1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2021 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
, ULONGEST 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 (inferior
*, ptid_t
, target_waitkind
, 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 print_one_stopped_thread (thread_info
*thread
);
770 void process_initial_stop_replies (int from_tty
);
772 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 private: /* data fields */
961 /* The remote state. Don't reference this directly. Use the
962 get_remote_state method instead. */
963 remote_state m_remote_state
;
966 static const target_info extended_remote_target_info
= {
968 N_("Extended remote serial target in gdb-specific protocol"),
972 /* Set up the extended remote target by extending the standard remote
973 target and adding to it. */
975 class extended_remote_target final
: public remote_target
978 const target_info
&info () const override
979 { return extended_remote_target_info
; }
981 /* Open an extended-remote connection. */
982 static void open (const char *, int);
984 bool can_create_inferior () override
{ return true; }
985 void create_inferior (const char *, const std::string
&,
986 char **, int) override
;
988 void detach (inferior
*, int) override
;
990 bool can_attach () override
{ return true; }
991 void attach (const char *, int) override
;
993 void post_attach (int) override
;
994 bool supports_disable_randomization () override
;
1000 is_remote_target (process_stratum_target
*target
)
1002 remote_target
*rt
= dynamic_cast<remote_target
*> (target
);
1003 return rt
!= nullptr;
1006 /* Per-program-space data key. */
1007 static const struct program_space_key
<char, gdb::xfree_deleter
<char>>
1010 /* The variable registered as the control variable used by the
1011 remote exec-file commands. While the remote exec-file setting is
1012 per-program-space, the set/show machinery uses this as the
1013 location of the remote exec-file value. */
1014 static std::string remote_exec_file_var
;
1016 /* The size to align memory write packets, when practical. The protocol
1017 does not guarantee any alignment, and gdb will generate short
1018 writes and unaligned writes, but even as a best-effort attempt this
1019 can improve bulk transfers. For instance, if a write is misaligned
1020 relative to the target's data bus, the stub may need to make an extra
1021 round trip fetching data from the target. This doesn't make a
1022 huge difference, but it's easy to do, so we try to be helpful.
1024 The alignment chosen is arbitrary; usually data bus width is
1025 important here, not the possibly larger cache line size. */
1026 enum { REMOTE_ALIGN_WRITES
= 16 };
1028 /* Prototypes for local functions. */
1030 static int hexnumlen (ULONGEST num
);
1032 static int stubhex (int ch
);
1034 static int hexnumstr (char *, ULONGEST
);
1036 static int hexnumnstr (char *, ULONGEST
, int);
1038 static CORE_ADDR
remote_address_masked (CORE_ADDR
);
1040 static int stub_unpack_int (const char *buff
, int fieldlength
);
1042 struct packet_config
;
1044 static void show_packet_config_cmd (struct packet_config
*config
);
1046 static void show_remote_protocol_packet_cmd (struct ui_file
*file
,
1048 struct cmd_list_element
*c
,
1051 static ptid_t
read_ptid (const char *buf
, const char **obuf
);
1053 static void remote_async_inferior_event_handler (gdb_client_data
);
1055 static bool remote_read_description_p (struct target_ops
*target
);
1057 static void remote_console_output (const char *msg
);
1059 static void remote_btrace_reset (remote_state
*rs
);
1061 static void remote_unpush_and_throw (remote_target
*target
);
1065 static struct cmd_list_element
*remote_cmdlist
;
1067 /* For "set remote" and "show remote". */
1069 static struct cmd_list_element
*remote_set_cmdlist
;
1070 static struct cmd_list_element
*remote_show_cmdlist
;
1072 /* Controls whether GDB is willing to use range stepping. */
1074 static bool use_range_stepping
= true;
1076 /* From the remote target's point of view, each thread is in one of these three
1078 enum class resume_state
1080 /* Not resumed - we haven't been asked to resume this thread. */
1083 /* We have been asked to resume this thread, but haven't sent a vCont action
1084 for it yet. We'll need to consider it next time commit_resume is
1086 RESUMED_PENDING_VCONT
,
1088 /* We have been asked to resume this thread, and we have sent a vCont action
1093 /* Information about a thread's pending vCont-resume. Used when a thread is in
1094 the remote_resume_state::RESUMED_PENDING_VCONT state. remote_target::resume
1095 stores this information which is then picked up by
1096 remote_target::commit_resume to know which is the proper action for this
1097 thread to include in the vCont packet. */
1098 struct resumed_pending_vcont_info
1100 /* True if the last resume call for this thread was a step request, false
1101 if a continue request. */
1104 /* The signal specified in the last resume call for this thread. */
1108 /* Private data that we'll store in (struct thread_info)->priv. */
1109 struct remote_thread_info
: public private_thread_info
1115 /* Thread handle, perhaps a pthread_t or thread_t value, stored as a
1116 sequence of bytes. */
1117 gdb::byte_vector thread_handle
;
1119 /* Whether the target stopped for a breakpoint/watchpoint. */
1120 enum target_stop_reason stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
1122 /* This is set to the data address of the access causing the target
1123 to stop for a watchpoint. */
1124 CORE_ADDR watch_data_address
= 0;
1126 /* Get the thread's resume state. */
1127 enum resume_state
get_resume_state () const
1129 return m_resume_state
;
1132 /* Put the thread in the NOT_RESUMED state. */
1133 void set_not_resumed ()
1135 m_resume_state
= resume_state::NOT_RESUMED
;
1138 /* Put the thread in the RESUMED_PENDING_VCONT state. */
1139 void set_resumed_pending_vcont (bool step
, gdb_signal sig
)
1141 m_resume_state
= resume_state::RESUMED_PENDING_VCONT
;
1142 m_resumed_pending_vcont_info
.step
= step
;
1143 m_resumed_pending_vcont_info
.sig
= sig
;
1146 /* Get the information this thread's pending vCont-resumption.
1148 Must only be called if the thread is in the RESUMED_PENDING_VCONT resume
1150 const struct resumed_pending_vcont_info
&resumed_pending_vcont_info () const
1152 gdb_assert (m_resume_state
== resume_state::RESUMED_PENDING_VCONT
);
1154 return m_resumed_pending_vcont_info
;
1157 /* Put the thread in the VCONT_RESUMED state. */
1160 m_resume_state
= resume_state::RESUMED
;
1164 /* Resume state for this thread. This is used to implement vCont action
1165 coalescing (only when the target operates in non-stop mode).
1167 remote_target::resume moves the thread to the RESUMED_PENDING_VCONT state,
1168 which notes that this thread must be considered in the next commit_resume
1171 remote_target::commit_resume sends a vCont packet with actions for the
1172 threads in the RESUMED_PENDING_VCONT state and moves them to the
1173 VCONT_RESUMED state.
1175 When reporting a stop to the core for a thread, that thread is moved back
1176 to the NOT_RESUMED state. */
1177 enum resume_state m_resume_state
= resume_state::NOT_RESUMED
;
1179 /* Extra info used if the thread is in the RESUMED_PENDING_VCONT state. */
1180 struct resumed_pending_vcont_info m_resumed_pending_vcont_info
;
1183 remote_state::remote_state ()
1188 remote_state::~remote_state ()
1190 xfree (this->last_pass_packet
);
1191 xfree (this->last_program_signals_packet
);
1192 xfree (this->finished_object
);
1193 xfree (this->finished_annex
);
1196 /* Utility: generate error from an incoming stub packet. */
1198 trace_error (char *buf
)
1201 return; /* not an error msg */
1204 case '1': /* malformed packet error */
1205 if (*++buf
== '0') /* general case: */
1206 error (_("remote.c: error in outgoing packet."));
1208 error (_("remote.c: error in outgoing packet at field #%ld."),
1209 strtol (buf
, NULL
, 16));
1211 error (_("Target returns error code '%s'."), buf
);
1215 /* Utility: wait for reply from stub, while accepting "O" packets. */
1218 remote_target::remote_get_noisy_reply ()
1220 struct remote_state
*rs
= get_remote_state ();
1222 do /* Loop on reply from remote stub. */
1226 QUIT
; /* Allow user to bail out with ^C. */
1227 getpkt (&rs
->buf
, 0);
1228 buf
= rs
->buf
.data ();
1231 else if (startswith (buf
, "qRelocInsn:"))
1234 CORE_ADDR from
, to
, org_to
;
1236 int adjusted_size
= 0;
1239 p
= buf
+ strlen ("qRelocInsn:");
1240 pp
= unpack_varlen_hex (p
, &ul
);
1242 error (_("invalid qRelocInsn packet: %s"), buf
);
1246 unpack_varlen_hex (p
, &ul
);
1253 gdbarch_relocate_instruction (target_gdbarch (), &to
, from
);
1256 catch (const gdb_exception
&ex
)
1258 if (ex
.error
== MEMORY_ERROR
)
1260 /* Propagate memory errors silently back to the
1261 target. The stub may have limited the range of
1262 addresses we can write to, for example. */
1266 /* Something unexpectedly bad happened. Be verbose
1267 so we can tell what, and propagate the error back
1268 to the stub, so it doesn't get stuck waiting for
1270 exception_fprintf (gdb_stderr
, ex
,
1271 _("warning: relocating instruction: "));
1278 adjusted_size
= to
- org_to
;
1280 xsnprintf (buf
, rs
->buf
.size (), "qRelocInsn:%x", adjusted_size
);
1284 else if (buf
[0] == 'O' && buf
[1] != 'K')
1285 remote_console_output (buf
+ 1); /* 'O' message from stub */
1287 return buf
; /* Here's the actual reply. */
1292 struct remote_arch_state
*
1293 remote_state::get_remote_arch_state (struct gdbarch
*gdbarch
)
1295 remote_arch_state
*rsa
;
1297 auto it
= this->m_arch_states
.find (gdbarch
);
1298 if (it
== this->m_arch_states
.end ())
1300 auto p
= this->m_arch_states
.emplace (std::piecewise_construct
,
1301 std::forward_as_tuple (gdbarch
),
1302 std::forward_as_tuple (gdbarch
));
1303 rsa
= &p
.first
->second
;
1305 /* Make sure that the packet buffer is plenty big enough for
1306 this architecture. */
1307 if (this->buf
.size () < rsa
->remote_packet_size
)
1308 this->buf
.resize (2 * rsa
->remote_packet_size
);
1316 /* Fetch the global remote target state. */
1319 remote_target::get_remote_state ()
1321 /* Make sure that the remote architecture state has been
1322 initialized, because doing so might reallocate rs->buf. Any
1323 function which calls getpkt also needs to be mindful of changes
1324 to rs->buf, but this call limits the number of places which run
1326 m_remote_state
.get_remote_arch_state (target_gdbarch ());
1328 return &m_remote_state
;
1331 /* Fetch the remote exec-file from the current program space. */
1334 get_remote_exec_file (void)
1336 char *remote_exec_file
;
1338 remote_exec_file
= remote_pspace_data
.get (current_program_space
);
1339 if (remote_exec_file
== NULL
)
1342 return remote_exec_file
;
1345 /* Set the remote exec file for PSPACE. */
1348 set_pspace_remote_exec_file (struct program_space
*pspace
,
1349 const char *remote_exec_file
)
1351 char *old_file
= remote_pspace_data
.get (pspace
);
1354 remote_pspace_data
.set (pspace
, xstrdup (remote_exec_file
));
1357 /* The "set/show remote exec-file" set command hook. */
1360 set_remote_exec_file (const char *ignored
, int from_tty
,
1361 struct cmd_list_element
*c
)
1363 set_pspace_remote_exec_file (current_program_space
,
1364 remote_exec_file_var
.c_str ());
1367 /* The "set/show remote exec-file" show command hook. */
1370 show_remote_exec_file (struct ui_file
*file
, int from_tty
,
1371 struct cmd_list_element
*cmd
, const char *value
)
1373 fprintf_filtered (file
, "%s\n", get_remote_exec_file ());
1377 map_regcache_remote_table (struct gdbarch
*gdbarch
, struct packet_reg
*regs
)
1379 int regnum
, num_remote_regs
, offset
;
1380 struct packet_reg
**remote_regs
;
1382 for (regnum
= 0; regnum
< gdbarch_num_regs (gdbarch
); regnum
++)
1384 struct packet_reg
*r
= ®s
[regnum
];
1386 if (register_size (gdbarch
, regnum
) == 0)
1387 /* Do not try to fetch zero-sized (placeholder) registers. */
1390 r
->pnum
= gdbarch_remote_register_number (gdbarch
, regnum
);
1395 /* Define the g/G packet format as the contents of each register
1396 with a remote protocol number, in order of ascending protocol
1399 remote_regs
= XALLOCAVEC (struct packet_reg
*, gdbarch_num_regs (gdbarch
));
1400 for (num_remote_regs
= 0, regnum
= 0;
1401 regnum
< gdbarch_num_regs (gdbarch
);
1403 if (regs
[regnum
].pnum
!= -1)
1404 remote_regs
[num_remote_regs
++] = ®s
[regnum
];
1406 std::sort (remote_regs
, remote_regs
+ num_remote_regs
,
1407 [] (const packet_reg
*a
, const packet_reg
*b
)
1408 { return a
->pnum
< b
->pnum
; });
1410 for (regnum
= 0, offset
= 0; regnum
< num_remote_regs
; regnum
++)
1412 remote_regs
[regnum
]->in_g_packet
= 1;
1413 remote_regs
[regnum
]->offset
= offset
;
1414 offset
+= register_size (gdbarch
, remote_regs
[regnum
]->regnum
);
1420 /* Given the architecture described by GDBARCH, return the remote
1421 protocol register's number and the register's offset in the g/G
1422 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
1423 If the target does not have a mapping for REGNUM, return false,
1424 otherwise, return true. */
1427 remote_register_number_and_offset (struct gdbarch
*gdbarch
, int regnum
,
1428 int *pnum
, int *poffset
)
1430 gdb_assert (regnum
< gdbarch_num_regs (gdbarch
));
1432 std::vector
<packet_reg
> regs (gdbarch_num_regs (gdbarch
));
1434 map_regcache_remote_table (gdbarch
, regs
.data ());
1436 *pnum
= regs
[regnum
].pnum
;
1437 *poffset
= regs
[regnum
].offset
;
1442 remote_arch_state::remote_arch_state (struct gdbarch
*gdbarch
)
1444 /* Use the architecture to build a regnum<->pnum table, which will be
1445 1:1 unless a feature set specifies otherwise. */
1446 this->regs
.reset (new packet_reg
[gdbarch_num_regs (gdbarch
)] ());
1448 /* Record the maximum possible size of the g packet - it may turn out
1450 this->sizeof_g_packet
1451 = map_regcache_remote_table (gdbarch
, this->regs
.get ());
1453 /* Default maximum number of characters in a packet body. Many
1454 remote stubs have a hardwired buffer size of 400 bytes
1455 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
1456 as the maximum packet-size to ensure that the packet and an extra
1457 NUL character can always fit in the buffer. This stops GDB
1458 trashing stubs that try to squeeze an extra NUL into what is
1459 already a full buffer (As of 1999-12-04 that was most stubs). */
1460 this->remote_packet_size
= 400 - 1;
1462 /* This one is filled in when a ``g'' packet is received. */
1463 this->actual_register_packet_size
= 0;
1465 /* Should rsa->sizeof_g_packet needs more space than the
1466 default, adjust the size accordingly. Remember that each byte is
1467 encoded as two characters. 32 is the overhead for the packet
1468 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
1469 (``$NN:G...#NN'') is a better guess, the below has been padded a
1471 if (this->sizeof_g_packet
> ((this->remote_packet_size
- 32) / 2))
1472 this->remote_packet_size
= (this->sizeof_g_packet
* 2 + 32);
1475 /* Get a pointer to the current remote target. If not connected to a
1476 remote target, return NULL. */
1478 static remote_target
*
1479 get_current_remote_target ()
1481 target_ops
*proc_target
= current_inferior ()->process_target ();
1482 return dynamic_cast<remote_target
*> (proc_target
);
1485 /* Return the current allowed size of a remote packet. This is
1486 inferred from the current architecture, and should be used to
1487 limit the length of outgoing packets. */
1489 remote_target::get_remote_packet_size ()
1491 struct remote_state
*rs
= get_remote_state ();
1492 remote_arch_state
*rsa
= rs
->get_remote_arch_state (target_gdbarch ());
1494 if (rs
->explicit_packet_size
)
1495 return rs
->explicit_packet_size
;
1497 return rsa
->remote_packet_size
;
1500 static struct packet_reg
*
1501 packet_reg_from_regnum (struct gdbarch
*gdbarch
, struct remote_arch_state
*rsa
,
1504 if (regnum
< 0 && regnum
>= gdbarch_num_regs (gdbarch
))
1508 struct packet_reg
*r
= &rsa
->regs
[regnum
];
1510 gdb_assert (r
->regnum
== regnum
);
1515 static struct packet_reg
*
1516 packet_reg_from_pnum (struct gdbarch
*gdbarch
, struct remote_arch_state
*rsa
,
1521 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
1523 struct packet_reg
*r
= &rsa
->regs
[i
];
1525 if (r
->pnum
== pnum
)
1531 /* Allow the user to specify what sequence to send to the remote
1532 when he requests a program interruption: Although ^C is usually
1533 what remote systems expect (this is the default, here), it is
1534 sometimes preferable to send a break. On other systems such
1535 as the Linux kernel, a break followed by g, which is Magic SysRq g
1536 is required in order to interrupt the execution. */
1537 const char interrupt_sequence_control_c
[] = "Ctrl-C";
1538 const char interrupt_sequence_break
[] = "BREAK";
1539 const char interrupt_sequence_break_g
[] = "BREAK-g";
1540 static const char *const interrupt_sequence_modes
[] =
1542 interrupt_sequence_control_c
,
1543 interrupt_sequence_break
,
1544 interrupt_sequence_break_g
,
1547 static const char *interrupt_sequence_mode
= interrupt_sequence_control_c
;
1550 show_interrupt_sequence (struct ui_file
*file
, int from_tty
,
1551 struct cmd_list_element
*c
,
1554 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
1555 fprintf_filtered (file
,
1556 _("Send the ASCII ETX character (Ctrl-c) "
1557 "to the remote target to interrupt the "
1558 "execution of the program.\n"));
1559 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
1560 fprintf_filtered (file
,
1561 _("send a break signal to the remote target "
1562 "to interrupt the execution of the program.\n"));
1563 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
1564 fprintf_filtered (file
,
1565 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
1566 "the remote target to interrupt the execution "
1567 "of Linux kernel.\n"));
1569 internal_error (__FILE__
, __LINE__
,
1570 _("Invalid value for interrupt_sequence_mode: %s."),
1571 interrupt_sequence_mode
);
1574 /* This boolean variable specifies whether interrupt_sequence is sent
1575 to the remote target when gdb connects to it.
1576 This is mostly needed when you debug the Linux kernel: The Linux kernel
1577 expects BREAK g which is Magic SysRq g for connecting gdb. */
1578 static bool interrupt_on_connect
= false;
1580 /* This variable is used to implement the "set/show remotebreak" commands.
1581 Since these commands are now deprecated in favor of "set/show remote
1582 interrupt-sequence", it no longer has any effect on the code. */
1583 static bool remote_break
;
1586 set_remotebreak (const char *args
, int from_tty
, struct cmd_list_element
*c
)
1589 interrupt_sequence_mode
= interrupt_sequence_break
;
1591 interrupt_sequence_mode
= interrupt_sequence_control_c
;
1595 show_remotebreak (struct ui_file
*file
, int from_tty
,
1596 struct cmd_list_element
*c
,
1601 /* This variable sets the number of bits in an address that are to be
1602 sent in a memory ("M" or "m") packet. Normally, after stripping
1603 leading zeros, the entire address would be sent. This variable
1604 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
1605 initial implementation of remote.c restricted the address sent in
1606 memory packets to ``host::sizeof long'' bytes - (typically 32
1607 bits). Consequently, for 64 bit targets, the upper 32 bits of an
1608 address was never sent. Since fixing this bug may cause a break in
1609 some remote targets this variable is principally provided to
1610 facilitate backward compatibility. */
1612 static unsigned int remote_address_size
;
1615 /* User configurable variables for the number of characters in a
1616 memory read/write packet. MIN (rsa->remote_packet_size,
1617 rsa->sizeof_g_packet) is the default. Some targets need smaller
1618 values (fifo overruns, et.al.) and some users need larger values
1619 (speed up transfers). The variables ``preferred_*'' (the user
1620 request), ``current_*'' (what was actually set) and ``forced_*''
1621 (Positive - a soft limit, negative - a hard limit). */
1623 struct memory_packet_config
1630 /* The default max memory-write-packet-size, when the setting is
1631 "fixed". The 16k is historical. (It came from older GDB's using
1632 alloca for buffers and the knowledge (folklore?) that some hosts
1633 don't cope very well with large alloca calls.) */
1634 #define DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED 16384
1636 /* The minimum remote packet size for memory transfers. Ensures we
1637 can write at least one byte. */
1638 #define MIN_MEMORY_PACKET_SIZE 20
1640 /* Get the memory packet size, assuming it is fixed. */
1643 get_fixed_memory_packet_size (struct memory_packet_config
*config
)
1645 gdb_assert (config
->fixed_p
);
1647 if (config
->size
<= 0)
1648 return DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
;
1650 return config
->size
;
1653 /* Compute the current size of a read/write packet. Since this makes
1654 use of ``actual_register_packet_size'' the computation is dynamic. */
1657 remote_target::get_memory_packet_size (struct memory_packet_config
*config
)
1659 struct remote_state
*rs
= get_remote_state ();
1660 remote_arch_state
*rsa
= rs
->get_remote_arch_state (target_gdbarch ());
1663 if (config
->fixed_p
)
1664 what_they_get
= get_fixed_memory_packet_size (config
);
1667 what_they_get
= get_remote_packet_size ();
1668 /* Limit the packet to the size specified by the user. */
1669 if (config
->size
> 0
1670 && what_they_get
> config
->size
)
1671 what_they_get
= config
->size
;
1673 /* Limit it to the size of the targets ``g'' response unless we have
1674 permission from the stub to use a larger packet size. */
1675 if (rs
->explicit_packet_size
== 0
1676 && rsa
->actual_register_packet_size
> 0
1677 && what_they_get
> rsa
->actual_register_packet_size
)
1678 what_they_get
= rsa
->actual_register_packet_size
;
1680 if (what_they_get
< MIN_MEMORY_PACKET_SIZE
)
1681 what_they_get
= MIN_MEMORY_PACKET_SIZE
;
1683 /* Make sure there is room in the global buffer for this packet
1684 (including its trailing NUL byte). */
1685 if (rs
->buf
.size () < what_they_get
+ 1)
1686 rs
->buf
.resize (2 * what_they_get
);
1688 return what_they_get
;
1691 /* Update the size of a read/write packet. If they user wants
1692 something really big then do a sanity check. */
1695 set_memory_packet_size (const char *args
, struct memory_packet_config
*config
)
1697 int fixed_p
= config
->fixed_p
;
1698 long size
= config
->size
;
1701 error (_("Argument required (integer, `fixed' or `limited')."));
1702 else if (strcmp (args
, "hard") == 0
1703 || strcmp (args
, "fixed") == 0)
1705 else if (strcmp (args
, "soft") == 0
1706 || strcmp (args
, "limit") == 0)
1712 size
= strtoul (args
, &end
, 0);
1714 error (_("Invalid %s (bad syntax)."), config
->name
);
1716 /* Instead of explicitly capping the size of a packet to or
1717 disallowing it, the user is allowed to set the size to
1718 something arbitrarily large. */
1722 if (fixed_p
&& !config
->fixed_p
)
1724 /* So that the query shows the correct value. */
1725 long query_size
= (size
<= 0
1726 ? DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
1729 if (! query (_("The target may not be able to correctly handle a %s\n"
1730 "of %ld bytes. Change the packet size? "),
1731 config
->name
, query_size
))
1732 error (_("Packet size not changed."));
1734 /* Update the config. */
1735 config
->fixed_p
= fixed_p
;
1736 config
->size
= size
;
1740 show_memory_packet_size (struct memory_packet_config
*config
)
1742 if (config
->size
== 0)
1743 printf_filtered (_("The %s is 0 (default). "), config
->name
);
1745 printf_filtered (_("The %s is %ld. "), config
->name
, config
->size
);
1746 if (config
->fixed_p
)
1747 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
1748 get_fixed_memory_packet_size (config
));
1751 remote_target
*remote
= get_current_remote_target ();
1754 printf_filtered (_("Packets are limited to %ld bytes.\n"),
1755 remote
->get_memory_packet_size (config
));
1757 puts_filtered ("The actual limit will be further reduced "
1758 "dependent on the target.\n");
1762 /* FIXME: needs to be per-remote-target. */
1763 static struct memory_packet_config memory_write_packet_config
=
1765 "memory-write-packet-size",
1769 set_memory_write_packet_size (const char *args
, int from_tty
)
1771 set_memory_packet_size (args
, &memory_write_packet_config
);
1775 show_memory_write_packet_size (const char *args
, int from_tty
)
1777 show_memory_packet_size (&memory_write_packet_config
);
1780 /* Show the number of hardware watchpoints that can be used. */
1783 show_hardware_watchpoint_limit (struct ui_file
*file
, int from_tty
,
1784 struct cmd_list_element
*c
,
1787 fprintf_filtered (file
, _("The maximum number of target hardware "
1788 "watchpoints is %s.\n"), value
);
1791 /* Show the length limit (in bytes) for hardware watchpoints. */
1794 show_hardware_watchpoint_length_limit (struct ui_file
*file
, int from_tty
,
1795 struct cmd_list_element
*c
,
1798 fprintf_filtered (file
, _("The maximum length (in bytes) of a target "
1799 "hardware watchpoint is %s.\n"), value
);
1802 /* Show the number of hardware breakpoints that can be used. */
1805 show_hardware_breakpoint_limit (struct ui_file
*file
, int from_tty
,
1806 struct cmd_list_element
*c
,
1809 fprintf_filtered (file
, _("The maximum number of target hardware "
1810 "breakpoints is %s.\n"), value
);
1813 /* Controls the maximum number of characters to display in the debug output
1814 for each remote packet. The remaining characters are omitted. */
1816 static int remote_packet_max_chars
= 512;
1818 /* Show the maximum number of characters to display for each remote packet
1819 when remote debugging is enabled. */
1822 show_remote_packet_max_chars (struct ui_file
*file
, int from_tty
,
1823 struct cmd_list_element
*c
,
1826 fprintf_filtered (file
, _("Number of remote packet characters to "
1827 "display is %s.\n"), value
);
1831 remote_target::get_memory_write_packet_size ()
1833 return get_memory_packet_size (&memory_write_packet_config
);
1836 /* FIXME: needs to be per-remote-target. */
1837 static struct memory_packet_config memory_read_packet_config
=
1839 "memory-read-packet-size",
1843 set_memory_read_packet_size (const char *args
, int from_tty
)
1845 set_memory_packet_size (args
, &memory_read_packet_config
);
1849 show_memory_read_packet_size (const char *args
, int from_tty
)
1851 show_memory_packet_size (&memory_read_packet_config
);
1855 remote_target::get_memory_read_packet_size ()
1857 long size
= get_memory_packet_size (&memory_read_packet_config
);
1859 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1860 extra buffer size argument before the memory read size can be
1861 increased beyond this. */
1862 if (size
> get_remote_packet_size ())
1863 size
= get_remote_packet_size ();
1869 struct packet_config
1874 /* If auto, GDB auto-detects support for this packet or feature,
1875 either through qSupported, or by trying the packet and looking
1876 at the response. If true, GDB assumes the target supports this
1877 packet. If false, the packet is disabled. Configs that don't
1878 have an associated command always have this set to auto. */
1879 enum auto_boolean detect
;
1881 /* The "show remote foo-packet" command created for this packet. */
1882 cmd_list_element
*show_cmd
;
1884 /* Does the target support this packet? */
1885 enum packet_support support
;
1888 static enum packet_support
packet_config_support (struct packet_config
*config
);
1889 static enum packet_support
packet_support (int packet
);
1892 show_packet_config_cmd (struct packet_config
*config
)
1894 const char *support
= "internal-error";
1896 switch (packet_config_support (config
))
1899 support
= "enabled";
1901 case PACKET_DISABLE
:
1902 support
= "disabled";
1904 case PACKET_SUPPORT_UNKNOWN
:
1905 support
= "unknown";
1908 switch (config
->detect
)
1910 case AUTO_BOOLEAN_AUTO
:
1911 printf_filtered (_("Support for the `%s' packet "
1912 "is auto-detected, currently %s.\n"),
1913 config
->name
, support
);
1915 case AUTO_BOOLEAN_TRUE
:
1916 case AUTO_BOOLEAN_FALSE
:
1917 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1918 config
->name
, support
);
1924 add_packet_config_cmd (struct packet_config
*config
, const char *name
,
1925 const char *title
, int legacy
)
1927 config
->name
= name
;
1928 config
->title
= title
;
1929 gdb::unique_xmalloc_ptr
<char> set_doc
1930 = xstrprintf ("Set use of remote protocol `%s' (%s) packet.",
1932 gdb::unique_xmalloc_ptr
<char> show_doc
1933 = xstrprintf ("Show current use of remote protocol `%s' (%s) packet.",
1935 /* set/show TITLE-packet {auto,on,off} */
1936 gdb::unique_xmalloc_ptr
<char> cmd_name
= xstrprintf ("%s-packet", title
);
1937 set_show_commands cmds
1938 = add_setshow_auto_boolean_cmd (cmd_name
.release (), class_obscure
,
1939 &config
->detect
, set_doc
.get (),
1940 show_doc
.get (), NULL
, /* help_doc */
1942 show_remote_protocol_packet_cmd
,
1943 &remote_set_cmdlist
, &remote_show_cmdlist
);
1944 config
->show_cmd
= cmds
.show
;
1946 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1949 /* It's not clear who should take ownership of this string, so, for
1950 now, make it static, and give copies to each of the add_alias_cmd
1952 static gdb::unique_xmalloc_ptr
<char> legacy_name
1953 = xstrprintf ("%s-packet", name
);
1954 add_alias_cmd (legacy_name
.get (), cmds
.set
, class_obscure
, 0,
1955 &remote_set_cmdlist
);
1956 add_alias_cmd (legacy_name
.get (), cmds
.show
, class_obscure
, 0,
1957 &remote_show_cmdlist
);
1961 static enum packet_result
1962 packet_check_result (const char *buf
)
1966 /* The stub recognized the packet request. Check that the
1967 operation succeeded. */
1969 && isxdigit (buf
[1]) && isxdigit (buf
[2])
1971 /* "Enn" - definitely an error. */
1972 return PACKET_ERROR
;
1974 /* Always treat "E." as an error. This will be used for
1975 more verbose error messages, such as E.memtypes. */
1976 if (buf
[0] == 'E' && buf
[1] == '.')
1977 return PACKET_ERROR
;
1979 /* The packet may or may not be OK. Just assume it is. */
1983 /* The stub does not support the packet. */
1984 return PACKET_UNKNOWN
;
1987 static enum packet_result
1988 packet_check_result (const gdb::char_vector
&buf
)
1990 return packet_check_result (buf
.data ());
1993 static enum packet_result
1994 packet_ok (const char *buf
, struct packet_config
*config
)
1996 enum packet_result result
;
1998 if (config
->detect
!= AUTO_BOOLEAN_TRUE
1999 && config
->support
== PACKET_DISABLE
)
2000 internal_error (__FILE__
, __LINE__
,
2001 _("packet_ok: attempt to use a disabled packet"));
2003 result
= packet_check_result (buf
);
2008 /* The stub recognized the packet request. */
2009 if (config
->support
== PACKET_SUPPORT_UNKNOWN
)
2011 remote_debug_printf ("Packet %s (%s) is supported",
2012 config
->name
, config
->title
);
2013 config
->support
= PACKET_ENABLE
;
2016 case PACKET_UNKNOWN
:
2017 /* The stub does not support the packet. */
2018 if (config
->detect
== AUTO_BOOLEAN_AUTO
2019 && config
->support
== PACKET_ENABLE
)
2021 /* If the stub previously indicated that the packet was
2022 supported then there is a protocol error. */
2023 error (_("Protocol error: %s (%s) conflicting enabled responses."),
2024 config
->name
, config
->title
);
2026 else if (config
->detect
== AUTO_BOOLEAN_TRUE
)
2028 /* The user set it wrong. */
2029 error (_("Enabled packet %s (%s) not recognized by stub"),
2030 config
->name
, config
->title
);
2033 remote_debug_printf ("Packet %s (%s) is NOT supported",
2034 config
->name
, config
->title
);
2035 config
->support
= PACKET_DISABLE
;
2042 static enum packet_result
2043 packet_ok (const gdb::char_vector
&buf
, struct packet_config
*config
)
2045 return packet_ok (buf
.data (), config
);
2062 PACKET_vFile_pwrite
,
2064 PACKET_vFile_unlink
,
2065 PACKET_vFile_readlink
,
2068 PACKET_qXfer_features
,
2069 PACKET_qXfer_exec_file
,
2070 PACKET_qXfer_libraries
,
2071 PACKET_qXfer_libraries_svr4
,
2072 PACKET_qXfer_memory_map
,
2073 PACKET_qXfer_osdata
,
2074 PACKET_qXfer_threads
,
2075 PACKET_qXfer_statictrace_read
,
2076 PACKET_qXfer_traceframe_info
,
2082 PACKET_QPassSignals
,
2083 PACKET_QCatchSyscalls
,
2084 PACKET_QProgramSignals
,
2085 PACKET_QSetWorkingDir
,
2086 PACKET_QStartupWithShell
,
2087 PACKET_QEnvironmentHexEncoded
,
2088 PACKET_QEnvironmentReset
,
2089 PACKET_QEnvironmentUnset
,
2091 PACKET_qSearch_memory
,
2094 PACKET_QStartNoAckMode
,
2096 PACKET_qXfer_siginfo_read
,
2097 PACKET_qXfer_siginfo_write
,
2100 /* Support for conditional tracepoints. */
2101 PACKET_ConditionalTracepoints
,
2103 /* Support for target-side breakpoint conditions. */
2104 PACKET_ConditionalBreakpoints
,
2106 /* Support for target-side breakpoint commands. */
2107 PACKET_BreakpointCommands
,
2109 /* Support for fast tracepoints. */
2110 PACKET_FastTracepoints
,
2112 /* Support for static tracepoints. */
2113 PACKET_StaticTracepoints
,
2115 /* Support for installing tracepoints while a trace experiment is
2117 PACKET_InstallInTrace
,
2121 PACKET_TracepointSource
,
2124 PACKET_QDisableRandomization
,
2126 PACKET_QTBuffer_size
,
2130 PACKET_qXfer_btrace
,
2132 /* Support for the QNonStop packet. */
2135 /* Support for the QThreadEvents packet. */
2136 PACKET_QThreadEvents
,
2138 /* Support for multi-process extensions. */
2139 PACKET_multiprocess_feature
,
2141 /* Support for enabling and disabling tracepoints while a trace
2142 experiment is running. */
2143 PACKET_EnableDisableTracepoints_feature
,
2145 /* Support for collecting strings using the tracenz bytecode. */
2146 PACKET_tracenz_feature
,
2148 /* Support for continuing to run a trace experiment while GDB is
2150 PACKET_DisconnectedTracing_feature
,
2152 /* Support for qXfer:libraries-svr4:read with a non-empty annex. */
2153 PACKET_augmented_libraries_svr4_read_feature
,
2155 /* Support for the qXfer:btrace-conf:read packet. */
2156 PACKET_qXfer_btrace_conf
,
2158 /* Support for the Qbtrace-conf:bts:size packet. */
2159 PACKET_Qbtrace_conf_bts_size
,
2161 /* Support for swbreak+ feature. */
2162 PACKET_swbreak_feature
,
2164 /* Support for hwbreak+ feature. */
2165 PACKET_hwbreak_feature
,
2167 /* Support for fork events. */
2168 PACKET_fork_event_feature
,
2170 /* Support for vfork events. */
2171 PACKET_vfork_event_feature
,
2173 /* Support for the Qbtrace-conf:pt:size packet. */
2174 PACKET_Qbtrace_conf_pt_size
,
2176 /* Support for exec events. */
2177 PACKET_exec_event_feature
,
2179 /* Support for query supported vCont actions. */
2180 PACKET_vContSupported
,
2182 /* Support remote CTRL-C. */
2185 /* Support TARGET_WAITKIND_NO_RESUMED. */
2188 /* Support for memory tagging, allocation tag fetch/store
2189 packets and the tag violation stop replies. */
2190 PACKET_memory_tagging_feature
,
2195 /* FIXME: needs to be per-remote-target. Ignoring this for now,
2196 assuming all remote targets are the same server (thus all support
2197 the same packets). */
2198 static struct packet_config remote_protocol_packets
[PACKET_MAX
];
2200 /* Returns the packet's corresponding "set remote foo-packet" command
2201 state. See struct packet_config for more details. */
2203 static enum auto_boolean
2204 packet_set_cmd_state (int packet
)
2206 return remote_protocol_packets
[packet
].detect
;
2209 /* Returns whether a given packet or feature is supported. This takes
2210 into account the state of the corresponding "set remote foo-packet"
2211 command, which may be used to bypass auto-detection. */
2213 static enum packet_support
2214 packet_config_support (struct packet_config
*config
)
2216 switch (config
->detect
)
2218 case AUTO_BOOLEAN_TRUE
:
2219 return PACKET_ENABLE
;
2220 case AUTO_BOOLEAN_FALSE
:
2221 return PACKET_DISABLE
;
2222 case AUTO_BOOLEAN_AUTO
:
2223 return config
->support
;
2225 gdb_assert_not_reached ("bad switch");
2229 /* Same as packet_config_support, but takes the packet's enum value as
2232 static enum packet_support
2233 packet_support (int packet
)
2235 struct packet_config
*config
= &remote_protocol_packets
[packet
];
2237 return packet_config_support (config
);
2241 show_remote_protocol_packet_cmd (struct ui_file
*file
, int from_tty
,
2242 struct cmd_list_element
*c
,
2245 struct packet_config
*packet
;
2246 gdb_assert (c
->var
.has_value ());
2248 for (packet
= remote_protocol_packets
;
2249 packet
< &remote_protocol_packets
[PACKET_MAX
];
2252 if (c
== packet
->show_cmd
)
2254 show_packet_config_cmd (packet
);
2258 internal_error (__FILE__
, __LINE__
, _("Could not find config for %s"),
2262 /* Should we try one of the 'Z' requests? */
2266 Z_PACKET_SOFTWARE_BP
,
2267 Z_PACKET_HARDWARE_BP
,
2274 /* For compatibility with older distributions. Provide a ``set remote
2275 Z-packet ...'' command that updates all the Z packet types. */
2277 static enum auto_boolean remote_Z_packet_detect
;
2280 set_remote_protocol_Z_packet_cmd (const char *args
, int from_tty
,
2281 struct cmd_list_element
*c
)
2285 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
2286 remote_protocol_packets
[PACKET_Z0
+ i
].detect
= remote_Z_packet_detect
;
2290 show_remote_protocol_Z_packet_cmd (struct ui_file
*file
, int from_tty
,
2291 struct cmd_list_element
*c
,
2296 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
2298 show_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
+ i
]);
2302 /* Returns true if the multi-process extensions are in effect. */
2305 remote_multi_process_p (struct remote_state
*rs
)
2307 return packet_support (PACKET_multiprocess_feature
) == PACKET_ENABLE
;
2310 /* Returns true if fork events are supported. */
2313 remote_fork_event_p (struct remote_state
*rs
)
2315 return packet_support (PACKET_fork_event_feature
) == PACKET_ENABLE
;
2318 /* Returns true if vfork events are supported. */
2321 remote_vfork_event_p (struct remote_state
*rs
)
2323 return packet_support (PACKET_vfork_event_feature
) == PACKET_ENABLE
;
2326 /* Returns true if exec events are supported. */
2329 remote_exec_event_p (struct remote_state
*rs
)
2331 return packet_support (PACKET_exec_event_feature
) == PACKET_ENABLE
;
2334 /* Returns true if memory tagging is supported, false otherwise. */
2337 remote_memory_tagging_p ()
2339 return packet_support (PACKET_memory_tagging_feature
) == PACKET_ENABLE
;
2342 /* Insert fork catchpoint target routine. If fork events are enabled
2343 then return success, nothing more to do. */
2346 remote_target::insert_fork_catchpoint (int pid
)
2348 struct remote_state
*rs
= get_remote_state ();
2350 return !remote_fork_event_p (rs
);
2353 /* Remove fork catchpoint target routine. Nothing to do, just
2357 remote_target::remove_fork_catchpoint (int pid
)
2362 /* Insert vfork catchpoint target routine. If vfork events are enabled
2363 then return success, nothing more to do. */
2366 remote_target::insert_vfork_catchpoint (int pid
)
2368 struct remote_state
*rs
= get_remote_state ();
2370 return !remote_vfork_event_p (rs
);
2373 /* Remove vfork catchpoint target routine. Nothing to do, just
2377 remote_target::remove_vfork_catchpoint (int pid
)
2382 /* Insert exec catchpoint target routine. If exec events are
2383 enabled, just return success. */
2386 remote_target::insert_exec_catchpoint (int pid
)
2388 struct remote_state
*rs
= get_remote_state ();
2390 return !remote_exec_event_p (rs
);
2393 /* Remove exec catchpoint target routine. Nothing to do, just
2397 remote_target::remove_exec_catchpoint (int pid
)
2404 /* Take advantage of the fact that the TID field is not used, to tag
2405 special ptids with it set to != 0. */
2406 static const ptid_t
magic_null_ptid (42000, -1, 1);
2407 static const ptid_t
not_sent_ptid (42000, -2, 1);
2408 static const ptid_t
any_thread_ptid (42000, 0, 1);
2410 /* Find out if the stub attached to PID (and hence GDB should offer to
2411 detach instead of killing it when bailing out). */
2414 remote_target::remote_query_attached (int pid
)
2416 struct remote_state
*rs
= get_remote_state ();
2417 size_t size
= get_remote_packet_size ();
2419 if (packet_support (PACKET_qAttached
) == PACKET_DISABLE
)
2422 if (remote_multi_process_p (rs
))
2423 xsnprintf (rs
->buf
.data (), size
, "qAttached:%x", pid
);
2425 xsnprintf (rs
->buf
.data (), size
, "qAttached");
2428 getpkt (&rs
->buf
, 0);
2430 switch (packet_ok (rs
->buf
,
2431 &remote_protocol_packets
[PACKET_qAttached
]))
2434 if (strcmp (rs
->buf
.data (), "1") == 0)
2438 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
2440 case PACKET_UNKNOWN
:
2447 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
2448 has been invented by GDB, instead of reported by the target. Since
2449 we can be connected to a remote system before before knowing about
2450 any inferior, mark the target with execution when we find the first
2451 inferior. If ATTACHED is 1, then we had just attached to this
2452 inferior. If it is 0, then we just created this inferior. If it
2453 is -1, then try querying the remote stub to find out if it had
2454 attached to the inferior or not. If TRY_OPEN_EXEC is true then
2455 attempt to open this inferior's executable as the main executable
2456 if no main executable is open already. */
2459 remote_target::remote_add_inferior (bool fake_pid_p
, int pid
, int attached
,
2462 struct inferior
*inf
;
2464 /* Check whether this process we're learning about is to be
2465 considered attached, or if is to be considered to have been
2466 spawned by the stub. */
2468 attached
= remote_query_attached (pid
);
2470 if (gdbarch_has_global_solist (target_gdbarch ()))
2472 /* If the target shares code across all inferiors, then every
2473 attach adds a new inferior. */
2474 inf
= add_inferior (pid
);
2476 /* ... and every inferior is bound to the same program space.
2477 However, each inferior may still have its own address
2479 inf
->aspace
= maybe_new_address_space ();
2480 inf
->pspace
= current_program_space
;
2484 /* In the traditional debugging scenario, there's a 1-1 match
2485 between program/address spaces. We simply bind the inferior
2486 to the program space's address space. */
2487 inf
= current_inferior ();
2489 /* However, if the current inferior is already bound to a
2490 process, find some other empty inferior. */
2494 for (inferior
*it
: all_inferiors ())
2503 /* Since all inferiors were already bound to a process, add
2505 inf
= add_inferior_with_spaces ();
2507 switch_to_inferior_no_thread (inf
);
2508 inf
->push_target (this);
2509 inferior_appeared (inf
, pid
);
2512 inf
->attach_flag
= attached
;
2513 inf
->fake_pid_p
= fake_pid_p
;
2515 /* If no main executable is currently open then attempt to
2516 open the file that was executed to create this inferior. */
2517 if (try_open_exec
&& get_exec_file (0) == NULL
)
2518 exec_file_locate_attach (pid
, 0, 1);
2520 /* Check for exec file mismatch, and let the user solve it. */
2521 validate_exec_file (1);
2526 static remote_thread_info
*get_remote_thread_info (thread_info
*thread
);
2527 static remote_thread_info
*get_remote_thread_info (remote_target
*target
,
2530 /* Add thread PTID to GDB's thread list. Tag it as executing/running
2531 according to RUNNING. */
2534 remote_target::remote_add_thread (ptid_t ptid
, bool running
, bool executing
)
2536 struct remote_state
*rs
= get_remote_state ();
2537 struct thread_info
*thread
;
2539 /* GDB historically didn't pull threads in the initial connection
2540 setup. If the remote target doesn't even have a concept of
2541 threads (e.g., a bare-metal target), even if internally we
2542 consider that a single-threaded target, mentioning a new thread
2543 might be confusing to the user. Be silent then, preserving the
2544 age old behavior. */
2545 if (rs
->starting_up
)
2546 thread
= add_thread_silent (this, ptid
);
2548 thread
= add_thread (this, ptid
);
2550 /* We start by assuming threads are resumed. That state then gets updated
2551 when we process a matching stop reply. */
2552 get_remote_thread_info (thread
)->set_resumed ();
2554 set_executing (this, ptid
, executing
);
2555 set_running (this, ptid
, running
);
2560 /* Come here when we learn about a thread id from the remote target.
2561 It may be the first time we hear about such thread, so take the
2562 opportunity to add it to GDB's thread list. In case this is the
2563 first time we're noticing its corresponding inferior, add it to
2564 GDB's inferior list as well. EXECUTING indicates whether the
2565 thread is (internally) executing or stopped. */
2568 remote_target::remote_notice_new_inferior (ptid_t currthread
, bool executing
)
2570 /* In non-stop mode, we assume new found threads are (externally)
2571 running until proven otherwise with a stop reply. In all-stop,
2572 we can only get here if all threads are stopped. */
2573 bool running
= target_is_non_stop_p ();
2575 /* If this is a new thread, add it to GDB's thread list.
2576 If we leave it up to WFI to do this, bad things will happen. */
2578 thread_info
*tp
= find_thread_ptid (this, currthread
);
2579 if (tp
!= NULL
&& tp
->state
== THREAD_EXITED
)
2581 /* We're seeing an event on a thread id we knew had exited.
2582 This has to be a new thread reusing the old id. Add it. */
2583 remote_add_thread (currthread
, running
, executing
);
2587 if (!in_thread_list (this, currthread
))
2589 struct inferior
*inf
= NULL
;
2590 int pid
= currthread
.pid ();
2592 if (inferior_ptid
.is_pid ()
2593 && pid
== inferior_ptid
.pid ())
2595 /* inferior_ptid has no thread member yet. This can happen
2596 with the vAttach -> remote_wait,"TAAthread:" path if the
2597 stub doesn't support qC. This is the first stop reported
2598 after an attach, so this is the main thread. Update the
2599 ptid in the thread list. */
2600 if (in_thread_list (this, ptid_t (pid
)))
2601 thread_change_ptid (this, inferior_ptid
, currthread
);
2605 = remote_add_thread (currthread
, running
, executing
);
2606 switch_to_thread (thr
);
2611 if (magic_null_ptid
== inferior_ptid
)
2613 /* inferior_ptid is not set yet. This can happen with the
2614 vRun -> remote_wait,"TAAthread:" path if the stub
2615 doesn't support qC. This is the first stop reported
2616 after an attach, so this is the main thread. Update the
2617 ptid in the thread list. */
2618 thread_change_ptid (this, inferior_ptid
, currthread
);
2622 /* When connecting to a target remote, or to a target
2623 extended-remote which already was debugging an inferior, we
2624 may not know about it yet. Add it before adding its child
2625 thread, so notifications are emitted in a sensible order. */
2626 if (find_inferior_pid (this, currthread
.pid ()) == NULL
)
2628 struct remote_state
*rs
= get_remote_state ();
2629 bool fake_pid_p
= !remote_multi_process_p (rs
);
2631 inf
= remote_add_inferior (fake_pid_p
,
2632 currthread
.pid (), -1, 1);
2635 /* This is really a new thread. Add it. */
2636 thread_info
*new_thr
2637 = remote_add_thread (currthread
, running
, executing
);
2639 /* If we found a new inferior, let the common code do whatever
2640 it needs to with it (e.g., read shared libraries, insert
2641 breakpoints), unless we're just setting up an all-stop
2645 struct remote_state
*rs
= get_remote_state ();
2647 if (!rs
->starting_up
)
2648 notice_new_inferior (new_thr
, executing
, 0);
2653 /* Return THREAD's private thread data, creating it if necessary. */
2655 static remote_thread_info
*
2656 get_remote_thread_info (thread_info
*thread
)
2658 gdb_assert (thread
!= NULL
);
2660 if (thread
->priv
== NULL
)
2661 thread
->priv
.reset (new remote_thread_info
);
2663 return static_cast<remote_thread_info
*> (thread
->priv
.get ());
2666 /* Return PTID's private thread data, creating it if necessary. */
2668 static remote_thread_info
*
2669 get_remote_thread_info (remote_target
*target
, ptid_t ptid
)
2671 thread_info
*thr
= find_thread_ptid (target
, ptid
);
2672 return get_remote_thread_info (thr
);
2675 /* Call this function as a result of
2676 1) A halt indication (T packet) containing a thread id
2677 2) A direct query of currthread
2678 3) Successful execution of set thread */
2681 record_currthread (struct remote_state
*rs
, ptid_t currthread
)
2683 rs
->general_thread
= currthread
;
2686 /* If 'QPassSignals' is supported, tell the remote stub what signals
2687 it can simply pass through to the inferior without reporting. */
2690 remote_target::pass_signals (gdb::array_view
<const unsigned char> pass_signals
)
2692 if (packet_support (PACKET_QPassSignals
) != PACKET_DISABLE
)
2694 char *pass_packet
, *p
;
2696 struct remote_state
*rs
= get_remote_state ();
2698 gdb_assert (pass_signals
.size () < 256);
2699 for (size_t i
= 0; i
< pass_signals
.size (); i
++)
2701 if (pass_signals
[i
])
2704 pass_packet
= (char *) xmalloc (count
* 3 + strlen ("QPassSignals:") + 1);
2705 strcpy (pass_packet
, "QPassSignals:");
2706 p
= pass_packet
+ strlen (pass_packet
);
2707 for (size_t i
= 0; i
< pass_signals
.size (); i
++)
2709 if (pass_signals
[i
])
2712 *p
++ = tohex (i
>> 4);
2713 *p
++ = tohex (i
& 15);
2722 if (!rs
->last_pass_packet
|| strcmp (rs
->last_pass_packet
, pass_packet
))
2724 putpkt (pass_packet
);
2725 getpkt (&rs
->buf
, 0);
2726 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QPassSignals
]);
2727 xfree (rs
->last_pass_packet
);
2728 rs
->last_pass_packet
= pass_packet
;
2731 xfree (pass_packet
);
2735 /* If 'QCatchSyscalls' is supported, tell the remote stub
2736 to report syscalls to GDB. */
2739 remote_target::set_syscall_catchpoint (int pid
, bool needed
, int any_count
,
2740 gdb::array_view
<const int> syscall_counts
)
2742 const char *catch_packet
;
2743 enum packet_result result
;
2746 if (packet_support (PACKET_QCatchSyscalls
) == PACKET_DISABLE
)
2748 /* Not supported. */
2752 if (needed
&& any_count
== 0)
2754 /* Count how many syscalls are to be caught. */
2755 for (size_t i
= 0; i
< syscall_counts
.size (); i
++)
2757 if (syscall_counts
[i
] != 0)
2762 remote_debug_printf ("pid %d needed %d any_count %d n_sysno %d",
2763 pid
, needed
, any_count
, n_sysno
);
2765 std::string built_packet
;
2768 /* Prepare a packet with the sysno list, assuming max 8+1
2769 characters for a sysno. If the resulting packet size is too
2770 big, fallback on the non-selective packet. */
2771 const int maxpktsz
= strlen ("QCatchSyscalls:1") + n_sysno
* 9 + 1;
2772 built_packet
.reserve (maxpktsz
);
2773 built_packet
= "QCatchSyscalls:1";
2776 /* Add in each syscall to be caught. */
2777 for (size_t i
= 0; i
< syscall_counts
.size (); i
++)
2779 if (syscall_counts
[i
] != 0)
2780 string_appendf (built_packet
, ";%zx", i
);
2783 if (built_packet
.size () > get_remote_packet_size ())
2785 /* catch_packet too big. Fallback to less efficient
2786 non selective mode, with GDB doing the filtering. */
2787 catch_packet
= "QCatchSyscalls:1";
2790 catch_packet
= built_packet
.c_str ();
2793 catch_packet
= "QCatchSyscalls:0";
2795 struct remote_state
*rs
= get_remote_state ();
2797 putpkt (catch_packet
);
2798 getpkt (&rs
->buf
, 0);
2799 result
= packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QCatchSyscalls
]);
2800 if (result
== PACKET_OK
)
2806 /* If 'QProgramSignals' is supported, tell the remote stub what
2807 signals it should pass through to the inferior when detaching. */
2810 remote_target::program_signals (gdb::array_view
<const unsigned char> signals
)
2812 if (packet_support (PACKET_QProgramSignals
) != PACKET_DISABLE
)
2816 struct remote_state
*rs
= get_remote_state ();
2818 gdb_assert (signals
.size () < 256);
2819 for (size_t i
= 0; i
< signals
.size (); i
++)
2824 packet
= (char *) xmalloc (count
* 3 + strlen ("QProgramSignals:") + 1);
2825 strcpy (packet
, "QProgramSignals:");
2826 p
= packet
+ strlen (packet
);
2827 for (size_t i
= 0; i
< signals
.size (); i
++)
2829 if (signal_pass_state (i
))
2832 *p
++ = tohex (i
>> 4);
2833 *p
++ = tohex (i
& 15);
2842 if (!rs
->last_program_signals_packet
2843 || strcmp (rs
->last_program_signals_packet
, packet
) != 0)
2846 getpkt (&rs
->buf
, 0);
2847 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QProgramSignals
]);
2848 xfree (rs
->last_program_signals_packet
);
2849 rs
->last_program_signals_packet
= packet
;
2856 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
2857 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
2858 thread. If GEN is set, set the general thread, if not, then set
2859 the step/continue thread. */
2861 remote_target::set_thread (ptid_t ptid
, int gen
)
2863 struct remote_state
*rs
= get_remote_state ();
2864 ptid_t state
= gen
? rs
->general_thread
: rs
->continue_thread
;
2865 char *buf
= rs
->buf
.data ();
2866 char *endbuf
= buf
+ get_remote_packet_size ();
2872 *buf
++ = gen
? 'g' : 'c';
2873 if (ptid
== magic_null_ptid
)
2874 xsnprintf (buf
, endbuf
- buf
, "0");
2875 else if (ptid
== any_thread_ptid
)
2876 xsnprintf (buf
, endbuf
- buf
, "0");
2877 else if (ptid
== minus_one_ptid
)
2878 xsnprintf (buf
, endbuf
- buf
, "-1");
2880 write_ptid (buf
, endbuf
, ptid
);
2882 getpkt (&rs
->buf
, 0);
2884 rs
->general_thread
= ptid
;
2886 rs
->continue_thread
= ptid
;
2890 remote_target::set_general_thread (ptid_t ptid
)
2892 set_thread (ptid
, 1);
2896 remote_target::set_continue_thread (ptid_t ptid
)
2898 set_thread (ptid
, 0);
2901 /* Change the remote current process. Which thread within the process
2902 ends up selected isn't important, as long as it is the same process
2903 as what INFERIOR_PTID points to.
2905 This comes from that fact that there is no explicit notion of
2906 "selected process" in the protocol. The selected process for
2907 general operations is the process the selected general thread
2911 remote_target::set_general_process ()
2913 struct remote_state
*rs
= get_remote_state ();
2915 /* If the remote can't handle multiple processes, don't bother. */
2916 if (!remote_multi_process_p (rs
))
2919 /* We only need to change the remote current thread if it's pointing
2920 at some other process. */
2921 if (rs
->general_thread
.pid () != inferior_ptid
.pid ())
2922 set_general_thread (inferior_ptid
);
2926 /* Return nonzero if this is the main thread that we made up ourselves
2927 to model non-threaded targets as single-threaded. */
2930 remote_thread_always_alive (ptid_t ptid
)
2932 if (ptid
== magic_null_ptid
)
2933 /* The main thread is always alive. */
2936 if (ptid
.pid () != 0 && ptid
.lwp () == 0)
2937 /* The main thread is always alive. This can happen after a
2938 vAttach, if the remote side doesn't support
2945 /* Return nonzero if the thread PTID is still alive on the remote
2949 remote_target::thread_alive (ptid_t ptid
)
2951 struct remote_state
*rs
= get_remote_state ();
2954 /* Check if this is a thread that we made up ourselves to model
2955 non-threaded targets as single-threaded. */
2956 if (remote_thread_always_alive (ptid
))
2959 p
= rs
->buf
.data ();
2960 endp
= p
+ get_remote_packet_size ();
2963 write_ptid (p
, endp
, ptid
);
2966 getpkt (&rs
->buf
, 0);
2967 return (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K');
2970 /* Return a pointer to a thread name if we know it and NULL otherwise.
2971 The thread_info object owns the memory for the name. */
2974 remote_target::thread_name (struct thread_info
*info
)
2976 if (info
->priv
!= NULL
)
2978 const std::string
&name
= get_remote_thread_info (info
)->name
;
2979 return !name
.empty () ? name
.c_str () : NULL
;
2985 /* About these extended threadlist and threadinfo packets. They are
2986 variable length packets but, the fields within them are often fixed
2987 length. They are redundant enough to send over UDP as is the
2988 remote protocol in general. There is a matching unit test module
2991 /* WARNING: This threadref data structure comes from the remote O.S.,
2992 libstub protocol encoding, and remote.c. It is not particularly
2995 /* Right now, the internal structure is int. We want it to be bigger.
2996 Plan to fix this. */
2998 typedef int gdb_threadref
; /* Internal GDB thread reference. */
3000 /* gdb_ext_thread_info is an internal GDB data structure which is
3001 equivalent to the reply of the remote threadinfo packet. */
3003 struct gdb_ext_thread_info
3005 threadref threadid
; /* External form of thread reference. */
3006 int active
; /* Has state interesting to GDB?
3008 char display
[256]; /* Brief state display, name,
3009 blocked/suspended. */
3010 char shortname
[32]; /* To be used to name threads. */
3011 char more_display
[256]; /* Long info, statistics, queue depth,
3015 /* The volume of remote transfers can be limited by submitting
3016 a mask containing bits specifying the desired information.
3017 Use a union of these values as the 'selection' parameter to
3018 get_thread_info. FIXME: Make these TAG names more thread specific. */
3020 #define TAG_THREADID 1
3021 #define TAG_EXISTS 2
3022 #define TAG_DISPLAY 4
3023 #define TAG_THREADNAME 8
3024 #define TAG_MOREDISPLAY 16
3026 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
3028 static const char *unpack_nibble (const char *buf
, int *val
);
3030 static const char *unpack_byte (const char *buf
, int *value
);
3032 static char *pack_int (char *buf
, int value
);
3034 static const char *unpack_int (const char *buf
, int *value
);
3036 static const char *unpack_string (const char *src
, char *dest
, int length
);
3038 static char *pack_threadid (char *pkt
, threadref
*id
);
3040 static const char *unpack_threadid (const char *inbuf
, threadref
*id
);
3042 void int_to_threadref (threadref
*id
, int value
);
3044 static int threadref_to_int (threadref
*ref
);
3046 static void copy_threadref (threadref
*dest
, threadref
*src
);
3048 static int threadmatch (threadref
*dest
, threadref
*src
);
3050 static char *pack_threadinfo_request (char *pkt
, int mode
,
3053 static char *pack_threadlist_request (char *pkt
, int startflag
,
3055 threadref
*nextthread
);
3057 static int remote_newthread_step (threadref
*ref
, void *context
);
3060 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
3061 buffer we're allowed to write to. Returns
3062 BUF+CHARACTERS_WRITTEN. */
3065 remote_target::write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
)
3068 struct remote_state
*rs
= get_remote_state ();
3070 if (remote_multi_process_p (rs
))
3074 buf
+= xsnprintf (buf
, endbuf
- buf
, "p-%x.", -pid
);
3076 buf
+= xsnprintf (buf
, endbuf
- buf
, "p%x.", pid
);
3080 buf
+= xsnprintf (buf
, endbuf
- buf
, "-%x", -tid
);
3082 buf
+= xsnprintf (buf
, endbuf
- buf
, "%x", tid
);
3087 /* Extract a PTID from BUF. If non-null, OBUF is set to one past the
3088 last parsed char. Returns null_ptid if no thread id is found, and
3089 throws an error if the thread id has an invalid format. */
3092 read_ptid (const char *buf
, const char **obuf
)
3094 const char *p
= buf
;
3096 ULONGEST pid
= 0, tid
= 0;
3100 /* Multi-process ptid. */
3101 pp
= unpack_varlen_hex (p
+ 1, &pid
);
3103 error (_("invalid remote ptid: %s"), p
);
3106 pp
= unpack_varlen_hex (p
+ 1, &tid
);
3109 return ptid_t (pid
, tid
);
3112 /* No multi-process. Just a tid. */
3113 pp
= unpack_varlen_hex (p
, &tid
);
3115 /* Return null_ptid when no thread id is found. */
3123 /* Since the stub is not sending a process id, then default to
3124 what's in inferior_ptid, unless it's null at this point. If so,
3125 then since there's no way to know the pid of the reported
3126 threads, use the magic number. */
3127 if (inferior_ptid
== null_ptid
)
3128 pid
= magic_null_ptid
.pid ();
3130 pid
= inferior_ptid
.pid ();
3134 return ptid_t (pid
, tid
);
3140 if (ch
>= 'a' && ch
<= 'f')
3141 return ch
- 'a' + 10;
3142 if (ch
>= '0' && ch
<= '9')
3144 if (ch
>= 'A' && ch
<= 'F')
3145 return ch
- 'A' + 10;
3150 stub_unpack_int (const char *buff
, int fieldlength
)
3157 nibble
= stubhex (*buff
++);
3161 retval
= retval
<< 4;
3167 unpack_nibble (const char *buf
, int *val
)
3169 *val
= fromhex (*buf
++);
3174 unpack_byte (const char *buf
, int *value
)
3176 *value
= stub_unpack_int (buf
, 2);
3181 pack_int (char *buf
, int value
)
3183 buf
= pack_hex_byte (buf
, (value
>> 24) & 0xff);
3184 buf
= pack_hex_byte (buf
, (value
>> 16) & 0xff);
3185 buf
= pack_hex_byte (buf
, (value
>> 8) & 0x0ff);
3186 buf
= pack_hex_byte (buf
, (value
& 0xff));
3191 unpack_int (const char *buf
, int *value
)
3193 *value
= stub_unpack_int (buf
, 8);
3197 #if 0 /* Currently unused, uncomment when needed. */
3198 static char *pack_string (char *pkt
, char *string
);
3201 pack_string (char *pkt
, char *string
)
3206 len
= strlen (string
);
3208 len
= 200; /* Bigger than most GDB packets, junk??? */
3209 pkt
= pack_hex_byte (pkt
, len
);
3213 if ((ch
== '\0') || (ch
== '#'))
3214 ch
= '*'; /* Protect encapsulation. */
3219 #endif /* 0 (unused) */
3222 unpack_string (const char *src
, char *dest
, int length
)
3231 pack_threadid (char *pkt
, threadref
*id
)
3234 unsigned char *altid
;
3236 altid
= (unsigned char *) id
;
3237 limit
= pkt
+ BUF_THREAD_ID_SIZE
;
3239 pkt
= pack_hex_byte (pkt
, *altid
++);
3245 unpack_threadid (const char *inbuf
, threadref
*id
)
3248 const char *limit
= inbuf
+ BUF_THREAD_ID_SIZE
;
3251 altref
= (char *) id
;
3253 while (inbuf
< limit
)
3255 x
= stubhex (*inbuf
++);
3256 y
= stubhex (*inbuf
++);
3257 *altref
++ = (x
<< 4) | y
;
3262 /* Externally, threadrefs are 64 bits but internally, they are still
3263 ints. This is due to a mismatch of specifications. We would like
3264 to use 64bit thread references internally. This is an adapter
3268 int_to_threadref (threadref
*id
, int value
)
3270 unsigned char *scan
;
3272 scan
= (unsigned char *) id
;
3278 *scan
++ = (value
>> 24) & 0xff;
3279 *scan
++ = (value
>> 16) & 0xff;
3280 *scan
++ = (value
>> 8) & 0xff;
3281 *scan
++ = (value
& 0xff);
3285 threadref_to_int (threadref
*ref
)
3288 unsigned char *scan
;
3294 value
= (value
<< 8) | ((*scan
++) & 0xff);
3299 copy_threadref (threadref
*dest
, threadref
*src
)
3302 unsigned char *csrc
, *cdest
;
3304 csrc
= (unsigned char *) src
;
3305 cdest
= (unsigned char *) dest
;
3312 threadmatch (threadref
*dest
, threadref
*src
)
3314 /* Things are broken right now, so just assume we got a match. */
3316 unsigned char *srcp
, *destp
;
3318 srcp
= (char *) src
;
3319 destp
= (char *) dest
;
3323 result
&= (*srcp
++ == *destp
++) ? 1 : 0;
3330 threadid:1, # always request threadid
3337 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
3340 pack_threadinfo_request (char *pkt
, int mode
, threadref
*id
)
3342 *pkt
++ = 'q'; /* Info Query */
3343 *pkt
++ = 'P'; /* process or thread info */
3344 pkt
= pack_int (pkt
, mode
); /* mode */
3345 pkt
= pack_threadid (pkt
, id
); /* threadid */
3346 *pkt
= '\0'; /* terminate */
3350 /* These values tag the fields in a thread info response packet. */
3351 /* Tagging the fields allows us to request specific fields and to
3352 add more fields as time goes by. */
3354 #define TAG_THREADID 1 /* Echo the thread identifier. */
3355 #define TAG_EXISTS 2 /* Is this process defined enough to
3356 fetch registers and its stack? */
3357 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
3358 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
3359 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
3363 remote_target::remote_unpack_thread_info_response (const char *pkt
,
3364 threadref
*expectedref
,
3365 gdb_ext_thread_info
*info
)
3367 struct remote_state
*rs
= get_remote_state ();
3371 const char *limit
= pkt
+ rs
->buf
.size (); /* Plausible parsing limit. */
3374 /* info->threadid = 0; FIXME: implement zero_threadref. */
3376 info
->display
[0] = '\0';
3377 info
->shortname
[0] = '\0';
3378 info
->more_display
[0] = '\0';
3380 /* Assume the characters indicating the packet type have been
3382 pkt
= unpack_int (pkt
, &mask
); /* arg mask */
3383 pkt
= unpack_threadid (pkt
, &ref
);
3386 warning (_("Incomplete response to threadinfo request."));
3387 if (!threadmatch (&ref
, expectedref
))
3388 { /* This is an answer to a different request. */
3389 warning (_("ERROR RMT Thread info mismatch."));
3392 copy_threadref (&info
->threadid
, &ref
);
3394 /* Loop on tagged fields , try to bail if something goes wrong. */
3396 /* Packets are terminated with nulls. */
3397 while ((pkt
< limit
) && mask
&& *pkt
)
3399 pkt
= unpack_int (pkt
, &tag
); /* tag */
3400 pkt
= unpack_byte (pkt
, &length
); /* length */
3401 if (!(tag
& mask
)) /* Tags out of synch with mask. */
3403 warning (_("ERROR RMT: threadinfo tag mismatch."));
3407 if (tag
== TAG_THREADID
)
3411 warning (_("ERROR RMT: length of threadid is not 16."));
3415 pkt
= unpack_threadid (pkt
, &ref
);
3416 mask
= mask
& ~TAG_THREADID
;
3419 if (tag
== TAG_EXISTS
)
3421 info
->active
= stub_unpack_int (pkt
, length
);
3423 mask
= mask
& ~(TAG_EXISTS
);
3426 warning (_("ERROR RMT: 'exists' length too long."));
3432 if (tag
== TAG_THREADNAME
)
3434 pkt
= unpack_string (pkt
, &info
->shortname
[0], length
);
3435 mask
= mask
& ~TAG_THREADNAME
;
3438 if (tag
== TAG_DISPLAY
)
3440 pkt
= unpack_string (pkt
, &info
->display
[0], length
);
3441 mask
= mask
& ~TAG_DISPLAY
;
3444 if (tag
== TAG_MOREDISPLAY
)
3446 pkt
= unpack_string (pkt
, &info
->more_display
[0], length
);
3447 mask
= mask
& ~TAG_MOREDISPLAY
;
3450 warning (_("ERROR RMT: unknown thread info tag."));
3451 break; /* Not a tag we know about. */
3457 remote_target::remote_get_threadinfo (threadref
*threadid
,
3459 gdb_ext_thread_info
*info
)
3461 struct remote_state
*rs
= get_remote_state ();
3464 pack_threadinfo_request (rs
->buf
.data (), fieldset
, threadid
);
3466 getpkt (&rs
->buf
, 0);
3468 if (rs
->buf
[0] == '\0')
3471 result
= remote_unpack_thread_info_response (&rs
->buf
[2],
3476 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
3479 pack_threadlist_request (char *pkt
, int startflag
, int threadcount
,
3480 threadref
*nextthread
)
3482 *pkt
++ = 'q'; /* info query packet */
3483 *pkt
++ = 'L'; /* Process LIST or threadLIST request */
3484 pkt
= pack_nibble (pkt
, startflag
); /* initflag 1 bytes */
3485 pkt
= pack_hex_byte (pkt
, threadcount
); /* threadcount 2 bytes */
3486 pkt
= pack_threadid (pkt
, nextthread
); /* 64 bit thread identifier */
3491 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
3494 remote_target::parse_threadlist_response (const char *pkt
, int result_limit
,
3495 threadref
*original_echo
,
3496 threadref
*resultlist
,
3499 struct remote_state
*rs
= get_remote_state ();
3500 int count
, resultcount
, done
;
3503 /* Assume the 'q' and 'M chars have been stripped. */
3504 const char *limit
= pkt
+ (rs
->buf
.size () - BUF_THREAD_ID_SIZE
);
3505 /* done parse past here */
3506 pkt
= unpack_byte (pkt
, &count
); /* count field */
3507 pkt
= unpack_nibble (pkt
, &done
);
3508 /* The first threadid is the argument threadid. */
3509 pkt
= unpack_threadid (pkt
, original_echo
); /* should match query packet */
3510 while ((count
-- > 0) && (pkt
< limit
))
3512 pkt
= unpack_threadid (pkt
, resultlist
++);
3513 if (resultcount
++ >= result_limit
)
3521 /* Fetch the next batch of threads from the remote. Returns -1 if the
3522 qL packet is not supported, 0 on error and 1 on success. */
3525 remote_target::remote_get_threadlist (int startflag
, threadref
*nextthread
,
3526 int result_limit
, int *done
, int *result_count
,
3527 threadref
*threadlist
)
3529 struct remote_state
*rs
= get_remote_state ();
3532 /* Truncate result limit to be smaller than the packet size. */
3533 if ((((result_limit
+ 1) * BUF_THREAD_ID_SIZE
) + 10)
3534 >= get_remote_packet_size ())
3535 result_limit
= (get_remote_packet_size () / BUF_THREAD_ID_SIZE
) - 2;
3537 pack_threadlist_request (rs
->buf
.data (), startflag
, result_limit
,
3540 getpkt (&rs
->buf
, 0);
3541 if (rs
->buf
[0] == '\0')
3543 /* Packet not supported. */
3548 parse_threadlist_response (&rs
->buf
[2], result_limit
,
3549 &rs
->echo_nextthread
, threadlist
, done
);
3551 if (!threadmatch (&rs
->echo_nextthread
, nextthread
))
3553 /* FIXME: This is a good reason to drop the packet. */
3554 /* Possibly, there is a duplicate response. */
3556 retransmit immediatly - race conditions
3557 retransmit after timeout - yes
3559 wait for packet, then exit
3561 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
3562 return 0; /* I choose simply exiting. */
3564 if (*result_count
<= 0)
3568 warning (_("RMT ERROR : failed to get remote thread list."));
3571 return result
; /* break; */
3573 if (*result_count
> result_limit
)
3576 warning (_("RMT ERROR: threadlist response longer than requested."));
3582 /* Fetch the list of remote threads, with the qL packet, and call
3583 STEPFUNCTION for each thread found. Stops iterating and returns 1
3584 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
3585 STEPFUNCTION returns false. If the packet is not supported,
3589 remote_target::remote_threadlist_iterator (rmt_thread_action stepfunction
,
3590 void *context
, int looplimit
)
3592 struct remote_state
*rs
= get_remote_state ();
3593 int done
, i
, result_count
;
3601 if (loopcount
++ > looplimit
)
3604 warning (_("Remote fetch threadlist -infinite loop-."));
3607 result
= remote_get_threadlist (startflag
, &rs
->nextthread
,
3608 MAXTHREADLISTRESULTS
,
3609 &done
, &result_count
,
3610 rs
->resultthreadlist
);
3613 /* Clear for later iterations. */
3615 /* Setup to resume next batch of thread references, set nextthread. */
3616 if (result_count
>= 1)
3617 copy_threadref (&rs
->nextthread
,
3618 &rs
->resultthreadlist
[result_count
- 1]);
3620 while (result_count
--)
3622 if (!(*stepfunction
) (&rs
->resultthreadlist
[i
++], context
))
3632 /* A thread found on the remote target. */
3636 explicit thread_item (ptid_t ptid_
)
3640 thread_item (thread_item
&&other
) = default;
3641 thread_item
&operator= (thread_item
&&other
) = default;
3643 DISABLE_COPY_AND_ASSIGN (thread_item
);
3645 /* The thread's PTID. */
3648 /* The thread's extra info. */
3651 /* The thread's name. */
3654 /* The core the thread was running on. -1 if not known. */
3657 /* The thread handle associated with the thread. */
3658 gdb::byte_vector thread_handle
;
3661 /* Context passed around to the various methods listing remote
3662 threads. As new threads are found, they're added to the ITEMS
3665 struct threads_listing_context
3667 /* Return true if this object contains an entry for a thread with ptid
3670 bool contains_thread (ptid_t ptid
) const
3672 auto match_ptid
= [&] (const thread_item
&item
)
3674 return item
.ptid
== ptid
;
3677 auto it
= std::find_if (this->items
.begin (),
3681 return it
!= this->items
.end ();
3684 /* Remove the thread with ptid PTID. */
3686 void remove_thread (ptid_t ptid
)
3688 auto match_ptid
= [&] (const thread_item
&item
)
3690 return item
.ptid
== ptid
;
3693 auto it
= std::remove_if (this->items
.begin (),
3697 if (it
!= this->items
.end ())
3698 this->items
.erase (it
);
3701 /* The threads found on the remote target. */
3702 std::vector
<thread_item
> items
;
3706 remote_newthread_step (threadref
*ref
, void *data
)
3708 struct threads_listing_context
*context
3709 = (struct threads_listing_context
*) data
;
3710 int pid
= inferior_ptid
.pid ();
3711 int lwp
= threadref_to_int (ref
);
3712 ptid_t
ptid (pid
, lwp
);
3714 context
->items
.emplace_back (ptid
);
3716 return 1; /* continue iterator */
3719 #define CRAZY_MAX_THREADS 1000
3722 remote_target::remote_current_thread (ptid_t oldpid
)
3724 struct remote_state
*rs
= get_remote_state ();
3727 getpkt (&rs
->buf
, 0);
3728 if (rs
->buf
[0] == 'Q' && rs
->buf
[1] == 'C')
3733 result
= read_ptid (&rs
->buf
[2], &obuf
);
3735 remote_debug_printf ("warning: garbage in qC reply");
3743 /* List remote threads using the deprecated qL packet. */
3746 remote_target::remote_get_threads_with_ql (threads_listing_context
*context
)
3748 if (remote_threadlist_iterator (remote_newthread_step
, context
,
3749 CRAZY_MAX_THREADS
) >= 0)
3755 #if defined(HAVE_LIBEXPAT)
3758 start_thread (struct gdb_xml_parser
*parser
,
3759 const struct gdb_xml_element
*element
,
3761 std::vector
<gdb_xml_value
> &attributes
)
3763 struct threads_listing_context
*data
3764 = (struct threads_listing_context
*) user_data
;
3765 struct gdb_xml_value
*attr
;
3767 char *id
= (char *) xml_find_attribute (attributes
, "id")->value
.get ();
3768 ptid_t ptid
= read_ptid (id
, NULL
);
3770 data
->items
.emplace_back (ptid
);
3771 thread_item
&item
= data
->items
.back ();
3773 attr
= xml_find_attribute (attributes
, "core");
3775 item
.core
= *(ULONGEST
*) attr
->value
.get ();
3777 attr
= xml_find_attribute (attributes
, "name");
3779 item
.name
= (const char *) attr
->value
.get ();
3781 attr
= xml_find_attribute (attributes
, "handle");
3783 item
.thread_handle
= hex2bin ((const char *) attr
->value
.get ());
3787 end_thread (struct gdb_xml_parser
*parser
,
3788 const struct gdb_xml_element
*element
,
3789 void *user_data
, const char *body_text
)
3791 struct threads_listing_context
*data
3792 = (struct threads_listing_context
*) user_data
;
3794 if (body_text
!= NULL
&& *body_text
!= '\0')
3795 data
->items
.back ().extra
= body_text
;
3798 const struct gdb_xml_attribute thread_attributes
[] = {
3799 { "id", GDB_XML_AF_NONE
, NULL
, NULL
},
3800 { "core", GDB_XML_AF_OPTIONAL
, gdb_xml_parse_attr_ulongest
, NULL
},
3801 { "name", GDB_XML_AF_OPTIONAL
, NULL
, NULL
},
3802 { "handle", GDB_XML_AF_OPTIONAL
, NULL
, NULL
},
3803 { NULL
, GDB_XML_AF_NONE
, NULL
, NULL
}
3806 const struct gdb_xml_element thread_children
[] = {
3807 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3810 const struct gdb_xml_element threads_children
[] = {
3811 { "thread", thread_attributes
, thread_children
,
3812 GDB_XML_EF_REPEATABLE
| GDB_XML_EF_OPTIONAL
,
3813 start_thread
, end_thread
},
3814 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3817 const struct gdb_xml_element threads_elements
[] = {
3818 { "threads", NULL
, threads_children
,
3819 GDB_XML_EF_NONE
, NULL
, NULL
},
3820 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3825 /* List remote threads using qXfer:threads:read. */
3828 remote_target::remote_get_threads_with_qxfer (threads_listing_context
*context
)
3830 #if defined(HAVE_LIBEXPAT)
3831 if (packet_support (PACKET_qXfer_threads
) == PACKET_ENABLE
)
3833 gdb::optional
<gdb::char_vector
> xml
3834 = target_read_stralloc (this, TARGET_OBJECT_THREADS
, NULL
);
3836 if (xml
&& (*xml
)[0] != '\0')
3838 gdb_xml_parse_quick (_("threads"), "threads.dtd",
3839 threads_elements
, xml
->data (), context
);
3849 /* List remote threads using qfThreadInfo/qsThreadInfo. */
3852 remote_target::remote_get_threads_with_qthreadinfo (threads_listing_context
*context
)
3854 struct remote_state
*rs
= get_remote_state ();
3856 if (rs
->use_threadinfo_query
)
3860 putpkt ("qfThreadInfo");
3861 getpkt (&rs
->buf
, 0);
3862 bufp
= rs
->buf
.data ();
3863 if (bufp
[0] != '\0') /* q packet recognized */
3865 while (*bufp
++ == 'm') /* reply contains one or more TID */
3869 ptid_t ptid
= read_ptid (bufp
, &bufp
);
3870 context
->items
.emplace_back (ptid
);
3872 while (*bufp
++ == ','); /* comma-separated list */
3873 putpkt ("qsThreadInfo");
3874 getpkt (&rs
->buf
, 0);
3875 bufp
= rs
->buf
.data ();
3881 /* Packet not recognized. */
3882 rs
->use_threadinfo_query
= 0;
3889 /* Return true if INF only has one non-exited thread. */
3892 has_single_non_exited_thread (inferior
*inf
)
3895 for (thread_info
*tp ATTRIBUTE_UNUSED
: inf
->non_exited_threads ())
3901 /* Implement the to_update_thread_list function for the remote
3905 remote_target::update_thread_list ()
3907 struct threads_listing_context context
;
3910 /* We have a few different mechanisms to fetch the thread list. Try
3911 them all, starting with the most preferred one first, falling
3912 back to older methods. */
3913 if (remote_get_threads_with_qxfer (&context
)
3914 || remote_get_threads_with_qthreadinfo (&context
)
3915 || remote_get_threads_with_ql (&context
))
3919 if (context
.items
.empty ()
3920 && remote_thread_always_alive (inferior_ptid
))
3922 /* Some targets don't really support threads, but still
3923 reply an (empty) thread list in response to the thread
3924 listing packets, instead of replying "packet not
3925 supported". Exit early so we don't delete the main
3930 /* CONTEXT now holds the current thread list on the remote
3931 target end. Delete GDB-side threads no longer found on the
3933 for (thread_info
*tp
: all_threads_safe ())
3935 if (tp
->inf
->process_target () != this)
3938 if (!context
.contains_thread (tp
->ptid
))
3940 /* Do not remove the thread if it is the last thread in
3941 the inferior. This situation happens when we have a
3942 pending exit process status to process. Otherwise we
3943 may end up with a seemingly live inferior (i.e. pid
3944 != 0) that has no threads. */
3945 if (has_single_non_exited_thread (tp
->inf
))
3953 /* Remove any unreported fork child threads from CONTEXT so
3954 that we don't interfere with follow fork, which is where
3955 creation of such threads is handled. */
3956 remove_new_fork_children (&context
);
3958 /* And now add threads we don't know about yet to our list. */
3959 for (thread_item
&item
: context
.items
)
3961 if (item
.ptid
!= null_ptid
)
3963 /* In non-stop mode, we assume new found threads are
3964 executing until proven otherwise with a stop reply.
3965 In all-stop, we can only get here if all threads are
3967 bool executing
= target_is_non_stop_p ();
3969 remote_notice_new_inferior (item
.ptid
, executing
);
3971 thread_info
*tp
= find_thread_ptid (this, item
.ptid
);
3972 remote_thread_info
*info
= get_remote_thread_info (tp
);
3973 info
->core
= item
.core
;
3974 info
->extra
= std::move (item
.extra
);
3975 info
->name
= std::move (item
.name
);
3976 info
->thread_handle
= std::move (item
.thread_handle
);
3983 /* If no thread listing method is supported, then query whether
3984 each known thread is alive, one by one, with the T packet.
3985 If the target doesn't support threads at all, then this is a
3986 no-op. See remote_thread_alive. */
3992 * Collect a descriptive string about the given thread.
3993 * The target may say anything it wants to about the thread
3994 * (typically info about its blocked / runnable state, name, etc.).
3995 * This string will appear in the info threads display.
3997 * Optional: targets are not required to implement this function.
4001 remote_target::extra_thread_info (thread_info
*tp
)
4003 struct remote_state
*rs
= get_remote_state ();
4006 struct gdb_ext_thread_info threadinfo
;
4008 if (rs
->remote_desc
== 0) /* paranoia */
4009 internal_error (__FILE__
, __LINE__
,
4010 _("remote_threads_extra_info"));
4012 if (tp
->ptid
== magic_null_ptid
4013 || (tp
->ptid
.pid () != 0 && tp
->ptid
.lwp () == 0))
4014 /* This is the main thread which was added by GDB. The remote
4015 server doesn't know about it. */
4018 std::string
&extra
= get_remote_thread_info (tp
)->extra
;
4020 /* If already have cached info, use it. */
4021 if (!extra
.empty ())
4022 return extra
.c_str ();
4024 if (packet_support (PACKET_qXfer_threads
) == PACKET_ENABLE
)
4026 /* If we're using qXfer:threads:read, then the extra info is
4027 included in the XML. So if we didn't have anything cached,
4028 it's because there's really no extra info. */
4032 if (rs
->use_threadextra_query
)
4034 char *b
= rs
->buf
.data ();
4035 char *endb
= b
+ get_remote_packet_size ();
4037 xsnprintf (b
, endb
- b
, "qThreadExtraInfo,");
4039 write_ptid (b
, endb
, tp
->ptid
);
4042 getpkt (&rs
->buf
, 0);
4043 if (rs
->buf
[0] != 0)
4045 extra
.resize (strlen (rs
->buf
.data ()) / 2);
4046 hex2bin (rs
->buf
.data (), (gdb_byte
*) &extra
[0], extra
.size ());
4047 return extra
.c_str ();
4051 /* If the above query fails, fall back to the old method. */
4052 rs
->use_threadextra_query
= 0;
4053 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
4054 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
4055 int_to_threadref (&id
, tp
->ptid
.lwp ());
4056 if (remote_get_threadinfo (&id
, set
, &threadinfo
))
4057 if (threadinfo
.active
)
4059 if (*threadinfo
.shortname
)
4060 string_appendf (extra
, " Name: %s", threadinfo
.shortname
);
4061 if (*threadinfo
.display
)
4063 if (!extra
.empty ())
4065 string_appendf (extra
, " State: %s", threadinfo
.display
);
4067 if (*threadinfo
.more_display
)
4069 if (!extra
.empty ())
4071 string_appendf (extra
, " Priority: %s", threadinfo
.more_display
);
4073 return extra
.c_str ();
4080 remote_target::static_tracepoint_marker_at (CORE_ADDR addr
,
4081 struct static_tracepoint_marker
*marker
)
4083 struct remote_state
*rs
= get_remote_state ();
4084 char *p
= rs
->buf
.data ();
4086 xsnprintf (p
, get_remote_packet_size (), "qTSTMat:");
4088 p
+= hexnumstr (p
, addr
);
4090 getpkt (&rs
->buf
, 0);
4091 p
= rs
->buf
.data ();
4094 error (_("Remote failure reply: %s"), p
);
4098 parse_static_tracepoint_marker_definition (p
, NULL
, marker
);
4105 std::vector
<static_tracepoint_marker
>
4106 remote_target::static_tracepoint_markers_by_strid (const char *strid
)
4108 struct remote_state
*rs
= get_remote_state ();
4109 std::vector
<static_tracepoint_marker
> markers
;
4111 static_tracepoint_marker marker
;
4113 /* Ask for a first packet of static tracepoint marker
4116 getpkt (&rs
->buf
, 0);
4117 p
= rs
->buf
.data ();
4119 error (_("Remote failure reply: %s"), p
);
4125 parse_static_tracepoint_marker_definition (p
, &p
, &marker
);
4127 if (strid
== NULL
|| marker
.str_id
== strid
)
4128 markers
.push_back (std::move (marker
));
4130 while (*p
++ == ','); /* comma-separated list */
4131 /* Ask for another packet of static tracepoint definition. */
4133 getpkt (&rs
->buf
, 0);
4134 p
= rs
->buf
.data ();
4141 /* Implement the to_get_ada_task_ptid function for the remote targets. */
4144 remote_target::get_ada_task_ptid (long lwp
, ULONGEST thread
)
4146 return ptid_t (inferior_ptid
.pid (), lwp
);
4150 /* Restart the remote side; this is an extended protocol operation. */
4153 remote_target::extended_remote_restart ()
4155 struct remote_state
*rs
= get_remote_state ();
4157 /* Send the restart command; for reasons I don't understand the
4158 remote side really expects a number after the "R". */
4159 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "R%x", 0);
4162 remote_fileio_reset ();
4165 /* Clean up connection to a remote debugger. */
4168 remote_target::close ()
4170 /* Make sure we leave stdin registered in the event loop. */
4173 trace_reset_local_state ();
4178 remote_target::~remote_target ()
4180 struct remote_state
*rs
= get_remote_state ();
4182 /* Check for NULL because we may get here with a partially
4183 constructed target/connection. */
4184 if (rs
->remote_desc
== nullptr)
4187 serial_close (rs
->remote_desc
);
4189 /* We are destroying the remote target, so we should discard
4190 everything of this target. */
4191 discard_pending_stop_replies_in_queue ();
4193 if (rs
->remote_async_inferior_event_token
)
4194 delete_async_event_handler (&rs
->remote_async_inferior_event_token
);
4196 delete rs
->notif_state
;
4199 /* Query the remote side for the text, data and bss offsets. */
4202 remote_target::get_offsets ()
4204 struct remote_state
*rs
= get_remote_state ();
4207 int lose
, num_segments
= 0, do_sections
, do_segments
;
4208 CORE_ADDR text_addr
, data_addr
, bss_addr
, segments
[2];
4210 if (current_program_space
->symfile_object_file
== NULL
)
4213 putpkt ("qOffsets");
4214 getpkt (&rs
->buf
, 0);
4215 buf
= rs
->buf
.data ();
4217 if (buf
[0] == '\000')
4218 return; /* Return silently. Stub doesn't support
4222 warning (_("Remote failure reply: %s"), buf
);
4226 /* Pick up each field in turn. This used to be done with scanf, but
4227 scanf will make trouble if CORE_ADDR size doesn't match
4228 conversion directives correctly. The following code will work
4229 with any size of CORE_ADDR. */
4230 text_addr
= data_addr
= bss_addr
= 0;
4234 if (startswith (ptr
, "Text="))
4237 /* Don't use strtol, could lose on big values. */
4238 while (*ptr
&& *ptr
!= ';')
4239 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
4241 if (startswith (ptr
, ";Data="))
4244 while (*ptr
&& *ptr
!= ';')
4245 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
4250 if (!lose
&& startswith (ptr
, ";Bss="))
4253 while (*ptr
&& *ptr
!= ';')
4254 bss_addr
= (bss_addr
<< 4) + fromhex (*ptr
++);
4256 if (bss_addr
!= data_addr
)
4257 warning (_("Target reported unsupported offsets: %s"), buf
);
4262 else if (startswith (ptr
, "TextSeg="))
4265 /* Don't use strtol, could lose on big values. */
4266 while (*ptr
&& *ptr
!= ';')
4267 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
4270 if (startswith (ptr
, ";DataSeg="))
4273 while (*ptr
&& *ptr
!= ';')
4274 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
4282 error (_("Malformed response to offset query, %s"), buf
);
4283 else if (*ptr
!= '\0')
4284 warning (_("Target reported unsupported offsets: %s"), buf
);
4286 objfile
*objf
= current_program_space
->symfile_object_file
;
4287 section_offsets offs
= objf
->section_offsets
;
4289 symfile_segment_data_up data
= get_symfile_segment_data (objf
->obfd
);
4290 do_segments
= (data
!= NULL
);
4291 do_sections
= num_segments
== 0;
4293 if (num_segments
> 0)
4295 segments
[0] = text_addr
;
4296 segments
[1] = data_addr
;
4298 /* If we have two segments, we can still try to relocate everything
4299 by assuming that the .text and .data offsets apply to the whole
4300 text and data segments. Convert the offsets given in the packet
4301 to base addresses for symfile_map_offsets_to_segments. */
4302 else if (data
!= nullptr && data
->segments
.size () == 2)
4304 segments
[0] = data
->segments
[0].base
+ text_addr
;
4305 segments
[1] = data
->segments
[1].base
+ data_addr
;
4308 /* If the object file has only one segment, assume that it is text
4309 rather than data; main programs with no writable data are rare,
4310 but programs with no code are useless. Of course the code might
4311 have ended up in the data segment... to detect that we would need
4312 the permissions here. */
4313 else if (data
&& data
->segments
.size () == 1)
4315 segments
[0] = data
->segments
[0].base
+ text_addr
;
4318 /* There's no way to relocate by segment. */
4324 int ret
= symfile_map_offsets_to_segments (objf
->obfd
,
4326 num_segments
, segments
);
4328 if (ret
== 0 && !do_sections
)
4329 error (_("Can not handle qOffsets TextSeg "
4330 "response with this symbol file"));
4338 offs
[SECT_OFF_TEXT (objf
)] = text_addr
;
4340 /* This is a temporary kludge to force data and bss to use the
4341 same offsets because that's what nlmconv does now. The real
4342 solution requires changes to the stub and remote.c that I
4343 don't have time to do right now. */
4345 offs
[SECT_OFF_DATA (objf
)] = data_addr
;
4346 offs
[SECT_OFF_BSS (objf
)] = data_addr
;
4349 objfile_relocate (objf
, offs
);
4352 /* Send interrupt_sequence to remote target. */
4355 remote_target::send_interrupt_sequence ()
4357 struct remote_state
*rs
= get_remote_state ();
4359 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
4360 remote_serial_write ("\x03", 1);
4361 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
4362 serial_send_break (rs
->remote_desc
);
4363 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
4365 serial_send_break (rs
->remote_desc
);
4366 remote_serial_write ("g", 1);
4369 internal_error (__FILE__
, __LINE__
,
4370 _("Invalid value for interrupt_sequence_mode: %s."),
4371 interrupt_sequence_mode
);
4375 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
4376 and extract the PTID. Returns NULL_PTID if not found. */
4379 stop_reply_extract_thread (const char *stop_reply
)
4381 if (stop_reply
[0] == 'T' && strlen (stop_reply
) > 3)
4385 /* Txx r:val ; r:val (...) */
4388 /* Look for "register" named "thread". */
4393 p1
= strchr (p
, ':');
4397 if (strncmp (p
, "thread", p1
- p
) == 0)
4398 return read_ptid (++p1
, &p
);
4400 p1
= strchr (p
, ';');
4412 /* Determine the remote side's current thread. If we have a stop
4413 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
4414 "thread" register we can extract the current thread from. If not,
4415 ask the remote which is the current thread with qC. The former
4416 method avoids a roundtrip. */
4419 remote_target::get_current_thread (const char *wait_status
)
4421 ptid_t ptid
= null_ptid
;
4423 /* Note we don't use remote_parse_stop_reply as that makes use of
4424 the target architecture, which we haven't yet fully determined at
4426 if (wait_status
!= NULL
)
4427 ptid
= stop_reply_extract_thread (wait_status
);
4428 if (ptid
== null_ptid
)
4429 ptid
= remote_current_thread (inferior_ptid
);
4434 /* Query the remote target for which is the current thread/process,
4435 add it to our tables, and update INFERIOR_PTID. The caller is
4436 responsible for setting the state such that the remote end is ready
4437 to return the current thread.
4439 This function is called after handling the '?' or 'vRun' packets,
4440 whose response is a stop reply from which we can also try
4441 extracting the thread. If the target doesn't support the explicit
4442 qC query, we infer the current thread from that stop reply, passed
4443 in in WAIT_STATUS, which may be NULL.
4445 The function returns pointer to the main thread of the inferior. */
4448 remote_target::add_current_inferior_and_thread (const char *wait_status
)
4450 struct remote_state
*rs
= get_remote_state ();
4451 bool fake_pid_p
= false;
4453 switch_to_no_thread ();
4455 /* Now, if we have thread information, update the current thread's
4457 ptid_t curr_ptid
= get_current_thread (wait_status
);
4459 if (curr_ptid
!= null_ptid
)
4461 if (!remote_multi_process_p (rs
))
4466 /* Without this, some commands which require an active target
4467 (such as kill) won't work. This variable serves (at least)
4468 double duty as both the pid of the target process (if it has
4469 such), and as a flag indicating that a target is active. */
4470 curr_ptid
= magic_null_ptid
;
4474 remote_add_inferior (fake_pid_p
, curr_ptid
.pid (), -1, 1);
4476 /* Add the main thread and switch to it. Don't try reading
4477 registers yet, since we haven't fetched the target description
4479 thread_info
*tp
= add_thread_silent (this, curr_ptid
);
4480 switch_to_thread_no_regs (tp
);
4485 /* Print info about a thread that was found already stopped on
4489 remote_target::print_one_stopped_thread (thread_info
*thread
)
4491 target_waitstatus ws
;
4493 /* If there is a pending waitstatus, use it. If there isn't it's because
4494 the thread's stop was reported with TARGET_WAITKIND_STOPPED / GDB_SIGNAL_0
4495 and process_initial_stop_replies decided it wasn't interesting to save
4496 and report to the core. */
4497 if (thread
->has_pending_waitstatus ())
4499 ws
= thread
->pending_waitstatus ();
4500 thread
->clear_pending_waitstatus ();
4504 ws
.set_stopped (GDB_SIGNAL_0
);
4507 switch_to_thread (thread
);
4508 thread
->set_stop_pc (get_frame_pc (get_current_frame ()));
4509 set_current_sal_from_frame (get_current_frame ());
4511 /* For "info program". */
4512 set_last_target_status (this, thread
->ptid
, ws
);
4514 if (ws
.kind () == TARGET_WAITKIND_STOPPED
)
4516 enum gdb_signal sig
= ws
.sig ();
4518 if (signal_print_state (sig
))
4519 gdb::observers::signal_received
.notify (sig
);
4521 gdb::observers::normal_stop
.notify (NULL
, 1);
4524 /* Process all initial stop replies the remote side sent in response
4525 to the ? packet. These indicate threads that were already stopped
4526 on initial connection. We mark these threads as stopped and print
4527 their current frame before giving the user the prompt. */
4530 remote_target::process_initial_stop_replies (int from_tty
)
4532 int pending_stop_replies
= stop_reply_queue_length ();
4533 struct thread_info
*selected
= NULL
;
4534 struct thread_info
*lowest_stopped
= NULL
;
4535 struct thread_info
*first
= NULL
;
4537 /* This is only used when the target is non-stop. */
4538 gdb_assert (target_is_non_stop_p ());
4540 /* Consume the initial pending events. */
4541 while (pending_stop_replies
-- > 0)
4543 ptid_t waiton_ptid
= minus_one_ptid
;
4545 struct target_waitstatus ws
;
4546 int ignore_event
= 0;
4548 event_ptid
= target_wait (waiton_ptid
, &ws
, TARGET_WNOHANG
);
4550 print_target_wait_results (waiton_ptid
, event_ptid
, ws
);
4554 case TARGET_WAITKIND_IGNORE
:
4555 case TARGET_WAITKIND_NO_RESUMED
:
4556 case TARGET_WAITKIND_SIGNALLED
:
4557 case TARGET_WAITKIND_EXITED
:
4558 /* We shouldn't see these, but if we do, just ignore. */
4559 remote_debug_printf ("event ignored");
4570 thread_info
*evthread
= find_thread_ptid (this, event_ptid
);
4572 if (ws
.kind () == TARGET_WAITKIND_STOPPED
)
4574 enum gdb_signal sig
= ws
.sig ();
4576 /* Stubs traditionally report SIGTRAP as initial signal,
4577 instead of signal 0. Suppress it. */
4578 if (sig
== GDB_SIGNAL_TRAP
)
4580 evthread
->set_stop_signal (sig
);
4581 ws
.set_stopped (sig
);
4584 if (ws
.kind () != TARGET_WAITKIND_STOPPED
4585 || ws
.sig () != GDB_SIGNAL_0
)
4586 evthread
->set_pending_waitstatus (ws
);
4588 set_executing (this, event_ptid
, false);
4589 set_running (this, event_ptid
, false);
4590 get_remote_thread_info (evthread
)->set_not_resumed ();
4593 /* "Notice" the new inferiors before anything related to
4594 registers/memory. */
4595 for (inferior
*inf
: all_non_exited_inferiors (this))
4597 inf
->needs_setup
= 1;
4601 thread_info
*thread
= any_live_thread_of_inferior (inf
);
4602 notice_new_inferior (thread
, thread
->state
== THREAD_RUNNING
,
4607 /* If all-stop on top of non-stop, pause all threads. Note this
4608 records the threads' stop pc, so must be done after "noticing"
4613 /* At this point, the remote target is not async. It needs to be for
4614 the poll in stop_all_threads to consider events from it, so enable
4616 gdb_assert (!this->is_async_p ());
4617 SCOPE_EXIT
{ target_async (0); };
4619 stop_all_threads ();
4622 /* If all threads of an inferior were already stopped, we
4623 haven't setup the inferior yet. */
4624 for (inferior
*inf
: all_non_exited_inferiors (this))
4626 if (inf
->needs_setup
)
4628 thread_info
*thread
= any_live_thread_of_inferior (inf
);
4629 switch_to_thread_no_regs (thread
);
4635 /* Now go over all threads that are stopped, and print their current
4636 frame. If all-stop, then if there's a signalled thread, pick
4638 for (thread_info
*thread
: all_non_exited_threads (this))
4644 thread
->set_running (false);
4645 else if (thread
->state
!= THREAD_STOPPED
)
4648 if (selected
== nullptr && thread
->has_pending_waitstatus ())
4651 if (lowest_stopped
== NULL
4652 || thread
->inf
->num
< lowest_stopped
->inf
->num
4653 || thread
->per_inf_num
< lowest_stopped
->per_inf_num
)
4654 lowest_stopped
= thread
;
4657 print_one_stopped_thread (thread
);
4660 /* In all-stop, we only print the status of one thread, and leave
4661 others with their status pending. */
4664 thread_info
*thread
= selected
;
4666 thread
= lowest_stopped
;
4670 print_one_stopped_thread (thread
);
4674 /* Start the remote connection and sync state. */
4677 remote_target::start_remote (int from_tty
, int extended_p
)
4679 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
4681 struct remote_state
*rs
= get_remote_state ();
4682 struct packet_config
*noack_config
;
4684 /* Signal other parts that we're going through the initial setup,
4685 and so things may not be stable yet. E.g., we don't try to
4686 install tracepoints until we've relocated symbols. Also, a
4687 Ctrl-C before we're connected and synced up can't interrupt the
4688 target. Instead, it offers to drop the (potentially wedged)
4690 rs
->starting_up
= true;
4694 if (interrupt_on_connect
)
4695 send_interrupt_sequence ();
4697 /* Ack any packet which the remote side has already sent. */
4698 remote_serial_write ("+", 1);
4700 /* The first packet we send to the target is the optional "supported
4701 packets" request. If the target can answer this, it will tell us
4702 which later probes to skip. */
4703 remote_query_supported ();
4705 /* If the stub wants to get a QAllow, compose one and send it. */
4706 if (packet_support (PACKET_QAllow
) != PACKET_DISABLE
)
4709 /* gdbserver < 7.7 (before its fix from 2013-12-11) did reply to any
4710 unknown 'v' packet with string "OK". "OK" gets interpreted by GDB
4711 as a reply to known packet. For packet "vFile:setfs:" it is an
4712 invalid reply and GDB would return error in
4713 remote_hostio_set_filesystem, making remote files access impossible.
4714 Disable "vFile:setfs:" in such case. Do not disable other 'v' packets as
4715 other "vFile" packets get correctly detected even on gdbserver < 7.7. */
4717 const char v_mustreplyempty
[] = "vMustReplyEmpty";
4719 putpkt (v_mustreplyempty
);
4720 getpkt (&rs
->buf
, 0);
4721 if (strcmp (rs
->buf
.data (), "OK") == 0)
4722 remote_protocol_packets
[PACKET_vFile_setfs
].support
= PACKET_DISABLE
;
4723 else if (strcmp (rs
->buf
.data (), "") != 0)
4724 error (_("Remote replied unexpectedly to '%s': %s"), v_mustreplyempty
,
4728 /* Next, we possibly activate noack mode.
4730 If the QStartNoAckMode packet configuration is set to AUTO,
4731 enable noack mode if the stub reported a wish for it with
4734 If set to TRUE, then enable noack mode even if the stub didn't
4735 report it in qSupported. If the stub doesn't reply OK, the
4736 session ends with an error.
4738 If FALSE, then don't activate noack mode, regardless of what the
4739 stub claimed should be the default with qSupported. */
4741 noack_config
= &remote_protocol_packets
[PACKET_QStartNoAckMode
];
4742 if (packet_config_support (noack_config
) != PACKET_DISABLE
)
4744 putpkt ("QStartNoAckMode");
4745 getpkt (&rs
->buf
, 0);
4746 if (packet_ok (rs
->buf
, noack_config
) == PACKET_OK
)
4752 /* Tell the remote that we are using the extended protocol. */
4754 getpkt (&rs
->buf
, 0);
4757 /* Let the target know which signals it is allowed to pass down to
4759 update_signals_program_target ();
4761 /* Next, if the target can specify a description, read it. We do
4762 this before anything involving memory or registers. */
4763 target_find_description ();
4765 /* Next, now that we know something about the target, update the
4766 address spaces in the program spaces. */
4767 update_address_spaces ();
4769 /* On OSs where the list of libraries is global to all
4770 processes, we fetch them early. */
4771 if (gdbarch_has_global_solist (target_gdbarch ()))
4772 solib_add (NULL
, from_tty
, auto_solib_add
);
4774 if (target_is_non_stop_p ())
4776 if (packet_support (PACKET_QNonStop
) != PACKET_ENABLE
)
4777 error (_("Non-stop mode requested, but remote "
4778 "does not support non-stop"));
4780 putpkt ("QNonStop:1");
4781 getpkt (&rs
->buf
, 0);
4783 if (strcmp (rs
->buf
.data (), "OK") != 0)
4784 error (_("Remote refused setting non-stop mode with: %s"),
4787 /* Find about threads and processes the stub is already
4788 controlling. We default to adding them in the running state.
4789 The '?' query below will then tell us about which threads are
4791 this->update_thread_list ();
4793 else if (packet_support (PACKET_QNonStop
) == PACKET_ENABLE
)
4795 /* Don't assume that the stub can operate in all-stop mode.
4796 Request it explicitly. */
4797 putpkt ("QNonStop:0");
4798 getpkt (&rs
->buf
, 0);
4800 if (strcmp (rs
->buf
.data (), "OK") != 0)
4801 error (_("Remote refused setting all-stop mode with: %s"),
4805 /* Upload TSVs regardless of whether the target is running or not. The
4806 remote stub, such as GDBserver, may have some predefined or builtin
4807 TSVs, even if the target is not running. */
4808 if (get_trace_status (current_trace_status ()) != -1)
4810 struct uploaded_tsv
*uploaded_tsvs
= NULL
;
4812 upload_trace_state_variables (&uploaded_tsvs
);
4813 merge_uploaded_trace_state_variables (&uploaded_tsvs
);
4816 /* Check whether the target is running now. */
4818 getpkt (&rs
->buf
, 0);
4820 if (!target_is_non_stop_p ())
4822 char *wait_status
= NULL
;
4824 if (rs
->buf
[0] == 'W' || rs
->buf
[0] == 'X')
4827 error (_("The target is not running (try extended-remote?)"));
4829 /* We're connected, but not running. Drop out before we
4830 call start_remote. */
4831 rs
->starting_up
= false;
4836 /* Save the reply for later. */
4837 wait_status
= (char *) alloca (strlen (rs
->buf
.data ()) + 1);
4838 strcpy (wait_status
, rs
->buf
.data ());
4841 /* Fetch thread list. */
4842 target_update_thread_list ();
4844 /* Let the stub know that we want it to return the thread. */
4845 set_continue_thread (minus_one_ptid
);
4847 if (thread_count (this) == 0)
4849 /* Target has no concept of threads at all. GDB treats
4850 non-threaded target as single-threaded; add a main
4852 thread_info
*tp
= add_current_inferior_and_thread (wait_status
);
4853 get_remote_thread_info (tp
)->set_resumed ();
4857 /* We have thread information; select the thread the target
4858 says should be current. If we're reconnecting to a
4859 multi-threaded program, this will ideally be the thread
4860 that last reported an event before GDB disconnected. */
4861 ptid_t curr_thread
= get_current_thread (wait_status
);
4862 if (curr_thread
== null_ptid
)
4864 /* Odd... The target was able to list threads, but not
4865 tell us which thread was current (no "thread"
4866 register in T stop reply?). Just pick the first
4867 thread in the thread list then. */
4869 remote_debug_printf ("warning: couldn't determine remote "
4870 "current thread; picking first in list.");
4872 for (thread_info
*tp
: all_non_exited_threads (this,
4875 switch_to_thread (tp
);
4880 switch_to_thread (find_thread_ptid (this, curr_thread
));
4883 /* init_wait_for_inferior should be called before get_offsets in order
4884 to manage `inserted' flag in bp loc in a correct state.
4885 breakpoint_init_inferior, called from init_wait_for_inferior, set
4886 `inserted' flag to 0, while before breakpoint_re_set, called from
4887 start_remote, set `inserted' flag to 1. In the initialization of
4888 inferior, breakpoint_init_inferior should be called first, and then
4889 breakpoint_re_set can be called. If this order is broken, state of
4890 `inserted' flag is wrong, and cause some problems on breakpoint
4892 init_wait_for_inferior ();
4894 get_offsets (); /* Get text, data & bss offsets. */
4896 /* If we could not find a description using qXfer, and we know
4897 how to do it some other way, try again. This is not
4898 supported for non-stop; it could be, but it is tricky if
4899 there are no stopped threads when we connect. */
4900 if (remote_read_description_p (this)
4901 && gdbarch_target_desc (target_gdbarch ()) == NULL
)
4903 target_clear_description ();
4904 target_find_description ();
4907 /* Use the previously fetched status. */
4908 gdb_assert (wait_status
!= NULL
);
4909 strcpy (rs
->buf
.data (), wait_status
);
4910 rs
->cached_wait_status
= 1;
4912 ::start_remote (from_tty
); /* Initialize gdb process mechanisms. */
4916 /* Clear WFI global state. Do this before finding about new
4917 threads and inferiors, and setting the current inferior.
4918 Otherwise we would clear the proceed status of the current
4919 inferior when we want its stop_soon state to be preserved
4920 (see notice_new_inferior). */
4921 init_wait_for_inferior ();
4923 /* In non-stop, we will either get an "OK", meaning that there
4924 are no stopped threads at this time; or, a regular stop
4925 reply. In the latter case, there may be more than one thread
4926 stopped --- we pull them all out using the vStopped
4928 if (strcmp (rs
->buf
.data (), "OK") != 0)
4930 struct notif_client
*notif
= ¬if_client_stop
;
4932 /* remote_notif_get_pending_replies acks this one, and gets
4934 rs
->notif_state
->pending_event
[notif_client_stop
.id
]
4935 = remote_notif_parse (this, notif
, rs
->buf
.data ());
4936 remote_notif_get_pending_events (notif
);
4939 if (thread_count (this) == 0)
4942 error (_("The target is not running (try extended-remote?)"));
4944 /* We're connected, but not running. Drop out before we
4945 call start_remote. */
4946 rs
->starting_up
= false;
4950 /* Report all signals during attach/startup. */
4953 /* If there are already stopped threads, mark them stopped and
4954 report their stops before giving the prompt to the user. */
4955 process_initial_stop_replies (from_tty
);
4957 if (target_can_async_p ())
4961 /* If we connected to a live target, do some additional setup. */
4962 if (target_has_execution ())
4964 /* No use without a symbol-file. */
4965 if (current_program_space
->symfile_object_file
)
4966 remote_check_symbols ();
4969 /* Possibly the target has been engaged in a trace run started
4970 previously; find out where things are at. */
4971 if (get_trace_status (current_trace_status ()) != -1)
4973 struct uploaded_tp
*uploaded_tps
= NULL
;
4975 if (current_trace_status ()->running
)
4976 printf_filtered (_("Trace is already running on the target.\n"));
4978 upload_tracepoints (&uploaded_tps
);
4980 merge_uploaded_tracepoints (&uploaded_tps
);
4983 /* Possibly the target has been engaged in a btrace record started
4984 previously; find out where things are at. */
4985 remote_btrace_maybe_reopen ();
4987 /* The thread and inferior lists are now synchronized with the
4988 target, our symbols have been relocated, and we're merged the
4989 target's tracepoints with ours. We're done with basic start
4991 rs
->starting_up
= false;
4993 /* Maybe breakpoints are global and need to be inserted now. */
4994 if (breakpoints_should_be_inserted_now ())
4995 insert_breakpoints ();
4999 remote_target::connection_string ()
5001 remote_state
*rs
= get_remote_state ();
5003 if (rs
->remote_desc
->name
!= NULL
)
5004 return rs
->remote_desc
->name
;
5009 /* Open a connection to a remote debugger.
5010 NAME is the filename used for communication. */
5013 remote_target::open (const char *name
, int from_tty
)
5015 open_1 (name
, from_tty
, 0);
5018 /* Open a connection to a remote debugger using the extended
5019 remote gdb protocol. NAME is the filename used for communication. */
5022 extended_remote_target::open (const char *name
, int from_tty
)
5024 open_1 (name
, from_tty
, 1 /*extended_p */);
5027 /* Reset all packets back to "unknown support". Called when opening a
5028 new connection to a remote target. */
5031 reset_all_packet_configs_support (void)
5035 for (i
= 0; i
< PACKET_MAX
; i
++)
5036 remote_protocol_packets
[i
].support
= PACKET_SUPPORT_UNKNOWN
;
5039 /* Initialize all packet configs. */
5042 init_all_packet_configs (void)
5046 for (i
= 0; i
< PACKET_MAX
; i
++)
5048 remote_protocol_packets
[i
].detect
= AUTO_BOOLEAN_AUTO
;
5049 remote_protocol_packets
[i
].support
= PACKET_SUPPORT_UNKNOWN
;
5053 /* Symbol look-up. */
5056 remote_target::remote_check_symbols ()
5061 /* The remote side has no concept of inferiors that aren't running
5062 yet, it only knows about running processes. If we're connected
5063 but our current inferior is not running, we should not invite the
5064 remote target to request symbol lookups related to its
5065 (unrelated) current process. */
5066 if (!target_has_execution ())
5069 if (packet_support (PACKET_qSymbol
) == PACKET_DISABLE
)
5072 /* Make sure the remote is pointing at the right process. Note
5073 there's no way to select "no process". */
5074 set_general_process ();
5076 /* Allocate a message buffer. We can't reuse the input buffer in RS,
5077 because we need both at the same time. */
5078 gdb::char_vector
msg (get_remote_packet_size ());
5079 gdb::char_vector
reply (get_remote_packet_size ());
5081 /* Invite target to request symbol lookups. */
5083 putpkt ("qSymbol::");
5085 packet_ok (reply
, &remote_protocol_packets
[PACKET_qSymbol
]);
5087 while (startswith (reply
.data (), "qSymbol:"))
5089 struct bound_minimal_symbol sym
;
5092 end
= hex2bin (tmp
, reinterpret_cast <gdb_byte
*> (msg
.data ()),
5095 sym
= lookup_minimal_symbol (msg
.data (), NULL
, NULL
);
5096 if (sym
.minsym
== NULL
)
5097 xsnprintf (msg
.data (), get_remote_packet_size (), "qSymbol::%s",
5101 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
5102 CORE_ADDR sym_addr
= BMSYMBOL_VALUE_ADDRESS (sym
);
5104 /* If this is a function address, return the start of code
5105 instead of any data function descriptor. */
5106 sym_addr
= gdbarch_convert_from_func_ptr_addr
5107 (target_gdbarch (), sym_addr
, current_inferior ()->top_target ());
5109 xsnprintf (msg
.data (), get_remote_packet_size (), "qSymbol:%s:%s",
5110 phex_nz (sym_addr
, addr_size
), &reply
[8]);
5113 putpkt (msg
.data ());
5118 static struct serial
*
5119 remote_serial_open (const char *name
)
5121 static int udp_warning
= 0;
5123 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
5124 of in ser-tcp.c, because it is the remote protocol assuming that the
5125 serial connection is reliable and not the serial connection promising
5127 if (!udp_warning
&& startswith (name
, "udp:"))
5129 warning (_("The remote protocol may be unreliable over UDP.\n"
5130 "Some events may be lost, rendering further debugging "
5135 return serial_open (name
);
5138 /* Inform the target of our permission settings. The permission flags
5139 work without this, but if the target knows the settings, it can do
5140 a couple things. First, it can add its own check, to catch cases
5141 that somehow manage to get by the permissions checks in target
5142 methods. Second, if the target is wired to disallow particular
5143 settings (for instance, a system in the field that is not set up to
5144 be able to stop at a breakpoint), it can object to any unavailable
5148 remote_target::set_permissions ()
5150 struct remote_state
*rs
= get_remote_state ();
5152 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QAllow:"
5153 "WriteReg:%x;WriteMem:%x;"
5154 "InsertBreak:%x;InsertTrace:%x;"
5155 "InsertFastTrace:%x;Stop:%x",
5156 may_write_registers
, may_write_memory
,
5157 may_insert_breakpoints
, may_insert_tracepoints
,
5158 may_insert_fast_tracepoints
, may_stop
);
5160 getpkt (&rs
->buf
, 0);
5162 /* If the target didn't like the packet, warn the user. Do not try
5163 to undo the user's settings, that would just be maddening. */
5164 if (strcmp (rs
->buf
.data (), "OK") != 0)
5165 warning (_("Remote refused setting permissions with: %s"),
5169 /* This type describes each known response to the qSupported
5171 struct protocol_feature
5173 /* The name of this protocol feature. */
5176 /* The default for this protocol feature. */
5177 enum packet_support default_support
;
5179 /* The function to call when this feature is reported, or after
5180 qSupported processing if the feature is not supported.
5181 The first argument points to this structure. The second
5182 argument indicates whether the packet requested support be
5183 enabled, disabled, or probed (or the default, if this function
5184 is being called at the end of processing and this feature was
5185 not reported). The third argument may be NULL; if not NULL, it
5186 is a NUL-terminated string taken from the packet following
5187 this feature's name and an equals sign. */
5188 void (*func
) (remote_target
*remote
, const struct protocol_feature
*,
5189 enum packet_support
, const char *);
5191 /* The corresponding packet for this feature. Only used if
5192 FUNC is remote_supported_packet. */
5197 remote_supported_packet (remote_target
*remote
,
5198 const struct protocol_feature
*feature
,
5199 enum packet_support support
,
5200 const char *argument
)
5204 warning (_("Remote qSupported response supplied an unexpected value for"
5205 " \"%s\"."), feature
->name
);
5209 remote_protocol_packets
[feature
->packet
].support
= support
;
5213 remote_target::remote_packet_size (const protocol_feature
*feature
,
5214 enum packet_support support
, const char *value
)
5216 struct remote_state
*rs
= get_remote_state ();
5221 if (support
!= PACKET_ENABLE
)
5224 if (value
== NULL
|| *value
== '\0')
5226 warning (_("Remote target reported \"%s\" without a size."),
5232 packet_size
= strtol (value
, &value_end
, 16);
5233 if (errno
!= 0 || *value_end
!= '\0' || packet_size
< 0)
5235 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
5236 feature
->name
, value
);
5240 /* Record the new maximum packet size. */
5241 rs
->explicit_packet_size
= packet_size
;
5245 remote_packet_size (remote_target
*remote
, const protocol_feature
*feature
,
5246 enum packet_support support
, const char *value
)
5248 remote
->remote_packet_size (feature
, support
, value
);
5251 static const struct protocol_feature remote_protocol_features
[] = {
5252 { "PacketSize", PACKET_DISABLE
, remote_packet_size
, -1 },
5253 { "qXfer:auxv:read", PACKET_DISABLE
, remote_supported_packet
,
5254 PACKET_qXfer_auxv
},
5255 { "qXfer:exec-file:read", PACKET_DISABLE
, remote_supported_packet
,
5256 PACKET_qXfer_exec_file
},
5257 { "qXfer:features:read", PACKET_DISABLE
, remote_supported_packet
,
5258 PACKET_qXfer_features
},
5259 { "qXfer:libraries:read", PACKET_DISABLE
, remote_supported_packet
,
5260 PACKET_qXfer_libraries
},
5261 { "qXfer:libraries-svr4:read", PACKET_DISABLE
, remote_supported_packet
,
5262 PACKET_qXfer_libraries_svr4
},
5263 { "augmented-libraries-svr4-read", PACKET_DISABLE
,
5264 remote_supported_packet
, PACKET_augmented_libraries_svr4_read_feature
},
5265 { "qXfer:memory-map:read", PACKET_DISABLE
, remote_supported_packet
,
5266 PACKET_qXfer_memory_map
},
5267 { "qXfer:osdata:read", PACKET_DISABLE
, remote_supported_packet
,
5268 PACKET_qXfer_osdata
},
5269 { "qXfer:threads:read", PACKET_DISABLE
, remote_supported_packet
,
5270 PACKET_qXfer_threads
},
5271 { "qXfer:traceframe-info:read", PACKET_DISABLE
, remote_supported_packet
,
5272 PACKET_qXfer_traceframe_info
},
5273 { "QPassSignals", PACKET_DISABLE
, remote_supported_packet
,
5274 PACKET_QPassSignals
},
5275 { "QCatchSyscalls", PACKET_DISABLE
, remote_supported_packet
,
5276 PACKET_QCatchSyscalls
},
5277 { "QProgramSignals", PACKET_DISABLE
, remote_supported_packet
,
5278 PACKET_QProgramSignals
},
5279 { "QSetWorkingDir", PACKET_DISABLE
, remote_supported_packet
,
5280 PACKET_QSetWorkingDir
},
5281 { "QStartupWithShell", PACKET_DISABLE
, remote_supported_packet
,
5282 PACKET_QStartupWithShell
},
5283 { "QEnvironmentHexEncoded", PACKET_DISABLE
, remote_supported_packet
,
5284 PACKET_QEnvironmentHexEncoded
},
5285 { "QEnvironmentReset", PACKET_DISABLE
, remote_supported_packet
,
5286 PACKET_QEnvironmentReset
},
5287 { "QEnvironmentUnset", PACKET_DISABLE
, remote_supported_packet
,
5288 PACKET_QEnvironmentUnset
},
5289 { "QStartNoAckMode", PACKET_DISABLE
, remote_supported_packet
,
5290 PACKET_QStartNoAckMode
},
5291 { "multiprocess", PACKET_DISABLE
, remote_supported_packet
,
5292 PACKET_multiprocess_feature
},
5293 { "QNonStop", PACKET_DISABLE
, remote_supported_packet
, PACKET_QNonStop
},
5294 { "qXfer:siginfo:read", PACKET_DISABLE
, remote_supported_packet
,
5295 PACKET_qXfer_siginfo_read
},
5296 { "qXfer:siginfo:write", PACKET_DISABLE
, remote_supported_packet
,
5297 PACKET_qXfer_siginfo_write
},
5298 { "ConditionalTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5299 PACKET_ConditionalTracepoints
},
5300 { "ConditionalBreakpoints", PACKET_DISABLE
, remote_supported_packet
,
5301 PACKET_ConditionalBreakpoints
},
5302 { "BreakpointCommands", PACKET_DISABLE
, remote_supported_packet
,
5303 PACKET_BreakpointCommands
},
5304 { "FastTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5305 PACKET_FastTracepoints
},
5306 { "StaticTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5307 PACKET_StaticTracepoints
},
5308 {"InstallInTrace", PACKET_DISABLE
, remote_supported_packet
,
5309 PACKET_InstallInTrace
},
5310 { "DisconnectedTracing", PACKET_DISABLE
, remote_supported_packet
,
5311 PACKET_DisconnectedTracing_feature
},
5312 { "ReverseContinue", PACKET_DISABLE
, remote_supported_packet
,
5314 { "ReverseStep", PACKET_DISABLE
, remote_supported_packet
,
5316 { "TracepointSource", PACKET_DISABLE
, remote_supported_packet
,
5317 PACKET_TracepointSource
},
5318 { "QAllow", PACKET_DISABLE
, remote_supported_packet
,
5320 { "EnableDisableTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5321 PACKET_EnableDisableTracepoints_feature
},
5322 { "qXfer:fdpic:read", PACKET_DISABLE
, remote_supported_packet
,
5323 PACKET_qXfer_fdpic
},
5324 { "qXfer:uib:read", PACKET_DISABLE
, remote_supported_packet
,
5326 { "QDisableRandomization", PACKET_DISABLE
, remote_supported_packet
,
5327 PACKET_QDisableRandomization
},
5328 { "QAgent", PACKET_DISABLE
, remote_supported_packet
, PACKET_QAgent
},
5329 { "QTBuffer:size", PACKET_DISABLE
,
5330 remote_supported_packet
, PACKET_QTBuffer_size
},
5331 { "tracenz", PACKET_DISABLE
, remote_supported_packet
, PACKET_tracenz_feature
},
5332 { "Qbtrace:off", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_off
},
5333 { "Qbtrace:bts", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_bts
},
5334 { "Qbtrace:pt", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_pt
},
5335 { "qXfer:btrace:read", PACKET_DISABLE
, remote_supported_packet
,
5336 PACKET_qXfer_btrace
},
5337 { "qXfer:btrace-conf:read", PACKET_DISABLE
, remote_supported_packet
,
5338 PACKET_qXfer_btrace_conf
},
5339 { "Qbtrace-conf:bts:size", PACKET_DISABLE
, remote_supported_packet
,
5340 PACKET_Qbtrace_conf_bts_size
},
5341 { "swbreak", PACKET_DISABLE
, remote_supported_packet
, PACKET_swbreak_feature
},
5342 { "hwbreak", PACKET_DISABLE
, remote_supported_packet
, PACKET_hwbreak_feature
},
5343 { "fork-events", PACKET_DISABLE
, remote_supported_packet
,
5344 PACKET_fork_event_feature
},
5345 { "vfork-events", PACKET_DISABLE
, remote_supported_packet
,
5346 PACKET_vfork_event_feature
},
5347 { "exec-events", PACKET_DISABLE
, remote_supported_packet
,
5348 PACKET_exec_event_feature
},
5349 { "Qbtrace-conf:pt:size", PACKET_DISABLE
, remote_supported_packet
,
5350 PACKET_Qbtrace_conf_pt_size
},
5351 { "vContSupported", PACKET_DISABLE
, remote_supported_packet
, PACKET_vContSupported
},
5352 { "QThreadEvents", PACKET_DISABLE
, remote_supported_packet
, PACKET_QThreadEvents
},
5353 { "no-resumed", PACKET_DISABLE
, remote_supported_packet
, PACKET_no_resumed
},
5354 { "memory-tagging", PACKET_DISABLE
, remote_supported_packet
,
5355 PACKET_memory_tagging_feature
},
5358 static char *remote_support_xml
;
5360 /* Register string appended to "xmlRegisters=" in qSupported query. */
5363 register_remote_support_xml (const char *xml
)
5365 #if defined(HAVE_LIBEXPAT)
5366 if (remote_support_xml
== NULL
)
5367 remote_support_xml
= concat ("xmlRegisters=", xml
, (char *) NULL
);
5370 char *copy
= xstrdup (remote_support_xml
+ 13);
5372 char *p
= strtok_r (copy
, ",", &saveptr
);
5376 if (strcmp (p
, xml
) == 0)
5383 while ((p
= strtok_r (NULL
, ",", &saveptr
)) != NULL
);
5386 remote_support_xml
= reconcat (remote_support_xml
,
5387 remote_support_xml
, ",", xml
,
5394 remote_query_supported_append (std::string
*msg
, const char *append
)
5398 msg
->append (append
);
5402 remote_target::remote_query_supported ()
5404 struct remote_state
*rs
= get_remote_state ();
5407 unsigned char seen
[ARRAY_SIZE (remote_protocol_features
)];
5409 /* The packet support flags are handled differently for this packet
5410 than for most others. We treat an error, a disabled packet, and
5411 an empty response identically: any features which must be reported
5412 to be used will be automatically disabled. An empty buffer
5413 accomplishes this, since that is also the representation for a list
5414 containing no features. */
5417 if (packet_support (PACKET_qSupported
) != PACKET_DISABLE
)
5421 if (packet_set_cmd_state (PACKET_multiprocess_feature
) != AUTO_BOOLEAN_FALSE
)
5422 remote_query_supported_append (&q
, "multiprocess+");
5424 if (packet_set_cmd_state (PACKET_swbreak_feature
) != AUTO_BOOLEAN_FALSE
)
5425 remote_query_supported_append (&q
, "swbreak+");
5426 if (packet_set_cmd_state (PACKET_hwbreak_feature
) != AUTO_BOOLEAN_FALSE
)
5427 remote_query_supported_append (&q
, "hwbreak+");
5429 remote_query_supported_append (&q
, "qRelocInsn+");
5431 if (packet_set_cmd_state (PACKET_fork_event_feature
)
5432 != AUTO_BOOLEAN_FALSE
)
5433 remote_query_supported_append (&q
, "fork-events+");
5434 if (packet_set_cmd_state (PACKET_vfork_event_feature
)
5435 != AUTO_BOOLEAN_FALSE
)
5436 remote_query_supported_append (&q
, "vfork-events+");
5437 if (packet_set_cmd_state (PACKET_exec_event_feature
)
5438 != AUTO_BOOLEAN_FALSE
)
5439 remote_query_supported_append (&q
, "exec-events+");
5441 if (packet_set_cmd_state (PACKET_vContSupported
) != AUTO_BOOLEAN_FALSE
)
5442 remote_query_supported_append (&q
, "vContSupported+");
5444 if (packet_set_cmd_state (PACKET_QThreadEvents
) != AUTO_BOOLEAN_FALSE
)
5445 remote_query_supported_append (&q
, "QThreadEvents+");
5447 if (packet_set_cmd_state (PACKET_no_resumed
) != AUTO_BOOLEAN_FALSE
)
5448 remote_query_supported_append (&q
, "no-resumed+");
5450 if (packet_set_cmd_state (PACKET_memory_tagging_feature
)
5451 != AUTO_BOOLEAN_FALSE
)
5452 remote_query_supported_append (&q
, "memory-tagging+");
5454 /* Keep this one last to work around a gdbserver <= 7.10 bug in
5455 the qSupported:xmlRegisters=i386 handling. */
5456 if (remote_support_xml
!= NULL
5457 && packet_support (PACKET_qXfer_features
) != PACKET_DISABLE
)
5458 remote_query_supported_append (&q
, remote_support_xml
);
5460 q
= "qSupported:" + q
;
5461 putpkt (q
.c_str ());
5463 getpkt (&rs
->buf
, 0);
5465 /* If an error occured, warn, but do not return - just reset the
5466 buffer to empty and go on to disable features. */
5467 if (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_qSupported
])
5470 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
5475 memset (seen
, 0, sizeof (seen
));
5477 next
= rs
->buf
.data ();
5480 enum packet_support is_supported
;
5481 char *p
, *end
, *name_end
, *value
;
5483 /* First separate out this item from the rest of the packet. If
5484 there's another item after this, we overwrite the separator
5485 (terminated strings are much easier to work with). */
5487 end
= strchr (p
, ';');
5490 end
= p
+ strlen (p
);
5500 warning (_("empty item in \"qSupported\" response"));
5505 name_end
= strchr (p
, '=');
5508 /* This is a name=value entry. */
5509 is_supported
= PACKET_ENABLE
;
5510 value
= name_end
+ 1;
5519 is_supported
= PACKET_ENABLE
;
5523 is_supported
= PACKET_DISABLE
;
5527 is_supported
= PACKET_SUPPORT_UNKNOWN
;
5531 warning (_("unrecognized item \"%s\" "
5532 "in \"qSupported\" response"), p
);
5538 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
5539 if (strcmp (remote_protocol_features
[i
].name
, p
) == 0)
5541 const struct protocol_feature
*feature
;
5544 feature
= &remote_protocol_features
[i
];
5545 feature
->func (this, feature
, is_supported
, value
);
5550 /* If we increased the packet size, make sure to increase the global
5551 buffer size also. We delay this until after parsing the entire
5552 qSupported packet, because this is the same buffer we were
5554 if (rs
->buf
.size () < rs
->explicit_packet_size
)
5555 rs
->buf
.resize (rs
->explicit_packet_size
);
5557 /* Handle the defaults for unmentioned features. */
5558 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
5561 const struct protocol_feature
*feature
;
5563 feature
= &remote_protocol_features
[i
];
5564 feature
->func (this, feature
, feature
->default_support
, NULL
);
5568 /* Serial QUIT handler for the remote serial descriptor.
5570 Defers handling a Ctrl-C until we're done with the current
5571 command/response packet sequence, unless:
5573 - We're setting up the connection. Don't send a remote interrupt
5574 request, as we're not fully synced yet. Quit immediately
5577 - The target has been resumed in the foreground
5578 (target_terminal::is_ours is false) with a synchronous resume
5579 packet, and we're blocked waiting for the stop reply, thus a
5580 Ctrl-C should be immediately sent to the target.
5582 - We get a second Ctrl-C while still within the same serial read or
5583 write. In that case the serial is seemingly wedged --- offer to
5586 - We see a second Ctrl-C without target response, after having
5587 previously interrupted the target. In that case the target/stub
5588 is probably wedged --- offer to quit/disconnect.
5592 remote_target::remote_serial_quit_handler ()
5594 struct remote_state
*rs
= get_remote_state ();
5596 if (check_quit_flag ())
5598 /* If we're starting up, we're not fully synced yet. Quit
5600 if (rs
->starting_up
)
5602 else if (rs
->got_ctrlc_during_io
)
5604 if (query (_("The target is not responding to GDB commands.\n"
5605 "Stop debugging it? ")))
5606 remote_unpush_and_throw (this);
5608 /* If ^C has already been sent once, offer to disconnect. */
5609 else if (!target_terminal::is_ours () && rs
->ctrlc_pending_p
)
5611 /* All-stop protocol, and blocked waiting for stop reply. Send
5612 an interrupt request. */
5613 else if (!target_terminal::is_ours () && rs
->waiting_for_stop_reply
)
5614 target_interrupt ();
5616 rs
->got_ctrlc_during_io
= 1;
5620 /* The remote_target that is current while the quit handler is
5621 overridden with remote_serial_quit_handler. */
5622 static remote_target
*curr_quit_handler_target
;
5625 remote_serial_quit_handler ()
5627 curr_quit_handler_target
->remote_serial_quit_handler ();
5630 /* Remove the remote target from the target stack of each inferior
5631 that is using it. Upper targets depend on it so remove them
5635 remote_unpush_target (remote_target
*target
)
5637 /* We have to unpush the target from all inferiors, even those that
5639 scoped_restore_current_inferior restore_current_inferior
;
5641 for (inferior
*inf
: all_inferiors (target
))
5643 switch_to_inferior_no_thread (inf
);
5644 pop_all_targets_at_and_above (process_stratum
);
5645 generic_mourn_inferior ();
5648 /* Don't rely on target_close doing this when the target is popped
5649 from the last remote inferior above, because something may be
5650 holding a reference to the target higher up on the stack, meaning
5651 target_close won't be called yet. We lost the connection to the
5652 target, so clear these now, otherwise we may later throw
5653 TARGET_CLOSE_ERROR while trying to tell the remote target to
5655 fileio_handles_invalidate_target (target
);
5659 remote_unpush_and_throw (remote_target
*target
)
5661 remote_unpush_target (target
);
5662 throw_error (TARGET_CLOSE_ERROR
, _("Disconnected from target."));
5666 remote_target::open_1 (const char *name
, int from_tty
, int extended_p
)
5668 remote_target
*curr_remote
= get_current_remote_target ();
5671 error (_("To open a remote debug connection, you need to specify what\n"
5672 "serial device is attached to the remote system\n"
5673 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
5675 /* If we're connected to a running target, target_preopen will kill it.
5676 Ask this question first, before target_preopen has a chance to kill
5678 if (curr_remote
!= NULL
&& !target_has_execution ())
5681 && !query (_("Already connected to a remote target. Disconnect? ")))
5682 error (_("Still connected."));
5685 /* Here the possibly existing remote target gets unpushed. */
5686 target_preopen (from_tty
);
5688 remote_fileio_reset ();
5689 reopen_exec_file ();
5692 remote_target
*remote
5693 = (extended_p
? new extended_remote_target () : new remote_target ());
5694 target_ops_up
target_holder (remote
);
5696 remote_state
*rs
= remote
->get_remote_state ();
5698 /* See FIXME above. */
5699 if (!target_async_permitted
)
5700 rs
->wait_forever_enabled_p
= 1;
5702 rs
->remote_desc
= remote_serial_open (name
);
5703 if (!rs
->remote_desc
)
5704 perror_with_name (name
);
5706 if (baud_rate
!= -1)
5708 if (serial_setbaudrate (rs
->remote_desc
, baud_rate
))
5710 /* The requested speed could not be set. Error out to
5711 top level after closing remote_desc. Take care to
5712 set remote_desc to NULL to avoid closing remote_desc
5714 serial_close (rs
->remote_desc
);
5715 rs
->remote_desc
= NULL
;
5716 perror_with_name (name
);
5720 serial_setparity (rs
->remote_desc
, serial_parity
);
5721 serial_raw (rs
->remote_desc
);
5723 /* If there is something sitting in the buffer we might take it as a
5724 response to a command, which would be bad. */
5725 serial_flush_input (rs
->remote_desc
);
5729 puts_filtered ("Remote debugging using ");
5730 puts_filtered (name
);
5731 puts_filtered ("\n");
5734 /* Switch to using the remote target now. */
5735 current_inferior ()->push_target (std::move (target_holder
));
5737 /* Register extra event sources in the event loop. */
5738 rs
->remote_async_inferior_event_token
5739 = create_async_event_handler (remote_async_inferior_event_handler
, nullptr,
5741 rs
->notif_state
= remote_notif_state_allocate (remote
);
5743 /* Reset the target state; these things will be queried either by
5744 remote_query_supported or as they are needed. */
5745 reset_all_packet_configs_support ();
5746 rs
->cached_wait_status
= 0;
5747 rs
->explicit_packet_size
= 0;
5749 rs
->extended
= extended_p
;
5750 rs
->waiting_for_stop_reply
= 0;
5751 rs
->ctrlc_pending_p
= 0;
5752 rs
->got_ctrlc_during_io
= 0;
5754 rs
->general_thread
= not_sent_ptid
;
5755 rs
->continue_thread
= not_sent_ptid
;
5756 rs
->remote_traceframe_number
= -1;
5758 rs
->last_resume_exec_dir
= EXEC_FORWARD
;
5760 /* Probe for ability to use "ThreadInfo" query, as required. */
5761 rs
->use_threadinfo_query
= 1;
5762 rs
->use_threadextra_query
= 1;
5764 rs
->readahead_cache
.invalidate ();
5766 if (target_async_permitted
)
5768 /* FIXME: cagney/1999-09-23: During the initial connection it is
5769 assumed that the target is already ready and able to respond to
5770 requests. Unfortunately remote_start_remote() eventually calls
5771 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
5772 around this. Eventually a mechanism that allows
5773 wait_for_inferior() to expect/get timeouts will be
5775 rs
->wait_forever_enabled_p
= 0;
5778 /* First delete any symbols previously loaded from shared libraries. */
5779 no_shared_libraries (NULL
, 0);
5781 /* Start the remote connection. If error() or QUIT, discard this
5782 target (we'd otherwise be in an inconsistent state) and then
5783 propogate the error on up the exception chain. This ensures that
5784 the caller doesn't stumble along blindly assuming that the
5785 function succeeded. The CLI doesn't have this problem but other
5786 UI's, such as MI do.
5788 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
5789 this function should return an error indication letting the
5790 caller restore the previous state. Unfortunately the command
5791 ``target remote'' is directly wired to this function making that
5792 impossible. On a positive note, the CLI side of this problem has
5793 been fixed - the function set_cmd_context() makes it possible for
5794 all the ``target ....'' commands to share a common callback
5795 function. See cli-dump.c. */
5800 remote
->start_remote (from_tty
, extended_p
);
5802 catch (const gdb_exception
&ex
)
5804 /* Pop the partially set up target - unless something else did
5805 already before throwing the exception. */
5806 if (ex
.error
!= TARGET_CLOSE_ERROR
)
5807 remote_unpush_target (remote
);
5812 remote_btrace_reset (rs
);
5814 if (target_async_permitted
)
5815 rs
->wait_forever_enabled_p
= 1;
5818 /* Detach the specified process. */
5821 remote_target::remote_detach_pid (int pid
)
5823 struct remote_state
*rs
= get_remote_state ();
5825 /* This should not be necessary, but the handling for D;PID in
5826 GDBserver versions prior to 8.2 incorrectly assumes that the
5827 selected process points to the same process we're detaching,
5828 leading to misbehavior (and possibly GDBserver crashing) when it
5829 does not. Since it's easy and cheap, work around it by forcing
5830 GDBserver to select GDB's current process. */
5831 set_general_process ();
5833 if (remote_multi_process_p (rs
))
5834 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "D;%x", pid
);
5836 strcpy (rs
->buf
.data (), "D");
5839 getpkt (&rs
->buf
, 0);
5841 if (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K')
5843 else if (rs
->buf
[0] == '\0')
5844 error (_("Remote doesn't know how to detach"));
5846 error (_("Can't detach process."));
5849 /* This detaches a program to which we previously attached, using
5850 inferior_ptid to identify the process. After this is done, GDB
5851 can be used to debug some other program. We better not have left
5852 any breakpoints in the target program or it'll die when it hits
5856 remote_target::remote_detach_1 (inferior
*inf
, int from_tty
)
5858 int pid
= inferior_ptid
.pid ();
5859 struct remote_state
*rs
= get_remote_state ();
5862 if (!target_has_execution ())
5863 error (_("No process to detach from."));
5865 target_announce_detach (from_tty
);
5867 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
5869 /* If we're in breakpoints-always-inserted mode, or the inferior
5870 is running, we have to remove breakpoints before detaching.
5871 We don't do this in common code instead because not all
5872 targets support removing breakpoints while the target is
5873 running. The remote target / gdbserver does, though. */
5874 remove_breakpoints_inf (current_inferior ());
5877 /* Tell the remote target to detach. */
5878 remote_detach_pid (pid
);
5880 /* Exit only if this is the only active inferior. */
5881 if (from_tty
&& !rs
->extended
&& number_of_live_inferiors (this) == 1)
5882 puts_filtered (_("Ending remote debugging.\n"));
5884 thread_info
*tp
= find_thread_ptid (this, inferior_ptid
);
5886 /* Check to see if we are detaching a fork parent. Note that if we
5887 are detaching a fork child, tp == NULL. */
5888 is_fork_parent
= (tp
!= NULL
5889 && tp
->pending_follow
.kind () == TARGET_WAITKIND_FORKED
);
5891 /* If doing detach-on-fork, we don't mourn, because that will delete
5892 breakpoints that should be available for the followed inferior. */
5893 if (!is_fork_parent
)
5895 /* Save the pid as a string before mourning, since that will
5896 unpush the remote target, and we need the string after. */
5897 std::string infpid
= target_pid_to_str (ptid_t (pid
));
5899 target_mourn_inferior (inferior_ptid
);
5900 if (print_inferior_events
)
5901 printf_unfiltered (_("[Inferior %d (%s) detached]\n"),
5902 inf
->num
, infpid
.c_str ());
5906 switch_to_no_thread ();
5907 detach_inferior (current_inferior ());
5912 remote_target::detach (inferior
*inf
, int from_tty
)
5914 remote_detach_1 (inf
, from_tty
);
5918 extended_remote_target::detach (inferior
*inf
, int from_tty
)
5920 remote_detach_1 (inf
, from_tty
);
5923 /* Target follow-fork function for remote targets. On entry, and
5924 at return, the current inferior is the fork parent.
5926 Note that although this is currently only used for extended-remote,
5927 it is named remote_follow_fork in anticipation of using it for the
5928 remote target as well. */
5931 remote_target::follow_fork (inferior
*child_inf
, ptid_t child_ptid
,
5932 target_waitkind fork_kind
, bool follow_child
,
5935 process_stratum_target::follow_fork (child_inf
, child_ptid
,
5936 fork_kind
, follow_child
, detach_fork
);
5938 struct remote_state
*rs
= get_remote_state ();
5940 if ((fork_kind
== TARGET_WAITKIND_FORKED
&& remote_fork_event_p (rs
))
5941 || (fork_kind
== TARGET_WAITKIND_VFORKED
&& remote_vfork_event_p (rs
)))
5943 /* When following the parent and detaching the child, we detach
5944 the child here. For the case of following the child and
5945 detaching the parent, the detach is done in the target-
5946 independent follow fork code in infrun.c. We can't use
5947 target_detach when detaching an unfollowed child because
5948 the client side doesn't know anything about the child. */
5949 if (detach_fork
&& !follow_child
)
5951 /* Detach the fork child. */
5952 remote_detach_pid (child_ptid
.pid ());
5957 /* Target follow-exec function for remote targets. Save EXECD_PATHNAME
5958 in the program space of the new inferior. */
5961 remote_target::follow_exec (inferior
*follow_inf
, ptid_t ptid
,
5962 const char *execd_pathname
)
5964 process_stratum_target::follow_exec (follow_inf
, ptid
, execd_pathname
);
5966 /* We know that this is a target file name, so if it has the "target:"
5967 prefix we strip it off before saving it in the program space. */
5968 if (is_target_filename (execd_pathname
))
5969 execd_pathname
+= strlen (TARGET_SYSROOT_PREFIX
);
5971 set_pspace_remote_exec_file (follow_inf
->pspace
, execd_pathname
);
5974 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
5977 remote_target::disconnect (const char *args
, int from_tty
)
5980 error (_("Argument given to \"disconnect\" when remotely debugging."));
5982 /* Make sure we unpush even the extended remote targets. Calling
5983 target_mourn_inferior won't unpush, and
5984 remote_target::mourn_inferior won't unpush if there is more than
5985 one inferior left. */
5986 remote_unpush_target (this);
5989 puts_filtered ("Ending remote debugging.\n");
5992 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
5993 be chatty about it. */
5996 extended_remote_target::attach (const char *args
, int from_tty
)
5998 struct remote_state
*rs
= get_remote_state ();
6000 char *wait_status
= NULL
;
6002 pid
= parse_pid_to_attach (args
);
6004 /* Remote PID can be freely equal to getpid, do not check it here the same
6005 way as in other targets. */
6007 if (packet_support (PACKET_vAttach
) == PACKET_DISABLE
)
6008 error (_("This target does not support attaching to a process"));
6012 const char *exec_file
= get_exec_file (0);
6015 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file
,
6016 target_pid_to_str (ptid_t (pid
)).c_str ());
6018 printf_unfiltered (_("Attaching to %s\n"),
6019 target_pid_to_str (ptid_t (pid
)).c_str ());
6022 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "vAttach;%x", pid
);
6024 getpkt (&rs
->buf
, 0);
6026 switch (packet_ok (rs
->buf
,
6027 &remote_protocol_packets
[PACKET_vAttach
]))
6030 if (!target_is_non_stop_p ())
6032 /* Save the reply for later. */
6033 wait_status
= (char *) alloca (strlen (rs
->buf
.data ()) + 1);
6034 strcpy (wait_status
, rs
->buf
.data ());
6036 else if (strcmp (rs
->buf
.data (), "OK") != 0)
6037 error (_("Attaching to %s failed with: %s"),
6038 target_pid_to_str (ptid_t (pid
)).c_str (),
6041 case PACKET_UNKNOWN
:
6042 error (_("This target does not support attaching to a process"));
6044 error (_("Attaching to %s failed"),
6045 target_pid_to_str (ptid_t (pid
)).c_str ());
6048 switch_to_inferior_no_thread (remote_add_inferior (false, pid
, 1, 0));
6050 inferior_ptid
= ptid_t (pid
);
6052 if (target_is_non_stop_p ())
6054 /* Get list of threads. */
6055 update_thread_list ();
6057 thread_info
*thread
= first_thread_of_inferior (current_inferior ());
6058 if (thread
!= nullptr)
6059 switch_to_thread (thread
);
6061 /* Invalidate our notion of the remote current thread. */
6062 record_currthread (rs
, minus_one_ptid
);
6066 /* Now, if we have thread information, update the main thread's
6068 ptid_t curr_ptid
= remote_current_thread (ptid_t (pid
));
6070 /* Add the main thread to the thread list. */
6071 thread_info
*thr
= add_thread_silent (this, curr_ptid
);
6073 switch_to_thread (thr
);
6075 /* Don't consider the thread stopped until we've processed the
6076 saved stop reply. */
6077 set_executing (this, thr
->ptid
, true);
6080 /* Next, if the target can specify a description, read it. We do
6081 this before anything involving memory or registers. */
6082 target_find_description ();
6084 if (!target_is_non_stop_p ())
6086 /* Use the previously fetched status. */
6087 gdb_assert (wait_status
!= NULL
);
6089 if (target_can_async_p ())
6091 struct notif_event
*reply
6092 = remote_notif_parse (this, ¬if_client_stop
, wait_status
);
6094 push_stop_reply ((struct stop_reply
*) reply
);
6100 gdb_assert (wait_status
!= NULL
);
6101 strcpy (rs
->buf
.data (), wait_status
);
6102 rs
->cached_wait_status
= 1;
6107 gdb_assert (wait_status
== NULL
);
6109 gdb_assert (target_can_async_p ());
6114 /* Implementation of the to_post_attach method. */
6117 extended_remote_target::post_attach (int pid
)
6119 /* Get text, data & bss offsets. */
6122 /* In certain cases GDB might not have had the chance to start
6123 symbol lookup up until now. This could happen if the debugged
6124 binary is not using shared libraries, the vsyscall page is not
6125 present (on Linux) and the binary itself hadn't changed since the
6126 debugging process was started. */
6127 if (current_program_space
->symfile_object_file
!= NULL
)
6128 remote_check_symbols();
6132 /* Check for the availability of vCont. This function should also check
6136 remote_target::remote_vcont_probe ()
6138 remote_state
*rs
= get_remote_state ();
6141 strcpy (rs
->buf
.data (), "vCont?");
6143 getpkt (&rs
->buf
, 0);
6144 buf
= rs
->buf
.data ();
6146 /* Make sure that the features we assume are supported. */
6147 if (startswith (buf
, "vCont"))
6150 int support_c
, support_C
;
6152 rs
->supports_vCont
.s
= 0;
6153 rs
->supports_vCont
.S
= 0;
6156 rs
->supports_vCont
.t
= 0;
6157 rs
->supports_vCont
.r
= 0;
6158 while (p
&& *p
== ';')
6161 if (*p
== 's' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6162 rs
->supports_vCont
.s
= 1;
6163 else if (*p
== 'S' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6164 rs
->supports_vCont
.S
= 1;
6165 else if (*p
== 'c' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6167 else if (*p
== 'C' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6169 else if (*p
== 't' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6170 rs
->supports_vCont
.t
= 1;
6171 else if (*p
== 'r' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6172 rs
->supports_vCont
.r
= 1;
6174 p
= strchr (p
, ';');
6177 /* If c, and C are not all supported, we can't use vCont. Clearing
6178 BUF will make packet_ok disable the packet. */
6179 if (!support_c
|| !support_C
)
6183 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vCont
]);
6184 rs
->supports_vCont_probed
= true;
6187 /* Helper function for building "vCont" resumptions. Write a
6188 resumption to P. ENDP points to one-passed-the-end of the buffer
6189 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
6190 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
6191 resumed thread should be single-stepped and/or signalled. If PTID
6192 equals minus_one_ptid, then all threads are resumed; if PTID
6193 represents a process, then all threads of the process are resumed;
6194 the thread to be stepped and/or signalled is given in the global
6198 remote_target::append_resumption (char *p
, char *endp
,
6199 ptid_t ptid
, int step
, gdb_signal siggnal
)
6201 struct remote_state
*rs
= get_remote_state ();
6203 if (step
&& siggnal
!= GDB_SIGNAL_0
)
6204 p
+= xsnprintf (p
, endp
- p
, ";S%02x", siggnal
);
6206 /* GDB is willing to range step. */
6207 && use_range_stepping
6208 /* Target supports range stepping. */
6209 && rs
->supports_vCont
.r
6210 /* We don't currently support range stepping multiple
6211 threads with a wildcard (though the protocol allows it,
6212 so stubs shouldn't make an active effort to forbid
6214 && !(remote_multi_process_p (rs
) && ptid
.is_pid ()))
6216 struct thread_info
*tp
;
6218 if (ptid
== minus_one_ptid
)
6220 /* If we don't know about the target thread's tid, then
6221 we're resuming magic_null_ptid (see caller). */
6222 tp
= find_thread_ptid (this, magic_null_ptid
);
6225 tp
= find_thread_ptid (this, ptid
);
6226 gdb_assert (tp
!= NULL
);
6228 if (tp
->control
.may_range_step
)
6230 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
6232 p
+= xsnprintf (p
, endp
- p
, ";r%s,%s",
6233 phex_nz (tp
->control
.step_range_start
,
6235 phex_nz (tp
->control
.step_range_end
,
6239 p
+= xsnprintf (p
, endp
- p
, ";s");
6242 p
+= xsnprintf (p
, endp
- p
, ";s");
6243 else if (siggnal
!= GDB_SIGNAL_0
)
6244 p
+= xsnprintf (p
, endp
- p
, ";C%02x", siggnal
);
6246 p
+= xsnprintf (p
, endp
- p
, ";c");
6248 if (remote_multi_process_p (rs
) && ptid
.is_pid ())
6252 /* All (-1) threads of process. */
6253 nptid
= ptid_t (ptid
.pid (), -1);
6255 p
+= xsnprintf (p
, endp
- p
, ":");
6256 p
= write_ptid (p
, endp
, nptid
);
6258 else if (ptid
!= minus_one_ptid
)
6260 p
+= xsnprintf (p
, endp
- p
, ":");
6261 p
= write_ptid (p
, endp
, ptid
);
6267 /* Clear the thread's private info on resume. */
6270 resume_clear_thread_private_info (struct thread_info
*thread
)
6272 if (thread
->priv
!= NULL
)
6274 remote_thread_info
*priv
= get_remote_thread_info (thread
);
6276 priv
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
6277 priv
->watch_data_address
= 0;
6281 /* Append a vCont continue-with-signal action for threads that have a
6282 non-zero stop signal. */
6285 remote_target::append_pending_thread_resumptions (char *p
, char *endp
,
6288 for (thread_info
*thread
: all_non_exited_threads (this, ptid
))
6289 if (inferior_ptid
!= thread
->ptid
6290 && thread
->stop_signal () != GDB_SIGNAL_0
)
6292 p
= append_resumption (p
, endp
, thread
->ptid
,
6293 0, thread
->stop_signal ());
6294 thread
->set_stop_signal (GDB_SIGNAL_0
);
6295 resume_clear_thread_private_info (thread
);
6301 /* Set the target running, using the packets that use Hc
6305 remote_target::remote_resume_with_hc (ptid_t ptid
, int step
,
6308 struct remote_state
*rs
= get_remote_state ();
6311 rs
->last_sent_signal
= siggnal
;
6312 rs
->last_sent_step
= step
;
6314 /* The c/s/C/S resume packets use Hc, so set the continue
6316 if (ptid
== minus_one_ptid
)
6317 set_continue_thread (any_thread_ptid
);
6319 set_continue_thread (ptid
);
6321 for (thread_info
*thread
: all_non_exited_threads (this))
6322 resume_clear_thread_private_info (thread
);
6324 buf
= rs
->buf
.data ();
6325 if (::execution_direction
== EXEC_REVERSE
)
6327 /* We don't pass signals to the target in reverse exec mode. */
6328 if (info_verbose
&& siggnal
!= GDB_SIGNAL_0
)
6329 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
6332 if (step
&& packet_support (PACKET_bs
) == PACKET_DISABLE
)
6333 error (_("Remote reverse-step not supported."));
6334 if (!step
&& packet_support (PACKET_bc
) == PACKET_DISABLE
)
6335 error (_("Remote reverse-continue not supported."));
6337 strcpy (buf
, step
? "bs" : "bc");
6339 else if (siggnal
!= GDB_SIGNAL_0
)
6341 buf
[0] = step
? 'S' : 'C';
6342 buf
[1] = tohex (((int) siggnal
>> 4) & 0xf);
6343 buf
[2] = tohex (((int) siggnal
) & 0xf);
6347 strcpy (buf
, step
? "s" : "c");
6352 /* Resume the remote inferior by using a "vCont" packet. The thread
6353 to be resumed is PTID; STEP and SIGGNAL indicate whether the
6354 resumed thread should be single-stepped and/or signalled. If PTID
6355 equals minus_one_ptid, then all threads are resumed; the thread to
6356 be stepped and/or signalled is given in the global INFERIOR_PTID.
6357 This function returns non-zero iff it resumes the inferior.
6359 This function issues a strict subset of all possible vCont commands
6363 remote_target::remote_resume_with_vcont (ptid_t ptid
, int step
,
6364 enum gdb_signal siggnal
)
6366 struct remote_state
*rs
= get_remote_state ();
6370 /* No reverse execution actions defined for vCont. */
6371 if (::execution_direction
== EXEC_REVERSE
)
6374 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
6375 remote_vcont_probe ();
6377 if (packet_support (PACKET_vCont
) == PACKET_DISABLE
)
6380 p
= rs
->buf
.data ();
6381 endp
= p
+ get_remote_packet_size ();
6383 /* If we could generate a wider range of packets, we'd have to worry
6384 about overflowing BUF. Should there be a generic
6385 "multi-part-packet" packet? */
6387 p
+= xsnprintf (p
, endp
- p
, "vCont");
6389 if (ptid
== magic_null_ptid
)
6391 /* MAGIC_NULL_PTID means that we don't have any active threads,
6392 so we don't have any TID numbers the inferior will
6393 understand. Make sure to only send forms that do not specify
6395 append_resumption (p
, endp
, minus_one_ptid
, step
, siggnal
);
6397 else if (ptid
== minus_one_ptid
|| ptid
.is_pid ())
6399 /* Resume all threads (of all processes, or of a single
6400 process), with preference for INFERIOR_PTID. This assumes
6401 inferior_ptid belongs to the set of all threads we are about
6403 if (step
|| siggnal
!= GDB_SIGNAL_0
)
6405 /* Step inferior_ptid, with or without signal. */
6406 p
= append_resumption (p
, endp
, inferior_ptid
, step
, siggnal
);
6409 /* Also pass down any pending signaled resumption for other
6410 threads not the current. */
6411 p
= append_pending_thread_resumptions (p
, endp
, ptid
);
6413 /* And continue others without a signal. */
6414 append_resumption (p
, endp
, ptid
, /*step=*/ 0, GDB_SIGNAL_0
);
6418 /* Scheduler locking; resume only PTID. */
6419 append_resumption (p
, endp
, ptid
, step
, siggnal
);
6422 gdb_assert (strlen (rs
->buf
.data ()) < get_remote_packet_size ());
6425 if (target_is_non_stop_p ())
6427 /* In non-stop, the stub replies to vCont with "OK". The stop
6428 reply will be reported asynchronously by means of a `%Stop'
6430 getpkt (&rs
->buf
, 0);
6431 if (strcmp (rs
->buf
.data (), "OK") != 0)
6432 error (_("Unexpected vCont reply in non-stop mode: %s"),
6439 /* Tell the remote machine to resume. */
6442 remote_target::resume (ptid_t ptid
, int step
, enum gdb_signal siggnal
)
6444 struct remote_state
*rs
= get_remote_state ();
6446 /* When connected in non-stop mode, the core resumes threads
6447 individually. Resuming remote threads directly in target_resume
6448 would thus result in sending one packet per thread. Instead, to
6449 minimize roundtrip latency, here we just store the resume
6450 request (put the thread in RESUMED_PENDING_VCONT state); the actual remote
6451 resumption will be done in remote_target::commit_resume, where we'll be
6452 able to do vCont action coalescing. */
6453 if (target_is_non_stop_p () && ::execution_direction
!= EXEC_REVERSE
)
6455 remote_thread_info
*remote_thr
;
6457 if (minus_one_ptid
== ptid
|| ptid
.is_pid ())
6458 remote_thr
= get_remote_thread_info (this, inferior_ptid
);
6460 remote_thr
= get_remote_thread_info (this, ptid
);
6462 /* We don't expect the core to ask to resume an already resumed (from
6463 its point of view) thread. */
6464 gdb_assert (remote_thr
->get_resume_state () == resume_state::NOT_RESUMED
);
6466 remote_thr
->set_resumed_pending_vcont (step
, siggnal
);
6470 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
6471 (explained in remote-notif.c:handle_notification) so
6472 remote_notif_process is not called. We need find a place where
6473 it is safe to start a 'vNotif' sequence. It is good to do it
6474 before resuming inferior, because inferior was stopped and no RSP
6475 traffic at that moment. */
6476 if (!target_is_non_stop_p ())
6477 remote_notif_process (rs
->notif_state
, ¬if_client_stop
);
6479 rs
->last_resume_exec_dir
= ::execution_direction
;
6481 /* Prefer vCont, and fallback to s/c/S/C, which use Hc. */
6482 if (!remote_resume_with_vcont (ptid
, step
, siggnal
))
6483 remote_resume_with_hc (ptid
, step
, siggnal
);
6485 /* Update resumed state tracked by the remote target. */
6486 for (thread_info
*tp
: all_non_exited_threads (this, ptid
))
6487 get_remote_thread_info (tp
)->set_resumed ();
6489 /* We are about to start executing the inferior, let's register it
6490 with the event loop. NOTE: this is the one place where all the
6491 execution commands end up. We could alternatively do this in each
6492 of the execution commands in infcmd.c. */
6493 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
6494 into infcmd.c in order to allow inferior function calls to work
6495 NOT asynchronously. */
6496 if (target_can_async_p ())
6499 /* We've just told the target to resume. The remote server will
6500 wait for the inferior to stop, and then send a stop reply. In
6501 the mean time, we can't start another command/query ourselves
6502 because the stub wouldn't be ready to process it. This applies
6503 only to the base all-stop protocol, however. In non-stop (which
6504 only supports vCont), the stub replies with an "OK", and is
6505 immediate able to process further serial input. */
6506 if (!target_is_non_stop_p ())
6507 rs
->waiting_for_stop_reply
= 1;
6510 static int is_pending_fork_parent_thread (struct thread_info
*thread
);
6512 /* Private per-inferior info for target remote processes. */
6514 struct remote_inferior
: public private_inferior
6516 /* Whether we can send a wildcard vCont for this process. */
6517 bool may_wildcard_vcont
= true;
6520 /* Get the remote private inferior data associated to INF. */
6522 static remote_inferior
*
6523 get_remote_inferior (inferior
*inf
)
6525 if (inf
->priv
== NULL
)
6526 inf
->priv
.reset (new remote_inferior
);
6528 return static_cast<remote_inferior
*> (inf
->priv
.get ());
6531 struct stop_reply
: public notif_event
6535 /* The identifier of the thread about this event */
6538 /* The remote state this event is associated with. When the remote
6539 connection, represented by a remote_state object, is closed,
6540 all the associated stop_reply events should be released. */
6541 struct remote_state
*rs
;
6543 struct target_waitstatus ws
;
6545 /* The architecture associated with the expedited registers. */
6548 /* Expedited registers. This makes remote debugging a bit more
6549 efficient for those targets that provide critical registers as
6550 part of their normal status mechanism (as another roundtrip to
6551 fetch them is avoided). */
6552 std::vector
<cached_reg_t
> regcache
;
6554 enum target_stop_reason stop_reason
;
6556 CORE_ADDR watch_data_address
;
6561 /* Class used to track the construction of a vCont packet in the
6562 outgoing packet buffer. This is used to send multiple vCont
6563 packets if we have more actions than would fit a single packet. */
6568 explicit vcont_builder (remote_target
*remote
)
6575 void push_action (ptid_t ptid
, bool step
, gdb_signal siggnal
);
6580 /* The remote target. */
6581 remote_target
*m_remote
;
6583 /* Pointer to the first action. P points here if no action has been
6585 char *m_first_action
;
6587 /* Where the next action will be appended. */
6590 /* The end of the buffer. Must never write past this. */
6594 /* Prepare the outgoing buffer for a new vCont packet. */
6597 vcont_builder::restart ()
6599 struct remote_state
*rs
= m_remote
->get_remote_state ();
6601 m_p
= rs
->buf
.data ();
6602 m_endp
= m_p
+ m_remote
->get_remote_packet_size ();
6603 m_p
+= xsnprintf (m_p
, m_endp
- m_p
, "vCont");
6604 m_first_action
= m_p
;
6607 /* If the vCont packet being built has any action, send it to the
6611 vcont_builder::flush ()
6613 struct remote_state
*rs
;
6615 if (m_p
== m_first_action
)
6618 rs
= m_remote
->get_remote_state ();
6619 m_remote
->putpkt (rs
->buf
);
6620 m_remote
->getpkt (&rs
->buf
, 0);
6621 if (strcmp (rs
->buf
.data (), "OK") != 0)
6622 error (_("Unexpected vCont reply in non-stop mode: %s"), rs
->buf
.data ());
6625 /* The largest action is range-stepping, with its two addresses. This
6626 is more than sufficient. If a new, bigger action is created, it'll
6627 quickly trigger a failed assertion in append_resumption (and we'll
6629 #define MAX_ACTION_SIZE 200
6631 /* Append a new vCont action in the outgoing packet being built. If
6632 the action doesn't fit the packet along with previous actions, push
6633 what we've got so far to the remote end and start over a new vCont
6634 packet (with the new action). */
6637 vcont_builder::push_action (ptid_t ptid
, bool step
, gdb_signal siggnal
)
6639 char buf
[MAX_ACTION_SIZE
+ 1];
6641 char *endp
= m_remote
->append_resumption (buf
, buf
+ sizeof (buf
),
6642 ptid
, step
, siggnal
);
6644 /* Check whether this new action would fit in the vCont packet along
6645 with previous actions. If not, send what we've got so far and
6646 start a new vCont packet. */
6647 size_t rsize
= endp
- buf
;
6648 if (rsize
> m_endp
- m_p
)
6653 /* Should now fit. */
6654 gdb_assert (rsize
<= m_endp
- m_p
);
6657 memcpy (m_p
, buf
, rsize
);
6662 /* to_commit_resume implementation. */
6665 remote_target::commit_resumed ()
6667 /* If connected in all-stop mode, we'd send the remote resume
6668 request directly from remote_resume. Likewise if
6669 reverse-debugging, as there are no defined vCont actions for
6670 reverse execution. */
6671 if (!target_is_non_stop_p () || ::execution_direction
== EXEC_REVERSE
)
6674 /* Try to send wildcard actions ("vCont;c" or "vCont;c:pPID.-1")
6675 instead of resuming all threads of each process individually.
6676 However, if any thread of a process must remain halted, we can't
6677 send wildcard resumes and must send one action per thread.
6679 Care must be taken to not resume threads/processes the server
6680 side already told us are stopped, but the core doesn't know about
6681 yet, because the events are still in the vStopped notification
6684 #1 => vCont s:p1.1;c
6686 #3 <= %Stopped T05 p1.1
6691 #8 (infrun handles the stop for p1.1 and continues stepping)
6692 #9 => vCont s:p1.1;c
6694 The last vCont above would resume thread p1.2 by mistake, because
6695 the server has no idea that the event for p1.2 had not been
6698 The server side must similarly ignore resume actions for the
6699 thread that has a pending %Stopped notification (and any other
6700 threads with events pending), until GDB acks the notification
6701 with vStopped. Otherwise, e.g., the following case is
6704 #1 => g (or any other packet)
6706 #3 <= %Stopped T05 p1.2
6707 #4 => vCont s:p1.1;c
6710 Above, the server must not resume thread p1.2. GDB can't know
6711 that p1.2 stopped until it acks the %Stopped notification, and
6712 since from GDB's perspective all threads should be running, it
6715 Finally, special care must also be given to handling fork/vfork
6716 events. A (v)fork event actually tells us that two processes
6717 stopped -- the parent and the child. Until we follow the fork,
6718 we must not resume the child. Therefore, if we have a pending
6719 fork follow, we must not send a global wildcard resume action
6720 (vCont;c). We can still send process-wide wildcards though. */
6722 /* Start by assuming a global wildcard (vCont;c) is possible. */
6723 bool may_global_wildcard_vcont
= true;
6725 /* And assume every process is individually wildcard-able too. */
6726 for (inferior
*inf
: all_non_exited_inferiors (this))
6728 remote_inferior
*priv
= get_remote_inferior (inf
);
6730 priv
->may_wildcard_vcont
= true;
6733 /* Check for any pending events (not reported or processed yet) and
6734 disable process and global wildcard resumes appropriately. */
6735 check_pending_events_prevent_wildcard_vcont (&may_global_wildcard_vcont
);
6737 bool any_pending_vcont_resume
= false;
6739 for (thread_info
*tp
: all_non_exited_threads (this))
6741 remote_thread_info
*priv
= get_remote_thread_info (tp
);
6743 /* If a thread of a process is not meant to be resumed, then we
6744 can't wildcard that process. */
6745 if (priv
->get_resume_state () == resume_state::NOT_RESUMED
)
6747 get_remote_inferior (tp
->inf
)->may_wildcard_vcont
= false;
6749 /* And if we can't wildcard a process, we can't wildcard
6750 everything either. */
6751 may_global_wildcard_vcont
= false;
6755 if (priv
->get_resume_state () == resume_state::RESUMED_PENDING_VCONT
)
6756 any_pending_vcont_resume
= true;
6758 /* If a thread is the parent of an unfollowed fork, then we
6759 can't do a global wildcard, as that would resume the fork
6761 if (is_pending_fork_parent_thread (tp
))
6762 may_global_wildcard_vcont
= false;
6765 /* We didn't have any resumed thread pending a vCont resume, so nothing to
6767 if (!any_pending_vcont_resume
)
6770 /* Now let's build the vCont packet(s). Actions must be appended
6771 from narrower to wider scopes (thread -> process -> global). If
6772 we end up with too many actions for a single packet vcont_builder
6773 flushes the current vCont packet to the remote side and starts a
6775 struct vcont_builder
vcont_builder (this);
6777 /* Threads first. */
6778 for (thread_info
*tp
: all_non_exited_threads (this))
6780 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6782 /* If the thread was previously vCont-resumed, no need to send a specific
6783 action for it. If we didn't receive a resume request for it, don't
6784 send an action for it either. */
6785 if (remote_thr
->get_resume_state () != resume_state::RESUMED_PENDING_VCONT
)
6788 gdb_assert (!thread_is_in_step_over_chain (tp
));
6790 /* We should never be commit-resuming a thread that has a stop reply.
6791 Otherwise, we would end up reporting a stop event for a thread while
6792 it is running on the remote target. */
6793 remote_state
*rs
= get_remote_state ();
6794 for (const auto &stop_reply
: rs
->stop_reply_queue
)
6795 gdb_assert (stop_reply
->ptid
!= tp
->ptid
);
6797 const resumed_pending_vcont_info
&info
6798 = remote_thr
->resumed_pending_vcont_info ();
6800 /* Check if we need to send a specific action for this thread. If not,
6801 it will be included in a wildcard resume instead. */
6802 if (info
.step
|| info
.sig
!= GDB_SIGNAL_0
6803 || !get_remote_inferior (tp
->inf
)->may_wildcard_vcont
)
6804 vcont_builder
.push_action (tp
->ptid
, info
.step
, info
.sig
);
6806 remote_thr
->set_resumed ();
6809 /* Now check whether we can send any process-wide wildcard. This is
6810 to avoid sending a global wildcard in the case nothing is
6811 supposed to be resumed. */
6812 bool any_process_wildcard
= false;
6814 for (inferior
*inf
: all_non_exited_inferiors (this))
6816 if (get_remote_inferior (inf
)->may_wildcard_vcont
)
6818 any_process_wildcard
= true;
6823 if (any_process_wildcard
)
6825 /* If all processes are wildcard-able, then send a single "c"
6826 action, otherwise, send an "all (-1) threads of process"
6827 continue action for each running process, if any. */
6828 if (may_global_wildcard_vcont
)
6830 vcont_builder
.push_action (minus_one_ptid
,
6831 false, GDB_SIGNAL_0
);
6835 for (inferior
*inf
: all_non_exited_inferiors (this))
6837 if (get_remote_inferior (inf
)->may_wildcard_vcont
)
6839 vcont_builder
.push_action (ptid_t (inf
->pid
),
6840 false, GDB_SIGNAL_0
);
6846 vcont_builder
.flush ();
6849 /* Implementation of target_has_pending_events. */
6852 remote_target::has_pending_events ()
6854 if (target_can_async_p ())
6856 remote_state
*rs
= get_remote_state ();
6858 if (async_event_handler_marked (rs
->remote_async_inferior_event_token
))
6861 /* Note that BUFCNT can be negative, indicating sticky
6863 if (rs
->remote_desc
->bufcnt
!= 0)
6871 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
6872 thread, all threads of a remote process, or all threads of all
6876 remote_target::remote_stop_ns (ptid_t ptid
)
6878 struct remote_state
*rs
= get_remote_state ();
6879 char *p
= rs
->buf
.data ();
6880 char *endp
= p
+ get_remote_packet_size ();
6882 /* If any thread that needs to stop was resumed but pending a vCont
6883 resume, generate a phony stop_reply. However, first check
6884 whether the thread wasn't resumed with a signal. Generating a
6885 phony stop in that case would result in losing the signal. */
6886 bool needs_commit
= false;
6887 for (thread_info
*tp
: all_non_exited_threads (this, ptid
))
6889 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6891 if (remote_thr
->get_resume_state ()
6892 == resume_state::RESUMED_PENDING_VCONT
)
6894 const resumed_pending_vcont_info
&info
6895 = remote_thr
->resumed_pending_vcont_info ();
6896 if (info
.sig
!= GDB_SIGNAL_0
)
6898 /* This signal must be forwarded to the inferior. We
6899 could commit-resume just this thread, but its simpler
6900 to just commit-resume everything. */
6901 needs_commit
= true;
6910 for (thread_info
*tp
: all_non_exited_threads (this, ptid
))
6912 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6914 if (remote_thr
->get_resume_state ()
6915 == resume_state::RESUMED_PENDING_VCONT
)
6917 remote_debug_printf ("Enqueueing phony stop reply for thread pending "
6918 "vCont-resume (%d, %ld, %s)", tp
->ptid
.pid(),
6920 pulongest (tp
->ptid
.tid ()));
6922 /* Check that the thread wasn't resumed with a signal.
6923 Generating a phony stop would result in losing the
6925 const resumed_pending_vcont_info
&info
6926 = remote_thr
->resumed_pending_vcont_info ();
6927 gdb_assert (info
.sig
== GDB_SIGNAL_0
);
6929 stop_reply
*sr
= new stop_reply ();
6930 sr
->ptid
= tp
->ptid
;
6932 sr
->ws
.set_stopped (GDB_SIGNAL_0
);
6933 sr
->arch
= tp
->inf
->gdbarch
;
6934 sr
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
6935 sr
->watch_data_address
= 0;
6937 this->push_stop_reply (sr
);
6939 /* Pretend that this thread was actually resumed on the
6940 remote target, then stopped. If we leave it in the
6941 RESUMED_PENDING_VCONT state and the commit_resumed
6942 method is called while the stop reply is still in the
6943 queue, we'll end up reporting a stop event to the core
6944 for that thread while it is running on the remote
6945 target... that would be bad. */
6946 remote_thr
->set_resumed ();
6950 /* FIXME: This supports_vCont_probed check is a workaround until
6951 packet_support is per-connection. */
6952 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
6953 || !rs
->supports_vCont_probed
)
6954 remote_vcont_probe ();
6956 if (!rs
->supports_vCont
.t
)
6957 error (_("Remote server does not support stopping threads"));
6959 if (ptid
== minus_one_ptid
6960 || (!remote_multi_process_p (rs
) && ptid
.is_pid ()))
6961 p
+= xsnprintf (p
, endp
- p
, "vCont;t");
6966 p
+= xsnprintf (p
, endp
- p
, "vCont;t:");
6969 /* All (-1) threads of process. */
6970 nptid
= ptid_t (ptid
.pid (), -1);
6973 /* Small optimization: if we already have a stop reply for
6974 this thread, no use in telling the stub we want this
6976 if (peek_stop_reply (ptid
))
6982 write_ptid (p
, endp
, nptid
);
6985 /* In non-stop, we get an immediate OK reply. The stop reply will
6986 come in asynchronously by notification. */
6988 getpkt (&rs
->buf
, 0);
6989 if (strcmp (rs
->buf
.data (), "OK") != 0)
6990 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid
).c_str (),
6994 /* All-stop version of target_interrupt. Sends a break or a ^C to
6995 interrupt the remote target. It is undefined which thread of which
6996 process reports the interrupt. */
6999 remote_target::remote_interrupt_as ()
7001 struct remote_state
*rs
= get_remote_state ();
7003 rs
->ctrlc_pending_p
= 1;
7005 /* If the inferior is stopped already, but the core didn't know
7006 about it yet, just ignore the request. The cached wait status
7007 will be collected in remote_wait. */
7008 if (rs
->cached_wait_status
)
7011 /* Send interrupt_sequence to remote target. */
7012 send_interrupt_sequence ();
7015 /* Non-stop version of target_interrupt. Uses `vCtrlC' to interrupt
7016 the remote target. It is undefined which thread of which process
7017 reports the interrupt. Throws an error if the packet is not
7018 supported by the server. */
7021 remote_target::remote_interrupt_ns ()
7023 struct remote_state
*rs
= get_remote_state ();
7024 char *p
= rs
->buf
.data ();
7025 char *endp
= p
+ get_remote_packet_size ();
7027 xsnprintf (p
, endp
- p
, "vCtrlC");
7029 /* In non-stop, we get an immediate OK reply. The stop reply will
7030 come in asynchronously by notification. */
7032 getpkt (&rs
->buf
, 0);
7034 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vCtrlC
]))
7038 case PACKET_UNKNOWN
:
7039 error (_("No support for interrupting the remote target."));
7041 error (_("Interrupting target failed: %s"), rs
->buf
.data ());
7045 /* Implement the to_stop function for the remote targets. */
7048 remote_target::stop (ptid_t ptid
)
7050 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7052 if (target_is_non_stop_p ())
7053 remote_stop_ns (ptid
);
7056 /* We don't currently have a way to transparently pause the
7057 remote target in all-stop mode. Interrupt it instead. */
7058 remote_interrupt_as ();
7062 /* Implement the to_interrupt function for the remote targets. */
7065 remote_target::interrupt ()
7067 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7069 if (target_is_non_stop_p ())
7070 remote_interrupt_ns ();
7072 remote_interrupt_as ();
7075 /* Implement the to_pass_ctrlc function for the remote targets. */
7078 remote_target::pass_ctrlc ()
7080 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7082 struct remote_state
*rs
= get_remote_state ();
7084 /* If we're starting up, we're not fully synced yet. Quit
7086 if (rs
->starting_up
)
7088 /* If ^C has already been sent once, offer to disconnect. */
7089 else if (rs
->ctrlc_pending_p
)
7092 target_interrupt ();
7095 /* Ask the user what to do when an interrupt is received. */
7098 remote_target::interrupt_query ()
7100 struct remote_state
*rs
= get_remote_state ();
7102 if (rs
->waiting_for_stop_reply
&& rs
->ctrlc_pending_p
)
7104 if (query (_("The target is not responding to interrupt requests.\n"
7105 "Stop debugging it? ")))
7107 remote_unpush_target (this);
7108 throw_error (TARGET_CLOSE_ERROR
, _("Disconnected from target."));
7113 if (query (_("Interrupted while waiting for the program.\n"
7114 "Give up waiting? ")))
7119 /* Enable/disable target terminal ownership. Most targets can use
7120 terminal groups to control terminal ownership. Remote targets are
7121 different in that explicit transfer of ownership to/from GDB/target
7125 remote_target::terminal_inferior ()
7127 /* NOTE: At this point we could also register our selves as the
7128 recipient of all input. Any characters typed could then be
7129 passed on down to the target. */
7133 remote_target::terminal_ours ()
7138 remote_console_output (const char *msg
)
7142 for (p
= msg
; p
[0] && p
[1]; p
+= 2)
7145 char c
= fromhex (p
[0]) * 16 + fromhex (p
[1]);
7149 gdb_stdtarg
->puts (tb
);
7151 gdb_stdtarg
->flush ();
7154 /* Return the length of the stop reply queue. */
7157 remote_target::stop_reply_queue_length ()
7159 remote_state
*rs
= get_remote_state ();
7160 return rs
->stop_reply_queue
.size ();
7164 remote_notif_stop_parse (remote_target
*remote
,
7165 struct notif_client
*self
, const char *buf
,
7166 struct notif_event
*event
)
7168 remote
->remote_parse_stop_reply (buf
, (struct stop_reply
*) event
);
7172 remote_notif_stop_ack (remote_target
*remote
,
7173 struct notif_client
*self
, const char *buf
,
7174 struct notif_event
*event
)
7176 struct stop_reply
*stop_reply
= (struct stop_reply
*) event
;
7179 putpkt (remote
, self
->ack_command
);
7181 /* Kind can be TARGET_WAITKIND_IGNORE if we have meanwhile discarded
7182 the notification. It was left in the queue because we need to
7183 acknowledge it and pull the rest of the notifications out. */
7184 if (stop_reply
->ws
.kind () != TARGET_WAITKIND_IGNORE
)
7185 remote
->push_stop_reply (stop_reply
);
7189 remote_notif_stop_can_get_pending_events (remote_target
*remote
,
7190 struct notif_client
*self
)
7192 /* We can't get pending events in remote_notif_process for
7193 notification stop, and we have to do this in remote_wait_ns
7194 instead. If we fetch all queued events from stub, remote stub
7195 may exit and we have no chance to process them back in
7197 remote_state
*rs
= remote
->get_remote_state ();
7198 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7202 stop_reply::~stop_reply ()
7204 for (cached_reg_t
®
: regcache
)
7208 static notif_event_up
7209 remote_notif_stop_alloc_reply ()
7211 return notif_event_up (new struct stop_reply ());
7214 /* A client of notification Stop. */
7216 struct notif_client notif_client_stop
=
7220 remote_notif_stop_parse
,
7221 remote_notif_stop_ack
,
7222 remote_notif_stop_can_get_pending_events
,
7223 remote_notif_stop_alloc_reply
,
7227 /* Determine if THREAD_PTID is a pending fork parent thread. ARG contains
7228 the pid of the process that owns the threads we want to check, or
7229 -1 if we want to check all threads. */
7232 is_pending_fork_parent (const target_waitstatus
&ws
, int event_pid
,
7235 if (ws
.kind () == TARGET_WAITKIND_FORKED
7236 || ws
.kind () == TARGET_WAITKIND_VFORKED
)
7238 if (event_pid
== -1 || event_pid
== thread_ptid
.pid ())
7245 /* Return the thread's pending status used to determine whether the
7246 thread is a fork parent stopped at a fork event. */
7248 static const target_waitstatus
&
7249 thread_pending_fork_status (struct thread_info
*thread
)
7251 if (thread
->has_pending_waitstatus ())
7252 return thread
->pending_waitstatus ();
7254 return thread
->pending_follow
;
7257 /* Determine if THREAD is a pending fork parent thread. */
7260 is_pending_fork_parent_thread (struct thread_info
*thread
)
7262 const target_waitstatus
&ws
= thread_pending_fork_status (thread
);
7265 return is_pending_fork_parent (ws
, pid
, thread
->ptid
);
7268 /* If CONTEXT contains any fork child threads that have not been
7269 reported yet, remove them from the CONTEXT list. If such a
7270 thread exists it is because we are stopped at a fork catchpoint
7271 and have not yet called follow_fork, which will set up the
7272 host-side data structures for the new process. */
7275 remote_target::remove_new_fork_children (threads_listing_context
*context
)
7278 struct notif_client
*notif
= ¬if_client_stop
;
7280 /* For any threads stopped at a fork event, remove the corresponding
7281 fork child threads from the CONTEXT list. */
7282 for (thread_info
*thread
: all_non_exited_threads (this))
7284 const target_waitstatus
&ws
= thread_pending_fork_status (thread
);
7286 if (is_pending_fork_parent (ws
, pid
, thread
->ptid
))
7287 context
->remove_thread (ws
.child_ptid ());
7290 /* Check for any pending fork events (not reported or processed yet)
7291 in process PID and remove those fork child threads from the
7292 CONTEXT list as well. */
7293 remote_notif_get_pending_events (notif
);
7294 for (auto &event
: get_remote_state ()->stop_reply_queue
)
7295 if (event
->ws
.kind () == TARGET_WAITKIND_FORKED
7296 || event
->ws
.kind () == TARGET_WAITKIND_VFORKED
7297 || event
->ws
.kind () == TARGET_WAITKIND_THREAD_EXITED
)
7298 context
->remove_thread (event
->ws
.child_ptid ());
7301 /* Check whether any event pending in the vStopped queue would prevent a
7302 global or process wildcard vCont action. Set *may_global_wildcard to
7303 false if we can't do a global wildcard (vCont;c), and clear the event
7304 inferior's may_wildcard_vcont flag if we can't do a process-wide
7305 wildcard resume (vCont;c:pPID.-1). */
7308 remote_target::check_pending_events_prevent_wildcard_vcont
7309 (bool *may_global_wildcard
)
7311 struct notif_client
*notif
= ¬if_client_stop
;
7313 remote_notif_get_pending_events (notif
);
7314 for (auto &event
: get_remote_state ()->stop_reply_queue
)
7316 if (event
->ws
.kind () == TARGET_WAITKIND_NO_RESUMED
7317 || event
->ws
.kind () == TARGET_WAITKIND_NO_HISTORY
)
7320 if (event
->ws
.kind () == TARGET_WAITKIND_FORKED
7321 || event
->ws
.kind () == TARGET_WAITKIND_VFORKED
)
7322 *may_global_wildcard
= false;
7324 /* This may be the first time we heard about this process.
7325 Regardless, we must not do a global wildcard resume, otherwise
7326 we'd resume this process too. */
7327 *may_global_wildcard
= false;
7328 if (event
->ptid
!= null_ptid
)
7330 inferior
*inf
= find_inferior_ptid (this, event
->ptid
);
7332 get_remote_inferior (inf
)->may_wildcard_vcont
= false;
7337 /* Discard all pending stop replies of inferior INF. */
7340 remote_target::discard_pending_stop_replies (struct inferior
*inf
)
7342 struct stop_reply
*reply
;
7343 struct remote_state
*rs
= get_remote_state ();
7344 struct remote_notif_state
*rns
= rs
->notif_state
;
7346 /* This function can be notified when an inferior exists. When the
7347 target is not remote, the notification state is NULL. */
7348 if (rs
->remote_desc
== NULL
)
7351 reply
= (struct stop_reply
*) rns
->pending_event
[notif_client_stop
.id
];
7353 /* Discard the in-flight notification. */
7354 if (reply
!= NULL
&& reply
->ptid
.pid () == inf
->pid
)
7356 /* Leave the notification pending, since the server expects that
7357 we acknowledge it with vStopped. But clear its contents, so
7358 that later on when we acknowledge it, we also discard it. */
7359 reply
->ws
.set_ignore ();
7362 fprintf_unfiltered (gdb_stdlog
,
7363 "discarded in-flight notification\n");
7366 /* Discard the stop replies we have already pulled with
7368 auto iter
= std::remove_if (rs
->stop_reply_queue
.begin (),
7369 rs
->stop_reply_queue
.end (),
7370 [=] (const stop_reply_up
&event
)
7372 return event
->ptid
.pid () == inf
->pid
;
7374 rs
->stop_reply_queue
.erase (iter
, rs
->stop_reply_queue
.end ());
7377 /* Discard the stop replies for RS in stop_reply_queue. */
7380 remote_target::discard_pending_stop_replies_in_queue ()
7382 remote_state
*rs
= get_remote_state ();
7384 /* Discard the stop replies we have already pulled with
7386 auto iter
= std::remove_if (rs
->stop_reply_queue
.begin (),
7387 rs
->stop_reply_queue
.end (),
7388 [=] (const stop_reply_up
&event
)
7390 return event
->rs
== rs
;
7392 rs
->stop_reply_queue
.erase (iter
, rs
->stop_reply_queue
.end ());
7395 /* Remove the first reply in 'stop_reply_queue' which matches
7399 remote_target::remote_notif_remove_queued_reply (ptid_t ptid
)
7401 remote_state
*rs
= get_remote_state ();
7403 auto iter
= std::find_if (rs
->stop_reply_queue
.begin (),
7404 rs
->stop_reply_queue
.end (),
7405 [=] (const stop_reply_up
&event
)
7407 return event
->ptid
.matches (ptid
);
7409 struct stop_reply
*result
;
7410 if (iter
== rs
->stop_reply_queue
.end ())
7414 result
= iter
->release ();
7415 rs
->stop_reply_queue
.erase (iter
);
7419 fprintf_unfiltered (gdb_stdlog
,
7420 "notif: discard queued event: 'Stop' in %s\n",
7421 target_pid_to_str (ptid
).c_str ());
7426 /* Look for a queued stop reply belonging to PTID. If one is found,
7427 remove it from the queue, and return it. Returns NULL if none is
7428 found. If there are still queued events left to process, tell the
7429 event loop to get back to target_wait soon. */
7432 remote_target::queued_stop_reply (ptid_t ptid
)
7434 remote_state
*rs
= get_remote_state ();
7435 struct stop_reply
*r
= remote_notif_remove_queued_reply (ptid
);
7437 if (!rs
->stop_reply_queue
.empty ())
7439 /* There's still at least an event left. */
7440 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7446 /* Push a fully parsed stop reply in the stop reply queue. Since we
7447 know that we now have at least one queued event left to pass to the
7448 core side, tell the event loop to get back to target_wait soon. */
7451 remote_target::push_stop_reply (struct stop_reply
*new_event
)
7453 remote_state
*rs
= get_remote_state ();
7454 rs
->stop_reply_queue
.push_back (stop_reply_up (new_event
));
7457 fprintf_unfiltered (gdb_stdlog
,
7458 "notif: push 'Stop' %s to queue %d\n",
7459 target_pid_to_str (new_event
->ptid
).c_str (),
7460 int (rs
->stop_reply_queue
.size ()));
7462 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7465 /* Returns true if we have a stop reply for PTID. */
7468 remote_target::peek_stop_reply (ptid_t ptid
)
7470 remote_state
*rs
= get_remote_state ();
7471 for (auto &event
: rs
->stop_reply_queue
)
7472 if (ptid
== event
->ptid
7473 && event
->ws
.kind () == TARGET_WAITKIND_STOPPED
)
7478 /* Helper for remote_parse_stop_reply. Return nonzero if the substring
7479 starting with P and ending with PEND matches PREFIX. */
7482 strprefix (const char *p
, const char *pend
, const char *prefix
)
7484 for ( ; p
< pend
; p
++, prefix
++)
7487 return *prefix
== '\0';
7490 /* Parse the stop reply in BUF. Either the function succeeds, and the
7491 result is stored in EVENT, or throws an error. */
7494 remote_target::remote_parse_stop_reply (const char *buf
, stop_reply
*event
)
7496 remote_arch_state
*rsa
= NULL
;
7501 event
->ptid
= null_ptid
;
7502 event
->rs
= get_remote_state ();
7503 event
->ws
.set_ignore ();
7504 event
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
7505 event
->regcache
.clear ();
7510 case 'T': /* Status with PC, SP, FP, ... */
7511 /* Expedited reply, containing Signal, {regno, reg} repeat. */
7512 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
7514 n... = register number
7515 r... = register contents
7518 p
= &buf
[3]; /* after Txx */
7524 p1
= strchr (p
, ':');
7526 error (_("Malformed packet(a) (missing colon): %s\n\
7530 error (_("Malformed packet(a) (missing register number): %s\n\
7534 /* Some "registers" are actually extended stop information.
7535 Note if you're adding a new entry here: GDB 7.9 and
7536 earlier assume that all register "numbers" that start
7537 with an hex digit are real register numbers. Make sure
7538 the server only sends such a packet if it knows the
7539 client understands it. */
7541 if (strprefix (p
, p1
, "thread"))
7542 event
->ptid
= read_ptid (++p1
, &p
);
7543 else if (strprefix (p
, p1
, "syscall_entry"))
7547 p
= unpack_varlen_hex (++p1
, &sysno
);
7548 event
->ws
.set_syscall_entry ((int) sysno
);
7550 else if (strprefix (p
, p1
, "syscall_return"))
7554 p
= unpack_varlen_hex (++p1
, &sysno
);
7555 event
->ws
.set_syscall_return ((int) sysno
);
7557 else if (strprefix (p
, p1
, "watch")
7558 || strprefix (p
, p1
, "rwatch")
7559 || strprefix (p
, p1
, "awatch"))
7561 event
->stop_reason
= TARGET_STOPPED_BY_WATCHPOINT
;
7562 p
= unpack_varlen_hex (++p1
, &addr
);
7563 event
->watch_data_address
= (CORE_ADDR
) addr
;
7565 else if (strprefix (p
, p1
, "swbreak"))
7567 event
->stop_reason
= TARGET_STOPPED_BY_SW_BREAKPOINT
;
7569 /* Make sure the stub doesn't forget to indicate support
7571 if (packet_support (PACKET_swbreak_feature
) != PACKET_ENABLE
)
7572 error (_("Unexpected swbreak stop reason"));
7574 /* The value part is documented as "must be empty",
7575 though we ignore it, in case we ever decide to make
7576 use of it in a backward compatible way. */
7577 p
= strchrnul (p1
+ 1, ';');
7579 else if (strprefix (p
, p1
, "hwbreak"))
7581 event
->stop_reason
= TARGET_STOPPED_BY_HW_BREAKPOINT
;
7583 /* Make sure the stub doesn't forget to indicate support
7585 if (packet_support (PACKET_hwbreak_feature
) != PACKET_ENABLE
)
7586 error (_("Unexpected hwbreak stop reason"));
7589 p
= strchrnul (p1
+ 1, ';');
7591 else if (strprefix (p
, p1
, "library"))
7593 event
->ws
.set_loaded ();
7594 p
= strchrnul (p1
+ 1, ';');
7596 else if (strprefix (p
, p1
, "replaylog"))
7598 event
->ws
.set_no_history ();
7599 /* p1 will indicate "begin" or "end", but it makes
7600 no difference for now, so ignore it. */
7601 p
= strchrnul (p1
+ 1, ';');
7603 else if (strprefix (p
, p1
, "core"))
7607 p
= unpack_varlen_hex (++p1
, &c
);
7610 else if (strprefix (p
, p1
, "fork"))
7611 event
->ws
.set_forked (read_ptid (++p1
, &p
));
7612 else if (strprefix (p
, p1
, "vfork"))
7613 event
->ws
.set_vforked (read_ptid (++p1
, &p
));
7614 else if (strprefix (p
, p1
, "vforkdone"))
7616 event
->ws
.set_vfork_done ();
7617 p
= strchrnul (p1
+ 1, ';');
7619 else if (strprefix (p
, p1
, "exec"))
7624 /* Determine the length of the execd pathname. */
7625 p
= unpack_varlen_hex (++p1
, &ignored
);
7626 pathlen
= (p
- p1
) / 2;
7628 /* Save the pathname for event reporting and for
7629 the next run command. */
7630 gdb::unique_xmalloc_ptr
<char> pathname
7631 ((char *) xmalloc (pathlen
+ 1));
7632 hex2bin (p1
, (gdb_byte
*) pathname
.get (), pathlen
);
7633 pathname
.get ()[pathlen
] = '\0';
7635 /* This is freed during event handling. */
7636 event
->ws
.set_execd (std::move (pathname
));
7638 /* Skip the registers included in this packet, since
7639 they may be for an architecture different from the
7640 one used by the original program. */
7643 else if (strprefix (p
, p1
, "create"))
7645 event
->ws
.set_thread_created ();
7646 p
= strchrnul (p1
+ 1, ';');
7655 p
= strchrnul (p1
+ 1, ';');
7660 /* Maybe a real ``P'' register number. */
7661 p_temp
= unpack_varlen_hex (p
, &pnum
);
7662 /* If the first invalid character is the colon, we got a
7663 register number. Otherwise, it's an unknown stop
7667 /* If we haven't parsed the event's thread yet, find
7668 it now, in order to find the architecture of the
7669 reported expedited registers. */
7670 if (event
->ptid
== null_ptid
)
7672 /* If there is no thread-id information then leave
7673 the event->ptid as null_ptid. Later in
7674 process_stop_reply we will pick a suitable
7676 const char *thr
= strstr (p1
+ 1, ";thread:");
7678 event
->ptid
= read_ptid (thr
+ strlen (";thread:"),
7685 = (event
->ptid
== null_ptid
7687 : find_inferior_ptid (this, event
->ptid
));
7688 /* If this is the first time we learn anything
7689 about this process, skip the registers
7690 included in this packet, since we don't yet
7691 know which architecture to use to parse them.
7692 We'll determine the architecture later when
7693 we process the stop reply and retrieve the
7694 target description, via
7695 remote_notice_new_inferior ->
7696 post_create_inferior. */
7699 p
= strchrnul (p1
+ 1, ';');
7704 event
->arch
= inf
->gdbarch
;
7705 rsa
= event
->rs
->get_remote_arch_state (event
->arch
);
7709 = packet_reg_from_pnum (event
->arch
, rsa
, pnum
);
7710 cached_reg_t cached_reg
;
7713 error (_("Remote sent bad register number %s: %s\n\
7715 hex_string (pnum
), p
, buf
);
7717 cached_reg
.num
= reg
->regnum
;
7718 cached_reg
.data
= (gdb_byte
*)
7719 xmalloc (register_size (event
->arch
, reg
->regnum
));
7722 fieldsize
= hex2bin (p
, cached_reg
.data
,
7723 register_size (event
->arch
, reg
->regnum
));
7725 if (fieldsize
< register_size (event
->arch
, reg
->regnum
))
7726 warning (_("Remote reply is too short: %s"), buf
);
7728 event
->regcache
.push_back (cached_reg
);
7732 /* Not a number. Silently skip unknown optional
7734 p
= strchrnul (p1
+ 1, ';');
7739 error (_("Remote register badly formatted: %s\nhere: %s"),
7744 if (event
->ws
.kind () != TARGET_WAITKIND_IGNORE
)
7748 case 'S': /* Old style status, just signal only. */
7752 sig
= (fromhex (buf
[1]) << 4) + fromhex (buf
[2]);
7753 if (GDB_SIGNAL_FIRST
<= sig
&& sig
< GDB_SIGNAL_LAST
)
7754 event
->ws
.set_stopped ((enum gdb_signal
) sig
);
7756 event
->ws
.set_stopped (GDB_SIGNAL_UNKNOWN
);
7759 case 'w': /* Thread exited. */
7763 p
= unpack_varlen_hex (&buf
[1], &value
);
7764 event
->ws
.set_thread_exited (value
);
7766 error (_("stop reply packet badly formatted: %s"), buf
);
7767 event
->ptid
= read_ptid (++p
, NULL
);
7770 case 'W': /* Target exited. */
7775 /* GDB used to accept only 2 hex chars here. Stubs should
7776 only send more if they detect GDB supports multi-process
7778 p
= unpack_varlen_hex (&buf
[1], &value
);
7782 /* The remote process exited. */
7783 event
->ws
.set_exited (value
);
7787 /* The remote process exited with a signal. */
7788 if (GDB_SIGNAL_FIRST
<= value
&& value
< GDB_SIGNAL_LAST
)
7789 event
->ws
.set_signalled ((enum gdb_signal
) value
);
7791 event
->ws
.set_signalled (GDB_SIGNAL_UNKNOWN
);
7794 /* If no process is specified, return null_ptid, and let the
7795 caller figure out the right process to use. */
7805 else if (startswith (p
, "process:"))
7809 p
+= sizeof ("process:") - 1;
7810 unpack_varlen_hex (p
, &upid
);
7814 error (_("unknown stop reply packet: %s"), buf
);
7817 error (_("unknown stop reply packet: %s"), buf
);
7818 event
->ptid
= ptid_t (pid
);
7822 event
->ws
.set_no_resumed ();
7823 event
->ptid
= minus_one_ptid
;
7828 /* When the stub wants to tell GDB about a new notification reply, it
7829 sends a notification (%Stop, for example). Those can come it at
7830 any time, hence, we have to make sure that any pending
7831 putpkt/getpkt sequence we're making is finished, before querying
7832 the stub for more events with the corresponding ack command
7833 (vStopped, for example). E.g., if we started a vStopped sequence
7834 immediately upon receiving the notification, something like this
7842 1.6) <-- (registers reply to step #1.3)
7844 Obviously, the reply in step #1.6 would be unexpected to a vStopped
7847 To solve this, whenever we parse a %Stop notification successfully,
7848 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
7849 doing whatever we were doing:
7855 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
7856 2.5) <-- (registers reply to step #2.3)
7858 Eventually after step #2.5, we return to the event loop, which
7859 notices there's an event on the
7860 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
7861 associated callback --- the function below. At this point, we're
7862 always safe to start a vStopped sequence. :
7865 2.7) <-- T05 thread:2
7871 remote_target::remote_notif_get_pending_events (notif_client
*nc
)
7873 struct remote_state
*rs
= get_remote_state ();
7875 if (rs
->notif_state
->pending_event
[nc
->id
] != NULL
)
7878 fprintf_unfiltered (gdb_stdlog
,
7879 "notif: process: '%s' ack pending event\n",
7883 nc
->ack (this, nc
, rs
->buf
.data (),
7884 rs
->notif_state
->pending_event
[nc
->id
]);
7885 rs
->notif_state
->pending_event
[nc
->id
] = NULL
;
7889 getpkt (&rs
->buf
, 0);
7890 if (strcmp (rs
->buf
.data (), "OK") == 0)
7893 remote_notif_ack (this, nc
, rs
->buf
.data ());
7899 fprintf_unfiltered (gdb_stdlog
,
7900 "notif: process: '%s' no pending reply\n",
7905 /* Wrapper around remote_target::remote_notif_get_pending_events to
7906 avoid having to export the whole remote_target class. */
7909 remote_notif_get_pending_events (remote_target
*remote
, notif_client
*nc
)
7911 remote
->remote_notif_get_pending_events (nc
);
7914 /* Called from process_stop_reply when the stop packet we are responding
7915 to didn't include a process-id or thread-id. STATUS is the stop event
7916 we are responding to.
7918 It is the task of this function to select a suitable thread (or process)
7919 and return its ptid, this is the thread (or process) we will assume the
7920 stop event came from.
7922 In some cases there isn't really any choice about which thread (or
7923 process) is selected, a basic remote with a single process containing a
7924 single thread might choose not to send any process-id or thread-id in
7925 its stop packets, this function will select and return the one and only
7928 However, if a target supports multiple threads (or processes) and still
7929 doesn't include a thread-id (or process-id) in its stop packet then
7930 first, this is a badly behaving target, and second, we're going to have
7931 to select a thread (or process) at random and use that. This function
7932 will print a warning to the user if it detects that there is the
7933 possibility that GDB is guessing which thread (or process) to
7936 Note that this is called before GDB fetches the updated thread list from the
7937 target. So it's possible for the stop reply to be ambiguous and for GDB to
7938 not realize it. For example, if there's initially one thread, the target
7939 spawns a second thread, and then sends a stop reply without an id that
7940 concerns the first thread. GDB will assume the stop reply is about the
7941 first thread - the only thread it knows about - without printing a warning.
7942 Anyway, if the remote meant for the stop reply to be about the second thread,
7943 then it would be really broken, because GDB doesn't know about that thread
7947 remote_target::select_thread_for_ambiguous_stop_reply
7948 (const target_waitstatus
&status
)
7950 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7952 /* Some stop events apply to all threads in an inferior, while others
7953 only apply to a single thread. */
7954 bool process_wide_stop
7955 = (status
.kind () == TARGET_WAITKIND_EXITED
7956 || status
.kind () == TARGET_WAITKIND_SIGNALLED
);
7958 remote_debug_printf ("process_wide_stop = %d", process_wide_stop
);
7960 thread_info
*first_resumed_thread
= nullptr;
7961 bool ambiguous
= false;
7963 /* Consider all non-exited threads of the target, find the first resumed
7965 for (thread_info
*thr
: all_non_exited_threads (this))
7967 remote_thread_info
*remote_thr
= get_remote_thread_info (thr
);
7969 if (remote_thr
->get_resume_state () != resume_state::RESUMED
)
7972 if (first_resumed_thread
== nullptr)
7973 first_resumed_thread
= thr
;
7974 else if (!process_wide_stop
7975 || first_resumed_thread
->ptid
.pid () != thr
->ptid
.pid ())
7979 remote_debug_printf ("first resumed thread is %s",
7980 pid_to_str (first_resumed_thread
->ptid
).c_str ());
7981 remote_debug_printf ("is this guess ambiguous? = %d", ambiguous
);
7983 gdb_assert (first_resumed_thread
!= nullptr);
7985 /* Warn if the remote target is sending ambiguous stop replies. */
7988 static bool warned
= false;
7992 /* If you are seeing this warning then the remote target has
7993 stopped without specifying a thread-id, but the target
7994 does have multiple threads (or inferiors), and so GDB is
7995 having to guess which thread stopped.
7997 Examples of what might cause this are the target sending
7998 and 'S' stop packet, or a 'T' stop packet and not
7999 including a thread-id.
8001 Additionally, the target might send a 'W' or 'X packet
8002 without including a process-id, when the target has
8003 multiple running inferiors. */
8004 if (process_wide_stop
)
8005 warning (_("multi-inferior target stopped without "
8006 "sending a process-id, using first "
8007 "non-exited inferior"));
8009 warning (_("multi-threaded target stopped without "
8010 "sending a thread-id, using first "
8011 "non-exited thread"));
8016 /* If this is a stop for all threads then don't use a particular threads
8017 ptid, instead create a new ptid where only the pid field is set. */
8018 if (process_wide_stop
)
8019 return ptid_t (first_resumed_thread
->ptid
.pid ());
8021 return first_resumed_thread
->ptid
;
8024 /* Called when it is decided that STOP_REPLY holds the info of the
8025 event that is to be returned to the core. This function always
8026 destroys STOP_REPLY. */
8029 remote_target::process_stop_reply (struct stop_reply
*stop_reply
,
8030 struct target_waitstatus
*status
)
8032 *status
= stop_reply
->ws
;
8033 ptid_t ptid
= stop_reply
->ptid
;
8035 /* If no thread/process was reported by the stub then select a suitable
8037 if (ptid
== null_ptid
)
8038 ptid
= select_thread_for_ambiguous_stop_reply (*status
);
8039 gdb_assert (ptid
!= null_ptid
);
8041 if (status
->kind () != TARGET_WAITKIND_EXITED
8042 && status
->kind () != TARGET_WAITKIND_SIGNALLED
8043 && status
->kind () != TARGET_WAITKIND_NO_RESUMED
)
8045 /* Expedited registers. */
8046 if (!stop_reply
->regcache
.empty ())
8048 struct regcache
*regcache
8049 = get_thread_arch_regcache (this, ptid
, stop_reply
->arch
);
8051 for (cached_reg_t
®
: stop_reply
->regcache
)
8053 regcache
->raw_supply (reg
.num
, reg
.data
);
8057 stop_reply
->regcache
.clear ();
8060 remote_notice_new_inferior (ptid
, false);
8061 remote_thread_info
*remote_thr
= get_remote_thread_info (this, ptid
);
8062 remote_thr
->core
= stop_reply
->core
;
8063 remote_thr
->stop_reason
= stop_reply
->stop_reason
;
8064 remote_thr
->watch_data_address
= stop_reply
->watch_data_address
;
8066 if (target_is_non_stop_p ())
8068 /* If the target works in non-stop mode, a stop-reply indicates that
8069 only this thread stopped. */
8070 remote_thr
->set_not_resumed ();
8074 /* If the target works in all-stop mode, a stop-reply indicates that
8075 all the target's threads stopped. */
8076 for (thread_info
*tp
: all_non_exited_threads (this))
8077 get_remote_thread_info (tp
)->set_not_resumed ();
8085 /* The non-stop mode version of target_wait. */
8088 remote_target::wait_ns (ptid_t ptid
, struct target_waitstatus
*status
,
8089 target_wait_flags options
)
8091 struct remote_state
*rs
= get_remote_state ();
8092 struct stop_reply
*stop_reply
;
8096 /* If in non-stop mode, get out of getpkt even if a
8097 notification is received. */
8099 ret
= getpkt_or_notif_sane (&rs
->buf
, 0 /* forever */, &is_notif
);
8102 if (ret
!= -1 && !is_notif
)
8105 case 'E': /* Error of some sort. */
8106 /* We're out of sync with the target now. Did it continue
8107 or not? We can't tell which thread it was in non-stop,
8108 so just ignore this. */
8109 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
8111 case 'O': /* Console output. */
8112 remote_console_output (&rs
->buf
[1]);
8115 warning (_("Invalid remote reply: %s"), rs
->buf
.data ());
8119 /* Acknowledge a pending stop reply that may have arrived in the
8121 if (rs
->notif_state
->pending_event
[notif_client_stop
.id
] != NULL
)
8122 remote_notif_get_pending_events (¬if_client_stop
);
8124 /* If indeed we noticed a stop reply, we're done. */
8125 stop_reply
= queued_stop_reply (ptid
);
8126 if (stop_reply
!= NULL
)
8127 return process_stop_reply (stop_reply
, status
);
8129 /* Still no event. If we're just polling for an event, then
8130 return to the event loop. */
8131 if (options
& TARGET_WNOHANG
)
8133 status
->set_ignore ();
8134 return minus_one_ptid
;
8137 /* Otherwise do a blocking wait. */
8138 ret
= getpkt_or_notif_sane (&rs
->buf
, 1 /* forever */, &is_notif
);
8142 /* Return the first resumed thread. */
8145 first_remote_resumed_thread (remote_target
*target
)
8147 for (thread_info
*tp
: all_non_exited_threads (target
, minus_one_ptid
))
8153 /* Wait until the remote machine stops, then return, storing status in
8154 STATUS just as `wait' would. */
8157 remote_target::wait_as (ptid_t ptid
, target_waitstatus
*status
,
8158 target_wait_flags options
)
8160 struct remote_state
*rs
= get_remote_state ();
8161 ptid_t event_ptid
= null_ptid
;
8163 struct stop_reply
*stop_reply
;
8167 status
->set_ignore ();
8169 stop_reply
= queued_stop_reply (ptid
);
8170 if (stop_reply
!= NULL
)
8171 return process_stop_reply (stop_reply
, status
);
8173 if (rs
->cached_wait_status
)
8174 /* Use the cached wait status, but only once. */
8175 rs
->cached_wait_status
= 0;
8180 int forever
= ((options
& TARGET_WNOHANG
) == 0
8181 && rs
->wait_forever_enabled_p
);
8183 if (!rs
->waiting_for_stop_reply
)
8185 status
->set_no_resumed ();
8186 return minus_one_ptid
;
8189 /* FIXME: cagney/1999-09-27: If we're in async mode we should
8190 _never_ wait for ever -> test on target_is_async_p().
8191 However, before we do that we need to ensure that the caller
8192 knows how to take the target into/out of async mode. */
8193 ret
= getpkt_or_notif_sane (&rs
->buf
, forever
, &is_notif
);
8195 /* GDB gets a notification. Return to core as this event is
8197 if (ret
!= -1 && is_notif
)
8198 return minus_one_ptid
;
8200 if (ret
== -1 && (options
& TARGET_WNOHANG
) != 0)
8201 return minus_one_ptid
;
8204 buf
= rs
->buf
.data ();
8206 /* Assume that the target has acknowledged Ctrl-C unless we receive
8207 an 'F' or 'O' packet. */
8208 if (buf
[0] != 'F' && buf
[0] != 'O')
8209 rs
->ctrlc_pending_p
= 0;
8213 case 'E': /* Error of some sort. */
8214 /* We're out of sync with the target now. Did it continue or
8215 not? Not is more likely, so report a stop. */
8216 rs
->waiting_for_stop_reply
= 0;
8218 warning (_("Remote failure reply: %s"), buf
);
8219 status
->set_stopped (GDB_SIGNAL_0
);
8221 case 'F': /* File-I/O request. */
8222 /* GDB may access the inferior memory while handling the File-I/O
8223 request, but we don't want GDB accessing memory while waiting
8224 for a stop reply. See the comments in putpkt_binary. Set
8225 waiting_for_stop_reply to 0 temporarily. */
8226 rs
->waiting_for_stop_reply
= 0;
8227 remote_fileio_request (this, buf
, rs
->ctrlc_pending_p
);
8228 rs
->ctrlc_pending_p
= 0;
8229 /* GDB handled the File-I/O request, and the target is running
8230 again. Keep waiting for events. */
8231 rs
->waiting_for_stop_reply
= 1;
8233 case 'N': case 'T': case 'S': case 'X': case 'W':
8235 /* There is a stop reply to handle. */
8236 rs
->waiting_for_stop_reply
= 0;
8239 = (struct stop_reply
*) remote_notif_parse (this,
8243 event_ptid
= process_stop_reply (stop_reply
, status
);
8246 case 'O': /* Console output. */
8247 remote_console_output (buf
+ 1);
8250 if (rs
->last_sent_signal
!= GDB_SIGNAL_0
)
8252 /* Zero length reply means that we tried 'S' or 'C' and the
8253 remote system doesn't support it. */
8254 target_terminal::ours_for_output ();
8256 ("Can't send signals to this remote system. %s not sent.\n",
8257 gdb_signal_to_name (rs
->last_sent_signal
));
8258 rs
->last_sent_signal
= GDB_SIGNAL_0
;
8259 target_terminal::inferior ();
8261 strcpy (buf
, rs
->last_sent_step
? "s" : "c");
8267 warning (_("Invalid remote reply: %s"), buf
);
8271 if (status
->kind () == TARGET_WAITKIND_NO_RESUMED
)
8272 return minus_one_ptid
;
8273 else if (status
->kind () == TARGET_WAITKIND_IGNORE
)
8275 /* Nothing interesting happened. If we're doing a non-blocking
8276 poll, we're done. Otherwise, go back to waiting. */
8277 if (options
& TARGET_WNOHANG
)
8278 return minus_one_ptid
;
8282 else if (status
->kind () != TARGET_WAITKIND_EXITED
8283 && status
->kind () != TARGET_WAITKIND_SIGNALLED
)
8285 if (event_ptid
!= null_ptid
)
8286 record_currthread (rs
, event_ptid
);
8288 event_ptid
= first_remote_resumed_thread (this);
8292 /* A process exit. Invalidate our notion of current thread. */
8293 record_currthread (rs
, minus_one_ptid
);
8294 /* It's possible that the packet did not include a pid. */
8295 if (event_ptid
== null_ptid
)
8296 event_ptid
= first_remote_resumed_thread (this);
8297 /* EVENT_PTID could still be NULL_PTID. Double-check. */
8298 if (event_ptid
== null_ptid
)
8299 event_ptid
= magic_null_ptid
;
8305 /* Wait until the remote machine stops, then return, storing status in
8306 STATUS just as `wait' would. */
8309 remote_target::wait (ptid_t ptid
, struct target_waitstatus
*status
,
8310 target_wait_flags options
)
8312 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
8314 remote_state
*rs
= get_remote_state ();
8316 /* Start by clearing the flag that asks for our wait method to be called,
8317 we'll mark it again at the end if needed. */
8318 if (target_is_async_p ())
8319 clear_async_event_handler (rs
->remote_async_inferior_event_token
);
8323 if (target_is_non_stop_p ())
8324 event_ptid
= wait_ns (ptid
, status
, options
);
8326 event_ptid
= wait_as (ptid
, status
, options
);
8328 if (target_is_async_p ())
8330 /* If there are events left in the queue, or unacknowledged
8331 notifications, then tell the event loop to call us again. */
8332 if (!rs
->stop_reply_queue
.empty ()
8333 || rs
->notif_state
->pending_event
[notif_client_stop
.id
] != nullptr)
8334 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
8340 /* Fetch a single register using a 'p' packet. */
8343 remote_target::fetch_register_using_p (struct regcache
*regcache
,
8346 struct gdbarch
*gdbarch
= regcache
->arch ();
8347 struct remote_state
*rs
= get_remote_state ();
8349 gdb_byte
*regp
= (gdb_byte
*) alloca (register_size (gdbarch
, reg
->regnum
));
8352 if (packet_support (PACKET_p
) == PACKET_DISABLE
)
8355 if (reg
->pnum
== -1)
8358 p
= rs
->buf
.data ();
8360 p
+= hexnumstr (p
, reg
->pnum
);
8363 getpkt (&rs
->buf
, 0);
8365 buf
= rs
->buf
.data ();
8367 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_p
]))
8371 case PACKET_UNKNOWN
:
8374 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
8375 gdbarch_register_name (regcache
->arch (),
8380 /* If this register is unfetchable, tell the regcache. */
8383 regcache
->raw_supply (reg
->regnum
, NULL
);
8387 /* Otherwise, parse and supply the value. */
8393 error (_("fetch_register_using_p: early buf termination"));
8395 regp
[i
++] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
8398 regcache
->raw_supply (reg
->regnum
, regp
);
8402 /* Fetch the registers included in the target's 'g' packet. */
8405 remote_target::send_g_packet ()
8407 struct remote_state
*rs
= get_remote_state ();
8410 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "g");
8412 getpkt (&rs
->buf
, 0);
8413 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
8414 error (_("Could not read registers; remote failure reply '%s'"),
8417 /* We can get out of synch in various cases. If the first character
8418 in the buffer is not a hex character, assume that has happened
8419 and try to fetch another packet to read. */
8420 while ((rs
->buf
[0] < '0' || rs
->buf
[0] > '9')
8421 && (rs
->buf
[0] < 'A' || rs
->buf
[0] > 'F')
8422 && (rs
->buf
[0] < 'a' || rs
->buf
[0] > 'f')
8423 && rs
->buf
[0] != 'x') /* New: unavailable register value. */
8425 remote_debug_printf ("Bad register packet; fetching a new packet");
8426 getpkt (&rs
->buf
, 0);
8429 buf_len
= strlen (rs
->buf
.data ());
8431 /* Sanity check the received packet. */
8432 if (buf_len
% 2 != 0)
8433 error (_("Remote 'g' packet reply is of odd length: %s"), rs
->buf
.data ());
8439 remote_target::process_g_packet (struct regcache
*regcache
)
8441 struct gdbarch
*gdbarch
= regcache
->arch ();
8442 struct remote_state
*rs
= get_remote_state ();
8443 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8448 buf_len
= strlen (rs
->buf
.data ());
8450 /* Further sanity checks, with knowledge of the architecture. */
8451 if (buf_len
> 2 * rsa
->sizeof_g_packet
)
8452 error (_("Remote 'g' packet reply is too long (expected %ld bytes, got %d "
8454 rsa
->sizeof_g_packet
, buf_len
/ 2,
8457 /* Save the size of the packet sent to us by the target. It is used
8458 as a heuristic when determining the max size of packets that the
8459 target can safely receive. */
8460 if (rsa
->actual_register_packet_size
== 0)
8461 rsa
->actual_register_packet_size
= buf_len
;
8463 /* If this is smaller than we guessed the 'g' packet would be,
8464 update our records. A 'g' reply that doesn't include a register's
8465 value implies either that the register is not available, or that
8466 the 'p' packet must be used. */
8467 if (buf_len
< 2 * rsa
->sizeof_g_packet
)
8469 long sizeof_g_packet
= buf_len
/ 2;
8471 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8473 long offset
= rsa
->regs
[i
].offset
;
8474 long reg_size
= register_size (gdbarch
, i
);
8476 if (rsa
->regs
[i
].pnum
== -1)
8479 if (offset
>= sizeof_g_packet
)
8480 rsa
->regs
[i
].in_g_packet
= 0;
8481 else if (offset
+ reg_size
> sizeof_g_packet
)
8482 error (_("Truncated register %d in remote 'g' packet"), i
);
8484 rsa
->regs
[i
].in_g_packet
= 1;
8487 /* Looks valid enough, we can assume this is the correct length
8488 for a 'g' packet. It's important not to adjust
8489 rsa->sizeof_g_packet if we have truncated registers otherwise
8490 this "if" won't be run the next time the method is called
8491 with a packet of the same size and one of the internal errors
8492 below will trigger instead. */
8493 rsa
->sizeof_g_packet
= sizeof_g_packet
;
8496 regs
= (char *) alloca (rsa
->sizeof_g_packet
);
8498 /* Unimplemented registers read as all bits zero. */
8499 memset (regs
, 0, rsa
->sizeof_g_packet
);
8501 /* Reply describes registers byte by byte, each byte encoded as two
8502 hex characters. Suck them all up, then supply them to the
8503 register cacheing/storage mechanism. */
8505 p
= rs
->buf
.data ();
8506 for (i
= 0; i
< rsa
->sizeof_g_packet
; i
++)
8508 if (p
[0] == 0 || p
[1] == 0)
8509 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
8510 internal_error (__FILE__
, __LINE__
,
8511 _("unexpected end of 'g' packet reply"));
8513 if (p
[0] == 'x' && p
[1] == 'x')
8514 regs
[i
] = 0; /* 'x' */
8516 regs
[i
] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
8520 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8522 struct packet_reg
*r
= &rsa
->regs
[i
];
8523 long reg_size
= register_size (gdbarch
, i
);
8527 if ((r
->offset
+ reg_size
) * 2 > strlen (rs
->buf
.data ()))
8528 /* This shouldn't happen - we adjusted in_g_packet above. */
8529 internal_error (__FILE__
, __LINE__
,
8530 _("unexpected end of 'g' packet reply"));
8531 else if (rs
->buf
[r
->offset
* 2] == 'x')
8533 gdb_assert (r
->offset
* 2 < strlen (rs
->buf
.data ()));
8534 /* The register isn't available, mark it as such (at
8535 the same time setting the value to zero). */
8536 regcache
->raw_supply (r
->regnum
, NULL
);
8539 regcache
->raw_supply (r
->regnum
, regs
+ r
->offset
);
8545 remote_target::fetch_registers_using_g (struct regcache
*regcache
)
8548 process_g_packet (regcache
);
8551 /* Make the remote selected traceframe match GDB's selected
8555 remote_target::set_remote_traceframe ()
8558 struct remote_state
*rs
= get_remote_state ();
8560 if (rs
->remote_traceframe_number
== get_traceframe_number ())
8563 /* Avoid recursion, remote_trace_find calls us again. */
8564 rs
->remote_traceframe_number
= get_traceframe_number ();
8566 newnum
= target_trace_find (tfind_number
,
8567 get_traceframe_number (), 0, 0, NULL
);
8569 /* Should not happen. If it does, all bets are off. */
8570 if (newnum
!= get_traceframe_number ())
8571 warning (_("could not set remote traceframe"));
8575 remote_target::fetch_registers (struct regcache
*regcache
, int regnum
)
8577 struct gdbarch
*gdbarch
= regcache
->arch ();
8578 struct remote_state
*rs
= get_remote_state ();
8579 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8582 set_remote_traceframe ();
8583 set_general_thread (regcache
->ptid ());
8587 packet_reg
*reg
= packet_reg_from_regnum (gdbarch
, rsa
, regnum
);
8589 gdb_assert (reg
!= NULL
);
8591 /* If this register might be in the 'g' packet, try that first -
8592 we are likely to read more than one register. If this is the
8593 first 'g' packet, we might be overly optimistic about its
8594 contents, so fall back to 'p'. */
8595 if (reg
->in_g_packet
)
8597 fetch_registers_using_g (regcache
);
8598 if (reg
->in_g_packet
)
8602 if (fetch_register_using_p (regcache
, reg
))
8605 /* This register is not available. */
8606 regcache
->raw_supply (reg
->regnum
, NULL
);
8611 fetch_registers_using_g (regcache
);
8613 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8614 if (!rsa
->regs
[i
].in_g_packet
)
8615 if (!fetch_register_using_p (regcache
, &rsa
->regs
[i
]))
8617 /* This register is not available. */
8618 regcache
->raw_supply (i
, NULL
);
8622 /* Prepare to store registers. Since we may send them all (using a
8623 'G' request), we have to read out the ones we don't want to change
8627 remote_target::prepare_to_store (struct regcache
*regcache
)
8629 struct remote_state
*rs
= get_remote_state ();
8630 remote_arch_state
*rsa
= rs
->get_remote_arch_state (regcache
->arch ());
8633 /* Make sure the entire registers array is valid. */
8634 switch (packet_support (PACKET_P
))
8636 case PACKET_DISABLE
:
8637 case PACKET_SUPPORT_UNKNOWN
:
8638 /* Make sure all the necessary registers are cached. */
8639 for (i
= 0; i
< gdbarch_num_regs (regcache
->arch ()); i
++)
8640 if (rsa
->regs
[i
].in_g_packet
)
8641 regcache
->raw_update (rsa
->regs
[i
].regnum
);
8648 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
8649 packet was not recognized. */
8652 remote_target::store_register_using_P (const struct regcache
*regcache
,
8655 struct gdbarch
*gdbarch
= regcache
->arch ();
8656 struct remote_state
*rs
= get_remote_state ();
8657 /* Try storing a single register. */
8658 char *buf
= rs
->buf
.data ();
8659 gdb_byte
*regp
= (gdb_byte
*) alloca (register_size (gdbarch
, reg
->regnum
));
8662 if (packet_support (PACKET_P
) == PACKET_DISABLE
)
8665 if (reg
->pnum
== -1)
8668 xsnprintf (buf
, get_remote_packet_size (), "P%s=", phex_nz (reg
->pnum
, 0));
8669 p
= buf
+ strlen (buf
);
8670 regcache
->raw_collect (reg
->regnum
, regp
);
8671 bin2hex (regp
, p
, register_size (gdbarch
, reg
->regnum
));
8673 getpkt (&rs
->buf
, 0);
8675 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_P
]))
8680 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
8681 gdbarch_register_name (gdbarch
, reg
->regnum
), rs
->buf
.data ());
8682 case PACKET_UNKNOWN
:
8685 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
8689 /* Store register REGNUM, or all registers if REGNUM == -1, from the
8690 contents of the register cache buffer. FIXME: ignores errors. */
8693 remote_target::store_registers_using_G (const struct regcache
*regcache
)
8695 struct remote_state
*rs
= get_remote_state ();
8696 remote_arch_state
*rsa
= rs
->get_remote_arch_state (regcache
->arch ());
8700 /* Extract all the registers in the regcache copying them into a
8705 regs
= (gdb_byte
*) alloca (rsa
->sizeof_g_packet
);
8706 memset (regs
, 0, rsa
->sizeof_g_packet
);
8707 for (i
= 0; i
< gdbarch_num_regs (regcache
->arch ()); i
++)
8709 struct packet_reg
*r
= &rsa
->regs
[i
];
8712 regcache
->raw_collect (r
->regnum
, regs
+ r
->offset
);
8716 /* Command describes registers byte by byte,
8717 each byte encoded as two hex characters. */
8718 p
= rs
->buf
.data ();
8720 bin2hex (regs
, p
, rsa
->sizeof_g_packet
);
8722 getpkt (&rs
->buf
, 0);
8723 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
8724 error (_("Could not write registers; remote failure reply '%s'"),
8728 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
8729 of the register cache buffer. FIXME: ignores errors. */
8732 remote_target::store_registers (struct regcache
*regcache
, int regnum
)
8734 struct gdbarch
*gdbarch
= regcache
->arch ();
8735 struct remote_state
*rs
= get_remote_state ();
8736 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8739 set_remote_traceframe ();
8740 set_general_thread (regcache
->ptid ());
8744 packet_reg
*reg
= packet_reg_from_regnum (gdbarch
, rsa
, regnum
);
8746 gdb_assert (reg
!= NULL
);
8748 /* Always prefer to store registers using the 'P' packet if
8749 possible; we often change only a small number of registers.
8750 Sometimes we change a larger number; we'd need help from a
8751 higher layer to know to use 'G'. */
8752 if (store_register_using_P (regcache
, reg
))
8755 /* For now, don't complain if we have no way to write the
8756 register. GDB loses track of unavailable registers too
8757 easily. Some day, this may be an error. We don't have
8758 any way to read the register, either... */
8759 if (!reg
->in_g_packet
)
8762 store_registers_using_G (regcache
);
8766 store_registers_using_G (regcache
);
8768 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8769 if (!rsa
->regs
[i
].in_g_packet
)
8770 if (!store_register_using_P (regcache
, &rsa
->regs
[i
]))
8771 /* See above for why we do not issue an error here. */
8776 /* Return the number of hex digits in num. */
8779 hexnumlen (ULONGEST num
)
8783 for (i
= 0; num
!= 0; i
++)
8786 return std::max (i
, 1);
8789 /* Set BUF to the minimum number of hex digits representing NUM. */
8792 hexnumstr (char *buf
, ULONGEST num
)
8794 int len
= hexnumlen (num
);
8796 return hexnumnstr (buf
, num
, len
);
8800 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
8803 hexnumnstr (char *buf
, ULONGEST num
, int width
)
8809 for (i
= width
- 1; i
>= 0; i
--)
8811 buf
[i
] = "0123456789abcdef"[(num
& 0xf)];
8818 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
8821 remote_address_masked (CORE_ADDR addr
)
8823 unsigned int address_size
= remote_address_size
;
8825 /* If "remoteaddresssize" was not set, default to target address size. */
8827 address_size
= gdbarch_addr_bit (target_gdbarch ());
8829 if (address_size
> 0
8830 && address_size
< (sizeof (ULONGEST
) * 8))
8832 /* Only create a mask when that mask can safely be constructed
8833 in a ULONGEST variable. */
8836 mask
= (mask
<< address_size
) - 1;
8842 /* Determine whether the remote target supports binary downloading.
8843 This is accomplished by sending a no-op memory write of zero length
8844 to the target at the specified address. It does not suffice to send
8845 the whole packet, since many stubs strip the eighth bit and
8846 subsequently compute a wrong checksum, which causes real havoc with
8849 NOTE: This can still lose if the serial line is not eight-bit
8850 clean. In cases like this, the user should clear "remote
8854 remote_target::check_binary_download (CORE_ADDR addr
)
8856 struct remote_state
*rs
= get_remote_state ();
8858 switch (packet_support (PACKET_X
))
8860 case PACKET_DISABLE
:
8864 case PACKET_SUPPORT_UNKNOWN
:
8868 p
= rs
->buf
.data ();
8870 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8872 p
+= hexnumstr (p
, (ULONGEST
) 0);
8876 putpkt_binary (rs
->buf
.data (), (int) (p
- rs
->buf
.data ()));
8877 getpkt (&rs
->buf
, 0);
8879 if (rs
->buf
[0] == '\0')
8881 remote_debug_printf ("binary downloading NOT supported by target");
8882 remote_protocol_packets
[PACKET_X
].support
= PACKET_DISABLE
;
8886 remote_debug_printf ("binary downloading supported by target");
8887 remote_protocol_packets
[PACKET_X
].support
= PACKET_ENABLE
;
8894 /* Helper function to resize the payload in order to try to get a good
8895 alignment. We try to write an amount of data such that the next write will
8896 start on an address aligned on REMOTE_ALIGN_WRITES. */
8899 align_for_efficient_write (int todo
, CORE_ADDR memaddr
)
8901 return ((memaddr
+ todo
) & ~(REMOTE_ALIGN_WRITES
- 1)) - memaddr
;
8904 /* Write memory data directly to the remote machine.
8905 This does not inform the data cache; the data cache uses this.
8906 HEADER is the starting part of the packet.
8907 MEMADDR is the address in the remote memory space.
8908 MYADDR is the address of the buffer in our space.
8909 LEN_UNITS is the number of addressable units to write.
8910 UNIT_SIZE is the length in bytes of an addressable unit.
8911 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
8912 should send data as binary ('X'), or hex-encoded ('M').
8914 The function creates packet of the form
8915 <HEADER><ADDRESS>,<LENGTH>:<DATA>
8917 where encoding of <DATA> is terminated by PACKET_FORMAT.
8919 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
8922 Return the transferred status, error or OK (an
8923 'enum target_xfer_status' value). Save the number of addressable units
8924 transferred in *XFERED_LEN_UNITS. Only transfer a single packet.
8926 On a platform with an addressable memory size of 2 bytes (UNIT_SIZE == 2), an
8927 exchange between gdb and the stub could look like (?? in place of the
8933 -> $M1000,3:eeeeffffeeee#??
8937 <- eeeeffffeeeedddd */
8940 remote_target::remote_write_bytes_aux (const char *header
, CORE_ADDR memaddr
,
8941 const gdb_byte
*myaddr
,
8944 ULONGEST
*xfered_len_units
,
8945 char packet_format
, int use_length
)
8947 struct remote_state
*rs
= get_remote_state ();
8953 int payload_capacity_bytes
;
8954 int payload_length_bytes
;
8956 if (packet_format
!= 'X' && packet_format
!= 'M')
8957 internal_error (__FILE__
, __LINE__
,
8958 _("remote_write_bytes_aux: bad packet format"));
8961 return TARGET_XFER_EOF
;
8963 payload_capacity_bytes
= get_memory_write_packet_size ();
8965 /* The packet buffer will be large enough for the payload;
8966 get_memory_packet_size ensures this. */
8969 /* Compute the size of the actual payload by subtracting out the
8970 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
8972 payload_capacity_bytes
-= strlen ("$,:#NN");
8974 /* The comma won't be used. */
8975 payload_capacity_bytes
+= 1;
8976 payload_capacity_bytes
-= strlen (header
);
8977 payload_capacity_bytes
-= hexnumlen (memaddr
);
8979 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
8981 strcat (rs
->buf
.data (), header
);
8982 p
= rs
->buf
.data () + strlen (header
);
8984 /* Compute a best guess of the number of bytes actually transfered. */
8985 if (packet_format
== 'X')
8987 /* Best guess at number of bytes that will fit. */
8988 todo_units
= std::min (len_units
,
8989 (ULONGEST
) payload_capacity_bytes
/ unit_size
);
8991 payload_capacity_bytes
-= hexnumlen (todo_units
);
8992 todo_units
= std::min (todo_units
, payload_capacity_bytes
/ unit_size
);
8996 /* Number of bytes that will fit. */
8998 = std::min (len_units
,
8999 (ULONGEST
) (payload_capacity_bytes
/ unit_size
) / 2);
9001 payload_capacity_bytes
-= hexnumlen (todo_units
);
9002 todo_units
= std::min (todo_units
,
9003 (payload_capacity_bytes
/ unit_size
) / 2);
9006 if (todo_units
<= 0)
9007 internal_error (__FILE__
, __LINE__
,
9008 _("minimum packet size too small to write data"));
9010 /* If we already need another packet, then try to align the end
9011 of this packet to a useful boundary. */
9012 if (todo_units
> 2 * REMOTE_ALIGN_WRITES
&& todo_units
< len_units
)
9013 todo_units
= align_for_efficient_write (todo_units
, memaddr
);
9015 /* Append "<memaddr>". */
9016 memaddr
= remote_address_masked (memaddr
);
9017 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
9024 /* Append the length and retain its location and size. It may need to be
9025 adjusted once the packet body has been created. */
9027 plenlen
= hexnumstr (p
, (ULONGEST
) todo_units
);
9035 /* Append the packet body. */
9036 if (packet_format
== 'X')
9038 /* Binary mode. Send target system values byte by byte, in
9039 increasing byte addresses. Only escape certain critical
9041 payload_length_bytes
=
9042 remote_escape_output (myaddr
, todo_units
, unit_size
, (gdb_byte
*) p
,
9043 &units_written
, payload_capacity_bytes
);
9045 /* If not all TODO units fit, then we'll need another packet. Make
9046 a second try to keep the end of the packet aligned. Don't do
9047 this if the packet is tiny. */
9048 if (units_written
< todo_units
&& units_written
> 2 * REMOTE_ALIGN_WRITES
)
9052 new_todo_units
= align_for_efficient_write (units_written
, memaddr
);
9054 if (new_todo_units
!= units_written
)
9055 payload_length_bytes
=
9056 remote_escape_output (myaddr
, new_todo_units
, unit_size
,
9057 (gdb_byte
*) p
, &units_written
,
9058 payload_capacity_bytes
);
9061 p
+= payload_length_bytes
;
9062 if (use_length
&& units_written
< todo_units
)
9064 /* Escape chars have filled up the buffer prematurely,
9065 and we have actually sent fewer units than planned.
9066 Fix-up the length field of the packet. Use the same
9067 number of characters as before. */
9068 plen
+= hexnumnstr (plen
, (ULONGEST
) units_written
,
9070 *plen
= ':'; /* overwrite \0 from hexnumnstr() */
9075 /* Normal mode: Send target system values byte by byte, in
9076 increasing byte addresses. Each byte is encoded as a two hex
9078 p
+= 2 * bin2hex (myaddr
, p
, todo_units
* unit_size
);
9079 units_written
= todo_units
;
9082 putpkt_binary (rs
->buf
.data (), (int) (p
- rs
->buf
.data ()));
9083 getpkt (&rs
->buf
, 0);
9085 if (rs
->buf
[0] == 'E')
9086 return TARGET_XFER_E_IO
;
9088 /* Return UNITS_WRITTEN, not TODO_UNITS, in case escape chars caused us to
9089 send fewer units than we'd planned. */
9090 *xfered_len_units
= (ULONGEST
) units_written
;
9091 return (*xfered_len_units
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
9094 /* Write memory data directly to the remote machine.
9095 This does not inform the data cache; the data cache uses this.
9096 MEMADDR is the address in the remote memory space.
9097 MYADDR is the address of the buffer in our space.
9098 LEN is the number of bytes.
9100 Return the transferred status, error or OK (an
9101 'enum target_xfer_status' value). Save the number of bytes
9102 transferred in *XFERED_LEN. Only transfer a single packet. */
9105 remote_target::remote_write_bytes (CORE_ADDR memaddr
, const gdb_byte
*myaddr
,
9106 ULONGEST len
, int unit_size
,
9107 ULONGEST
*xfered_len
)
9109 const char *packet_format
= NULL
;
9111 /* Check whether the target supports binary download. */
9112 check_binary_download (memaddr
);
9114 switch (packet_support (PACKET_X
))
9117 packet_format
= "X";
9119 case PACKET_DISABLE
:
9120 packet_format
= "M";
9122 case PACKET_SUPPORT_UNKNOWN
:
9123 internal_error (__FILE__
, __LINE__
,
9124 _("remote_write_bytes: bad internal state"));
9126 internal_error (__FILE__
, __LINE__
, _("bad switch"));
9129 return remote_write_bytes_aux (packet_format
,
9130 memaddr
, myaddr
, len
, unit_size
, xfered_len
,
9131 packet_format
[0], 1);
9134 /* Read memory data directly from the remote machine.
9135 This does not use the data cache; the data cache uses this.
9136 MEMADDR is the address in the remote memory space.
9137 MYADDR is the address of the buffer in our space.
9138 LEN_UNITS is the number of addressable memory units to read..
9139 UNIT_SIZE is the length in bytes of an addressable unit.
9141 Return the transferred status, error or OK (an
9142 'enum target_xfer_status' value). Save the number of bytes
9143 transferred in *XFERED_LEN_UNITS.
9145 See the comment of remote_write_bytes_aux for an example of
9146 memory read/write exchange between gdb and the stub. */
9149 remote_target::remote_read_bytes_1 (CORE_ADDR memaddr
, gdb_byte
*myaddr
,
9151 int unit_size
, ULONGEST
*xfered_len_units
)
9153 struct remote_state
*rs
= get_remote_state ();
9154 int buf_size_bytes
; /* Max size of packet output buffer. */
9159 buf_size_bytes
= get_memory_read_packet_size ();
9160 /* The packet buffer will be large enough for the payload;
9161 get_memory_packet_size ensures this. */
9163 /* Number of units that will fit. */
9164 todo_units
= std::min (len_units
,
9165 (ULONGEST
) (buf_size_bytes
/ unit_size
) / 2);
9167 /* Construct "m"<memaddr>","<len>". */
9168 memaddr
= remote_address_masked (memaddr
);
9169 p
= rs
->buf
.data ();
9171 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
9173 p
+= hexnumstr (p
, (ULONGEST
) todo_units
);
9176 getpkt (&rs
->buf
, 0);
9177 if (rs
->buf
[0] == 'E'
9178 && isxdigit (rs
->buf
[1]) && isxdigit (rs
->buf
[2])
9179 && rs
->buf
[3] == '\0')
9180 return TARGET_XFER_E_IO
;
9181 /* Reply describes memory byte by byte, each byte encoded as two hex
9183 p
= rs
->buf
.data ();
9184 decoded_bytes
= hex2bin (p
, myaddr
, todo_units
* unit_size
);
9185 /* Return what we have. Let higher layers handle partial reads. */
9186 *xfered_len_units
= (ULONGEST
) (decoded_bytes
/ unit_size
);
9187 return (*xfered_len_units
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
9190 /* Using the set of read-only target sections of remote, read live
9193 For interface/parameters/return description see target.h,
9197 remote_target::remote_xfer_live_readonly_partial (gdb_byte
*readbuf
,
9201 ULONGEST
*xfered_len
)
9203 const struct target_section
*secp
;
9205 secp
= target_section_by_addr (this, memaddr
);
9207 && (bfd_section_flags (secp
->the_bfd_section
) & SEC_READONLY
))
9209 ULONGEST memend
= memaddr
+ len
;
9211 const target_section_table
*table
= target_get_section_table (this);
9212 for (const target_section
&p
: *table
)
9214 if (memaddr
>= p
.addr
)
9216 if (memend
<= p
.endaddr
)
9218 /* Entire transfer is within this section. */
9219 return remote_read_bytes_1 (memaddr
, readbuf
, len
, unit_size
,
9222 else if (memaddr
>= p
.endaddr
)
9224 /* This section ends before the transfer starts. */
9229 /* This section overlaps the transfer. Just do half. */
9230 len
= p
.endaddr
- memaddr
;
9231 return remote_read_bytes_1 (memaddr
, readbuf
, len
, unit_size
,
9238 return TARGET_XFER_EOF
;
9241 /* Similar to remote_read_bytes_1, but it reads from the remote stub
9242 first if the requested memory is unavailable in traceframe.
9243 Otherwise, fall back to remote_read_bytes_1. */
9246 remote_target::remote_read_bytes (CORE_ADDR memaddr
,
9247 gdb_byte
*myaddr
, ULONGEST len
, int unit_size
,
9248 ULONGEST
*xfered_len
)
9251 return TARGET_XFER_EOF
;
9253 if (get_traceframe_number () != -1)
9255 std::vector
<mem_range
> available
;
9257 /* If we fail to get the set of available memory, then the
9258 target does not support querying traceframe info, and so we
9259 attempt reading from the traceframe anyway (assuming the
9260 target implements the old QTro packet then). */
9261 if (traceframe_available_memory (&available
, memaddr
, len
))
9263 if (available
.empty () || available
[0].start
!= memaddr
)
9265 enum target_xfer_status res
;
9267 /* Don't read into the traceframe's available
9269 if (!available
.empty ())
9271 LONGEST oldlen
= len
;
9273 len
= available
[0].start
- memaddr
;
9274 gdb_assert (len
<= oldlen
);
9277 /* This goes through the topmost target again. */
9278 res
= remote_xfer_live_readonly_partial (myaddr
, memaddr
,
9279 len
, unit_size
, xfered_len
);
9280 if (res
== TARGET_XFER_OK
)
9281 return TARGET_XFER_OK
;
9284 /* No use trying further, we know some memory starting
9285 at MEMADDR isn't available. */
9287 return (*xfered_len
!= 0) ?
9288 TARGET_XFER_UNAVAILABLE
: TARGET_XFER_EOF
;
9292 /* Don't try to read more than how much is available, in
9293 case the target implements the deprecated QTro packet to
9294 cater for older GDBs (the target's knowledge of read-only
9295 sections may be outdated by now). */
9296 len
= available
[0].length
;
9300 return remote_read_bytes_1 (memaddr
, myaddr
, len
, unit_size
, xfered_len
);
9305 /* Sends a packet with content determined by the printf format string
9306 FORMAT and the remaining arguments, then gets the reply. Returns
9307 whether the packet was a success, a failure, or unknown. */
9310 remote_target::remote_send_printf (const char *format
, ...)
9312 struct remote_state
*rs
= get_remote_state ();
9313 int max_size
= get_remote_packet_size ();
9316 va_start (ap
, format
);
9319 int size
= vsnprintf (rs
->buf
.data (), max_size
, format
, ap
);
9323 if (size
>= max_size
)
9324 internal_error (__FILE__
, __LINE__
, _("Too long remote packet."));
9326 if (putpkt (rs
->buf
) < 0)
9327 error (_("Communication problem with target."));
9330 getpkt (&rs
->buf
, 0);
9332 return packet_check_result (rs
->buf
);
9335 /* Flash writing can take quite some time. We'll set
9336 effectively infinite timeout for flash operations.
9337 In future, we'll need to decide on a better approach. */
9338 static const int remote_flash_timeout
= 1000;
9341 remote_target::flash_erase (ULONGEST address
, LONGEST length
)
9343 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
9344 enum packet_result ret
;
9345 scoped_restore restore_timeout
9346 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9348 ret
= remote_send_printf ("vFlashErase:%s,%s",
9349 phex (address
, addr_size
),
9353 case PACKET_UNKNOWN
:
9354 error (_("Remote target does not support flash erase"));
9356 error (_("Error erasing flash with vFlashErase packet"));
9363 remote_target::remote_flash_write (ULONGEST address
,
9364 ULONGEST length
, ULONGEST
*xfered_len
,
9365 const gdb_byte
*data
)
9367 scoped_restore restore_timeout
9368 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9369 return remote_write_bytes_aux ("vFlashWrite:", address
, data
, length
, 1,
9374 remote_target::flash_done ()
9378 scoped_restore restore_timeout
9379 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9381 ret
= remote_send_printf ("vFlashDone");
9385 case PACKET_UNKNOWN
:
9386 error (_("Remote target does not support vFlashDone"));
9388 error (_("Error finishing flash operation"));
9395 remote_target::files_info ()
9397 puts_filtered ("Debugging a target over a serial line.\n");
9400 /* Stuff for dealing with the packets which are part of this protocol.
9401 See comment at top of file for details. */
9403 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
9404 error to higher layers. Called when a serial error is detected.
9405 The exception message is STRING, followed by a colon and a blank,
9406 the system error message for errno at function entry and final dot
9407 for output compatibility with throw_perror_with_name. */
9410 unpush_and_perror (remote_target
*target
, const char *string
)
9412 int saved_errno
= errno
;
9414 remote_unpush_target (target
);
9415 throw_error (TARGET_CLOSE_ERROR
, "%s: %s.", string
,
9416 safe_strerror (saved_errno
));
9419 /* Read a single character from the remote end. The current quit
9420 handler is overridden to avoid quitting in the middle of packet
9421 sequence, as that would break communication with the remote server.
9422 See remote_serial_quit_handler for more detail. */
9425 remote_target::readchar (int timeout
)
9428 struct remote_state
*rs
= get_remote_state ();
9431 scoped_restore restore_quit_target
9432 = make_scoped_restore (&curr_quit_handler_target
, this);
9433 scoped_restore restore_quit
9434 = make_scoped_restore (&quit_handler
, ::remote_serial_quit_handler
);
9436 rs
->got_ctrlc_during_io
= 0;
9438 ch
= serial_readchar (rs
->remote_desc
, timeout
);
9440 if (rs
->got_ctrlc_during_io
)
9447 switch ((enum serial_rc
) ch
)
9450 remote_unpush_target (this);
9451 throw_error (TARGET_CLOSE_ERROR
, _("Remote connection closed"));
9454 unpush_and_perror (this, _("Remote communication error. "
9455 "Target disconnected."));
9457 case SERIAL_TIMEOUT
:
9463 /* Wrapper for serial_write that closes the target and throws if
9464 writing fails. The current quit handler is overridden to avoid
9465 quitting in the middle of packet sequence, as that would break
9466 communication with the remote server. See
9467 remote_serial_quit_handler for more detail. */
9470 remote_target::remote_serial_write (const char *str
, int len
)
9472 struct remote_state
*rs
= get_remote_state ();
9474 scoped_restore restore_quit_target
9475 = make_scoped_restore (&curr_quit_handler_target
, this);
9476 scoped_restore restore_quit
9477 = make_scoped_restore (&quit_handler
, ::remote_serial_quit_handler
);
9479 rs
->got_ctrlc_during_io
= 0;
9481 if (serial_write (rs
->remote_desc
, str
, len
))
9483 unpush_and_perror (this, _("Remote communication error. "
9484 "Target disconnected."));
9487 if (rs
->got_ctrlc_during_io
)
9491 /* Return a string representing an escaped version of BUF, of len N.
9492 E.g. \n is converted to \\n, \t to \\t, etc. */
9495 escape_buffer (const char *buf
, int n
)
9499 stb
.putstrn (buf
, n
, '\\');
9500 return std::move (stb
.string ());
9504 remote_target::putpkt (const char *buf
)
9506 return putpkt_binary (buf
, strlen (buf
));
9509 /* Wrapper around remote_target::putpkt to avoid exporting
9513 putpkt (remote_target
*remote
, const char *buf
)
9515 return remote
->putpkt (buf
);
9518 /* Send a packet to the remote machine, with error checking. The data
9519 of the packet is in BUF. The string in BUF can be at most
9520 get_remote_packet_size () - 5 to account for the $, # and checksum,
9521 and for a possible /0 if we are debugging (remote_debug) and want
9522 to print the sent packet as a string. */
9525 remote_target::putpkt_binary (const char *buf
, int cnt
)
9527 struct remote_state
*rs
= get_remote_state ();
9529 unsigned char csum
= 0;
9530 gdb::def_vector
<char> data (cnt
+ 6);
9531 char *buf2
= data
.data ();
9537 /* Catch cases like trying to read memory or listing threads while
9538 we're waiting for a stop reply. The remote server wouldn't be
9539 ready to handle this request, so we'd hang and timeout. We don't
9540 have to worry about this in synchronous mode, because in that
9541 case it's not possible to issue a command while the target is
9542 running. This is not a problem in non-stop mode, because in that
9543 case, the stub is always ready to process serial input. */
9544 if (!target_is_non_stop_p ()
9545 && target_is_async_p ()
9546 && rs
->waiting_for_stop_reply
)
9548 error (_("Cannot execute this command while the target is running.\n"
9549 "Use the \"interrupt\" command to stop the target\n"
9550 "and then try again."));
9553 /* We're sending out a new packet. Make sure we don't look at a
9554 stale cached response. */
9555 rs
->cached_wait_status
= 0;
9557 /* Copy the packet into buffer BUF2, encapsulating it
9558 and giving it a checksum. */
9563 for (i
= 0; i
< cnt
; i
++)
9569 *p
++ = tohex ((csum
>> 4) & 0xf);
9570 *p
++ = tohex (csum
& 0xf);
9572 /* Send it over and over until we get a positive ack. */
9580 int len
= (int) (p
- buf2
);
9583 if (remote_packet_max_chars
< 0)
9586 max_chars
= remote_packet_max_chars
;
9589 = escape_buffer (buf2
, std::min (len
, max_chars
));
9591 if (len
> max_chars
)
9592 remote_debug_printf_nofunc
9593 ("Sending packet: %s [%d bytes omitted]", str
.c_str (),
9596 remote_debug_printf_nofunc ("Sending packet: %s", str
.c_str ());
9598 remote_serial_write (buf2
, p
- buf2
);
9600 /* If this is a no acks version of the remote protocol, send the
9601 packet and move on. */
9605 /* Read until either a timeout occurs (-2) or '+' is read.
9606 Handle any notification that arrives in the mean time. */
9609 ch
= readchar (remote_timeout
);
9614 remote_debug_printf_nofunc ("Received Ack");
9617 remote_debug_printf_nofunc ("Received Nak");
9619 case SERIAL_TIMEOUT
:
9623 break; /* Retransmit buffer. */
9626 remote_debug_printf ("Packet instead of Ack, ignoring it");
9627 /* It's probably an old response sent because an ACK
9628 was lost. Gobble up the packet and ack it so it
9629 doesn't get retransmitted when we resend this
9632 remote_serial_write ("+", 1);
9633 continue; /* Now, go look for +. */
9640 /* If we got a notification, handle it, and go back to looking
9642 /* We've found the start of a notification. Now
9643 collect the data. */
9644 val
= read_frame (&rs
->buf
);
9647 remote_debug_printf_nofunc
9648 (" Notification received: %s",
9649 escape_buffer (rs
->buf
.data (), val
).c_str ());
9651 handle_notification (rs
->notif_state
, rs
->buf
.data ());
9652 /* We're in sync now, rewait for the ack. */
9656 remote_debug_printf_nofunc ("Junk: %c%s", ch
& 0177,
9662 remote_debug_printf_nofunc ("Junk: %c%s", ch
& 0177,
9666 break; /* Here to retransmit. */
9670 /* This is wrong. If doing a long backtrace, the user should be
9671 able to get out next time we call QUIT, without anything as
9672 violent as interrupt_query. If we want to provide a way out of
9673 here without getting to the next QUIT, it should be based on
9674 hitting ^C twice as in remote_wait. */
9686 /* Come here after finding the start of a frame when we expected an
9687 ack. Do our best to discard the rest of this packet. */
9690 remote_target::skip_frame ()
9696 c
= readchar (remote_timeout
);
9699 case SERIAL_TIMEOUT
:
9700 /* Nothing we can do. */
9703 /* Discard the two bytes of checksum and stop. */
9704 c
= readchar (remote_timeout
);
9706 c
= readchar (remote_timeout
);
9709 case '*': /* Run length encoding. */
9710 /* Discard the repeat count. */
9711 c
= readchar (remote_timeout
);
9716 /* A regular character. */
9722 /* Come here after finding the start of the frame. Collect the rest
9723 into *BUF, verifying the checksum, length, and handling run-length
9724 compression. NUL terminate the buffer. If there is not enough room,
9727 Returns -1 on error, number of characters in buffer (ignoring the
9728 trailing NULL) on success. (could be extended to return one of the
9729 SERIAL status indications). */
9732 remote_target::read_frame (gdb::char_vector
*buf_p
)
9737 char *buf
= buf_p
->data ();
9738 struct remote_state
*rs
= get_remote_state ();
9745 c
= readchar (remote_timeout
);
9748 case SERIAL_TIMEOUT
:
9749 remote_debug_printf ("Timeout in mid-packet, retrying");
9753 remote_debug_printf ("Saw new packet start in middle of old one");
9754 return -1; /* Start a new packet, count retries. */
9758 unsigned char pktcsum
;
9764 check_0
= readchar (remote_timeout
);
9766 check_1
= readchar (remote_timeout
);
9768 if (check_0
== SERIAL_TIMEOUT
|| check_1
== SERIAL_TIMEOUT
)
9770 remote_debug_printf ("Timeout in checksum, retrying");
9773 else if (check_0
< 0 || check_1
< 0)
9775 remote_debug_printf ("Communication error in checksum");
9779 /* Don't recompute the checksum; with no ack packets we
9780 don't have any way to indicate a packet retransmission
9785 pktcsum
= (fromhex (check_0
) << 4) | fromhex (check_1
);
9786 if (csum
== pktcsum
)
9790 ("Bad checksum, sentsum=0x%x, csum=0x%x, buf=%s",
9791 pktcsum
, csum
, escape_buffer (buf
, bc
).c_str ());
9793 /* Number of characters in buffer ignoring trailing
9797 case '*': /* Run length encoding. */
9802 c
= readchar (remote_timeout
);
9804 repeat
= c
- ' ' + 3; /* Compute repeat count. */
9806 /* The character before ``*'' is repeated. */
9808 if (repeat
> 0 && repeat
<= 255 && bc
> 0)
9810 if (bc
+ repeat
- 1 >= buf_p
->size () - 1)
9812 /* Make some more room in the buffer. */
9813 buf_p
->resize (buf_p
->size () + repeat
);
9814 buf
= buf_p
->data ();
9817 memset (&buf
[bc
], buf
[bc
- 1], repeat
);
9823 printf_filtered (_("Invalid run length encoding: %s\n"), buf
);
9827 if (bc
>= buf_p
->size () - 1)
9829 /* Make some more room in the buffer. */
9830 buf_p
->resize (buf_p
->size () * 2);
9831 buf
= buf_p
->data ();
9841 /* Set this to the maximum number of seconds to wait instead of waiting forever
9842 in target_wait(). If this timer times out, then it generates an error and
9843 the command is aborted. This replaces most of the need for timeouts in the
9844 GDB test suite, and makes it possible to distinguish between a hung target
9845 and one with slow communications. */
9847 static int watchdog
= 0;
9849 show_watchdog (struct ui_file
*file
, int from_tty
,
9850 struct cmd_list_element
*c
, const char *value
)
9852 fprintf_filtered (file
, _("Watchdog timer is %s.\n"), value
);
9855 /* Read a packet from the remote machine, with error checking, and
9856 store it in *BUF. Resize *BUF if necessary to hold the result. If
9857 FOREVER, wait forever rather than timing out; this is used (in
9858 synchronous mode) to wait for a target that is is executing user
9860 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
9861 don't have to change all the calls to getpkt to deal with the
9862 return value, because at the moment I don't know what the right
9863 thing to do it for those. */
9866 remote_target::getpkt (gdb::char_vector
*buf
, int forever
)
9868 getpkt_sane (buf
, forever
);
9872 /* Read a packet from the remote machine, with error checking, and
9873 store it in *BUF. Resize *BUF if necessary to hold the result. If
9874 FOREVER, wait forever rather than timing out; this is used (in
9875 synchronous mode) to wait for a target that is is executing user
9876 code to stop. If FOREVER == 0, this function is allowed to time
9877 out gracefully and return an indication of this to the caller.
9878 Otherwise return the number of bytes read. If EXPECTING_NOTIF,
9879 consider receiving a notification enough reason to return to the
9880 caller. *IS_NOTIF is an output boolean that indicates whether *BUF
9881 holds a notification or not (a regular packet). */
9884 remote_target::getpkt_or_notif_sane_1 (gdb::char_vector
*buf
,
9885 int forever
, int expecting_notif
,
9888 struct remote_state
*rs
= get_remote_state ();
9894 /* We're reading a new response. Make sure we don't look at a
9895 previously cached response. */
9896 rs
->cached_wait_status
= 0;
9898 strcpy (buf
->data (), "timeout");
9901 timeout
= watchdog
> 0 ? watchdog
: -1;
9902 else if (expecting_notif
)
9903 timeout
= 0; /* There should already be a char in the buffer. If
9906 timeout
= remote_timeout
;
9910 /* Process any number of notifications, and then return when
9914 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
9916 for (tries
= 1; tries
<= MAX_TRIES
; tries
++)
9918 /* This can loop forever if the remote side sends us
9919 characters continuously, but if it pauses, we'll get
9920 SERIAL_TIMEOUT from readchar because of timeout. Then
9921 we'll count that as a retry.
9923 Note that even when forever is set, we will only wait
9924 forever prior to the start of a packet. After that, we
9925 expect characters to arrive at a brisk pace. They should
9926 show up within remote_timeout intervals. */
9928 c
= readchar (timeout
);
9929 while (c
!= SERIAL_TIMEOUT
&& c
!= '$' && c
!= '%');
9931 if (c
== SERIAL_TIMEOUT
)
9933 if (expecting_notif
)
9934 return -1; /* Don't complain, it's normal to not get
9935 anything in this case. */
9937 if (forever
) /* Watchdog went off? Kill the target. */
9939 remote_unpush_target (this);
9940 throw_error (TARGET_CLOSE_ERROR
,
9941 _("Watchdog timeout has expired. "
9942 "Target detached."));
9945 remote_debug_printf ("Timed out.");
9949 /* We've found the start of a packet or notification.
9950 Now collect the data. */
9951 val
= read_frame (buf
);
9956 remote_serial_write ("-", 1);
9959 if (tries
> MAX_TRIES
)
9961 /* We have tried hard enough, and just can't receive the
9962 packet/notification. Give up. */
9963 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
9965 /* Skip the ack char if we're in no-ack mode. */
9966 if (!rs
->noack_mode
)
9967 remote_serial_write ("+", 1);
9971 /* If we got an ordinary packet, return that to our caller. */
9978 if (remote_packet_max_chars
< 0)
9981 max_chars
= remote_packet_max_chars
;
9984 = escape_buffer (buf
->data (),
9985 std::min (val
, max_chars
));
9987 if (val
> max_chars
)
9988 remote_debug_printf_nofunc
9989 ("Packet received: %s [%d bytes omitted]", str
.c_str (),
9992 remote_debug_printf_nofunc ("Packet received: %s",
9996 /* Skip the ack char if we're in no-ack mode. */
9997 if (!rs
->noack_mode
)
9998 remote_serial_write ("+", 1);
9999 if (is_notif
!= NULL
)
10004 /* If we got a notification, handle it, and go back to looking
10008 gdb_assert (c
== '%');
10010 remote_debug_printf_nofunc
10011 (" Notification received: %s",
10012 escape_buffer (buf
->data (), val
).c_str ());
10014 if (is_notif
!= NULL
)
10017 handle_notification (rs
->notif_state
, buf
->data ());
10019 /* Notifications require no acknowledgement. */
10021 if (expecting_notif
)
10028 remote_target::getpkt_sane (gdb::char_vector
*buf
, int forever
)
10030 return getpkt_or_notif_sane_1 (buf
, forever
, 0, NULL
);
10034 remote_target::getpkt_or_notif_sane (gdb::char_vector
*buf
, int forever
,
10037 return getpkt_or_notif_sane_1 (buf
, forever
, 1, is_notif
);
10040 /* Kill any new fork children of process PID that haven't been
10041 processed by follow_fork. */
10044 remote_target::kill_new_fork_children (int pid
)
10046 remote_state
*rs
= get_remote_state ();
10047 struct notif_client
*notif
= ¬if_client_stop
;
10049 /* Kill the fork child threads of any threads in process PID
10050 that are stopped at a fork event. */
10051 for (thread_info
*thread
: all_non_exited_threads (this))
10053 const target_waitstatus
&ws
= thread
->pending_follow
;
10055 if (is_pending_fork_parent (ws
, pid
, thread
->ptid
))
10057 int child_pid
= ws
.child_ptid ().pid ();
10060 res
= remote_vkill (child_pid
);
10062 error (_("Can't kill fork child process %d"), child_pid
);
10066 /* Check for any pending fork events (not reported or processed yet)
10067 in process PID and kill those fork child threads as well. */
10068 remote_notif_get_pending_events (notif
);
10069 for (auto &event
: rs
->stop_reply_queue
)
10070 if (is_pending_fork_parent (event
->ws
, pid
, event
->ptid
))
10072 int child_pid
= event
->ws
.child_ptid ().pid ();
10075 res
= remote_vkill (child_pid
);
10077 error (_("Can't kill fork child process %d"), child_pid
);
10082 /* Target hook to kill the current inferior. */
10085 remote_target::kill ()
10088 int pid
= inferior_ptid
.pid ();
10089 struct remote_state
*rs
= get_remote_state ();
10091 if (packet_support (PACKET_vKill
) != PACKET_DISABLE
)
10093 /* If we're stopped while forking and we haven't followed yet,
10094 kill the child task. We need to do this before killing the
10095 parent task because if this is a vfork then the parent will
10097 kill_new_fork_children (pid
);
10099 res
= remote_vkill (pid
);
10102 target_mourn_inferior (inferior_ptid
);
10107 /* If we are in 'target remote' mode and we are killing the only
10108 inferior, then we will tell gdbserver to exit and unpush the
10110 if (res
== -1 && !remote_multi_process_p (rs
)
10111 && number_of_live_inferiors (this) == 1)
10115 /* We've killed the remote end, we get to mourn it. If we are
10116 not in extended mode, mourning the inferior also unpushes
10117 remote_ops from the target stack, which closes the remote
10119 target_mourn_inferior (inferior_ptid
);
10124 error (_("Can't kill process"));
10127 /* Send a kill request to the target using the 'vKill' packet. */
10130 remote_target::remote_vkill (int pid
)
10132 if (packet_support (PACKET_vKill
) == PACKET_DISABLE
)
10135 remote_state
*rs
= get_remote_state ();
10137 /* Tell the remote target to detach. */
10138 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "vKill;%x", pid
);
10140 getpkt (&rs
->buf
, 0);
10142 switch (packet_ok (rs
->buf
,
10143 &remote_protocol_packets
[PACKET_vKill
]))
10149 case PACKET_UNKNOWN
:
10152 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
10156 /* Send a kill request to the target using the 'k' packet. */
10159 remote_target::remote_kill_k ()
10161 /* Catch errors so the user can quit from gdb even when we
10162 aren't on speaking terms with the remote system. */
10167 catch (const gdb_exception_error
&ex
)
10169 if (ex
.error
== TARGET_CLOSE_ERROR
)
10171 /* If we got an (EOF) error that caused the target
10172 to go away, then we're done, that's what we wanted.
10173 "k" is susceptible to cause a premature EOF, given
10174 that the remote server isn't actually required to
10175 reply to "k", and it can happen that it doesn't
10176 even get to reply ACK to the "k". */
10180 /* Otherwise, something went wrong. We didn't actually kill
10181 the target. Just propagate the exception, and let the
10182 user or higher layers decide what to do. */
10188 remote_target::mourn_inferior ()
10190 struct remote_state
*rs
= get_remote_state ();
10192 /* We're no longer interested in notification events of an inferior
10193 that exited or was killed/detached. */
10194 discard_pending_stop_replies (current_inferior ());
10196 /* In 'target remote' mode with one inferior, we close the connection. */
10197 if (!rs
->extended
&& number_of_live_inferiors (this) <= 1)
10199 remote_unpush_target (this);
10203 /* In case we got here due to an error, but we're going to stay
10205 rs
->waiting_for_stop_reply
= 0;
10207 /* If the current general thread belonged to the process we just
10208 detached from or has exited, the remote side current general
10209 thread becomes undefined. Considering a case like this:
10211 - We just got here due to a detach.
10212 - The process that we're detaching from happens to immediately
10213 report a global breakpoint being hit in non-stop mode, in the
10214 same thread we had selected before.
10215 - GDB attaches to this process again.
10216 - This event happens to be the next event we handle.
10218 GDB would consider that the current general thread didn't need to
10219 be set on the stub side (with Hg), since for all it knew,
10220 GENERAL_THREAD hadn't changed.
10222 Notice that although in all-stop mode, the remote server always
10223 sets the current thread to the thread reporting the stop event,
10224 that doesn't happen in non-stop mode; in non-stop, the stub *must
10225 not* change the current thread when reporting a breakpoint hit,
10226 due to the decoupling of event reporting and event handling.
10228 To keep things simple, we always invalidate our notion of the
10230 record_currthread (rs
, minus_one_ptid
);
10232 /* Call common code to mark the inferior as not running. */
10233 generic_mourn_inferior ();
10237 extended_remote_target::supports_disable_randomization ()
10239 return packet_support (PACKET_QDisableRandomization
) == PACKET_ENABLE
;
10243 remote_target::extended_remote_disable_randomization (int val
)
10245 struct remote_state
*rs
= get_remote_state ();
10248 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10249 "QDisableRandomization:%x", val
);
10251 reply
= remote_get_noisy_reply ();
10252 if (*reply
== '\0')
10253 error (_("Target does not support QDisableRandomization."));
10254 if (strcmp (reply
, "OK") != 0)
10255 error (_("Bogus QDisableRandomization reply from target: %s"), reply
);
10259 remote_target::extended_remote_run (const std::string
&args
)
10261 struct remote_state
*rs
= get_remote_state ();
10263 const char *remote_exec_file
= get_remote_exec_file ();
10265 /* If the user has disabled vRun support, or we have detected that
10266 support is not available, do not try it. */
10267 if (packet_support (PACKET_vRun
) == PACKET_DISABLE
)
10270 strcpy (rs
->buf
.data (), "vRun;");
10271 len
= strlen (rs
->buf
.data ());
10273 if (strlen (remote_exec_file
) * 2 + len
>= get_remote_packet_size ())
10274 error (_("Remote file name too long for run packet"));
10275 len
+= 2 * bin2hex ((gdb_byte
*) remote_exec_file
, rs
->buf
.data () + len
,
10276 strlen (remote_exec_file
));
10278 if (!args
.empty ())
10282 gdb_argv
argv (args
.c_str ());
10283 for (i
= 0; argv
[i
] != NULL
; i
++)
10285 if (strlen (argv
[i
]) * 2 + 1 + len
>= get_remote_packet_size ())
10286 error (_("Argument list too long for run packet"));
10287 rs
->buf
[len
++] = ';';
10288 len
+= 2 * bin2hex ((gdb_byte
*) argv
[i
], rs
->buf
.data () + len
,
10293 rs
->buf
[len
++] = '\0';
10296 getpkt (&rs
->buf
, 0);
10298 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vRun
]))
10301 /* We have a wait response. All is well. */
10303 case PACKET_UNKNOWN
:
10306 if (remote_exec_file
[0] == '\0')
10307 error (_("Running the default executable on the remote target failed; "
10308 "try \"set remote exec-file\"?"));
10310 error (_("Running \"%s\" on the remote target failed"),
10313 gdb_assert_not_reached ("bad switch");
10317 /* Helper function to send set/unset environment packets. ACTION is
10318 either "set" or "unset". PACKET is either "QEnvironmentHexEncoded"
10319 or "QEnvironmentUnsetVariable". VALUE is the variable to be
10323 remote_target::send_environment_packet (const char *action
,
10324 const char *packet
,
10327 remote_state
*rs
= get_remote_state ();
10329 /* Convert the environment variable to an hex string, which
10330 is the best format to be transmitted over the wire. */
10331 std::string encoded_value
= bin2hex ((const gdb_byte
*) value
,
10334 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10335 "%s:%s", packet
, encoded_value
.c_str ());
10338 getpkt (&rs
->buf
, 0);
10339 if (strcmp (rs
->buf
.data (), "OK") != 0)
10340 warning (_("Unable to %s environment variable '%s' on remote."),
10344 /* Helper function to handle the QEnvironment* packets. */
10347 remote_target::extended_remote_environment_support ()
10349 remote_state
*rs
= get_remote_state ();
10351 if (packet_support (PACKET_QEnvironmentReset
) != PACKET_DISABLE
)
10353 putpkt ("QEnvironmentReset");
10354 getpkt (&rs
->buf
, 0);
10355 if (strcmp (rs
->buf
.data (), "OK") != 0)
10356 warning (_("Unable to reset environment on remote."));
10359 gdb_environ
*e
= ¤t_inferior ()->environment
;
10361 if (packet_support (PACKET_QEnvironmentHexEncoded
) != PACKET_DISABLE
)
10362 for (const std::string
&el
: e
->user_set_env ())
10363 send_environment_packet ("set", "QEnvironmentHexEncoded",
10366 if (packet_support (PACKET_QEnvironmentUnset
) != PACKET_DISABLE
)
10367 for (const std::string
&el
: e
->user_unset_env ())
10368 send_environment_packet ("unset", "QEnvironmentUnset", el
.c_str ());
10371 /* Helper function to set the current working directory for the
10372 inferior in the remote target. */
10375 remote_target::extended_remote_set_inferior_cwd ()
10377 if (packet_support (PACKET_QSetWorkingDir
) != PACKET_DISABLE
)
10379 const std::string
&inferior_cwd
= current_inferior ()->cwd ();
10380 remote_state
*rs
= get_remote_state ();
10382 if (!inferior_cwd
.empty ())
10384 std::string hexpath
10385 = bin2hex ((const gdb_byte
*) inferior_cwd
.data (),
10386 inferior_cwd
.size ());
10388 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10389 "QSetWorkingDir:%s", hexpath
.c_str ());
10393 /* An empty inferior_cwd means that the user wants us to
10394 reset the remote server's inferior's cwd. */
10395 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10396 "QSetWorkingDir:");
10400 getpkt (&rs
->buf
, 0);
10401 if (packet_ok (rs
->buf
,
10402 &remote_protocol_packets
[PACKET_QSetWorkingDir
])
10405 Remote replied unexpectedly while setting the inferior's working\n\
10412 /* In the extended protocol we want to be able to do things like
10413 "run" and have them basically work as expected. So we need
10414 a special create_inferior function. We support changing the
10415 executable file and the command line arguments, but not the
10419 extended_remote_target::create_inferior (const char *exec_file
,
10420 const std::string
&args
,
10421 char **env
, int from_tty
)
10425 struct remote_state
*rs
= get_remote_state ();
10426 const char *remote_exec_file
= get_remote_exec_file ();
10428 /* If running asynchronously, register the target file descriptor
10429 with the event loop. */
10430 if (target_can_async_p ())
10433 /* Disable address space randomization if requested (and supported). */
10434 if (supports_disable_randomization ())
10435 extended_remote_disable_randomization (disable_randomization
);
10437 /* If startup-with-shell is on, we inform gdbserver to start the
10438 remote inferior using a shell. */
10439 if (packet_support (PACKET_QStartupWithShell
) != PACKET_DISABLE
)
10441 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10442 "QStartupWithShell:%d", startup_with_shell
? 1 : 0);
10444 getpkt (&rs
->buf
, 0);
10445 if (strcmp (rs
->buf
.data (), "OK") != 0)
10447 Remote replied unexpectedly while setting startup-with-shell: %s"),
10451 extended_remote_environment_support ();
10453 extended_remote_set_inferior_cwd ();
10455 /* Now restart the remote server. */
10456 run_worked
= extended_remote_run (args
) != -1;
10459 /* vRun was not supported. Fail if we need it to do what the
10461 if (remote_exec_file
[0])
10462 error (_("Remote target does not support \"set remote exec-file\""));
10463 if (!args
.empty ())
10464 error (_("Remote target does not support \"set args\" or run ARGS"));
10466 /* Fall back to "R". */
10467 extended_remote_restart ();
10470 /* vRun's success return is a stop reply. */
10471 stop_reply
= run_worked
? rs
->buf
.data () : NULL
;
10472 add_current_inferior_and_thread (stop_reply
);
10474 /* Get updated offsets, if the stub uses qOffsets. */
10479 /* Given a location's target info BP_TGT and the packet buffer BUF, output
10480 the list of conditions (in agent expression bytecode format), if any, the
10481 target needs to evaluate. The output is placed into the packet buffer
10482 started from BUF and ended at BUF_END. */
10485 remote_add_target_side_condition (struct gdbarch
*gdbarch
,
10486 struct bp_target_info
*bp_tgt
, char *buf
,
10489 if (bp_tgt
->conditions
.empty ())
10492 buf
+= strlen (buf
);
10493 xsnprintf (buf
, buf_end
- buf
, "%s", ";");
10496 /* Send conditions to the target. */
10497 for (agent_expr
*aexpr
: bp_tgt
->conditions
)
10499 xsnprintf (buf
, buf_end
- buf
, "X%x,", aexpr
->len
);
10500 buf
+= strlen (buf
);
10501 for (int i
= 0; i
< aexpr
->len
; ++i
)
10502 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
10509 remote_add_target_side_commands (struct gdbarch
*gdbarch
,
10510 struct bp_target_info
*bp_tgt
, char *buf
)
10512 if (bp_tgt
->tcommands
.empty ())
10515 buf
+= strlen (buf
);
10517 sprintf (buf
, ";cmds:%x,", bp_tgt
->persist
);
10518 buf
+= strlen (buf
);
10520 /* Concatenate all the agent expressions that are commands into the
10522 for (agent_expr
*aexpr
: bp_tgt
->tcommands
)
10524 sprintf (buf
, "X%x,", aexpr
->len
);
10525 buf
+= strlen (buf
);
10526 for (int i
= 0; i
< aexpr
->len
; ++i
)
10527 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
10532 /* Insert a breakpoint. On targets that have software breakpoint
10533 support, we ask the remote target to do the work; on targets
10534 which don't, we insert a traditional memory breakpoint. */
10537 remote_target::insert_breakpoint (struct gdbarch
*gdbarch
,
10538 struct bp_target_info
*bp_tgt
)
10540 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
10541 If it succeeds, then set the support to PACKET_ENABLE. If it
10542 fails, and the user has explicitly requested the Z support then
10543 report an error, otherwise, mark it disabled and go on. */
10545 if (packet_support (PACKET_Z0
) != PACKET_DISABLE
)
10547 CORE_ADDR addr
= bp_tgt
->reqstd_address
;
10548 struct remote_state
*rs
;
10551 /* Make sure the remote is pointing at the right process, if
10553 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10554 set_general_process ();
10556 rs
= get_remote_state ();
10557 p
= rs
->buf
.data ();
10558 endbuf
= p
+ get_remote_packet_size ();
10563 addr
= (ULONGEST
) remote_address_masked (addr
);
10564 p
+= hexnumstr (p
, addr
);
10565 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->kind
);
10567 if (supports_evaluation_of_breakpoint_conditions ())
10568 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
10570 if (can_run_breakpoint_commands ())
10571 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
10574 getpkt (&rs
->buf
, 0);
10576 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
]))
10582 case PACKET_UNKNOWN
:
10587 /* If this breakpoint has target-side commands but this stub doesn't
10588 support Z0 packets, throw error. */
10589 if (!bp_tgt
->tcommands
.empty ())
10590 throw_error (NOT_SUPPORTED_ERROR
, _("\
10591 Target doesn't support breakpoints that have target side commands."));
10593 return memory_insert_breakpoint (this, gdbarch
, bp_tgt
);
10597 remote_target::remove_breakpoint (struct gdbarch
*gdbarch
,
10598 struct bp_target_info
*bp_tgt
,
10599 enum remove_bp_reason reason
)
10601 CORE_ADDR addr
= bp_tgt
->placed_address
;
10602 struct remote_state
*rs
= get_remote_state ();
10604 if (packet_support (PACKET_Z0
) != PACKET_DISABLE
)
10606 char *p
= rs
->buf
.data ();
10607 char *endbuf
= p
+ get_remote_packet_size ();
10609 /* Make sure the remote is pointing at the right process, if
10611 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10612 set_general_process ();
10618 addr
= (ULONGEST
) remote_address_masked (bp_tgt
->placed_address
);
10619 p
+= hexnumstr (p
, addr
);
10620 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->kind
);
10623 getpkt (&rs
->buf
, 0);
10625 return (rs
->buf
[0] == 'E');
10628 return memory_remove_breakpoint (this, gdbarch
, bp_tgt
, reason
);
10631 static enum Z_packet_type
10632 watchpoint_to_Z_packet (int type
)
10637 return Z_PACKET_WRITE_WP
;
10640 return Z_PACKET_READ_WP
;
10643 return Z_PACKET_ACCESS_WP
;
10646 internal_error (__FILE__
, __LINE__
,
10647 _("hw_bp_to_z: bad watchpoint type %d"), type
);
10652 remote_target::insert_watchpoint (CORE_ADDR addr
, int len
,
10653 enum target_hw_bp_type type
, struct expression
*cond
)
10655 struct remote_state
*rs
= get_remote_state ();
10656 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
10658 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
10660 if (packet_support (PACKET_Z0
+ packet
) == PACKET_DISABLE
)
10663 /* Make sure the remote is pointing at the right process, if
10665 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10666 set_general_process ();
10668 xsnprintf (rs
->buf
.data (), endbuf
- rs
->buf
.data (), "Z%x,", packet
);
10669 p
= strchr (rs
->buf
.data (), '\0');
10670 addr
= remote_address_masked (addr
);
10671 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10672 xsnprintf (p
, endbuf
- p
, ",%x", len
);
10675 getpkt (&rs
->buf
, 0);
10677 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
10681 case PACKET_UNKNOWN
:
10686 internal_error (__FILE__
, __LINE__
,
10687 _("remote_insert_watchpoint: reached end of function"));
10691 remote_target::watchpoint_addr_within_range (CORE_ADDR addr
,
10692 CORE_ADDR start
, int length
)
10694 CORE_ADDR diff
= remote_address_masked (addr
- start
);
10696 return diff
< length
;
10701 remote_target::remove_watchpoint (CORE_ADDR addr
, int len
,
10702 enum target_hw_bp_type type
, struct expression
*cond
)
10704 struct remote_state
*rs
= get_remote_state ();
10705 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
10707 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
10709 if (packet_support (PACKET_Z0
+ packet
) == PACKET_DISABLE
)
10712 /* Make sure the remote is pointing at the right process, if
10714 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10715 set_general_process ();
10717 xsnprintf (rs
->buf
.data (), endbuf
- rs
->buf
.data (), "z%x,", packet
);
10718 p
= strchr (rs
->buf
.data (), '\0');
10719 addr
= remote_address_masked (addr
);
10720 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10721 xsnprintf (p
, endbuf
- p
, ",%x", len
);
10723 getpkt (&rs
->buf
, 0);
10725 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
10728 case PACKET_UNKNOWN
:
10733 internal_error (__FILE__
, __LINE__
,
10734 _("remote_remove_watchpoint: reached end of function"));
10738 static int remote_hw_watchpoint_limit
= -1;
10739 static int remote_hw_watchpoint_length_limit
= -1;
10740 static int remote_hw_breakpoint_limit
= -1;
10743 remote_target::region_ok_for_hw_watchpoint (CORE_ADDR addr
, int len
)
10745 if (remote_hw_watchpoint_length_limit
== 0)
10747 else if (remote_hw_watchpoint_length_limit
< 0)
10749 else if (len
<= remote_hw_watchpoint_length_limit
)
10756 remote_target::can_use_hw_breakpoint (enum bptype type
, int cnt
, int ot
)
10758 if (type
== bp_hardware_breakpoint
)
10760 if (remote_hw_breakpoint_limit
== 0)
10762 else if (remote_hw_breakpoint_limit
< 0)
10764 else if (cnt
<= remote_hw_breakpoint_limit
)
10769 if (remote_hw_watchpoint_limit
== 0)
10771 else if (remote_hw_watchpoint_limit
< 0)
10775 else if (cnt
<= remote_hw_watchpoint_limit
)
10781 /* The to_stopped_by_sw_breakpoint method of target remote. */
10784 remote_target::stopped_by_sw_breakpoint ()
10786 struct thread_info
*thread
= inferior_thread ();
10788 return (thread
->priv
!= NULL
10789 && (get_remote_thread_info (thread
)->stop_reason
10790 == TARGET_STOPPED_BY_SW_BREAKPOINT
));
10793 /* The to_supports_stopped_by_sw_breakpoint method of target
10797 remote_target::supports_stopped_by_sw_breakpoint ()
10799 return (packet_support (PACKET_swbreak_feature
) == PACKET_ENABLE
);
10802 /* The to_stopped_by_hw_breakpoint method of target remote. */
10805 remote_target::stopped_by_hw_breakpoint ()
10807 struct thread_info
*thread
= inferior_thread ();
10809 return (thread
->priv
!= NULL
10810 && (get_remote_thread_info (thread
)->stop_reason
10811 == TARGET_STOPPED_BY_HW_BREAKPOINT
));
10814 /* The to_supports_stopped_by_hw_breakpoint method of target
10818 remote_target::supports_stopped_by_hw_breakpoint ()
10820 return (packet_support (PACKET_hwbreak_feature
) == PACKET_ENABLE
);
10824 remote_target::stopped_by_watchpoint ()
10826 struct thread_info
*thread
= inferior_thread ();
10828 return (thread
->priv
!= NULL
10829 && (get_remote_thread_info (thread
)->stop_reason
10830 == TARGET_STOPPED_BY_WATCHPOINT
));
10834 remote_target::stopped_data_address (CORE_ADDR
*addr_p
)
10836 struct thread_info
*thread
= inferior_thread ();
10838 if (thread
->priv
!= NULL
10839 && (get_remote_thread_info (thread
)->stop_reason
10840 == TARGET_STOPPED_BY_WATCHPOINT
))
10842 *addr_p
= get_remote_thread_info (thread
)->watch_data_address
;
10851 remote_target::insert_hw_breakpoint (struct gdbarch
*gdbarch
,
10852 struct bp_target_info
*bp_tgt
)
10854 CORE_ADDR addr
= bp_tgt
->reqstd_address
;
10855 struct remote_state
*rs
;
10859 if (packet_support (PACKET_Z1
) == PACKET_DISABLE
)
10862 /* Make sure the remote is pointing at the right process, if
10864 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10865 set_general_process ();
10867 rs
= get_remote_state ();
10868 p
= rs
->buf
.data ();
10869 endbuf
= p
+ get_remote_packet_size ();
10875 addr
= remote_address_masked (addr
);
10876 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10877 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->kind
);
10879 if (supports_evaluation_of_breakpoint_conditions ())
10880 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
10882 if (can_run_breakpoint_commands ())
10883 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
10886 getpkt (&rs
->buf
, 0);
10888 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
10891 if (rs
->buf
[1] == '.')
10893 message
= strchr (&rs
->buf
[2], '.');
10895 error (_("Remote failure reply: %s"), message
+ 1);
10898 case PACKET_UNKNOWN
:
10903 internal_error (__FILE__
, __LINE__
,
10904 _("remote_insert_hw_breakpoint: reached end of function"));
10909 remote_target::remove_hw_breakpoint (struct gdbarch
*gdbarch
,
10910 struct bp_target_info
*bp_tgt
)
10913 struct remote_state
*rs
= get_remote_state ();
10914 char *p
= rs
->buf
.data ();
10915 char *endbuf
= p
+ get_remote_packet_size ();
10917 if (packet_support (PACKET_Z1
) == PACKET_DISABLE
)
10920 /* Make sure the remote is pointing at the right process, if
10922 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10923 set_general_process ();
10929 addr
= remote_address_masked (bp_tgt
->placed_address
);
10930 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10931 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->kind
);
10934 getpkt (&rs
->buf
, 0);
10936 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
10939 case PACKET_UNKNOWN
:
10944 internal_error (__FILE__
, __LINE__
,
10945 _("remote_remove_hw_breakpoint: reached end of function"));
10948 /* Verify memory using the "qCRC:" request. */
10951 remote_target::verify_memory (const gdb_byte
*data
, CORE_ADDR lma
, ULONGEST size
)
10953 struct remote_state
*rs
= get_remote_state ();
10954 unsigned long host_crc
, target_crc
;
10957 /* It doesn't make sense to use qCRC if the remote target is
10958 connected but not running. */
10959 if (target_has_execution ()
10960 && packet_support (PACKET_qCRC
) != PACKET_DISABLE
)
10962 enum packet_result result
;
10964 /* Make sure the remote is pointing at the right process. */
10965 set_general_process ();
10967 /* FIXME: assumes lma can fit into long. */
10968 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qCRC:%lx,%lx",
10969 (long) lma
, (long) size
);
10972 /* Be clever; compute the host_crc before waiting for target
10974 host_crc
= xcrc32 (data
, size
, 0xffffffff);
10976 getpkt (&rs
->buf
, 0);
10978 result
= packet_ok (rs
->buf
,
10979 &remote_protocol_packets
[PACKET_qCRC
]);
10980 if (result
== PACKET_ERROR
)
10982 else if (result
== PACKET_OK
)
10984 for (target_crc
= 0, tmp
= &rs
->buf
[1]; *tmp
; tmp
++)
10985 target_crc
= target_crc
* 16 + fromhex (*tmp
);
10987 return (host_crc
== target_crc
);
10991 return simple_verify_memory (this, data
, lma
, size
);
10994 /* compare-sections command
10996 With no arguments, compares each loadable section in the exec bfd
10997 with the same memory range on the target, and reports mismatches.
10998 Useful for verifying the image on the target against the exec file. */
11001 compare_sections_command (const char *args
, int from_tty
)
11004 const char *sectname
;
11005 bfd_size_type size
;
11008 int mismatched
= 0;
11012 if (!current_program_space
->exec_bfd ())
11013 error (_("command cannot be used without an exec file"));
11015 if (args
!= NULL
&& strcmp (args
, "-r") == 0)
11021 for (s
= current_program_space
->exec_bfd ()->sections
; s
; s
= s
->next
)
11023 if (!(s
->flags
& SEC_LOAD
))
11024 continue; /* Skip non-loadable section. */
11026 if (read_only
&& (s
->flags
& SEC_READONLY
) == 0)
11027 continue; /* Skip writeable sections */
11029 size
= bfd_section_size (s
);
11031 continue; /* Skip zero-length section. */
11033 sectname
= bfd_section_name (s
);
11034 if (args
&& strcmp (args
, sectname
) != 0)
11035 continue; /* Not the section selected by user. */
11037 matched
= 1; /* Do this section. */
11040 gdb::byte_vector
sectdata (size
);
11041 bfd_get_section_contents (current_program_space
->exec_bfd (), s
,
11042 sectdata
.data (), 0, size
);
11044 res
= target_verify_memory (sectdata
.data (), lma
, size
);
11047 error (_("target memory fault, section %s, range %s -- %s"), sectname
,
11048 paddress (target_gdbarch (), lma
),
11049 paddress (target_gdbarch (), lma
+ size
));
11051 printf_filtered ("Section %s, range %s -- %s: ", sectname
,
11052 paddress (target_gdbarch (), lma
),
11053 paddress (target_gdbarch (), lma
+ size
));
11055 printf_filtered ("matched.\n");
11058 printf_filtered ("MIS-MATCHED!\n");
11062 if (mismatched
> 0)
11063 warning (_("One or more sections of the target image does not match\n\
11064 the loaded file\n"));
11065 if (args
&& !matched
)
11066 printf_filtered (_("No loaded section named '%s'.\n"), args
);
11069 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
11070 into remote target. The number of bytes written to the remote
11071 target is returned, or -1 for error. */
11074 remote_target::remote_write_qxfer (const char *object_name
,
11075 const char *annex
, const gdb_byte
*writebuf
,
11076 ULONGEST offset
, LONGEST len
,
11077 ULONGEST
*xfered_len
,
11078 struct packet_config
*packet
)
11082 struct remote_state
*rs
= get_remote_state ();
11083 int max_size
= get_memory_write_packet_size ();
11085 if (packet_config_support (packet
) == PACKET_DISABLE
)
11086 return TARGET_XFER_E_IO
;
11088 /* Insert header. */
11089 i
= snprintf (rs
->buf
.data (), max_size
,
11090 "qXfer:%s:write:%s:%s:",
11091 object_name
, annex
? annex
: "",
11092 phex_nz (offset
, sizeof offset
));
11093 max_size
-= (i
+ 1);
11095 /* Escape as much data as fits into rs->buf. */
11096 buf_len
= remote_escape_output
11097 (writebuf
, len
, 1, (gdb_byte
*) rs
->buf
.data () + i
, &max_size
, max_size
);
11099 if (putpkt_binary (rs
->buf
.data (), i
+ buf_len
) < 0
11100 || getpkt_sane (&rs
->buf
, 0) < 0
11101 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11102 return TARGET_XFER_E_IO
;
11104 unpack_varlen_hex (rs
->buf
.data (), &n
);
11107 return (*xfered_len
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
11110 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
11111 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
11112 number of bytes read is returned, or 0 for EOF, or -1 for error.
11113 The number of bytes read may be less than LEN without indicating an
11114 EOF. PACKET is checked and updated to indicate whether the remote
11115 target supports this object. */
11118 remote_target::remote_read_qxfer (const char *object_name
,
11120 gdb_byte
*readbuf
, ULONGEST offset
,
11122 ULONGEST
*xfered_len
,
11123 struct packet_config
*packet
)
11125 struct remote_state
*rs
= get_remote_state ();
11126 LONGEST i
, n
, packet_len
;
11128 if (packet_config_support (packet
) == PACKET_DISABLE
)
11129 return TARGET_XFER_E_IO
;
11131 /* Check whether we've cached an end-of-object packet that matches
11133 if (rs
->finished_object
)
11135 if (strcmp (object_name
, rs
->finished_object
) == 0
11136 && strcmp (annex
? annex
: "", rs
->finished_annex
) == 0
11137 && offset
== rs
->finished_offset
)
11138 return TARGET_XFER_EOF
;
11141 /* Otherwise, we're now reading something different. Discard
11143 xfree (rs
->finished_object
);
11144 xfree (rs
->finished_annex
);
11145 rs
->finished_object
= NULL
;
11146 rs
->finished_annex
= NULL
;
11149 /* Request only enough to fit in a single packet. The actual data
11150 may not, since we don't know how much of it will need to be escaped;
11151 the target is free to respond with slightly less data. We subtract
11152 five to account for the response type and the protocol frame. */
11153 n
= std::min
<LONGEST
> (get_remote_packet_size () - 5, len
);
11154 snprintf (rs
->buf
.data (), get_remote_packet_size () - 4,
11155 "qXfer:%s:read:%s:%s,%s",
11156 object_name
, annex
? annex
: "",
11157 phex_nz (offset
, sizeof offset
),
11158 phex_nz (n
, sizeof n
));
11159 i
= putpkt (rs
->buf
);
11161 return TARGET_XFER_E_IO
;
11164 packet_len
= getpkt_sane (&rs
->buf
, 0);
11165 if (packet_len
< 0 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11166 return TARGET_XFER_E_IO
;
11168 if (rs
->buf
[0] != 'l' && rs
->buf
[0] != 'm')
11169 error (_("Unknown remote qXfer reply: %s"), rs
->buf
.data ());
11171 /* 'm' means there is (or at least might be) more data after this
11172 batch. That does not make sense unless there's at least one byte
11173 of data in this reply. */
11174 if (rs
->buf
[0] == 'm' && packet_len
== 1)
11175 error (_("Remote qXfer reply contained no data."));
11177 /* Got some data. */
11178 i
= remote_unescape_input ((gdb_byte
*) rs
->buf
.data () + 1,
11179 packet_len
- 1, readbuf
, n
);
11181 /* 'l' is an EOF marker, possibly including a final block of data,
11182 or possibly empty. If we have the final block of a non-empty
11183 object, record this fact to bypass a subsequent partial read. */
11184 if (rs
->buf
[0] == 'l' && offset
+ i
> 0)
11186 rs
->finished_object
= xstrdup (object_name
);
11187 rs
->finished_annex
= xstrdup (annex
? annex
: "");
11188 rs
->finished_offset
= offset
+ i
;
11192 return TARGET_XFER_EOF
;
11196 return TARGET_XFER_OK
;
11200 enum target_xfer_status
11201 remote_target::xfer_partial (enum target_object object
,
11202 const char *annex
, gdb_byte
*readbuf
,
11203 const gdb_byte
*writebuf
, ULONGEST offset
, ULONGEST len
,
11204 ULONGEST
*xfered_len
)
11206 struct remote_state
*rs
;
11210 int unit_size
= gdbarch_addressable_memory_unit_size (target_gdbarch ());
11212 set_remote_traceframe ();
11213 set_general_thread (inferior_ptid
);
11215 rs
= get_remote_state ();
11217 /* Handle memory using the standard memory routines. */
11218 if (object
== TARGET_OBJECT_MEMORY
)
11220 /* If the remote target is connected but not running, we should
11221 pass this request down to a lower stratum (e.g. the executable
11223 if (!target_has_execution ())
11224 return TARGET_XFER_EOF
;
11226 if (writebuf
!= NULL
)
11227 return remote_write_bytes (offset
, writebuf
, len
, unit_size
,
11230 return remote_read_bytes (offset
, readbuf
, len
, unit_size
,
11234 /* Handle extra signal info using qxfer packets. */
11235 if (object
== TARGET_OBJECT_SIGNAL_INFO
)
11238 return remote_read_qxfer ("siginfo", annex
, readbuf
, offset
, len
,
11239 xfered_len
, &remote_protocol_packets
11240 [PACKET_qXfer_siginfo_read
]);
11242 return remote_write_qxfer ("siginfo", annex
,
11243 writebuf
, offset
, len
, xfered_len
,
11244 &remote_protocol_packets
11245 [PACKET_qXfer_siginfo_write
]);
11248 if (object
== TARGET_OBJECT_STATIC_TRACE_DATA
)
11251 return remote_read_qxfer ("statictrace", annex
,
11252 readbuf
, offset
, len
, xfered_len
,
11253 &remote_protocol_packets
11254 [PACKET_qXfer_statictrace_read
]);
11256 return TARGET_XFER_E_IO
;
11259 /* Only handle flash writes. */
11260 if (writebuf
!= NULL
)
11264 case TARGET_OBJECT_FLASH
:
11265 return remote_flash_write (offset
, len
, xfered_len
,
11269 return TARGET_XFER_E_IO
;
11273 /* Map pre-existing objects onto letters. DO NOT do this for new
11274 objects!!! Instead specify new query packets. */
11277 case TARGET_OBJECT_AVR
:
11281 case TARGET_OBJECT_AUXV
:
11282 gdb_assert (annex
== NULL
);
11283 return remote_read_qxfer ("auxv", annex
, readbuf
, offset
, len
,
11285 &remote_protocol_packets
[PACKET_qXfer_auxv
]);
11287 case TARGET_OBJECT_AVAILABLE_FEATURES
:
11288 return remote_read_qxfer
11289 ("features", annex
, readbuf
, offset
, len
, xfered_len
,
11290 &remote_protocol_packets
[PACKET_qXfer_features
]);
11292 case TARGET_OBJECT_LIBRARIES
:
11293 return remote_read_qxfer
11294 ("libraries", annex
, readbuf
, offset
, len
, xfered_len
,
11295 &remote_protocol_packets
[PACKET_qXfer_libraries
]);
11297 case TARGET_OBJECT_LIBRARIES_SVR4
:
11298 return remote_read_qxfer
11299 ("libraries-svr4", annex
, readbuf
, offset
, len
, xfered_len
,
11300 &remote_protocol_packets
[PACKET_qXfer_libraries_svr4
]);
11302 case TARGET_OBJECT_MEMORY_MAP
:
11303 gdb_assert (annex
== NULL
);
11304 return remote_read_qxfer ("memory-map", annex
, readbuf
, offset
, len
,
11306 &remote_protocol_packets
[PACKET_qXfer_memory_map
]);
11308 case TARGET_OBJECT_OSDATA
:
11309 /* Should only get here if we're connected. */
11310 gdb_assert (rs
->remote_desc
);
11311 return remote_read_qxfer
11312 ("osdata", annex
, readbuf
, offset
, len
, xfered_len
,
11313 &remote_protocol_packets
[PACKET_qXfer_osdata
]);
11315 case TARGET_OBJECT_THREADS
:
11316 gdb_assert (annex
== NULL
);
11317 return remote_read_qxfer ("threads", annex
, readbuf
, offset
, len
,
11319 &remote_protocol_packets
[PACKET_qXfer_threads
]);
11321 case TARGET_OBJECT_TRACEFRAME_INFO
:
11322 gdb_assert (annex
== NULL
);
11323 return remote_read_qxfer
11324 ("traceframe-info", annex
, readbuf
, offset
, len
, xfered_len
,
11325 &remote_protocol_packets
[PACKET_qXfer_traceframe_info
]);
11327 case TARGET_OBJECT_FDPIC
:
11328 return remote_read_qxfer ("fdpic", annex
, readbuf
, offset
, len
,
11330 &remote_protocol_packets
[PACKET_qXfer_fdpic
]);
11332 case TARGET_OBJECT_OPENVMS_UIB
:
11333 return remote_read_qxfer ("uib", annex
, readbuf
, offset
, len
,
11335 &remote_protocol_packets
[PACKET_qXfer_uib
]);
11337 case TARGET_OBJECT_BTRACE
:
11338 return remote_read_qxfer ("btrace", annex
, readbuf
, offset
, len
,
11340 &remote_protocol_packets
[PACKET_qXfer_btrace
]);
11342 case TARGET_OBJECT_BTRACE_CONF
:
11343 return remote_read_qxfer ("btrace-conf", annex
, readbuf
, offset
,
11345 &remote_protocol_packets
[PACKET_qXfer_btrace_conf
]);
11347 case TARGET_OBJECT_EXEC_FILE
:
11348 return remote_read_qxfer ("exec-file", annex
, readbuf
, offset
,
11350 &remote_protocol_packets
[PACKET_qXfer_exec_file
]);
11353 return TARGET_XFER_E_IO
;
11356 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
11357 large enough let the caller deal with it. */
11358 if (len
< get_remote_packet_size ())
11359 return TARGET_XFER_E_IO
;
11360 len
= get_remote_packet_size ();
11362 /* Except for querying the minimum buffer size, target must be open. */
11363 if (!rs
->remote_desc
)
11364 error (_("remote query is only available after target open"));
11366 gdb_assert (annex
!= NULL
);
11367 gdb_assert (readbuf
!= NULL
);
11369 p2
= rs
->buf
.data ();
11371 *p2
++ = query_type
;
11373 /* We used one buffer char for the remote protocol q command and
11374 another for the query type. As the remote protocol encapsulation
11375 uses 4 chars plus one extra in case we are debugging
11376 (remote_debug), we have PBUFZIZ - 7 left to pack the query
11379 while (annex
[i
] && (i
< (get_remote_packet_size () - 8)))
11381 /* Bad caller may have sent forbidden characters. */
11382 gdb_assert (isprint (annex
[i
]) && annex
[i
] != '$' && annex
[i
] != '#');
11387 gdb_assert (annex
[i
] == '\0');
11389 i
= putpkt (rs
->buf
);
11391 return TARGET_XFER_E_IO
;
11393 getpkt (&rs
->buf
, 0);
11394 strcpy ((char *) readbuf
, rs
->buf
.data ());
11396 *xfered_len
= strlen ((char *) readbuf
);
11397 return (*xfered_len
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
11400 /* Implementation of to_get_memory_xfer_limit. */
11403 remote_target::get_memory_xfer_limit ()
11405 return get_memory_write_packet_size ();
11409 remote_target::search_memory (CORE_ADDR start_addr
, ULONGEST search_space_len
,
11410 const gdb_byte
*pattern
, ULONGEST pattern_len
,
11411 CORE_ADDR
*found_addrp
)
11413 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
11414 struct remote_state
*rs
= get_remote_state ();
11415 int max_size
= get_memory_write_packet_size ();
11416 struct packet_config
*packet
=
11417 &remote_protocol_packets
[PACKET_qSearch_memory
];
11418 /* Number of packet bytes used to encode the pattern;
11419 this could be more than PATTERN_LEN due to escape characters. */
11420 int escaped_pattern_len
;
11421 /* Amount of pattern that was encodable in the packet. */
11422 int used_pattern_len
;
11425 ULONGEST found_addr
;
11427 auto read_memory
= [=] (CORE_ADDR addr
, gdb_byte
*result
, size_t len
)
11429 return (target_read (this, TARGET_OBJECT_MEMORY
, NULL
, result
, addr
, len
)
11433 /* Don't go to the target if we don't have to. This is done before
11434 checking packet_config_support to avoid the possibility that a
11435 success for this edge case means the facility works in
11437 if (pattern_len
> search_space_len
)
11439 if (pattern_len
== 0)
11441 *found_addrp
= start_addr
;
11445 /* If we already know the packet isn't supported, fall back to the simple
11446 way of searching memory. */
11448 if (packet_config_support (packet
) == PACKET_DISABLE
)
11450 /* Target doesn't provided special support, fall back and use the
11451 standard support (copy memory and do the search here). */
11452 return simple_search_memory (read_memory
, start_addr
, search_space_len
,
11453 pattern
, pattern_len
, found_addrp
);
11456 /* Make sure the remote is pointing at the right process. */
11457 set_general_process ();
11459 /* Insert header. */
11460 i
= snprintf (rs
->buf
.data (), max_size
,
11461 "qSearch:memory:%s;%s;",
11462 phex_nz (start_addr
, addr_size
),
11463 phex_nz (search_space_len
, sizeof (search_space_len
)));
11464 max_size
-= (i
+ 1);
11466 /* Escape as much data as fits into rs->buf. */
11467 escaped_pattern_len
=
11468 remote_escape_output (pattern
, pattern_len
, 1,
11469 (gdb_byte
*) rs
->buf
.data () + i
,
11470 &used_pattern_len
, max_size
);
11472 /* Bail if the pattern is too large. */
11473 if (used_pattern_len
!= pattern_len
)
11474 error (_("Pattern is too large to transmit to remote target."));
11476 if (putpkt_binary (rs
->buf
.data (), i
+ escaped_pattern_len
) < 0
11477 || getpkt_sane (&rs
->buf
, 0) < 0
11478 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11480 /* The request may not have worked because the command is not
11481 supported. If so, fall back to the simple way. */
11482 if (packet_config_support (packet
) == PACKET_DISABLE
)
11484 return simple_search_memory (read_memory
, start_addr
, search_space_len
,
11485 pattern
, pattern_len
, found_addrp
);
11490 if (rs
->buf
[0] == '0')
11492 else if (rs
->buf
[0] == '1')
11495 if (rs
->buf
[1] != ',')
11496 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
.data ());
11497 unpack_varlen_hex (&rs
->buf
[2], &found_addr
);
11498 *found_addrp
= found_addr
;
11501 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
.data ());
11507 remote_target::rcmd (const char *command
, struct ui_file
*outbuf
)
11509 struct remote_state
*rs
= get_remote_state ();
11510 char *p
= rs
->buf
.data ();
11512 if (!rs
->remote_desc
)
11513 error (_("remote rcmd is only available after target open"));
11515 /* Send a NULL command across as an empty command. */
11516 if (command
== NULL
)
11519 /* The query prefix. */
11520 strcpy (rs
->buf
.data (), "qRcmd,");
11521 p
= strchr (rs
->buf
.data (), '\0');
11523 if ((strlen (rs
->buf
.data ()) + strlen (command
) * 2 + 8/*misc*/)
11524 > get_remote_packet_size ())
11525 error (_("\"monitor\" command ``%s'' is too long."), command
);
11527 /* Encode the actual command. */
11528 bin2hex ((const gdb_byte
*) command
, p
, strlen (command
));
11530 if (putpkt (rs
->buf
) < 0)
11531 error (_("Communication problem with target."));
11533 /* get/display the response */
11538 /* XXX - see also remote_get_noisy_reply(). */
11539 QUIT
; /* Allow user to bail out with ^C. */
11541 if (getpkt_sane (&rs
->buf
, 0) == -1)
11543 /* Timeout. Continue to (try to) read responses.
11544 This is better than stopping with an error, assuming the stub
11545 is still executing the (long) monitor command.
11546 If needed, the user can interrupt gdb using C-c, obtaining
11547 an effect similar to stop on timeout. */
11550 buf
= rs
->buf
.data ();
11551 if (buf
[0] == '\0')
11552 error (_("Target does not support this command."));
11553 if (buf
[0] == 'O' && buf
[1] != 'K')
11555 remote_console_output (buf
+ 1); /* 'O' message from stub. */
11558 if (strcmp (buf
, "OK") == 0)
11560 if (strlen (buf
) == 3 && buf
[0] == 'E'
11561 && isdigit (buf
[1]) && isdigit (buf
[2]))
11563 error (_("Protocol error with Rcmd"));
11565 for (p
= buf
; p
[0] != '\0' && p
[1] != '\0'; p
+= 2)
11567 char c
= (fromhex (p
[0]) << 4) + fromhex (p
[1]);
11569 fputc_unfiltered (c
, outbuf
);
11575 std::vector
<mem_region
>
11576 remote_target::memory_map ()
11578 std::vector
<mem_region
> result
;
11579 gdb::optional
<gdb::char_vector
> text
11580 = target_read_stralloc (current_inferior ()->top_target (),
11581 TARGET_OBJECT_MEMORY_MAP
, NULL
);
11584 result
= parse_memory_map (text
->data ());
11589 /* Set of callbacks used to implement the 'maint packet' command. */
11591 struct cli_packet_command_callbacks
: public send_remote_packet_callbacks
11593 /* Called before the packet is sent. BUF is the packet content before
11594 the protocol specific prefix, suffix, and escaping is added. */
11596 void sending (gdb::array_view
<const char> &buf
) override
11598 puts_filtered ("sending: ");
11599 print_packet (buf
);
11600 puts_filtered ("\n");
11603 /* Called with BUF, the reply from the remote target. */
11605 void received (gdb::array_view
<const char> &buf
) override
11607 puts_filtered ("received: \"");
11608 print_packet (buf
);
11609 puts_filtered ("\"\n");
11614 /* Print BUF o gdb_stdout. Any non-printable bytes in BUF are printed as
11615 '\x??' with '??' replaced by the hexadecimal value of the byte. */
11618 print_packet (gdb::array_view
<const char> &buf
)
11622 for (int i
= 0; i
< buf
.size (); ++i
)
11624 gdb_byte c
= buf
[i
];
11626 fputc_unfiltered (c
, &stb
);
11628 fprintf_unfiltered (&stb
, "\\x%02x", (unsigned char) c
);
11631 puts_filtered (stb
.string ().c_str ());
11635 /* See remote.h. */
11638 send_remote_packet (gdb::array_view
<const char> &buf
,
11639 send_remote_packet_callbacks
*callbacks
)
11641 if (buf
.size () == 0 || buf
.data ()[0] == '\0')
11642 error (_("a remote packet must not be empty"));
11644 remote_target
*remote
= get_current_remote_target ();
11645 if (remote
== nullptr)
11646 error (_("packets can only be sent to a remote target"));
11648 callbacks
->sending (buf
);
11650 remote
->putpkt_binary (buf
.data (), buf
.size ());
11651 remote_state
*rs
= remote
->get_remote_state ();
11652 int bytes
= remote
->getpkt_sane (&rs
->buf
, 0);
11655 error (_("error while fetching packet from remote target"));
11657 gdb::array_view
<const char> view (&rs
->buf
[0], bytes
);
11658 callbacks
->received (view
);
11661 /* Entry point for the 'maint packet' command. */
11664 cli_packet_command (const char *args
, int from_tty
)
11666 cli_packet_command_callbacks cb
;
11667 gdb::array_view
<const char> view
11668 = gdb::make_array_view (args
, args
== nullptr ? 0 : strlen (args
));
11669 send_remote_packet (view
, &cb
);
11673 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
11675 static void display_thread_info (struct gdb_ext_thread_info
*info
);
11677 static void threadset_test_cmd (char *cmd
, int tty
);
11679 static void threadalive_test (char *cmd
, int tty
);
11681 static void threadlist_test_cmd (char *cmd
, int tty
);
11683 int get_and_display_threadinfo (threadref
*ref
);
11685 static void threadinfo_test_cmd (char *cmd
, int tty
);
11687 static int thread_display_step (threadref
*ref
, void *context
);
11689 static void threadlist_update_test_cmd (char *cmd
, int tty
);
11691 static void init_remote_threadtests (void);
11693 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
11696 threadset_test_cmd (const char *cmd
, int tty
)
11698 int sample_thread
= SAMPLE_THREAD
;
11700 printf_filtered (_("Remote threadset test\n"));
11701 set_general_thread (sample_thread
);
11706 threadalive_test (const char *cmd
, int tty
)
11708 int sample_thread
= SAMPLE_THREAD
;
11709 int pid
= inferior_ptid
.pid ();
11710 ptid_t ptid
= ptid_t (pid
, sample_thread
, 0);
11712 if (remote_thread_alive (ptid
))
11713 printf_filtered ("PASS: Thread alive test\n");
11715 printf_filtered ("FAIL: Thread alive test\n");
11718 void output_threadid (char *title
, threadref
*ref
);
11721 output_threadid (char *title
, threadref
*ref
)
11725 pack_threadid (&hexid
[0], ref
); /* Convert thread id into hex. */
11727 printf_filtered ("%s %s\n", title
, (&hexid
[0]));
11731 threadlist_test_cmd (const char *cmd
, int tty
)
11734 threadref nextthread
;
11735 int done
, result_count
;
11736 threadref threadlist
[3];
11738 printf_filtered ("Remote Threadlist test\n");
11739 if (!remote_get_threadlist (startflag
, &nextthread
, 3, &done
,
11740 &result_count
, &threadlist
[0]))
11741 printf_filtered ("FAIL: threadlist test\n");
11744 threadref
*scan
= threadlist
;
11745 threadref
*limit
= scan
+ result_count
;
11747 while (scan
< limit
)
11748 output_threadid (" thread ", scan
++);
11753 display_thread_info (struct gdb_ext_thread_info
*info
)
11755 output_threadid ("Threadid: ", &info
->threadid
);
11756 printf_filtered ("Name: %s\n ", info
->shortname
);
11757 printf_filtered ("State: %s\n", info
->display
);
11758 printf_filtered ("other: %s\n\n", info
->more_display
);
11762 get_and_display_threadinfo (threadref
*ref
)
11766 struct gdb_ext_thread_info threadinfo
;
11768 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
11769 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
11770 if (0 != (result
= remote_get_threadinfo (ref
, set
, &threadinfo
)))
11771 display_thread_info (&threadinfo
);
11776 threadinfo_test_cmd (const char *cmd
, int tty
)
11778 int athread
= SAMPLE_THREAD
;
11782 int_to_threadref (&thread
, athread
);
11783 printf_filtered ("Remote Threadinfo test\n");
11784 if (!get_and_display_threadinfo (&thread
))
11785 printf_filtered ("FAIL cannot get thread info\n");
11789 thread_display_step (threadref
*ref
, void *context
)
11791 /* output_threadid(" threadstep ",ref); *//* simple test */
11792 return get_and_display_threadinfo (ref
);
11796 threadlist_update_test_cmd (const char *cmd
, int tty
)
11798 printf_filtered ("Remote Threadlist update test\n");
11799 remote_threadlist_iterator (thread_display_step
, 0, CRAZY_MAX_THREADS
);
11803 init_remote_threadtests (void)
11805 add_com ("tlist", class_obscure
, threadlist_test_cmd
,
11806 _("Fetch and print the remote list of "
11807 "thread identifiers, one pkt only."));
11808 add_com ("tinfo", class_obscure
, threadinfo_test_cmd
,
11809 _("Fetch and display info about one thread."));
11810 add_com ("tset", class_obscure
, threadset_test_cmd
,
11811 _("Test setting to a different thread."));
11812 add_com ("tupd", class_obscure
, threadlist_update_test_cmd
,
11813 _("Iterate through updating all remote thread info."));
11814 add_com ("talive", class_obscure
, threadalive_test
,
11815 _("Remote thread alive test."));
11820 /* Convert a thread ID to a string. */
11823 remote_target::pid_to_str (ptid_t ptid
)
11825 struct remote_state
*rs
= get_remote_state ();
11827 if (ptid
== null_ptid
)
11828 return normal_pid_to_str (ptid
);
11829 else if (ptid
.is_pid ())
11831 /* Printing an inferior target id. */
11833 /* When multi-process extensions are off, there's no way in the
11834 remote protocol to know the remote process id, if there's any
11835 at all. There's one exception --- when we're connected with
11836 target extended-remote, and we manually attached to a process
11837 with "attach PID". We don't record anywhere a flag that
11838 allows us to distinguish that case from the case of
11839 connecting with extended-remote and the stub already being
11840 attached to a process, and reporting yes to qAttached, hence
11841 no smart special casing here. */
11842 if (!remote_multi_process_p (rs
))
11843 return "Remote target";
11845 return normal_pid_to_str (ptid
);
11849 if (magic_null_ptid
== ptid
)
11850 return "Thread <main>";
11851 else if (remote_multi_process_p (rs
))
11852 if (ptid
.lwp () == 0)
11853 return normal_pid_to_str (ptid
);
11855 return string_printf ("Thread %d.%ld",
11856 ptid
.pid (), ptid
.lwp ());
11858 return string_printf ("Thread %ld", ptid
.lwp ());
11862 /* Get the address of the thread local variable in OBJFILE which is
11863 stored at OFFSET within the thread local storage for thread PTID. */
11866 remote_target::get_thread_local_address (ptid_t ptid
, CORE_ADDR lm
,
11869 if (packet_support (PACKET_qGetTLSAddr
) != PACKET_DISABLE
)
11871 struct remote_state
*rs
= get_remote_state ();
11872 char *p
= rs
->buf
.data ();
11873 char *endp
= p
+ get_remote_packet_size ();
11874 enum packet_result result
;
11876 strcpy (p
, "qGetTLSAddr:");
11878 p
= write_ptid (p
, endp
, ptid
);
11880 p
+= hexnumstr (p
, offset
);
11882 p
+= hexnumstr (p
, lm
);
11886 getpkt (&rs
->buf
, 0);
11887 result
= packet_ok (rs
->buf
,
11888 &remote_protocol_packets
[PACKET_qGetTLSAddr
]);
11889 if (result
== PACKET_OK
)
11893 unpack_varlen_hex (rs
->buf
.data (), &addr
);
11896 else if (result
== PACKET_UNKNOWN
)
11897 throw_error (TLS_GENERIC_ERROR
,
11898 _("Remote target doesn't support qGetTLSAddr packet"));
11900 throw_error (TLS_GENERIC_ERROR
,
11901 _("Remote target failed to process qGetTLSAddr request"));
11904 throw_error (TLS_GENERIC_ERROR
,
11905 _("TLS not supported or disabled on this target"));
11910 /* Provide thread local base, i.e. Thread Information Block address.
11911 Returns 1 if ptid is found and thread_local_base is non zero. */
11914 remote_target::get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
)
11916 if (packet_support (PACKET_qGetTIBAddr
) != PACKET_DISABLE
)
11918 struct remote_state
*rs
= get_remote_state ();
11919 char *p
= rs
->buf
.data ();
11920 char *endp
= p
+ get_remote_packet_size ();
11921 enum packet_result result
;
11923 strcpy (p
, "qGetTIBAddr:");
11925 p
= write_ptid (p
, endp
, ptid
);
11929 getpkt (&rs
->buf
, 0);
11930 result
= packet_ok (rs
->buf
,
11931 &remote_protocol_packets
[PACKET_qGetTIBAddr
]);
11932 if (result
== PACKET_OK
)
11935 unpack_varlen_hex (rs
->buf
.data (), &val
);
11937 *addr
= (CORE_ADDR
) val
;
11940 else if (result
== PACKET_UNKNOWN
)
11941 error (_("Remote target doesn't support qGetTIBAddr packet"));
11943 error (_("Remote target failed to process qGetTIBAddr request"));
11946 error (_("qGetTIBAddr not supported or disabled on this target"));
11951 /* Support for inferring a target description based on the current
11952 architecture and the size of a 'g' packet. While the 'g' packet
11953 can have any size (since optional registers can be left off the
11954 end), some sizes are easily recognizable given knowledge of the
11955 approximate architecture. */
11957 struct remote_g_packet_guess
11959 remote_g_packet_guess (int bytes_
, const struct target_desc
*tdesc_
)
11966 const struct target_desc
*tdesc
;
11969 struct remote_g_packet_data
: public allocate_on_obstack
11971 std::vector
<remote_g_packet_guess
> guesses
;
11974 static struct gdbarch_data
*remote_g_packet_data_handle
;
11977 remote_g_packet_data_init (struct obstack
*obstack
)
11979 return new (obstack
) remote_g_packet_data
;
11983 register_remote_g_packet_guess (struct gdbarch
*gdbarch
, int bytes
,
11984 const struct target_desc
*tdesc
)
11986 struct remote_g_packet_data
*data
11987 = ((struct remote_g_packet_data
*)
11988 gdbarch_data (gdbarch
, remote_g_packet_data_handle
));
11990 gdb_assert (tdesc
!= NULL
);
11992 for (const remote_g_packet_guess
&guess
: data
->guesses
)
11993 if (guess
.bytes
== bytes
)
11994 internal_error (__FILE__
, __LINE__
,
11995 _("Duplicate g packet description added for size %d"),
11998 data
->guesses
.emplace_back (bytes
, tdesc
);
12001 /* Return true if remote_read_description would do anything on this target
12002 and architecture, false otherwise. */
12005 remote_read_description_p (struct target_ops
*target
)
12007 struct remote_g_packet_data
*data
12008 = ((struct remote_g_packet_data
*)
12009 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
));
12011 return !data
->guesses
.empty ();
12014 const struct target_desc
*
12015 remote_target::read_description ()
12017 struct remote_g_packet_data
*data
12018 = ((struct remote_g_packet_data
*)
12019 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
));
12021 /* Do not try this during initial connection, when we do not know
12022 whether there is a running but stopped thread. */
12023 if (!target_has_execution () || inferior_ptid
== null_ptid
)
12024 return beneath ()->read_description ();
12026 if (!data
->guesses
.empty ())
12028 int bytes
= send_g_packet ();
12030 for (const remote_g_packet_guess
&guess
: data
->guesses
)
12031 if (guess
.bytes
== bytes
)
12032 return guess
.tdesc
;
12034 /* We discard the g packet. A minor optimization would be to
12035 hold on to it, and fill the register cache once we have selected
12036 an architecture, but it's too tricky to do safely. */
12039 return beneath ()->read_description ();
12042 /* Remote file transfer support. This is host-initiated I/O, not
12043 target-initiated; for target-initiated, see remote-fileio.c. */
12045 /* If *LEFT is at least the length of STRING, copy STRING to
12046 *BUFFER, update *BUFFER to point to the new end of the buffer, and
12047 decrease *LEFT. Otherwise raise an error. */
12050 remote_buffer_add_string (char **buffer
, int *left
, const char *string
)
12052 int len
= strlen (string
);
12055 error (_("Packet too long for target."));
12057 memcpy (*buffer
, string
, len
);
12061 /* NUL-terminate the buffer as a convenience, if there is
12067 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
12068 *BUFFER, update *BUFFER to point to the new end of the buffer, and
12069 decrease *LEFT. Otherwise raise an error. */
12072 remote_buffer_add_bytes (char **buffer
, int *left
, const gdb_byte
*bytes
,
12075 if (2 * len
> *left
)
12076 error (_("Packet too long for target."));
12078 bin2hex (bytes
, *buffer
, len
);
12079 *buffer
+= 2 * len
;
12082 /* NUL-terminate the buffer as a convenience, if there is
12088 /* If *LEFT is large enough, convert VALUE to hex and add it to
12089 *BUFFER, update *BUFFER to point to the new end of the buffer, and
12090 decrease *LEFT. Otherwise raise an error. */
12093 remote_buffer_add_int (char **buffer
, int *left
, ULONGEST value
)
12095 int len
= hexnumlen (value
);
12098 error (_("Packet too long for target."));
12100 hexnumstr (*buffer
, value
);
12104 /* NUL-terminate the buffer as a convenience, if there is
12110 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
12111 value, *REMOTE_ERRNO to the remote error number or zero if none
12112 was included, and *ATTACHMENT to point to the start of the annex
12113 if any. The length of the packet isn't needed here; there may
12114 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
12116 Return 0 if the packet could be parsed, -1 if it could not. If
12117 -1 is returned, the other variables may not be initialized. */
12120 remote_hostio_parse_result (const char *buffer
, int *retcode
,
12121 int *remote_errno
, const char **attachment
)
12126 *attachment
= NULL
;
12128 if (buffer
[0] != 'F')
12132 *retcode
= strtol (&buffer
[1], &p
, 16);
12133 if (errno
!= 0 || p
== &buffer
[1])
12136 /* Check for ",errno". */
12140 *remote_errno
= strtol (p
+ 1, &p2
, 16);
12141 if (errno
!= 0 || p
+ 1 == p2
)
12146 /* Check for ";attachment". If there is no attachment, the
12147 packet should end here. */
12150 *attachment
= p
+ 1;
12153 else if (*p
== '\0')
12159 /* Send a prepared I/O packet to the target and read its response.
12160 The prepared packet is in the global RS->BUF before this function
12161 is called, and the answer is there when we return.
12163 COMMAND_BYTES is the length of the request to send, which may include
12164 binary data. WHICH_PACKET is the packet configuration to check
12165 before attempting a packet. If an error occurs, *REMOTE_ERRNO
12166 is set to the error number and -1 is returned. Otherwise the value
12167 returned by the function is returned.
12169 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
12170 attachment is expected; an error will be reported if there's a
12171 mismatch. If one is found, *ATTACHMENT will be set to point into
12172 the packet buffer and *ATTACHMENT_LEN will be set to the
12173 attachment's length. */
12176 remote_target::remote_hostio_send_command (int command_bytes
, int which_packet
,
12177 int *remote_errno
, const char **attachment
,
12178 int *attachment_len
)
12180 struct remote_state
*rs
= get_remote_state ();
12181 int ret
, bytes_read
;
12182 const char *attachment_tmp
;
12184 if (packet_support (which_packet
) == PACKET_DISABLE
)
12186 *remote_errno
= FILEIO_ENOSYS
;
12190 putpkt_binary (rs
->buf
.data (), command_bytes
);
12191 bytes_read
= getpkt_sane (&rs
->buf
, 0);
12193 /* If it timed out, something is wrong. Don't try to parse the
12195 if (bytes_read
< 0)
12197 *remote_errno
= FILEIO_EINVAL
;
12201 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[which_packet
]))
12204 *remote_errno
= FILEIO_EINVAL
;
12206 case PACKET_UNKNOWN
:
12207 *remote_errno
= FILEIO_ENOSYS
;
12213 if (remote_hostio_parse_result (rs
->buf
.data (), &ret
, remote_errno
,
12216 *remote_errno
= FILEIO_EINVAL
;
12220 /* Make sure we saw an attachment if and only if we expected one. */
12221 if ((attachment_tmp
== NULL
&& attachment
!= NULL
)
12222 || (attachment_tmp
!= NULL
&& attachment
== NULL
))
12224 *remote_errno
= FILEIO_EINVAL
;
12228 /* If an attachment was found, it must point into the packet buffer;
12229 work out how many bytes there were. */
12230 if (attachment_tmp
!= NULL
)
12232 *attachment
= attachment_tmp
;
12233 *attachment_len
= bytes_read
- (*attachment
- rs
->buf
.data ());
12239 /* See declaration.h. */
12242 readahead_cache::invalidate ()
12247 /* See declaration.h. */
12250 readahead_cache::invalidate_fd (int fd
)
12252 if (this->fd
== fd
)
12256 /* Set the filesystem remote_hostio functions that take FILENAME
12257 arguments will use. Return 0 on success, or -1 if an error
12258 occurs (and set *REMOTE_ERRNO). */
12261 remote_target::remote_hostio_set_filesystem (struct inferior
*inf
,
12264 struct remote_state
*rs
= get_remote_state ();
12265 int required_pid
= (inf
== NULL
|| inf
->fake_pid_p
) ? 0 : inf
->pid
;
12266 char *p
= rs
->buf
.data ();
12267 int left
= get_remote_packet_size () - 1;
12271 if (packet_support (PACKET_vFile_setfs
) == PACKET_DISABLE
)
12274 if (rs
->fs_pid
!= -1 && required_pid
== rs
->fs_pid
)
12277 remote_buffer_add_string (&p
, &left
, "vFile:setfs:");
12279 xsnprintf (arg
, sizeof (arg
), "%x", required_pid
);
12280 remote_buffer_add_string (&p
, &left
, arg
);
12282 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_setfs
,
12283 remote_errno
, NULL
, NULL
);
12285 if (packet_support (PACKET_vFile_setfs
) == PACKET_DISABLE
)
12289 rs
->fs_pid
= required_pid
;
12294 /* Implementation of to_fileio_open. */
12297 remote_target::remote_hostio_open (inferior
*inf
, const char *filename
,
12298 int flags
, int mode
, int warn_if_slow
,
12301 struct remote_state
*rs
= get_remote_state ();
12302 char *p
= rs
->buf
.data ();
12303 int left
= get_remote_packet_size () - 1;
12307 static int warning_issued
= 0;
12309 printf_unfiltered (_("Reading %s from remote target...\n"),
12312 if (!warning_issued
)
12314 warning (_("File transfers from remote targets can be slow."
12315 " Use \"set sysroot\" to access files locally"
12317 warning_issued
= 1;
12321 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12324 remote_buffer_add_string (&p
, &left
, "vFile:open:");
12326 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12327 strlen (filename
));
12328 remote_buffer_add_string (&p
, &left
, ",");
12330 remote_buffer_add_int (&p
, &left
, flags
);
12331 remote_buffer_add_string (&p
, &left
, ",");
12333 remote_buffer_add_int (&p
, &left
, mode
);
12335 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_open
,
12336 remote_errno
, NULL
, NULL
);
12340 remote_target::fileio_open (struct inferior
*inf
, const char *filename
,
12341 int flags
, int mode
, int warn_if_slow
,
12344 return remote_hostio_open (inf
, filename
, flags
, mode
, warn_if_slow
,
12348 /* Implementation of to_fileio_pwrite. */
12351 remote_target::remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
12352 ULONGEST offset
, int *remote_errno
)
12354 struct remote_state
*rs
= get_remote_state ();
12355 char *p
= rs
->buf
.data ();
12356 int left
= get_remote_packet_size ();
12359 rs
->readahead_cache
.invalidate_fd (fd
);
12361 remote_buffer_add_string (&p
, &left
, "vFile:pwrite:");
12363 remote_buffer_add_int (&p
, &left
, fd
);
12364 remote_buffer_add_string (&p
, &left
, ",");
12366 remote_buffer_add_int (&p
, &left
, offset
);
12367 remote_buffer_add_string (&p
, &left
, ",");
12369 p
+= remote_escape_output (write_buf
, len
, 1, (gdb_byte
*) p
, &out_len
,
12370 (get_remote_packet_size ()
12371 - (p
- rs
->buf
.data ())));
12373 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_pwrite
,
12374 remote_errno
, NULL
, NULL
);
12378 remote_target::fileio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
12379 ULONGEST offset
, int *remote_errno
)
12381 return remote_hostio_pwrite (fd
, write_buf
, len
, offset
, remote_errno
);
12384 /* Helper for the implementation of to_fileio_pread. Read the file
12385 from the remote side with vFile:pread. */
12388 remote_target::remote_hostio_pread_vFile (int fd
, gdb_byte
*read_buf
, int len
,
12389 ULONGEST offset
, int *remote_errno
)
12391 struct remote_state
*rs
= get_remote_state ();
12392 char *p
= rs
->buf
.data ();
12393 const char *attachment
;
12394 int left
= get_remote_packet_size ();
12395 int ret
, attachment_len
;
12398 remote_buffer_add_string (&p
, &left
, "vFile:pread:");
12400 remote_buffer_add_int (&p
, &left
, fd
);
12401 remote_buffer_add_string (&p
, &left
, ",");
12403 remote_buffer_add_int (&p
, &left
, len
);
12404 remote_buffer_add_string (&p
, &left
, ",");
12406 remote_buffer_add_int (&p
, &left
, offset
);
12408 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_pread
,
12409 remote_errno
, &attachment
,
12415 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12417 if (read_len
!= ret
)
12418 error (_("Read returned %d, but %d bytes."), ret
, (int) read_len
);
12423 /* See declaration.h. */
12426 readahead_cache::pread (int fd
, gdb_byte
*read_buf
, size_t len
,
12430 && this->offset
<= offset
12431 && offset
< this->offset
+ this->bufsize
)
12433 ULONGEST max
= this->offset
+ this->bufsize
;
12435 if (offset
+ len
> max
)
12436 len
= max
- offset
;
12438 memcpy (read_buf
, this->buf
+ offset
- this->offset
, len
);
12445 /* Implementation of to_fileio_pread. */
12448 remote_target::remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
12449 ULONGEST offset
, int *remote_errno
)
12452 struct remote_state
*rs
= get_remote_state ();
12453 readahead_cache
*cache
= &rs
->readahead_cache
;
12455 ret
= cache
->pread (fd
, read_buf
, len
, offset
);
12458 cache
->hit_count
++;
12460 remote_debug_printf ("readahead cache hit %s",
12461 pulongest (cache
->hit_count
));
12465 cache
->miss_count
++;
12467 remote_debug_printf ("readahead cache miss %s",
12468 pulongest (cache
->miss_count
));
12471 cache
->offset
= offset
;
12472 cache
->bufsize
= get_remote_packet_size ();
12473 cache
->buf
= (gdb_byte
*) xrealloc (cache
->buf
, cache
->bufsize
);
12475 ret
= remote_hostio_pread_vFile (cache
->fd
, cache
->buf
, cache
->bufsize
,
12476 cache
->offset
, remote_errno
);
12479 cache
->invalidate_fd (fd
);
12483 cache
->bufsize
= ret
;
12484 return cache
->pread (fd
, read_buf
, len
, offset
);
12488 remote_target::fileio_pread (int fd
, gdb_byte
*read_buf
, int len
,
12489 ULONGEST offset
, int *remote_errno
)
12491 return remote_hostio_pread (fd
, read_buf
, len
, offset
, remote_errno
);
12494 /* Implementation of to_fileio_close. */
12497 remote_target::remote_hostio_close (int fd
, int *remote_errno
)
12499 struct remote_state
*rs
= get_remote_state ();
12500 char *p
= rs
->buf
.data ();
12501 int left
= get_remote_packet_size () - 1;
12503 rs
->readahead_cache
.invalidate_fd (fd
);
12505 remote_buffer_add_string (&p
, &left
, "vFile:close:");
12507 remote_buffer_add_int (&p
, &left
, fd
);
12509 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_close
,
12510 remote_errno
, NULL
, NULL
);
12514 remote_target::fileio_close (int fd
, int *remote_errno
)
12516 return remote_hostio_close (fd
, remote_errno
);
12519 /* Implementation of to_fileio_unlink. */
12522 remote_target::remote_hostio_unlink (inferior
*inf
, const char *filename
,
12525 struct remote_state
*rs
= get_remote_state ();
12526 char *p
= rs
->buf
.data ();
12527 int left
= get_remote_packet_size () - 1;
12529 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12532 remote_buffer_add_string (&p
, &left
, "vFile:unlink:");
12534 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12535 strlen (filename
));
12537 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_unlink
,
12538 remote_errno
, NULL
, NULL
);
12542 remote_target::fileio_unlink (struct inferior
*inf
, const char *filename
,
12545 return remote_hostio_unlink (inf
, filename
, remote_errno
);
12548 /* Implementation of to_fileio_readlink. */
12550 gdb::optional
<std::string
>
12551 remote_target::fileio_readlink (struct inferior
*inf
, const char *filename
,
12554 struct remote_state
*rs
= get_remote_state ();
12555 char *p
= rs
->buf
.data ();
12556 const char *attachment
;
12557 int left
= get_remote_packet_size ();
12558 int len
, attachment_len
;
12561 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12564 remote_buffer_add_string (&p
, &left
, "vFile:readlink:");
12566 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12567 strlen (filename
));
12569 len
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_readlink
,
12570 remote_errno
, &attachment
,
12576 std::string
ret (len
, '\0');
12578 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12579 (gdb_byte
*) &ret
[0], len
);
12580 if (read_len
!= len
)
12581 error (_("Readlink returned %d, but %d bytes."), len
, read_len
);
12586 /* Implementation of to_fileio_fstat. */
12589 remote_target::fileio_fstat (int fd
, struct stat
*st
, int *remote_errno
)
12591 struct remote_state
*rs
= get_remote_state ();
12592 char *p
= rs
->buf
.data ();
12593 int left
= get_remote_packet_size ();
12594 int attachment_len
, ret
;
12595 const char *attachment
;
12596 struct fio_stat fst
;
12599 remote_buffer_add_string (&p
, &left
, "vFile:fstat:");
12601 remote_buffer_add_int (&p
, &left
, fd
);
12603 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_fstat
,
12604 remote_errno
, &attachment
,
12608 if (*remote_errno
!= FILEIO_ENOSYS
)
12611 /* Strictly we should return -1, ENOSYS here, but when
12612 "set sysroot remote:" was implemented in August 2008
12613 BFD's need for a stat function was sidestepped with
12614 this hack. This was not remedied until March 2015
12615 so we retain the previous behavior to avoid breaking
12618 Note that the memset is a March 2015 addition; older
12619 GDBs set st_size *and nothing else* so the structure
12620 would have garbage in all other fields. This might
12621 break something but retaining the previous behavior
12622 here would be just too wrong. */
12624 memset (st
, 0, sizeof (struct stat
));
12625 st
->st_size
= INT_MAX
;
12629 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12630 (gdb_byte
*) &fst
, sizeof (fst
));
12632 if (read_len
!= ret
)
12633 error (_("vFile:fstat returned %d, but %d bytes."), ret
, read_len
);
12635 if (read_len
!= sizeof (fst
))
12636 error (_("vFile:fstat returned %d bytes, but expecting %d."),
12637 read_len
, (int) sizeof (fst
));
12639 remote_fileio_to_host_stat (&fst
, st
);
12644 /* Implementation of to_filesystem_is_local. */
12647 remote_target::filesystem_is_local ()
12649 /* Valgrind GDB presents itself as a remote target but works
12650 on the local filesystem: it does not implement remote get
12651 and users are not expected to set a sysroot. To handle
12652 this case we treat the remote filesystem as local if the
12653 sysroot is exactly TARGET_SYSROOT_PREFIX and if the stub
12654 does not support vFile:open. */
12655 if (gdb_sysroot
== TARGET_SYSROOT_PREFIX
)
12657 enum packet_support ps
= packet_support (PACKET_vFile_open
);
12659 if (ps
== PACKET_SUPPORT_UNKNOWN
)
12661 int fd
, remote_errno
;
12663 /* Try opening a file to probe support. The supplied
12664 filename is irrelevant, we only care about whether
12665 the stub recognizes the packet or not. */
12666 fd
= remote_hostio_open (NULL
, "just probing",
12667 FILEIO_O_RDONLY
, 0700, 0,
12671 remote_hostio_close (fd
, &remote_errno
);
12673 ps
= packet_support (PACKET_vFile_open
);
12676 if (ps
== PACKET_DISABLE
)
12678 static int warning_issued
= 0;
12680 if (!warning_issued
)
12682 warning (_("remote target does not support file"
12683 " transfer, attempting to access files"
12684 " from local filesystem."));
12685 warning_issued
= 1;
12696 remote_fileio_errno_to_host (int errnum
)
12702 case FILEIO_ENOENT
:
12710 case FILEIO_EACCES
:
12712 case FILEIO_EFAULT
:
12716 case FILEIO_EEXIST
:
12718 case FILEIO_ENODEV
:
12720 case FILEIO_ENOTDIR
:
12722 case FILEIO_EISDIR
:
12724 case FILEIO_EINVAL
:
12726 case FILEIO_ENFILE
:
12728 case FILEIO_EMFILE
:
12732 case FILEIO_ENOSPC
:
12734 case FILEIO_ESPIPE
:
12738 case FILEIO_ENOSYS
:
12740 case FILEIO_ENAMETOOLONG
:
12741 return ENAMETOOLONG
;
12747 remote_hostio_error (int errnum
)
12749 int host_error
= remote_fileio_errno_to_host (errnum
);
12751 if (host_error
== -1)
12752 error (_("Unknown remote I/O error %d"), errnum
);
12754 error (_("Remote I/O error: %s"), safe_strerror (host_error
));
12757 /* A RAII wrapper around a remote file descriptor. */
12759 class scoped_remote_fd
12762 scoped_remote_fd (remote_target
*remote
, int fd
)
12763 : m_remote (remote
), m_fd (fd
)
12767 ~scoped_remote_fd ()
12774 m_remote
->remote_hostio_close (m_fd
, &remote_errno
);
12778 /* Swallow exception before it escapes the dtor. If
12779 something goes wrong, likely the connection is gone,
12780 and there's nothing else that can be done. */
12785 DISABLE_COPY_AND_ASSIGN (scoped_remote_fd
);
12787 /* Release ownership of the file descriptor, and return it. */
12788 ATTRIBUTE_UNUSED_RESULT
int release () noexcept
12795 /* Return the owned file descriptor. */
12796 int get () const noexcept
12802 /* The remote target. */
12803 remote_target
*m_remote
;
12805 /* The owned remote I/O file descriptor. */
12810 remote_file_put (const char *local_file
, const char *remote_file
, int from_tty
)
12812 remote_target
*remote
= get_current_remote_target ();
12814 if (remote
== nullptr)
12815 error (_("command can only be used with remote target"));
12817 remote
->remote_file_put (local_file
, remote_file
, from_tty
);
12821 remote_target::remote_file_put (const char *local_file
, const char *remote_file
,
12824 int retcode
, remote_errno
, bytes
, io_size
;
12825 int bytes_in_buffer
;
12829 gdb_file_up file
= gdb_fopen_cloexec (local_file
, "rb");
12831 perror_with_name (local_file
);
12833 scoped_remote_fd fd
12834 (this, remote_hostio_open (NULL
,
12835 remote_file
, (FILEIO_O_WRONLY
| FILEIO_O_CREAT
12837 0700, 0, &remote_errno
));
12838 if (fd
.get () == -1)
12839 remote_hostio_error (remote_errno
);
12841 /* Send up to this many bytes at once. They won't all fit in the
12842 remote packet limit, so we'll transfer slightly fewer. */
12843 io_size
= get_remote_packet_size ();
12844 gdb::byte_vector
buffer (io_size
);
12846 bytes_in_buffer
= 0;
12849 while (bytes_in_buffer
|| !saw_eof
)
12853 bytes
= fread (buffer
.data () + bytes_in_buffer
, 1,
12854 io_size
- bytes_in_buffer
,
12858 if (ferror (file
.get ()))
12859 error (_("Error reading %s."), local_file
);
12862 /* EOF. Unless there is something still in the
12863 buffer from the last iteration, we are done. */
12865 if (bytes_in_buffer
== 0)
12873 bytes
+= bytes_in_buffer
;
12874 bytes_in_buffer
= 0;
12876 retcode
= remote_hostio_pwrite (fd
.get (), buffer
.data (), bytes
,
12877 offset
, &remote_errno
);
12880 remote_hostio_error (remote_errno
);
12881 else if (retcode
== 0)
12882 error (_("Remote write of %d bytes returned 0!"), bytes
);
12883 else if (retcode
< bytes
)
12885 /* Short write. Save the rest of the read data for the next
12887 bytes_in_buffer
= bytes
- retcode
;
12888 memmove (buffer
.data (), buffer
.data () + retcode
, bytes_in_buffer
);
12894 if (remote_hostio_close (fd
.release (), &remote_errno
))
12895 remote_hostio_error (remote_errno
);
12898 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file
);
12902 remote_file_get (const char *remote_file
, const char *local_file
, int from_tty
)
12904 remote_target
*remote
= get_current_remote_target ();
12906 if (remote
== nullptr)
12907 error (_("command can only be used with remote target"));
12909 remote
->remote_file_get (remote_file
, local_file
, from_tty
);
12913 remote_target::remote_file_get (const char *remote_file
, const char *local_file
,
12916 int remote_errno
, bytes
, io_size
;
12919 scoped_remote_fd fd
12920 (this, remote_hostio_open (NULL
,
12921 remote_file
, FILEIO_O_RDONLY
, 0, 0,
12923 if (fd
.get () == -1)
12924 remote_hostio_error (remote_errno
);
12926 gdb_file_up file
= gdb_fopen_cloexec (local_file
, "wb");
12928 perror_with_name (local_file
);
12930 /* Send up to this many bytes at once. They won't all fit in the
12931 remote packet limit, so we'll transfer slightly fewer. */
12932 io_size
= get_remote_packet_size ();
12933 gdb::byte_vector
buffer (io_size
);
12938 bytes
= remote_hostio_pread (fd
.get (), buffer
.data (), io_size
, offset
,
12941 /* Success, but no bytes, means end-of-file. */
12944 remote_hostio_error (remote_errno
);
12948 bytes
= fwrite (buffer
.data (), 1, bytes
, file
.get ());
12950 perror_with_name (local_file
);
12953 if (remote_hostio_close (fd
.release (), &remote_errno
))
12954 remote_hostio_error (remote_errno
);
12957 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file
);
12961 remote_file_delete (const char *remote_file
, int from_tty
)
12963 remote_target
*remote
= get_current_remote_target ();
12965 if (remote
== nullptr)
12966 error (_("command can only be used with remote target"));
12968 remote
->remote_file_delete (remote_file
, from_tty
);
12972 remote_target::remote_file_delete (const char *remote_file
, int from_tty
)
12974 int retcode
, remote_errno
;
12976 retcode
= remote_hostio_unlink (NULL
, remote_file
, &remote_errno
);
12978 remote_hostio_error (remote_errno
);
12981 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file
);
12985 remote_put_command (const char *args
, int from_tty
)
12988 error_no_arg (_("file to put"));
12990 gdb_argv
argv (args
);
12991 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
12992 error (_("Invalid parameters to remote put"));
12994 remote_file_put (argv
[0], argv
[1], from_tty
);
12998 remote_get_command (const char *args
, int from_tty
)
13001 error_no_arg (_("file to get"));
13003 gdb_argv
argv (args
);
13004 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
13005 error (_("Invalid parameters to remote get"));
13007 remote_file_get (argv
[0], argv
[1], from_tty
);
13011 remote_delete_command (const char *args
, int from_tty
)
13014 error_no_arg (_("file to delete"));
13016 gdb_argv
argv (args
);
13017 if (argv
[0] == NULL
|| argv
[1] != NULL
)
13018 error (_("Invalid parameters to remote delete"));
13020 remote_file_delete (argv
[0], from_tty
);
13024 remote_target::can_execute_reverse ()
13026 if (packet_support (PACKET_bs
) == PACKET_ENABLE
13027 || packet_support (PACKET_bc
) == PACKET_ENABLE
)
13034 remote_target::supports_non_stop ()
13040 remote_target::supports_disable_randomization ()
13042 /* Only supported in extended mode. */
13047 remote_target::supports_multi_process ()
13049 struct remote_state
*rs
= get_remote_state ();
13051 return remote_multi_process_p (rs
);
13055 remote_supports_cond_tracepoints ()
13057 return packet_support (PACKET_ConditionalTracepoints
) == PACKET_ENABLE
;
13061 remote_target::supports_evaluation_of_breakpoint_conditions ()
13063 return packet_support (PACKET_ConditionalBreakpoints
) == PACKET_ENABLE
;
13067 remote_supports_fast_tracepoints ()
13069 return packet_support (PACKET_FastTracepoints
) == PACKET_ENABLE
;
13073 remote_supports_static_tracepoints ()
13075 return packet_support (PACKET_StaticTracepoints
) == PACKET_ENABLE
;
13079 remote_supports_install_in_trace ()
13081 return packet_support (PACKET_InstallInTrace
) == PACKET_ENABLE
;
13085 remote_target::supports_enable_disable_tracepoint ()
13087 return (packet_support (PACKET_EnableDisableTracepoints_feature
)
13092 remote_target::supports_string_tracing ()
13094 return packet_support (PACKET_tracenz_feature
) == PACKET_ENABLE
;
13098 remote_target::can_run_breakpoint_commands ()
13100 return packet_support (PACKET_BreakpointCommands
) == PACKET_ENABLE
;
13104 remote_target::trace_init ()
13106 struct remote_state
*rs
= get_remote_state ();
13109 remote_get_noisy_reply ();
13110 if (strcmp (rs
->buf
.data (), "OK") != 0)
13111 error (_("Target does not support this command."));
13114 /* Recursive routine to walk through command list including loops, and
13115 download packets for each command. */
13118 remote_target::remote_download_command_source (int num
, ULONGEST addr
,
13119 struct command_line
*cmds
)
13121 struct remote_state
*rs
= get_remote_state ();
13122 struct command_line
*cmd
;
13124 for (cmd
= cmds
; cmd
; cmd
= cmd
->next
)
13126 QUIT
; /* Allow user to bail out with ^C. */
13127 strcpy (rs
->buf
.data (), "QTDPsrc:");
13128 encode_source_string (num
, addr
, "cmd", cmd
->line
,
13129 rs
->buf
.data () + strlen (rs
->buf
.data ()),
13130 rs
->buf
.size () - strlen (rs
->buf
.data ()));
13132 remote_get_noisy_reply ();
13133 if (strcmp (rs
->buf
.data (), "OK"))
13134 warning (_("Target does not support source download."));
13136 if (cmd
->control_type
== while_control
13137 || cmd
->control_type
== while_stepping_control
)
13139 remote_download_command_source (num
, addr
, cmd
->body_list_0
.get ());
13141 QUIT
; /* Allow user to bail out with ^C. */
13142 strcpy (rs
->buf
.data (), "QTDPsrc:");
13143 encode_source_string (num
, addr
, "cmd", "end",
13144 rs
->buf
.data () + strlen (rs
->buf
.data ()),
13145 rs
->buf
.size () - strlen (rs
->buf
.data ()));
13147 remote_get_noisy_reply ();
13148 if (strcmp (rs
->buf
.data (), "OK"))
13149 warning (_("Target does not support source download."));
13155 remote_target::download_tracepoint (struct bp_location
*loc
)
13159 std::vector
<std::string
> tdp_actions
;
13160 std::vector
<std::string
> stepping_actions
;
13162 struct breakpoint
*b
= loc
->owner
;
13163 struct tracepoint
*t
= (struct tracepoint
*) b
;
13164 struct remote_state
*rs
= get_remote_state ();
13166 const char *err_msg
= _("Tracepoint packet too large for target.");
13169 /* We use a buffer other than rs->buf because we'll build strings
13170 across multiple statements, and other statements in between could
13172 gdb::char_vector
buf (get_remote_packet_size ());
13174 encode_actions_rsp (loc
, &tdp_actions
, &stepping_actions
);
13176 tpaddr
= loc
->address
;
13177 strcpy (addrbuf
, phex (tpaddr
, sizeof (CORE_ADDR
)));
13178 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:%x:%s:%c:%lx:%x",
13179 b
->number
, addrbuf
, /* address */
13180 (b
->enable_state
== bp_enabled
? 'E' : 'D'),
13181 t
->step_count
, t
->pass_count
);
13183 if (ret
< 0 || ret
>= buf
.size ())
13184 error ("%s", err_msg
);
13186 /* Fast tracepoints are mostly handled by the target, but we can
13187 tell the target how big of an instruction block should be moved
13189 if (b
->type
== bp_fast_tracepoint
)
13191 /* Only test for support at download time; we may not know
13192 target capabilities at definition time. */
13193 if (remote_supports_fast_tracepoints ())
13195 if (gdbarch_fast_tracepoint_valid_at (loc
->gdbarch
, tpaddr
,
13198 size_left
= buf
.size () - strlen (buf
.data ());
13199 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13201 gdb_insn_length (loc
->gdbarch
, tpaddr
));
13203 if (ret
< 0 || ret
>= size_left
)
13204 error ("%s", err_msg
);
13207 /* If it passed validation at definition but fails now,
13208 something is very wrong. */
13209 internal_error (__FILE__
, __LINE__
,
13210 _("Fast tracepoint not "
13211 "valid during download"));
13214 /* Fast tracepoints are functionally identical to regular
13215 tracepoints, so don't take lack of support as a reason to
13216 give up on the trace run. */
13217 warning (_("Target does not support fast tracepoints, "
13218 "downloading %d as regular tracepoint"), b
->number
);
13220 else if (b
->type
== bp_static_tracepoint
)
13222 /* Only test for support at download time; we may not know
13223 target capabilities at definition time. */
13224 if (remote_supports_static_tracepoints ())
13226 struct static_tracepoint_marker marker
;
13228 if (target_static_tracepoint_marker_at (tpaddr
, &marker
))
13230 size_left
= buf
.size () - strlen (buf
.data ());
13231 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13234 if (ret
< 0 || ret
>= size_left
)
13235 error ("%s", err_msg
);
13238 error (_("Static tracepoint not valid during download"));
13241 /* Fast tracepoints are functionally identical to regular
13242 tracepoints, so don't take lack of support as a reason
13243 to give up on the trace run. */
13244 error (_("Target does not support static tracepoints"));
13246 /* If the tracepoint has a conditional, make it into an agent
13247 expression and append to the definition. */
13250 /* Only test support at download time, we may not know target
13251 capabilities at definition time. */
13252 if (remote_supports_cond_tracepoints ())
13254 agent_expr_up aexpr
= gen_eval_for_expr (tpaddr
,
13257 size_left
= buf
.size () - strlen (buf
.data ());
13259 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13260 size_left
, ":X%x,", aexpr
->len
);
13262 if (ret
< 0 || ret
>= size_left
)
13263 error ("%s", err_msg
);
13265 size_left
= buf
.size () - strlen (buf
.data ());
13267 /* Two bytes to encode each aexpr byte, plus the terminating
13269 if (aexpr
->len
* 2 + 1 > size_left
)
13270 error ("%s", err_msg
);
13272 pkt
= buf
.data () + strlen (buf
.data ());
13274 for (int ndx
= 0; ndx
< aexpr
->len
; ++ndx
)
13275 pkt
= pack_hex_byte (pkt
, aexpr
->buf
[ndx
]);
13279 warning (_("Target does not support conditional tracepoints, "
13280 "ignoring tp %d cond"), b
->number
);
13283 if (b
->commands
|| !default_collect
.empty ())
13285 size_left
= buf
.size () - strlen (buf
.data ());
13287 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13290 if (ret
< 0 || ret
>= size_left
)
13291 error ("%s", err_msg
);
13294 putpkt (buf
.data ());
13295 remote_get_noisy_reply ();
13296 if (strcmp (rs
->buf
.data (), "OK"))
13297 error (_("Target does not support tracepoints."));
13299 /* do_single_steps (t); */
13300 for (auto action_it
= tdp_actions
.begin ();
13301 action_it
!= tdp_actions
.end (); action_it
++)
13303 QUIT
; /* Allow user to bail out with ^C. */
13305 bool has_more
= ((action_it
+ 1) != tdp_actions
.end ()
13306 || !stepping_actions
.empty ());
13308 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:-%x:%s:%s%c",
13309 b
->number
, addrbuf
, /* address */
13310 action_it
->c_str (),
13311 has_more
? '-' : 0);
13313 if (ret
< 0 || ret
>= buf
.size ())
13314 error ("%s", err_msg
);
13316 putpkt (buf
.data ());
13317 remote_get_noisy_reply ();
13318 if (strcmp (rs
->buf
.data (), "OK"))
13319 error (_("Error on target while setting tracepoints."));
13322 for (auto action_it
= stepping_actions
.begin ();
13323 action_it
!= stepping_actions
.end (); action_it
++)
13325 QUIT
; /* Allow user to bail out with ^C. */
13327 bool is_first
= action_it
== stepping_actions
.begin ();
13328 bool has_more
= (action_it
+ 1) != stepping_actions
.end ();
13330 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:-%x:%s:%s%s%s",
13331 b
->number
, addrbuf
, /* address */
13332 is_first
? "S" : "",
13333 action_it
->c_str (),
13334 has_more
? "-" : "");
13336 if (ret
< 0 || ret
>= buf
.size ())
13337 error ("%s", err_msg
);
13339 putpkt (buf
.data ());
13340 remote_get_noisy_reply ();
13341 if (strcmp (rs
->buf
.data (), "OK"))
13342 error (_("Error on target while setting tracepoints."));
13345 if (packet_support (PACKET_TracepointSource
) == PACKET_ENABLE
)
13347 if (b
->location
!= NULL
)
13349 ret
= snprintf (buf
.data (), buf
.size (), "QTDPsrc:");
13351 if (ret
< 0 || ret
>= buf
.size ())
13352 error ("%s", err_msg
);
13354 encode_source_string (b
->number
, loc
->address
, "at",
13355 event_location_to_string (b
->location
.get ()),
13356 buf
.data () + strlen (buf
.data ()),
13357 buf
.size () - strlen (buf
.data ()));
13358 putpkt (buf
.data ());
13359 remote_get_noisy_reply ();
13360 if (strcmp (rs
->buf
.data (), "OK"))
13361 warning (_("Target does not support source download."));
13363 if (b
->cond_string
)
13365 ret
= snprintf (buf
.data (), buf
.size (), "QTDPsrc:");
13367 if (ret
< 0 || ret
>= buf
.size ())
13368 error ("%s", err_msg
);
13370 encode_source_string (b
->number
, loc
->address
,
13371 "cond", b
->cond_string
.get (),
13372 buf
.data () + strlen (buf
.data ()),
13373 buf
.size () - strlen (buf
.data ()));
13374 putpkt (buf
.data ());
13375 remote_get_noisy_reply ();
13376 if (strcmp (rs
->buf
.data (), "OK"))
13377 warning (_("Target does not support source download."));
13379 remote_download_command_source (b
->number
, loc
->address
,
13380 breakpoint_commands (b
));
13385 remote_target::can_download_tracepoint ()
13387 struct remote_state
*rs
= get_remote_state ();
13388 struct trace_status
*ts
;
13391 /* Don't try to install tracepoints until we've relocated our
13392 symbols, and fetched and merged the target's tracepoint list with
13394 if (rs
->starting_up
)
13397 ts
= current_trace_status ();
13398 status
= get_trace_status (ts
);
13400 if (status
== -1 || !ts
->running_known
|| !ts
->running
)
13403 /* If we are in a tracing experiment, but remote stub doesn't support
13404 installing tracepoint in trace, we have to return. */
13405 if (!remote_supports_install_in_trace ())
13413 remote_target::download_trace_state_variable (const trace_state_variable
&tsv
)
13415 struct remote_state
*rs
= get_remote_state ();
13418 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTDV:%x:%s:%x:",
13419 tsv
.number
, phex ((ULONGEST
) tsv
.initial_value
, 8),
13421 p
= rs
->buf
.data () + strlen (rs
->buf
.data ());
13422 if ((p
- rs
->buf
.data ()) + tsv
.name
.length () * 2
13423 >= get_remote_packet_size ())
13424 error (_("Trace state variable name too long for tsv definition packet"));
13425 p
+= 2 * bin2hex ((gdb_byte
*) (tsv
.name
.data ()), p
, tsv
.name
.length ());
13428 remote_get_noisy_reply ();
13429 if (rs
->buf
[0] == '\0')
13430 error (_("Target does not support this command."));
13431 if (strcmp (rs
->buf
.data (), "OK") != 0)
13432 error (_("Error on target while downloading trace state variable."));
13436 remote_target::enable_tracepoint (struct bp_location
*location
)
13438 struct remote_state
*rs
= get_remote_state ();
13440 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTEnable:%x:%s",
13441 location
->owner
->number
,
13442 phex (location
->address
, sizeof (CORE_ADDR
)));
13444 remote_get_noisy_reply ();
13445 if (rs
->buf
[0] == '\0')
13446 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
13447 if (strcmp (rs
->buf
.data (), "OK") != 0)
13448 error (_("Error on target while enabling tracepoint."));
13452 remote_target::disable_tracepoint (struct bp_location
*location
)
13454 struct remote_state
*rs
= get_remote_state ();
13456 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTDisable:%x:%s",
13457 location
->owner
->number
,
13458 phex (location
->address
, sizeof (CORE_ADDR
)));
13460 remote_get_noisy_reply ();
13461 if (rs
->buf
[0] == '\0')
13462 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
13463 if (strcmp (rs
->buf
.data (), "OK") != 0)
13464 error (_("Error on target while disabling tracepoint."));
13468 remote_target::trace_set_readonly_regions ()
13471 bfd_size_type size
;
13476 if (!current_program_space
->exec_bfd ())
13477 return; /* No information to give. */
13479 struct remote_state
*rs
= get_remote_state ();
13481 strcpy (rs
->buf
.data (), "QTro");
13482 offset
= strlen (rs
->buf
.data ());
13483 for (s
= current_program_space
->exec_bfd ()->sections
; s
; s
= s
->next
)
13485 char tmp1
[40], tmp2
[40];
13488 if ((s
->flags
& SEC_LOAD
) == 0 ||
13489 /* (s->flags & SEC_CODE) == 0 || */
13490 (s
->flags
& SEC_READONLY
) == 0)
13494 vma
= bfd_section_vma (s
);
13495 size
= bfd_section_size (s
);
13496 sprintf_vma (tmp1
, vma
);
13497 sprintf_vma (tmp2
, vma
+ size
);
13498 sec_length
= 1 + strlen (tmp1
) + 1 + strlen (tmp2
);
13499 if (offset
+ sec_length
+ 1 > rs
->buf
.size ())
13501 if (packet_support (PACKET_qXfer_traceframe_info
) != PACKET_ENABLE
)
13503 Too many sections for read-only sections definition packet."));
13506 xsnprintf (rs
->buf
.data () + offset
, rs
->buf
.size () - offset
, ":%s,%s",
13508 offset
+= sec_length
;
13513 getpkt (&rs
->buf
, 0);
13518 remote_target::trace_start ()
13520 struct remote_state
*rs
= get_remote_state ();
13522 putpkt ("QTStart");
13523 remote_get_noisy_reply ();
13524 if (rs
->buf
[0] == '\0')
13525 error (_("Target does not support this command."));
13526 if (strcmp (rs
->buf
.data (), "OK") != 0)
13527 error (_("Bogus reply from target: %s"), rs
->buf
.data ());
13531 remote_target::get_trace_status (struct trace_status
*ts
)
13533 /* Initialize it just to avoid a GCC false warning. */
13535 enum packet_result result
;
13536 struct remote_state
*rs
= get_remote_state ();
13538 if (packet_support (PACKET_qTStatus
) == PACKET_DISABLE
)
13541 /* FIXME we need to get register block size some other way. */
13542 trace_regblock_size
13543 = rs
->get_remote_arch_state (target_gdbarch ())->sizeof_g_packet
;
13545 putpkt ("qTStatus");
13549 p
= remote_get_noisy_reply ();
13551 catch (const gdb_exception_error
&ex
)
13553 if (ex
.error
!= TARGET_CLOSE_ERROR
)
13555 exception_fprintf (gdb_stderr
, ex
, "qTStatus: ");
13561 result
= packet_ok (p
, &remote_protocol_packets
[PACKET_qTStatus
]);
13563 /* If the remote target doesn't do tracing, flag it. */
13564 if (result
== PACKET_UNKNOWN
)
13567 /* We're working with a live target. */
13568 ts
->filename
= NULL
;
13571 error (_("Bogus trace status reply from target: %s"), rs
->buf
.data ());
13573 /* Function 'parse_trace_status' sets default value of each field of
13574 'ts' at first, so we don't have to do it here. */
13575 parse_trace_status (p
, ts
);
13577 return ts
->running
;
13581 remote_target::get_tracepoint_status (struct breakpoint
*bp
,
13582 struct uploaded_tp
*utp
)
13584 struct remote_state
*rs
= get_remote_state ();
13586 struct tracepoint
*tp
= (struct tracepoint
*) bp
;
13587 size_t size
= get_remote_packet_size ();
13592 tp
->traceframe_usage
= 0;
13593 for (bp_location
*loc
: tp
->locations ())
13595 /* If the tracepoint was never downloaded, don't go asking for
13597 if (tp
->number_on_target
== 0)
13599 xsnprintf (rs
->buf
.data (), size
, "qTP:%x:%s", tp
->number_on_target
,
13600 phex_nz (loc
->address
, 0));
13602 reply
= remote_get_noisy_reply ();
13603 if (reply
&& *reply
)
13606 parse_tracepoint_status (reply
+ 1, bp
, utp
);
13612 utp
->hit_count
= 0;
13613 utp
->traceframe_usage
= 0;
13614 xsnprintf (rs
->buf
.data (), size
, "qTP:%x:%s", utp
->number
,
13615 phex_nz (utp
->addr
, 0));
13617 reply
= remote_get_noisy_reply ();
13618 if (reply
&& *reply
)
13621 parse_tracepoint_status (reply
+ 1, bp
, utp
);
13627 remote_target::trace_stop ()
13629 struct remote_state
*rs
= get_remote_state ();
13632 remote_get_noisy_reply ();
13633 if (rs
->buf
[0] == '\0')
13634 error (_("Target does not support this command."));
13635 if (strcmp (rs
->buf
.data (), "OK") != 0)
13636 error (_("Bogus reply from target: %s"), rs
->buf
.data ());
13640 remote_target::trace_find (enum trace_find_type type
, int num
,
13641 CORE_ADDR addr1
, CORE_ADDR addr2
,
13644 struct remote_state
*rs
= get_remote_state ();
13645 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
13647 int target_frameno
= -1, target_tracept
= -1;
13649 /* Lookups other than by absolute frame number depend on the current
13650 trace selected, so make sure it is correct on the remote end
13652 if (type
!= tfind_number
)
13653 set_remote_traceframe ();
13655 p
= rs
->buf
.data ();
13656 strcpy (p
, "QTFrame:");
13657 p
= strchr (p
, '\0');
13661 xsnprintf (p
, endbuf
- p
, "%x", num
);
13664 xsnprintf (p
, endbuf
- p
, "pc:%s", phex_nz (addr1
, 0));
13667 xsnprintf (p
, endbuf
- p
, "tdp:%x", num
);
13670 xsnprintf (p
, endbuf
- p
, "range:%s:%s", phex_nz (addr1
, 0),
13671 phex_nz (addr2
, 0));
13673 case tfind_outside
:
13674 xsnprintf (p
, endbuf
- p
, "outside:%s:%s", phex_nz (addr1
, 0),
13675 phex_nz (addr2
, 0));
13678 error (_("Unknown trace find type %d"), type
);
13682 reply
= remote_get_noisy_reply ();
13683 if (*reply
== '\0')
13684 error (_("Target does not support this command."));
13686 while (reply
&& *reply
)
13691 target_frameno
= (int) strtol (p
, &reply
, 16);
13693 error (_("Unable to parse trace frame number"));
13694 /* Don't update our remote traceframe number cache on failure
13695 to select a remote traceframe. */
13696 if (target_frameno
== -1)
13701 target_tracept
= (int) strtol (p
, &reply
, 16);
13703 error (_("Unable to parse tracepoint number"));
13705 case 'O': /* "OK"? */
13706 if (reply
[1] == 'K' && reply
[2] == '\0')
13709 error (_("Bogus reply from target: %s"), reply
);
13712 error (_("Bogus reply from target: %s"), reply
);
13715 *tpp
= target_tracept
;
13717 rs
->remote_traceframe_number
= target_frameno
;
13718 return target_frameno
;
13722 remote_target::get_trace_state_variable_value (int tsvnum
, LONGEST
*val
)
13724 struct remote_state
*rs
= get_remote_state ();
13728 set_remote_traceframe ();
13730 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qTV:%x", tsvnum
);
13732 reply
= remote_get_noisy_reply ();
13733 if (reply
&& *reply
)
13737 unpack_varlen_hex (reply
+ 1, &uval
);
13738 *val
= (LONGEST
) uval
;
13746 remote_target::save_trace_data (const char *filename
)
13748 struct remote_state
*rs
= get_remote_state ();
13751 p
= rs
->buf
.data ();
13752 strcpy (p
, "QTSave:");
13754 if ((p
- rs
->buf
.data ()) + strlen (filename
) * 2
13755 >= get_remote_packet_size ())
13756 error (_("Remote file name too long for trace save packet"));
13757 p
+= 2 * bin2hex ((gdb_byte
*) filename
, p
, strlen (filename
));
13760 reply
= remote_get_noisy_reply ();
13761 if (*reply
== '\0')
13762 error (_("Target does not support this command."));
13763 if (strcmp (reply
, "OK") != 0)
13764 error (_("Bogus reply from target: %s"), reply
);
13768 /* This is basically a memory transfer, but needs to be its own packet
13769 because we don't know how the target actually organizes its trace
13770 memory, plus we want to be able to ask for as much as possible, but
13771 not be unhappy if we don't get as much as we ask for. */
13774 remote_target::get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
)
13776 struct remote_state
*rs
= get_remote_state ();
13781 p
= rs
->buf
.data ();
13782 strcpy (p
, "qTBuffer:");
13784 p
+= hexnumstr (p
, offset
);
13786 p
+= hexnumstr (p
, len
);
13790 reply
= remote_get_noisy_reply ();
13791 if (reply
&& *reply
)
13793 /* 'l' by itself means we're at the end of the buffer and
13794 there is nothing more to get. */
13798 /* Convert the reply into binary. Limit the number of bytes to
13799 convert according to our passed-in buffer size, rather than
13800 what was returned in the packet; if the target is
13801 unexpectedly generous and gives us a bigger reply than we
13802 asked for, we don't want to crash. */
13803 rslt
= hex2bin (reply
, buf
, len
);
13807 /* Something went wrong, flag as an error. */
13812 remote_target::set_disconnected_tracing (int val
)
13814 struct remote_state
*rs
= get_remote_state ();
13816 if (packet_support (PACKET_DisconnectedTracing_feature
) == PACKET_ENABLE
)
13820 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
13821 "QTDisconnected:%x", val
);
13823 reply
= remote_get_noisy_reply ();
13824 if (*reply
== '\0')
13825 error (_("Target does not support this command."));
13826 if (strcmp (reply
, "OK") != 0)
13827 error (_("Bogus reply from target: %s"), reply
);
13830 warning (_("Target does not support disconnected tracing."));
13834 remote_target::core_of_thread (ptid_t ptid
)
13836 thread_info
*info
= find_thread_ptid (this, ptid
);
13838 if (info
!= NULL
&& info
->priv
!= NULL
)
13839 return get_remote_thread_info (info
)->core
;
13845 remote_target::set_circular_trace_buffer (int val
)
13847 struct remote_state
*rs
= get_remote_state ();
13850 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
13851 "QTBuffer:circular:%x", val
);
13853 reply
= remote_get_noisy_reply ();
13854 if (*reply
== '\0')
13855 error (_("Target does not support this command."));
13856 if (strcmp (reply
, "OK") != 0)
13857 error (_("Bogus reply from target: %s"), reply
);
13861 remote_target::traceframe_info ()
13863 gdb::optional
<gdb::char_vector
> text
13864 = target_read_stralloc (current_inferior ()->top_target (),
13865 TARGET_OBJECT_TRACEFRAME_INFO
,
13868 return parse_traceframe_info (text
->data ());
13873 /* Handle the qTMinFTPILen packet. Returns the minimum length of
13874 instruction on which a fast tracepoint may be placed. Returns -1
13875 if the packet is not supported, and 0 if the minimum instruction
13876 length is unknown. */
13879 remote_target::get_min_fast_tracepoint_insn_len ()
13881 struct remote_state
*rs
= get_remote_state ();
13884 /* If we're not debugging a process yet, the IPA can't be
13886 if (!target_has_execution ())
13889 /* Make sure the remote is pointing at the right process. */
13890 set_general_process ();
13892 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qTMinFTPILen");
13894 reply
= remote_get_noisy_reply ();
13895 if (*reply
== '\0')
13899 ULONGEST min_insn_len
;
13901 unpack_varlen_hex (reply
, &min_insn_len
);
13903 return (int) min_insn_len
;
13908 remote_target::set_trace_buffer_size (LONGEST val
)
13910 if (packet_support (PACKET_QTBuffer_size
) != PACKET_DISABLE
)
13912 struct remote_state
*rs
= get_remote_state ();
13913 char *buf
= rs
->buf
.data ();
13914 char *endbuf
= buf
+ get_remote_packet_size ();
13915 enum packet_result result
;
13917 gdb_assert (val
>= 0 || val
== -1);
13918 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTBuffer:size:");
13919 /* Send -1 as literal "-1" to avoid host size dependency. */
13923 buf
+= hexnumstr (buf
, (ULONGEST
) -val
);
13926 buf
+= hexnumstr (buf
, (ULONGEST
) val
);
13929 remote_get_noisy_reply ();
13930 result
= packet_ok (rs
->buf
,
13931 &remote_protocol_packets
[PACKET_QTBuffer_size
]);
13933 if (result
!= PACKET_OK
)
13934 warning (_("Bogus reply from target: %s"), rs
->buf
.data ());
13939 remote_target::set_trace_notes (const char *user
, const char *notes
,
13940 const char *stop_notes
)
13942 struct remote_state
*rs
= get_remote_state ();
13944 char *buf
= rs
->buf
.data ();
13945 char *endbuf
= buf
+ get_remote_packet_size ();
13948 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTNotes:");
13951 buf
+= xsnprintf (buf
, endbuf
- buf
, "user:");
13952 nbytes
= bin2hex ((gdb_byte
*) user
, buf
, strlen (user
));
13958 buf
+= xsnprintf (buf
, endbuf
- buf
, "notes:");
13959 nbytes
= bin2hex ((gdb_byte
*) notes
, buf
, strlen (notes
));
13965 buf
+= xsnprintf (buf
, endbuf
- buf
, "tstop:");
13966 nbytes
= bin2hex ((gdb_byte
*) stop_notes
, buf
, strlen (stop_notes
));
13970 /* Ensure the buffer is terminated. */
13974 reply
= remote_get_noisy_reply ();
13975 if (*reply
== '\0')
13978 if (strcmp (reply
, "OK") != 0)
13979 error (_("Bogus reply from target: %s"), reply
);
13985 remote_target::use_agent (bool use
)
13987 if (packet_support (PACKET_QAgent
) != PACKET_DISABLE
)
13989 struct remote_state
*rs
= get_remote_state ();
13991 /* If the stub supports QAgent. */
13992 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QAgent:%d", use
);
13994 getpkt (&rs
->buf
, 0);
13996 if (strcmp (rs
->buf
.data (), "OK") == 0)
14007 remote_target::can_use_agent ()
14009 return (packet_support (PACKET_QAgent
) != PACKET_DISABLE
);
14012 struct btrace_target_info
14014 /* The ptid of the traced thread. */
14017 /* The obtained branch trace configuration. */
14018 struct btrace_config conf
;
14021 /* Reset our idea of our target's btrace configuration. */
14024 remote_btrace_reset (remote_state
*rs
)
14026 memset (&rs
->btrace_config
, 0, sizeof (rs
->btrace_config
));
14029 /* Synchronize the configuration with the target. */
14032 remote_target::btrace_sync_conf (const btrace_config
*conf
)
14034 struct packet_config
*packet
;
14035 struct remote_state
*rs
;
14036 char *buf
, *pos
, *endbuf
;
14038 rs
= get_remote_state ();
14039 buf
= rs
->buf
.data ();
14040 endbuf
= buf
+ get_remote_packet_size ();
14042 packet
= &remote_protocol_packets
[PACKET_Qbtrace_conf_bts_size
];
14043 if (packet_config_support (packet
) == PACKET_ENABLE
14044 && conf
->bts
.size
!= rs
->btrace_config
.bts
.size
)
14047 pos
+= xsnprintf (pos
, endbuf
- pos
, "%s=0x%x", packet
->name
,
14051 getpkt (&rs
->buf
, 0);
14053 if (packet_ok (buf
, packet
) == PACKET_ERROR
)
14055 if (buf
[0] == 'E' && buf
[1] == '.')
14056 error (_("Failed to configure the BTS buffer size: %s"), buf
+ 2);
14058 error (_("Failed to configure the BTS buffer size."));
14061 rs
->btrace_config
.bts
.size
= conf
->bts
.size
;
14064 packet
= &remote_protocol_packets
[PACKET_Qbtrace_conf_pt_size
];
14065 if (packet_config_support (packet
) == PACKET_ENABLE
14066 && conf
->pt
.size
!= rs
->btrace_config
.pt
.size
)
14069 pos
+= xsnprintf (pos
, endbuf
- pos
, "%s=0x%x", packet
->name
,
14073 getpkt (&rs
->buf
, 0);
14075 if (packet_ok (buf
, packet
) == PACKET_ERROR
)
14077 if (buf
[0] == 'E' && buf
[1] == '.')
14078 error (_("Failed to configure the trace buffer size: %s"), buf
+ 2);
14080 error (_("Failed to configure the trace buffer size."));
14083 rs
->btrace_config
.pt
.size
= conf
->pt
.size
;
14087 /* Read the current thread's btrace configuration from the target and
14088 store it into CONF. */
14091 btrace_read_config (struct btrace_config
*conf
)
14093 gdb::optional
<gdb::char_vector
> xml
14094 = target_read_stralloc (current_inferior ()->top_target (),
14095 TARGET_OBJECT_BTRACE_CONF
, "");
14097 parse_xml_btrace_conf (conf
, xml
->data ());
14100 /* Maybe reopen target btrace. */
14103 remote_target::remote_btrace_maybe_reopen ()
14105 struct remote_state
*rs
= get_remote_state ();
14106 int btrace_target_pushed
= 0;
14107 #if !defined (HAVE_LIBIPT)
14111 /* Don't bother walking the entirety of the remote thread list when
14112 we know the feature isn't supported by the remote. */
14113 if (packet_support (PACKET_qXfer_btrace_conf
) != PACKET_ENABLE
)
14116 scoped_restore_current_thread restore_thread
;
14118 for (thread_info
*tp
: all_non_exited_threads (this))
14120 set_general_thread (tp
->ptid
);
14122 memset (&rs
->btrace_config
, 0x00, sizeof (struct btrace_config
));
14123 btrace_read_config (&rs
->btrace_config
);
14125 if (rs
->btrace_config
.format
== BTRACE_FORMAT_NONE
)
14128 #if !defined (HAVE_LIBIPT)
14129 if (rs
->btrace_config
.format
== BTRACE_FORMAT_PT
)
14134 warning (_("Target is recording using Intel Processor Trace "
14135 "but support was disabled at compile time."));
14140 #endif /* !defined (HAVE_LIBIPT) */
14142 /* Push target, once, but before anything else happens. This way our
14143 changes to the threads will be cleaned up by unpushing the target
14144 in case btrace_read_config () throws. */
14145 if (!btrace_target_pushed
)
14147 btrace_target_pushed
= 1;
14148 record_btrace_push_target ();
14149 printf_filtered (_("Target is recording using %s.\n"),
14150 btrace_format_string (rs
->btrace_config
.format
));
14153 tp
->btrace
.target
= XCNEW (struct btrace_target_info
);
14154 tp
->btrace
.target
->ptid
= tp
->ptid
;
14155 tp
->btrace
.target
->conf
= rs
->btrace_config
;
14159 /* Enable branch tracing. */
14161 struct btrace_target_info
*
14162 remote_target::enable_btrace (ptid_t ptid
, const struct btrace_config
*conf
)
14164 struct btrace_target_info
*tinfo
= NULL
;
14165 struct packet_config
*packet
= NULL
;
14166 struct remote_state
*rs
= get_remote_state ();
14167 char *buf
= rs
->buf
.data ();
14168 char *endbuf
= buf
+ get_remote_packet_size ();
14170 switch (conf
->format
)
14172 case BTRACE_FORMAT_BTS
:
14173 packet
= &remote_protocol_packets
[PACKET_Qbtrace_bts
];
14176 case BTRACE_FORMAT_PT
:
14177 packet
= &remote_protocol_packets
[PACKET_Qbtrace_pt
];
14181 if (packet
== NULL
|| packet_config_support (packet
) != PACKET_ENABLE
)
14182 error (_("Target does not support branch tracing."));
14184 btrace_sync_conf (conf
);
14186 set_general_thread (ptid
);
14188 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
14190 getpkt (&rs
->buf
, 0);
14192 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
14194 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
14195 error (_("Could not enable branch tracing for %s: %s"),
14196 target_pid_to_str (ptid
).c_str (), &rs
->buf
[2]);
14198 error (_("Could not enable branch tracing for %s."),
14199 target_pid_to_str (ptid
).c_str ());
14202 tinfo
= XCNEW (struct btrace_target_info
);
14203 tinfo
->ptid
= ptid
;
14205 /* If we fail to read the configuration, we lose some information, but the
14206 tracing itself is not impacted. */
14209 btrace_read_config (&tinfo
->conf
);
14211 catch (const gdb_exception_error
&err
)
14213 if (err
.message
!= NULL
)
14214 warning ("%s", err
.what ());
14220 /* Disable branch tracing. */
14223 remote_target::disable_btrace (struct btrace_target_info
*tinfo
)
14225 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_Qbtrace_off
];
14226 struct remote_state
*rs
= get_remote_state ();
14227 char *buf
= rs
->buf
.data ();
14228 char *endbuf
= buf
+ get_remote_packet_size ();
14230 if (packet_config_support (packet
) != PACKET_ENABLE
)
14231 error (_("Target does not support branch tracing."));
14233 set_general_thread (tinfo
->ptid
);
14235 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
14237 getpkt (&rs
->buf
, 0);
14239 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
14241 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
14242 error (_("Could not disable branch tracing for %s: %s"),
14243 target_pid_to_str (tinfo
->ptid
).c_str (), &rs
->buf
[2]);
14245 error (_("Could not disable branch tracing for %s."),
14246 target_pid_to_str (tinfo
->ptid
).c_str ());
14252 /* Teardown branch tracing. */
14255 remote_target::teardown_btrace (struct btrace_target_info
*tinfo
)
14257 /* We must not talk to the target during teardown. */
14261 /* Read the branch trace. */
14264 remote_target::read_btrace (struct btrace_data
*btrace
,
14265 struct btrace_target_info
*tinfo
,
14266 enum btrace_read_type type
)
14268 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_qXfer_btrace
];
14271 if (packet_config_support (packet
) != PACKET_ENABLE
)
14272 error (_("Target does not support branch tracing."));
14274 #if !defined(HAVE_LIBEXPAT)
14275 error (_("Cannot process branch tracing result. XML parsing not supported."));
14280 case BTRACE_READ_ALL
:
14283 case BTRACE_READ_NEW
:
14286 case BTRACE_READ_DELTA
:
14290 internal_error (__FILE__
, __LINE__
,
14291 _("Bad branch tracing read type: %u."),
14292 (unsigned int) type
);
14295 gdb::optional
<gdb::char_vector
> xml
14296 = target_read_stralloc (current_inferior ()->top_target (),
14297 TARGET_OBJECT_BTRACE
, annex
);
14299 return BTRACE_ERR_UNKNOWN
;
14301 parse_xml_btrace (btrace
, xml
->data ());
14303 return BTRACE_ERR_NONE
;
14306 const struct btrace_config
*
14307 remote_target::btrace_conf (const struct btrace_target_info
*tinfo
)
14309 return &tinfo
->conf
;
14313 remote_target::augmented_libraries_svr4_read ()
14315 return (packet_support (PACKET_augmented_libraries_svr4_read_feature
)
14319 /* Implementation of to_load. */
14322 remote_target::load (const char *name
, int from_tty
)
14324 generic_load (name
, from_tty
);
14327 /* Accepts an integer PID; returns a string representing a file that
14328 can be opened on the remote side to get the symbols for the child
14329 process. Returns NULL if the operation is not supported. */
14332 remote_target::pid_to_exec_file (int pid
)
14334 static gdb::optional
<gdb::char_vector
> filename
;
14335 char *annex
= NULL
;
14337 if (packet_support (PACKET_qXfer_exec_file
) != PACKET_ENABLE
)
14340 inferior
*inf
= find_inferior_pid (this, pid
);
14342 internal_error (__FILE__
, __LINE__
,
14343 _("not currently attached to process %d"), pid
);
14345 if (!inf
->fake_pid_p
)
14347 const int annex_size
= 9;
14349 annex
= (char *) alloca (annex_size
);
14350 xsnprintf (annex
, annex_size
, "%x", pid
);
14353 filename
= target_read_stralloc (current_inferior ()->top_target (),
14354 TARGET_OBJECT_EXEC_FILE
, annex
);
14356 return filename
? filename
->data () : nullptr;
14359 /* Implement the to_can_do_single_step target_ops method. */
14362 remote_target::can_do_single_step ()
14364 /* We can only tell whether target supports single step or not by
14365 supported s and S vCont actions if the stub supports vContSupported
14366 feature. If the stub doesn't support vContSupported feature,
14367 we have conservatively to think target doesn't supports single
14369 if (packet_support (PACKET_vContSupported
) == PACKET_ENABLE
)
14371 struct remote_state
*rs
= get_remote_state ();
14373 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
14374 remote_vcont_probe ();
14376 return rs
->supports_vCont
.s
&& rs
->supports_vCont
.S
;
14382 /* Implementation of the to_execution_direction method for the remote
14385 enum exec_direction_kind
14386 remote_target::execution_direction ()
14388 struct remote_state
*rs
= get_remote_state ();
14390 return rs
->last_resume_exec_dir
;
14393 /* Return pointer to the thread_info struct which corresponds to
14394 THREAD_HANDLE (having length HANDLE_LEN). */
14397 remote_target::thread_handle_to_thread_info (const gdb_byte
*thread_handle
,
14401 for (thread_info
*tp
: all_non_exited_threads (this))
14403 remote_thread_info
*priv
= get_remote_thread_info (tp
);
14405 if (tp
->inf
== inf
&& priv
!= NULL
)
14407 if (handle_len
!= priv
->thread_handle
.size ())
14408 error (_("Thread handle size mismatch: %d vs %zu (from remote)"),
14409 handle_len
, priv
->thread_handle
.size ());
14410 if (memcmp (thread_handle
, priv
->thread_handle
.data (),
14420 remote_target::thread_info_to_thread_handle (struct thread_info
*tp
)
14422 remote_thread_info
*priv
= get_remote_thread_info (tp
);
14423 return priv
->thread_handle
;
14427 remote_target::can_async_p ()
14429 /* This flag should be checked in the common target.c code. */
14430 gdb_assert (target_async_permitted
);
14432 /* We're async whenever the serial device can. */
14433 struct remote_state
*rs
= get_remote_state ();
14434 return serial_can_async_p (rs
->remote_desc
);
14438 remote_target::is_async_p ()
14440 /* We're async whenever the serial device is. */
14441 struct remote_state
*rs
= get_remote_state ();
14442 return serial_is_async_p (rs
->remote_desc
);
14445 /* Pass the SERIAL event on and up to the client. One day this code
14446 will be able to delay notifying the client of an event until the
14447 point where an entire packet has been received. */
14449 static serial_event_ftype remote_async_serial_handler
;
14452 remote_async_serial_handler (struct serial
*scb
, void *context
)
14454 /* Don't propogate error information up to the client. Instead let
14455 the client find out about the error by querying the target. */
14456 inferior_event_handler (INF_REG_EVENT
);
14460 remote_async_inferior_event_handler (gdb_client_data data
)
14462 inferior_event_handler (INF_REG_EVENT
);
14466 remote_target::async_wait_fd ()
14468 struct remote_state
*rs
= get_remote_state ();
14469 return rs
->remote_desc
->fd
;
14473 remote_target::async (int enable
)
14475 struct remote_state
*rs
= get_remote_state ();
14479 serial_async (rs
->remote_desc
, remote_async_serial_handler
, rs
);
14481 /* If there are pending events in the stop reply queue tell the
14482 event loop to process them. */
14483 if (!rs
->stop_reply_queue
.empty ())
14484 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
14485 /* For simplicity, below we clear the pending events token
14486 without remembering whether it is marked, so here we always
14487 mark it. If there's actually no pending notification to
14488 process, this ends up being a no-op (other than a spurious
14489 event-loop wakeup). */
14490 if (target_is_non_stop_p ())
14491 mark_async_event_handler (rs
->notif_state
->get_pending_events_token
);
14495 serial_async (rs
->remote_desc
, NULL
, NULL
);
14496 /* If the core is disabling async, it doesn't want to be
14497 disturbed with target events. Clear all async event sources
14499 clear_async_event_handler (rs
->remote_async_inferior_event_token
);
14500 if (target_is_non_stop_p ())
14501 clear_async_event_handler (rs
->notif_state
->get_pending_events_token
);
14505 /* Implementation of the to_thread_events method. */
14508 remote_target::thread_events (int enable
)
14510 struct remote_state
*rs
= get_remote_state ();
14511 size_t size
= get_remote_packet_size ();
14513 if (packet_support (PACKET_QThreadEvents
) == PACKET_DISABLE
)
14516 xsnprintf (rs
->buf
.data (), size
, "QThreadEvents:%x", enable
? 1 : 0);
14518 getpkt (&rs
->buf
, 0);
14520 switch (packet_ok (rs
->buf
,
14521 &remote_protocol_packets
[PACKET_QThreadEvents
]))
14524 if (strcmp (rs
->buf
.data (), "OK") != 0)
14525 error (_("Remote refused setting thread events: %s"), rs
->buf
.data ());
14528 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
14530 case PACKET_UNKNOWN
:
14536 show_remote_cmd (const char *args
, int from_tty
)
14538 /* We can't just use cmd_show_list here, because we want to skip
14539 the redundant "show remote Z-packet" and the legacy aliases. */
14540 struct cmd_list_element
*list
= remote_show_cmdlist
;
14541 struct ui_out
*uiout
= current_uiout
;
14543 ui_out_emit_tuple
tuple_emitter (uiout
, "showlist");
14544 for (; list
!= NULL
; list
= list
->next
)
14545 if (strcmp (list
->name
, "Z-packet") == 0)
14547 else if (list
->type
== not_set_cmd
)
14548 /* Alias commands are exactly like the original, except they
14549 don't have the normal type. */
14553 ui_out_emit_tuple
option_emitter (uiout
, "option");
14555 uiout
->field_string ("name", list
->name
);
14556 uiout
->text (": ");
14557 if (list
->type
== show_cmd
)
14558 do_show_command (NULL
, from_tty
, list
);
14560 cmd_func (list
, NULL
, from_tty
);
14565 /* Function to be called whenever a new objfile (shlib) is detected. */
14567 remote_new_objfile (struct objfile
*objfile
)
14569 remote_target
*remote
= get_current_remote_target ();
14571 /* First, check whether the current inferior's process target is a remote
14573 if (remote
== nullptr)
14576 /* When we are attaching or handling a fork child and the shared library
14577 subsystem reads the list of loaded libraries, we receive new objfile
14578 events in between each found library. The libraries are read in an
14579 undefined order, so if we gave the remote side a chance to look up
14580 symbols between each objfile, we might give it an inconsistent picture
14581 of the inferior. It could appear that a library A appears loaded but
14582 a library B does not, even though library A requires library B. That
14583 would present a state that couldn't normally exist in the inferior.
14585 So, skip these events, we'll give the remote a chance to look up symbols
14586 once all the loaded libraries and their symbols are known to GDB. */
14587 if (current_inferior ()->in_initial_library_scan
)
14590 remote
->remote_check_symbols ();
14593 /* Pull all the tracepoints defined on the target and create local
14594 data structures representing them. We don't want to create real
14595 tracepoints yet, we don't want to mess up the user's existing
14599 remote_target::upload_tracepoints (struct uploaded_tp
**utpp
)
14601 struct remote_state
*rs
= get_remote_state ();
14604 /* Ask for a first packet of tracepoint definition. */
14606 getpkt (&rs
->buf
, 0);
14607 p
= rs
->buf
.data ();
14608 while (*p
&& *p
!= 'l')
14610 parse_tracepoint_definition (p
, utpp
);
14611 /* Ask for another packet of tracepoint definition. */
14613 getpkt (&rs
->buf
, 0);
14614 p
= rs
->buf
.data ();
14620 remote_target::upload_trace_state_variables (struct uploaded_tsv
**utsvp
)
14622 struct remote_state
*rs
= get_remote_state ();
14625 /* Ask for a first packet of variable definition. */
14627 getpkt (&rs
->buf
, 0);
14628 p
= rs
->buf
.data ();
14629 while (*p
&& *p
!= 'l')
14631 parse_tsv_definition (p
, utsvp
);
14632 /* Ask for another packet of variable definition. */
14634 getpkt (&rs
->buf
, 0);
14635 p
= rs
->buf
.data ();
14640 /* The "set/show range-stepping" show hook. */
14643 show_range_stepping (struct ui_file
*file
, int from_tty
,
14644 struct cmd_list_element
*c
,
14647 fprintf_filtered (file
,
14648 _("Debugger's willingness to use range stepping "
14649 "is %s.\n"), value
);
14652 /* Return true if the vCont;r action is supported by the remote
14656 remote_target::vcont_r_supported ()
14658 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
14659 remote_vcont_probe ();
14661 return (packet_support (PACKET_vCont
) == PACKET_ENABLE
14662 && get_remote_state ()->supports_vCont
.r
);
14665 /* The "set/show range-stepping" set hook. */
14668 set_range_stepping (const char *ignore_args
, int from_tty
,
14669 struct cmd_list_element
*c
)
14671 /* When enabling, check whether range stepping is actually supported
14672 by the target, and warn if not. */
14673 if (use_range_stepping
)
14675 remote_target
*remote
= get_current_remote_target ();
14677 || !remote
->vcont_r_supported ())
14678 warning (_("Range stepping is not supported by the current target"));
14683 show_remote_debug (struct ui_file
*file
, int from_tty
,
14684 struct cmd_list_element
*c
, const char *value
)
14686 fprintf_filtered (file
, _("Debugging of remote protocol is %s.\n"),
14691 show_remote_timeout (struct ui_file
*file
, int from_tty
,
14692 struct cmd_list_element
*c
, const char *value
)
14694 fprintf_filtered (file
,
14695 _("Timeout limit to wait for target to respond is %s.\n"),
14699 /* Implement the "supports_memory_tagging" target_ops method. */
14702 remote_target::supports_memory_tagging ()
14704 return remote_memory_tagging_p ();
14707 /* Create the qMemTags packet given ADDRESS, LEN and TYPE. */
14710 create_fetch_memtags_request (gdb::char_vector
&packet
, CORE_ADDR address
,
14711 size_t len
, int type
)
14713 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
14715 std::string request
= string_printf ("qMemTags:%s,%s:%s",
14716 phex_nz (address
, addr_size
),
14717 phex_nz (len
, sizeof (len
)),
14718 phex_nz (type
, sizeof (type
)));
14720 strcpy (packet
.data (), request
.c_str ());
14723 /* Parse the qMemTags packet reply into TAGS.
14725 Return true if successful, false otherwise. */
14728 parse_fetch_memtags_reply (const gdb::char_vector
&reply
,
14729 gdb::byte_vector
&tags
)
14731 if (reply
.empty () || reply
[0] == 'E' || reply
[0] != 'm')
14734 /* Copy the tag data. */
14735 tags
= hex2bin (reply
.data () + 1);
14740 /* Create the QMemTags packet given ADDRESS, LEN, TYPE and TAGS. */
14743 create_store_memtags_request (gdb::char_vector
&packet
, CORE_ADDR address
,
14744 size_t len
, int type
,
14745 const gdb::byte_vector
&tags
)
14747 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
14749 /* Put together the main packet, address and length. */
14750 std::string request
= string_printf ("QMemTags:%s,%s:%s:",
14751 phex_nz (address
, addr_size
),
14752 phex_nz (len
, sizeof (len
)),
14753 phex_nz (type
, sizeof (type
)));
14754 request
+= bin2hex (tags
.data (), tags
.size ());
14756 /* Check if we have exceeded the maximum packet size. */
14757 if (packet
.size () < request
.length ())
14758 error (_("Contents too big for packet QMemTags."));
14760 strcpy (packet
.data (), request
.c_str ());
14763 /* Implement the "fetch_memtags" target_ops method. */
14766 remote_target::fetch_memtags (CORE_ADDR address
, size_t len
,
14767 gdb::byte_vector
&tags
, int type
)
14769 /* Make sure the qMemTags packet is supported. */
14770 if (!remote_memory_tagging_p ())
14771 gdb_assert_not_reached ("remote fetch_memtags called with packet disabled");
14773 struct remote_state
*rs
= get_remote_state ();
14775 create_fetch_memtags_request (rs
->buf
, address
, len
, type
);
14778 getpkt (&rs
->buf
, 0);
14780 return parse_fetch_memtags_reply (rs
->buf
, tags
);
14783 /* Implement the "store_memtags" target_ops method. */
14786 remote_target::store_memtags (CORE_ADDR address
, size_t len
,
14787 const gdb::byte_vector
&tags
, int type
)
14789 /* Make sure the QMemTags packet is supported. */
14790 if (!remote_memory_tagging_p ())
14791 gdb_assert_not_reached ("remote store_memtags called with packet disabled");
14793 struct remote_state
*rs
= get_remote_state ();
14795 create_store_memtags_request (rs
->buf
, address
, len
, type
, tags
);
14798 getpkt (&rs
->buf
, 0);
14800 /* Verify if the request was successful. */
14801 return packet_check_result (rs
->buf
.data ()) == PACKET_OK
;
14804 /* Return true if remote target T is non-stop. */
14807 remote_target_is_non_stop_p (remote_target
*t
)
14809 scoped_restore_current_thread restore_thread
;
14810 switch_to_target_no_thread (t
);
14812 return target_is_non_stop_p ();
14817 namespace selftests
{
14820 test_memory_tagging_functions ()
14822 remote_target remote
;
14824 struct packet_config
*config
14825 = &remote_protocol_packets
[PACKET_memory_tagging_feature
];
14827 scoped_restore restore_memtag_support_
14828 = make_scoped_restore (&config
->support
);
14830 /* Test memory tagging packet support. */
14831 config
->support
= PACKET_SUPPORT_UNKNOWN
;
14832 SELF_CHECK (remote
.supports_memory_tagging () == false);
14833 config
->support
= PACKET_DISABLE
;
14834 SELF_CHECK (remote
.supports_memory_tagging () == false);
14835 config
->support
= PACKET_ENABLE
;
14836 SELF_CHECK (remote
.supports_memory_tagging () == true);
14838 /* Setup testing. */
14839 gdb::char_vector packet
;
14840 gdb::byte_vector tags
, bv
;
14841 std::string expected
, reply
;
14842 packet
.resize (32000);
14844 /* Test creating a qMemTags request. */
14846 expected
= "qMemTags:0,0:0";
14847 create_fetch_memtags_request (packet
, 0x0, 0x0, 0);
14848 SELF_CHECK (strcmp (packet
.data (), expected
.c_str ()) == 0);
14850 expected
= "qMemTags:deadbeef,10:1";
14851 create_fetch_memtags_request (packet
, 0xdeadbeef, 16, 1);
14852 SELF_CHECK (strcmp (packet
.data (), expected
.c_str ()) == 0);
14854 /* Test parsing a qMemTags reply. */
14856 /* Error reply, tags vector unmodified. */
14858 strcpy (packet
.data (), reply
.c_str ());
14860 SELF_CHECK (parse_fetch_memtags_reply (packet
, tags
) == false);
14861 SELF_CHECK (tags
.size () == 0);
14863 /* Valid reply, tags vector updated. */
14867 for (int i
= 0; i
< 5; i
++)
14870 reply
= "m" + bin2hex (bv
.data (), bv
.size ());
14871 strcpy (packet
.data (), reply
.c_str ());
14873 SELF_CHECK (parse_fetch_memtags_reply (packet
, tags
) == true);
14874 SELF_CHECK (tags
.size () == 5);
14876 for (int i
= 0; i
< 5; i
++)
14877 SELF_CHECK (tags
[i
] == i
);
14879 /* Test creating a QMemTags request. */
14881 /* Empty tag data. */
14883 expected
= "QMemTags:0,0:0:";
14884 create_store_memtags_request (packet
, 0x0, 0x0, 0, tags
);
14885 SELF_CHECK (memcmp (packet
.data (), expected
.c_str (),
14886 expected
.length ()) == 0);
14888 /* Non-empty tag data. */
14890 for (int i
= 0; i
< 5; i
++)
14891 tags
.push_back (i
);
14892 expected
= "QMemTags:deadbeef,ff:1:0001020304";
14893 create_store_memtags_request (packet
, 0xdeadbeef, 255, 1, tags
);
14894 SELF_CHECK (memcmp (packet
.data (), expected
.c_str (),
14895 expected
.length ()) == 0);
14898 } // namespace selftests
14899 #endif /* GDB_SELF_TEST */
14901 void _initialize_remote ();
14903 _initialize_remote ()
14905 /* architecture specific data */
14906 remote_g_packet_data_handle
=
14907 gdbarch_data_register_pre_init (remote_g_packet_data_init
);
14909 add_target (remote_target_info
, remote_target::open
);
14910 add_target (extended_remote_target_info
, extended_remote_target::open
);
14912 /* Hook into new objfile notification. */
14913 gdb::observers::new_objfile
.attach (remote_new_objfile
, "remote");
14916 init_remote_threadtests ();
14919 /* set/show remote ... */
14921 add_basic_prefix_cmd ("remote", class_maintenance
, _("\
14922 Remote protocol specific variables.\n\
14923 Configure various remote-protocol specific variables such as\n\
14924 the packets being used."),
14925 &remote_set_cmdlist
,
14926 0 /* allow-unknown */, &setlist
);
14927 add_prefix_cmd ("remote", class_maintenance
, show_remote_cmd
, _("\
14928 Remote protocol specific variables.\n\
14929 Configure various remote-protocol specific variables such as\n\
14930 the packets being used."),
14931 &remote_show_cmdlist
,
14932 0 /* allow-unknown */, &showlist
);
14934 add_cmd ("compare-sections", class_obscure
, compare_sections_command
, _("\
14935 Compare section data on target to the exec file.\n\
14936 Argument is a single section name (default: all loaded sections).\n\
14937 To compare only read-only loaded sections, specify the -r option."),
14940 add_cmd ("packet", class_maintenance
, cli_packet_command
, _("\
14941 Send an arbitrary packet to a remote target.\n\
14942 maintenance packet TEXT\n\
14943 If GDB is talking to an inferior via the GDB serial protocol, then\n\
14944 this command sends the string TEXT to the inferior, and displays the\n\
14945 response packet. GDB supplies the initial `$' character, and the\n\
14946 terminating `#' character and checksum."),
14949 set_show_commands remotebreak_cmds
14950 = add_setshow_boolean_cmd ("remotebreak", no_class
, &remote_break
, _("\
14951 Set whether to send break if interrupted."), _("\
14952 Show whether to send break if interrupted."), _("\
14953 If set, a break, instead of a cntrl-c, is sent to the remote target."),
14954 set_remotebreak
, show_remotebreak
,
14955 &setlist
, &showlist
);
14956 deprecate_cmd (remotebreak_cmds
.set
, "set remote interrupt-sequence");
14957 deprecate_cmd (remotebreak_cmds
.show
, "show remote interrupt-sequence");
14959 add_setshow_enum_cmd ("interrupt-sequence", class_support
,
14960 interrupt_sequence_modes
, &interrupt_sequence_mode
,
14962 Set interrupt sequence to remote target."), _("\
14963 Show interrupt sequence to remote target."), _("\
14964 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
14965 NULL
, show_interrupt_sequence
,
14966 &remote_set_cmdlist
,
14967 &remote_show_cmdlist
);
14969 add_setshow_boolean_cmd ("interrupt-on-connect", class_support
,
14970 &interrupt_on_connect
, _("\
14971 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _("\
14972 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _("\
14973 If set, interrupt sequence is sent to remote target."),
14975 &remote_set_cmdlist
, &remote_show_cmdlist
);
14977 /* Install commands for configuring memory read/write packets. */
14979 add_cmd ("remotewritesize", no_class
, set_memory_write_packet_size
, _("\
14980 Set the maximum number of bytes per memory write packet (deprecated)."),
14982 add_cmd ("remotewritesize", no_class
, show_memory_write_packet_size
, _("\
14983 Show the maximum number of bytes per memory write packet (deprecated)."),
14985 add_cmd ("memory-write-packet-size", no_class
,
14986 set_memory_write_packet_size
, _("\
14987 Set the maximum number of bytes per memory-write packet.\n\
14988 Specify the number of bytes in a packet or 0 (zero) for the\n\
14989 default packet size. The actual limit is further reduced\n\
14990 dependent on the target. Specify ``fixed'' to disable the\n\
14991 further restriction and ``limit'' to enable that restriction."),
14992 &remote_set_cmdlist
);
14993 add_cmd ("memory-read-packet-size", no_class
,
14994 set_memory_read_packet_size
, _("\
14995 Set the maximum number of bytes per memory-read packet.\n\
14996 Specify the number of bytes in a packet or 0 (zero) for the\n\
14997 default packet size. The actual limit is further reduced\n\
14998 dependent on the target. Specify ``fixed'' to disable the\n\
14999 further restriction and ``limit'' to enable that restriction."),
15000 &remote_set_cmdlist
);
15001 add_cmd ("memory-write-packet-size", no_class
,
15002 show_memory_write_packet_size
,
15003 _("Show the maximum number of bytes per memory-write packet."),
15004 &remote_show_cmdlist
);
15005 add_cmd ("memory-read-packet-size", no_class
,
15006 show_memory_read_packet_size
,
15007 _("Show the maximum number of bytes per memory-read packet."),
15008 &remote_show_cmdlist
);
15010 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-limit", no_class
,
15011 &remote_hw_watchpoint_limit
, _("\
15012 Set the maximum number of target hardware watchpoints."), _("\
15013 Show the maximum number of target hardware watchpoints."), _("\
15014 Specify \"unlimited\" for unlimited hardware watchpoints."),
15015 NULL
, show_hardware_watchpoint_limit
,
15016 &remote_set_cmdlist
,
15017 &remote_show_cmdlist
);
15018 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-length-limit",
15020 &remote_hw_watchpoint_length_limit
, _("\
15021 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
15022 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
15023 Specify \"unlimited\" to allow watchpoints of unlimited size."),
15024 NULL
, show_hardware_watchpoint_length_limit
,
15025 &remote_set_cmdlist
, &remote_show_cmdlist
);
15026 add_setshow_zuinteger_unlimited_cmd ("hardware-breakpoint-limit", no_class
,
15027 &remote_hw_breakpoint_limit
, _("\
15028 Set the maximum number of target hardware breakpoints."), _("\
15029 Show the maximum number of target hardware breakpoints."), _("\
15030 Specify \"unlimited\" for unlimited hardware breakpoints."),
15031 NULL
, show_hardware_breakpoint_limit
,
15032 &remote_set_cmdlist
, &remote_show_cmdlist
);
15034 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure
,
15035 &remote_address_size
, _("\
15036 Set the maximum size of the address (in bits) in a memory packet."), _("\
15037 Show the maximum size of the address (in bits) in a memory packet."), NULL
,
15039 NULL
, /* FIXME: i18n: */
15040 &setlist
, &showlist
);
15042 init_all_packet_configs ();
15044 add_packet_config_cmd (&remote_protocol_packets
[PACKET_X
],
15045 "X", "binary-download", 1);
15047 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCont
],
15048 "vCont", "verbose-resume", 0);
15050 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QPassSignals
],
15051 "QPassSignals", "pass-signals", 0);
15053 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QCatchSyscalls
],
15054 "QCatchSyscalls", "catch-syscalls", 0);
15056 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QProgramSignals
],
15057 "QProgramSignals", "program-signals", 0);
15059 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QSetWorkingDir
],
15060 "QSetWorkingDir", "set-working-dir", 0);
15062 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartupWithShell
],
15063 "QStartupWithShell", "startup-with-shell", 0);
15065 add_packet_config_cmd (&remote_protocol_packets
15066 [PACKET_QEnvironmentHexEncoded
],
15067 "QEnvironmentHexEncoded", "environment-hex-encoded",
15070 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QEnvironmentReset
],
15071 "QEnvironmentReset", "environment-reset",
15074 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QEnvironmentUnset
],
15075 "QEnvironmentUnset", "environment-unset",
15078 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSymbol
],
15079 "qSymbol", "symbol-lookup", 0);
15081 add_packet_config_cmd (&remote_protocol_packets
[PACKET_P
],
15082 "P", "set-register", 1);
15084 add_packet_config_cmd (&remote_protocol_packets
[PACKET_p
],
15085 "p", "fetch-register", 1);
15087 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
],
15088 "Z0", "software-breakpoint", 0);
15090 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z1
],
15091 "Z1", "hardware-breakpoint", 0);
15093 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z2
],
15094 "Z2", "write-watchpoint", 0);
15096 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z3
],
15097 "Z3", "read-watchpoint", 0);
15099 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z4
],
15100 "Z4", "access-watchpoint", 0);
15102 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_auxv
],
15103 "qXfer:auxv:read", "read-aux-vector", 0);
15105 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_exec_file
],
15106 "qXfer:exec-file:read", "pid-to-exec-file", 0);
15108 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_features
],
15109 "qXfer:features:read", "target-features", 0);
15111 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries
],
15112 "qXfer:libraries:read", "library-info", 0);
15114 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries_svr4
],
15115 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
15117 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_memory_map
],
15118 "qXfer:memory-map:read", "memory-map", 0);
15120 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_osdata
],
15121 "qXfer:osdata:read", "osdata", 0);
15123 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_threads
],
15124 "qXfer:threads:read", "threads", 0);
15126 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_read
],
15127 "qXfer:siginfo:read", "read-siginfo-object", 0);
15129 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_write
],
15130 "qXfer:siginfo:write", "write-siginfo-object", 0);
15132 add_packet_config_cmd
15133 (&remote_protocol_packets
[PACKET_qXfer_traceframe_info
],
15134 "qXfer:traceframe-info:read", "traceframe-info", 0);
15136 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_uib
],
15137 "qXfer:uib:read", "unwind-info-block", 0);
15139 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTLSAddr
],
15140 "qGetTLSAddr", "get-thread-local-storage-address",
15143 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTIBAddr
],
15144 "qGetTIBAddr", "get-thread-information-block-address",
15147 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bc
],
15148 "bc", "reverse-continue", 0);
15150 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bs
],
15151 "bs", "reverse-step", 0);
15153 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSupported
],
15154 "qSupported", "supported-packets", 0);
15156 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSearch_memory
],
15157 "qSearch:memory", "search-memory", 0);
15159 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qTStatus
],
15160 "qTStatus", "trace-status", 0);
15162 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_setfs
],
15163 "vFile:setfs", "hostio-setfs", 0);
15165 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_open
],
15166 "vFile:open", "hostio-open", 0);
15168 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pread
],
15169 "vFile:pread", "hostio-pread", 0);
15171 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pwrite
],
15172 "vFile:pwrite", "hostio-pwrite", 0);
15174 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_close
],
15175 "vFile:close", "hostio-close", 0);
15177 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_unlink
],
15178 "vFile:unlink", "hostio-unlink", 0);
15180 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_readlink
],
15181 "vFile:readlink", "hostio-readlink", 0);
15183 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_fstat
],
15184 "vFile:fstat", "hostio-fstat", 0);
15186 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vAttach
],
15187 "vAttach", "attach", 0);
15189 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vRun
],
15192 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartNoAckMode
],
15193 "QStartNoAckMode", "noack", 0);
15195 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vKill
],
15196 "vKill", "kill", 0);
15198 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qAttached
],
15199 "qAttached", "query-attached", 0);
15201 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalTracepoints
],
15202 "ConditionalTracepoints",
15203 "conditional-tracepoints", 0);
15205 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalBreakpoints
],
15206 "ConditionalBreakpoints",
15207 "conditional-breakpoints", 0);
15209 add_packet_config_cmd (&remote_protocol_packets
[PACKET_BreakpointCommands
],
15210 "BreakpointCommands",
15211 "breakpoint-commands", 0);
15213 add_packet_config_cmd (&remote_protocol_packets
[PACKET_FastTracepoints
],
15214 "FastTracepoints", "fast-tracepoints", 0);
15216 add_packet_config_cmd (&remote_protocol_packets
[PACKET_TracepointSource
],
15217 "TracepointSource", "TracepointSource", 0);
15219 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAllow
],
15220 "QAllow", "allow", 0);
15222 add_packet_config_cmd (&remote_protocol_packets
[PACKET_StaticTracepoints
],
15223 "StaticTracepoints", "static-tracepoints", 0);
15225 add_packet_config_cmd (&remote_protocol_packets
[PACKET_InstallInTrace
],
15226 "InstallInTrace", "install-in-trace", 0);
15228 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_statictrace_read
],
15229 "qXfer:statictrace:read", "read-sdata-object", 0);
15231 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_fdpic
],
15232 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
15234 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QDisableRandomization
],
15235 "QDisableRandomization", "disable-randomization", 0);
15237 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAgent
],
15238 "QAgent", "agent", 0);
15240 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QTBuffer_size
],
15241 "QTBuffer:size", "trace-buffer-size", 0);
15243 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_off
],
15244 "Qbtrace:off", "disable-btrace", 0);
15246 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_bts
],
15247 "Qbtrace:bts", "enable-btrace-bts", 0);
15249 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_pt
],
15250 "Qbtrace:pt", "enable-btrace-pt", 0);
15252 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace
],
15253 "qXfer:btrace", "read-btrace", 0);
15255 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace_conf
],
15256 "qXfer:btrace-conf", "read-btrace-conf", 0);
15258 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_conf_bts_size
],
15259 "Qbtrace-conf:bts:size", "btrace-conf-bts-size", 0);
15261 add_packet_config_cmd (&remote_protocol_packets
[PACKET_multiprocess_feature
],
15262 "multiprocess-feature", "multiprocess-feature", 0);
15264 add_packet_config_cmd (&remote_protocol_packets
[PACKET_swbreak_feature
],
15265 "swbreak-feature", "swbreak-feature", 0);
15267 add_packet_config_cmd (&remote_protocol_packets
[PACKET_hwbreak_feature
],
15268 "hwbreak-feature", "hwbreak-feature", 0);
15270 add_packet_config_cmd (&remote_protocol_packets
[PACKET_fork_event_feature
],
15271 "fork-event-feature", "fork-event-feature", 0);
15273 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vfork_event_feature
],
15274 "vfork-event-feature", "vfork-event-feature", 0);
15276 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_conf_pt_size
],
15277 "Qbtrace-conf:pt:size", "btrace-conf-pt-size", 0);
15279 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vContSupported
],
15280 "vContSupported", "verbose-resume-supported", 0);
15282 add_packet_config_cmd (&remote_protocol_packets
[PACKET_exec_event_feature
],
15283 "exec-event-feature", "exec-event-feature", 0);
15285 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCtrlC
],
15286 "vCtrlC", "ctrl-c", 0);
15288 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QThreadEvents
],
15289 "QThreadEvents", "thread-events", 0);
15291 add_packet_config_cmd (&remote_protocol_packets
[PACKET_no_resumed
],
15292 "N stop reply", "no-resumed-stop-reply", 0);
15294 add_packet_config_cmd (&remote_protocol_packets
[PACKET_memory_tagging_feature
],
15295 "memory-tagging-feature", "memory-tagging-feature", 0);
15297 /* Assert that we've registered "set remote foo-packet" commands
15298 for all packet configs. */
15302 for (i
= 0; i
< PACKET_MAX
; i
++)
15304 /* Ideally all configs would have a command associated. Some
15305 still don't though. */
15310 case PACKET_QNonStop
:
15311 case PACKET_EnableDisableTracepoints_feature
:
15312 case PACKET_tracenz_feature
:
15313 case PACKET_DisconnectedTracing_feature
:
15314 case PACKET_augmented_libraries_svr4_read_feature
:
15316 /* Additions to this list need to be well justified:
15317 pre-existing packets are OK; new packets are not. */
15325 /* This catches both forgetting to add a config command, and
15326 forgetting to remove a packet from the exception list. */
15327 gdb_assert (excepted
== (remote_protocol_packets
[i
].name
== NULL
));
15331 /* Keep the old ``set remote Z-packet ...'' working. Each individual
15332 Z sub-packet has its own set and show commands, but users may
15333 have sets to this variable in their .gdbinit files (or in their
15335 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure
,
15336 &remote_Z_packet_detect
, _("\
15337 Set use of remote protocol `Z' packets."), _("\
15338 Show use of remote protocol `Z' packets."), _("\
15339 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
15341 set_remote_protocol_Z_packet_cmd
,
15342 show_remote_protocol_Z_packet_cmd
,
15343 /* FIXME: i18n: Use of remote protocol
15344 `Z' packets is %s. */
15345 &remote_set_cmdlist
, &remote_show_cmdlist
);
15347 add_basic_prefix_cmd ("remote", class_files
, _("\
15348 Manipulate files on the remote system.\n\
15349 Transfer files to and from the remote target system."),
15351 0 /* allow-unknown */, &cmdlist
);
15353 add_cmd ("put", class_files
, remote_put_command
,
15354 _("Copy a local file to the remote system."),
15357 add_cmd ("get", class_files
, remote_get_command
,
15358 _("Copy a remote file to the local system."),
15361 add_cmd ("delete", class_files
, remote_delete_command
,
15362 _("Delete a remote file."),
15365 add_setshow_string_noescape_cmd ("exec-file", class_files
,
15366 &remote_exec_file_var
, _("\
15367 Set the remote pathname for \"run\"."), _("\
15368 Show the remote pathname for \"run\"."), NULL
,
15369 set_remote_exec_file
,
15370 show_remote_exec_file
,
15371 &remote_set_cmdlist
,
15372 &remote_show_cmdlist
);
15374 add_setshow_boolean_cmd ("range-stepping", class_run
,
15375 &use_range_stepping
, _("\
15376 Enable or disable range stepping."), _("\
15377 Show whether target-assisted range stepping is enabled."), _("\
15378 If on, and the target supports it, when stepping a source line, GDB\n\
15379 tells the target to step the corresponding range of addresses itself instead\n\
15380 of issuing multiple single-steps. This speeds up source level\n\
15381 stepping. If off, GDB always issues single-steps, even if range\n\
15382 stepping is supported by the target. The default is on."),
15383 set_range_stepping
,
15384 show_range_stepping
,
15388 add_setshow_zinteger_cmd ("watchdog", class_maintenance
, &watchdog
, _("\
15389 Set watchdog timer."), _("\
15390 Show watchdog timer."), _("\
15391 When non-zero, this timeout is used instead of waiting forever for a target\n\
15392 to finish a low-level step or continue operation. If the specified amount\n\
15393 of time passes without a response from the target, an error occurs."),
15396 &setlist
, &showlist
);
15398 add_setshow_zuinteger_unlimited_cmd ("remote-packet-max-chars", no_class
,
15399 &remote_packet_max_chars
, _("\
15400 Set the maximum number of characters to display for each remote packet."), _("\
15401 Show the maximum number of characters to display for each remote packet."), _("\
15402 Specify \"unlimited\" to display all the characters."),
15403 NULL
, show_remote_packet_max_chars
,
15404 &setdebuglist
, &showdebuglist
);
15406 add_setshow_boolean_cmd ("remote", no_class
, &remote_debug
,
15407 _("Set debugging of remote protocol."),
15408 _("Show debugging of remote protocol."),
15410 When enabled, each packet sent or received with the remote target\n\
15414 &setdebuglist
, &showdebuglist
);
15416 add_setshow_zuinteger_unlimited_cmd ("remotetimeout", no_class
,
15417 &remote_timeout
, _("\
15418 Set timeout limit to wait for target to respond."), _("\
15419 Show timeout limit to wait for target to respond."), _("\
15420 This value is used to set the time limit for gdb to wait for a response\n\
15421 from the target."),
15423 show_remote_timeout
,
15424 &setlist
, &showlist
);
15426 /* Eventually initialize fileio. See fileio.c */
15427 initialize_remote_fileio (&remote_set_cmdlist
, &remote_show_cmdlist
);
15430 selftests::register_test ("remote_memory_tagging",
15431 selftests::test_memory_tagging_functions
);