1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2022 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
20 /* See the GDB User Guide for details of the GDB remote protocol. */
30 #include "process-stratum-target.h"
33 #include "gdb-stabs.h"
34 #include "gdbthread.h"
36 #include "remote-notif.h"
39 #include "observable.h"
41 #include "cli/cli-decode.h"
42 #include "cli/cli-setshow.h"
43 #include "target-descriptions.h"
45 #include "gdbsupport/filestuff.h"
46 #include "gdbsupport/rsp-low.h"
50 #include "gdbsupport/gdb_sys_time.h"
52 #include "gdbsupport/event-loop.h"
53 #include "event-top.h"
61 #include "remote-fileio.h"
62 #include "gdb/fileio.h"
64 #include "xml-support.h"
66 #include "memory-map.h"
68 #include "tracepoint.h"
71 #include "gdbsupport/agent.h"
73 #include "record-btrace.h"
75 #include "gdbsupport/scoped_restore.h"
76 #include "gdbsupport/environ.h"
77 #include "gdbsupport/byte-vector.h"
78 #include "gdbsupport/search.h"
80 #include <unordered_map>
81 #include "async-event.h"
82 #include "gdbsupport/selftest.h"
84 /* The remote target. */
86 static const char remote_doc
[] = N_("\
87 Use a remote computer via a serial line, using a gdb-specific protocol.\n\
88 Specify the serial device it is connected to\n\
89 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).");
93 bool remote_debug
= false;
95 #define OPAQUETHREADBYTES 8
97 /* a 64 bit opaque identifier */
98 typedef unsigned char threadref
[OPAQUETHREADBYTES
];
100 struct gdb_ext_thread_info
;
101 struct threads_listing_context
;
102 typedef int (*rmt_thread_action
) (threadref
*ref
, void *context
);
103 struct protocol_feature
;
107 typedef std::unique_ptr
<stop_reply
> stop_reply_up
;
109 /* Generic configuration support for packets the stub optionally
110 supports. Allows the user to specify the use of the packet as well
111 as allowing GDB to auto-detect support in the remote stub. */
115 PACKET_SUPPORT_UNKNOWN
= 0,
120 /* Analyze a packet's return value and update the packet config
130 struct threads_listing_context
;
132 /* Stub vCont actions support.
134 Each field is a boolean flag indicating whether the stub reports
135 support for the corresponding action. */
137 struct vCont_action_support
152 /* About this many threadids fit in a packet. */
154 #define MAXTHREADLISTRESULTS 32
156 /* Data for the vFile:pread readahead cache. */
158 struct readahead_cache
160 /* Invalidate the readahead cache. */
163 /* Invalidate the readahead cache if it is holding data for FD. */
164 void invalidate_fd (int fd
);
166 /* Serve pread from the readahead cache. Returns number of bytes
167 read, or 0 if the request can't be served from the cache. */
168 int pread (int fd
, gdb_byte
*read_buf
, size_t len
, ULONGEST offset
);
170 /* The file descriptor for the file that is being cached. -1 if the
174 /* The offset into the file that the cache buffer corresponds
178 /* The buffer holding the cache contents. */
179 gdb_byte
*buf
= nullptr;
180 /* The buffer's size. We try to read as much as fits into a packet
184 /* Cache hit and miss counters. */
185 ULONGEST hit_count
= 0;
186 ULONGEST miss_count
= 0;
189 /* Description of the remote protocol for a given architecture. */
193 long offset
; /* Offset into G packet. */
194 long regnum
; /* GDB's internal register number. */
195 LONGEST pnum
; /* Remote protocol register number. */
196 int in_g_packet
; /* Always part of G packet. */
197 /* long size in bytes; == register_size (target_gdbarch (), regnum);
199 /* char *name; == gdbarch_register_name (target_gdbarch (), regnum);
203 struct remote_arch_state
205 explicit remote_arch_state (struct gdbarch
*gdbarch
);
207 /* Description of the remote protocol registers. */
208 long sizeof_g_packet
;
210 /* Description of the remote protocol registers indexed by REGNUM
211 (making an array gdbarch_num_regs in size). */
212 std::unique_ptr
<packet_reg
[]> regs
;
214 /* This is the size (in chars) of the first response to the ``g''
215 packet. It is used as a heuristic when determining the maximum
216 size of memory-read and memory-write packets. A target will
217 typically only reserve a buffer large enough to hold the ``g''
218 packet. The size does not include packet overhead (headers and
220 long actual_register_packet_size
;
222 /* This is the maximum size (in chars) of a non read/write packet.
223 It is also used as a cap on the size of read/write packets. */
224 long remote_packet_size
;
227 /* Description of the remote protocol state for the currently
228 connected target. This is per-target state, and independent of the
229 selected architecture. */
238 /* Get the remote arch state for GDBARCH. */
239 struct remote_arch_state
*get_remote_arch_state (struct gdbarch
*gdbarch
);
243 /* A buffer to use for incoming packets, and its current size. The
244 buffer is grown dynamically for larger incoming packets.
245 Outgoing packets may also be constructed in this buffer.
246 The size of the buffer is always at least REMOTE_PACKET_SIZE;
247 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
249 gdb::char_vector buf
;
251 /* True if we're going through initial connection setup (finding out
252 about the remote side's threads, relocating symbols, etc.). */
253 bool starting_up
= false;
255 /* If we negotiated packet size explicitly (and thus can bypass
256 heuristics for the largest packet size that will not overflow
257 a buffer in the stub), this will be set to that packet size.
258 Otherwise zero, meaning to use the guessed size. */
259 long explicit_packet_size
= 0;
261 /* True, if in no ack mode. That is, neither GDB nor the stub will
262 expect acks from each other. The connection is assumed to be
264 bool noack_mode
= false;
266 /* True if we're connected in extended remote mode. */
267 bool extended
= false;
269 /* True if we resumed the target and we're waiting for the target to
270 stop. In the mean time, we can't start another command/query.
271 The remote server wouldn't be ready to process it, so we'd
272 timeout waiting for a reply that would never come and eventually
273 we'd close the connection. This can happen in asynchronous mode
274 because we allow GDB commands while the target is running. */
275 bool waiting_for_stop_reply
= false;
277 /* The status of the stub support for the various vCont actions. */
278 vCont_action_support supports_vCont
;
279 /* Whether vCont support was probed already. This is a workaround
280 until packet_support is per-connection. */
281 bool supports_vCont_probed
;
283 /* True if the user has pressed Ctrl-C, but the target hasn't
284 responded to that. */
285 bool ctrlc_pending_p
= false;
287 /* True if we saw a Ctrl-C while reading or writing from/to the
288 remote descriptor. At that point it is not safe to send a remote
289 interrupt packet, so we instead remember we saw the Ctrl-C and
290 process it once we're done with sending/receiving the current
291 packet, which should be shortly. If however that takes too long,
292 and the user presses Ctrl-C again, we offer to disconnect. */
293 bool got_ctrlc_during_io
= false;
295 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
296 remote_open knows that we don't have a file open when the program
298 struct serial
*remote_desc
= nullptr;
300 /* These are the threads which we last sent to the remote system. The
301 TID member will be -1 for all or -2 for not sent yet. */
302 ptid_t general_thread
= null_ptid
;
303 ptid_t continue_thread
= null_ptid
;
305 /* This is the traceframe which we last selected on the remote system.
306 It will be -1 if no traceframe is selected. */
307 int remote_traceframe_number
= -1;
309 char *last_pass_packet
= nullptr;
311 /* The last QProgramSignals packet sent to the target. We bypass
312 sending a new program signals list down to the target if the new
313 packet is exactly the same as the last we sent. IOW, we only let
314 the target know about program signals list changes. */
315 char *last_program_signals_packet
= nullptr;
317 gdb_signal last_sent_signal
= GDB_SIGNAL_0
;
319 bool last_sent_step
= false;
321 /* The execution direction of the last resume we got. */
322 exec_direction_kind last_resume_exec_dir
= EXEC_FORWARD
;
324 char *finished_object
= nullptr;
325 char *finished_annex
= nullptr;
326 ULONGEST finished_offset
= 0;
328 /* Should we try the 'ThreadInfo' query packet?
330 This variable (NOT available to the user: auto-detect only!)
331 determines whether GDB will use the new, simpler "ThreadInfo"
332 query or the older, more complex syntax for thread queries.
333 This is an auto-detect variable (set to true at each connect,
334 and set to false when the target fails to recognize it). */
335 bool use_threadinfo_query
= false;
336 bool use_threadextra_query
= false;
338 threadref echo_nextthread
{};
339 threadref nextthread
{};
340 threadref resultthreadlist
[MAXTHREADLISTRESULTS
] {};
342 /* The state of remote notification. */
343 struct remote_notif_state
*notif_state
= nullptr;
345 /* The branch trace configuration. */
346 struct btrace_config btrace_config
{};
348 /* The argument to the last "vFile:setfs:" packet we sent, used
349 to avoid sending repeated unnecessary "vFile:setfs:" packets.
350 Initialized to -1 to indicate that no "vFile:setfs:" packet
351 has yet been sent. */
354 /* A readahead cache for vFile:pread. Often, reading a binary
355 involves a sequence of small reads. E.g., when parsing an ELF
356 file. A readahead cache helps mostly the case of remote
357 debugging on a connection with higher latency, due to the
358 request/reply nature of the RSP. We only cache data for a single
359 file descriptor at a time. */
360 struct readahead_cache readahead_cache
;
362 /* The list of already fetched and acknowledged stop events. This
363 queue is used for notification Stop, and other notifications
364 don't need queue for their events, because the notification
365 events of Stop can't be consumed immediately, so that events
366 should be queued first, and be consumed by remote_wait_{ns,as}
367 one per time. Other notifications can consume their events
368 immediately, so queue is not needed for them. */
369 std::vector
<stop_reply_up
> stop_reply_queue
;
371 /* Asynchronous signal handle registered as event loop source for
372 when we have pending events ready to be passed to the core. */
373 struct async_event_handler
*remote_async_inferior_event_token
= nullptr;
375 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
376 ``forever'' still use the normal timeout mechanism. This is
377 currently used by the ASYNC code to guarentee that target reads
378 during the initial connect always time-out. Once getpkt has been
379 modified to return a timeout indication and, in turn
380 remote_wait()/wait_for_inferior() have gained a timeout parameter
382 int wait_forever_enabled_p
= 1;
385 /* Mapping of remote protocol data for each gdbarch. Usually there
386 is only one entry here, though we may see more with stubs that
387 support multi-process. */
388 std::unordered_map
<struct gdbarch
*, remote_arch_state
>
392 static const target_info remote_target_info
= {
394 N_("Remote target using gdb-specific protocol"),
398 class remote_target
: public process_stratum_target
401 remote_target () = default;
402 ~remote_target () override
;
404 const target_info
&info () const override
405 { return remote_target_info
; }
407 const char *connection_string () override
;
409 thread_control_capabilities
get_thread_control_capabilities () override
410 { return tc_schedlock
; }
412 /* Open a remote connection. */
413 static void open (const char *, int);
415 void close () override
;
417 void detach (inferior
*, int) override
;
418 void disconnect (const char *, int) override
;
420 void commit_resumed () override
;
421 void resume (ptid_t
, int, enum gdb_signal
) override
;
422 ptid_t
wait (ptid_t
, struct target_waitstatus
*, target_wait_flags
) override
;
423 bool has_pending_events () override
;
425 void fetch_registers (struct regcache
*, int) override
;
426 void store_registers (struct regcache
*, int) override
;
427 void prepare_to_store (struct regcache
*) override
;
429 int insert_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
431 int remove_breakpoint (struct gdbarch
*, struct bp_target_info
*,
432 enum remove_bp_reason
) override
;
435 bool stopped_by_sw_breakpoint () override
;
436 bool supports_stopped_by_sw_breakpoint () override
;
438 bool stopped_by_hw_breakpoint () override
;
440 bool supports_stopped_by_hw_breakpoint () override
;
442 bool stopped_by_watchpoint () override
;
444 bool stopped_data_address (CORE_ADDR
*) override
;
446 bool watchpoint_addr_within_range (CORE_ADDR
, CORE_ADDR
, int) override
;
448 int can_use_hw_breakpoint (enum bptype
, int, int) override
;
450 int insert_hw_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
452 int remove_hw_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
454 int region_ok_for_hw_watchpoint (CORE_ADDR
, int) override
;
456 int insert_watchpoint (CORE_ADDR
, int, enum target_hw_bp_type
,
457 struct expression
*) override
;
459 int remove_watchpoint (CORE_ADDR
, int, enum target_hw_bp_type
,
460 struct expression
*) override
;
462 void kill () override
;
464 void load (const char *, int) override
;
466 void mourn_inferior () override
;
468 void pass_signals (gdb::array_view
<const unsigned char>) override
;
470 int set_syscall_catchpoint (int, bool, int,
471 gdb::array_view
<const int>) override
;
473 void program_signals (gdb::array_view
<const unsigned char>) override
;
475 bool thread_alive (ptid_t ptid
) override
;
477 const char *thread_name (struct thread_info
*) override
;
479 void update_thread_list () override
;
481 std::string
pid_to_str (ptid_t
) override
;
483 const char *extra_thread_info (struct thread_info
*) override
;
485 ptid_t
get_ada_task_ptid (long lwp
, ULONGEST thread
) override
;
487 thread_info
*thread_handle_to_thread_info (const gdb_byte
*thread_handle
,
489 inferior
*inf
) override
;
491 gdb::byte_vector
thread_info_to_thread_handle (struct thread_info
*tp
)
494 void stop (ptid_t
) override
;
496 void interrupt () override
;
498 void pass_ctrlc () override
;
500 enum target_xfer_status
xfer_partial (enum target_object object
,
503 const gdb_byte
*writebuf
,
504 ULONGEST offset
, ULONGEST len
,
505 ULONGEST
*xfered_len
) override
;
507 ULONGEST
get_memory_xfer_limit () override
;
509 void rcmd (const char *command
, struct ui_file
*output
) override
;
511 char *pid_to_exec_file (int pid
) override
;
513 void log_command (const char *cmd
) override
515 serial_log_command (this, cmd
);
518 CORE_ADDR
get_thread_local_address (ptid_t ptid
,
519 CORE_ADDR load_module_addr
,
520 CORE_ADDR offset
) override
;
522 bool can_execute_reverse () override
;
524 std::vector
<mem_region
> memory_map () override
;
526 void flash_erase (ULONGEST address
, LONGEST length
) override
;
528 void flash_done () override
;
530 const struct target_desc
*read_description () override
;
532 int search_memory (CORE_ADDR start_addr
, ULONGEST search_space_len
,
533 const gdb_byte
*pattern
, ULONGEST pattern_len
,
534 CORE_ADDR
*found_addrp
) override
;
536 bool can_async_p () override
;
538 bool is_async_p () override
;
540 void async (int) override
;
542 int async_wait_fd () override
;
544 void thread_events (int) override
;
546 int can_do_single_step () override
;
548 void terminal_inferior () override
;
550 void terminal_ours () override
;
552 bool supports_non_stop () override
;
554 bool supports_multi_process () override
;
556 bool supports_disable_randomization () override
;
558 bool filesystem_is_local () override
;
561 int fileio_open (struct inferior
*inf
, const char *filename
,
562 int flags
, int mode
, int warn_if_slow
,
563 int *target_errno
) override
;
565 int fileio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
566 ULONGEST offset
, int *target_errno
) override
;
568 int fileio_pread (int fd
, gdb_byte
*read_buf
, int len
,
569 ULONGEST offset
, int *target_errno
) override
;
571 int fileio_fstat (int fd
, struct stat
*sb
, int *target_errno
) override
;
573 int fileio_close (int fd
, int *target_errno
) override
;
575 int fileio_unlink (struct inferior
*inf
,
576 const char *filename
,
577 int *target_errno
) override
;
579 gdb::optional
<std::string
>
580 fileio_readlink (struct inferior
*inf
,
581 const char *filename
,
582 int *target_errno
) override
;
584 bool supports_enable_disable_tracepoint () override
;
586 bool supports_string_tracing () override
;
588 bool supports_evaluation_of_breakpoint_conditions () override
;
590 bool can_run_breakpoint_commands () override
;
592 void trace_init () override
;
594 void download_tracepoint (struct bp_location
*location
) override
;
596 bool can_download_tracepoint () override
;
598 void download_trace_state_variable (const trace_state_variable
&tsv
) override
;
600 void enable_tracepoint (struct bp_location
*location
) override
;
602 void disable_tracepoint (struct bp_location
*location
) override
;
604 void trace_set_readonly_regions () override
;
606 void trace_start () override
;
608 int get_trace_status (struct trace_status
*ts
) override
;
610 void get_tracepoint_status (struct breakpoint
*tp
, struct uploaded_tp
*utp
)
613 void trace_stop () override
;
615 int trace_find (enum trace_find_type type
, int num
,
616 CORE_ADDR addr1
, CORE_ADDR addr2
, int *tpp
) override
;
618 bool get_trace_state_variable_value (int tsv
, LONGEST
*val
) override
;
620 int save_trace_data (const char *filename
) override
;
622 int upload_tracepoints (struct uploaded_tp
**utpp
) override
;
624 int upload_trace_state_variables (struct uploaded_tsv
**utsvp
) override
;
626 LONGEST
get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
) override
;
628 int get_min_fast_tracepoint_insn_len () override
;
630 void set_disconnected_tracing (int val
) override
;
632 void set_circular_trace_buffer (int val
) override
;
634 void set_trace_buffer_size (LONGEST val
) override
;
636 bool set_trace_notes (const char *user
, const char *notes
,
637 const char *stopnotes
) override
;
639 int core_of_thread (ptid_t ptid
) override
;
641 int verify_memory (const gdb_byte
*data
,
642 CORE_ADDR memaddr
, ULONGEST size
) override
;
645 bool get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
) override
;
647 void set_permissions () override
;
649 bool static_tracepoint_marker_at (CORE_ADDR
,
650 struct static_tracepoint_marker
*marker
)
653 std::vector
<static_tracepoint_marker
>
654 static_tracepoint_markers_by_strid (const char *id
) override
;
656 traceframe_info_up
traceframe_info () override
;
658 bool use_agent (bool use
) override
;
659 bool can_use_agent () override
;
661 struct btrace_target_info
*
662 enable_btrace (thread_info
*tp
, const struct btrace_config
*conf
) override
;
664 void disable_btrace (struct btrace_target_info
*tinfo
) override
;
666 void teardown_btrace (struct btrace_target_info
*tinfo
) override
;
668 enum btrace_error
read_btrace (struct btrace_data
*data
,
669 struct btrace_target_info
*btinfo
,
670 enum btrace_read_type type
) override
;
672 const struct btrace_config
*btrace_conf (const struct btrace_target_info
*) override
;
673 bool augmented_libraries_svr4_read () override
;
674 void follow_fork (inferior
*, ptid_t
, target_waitkind
, bool, bool) override
;
675 void follow_exec (inferior
*, ptid_t
, const char *) override
;
676 int insert_fork_catchpoint (int) override
;
677 int remove_fork_catchpoint (int) override
;
678 int insert_vfork_catchpoint (int) override
;
679 int remove_vfork_catchpoint (int) override
;
680 int insert_exec_catchpoint (int) override
;
681 int remove_exec_catchpoint (int) override
;
682 enum exec_direction_kind
execution_direction () override
;
684 bool supports_memory_tagging () override
;
686 bool fetch_memtags (CORE_ADDR address
, size_t len
,
687 gdb::byte_vector
&tags
, int type
) override
;
689 bool store_memtags (CORE_ADDR address
, size_t len
,
690 const gdb::byte_vector
&tags
, int type
) override
;
692 public: /* Remote specific methods. */
694 void remote_download_command_source (int num
, ULONGEST addr
,
695 struct command_line
*cmds
);
697 void remote_file_put (const char *local_file
, const char *remote_file
,
699 void remote_file_get (const char *remote_file
, const char *local_file
,
701 void remote_file_delete (const char *remote_file
, int from_tty
);
703 int remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
704 ULONGEST offset
, int *remote_errno
);
705 int remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
706 ULONGEST offset
, int *remote_errno
);
707 int remote_hostio_pread_vFile (int fd
, gdb_byte
*read_buf
, int len
,
708 ULONGEST offset
, int *remote_errno
);
710 int remote_hostio_send_command (int command_bytes
, int which_packet
,
711 int *remote_errno
, const char **attachment
,
712 int *attachment_len
);
713 int remote_hostio_set_filesystem (struct inferior
*inf
,
715 /* We should get rid of this and use fileio_open directly. */
716 int remote_hostio_open (struct inferior
*inf
, const char *filename
,
717 int flags
, int mode
, int warn_if_slow
,
719 int remote_hostio_close (int fd
, int *remote_errno
);
721 int remote_hostio_unlink (inferior
*inf
, const char *filename
,
724 struct remote_state
*get_remote_state ();
726 long get_remote_packet_size (void);
727 long get_memory_packet_size (struct memory_packet_config
*config
);
729 long get_memory_write_packet_size ();
730 long get_memory_read_packet_size ();
732 char *append_pending_thread_resumptions (char *p
, char *endp
,
734 static void open_1 (const char *name
, int from_tty
, int extended_p
);
735 void start_remote (int from_tty
, int extended_p
);
736 void remote_detach_1 (struct inferior
*inf
, int from_tty
);
738 char *append_resumption (char *p
, char *endp
,
739 ptid_t ptid
, int step
, gdb_signal siggnal
);
740 int remote_resume_with_vcont (ptid_t scope_ptid
, int step
,
743 thread_info
*add_current_inferior_and_thread (const char *wait_status
);
745 ptid_t
wait_ns (ptid_t ptid
, struct target_waitstatus
*status
,
746 target_wait_flags options
);
747 ptid_t
wait_as (ptid_t ptid
, target_waitstatus
*status
,
748 target_wait_flags options
);
750 ptid_t
process_stop_reply (struct stop_reply
*stop_reply
,
751 target_waitstatus
*status
);
753 ptid_t select_thread_for_ambiguous_stop_reply
754 (const struct target_waitstatus
&status
);
756 void remote_notice_new_inferior (ptid_t currthread
, bool executing
);
758 void print_one_stopped_thread (thread_info
*thread
);
759 void process_initial_stop_replies (int from_tty
);
761 thread_info
*remote_add_thread (ptid_t ptid
, bool running
, bool executing
,
764 void btrace_sync_conf (const btrace_config
*conf
);
766 void remote_btrace_maybe_reopen ();
768 void remove_new_fork_children (threads_listing_context
*context
);
769 void kill_new_fork_children (inferior
*inf
);
770 void discard_pending_stop_replies (struct inferior
*inf
);
771 int stop_reply_queue_length ();
773 void check_pending_events_prevent_wildcard_vcont
774 (bool *may_global_wildcard_vcont
);
776 void discard_pending_stop_replies_in_queue ();
777 struct stop_reply
*remote_notif_remove_queued_reply (ptid_t ptid
);
778 struct stop_reply
*queued_stop_reply (ptid_t ptid
);
779 int peek_stop_reply (ptid_t ptid
);
780 void remote_parse_stop_reply (const char *buf
, stop_reply
*event
);
782 void remote_stop_ns (ptid_t ptid
);
783 void remote_interrupt_as ();
784 void remote_interrupt_ns ();
786 char *remote_get_noisy_reply ();
787 int remote_query_attached (int pid
);
788 inferior
*remote_add_inferior (bool fake_pid_p
, int pid
, int attached
,
791 ptid_t
remote_current_thread (ptid_t oldpid
);
792 ptid_t
get_current_thread (const char *wait_status
);
794 void set_thread (ptid_t ptid
, int gen
);
795 void set_general_thread (ptid_t ptid
);
796 void set_continue_thread (ptid_t ptid
);
797 void set_general_process ();
799 char *write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
);
801 int remote_unpack_thread_info_response (const char *pkt
, threadref
*expectedref
,
802 gdb_ext_thread_info
*info
);
803 int remote_get_threadinfo (threadref
*threadid
, int fieldset
,
804 gdb_ext_thread_info
*info
);
806 int parse_threadlist_response (const char *pkt
, int result_limit
,
807 threadref
*original_echo
,
808 threadref
*resultlist
,
810 int remote_get_threadlist (int startflag
, threadref
*nextthread
,
811 int result_limit
, int *done
, int *result_count
,
812 threadref
*threadlist
);
814 int remote_threadlist_iterator (rmt_thread_action stepfunction
,
815 void *context
, int looplimit
);
817 int remote_get_threads_with_ql (threads_listing_context
*context
);
818 int remote_get_threads_with_qxfer (threads_listing_context
*context
);
819 int remote_get_threads_with_qthreadinfo (threads_listing_context
*context
);
821 void extended_remote_restart ();
825 void remote_check_symbols ();
827 void remote_supported_packet (const struct protocol_feature
*feature
,
828 enum packet_support support
,
829 const char *argument
);
831 void remote_query_supported ();
833 void remote_packet_size (const protocol_feature
*feature
,
834 packet_support support
, const char *value
);
836 void remote_serial_quit_handler ();
838 void remote_detach_pid (int pid
);
840 void remote_vcont_probe ();
842 void remote_resume_with_hc (ptid_t ptid
, int step
,
845 void send_interrupt_sequence ();
846 void interrupt_query ();
848 void remote_notif_get_pending_events (notif_client
*nc
);
850 int fetch_register_using_p (struct regcache
*regcache
,
852 int send_g_packet ();
853 void process_g_packet (struct regcache
*regcache
);
854 void fetch_registers_using_g (struct regcache
*regcache
);
855 int store_register_using_P (const struct regcache
*regcache
,
857 void store_registers_using_G (const struct regcache
*regcache
);
859 void set_remote_traceframe ();
861 void check_binary_download (CORE_ADDR addr
);
863 target_xfer_status
remote_write_bytes_aux (const char *header
,
865 const gdb_byte
*myaddr
,
868 ULONGEST
*xfered_len_units
,
872 target_xfer_status
remote_write_bytes (CORE_ADDR memaddr
,
873 const gdb_byte
*myaddr
, ULONGEST len
,
874 int unit_size
, ULONGEST
*xfered_len
);
876 target_xfer_status
remote_read_bytes_1 (CORE_ADDR memaddr
, gdb_byte
*myaddr
,
878 int unit_size
, ULONGEST
*xfered_len_units
);
880 target_xfer_status
remote_xfer_live_readonly_partial (gdb_byte
*readbuf
,
884 ULONGEST
*xfered_len
);
886 target_xfer_status
remote_read_bytes (CORE_ADDR memaddr
,
887 gdb_byte
*myaddr
, ULONGEST len
,
889 ULONGEST
*xfered_len
);
891 packet_result
remote_send_printf (const char *format
, ...)
892 ATTRIBUTE_PRINTF (2, 3);
894 target_xfer_status
remote_flash_write (ULONGEST address
,
895 ULONGEST length
, ULONGEST
*xfered_len
,
896 const gdb_byte
*data
);
898 int readchar (int timeout
);
900 void remote_serial_write (const char *str
, int len
);
902 int putpkt (const char *buf
);
903 int putpkt_binary (const char *buf
, int cnt
);
905 int putpkt (const gdb::char_vector
&buf
)
907 return putpkt (buf
.data ());
911 long read_frame (gdb::char_vector
*buf_p
);
912 void getpkt (gdb::char_vector
*buf
, int forever
);
913 int getpkt_or_notif_sane_1 (gdb::char_vector
*buf
, int forever
,
914 int expecting_notif
, int *is_notif
);
915 int getpkt_sane (gdb::char_vector
*buf
, int forever
);
916 int getpkt_or_notif_sane (gdb::char_vector
*buf
, int forever
,
918 int remote_vkill (int pid
);
919 void remote_kill_k ();
921 void extended_remote_disable_randomization (int val
);
922 int extended_remote_run (const std::string
&args
);
924 void send_environment_packet (const char *action
,
928 void extended_remote_environment_support ();
929 void extended_remote_set_inferior_cwd ();
931 target_xfer_status
remote_write_qxfer (const char *object_name
,
933 const gdb_byte
*writebuf
,
934 ULONGEST offset
, LONGEST len
,
935 ULONGEST
*xfered_len
,
936 struct packet_config
*packet
);
938 target_xfer_status
remote_read_qxfer (const char *object_name
,
940 gdb_byte
*readbuf
, ULONGEST offset
,
942 ULONGEST
*xfered_len
,
943 struct packet_config
*packet
);
945 void push_stop_reply (struct stop_reply
*new_event
);
947 bool vcont_r_supported ();
951 bool start_remote_1 (int from_tty
, int extended_p
);
953 /* The remote state. Don't reference this directly. Use the
954 get_remote_state method instead. */
955 remote_state m_remote_state
;
958 static const target_info extended_remote_target_info
= {
960 N_("Extended remote target using gdb-specific protocol"),
964 /* Set up the extended remote target by extending the standard remote
965 target and adding to it. */
967 class extended_remote_target final
: public remote_target
970 const target_info
&info () const override
971 { return extended_remote_target_info
; }
973 /* Open an extended-remote connection. */
974 static void open (const char *, int);
976 bool can_create_inferior () override
{ return true; }
977 void create_inferior (const char *, const std::string
&,
978 char **, int) override
;
980 void detach (inferior
*, int) override
;
982 bool can_attach () override
{ return true; }
983 void attach (const char *, int) override
;
985 void post_attach (int) override
;
986 bool supports_disable_randomization () override
;
989 struct stop_reply
: public notif_event
993 /* The identifier of the thread about this event */
996 /* The remote state this event is associated with. When the remote
997 connection, represented by a remote_state object, is closed,
998 all the associated stop_reply events should be released. */
999 struct remote_state
*rs
;
1001 struct target_waitstatus ws
;
1003 /* The architecture associated with the expedited registers. */
1006 /* Expedited registers. This makes remote debugging a bit more
1007 efficient for those targets that provide critical registers as
1008 part of their normal status mechanism (as another roundtrip to
1009 fetch them is avoided). */
1010 std::vector
<cached_reg_t
> regcache
;
1012 enum target_stop_reason stop_reason
;
1014 CORE_ADDR watch_data_address
;
1022 is_remote_target (process_stratum_target
*target
)
1024 remote_target
*rt
= dynamic_cast<remote_target
*> (target
);
1025 return rt
!= nullptr;
1028 /* Per-program-space data key. */
1029 static const struct program_space_key
<char, gdb::xfree_deleter
<char>>
1032 /* The variable registered as the control variable used by the
1033 remote exec-file commands. While the remote exec-file setting is
1034 per-program-space, the set/show machinery uses this as the
1035 location of the remote exec-file value. */
1036 static std::string remote_exec_file_var
;
1038 /* The size to align memory write packets, when practical. The protocol
1039 does not guarantee any alignment, and gdb will generate short
1040 writes and unaligned writes, but even as a best-effort attempt this
1041 can improve bulk transfers. For instance, if a write is misaligned
1042 relative to the target's data bus, the stub may need to make an extra
1043 round trip fetching data from the target. This doesn't make a
1044 huge difference, but it's easy to do, so we try to be helpful.
1046 The alignment chosen is arbitrary; usually data bus width is
1047 important here, not the possibly larger cache line size. */
1048 enum { REMOTE_ALIGN_WRITES
= 16 };
1050 /* Prototypes for local functions. */
1052 static int hexnumlen (ULONGEST num
);
1054 static int stubhex (int ch
);
1056 static int hexnumstr (char *, ULONGEST
);
1058 static int hexnumnstr (char *, ULONGEST
, int);
1060 static CORE_ADDR
remote_address_masked (CORE_ADDR
);
1062 static int stub_unpack_int (const char *buff
, int fieldlength
);
1064 struct packet_config
;
1066 static void show_remote_protocol_packet_cmd (struct ui_file
*file
,
1068 struct cmd_list_element
*c
,
1071 static ptid_t
read_ptid (const char *buf
, const char **obuf
);
1073 static void remote_async_inferior_event_handler (gdb_client_data
);
1075 static bool remote_read_description_p (struct target_ops
*target
);
1077 static void remote_console_output (const char *msg
);
1079 static void remote_btrace_reset (remote_state
*rs
);
1081 static void remote_unpush_and_throw (remote_target
*target
);
1085 static struct cmd_list_element
*remote_cmdlist
;
1087 /* For "set remote" and "show remote". */
1089 static struct cmd_list_element
*remote_set_cmdlist
;
1090 static struct cmd_list_element
*remote_show_cmdlist
;
1092 /* Controls whether GDB is willing to use range stepping. */
1094 static bool use_range_stepping
= true;
1096 /* From the remote target's point of view, each thread is in one of these three
1098 enum class resume_state
1100 /* Not resumed - we haven't been asked to resume this thread. */
1103 /* We have been asked to resume this thread, but haven't sent a vCont action
1104 for it yet. We'll need to consider it next time commit_resume is
1106 RESUMED_PENDING_VCONT
,
1108 /* We have been asked to resume this thread, and we have sent a vCont action
1113 /* Information about a thread's pending vCont-resume. Used when a thread is in
1114 the remote_resume_state::RESUMED_PENDING_VCONT state. remote_target::resume
1115 stores this information which is then picked up by
1116 remote_target::commit_resume to know which is the proper action for this
1117 thread to include in the vCont packet. */
1118 struct resumed_pending_vcont_info
1120 /* True if the last resume call for this thread was a step request, false
1121 if a continue request. */
1124 /* The signal specified in the last resume call for this thread. */
1128 /* Private data that we'll store in (struct thread_info)->priv. */
1129 struct remote_thread_info
: public private_thread_info
1135 /* Thread handle, perhaps a pthread_t or thread_t value, stored as a
1136 sequence of bytes. */
1137 gdb::byte_vector thread_handle
;
1139 /* Whether the target stopped for a breakpoint/watchpoint. */
1140 enum target_stop_reason stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
1142 /* This is set to the data address of the access causing the target
1143 to stop for a watchpoint. */
1144 CORE_ADDR watch_data_address
= 0;
1146 /* Get the thread's resume state. */
1147 enum resume_state
get_resume_state () const
1149 return m_resume_state
;
1152 /* Put the thread in the NOT_RESUMED state. */
1153 void set_not_resumed ()
1155 m_resume_state
= resume_state::NOT_RESUMED
;
1158 /* Put the thread in the RESUMED_PENDING_VCONT state. */
1159 void set_resumed_pending_vcont (bool step
, gdb_signal sig
)
1161 m_resume_state
= resume_state::RESUMED_PENDING_VCONT
;
1162 m_resumed_pending_vcont_info
.step
= step
;
1163 m_resumed_pending_vcont_info
.sig
= sig
;
1166 /* Get the information this thread's pending vCont-resumption.
1168 Must only be called if the thread is in the RESUMED_PENDING_VCONT resume
1170 const struct resumed_pending_vcont_info
&resumed_pending_vcont_info () const
1172 gdb_assert (m_resume_state
== resume_state::RESUMED_PENDING_VCONT
);
1174 return m_resumed_pending_vcont_info
;
1177 /* Put the thread in the VCONT_RESUMED state. */
1180 m_resume_state
= resume_state::RESUMED
;
1184 /* Resume state for this thread. This is used to implement vCont action
1185 coalescing (only when the target operates in non-stop mode).
1187 remote_target::resume moves the thread to the RESUMED_PENDING_VCONT state,
1188 which notes that this thread must be considered in the next commit_resume
1191 remote_target::commit_resume sends a vCont packet with actions for the
1192 threads in the RESUMED_PENDING_VCONT state and moves them to the
1193 VCONT_RESUMED state.
1195 When reporting a stop to the core for a thread, that thread is moved back
1196 to the NOT_RESUMED state. */
1197 enum resume_state m_resume_state
= resume_state::NOT_RESUMED
;
1199 /* Extra info used if the thread is in the RESUMED_PENDING_VCONT state. */
1200 struct resumed_pending_vcont_info m_resumed_pending_vcont_info
;
1203 remote_state::remote_state ()
1208 remote_state::~remote_state ()
1210 xfree (this->last_pass_packet
);
1211 xfree (this->last_program_signals_packet
);
1212 xfree (this->finished_object
);
1213 xfree (this->finished_annex
);
1216 /* Utility: generate error from an incoming stub packet. */
1218 trace_error (char *buf
)
1221 return; /* not an error msg */
1224 case '1': /* malformed packet error */
1225 if (*++buf
== '0') /* general case: */
1226 error (_("remote.c: error in outgoing packet."));
1228 error (_("remote.c: error in outgoing packet at field #%ld."),
1229 strtol (buf
, NULL
, 16));
1231 error (_("Target returns error code '%s'."), buf
);
1235 /* Utility: wait for reply from stub, while accepting "O" packets. */
1238 remote_target::remote_get_noisy_reply ()
1240 struct remote_state
*rs
= get_remote_state ();
1242 do /* Loop on reply from remote stub. */
1246 QUIT
; /* Allow user to bail out with ^C. */
1247 getpkt (&rs
->buf
, 0);
1248 buf
= rs
->buf
.data ();
1251 else if (startswith (buf
, "qRelocInsn:"))
1254 CORE_ADDR from
, to
, org_to
;
1256 int adjusted_size
= 0;
1259 p
= buf
+ strlen ("qRelocInsn:");
1260 pp
= unpack_varlen_hex (p
, &ul
);
1262 error (_("invalid qRelocInsn packet: %s"), buf
);
1266 unpack_varlen_hex (p
, &ul
);
1273 gdbarch_relocate_instruction (target_gdbarch (), &to
, from
);
1276 catch (const gdb_exception
&ex
)
1278 if (ex
.error
== MEMORY_ERROR
)
1280 /* Propagate memory errors silently back to the
1281 target. The stub may have limited the range of
1282 addresses we can write to, for example. */
1286 /* Something unexpectedly bad happened. Be verbose
1287 so we can tell what, and propagate the error back
1288 to the stub, so it doesn't get stuck waiting for
1290 exception_fprintf (gdb_stderr
, ex
,
1291 _("warning: relocating instruction: "));
1298 adjusted_size
= to
- org_to
;
1300 xsnprintf (buf
, rs
->buf
.size (), "qRelocInsn:%x", adjusted_size
);
1304 else if (buf
[0] == 'O' && buf
[1] != 'K')
1305 remote_console_output (buf
+ 1); /* 'O' message from stub */
1307 return buf
; /* Here's the actual reply. */
1312 struct remote_arch_state
*
1313 remote_state::get_remote_arch_state (struct gdbarch
*gdbarch
)
1315 remote_arch_state
*rsa
;
1317 auto it
= this->m_arch_states
.find (gdbarch
);
1318 if (it
== this->m_arch_states
.end ())
1320 auto p
= this->m_arch_states
.emplace (std::piecewise_construct
,
1321 std::forward_as_tuple (gdbarch
),
1322 std::forward_as_tuple (gdbarch
));
1323 rsa
= &p
.first
->second
;
1325 /* Make sure that the packet buffer is plenty big enough for
1326 this architecture. */
1327 if (this->buf
.size () < rsa
->remote_packet_size
)
1328 this->buf
.resize (2 * rsa
->remote_packet_size
);
1336 /* Fetch the global remote target state. */
1339 remote_target::get_remote_state ()
1341 /* Make sure that the remote architecture state has been
1342 initialized, because doing so might reallocate rs->buf. Any
1343 function which calls getpkt also needs to be mindful of changes
1344 to rs->buf, but this call limits the number of places which run
1346 m_remote_state
.get_remote_arch_state (target_gdbarch ());
1348 return &m_remote_state
;
1351 /* Fetch the remote exec-file from the current program space. */
1354 get_remote_exec_file (void)
1356 char *remote_exec_file
;
1358 remote_exec_file
= remote_pspace_data
.get (current_program_space
);
1359 if (remote_exec_file
== NULL
)
1362 return remote_exec_file
;
1365 /* Set the remote exec file for PSPACE. */
1368 set_pspace_remote_exec_file (struct program_space
*pspace
,
1369 const char *remote_exec_file
)
1371 char *old_file
= remote_pspace_data
.get (pspace
);
1374 remote_pspace_data
.set (pspace
, xstrdup (remote_exec_file
));
1377 /* The "set/show remote exec-file" set command hook. */
1380 set_remote_exec_file (const char *ignored
, int from_tty
,
1381 struct cmd_list_element
*c
)
1383 set_pspace_remote_exec_file (current_program_space
,
1384 remote_exec_file_var
.c_str ());
1387 /* The "set/show remote exec-file" show command hook. */
1390 show_remote_exec_file (struct ui_file
*file
, int from_tty
,
1391 struct cmd_list_element
*cmd
, const char *value
)
1393 gdb_printf (file
, "%s\n", get_remote_exec_file ());
1397 map_regcache_remote_table (struct gdbarch
*gdbarch
, struct packet_reg
*regs
)
1399 int regnum
, num_remote_regs
, offset
;
1400 struct packet_reg
**remote_regs
;
1402 for (regnum
= 0; regnum
< gdbarch_num_regs (gdbarch
); regnum
++)
1404 struct packet_reg
*r
= ®s
[regnum
];
1406 if (register_size (gdbarch
, regnum
) == 0)
1407 /* Do not try to fetch zero-sized (placeholder) registers. */
1410 r
->pnum
= gdbarch_remote_register_number (gdbarch
, regnum
);
1415 /* Define the g/G packet format as the contents of each register
1416 with a remote protocol number, in order of ascending protocol
1419 remote_regs
= XALLOCAVEC (struct packet_reg
*, gdbarch_num_regs (gdbarch
));
1420 for (num_remote_regs
= 0, regnum
= 0;
1421 regnum
< gdbarch_num_regs (gdbarch
);
1423 if (regs
[regnum
].pnum
!= -1)
1424 remote_regs
[num_remote_regs
++] = ®s
[regnum
];
1426 std::sort (remote_regs
, remote_regs
+ num_remote_regs
,
1427 [] (const packet_reg
*a
, const packet_reg
*b
)
1428 { return a
->pnum
< b
->pnum
; });
1430 for (regnum
= 0, offset
= 0; regnum
< num_remote_regs
; regnum
++)
1432 remote_regs
[regnum
]->in_g_packet
= 1;
1433 remote_regs
[regnum
]->offset
= offset
;
1434 offset
+= register_size (gdbarch
, remote_regs
[regnum
]->regnum
);
1440 /* Given the architecture described by GDBARCH, return the remote
1441 protocol register's number and the register's offset in the g/G
1442 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
1443 If the target does not have a mapping for REGNUM, return false,
1444 otherwise, return true. */
1447 remote_register_number_and_offset (struct gdbarch
*gdbarch
, int regnum
,
1448 int *pnum
, int *poffset
)
1450 gdb_assert (regnum
< gdbarch_num_regs (gdbarch
));
1452 std::vector
<packet_reg
> regs (gdbarch_num_regs (gdbarch
));
1454 map_regcache_remote_table (gdbarch
, regs
.data ());
1456 *pnum
= regs
[regnum
].pnum
;
1457 *poffset
= regs
[regnum
].offset
;
1462 remote_arch_state::remote_arch_state (struct gdbarch
*gdbarch
)
1464 /* Use the architecture to build a regnum<->pnum table, which will be
1465 1:1 unless a feature set specifies otherwise. */
1466 this->regs
.reset (new packet_reg
[gdbarch_num_regs (gdbarch
)] ());
1468 /* Record the maximum possible size of the g packet - it may turn out
1470 this->sizeof_g_packet
1471 = map_regcache_remote_table (gdbarch
, this->regs
.get ());
1473 /* Default maximum number of characters in a packet body. Many
1474 remote stubs have a hardwired buffer size of 400 bytes
1475 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
1476 as the maximum packet-size to ensure that the packet and an extra
1477 NUL character can always fit in the buffer. This stops GDB
1478 trashing stubs that try to squeeze an extra NUL into what is
1479 already a full buffer (As of 1999-12-04 that was most stubs). */
1480 this->remote_packet_size
= 400 - 1;
1482 /* This one is filled in when a ``g'' packet is received. */
1483 this->actual_register_packet_size
= 0;
1485 /* Should rsa->sizeof_g_packet needs more space than the
1486 default, adjust the size accordingly. Remember that each byte is
1487 encoded as two characters. 32 is the overhead for the packet
1488 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
1489 (``$NN:G...#NN'') is a better guess, the below has been padded a
1491 if (this->sizeof_g_packet
> ((this->remote_packet_size
- 32) / 2))
1492 this->remote_packet_size
= (this->sizeof_g_packet
* 2 + 32);
1495 /* Get a pointer to the current remote target. If not connected to a
1496 remote target, return NULL. */
1498 static remote_target
*
1499 get_current_remote_target ()
1501 target_ops
*proc_target
= current_inferior ()->process_target ();
1502 return dynamic_cast<remote_target
*> (proc_target
);
1505 /* Return the current allowed size of a remote packet. This is
1506 inferred from the current architecture, and should be used to
1507 limit the length of outgoing packets. */
1509 remote_target::get_remote_packet_size ()
1511 struct remote_state
*rs
= get_remote_state ();
1512 remote_arch_state
*rsa
= rs
->get_remote_arch_state (target_gdbarch ());
1514 if (rs
->explicit_packet_size
)
1515 return rs
->explicit_packet_size
;
1517 return rsa
->remote_packet_size
;
1520 static struct packet_reg
*
1521 packet_reg_from_regnum (struct gdbarch
*gdbarch
, struct remote_arch_state
*rsa
,
1524 if (regnum
< 0 && regnum
>= gdbarch_num_regs (gdbarch
))
1528 struct packet_reg
*r
= &rsa
->regs
[regnum
];
1530 gdb_assert (r
->regnum
== regnum
);
1535 static struct packet_reg
*
1536 packet_reg_from_pnum (struct gdbarch
*gdbarch
, struct remote_arch_state
*rsa
,
1541 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
1543 struct packet_reg
*r
= &rsa
->regs
[i
];
1545 if (r
->pnum
== pnum
)
1551 /* Allow the user to specify what sequence to send to the remote
1552 when he requests a program interruption: Although ^C is usually
1553 what remote systems expect (this is the default, here), it is
1554 sometimes preferable to send a break. On other systems such
1555 as the Linux kernel, a break followed by g, which is Magic SysRq g
1556 is required in order to interrupt the execution. */
1557 const char interrupt_sequence_control_c
[] = "Ctrl-C";
1558 const char interrupt_sequence_break
[] = "BREAK";
1559 const char interrupt_sequence_break_g
[] = "BREAK-g";
1560 static const char *const interrupt_sequence_modes
[] =
1562 interrupt_sequence_control_c
,
1563 interrupt_sequence_break
,
1564 interrupt_sequence_break_g
,
1567 static const char *interrupt_sequence_mode
= interrupt_sequence_control_c
;
1570 show_interrupt_sequence (struct ui_file
*file
, int from_tty
,
1571 struct cmd_list_element
*c
,
1574 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
1576 _("Send the ASCII ETX character (Ctrl-c) "
1577 "to the remote target to interrupt the "
1578 "execution of the program.\n"));
1579 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
1581 _("send a break signal to the remote target "
1582 "to interrupt the execution of the program.\n"));
1583 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
1585 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
1586 "the remote target to interrupt the execution "
1587 "of Linux kernel.\n"));
1589 internal_error (__FILE__
, __LINE__
,
1590 _("Invalid value for interrupt_sequence_mode: %s."),
1591 interrupt_sequence_mode
);
1594 /* This boolean variable specifies whether interrupt_sequence is sent
1595 to the remote target when gdb connects to it.
1596 This is mostly needed when you debug the Linux kernel: The Linux kernel
1597 expects BREAK g which is Magic SysRq g for connecting gdb. */
1598 static bool interrupt_on_connect
= false;
1600 /* This variable is used to implement the "set/show remotebreak" commands.
1601 Since these commands are now deprecated in favor of "set/show remote
1602 interrupt-sequence", it no longer has any effect on the code. */
1603 static bool remote_break
;
1606 set_remotebreak (const char *args
, int from_tty
, struct cmd_list_element
*c
)
1609 interrupt_sequence_mode
= interrupt_sequence_break
;
1611 interrupt_sequence_mode
= interrupt_sequence_control_c
;
1615 show_remotebreak (struct ui_file
*file
, int from_tty
,
1616 struct cmd_list_element
*c
,
1621 /* This variable sets the number of bits in an address that are to be
1622 sent in a memory ("M" or "m") packet. Normally, after stripping
1623 leading zeros, the entire address would be sent. This variable
1624 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
1625 initial implementation of remote.c restricted the address sent in
1626 memory packets to ``host::sizeof long'' bytes - (typically 32
1627 bits). Consequently, for 64 bit targets, the upper 32 bits of an
1628 address was never sent. Since fixing this bug may cause a break in
1629 some remote targets this variable is principally provided to
1630 facilitate backward compatibility. */
1632 static unsigned int remote_address_size
;
1635 /* User configurable variables for the number of characters in a
1636 memory read/write packet. MIN (rsa->remote_packet_size,
1637 rsa->sizeof_g_packet) is the default. Some targets need smaller
1638 values (fifo overruns, et.al.) and some users need larger values
1639 (speed up transfers). The variables ``preferred_*'' (the user
1640 request), ``current_*'' (what was actually set) and ``forced_*''
1641 (Positive - a soft limit, negative - a hard limit). */
1643 struct memory_packet_config
1650 /* The default max memory-write-packet-size, when the setting is
1651 "fixed". The 16k is historical. (It came from older GDB's using
1652 alloca for buffers and the knowledge (folklore?) that some hosts
1653 don't cope very well with large alloca calls.) */
1654 #define DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED 16384
1656 /* The minimum remote packet size for memory transfers. Ensures we
1657 can write at least one byte. */
1658 #define MIN_MEMORY_PACKET_SIZE 20
1660 /* Get the memory packet size, assuming it is fixed. */
1663 get_fixed_memory_packet_size (struct memory_packet_config
*config
)
1665 gdb_assert (config
->fixed_p
);
1667 if (config
->size
<= 0)
1668 return DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
;
1670 return config
->size
;
1673 /* Compute the current size of a read/write packet. Since this makes
1674 use of ``actual_register_packet_size'' the computation is dynamic. */
1677 remote_target::get_memory_packet_size (struct memory_packet_config
*config
)
1679 struct remote_state
*rs
= get_remote_state ();
1680 remote_arch_state
*rsa
= rs
->get_remote_arch_state (target_gdbarch ());
1683 if (config
->fixed_p
)
1684 what_they_get
= get_fixed_memory_packet_size (config
);
1687 what_they_get
= get_remote_packet_size ();
1688 /* Limit the packet to the size specified by the user. */
1689 if (config
->size
> 0
1690 && what_they_get
> config
->size
)
1691 what_they_get
= config
->size
;
1693 /* Limit it to the size of the targets ``g'' response unless we have
1694 permission from the stub to use a larger packet size. */
1695 if (rs
->explicit_packet_size
== 0
1696 && rsa
->actual_register_packet_size
> 0
1697 && what_they_get
> rsa
->actual_register_packet_size
)
1698 what_they_get
= rsa
->actual_register_packet_size
;
1700 if (what_they_get
< MIN_MEMORY_PACKET_SIZE
)
1701 what_they_get
= MIN_MEMORY_PACKET_SIZE
;
1703 /* Make sure there is room in the global buffer for this packet
1704 (including its trailing NUL byte). */
1705 if (rs
->buf
.size () < what_they_get
+ 1)
1706 rs
->buf
.resize (2 * what_they_get
);
1708 return what_they_get
;
1711 /* Update the size of a read/write packet. If they user wants
1712 something really big then do a sanity check. */
1715 set_memory_packet_size (const char *args
, struct memory_packet_config
*config
)
1717 int fixed_p
= config
->fixed_p
;
1718 long size
= config
->size
;
1721 error (_("Argument required (integer, `fixed' or `limited')."));
1722 else if (strcmp (args
, "hard") == 0
1723 || strcmp (args
, "fixed") == 0)
1725 else if (strcmp (args
, "soft") == 0
1726 || strcmp (args
, "limit") == 0)
1732 size
= strtoul (args
, &end
, 0);
1734 error (_("Invalid %s (bad syntax)."), config
->name
);
1736 /* Instead of explicitly capping the size of a packet to or
1737 disallowing it, the user is allowed to set the size to
1738 something arbitrarily large. */
1742 if (fixed_p
&& !config
->fixed_p
)
1744 /* So that the query shows the correct value. */
1745 long query_size
= (size
<= 0
1746 ? DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
1749 if (! query (_("The target may not be able to correctly handle a %s\n"
1750 "of %ld bytes. Change the packet size? "),
1751 config
->name
, query_size
))
1752 error (_("Packet size not changed."));
1754 /* Update the config. */
1755 config
->fixed_p
= fixed_p
;
1756 config
->size
= size
;
1760 show_memory_packet_size (struct memory_packet_config
*config
)
1762 if (config
->size
== 0)
1763 gdb_printf (_("The %s is 0 (default). "), config
->name
);
1765 gdb_printf (_("The %s is %ld. "), config
->name
, config
->size
);
1766 if (config
->fixed_p
)
1767 gdb_printf (_("Packets are fixed at %ld bytes.\n"),
1768 get_fixed_memory_packet_size (config
));
1771 remote_target
*remote
= get_current_remote_target ();
1774 gdb_printf (_("Packets are limited to %ld bytes.\n"),
1775 remote
->get_memory_packet_size (config
));
1777 gdb_puts ("The actual limit will be further reduced "
1778 "dependent on the target.\n");
1782 /* FIXME: needs to be per-remote-target. */
1783 static struct memory_packet_config memory_write_packet_config
=
1785 "memory-write-packet-size",
1789 set_memory_write_packet_size (const char *args
, int from_tty
)
1791 set_memory_packet_size (args
, &memory_write_packet_config
);
1795 show_memory_write_packet_size (const char *args
, int from_tty
)
1797 show_memory_packet_size (&memory_write_packet_config
);
1800 /* Show the number of hardware watchpoints that can be used. */
1803 show_hardware_watchpoint_limit (struct ui_file
*file
, int from_tty
,
1804 struct cmd_list_element
*c
,
1807 gdb_printf (file
, _("The maximum number of target hardware "
1808 "watchpoints is %s.\n"), value
);
1811 /* Show the length limit (in bytes) for hardware watchpoints. */
1814 show_hardware_watchpoint_length_limit (struct ui_file
*file
, int from_tty
,
1815 struct cmd_list_element
*c
,
1818 gdb_printf (file
, _("The maximum length (in bytes) of a target "
1819 "hardware watchpoint is %s.\n"), value
);
1822 /* Show the number of hardware breakpoints that can be used. */
1825 show_hardware_breakpoint_limit (struct ui_file
*file
, int from_tty
,
1826 struct cmd_list_element
*c
,
1829 gdb_printf (file
, _("The maximum number of target hardware "
1830 "breakpoints is %s.\n"), value
);
1833 /* Controls the maximum number of characters to display in the debug output
1834 for each remote packet. The remaining characters are omitted. */
1836 static int remote_packet_max_chars
= 512;
1838 /* Show the maximum number of characters to display for each remote packet
1839 when remote debugging is enabled. */
1842 show_remote_packet_max_chars (struct ui_file
*file
, int from_tty
,
1843 struct cmd_list_element
*c
,
1846 gdb_printf (file
, _("Number of remote packet characters to "
1847 "display is %s.\n"), value
);
1851 remote_target::get_memory_write_packet_size ()
1853 return get_memory_packet_size (&memory_write_packet_config
);
1856 /* FIXME: needs to be per-remote-target. */
1857 static struct memory_packet_config memory_read_packet_config
=
1859 "memory-read-packet-size",
1863 set_memory_read_packet_size (const char *args
, int from_tty
)
1865 set_memory_packet_size (args
, &memory_read_packet_config
);
1869 show_memory_read_packet_size (const char *args
, int from_tty
)
1871 show_memory_packet_size (&memory_read_packet_config
);
1875 remote_target::get_memory_read_packet_size ()
1877 long size
= get_memory_packet_size (&memory_read_packet_config
);
1879 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1880 extra buffer size argument before the memory read size can be
1881 increased beyond this. */
1882 if (size
> get_remote_packet_size ())
1883 size
= get_remote_packet_size ();
1889 struct packet_config
1894 /* If auto, GDB auto-detects support for this packet or feature,
1895 either through qSupported, or by trying the packet and looking
1896 at the response. If true, GDB assumes the target supports this
1897 packet. If false, the packet is disabled. Configs that don't
1898 have an associated command always have this set to auto. */
1899 enum auto_boolean detect
;
1901 /* The "show remote foo-packet" command created for this packet. */
1902 cmd_list_element
*show_cmd
;
1904 /* Does the target support this packet? */
1905 enum packet_support support
;
1908 static enum packet_support
packet_config_support (struct packet_config
*config
);
1909 static enum packet_support
packet_support (int packet
);
1912 show_packet_config_cmd (ui_file
*file
, struct packet_config
*config
)
1914 const char *support
= "internal-error";
1916 switch (packet_config_support (config
))
1919 support
= "enabled";
1921 case PACKET_DISABLE
:
1922 support
= "disabled";
1924 case PACKET_SUPPORT_UNKNOWN
:
1925 support
= "unknown";
1928 switch (config
->detect
)
1930 case AUTO_BOOLEAN_AUTO
:
1932 _("Support for the `%s' packet "
1933 "is auto-detected, currently %s.\n"),
1934 config
->name
, support
);
1936 case AUTO_BOOLEAN_TRUE
:
1937 case AUTO_BOOLEAN_FALSE
:
1939 _("Support for the `%s' packet is currently %s.\n"),
1940 config
->name
, support
);
1946 add_packet_config_cmd (struct packet_config
*config
, const char *name
,
1947 const char *title
, int legacy
)
1949 config
->name
= name
;
1950 config
->title
= title
;
1951 gdb::unique_xmalloc_ptr
<char> set_doc
1952 = xstrprintf ("Set use of remote protocol `%s' (%s) packet.",
1954 gdb::unique_xmalloc_ptr
<char> show_doc
1955 = xstrprintf ("Show current use of remote protocol `%s' (%s) packet.",
1957 /* set/show TITLE-packet {auto,on,off} */
1958 gdb::unique_xmalloc_ptr
<char> cmd_name
= xstrprintf ("%s-packet", title
);
1959 set_show_commands cmds
1960 = add_setshow_auto_boolean_cmd (cmd_name
.release (), class_obscure
,
1961 &config
->detect
, set_doc
.get (),
1962 show_doc
.get (), NULL
, /* help_doc */
1964 show_remote_protocol_packet_cmd
,
1965 &remote_set_cmdlist
, &remote_show_cmdlist
);
1966 config
->show_cmd
= cmds
.show
;
1968 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1971 /* It's not clear who should take ownership of the LEGACY_NAME string
1972 created below, so, for now, place the string into a static vector
1973 which ensures the strings is released when GDB exits. */
1974 static std::vector
<gdb::unique_xmalloc_ptr
<char>> legacy_names
;
1975 gdb::unique_xmalloc_ptr
<char> legacy_name
1976 = xstrprintf ("%s-packet", name
);
1977 add_alias_cmd (legacy_name
.get (), cmds
.set
, class_obscure
, 0,
1978 &remote_set_cmdlist
);
1979 add_alias_cmd (legacy_name
.get (), cmds
.show
, class_obscure
, 0,
1980 &remote_show_cmdlist
);
1981 legacy_names
.emplace_back (std::move (legacy_name
));
1985 static enum packet_result
1986 packet_check_result (const char *buf
)
1990 /* The stub recognized the packet request. Check that the
1991 operation succeeded. */
1993 && isxdigit (buf
[1]) && isxdigit (buf
[2])
1995 /* "Enn" - definitely an error. */
1996 return PACKET_ERROR
;
1998 /* Always treat "E." as an error. This will be used for
1999 more verbose error messages, such as E.memtypes. */
2000 if (buf
[0] == 'E' && buf
[1] == '.')
2001 return PACKET_ERROR
;
2003 /* The packet may or may not be OK. Just assume it is. */
2007 /* The stub does not support the packet. */
2008 return PACKET_UNKNOWN
;
2011 static enum packet_result
2012 packet_check_result (const gdb::char_vector
&buf
)
2014 return packet_check_result (buf
.data ());
2017 static enum packet_result
2018 packet_ok (const char *buf
, struct packet_config
*config
)
2020 enum packet_result result
;
2022 if (config
->detect
!= AUTO_BOOLEAN_TRUE
2023 && config
->support
== PACKET_DISABLE
)
2024 internal_error (__FILE__
, __LINE__
,
2025 _("packet_ok: attempt to use a disabled packet"));
2027 result
= packet_check_result (buf
);
2032 /* The stub recognized the packet request. */
2033 if (config
->support
== PACKET_SUPPORT_UNKNOWN
)
2035 remote_debug_printf ("Packet %s (%s) is supported",
2036 config
->name
, config
->title
);
2037 config
->support
= PACKET_ENABLE
;
2040 case PACKET_UNKNOWN
:
2041 /* The stub does not support the packet. */
2042 if (config
->detect
== AUTO_BOOLEAN_AUTO
2043 && config
->support
== PACKET_ENABLE
)
2045 /* If the stub previously indicated that the packet was
2046 supported then there is a protocol error. */
2047 error (_("Protocol error: %s (%s) conflicting enabled responses."),
2048 config
->name
, config
->title
);
2050 else if (config
->detect
== AUTO_BOOLEAN_TRUE
)
2052 /* The user set it wrong. */
2053 error (_("Enabled packet %s (%s) not recognized by stub"),
2054 config
->name
, config
->title
);
2057 remote_debug_printf ("Packet %s (%s) is NOT supported",
2058 config
->name
, config
->title
);
2059 config
->support
= PACKET_DISABLE
;
2066 static enum packet_result
2067 packet_ok (const gdb::char_vector
&buf
, struct packet_config
*config
)
2069 return packet_ok (buf
.data (), config
);
2086 PACKET_vFile_pwrite
,
2088 PACKET_vFile_unlink
,
2089 PACKET_vFile_readlink
,
2092 PACKET_qXfer_features
,
2093 PACKET_qXfer_exec_file
,
2094 PACKET_qXfer_libraries
,
2095 PACKET_qXfer_libraries_svr4
,
2096 PACKET_qXfer_memory_map
,
2097 PACKET_qXfer_osdata
,
2098 PACKET_qXfer_threads
,
2099 PACKET_qXfer_statictrace_read
,
2100 PACKET_qXfer_traceframe_info
,
2106 PACKET_QPassSignals
,
2107 PACKET_QCatchSyscalls
,
2108 PACKET_QProgramSignals
,
2109 PACKET_QSetWorkingDir
,
2110 PACKET_QStartupWithShell
,
2111 PACKET_QEnvironmentHexEncoded
,
2112 PACKET_QEnvironmentReset
,
2113 PACKET_QEnvironmentUnset
,
2115 PACKET_qSearch_memory
,
2118 PACKET_QStartNoAckMode
,
2120 PACKET_qXfer_siginfo_read
,
2121 PACKET_qXfer_siginfo_write
,
2124 /* Support for conditional tracepoints. */
2125 PACKET_ConditionalTracepoints
,
2127 /* Support for target-side breakpoint conditions. */
2128 PACKET_ConditionalBreakpoints
,
2130 /* Support for target-side breakpoint commands. */
2131 PACKET_BreakpointCommands
,
2133 /* Support for fast tracepoints. */
2134 PACKET_FastTracepoints
,
2136 /* Support for static tracepoints. */
2137 PACKET_StaticTracepoints
,
2139 /* Support for installing tracepoints while a trace experiment is
2141 PACKET_InstallInTrace
,
2145 PACKET_TracepointSource
,
2148 PACKET_QDisableRandomization
,
2150 PACKET_QTBuffer_size
,
2154 PACKET_qXfer_btrace
,
2156 /* Support for the QNonStop packet. */
2159 /* Support for the QThreadEvents packet. */
2160 PACKET_QThreadEvents
,
2162 /* Support for multi-process extensions. */
2163 PACKET_multiprocess_feature
,
2165 /* Support for enabling and disabling tracepoints while a trace
2166 experiment is running. */
2167 PACKET_EnableDisableTracepoints_feature
,
2169 /* Support for collecting strings using the tracenz bytecode. */
2170 PACKET_tracenz_feature
,
2172 /* Support for continuing to run a trace experiment while GDB is
2174 PACKET_DisconnectedTracing_feature
,
2176 /* Support for qXfer:libraries-svr4:read with a non-empty annex. */
2177 PACKET_augmented_libraries_svr4_read_feature
,
2179 /* Support for the qXfer:btrace-conf:read packet. */
2180 PACKET_qXfer_btrace_conf
,
2182 /* Support for the Qbtrace-conf:bts:size packet. */
2183 PACKET_Qbtrace_conf_bts_size
,
2185 /* Support for swbreak+ feature. */
2186 PACKET_swbreak_feature
,
2188 /* Support for hwbreak+ feature. */
2189 PACKET_hwbreak_feature
,
2191 /* Support for fork events. */
2192 PACKET_fork_event_feature
,
2194 /* Support for vfork events. */
2195 PACKET_vfork_event_feature
,
2197 /* Support for the Qbtrace-conf:pt:size packet. */
2198 PACKET_Qbtrace_conf_pt_size
,
2200 /* Support for exec events. */
2201 PACKET_exec_event_feature
,
2203 /* Support for query supported vCont actions. */
2204 PACKET_vContSupported
,
2206 /* Support remote CTRL-C. */
2209 /* Support TARGET_WAITKIND_NO_RESUMED. */
2212 /* Support for memory tagging, allocation tag fetch/store
2213 packets and the tag violation stop replies. */
2214 PACKET_memory_tagging_feature
,
2219 /* FIXME: needs to be per-remote-target. Ignoring this for now,
2220 assuming all remote targets are the same server (thus all support
2221 the same packets). */
2222 static struct packet_config remote_protocol_packets
[PACKET_MAX
];
2224 /* Returns the packet's corresponding "set remote foo-packet" command
2225 state. See struct packet_config for more details. */
2227 static enum auto_boolean
2228 packet_set_cmd_state (int packet
)
2230 return remote_protocol_packets
[packet
].detect
;
2233 /* Returns whether a given packet or feature is supported. This takes
2234 into account the state of the corresponding "set remote foo-packet"
2235 command, which may be used to bypass auto-detection. */
2237 static enum packet_support
2238 packet_config_support (struct packet_config
*config
)
2240 switch (config
->detect
)
2242 case AUTO_BOOLEAN_TRUE
:
2243 return PACKET_ENABLE
;
2244 case AUTO_BOOLEAN_FALSE
:
2245 return PACKET_DISABLE
;
2246 case AUTO_BOOLEAN_AUTO
:
2247 return config
->support
;
2249 gdb_assert_not_reached ("bad switch");
2253 /* Same as packet_config_support, but takes the packet's enum value as
2256 static enum packet_support
2257 packet_support (int packet
)
2259 struct packet_config
*config
= &remote_protocol_packets
[packet
];
2261 return packet_config_support (config
);
2265 show_remote_protocol_packet_cmd (struct ui_file
*file
, int from_tty
,
2266 struct cmd_list_element
*c
,
2269 struct packet_config
*packet
;
2270 gdb_assert (c
->var
.has_value ());
2272 for (packet
= remote_protocol_packets
;
2273 packet
< &remote_protocol_packets
[PACKET_MAX
];
2276 if (c
== packet
->show_cmd
)
2278 show_packet_config_cmd (file
, packet
);
2282 internal_error (__FILE__
, __LINE__
, _("Could not find config for %s"),
2286 /* Should we try one of the 'Z' requests? */
2290 Z_PACKET_SOFTWARE_BP
,
2291 Z_PACKET_HARDWARE_BP
,
2298 /* For compatibility with older distributions. Provide a ``set remote
2299 Z-packet ...'' command that updates all the Z packet types. */
2301 static enum auto_boolean remote_Z_packet_detect
;
2304 set_remote_protocol_Z_packet_cmd (const char *args
, int from_tty
,
2305 struct cmd_list_element
*c
)
2309 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
2310 remote_protocol_packets
[PACKET_Z0
+ i
].detect
= remote_Z_packet_detect
;
2314 show_remote_protocol_Z_packet_cmd (struct ui_file
*file
, int from_tty
,
2315 struct cmd_list_element
*c
,
2320 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
2322 show_packet_config_cmd (file
, &remote_protocol_packets
[PACKET_Z0
+ i
]);
2326 /* Returns true if the multi-process extensions are in effect. */
2329 remote_multi_process_p (struct remote_state
*rs
)
2331 return packet_support (PACKET_multiprocess_feature
) == PACKET_ENABLE
;
2334 /* Returns true if fork events are supported. */
2337 remote_fork_event_p (struct remote_state
*rs
)
2339 return packet_support (PACKET_fork_event_feature
) == PACKET_ENABLE
;
2342 /* Returns true if vfork events are supported. */
2345 remote_vfork_event_p (struct remote_state
*rs
)
2347 return packet_support (PACKET_vfork_event_feature
) == PACKET_ENABLE
;
2350 /* Returns true if exec events are supported. */
2353 remote_exec_event_p (struct remote_state
*rs
)
2355 return packet_support (PACKET_exec_event_feature
) == PACKET_ENABLE
;
2358 /* Returns true if memory tagging is supported, false otherwise. */
2361 remote_memory_tagging_p ()
2363 return packet_support (PACKET_memory_tagging_feature
) == PACKET_ENABLE
;
2366 /* Insert fork catchpoint target routine. If fork events are enabled
2367 then return success, nothing more to do. */
2370 remote_target::insert_fork_catchpoint (int pid
)
2372 struct remote_state
*rs
= get_remote_state ();
2374 return !remote_fork_event_p (rs
);
2377 /* Remove fork catchpoint target routine. Nothing to do, just
2381 remote_target::remove_fork_catchpoint (int pid
)
2386 /* Insert vfork catchpoint target routine. If vfork events are enabled
2387 then return success, nothing more to do. */
2390 remote_target::insert_vfork_catchpoint (int pid
)
2392 struct remote_state
*rs
= get_remote_state ();
2394 return !remote_vfork_event_p (rs
);
2397 /* Remove vfork catchpoint target routine. Nothing to do, just
2401 remote_target::remove_vfork_catchpoint (int pid
)
2406 /* Insert exec catchpoint target routine. If exec events are
2407 enabled, just return success. */
2410 remote_target::insert_exec_catchpoint (int pid
)
2412 struct remote_state
*rs
= get_remote_state ();
2414 return !remote_exec_event_p (rs
);
2417 /* Remove exec catchpoint target routine. Nothing to do, just
2421 remote_target::remove_exec_catchpoint (int pid
)
2428 /* Take advantage of the fact that the TID field is not used, to tag
2429 special ptids with it set to != 0. */
2430 static const ptid_t
magic_null_ptid (42000, -1, 1);
2431 static const ptid_t
not_sent_ptid (42000, -2, 1);
2432 static const ptid_t
any_thread_ptid (42000, 0, 1);
2434 /* Find out if the stub attached to PID (and hence GDB should offer to
2435 detach instead of killing it when bailing out). */
2438 remote_target::remote_query_attached (int pid
)
2440 struct remote_state
*rs
= get_remote_state ();
2441 size_t size
= get_remote_packet_size ();
2443 if (packet_support (PACKET_qAttached
) == PACKET_DISABLE
)
2446 if (remote_multi_process_p (rs
))
2447 xsnprintf (rs
->buf
.data (), size
, "qAttached:%x", pid
);
2449 xsnprintf (rs
->buf
.data (), size
, "qAttached");
2452 getpkt (&rs
->buf
, 0);
2454 switch (packet_ok (rs
->buf
,
2455 &remote_protocol_packets
[PACKET_qAttached
]))
2458 if (strcmp (rs
->buf
.data (), "1") == 0)
2462 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
2464 case PACKET_UNKNOWN
:
2471 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
2472 has been invented by GDB, instead of reported by the target. Since
2473 we can be connected to a remote system before before knowing about
2474 any inferior, mark the target with execution when we find the first
2475 inferior. If ATTACHED is 1, then we had just attached to this
2476 inferior. If it is 0, then we just created this inferior. If it
2477 is -1, then try querying the remote stub to find out if it had
2478 attached to the inferior or not. If TRY_OPEN_EXEC is true then
2479 attempt to open this inferior's executable as the main executable
2480 if no main executable is open already. */
2483 remote_target::remote_add_inferior (bool fake_pid_p
, int pid
, int attached
,
2486 struct inferior
*inf
;
2488 /* Check whether this process we're learning about is to be
2489 considered attached, or if is to be considered to have been
2490 spawned by the stub. */
2492 attached
= remote_query_attached (pid
);
2494 if (gdbarch_has_global_solist (target_gdbarch ()))
2496 /* If the target shares code across all inferiors, then every
2497 attach adds a new inferior. */
2498 inf
= add_inferior (pid
);
2500 /* ... and every inferior is bound to the same program space.
2501 However, each inferior may still have its own address
2503 inf
->aspace
= maybe_new_address_space ();
2504 inf
->pspace
= current_program_space
;
2508 /* In the traditional debugging scenario, there's a 1-1 match
2509 between program/address spaces. We simply bind the inferior
2510 to the program space's address space. */
2511 inf
= current_inferior ();
2513 /* However, if the current inferior is already bound to a
2514 process, find some other empty inferior. */
2518 for (inferior
*it
: all_inferiors ())
2527 /* Since all inferiors were already bound to a process, add
2529 inf
= add_inferior_with_spaces ();
2531 switch_to_inferior_no_thread (inf
);
2532 inf
->push_target (this);
2533 inferior_appeared (inf
, pid
);
2536 inf
->attach_flag
= attached
;
2537 inf
->fake_pid_p
= fake_pid_p
;
2539 /* If no main executable is currently open then attempt to
2540 open the file that was executed to create this inferior. */
2541 if (try_open_exec
&& get_exec_file (0) == NULL
)
2542 exec_file_locate_attach (pid
, 0, 1);
2544 /* Check for exec file mismatch, and let the user solve it. */
2545 validate_exec_file (1);
2550 static remote_thread_info
*get_remote_thread_info (thread_info
*thread
);
2551 static remote_thread_info
*get_remote_thread_info (remote_target
*target
,
2554 /* Add thread PTID to GDB's thread list. Tag it as executing/running
2555 according to EXECUTING and RUNNING respectively. If SILENT_P (or the
2556 remote_state::starting_up flag) is true then the new thread is added
2557 silently, otherwise the new thread will be announced to the user. */
2560 remote_target::remote_add_thread (ptid_t ptid
, bool running
, bool executing
,
2563 struct remote_state
*rs
= get_remote_state ();
2564 struct thread_info
*thread
;
2566 /* GDB historically didn't pull threads in the initial connection
2567 setup. If the remote target doesn't even have a concept of
2568 threads (e.g., a bare-metal target), even if internally we
2569 consider that a single-threaded target, mentioning a new thread
2570 might be confusing to the user. Be silent then, preserving the
2571 age old behavior. */
2572 if (rs
->starting_up
|| silent_p
)
2573 thread
= add_thread_silent (this, ptid
);
2575 thread
= add_thread (this, ptid
);
2577 /* We start by assuming threads are resumed. That state then gets updated
2578 when we process a matching stop reply. */
2579 get_remote_thread_info (thread
)->set_resumed ();
2581 set_executing (this, ptid
, executing
);
2582 set_running (this, ptid
, running
);
2587 /* Come here when we learn about a thread id from the remote target.
2588 It may be the first time we hear about such thread, so take the
2589 opportunity to add it to GDB's thread list. In case this is the
2590 first time we're noticing its corresponding inferior, add it to
2591 GDB's inferior list as well. EXECUTING indicates whether the
2592 thread is (internally) executing or stopped. */
2595 remote_target::remote_notice_new_inferior (ptid_t currthread
, bool executing
)
2597 /* In non-stop mode, we assume new found threads are (externally)
2598 running until proven otherwise with a stop reply. In all-stop,
2599 we can only get here if all threads are stopped. */
2600 bool running
= target_is_non_stop_p ();
2602 /* If this is a new thread, add it to GDB's thread list.
2603 If we leave it up to WFI to do this, bad things will happen. */
2605 thread_info
*tp
= find_thread_ptid (this, currthread
);
2606 if (tp
!= NULL
&& tp
->state
== THREAD_EXITED
)
2608 /* We're seeing an event on a thread id we knew had exited.
2609 This has to be a new thread reusing the old id. Add it. */
2610 remote_add_thread (currthread
, running
, executing
, false);
2614 if (!in_thread_list (this, currthread
))
2616 struct inferior
*inf
= NULL
;
2617 int pid
= currthread
.pid ();
2619 if (inferior_ptid
.is_pid ()
2620 && pid
== inferior_ptid
.pid ())
2622 /* inferior_ptid has no thread member yet. This can happen
2623 with the vAttach -> remote_wait,"TAAthread:" path if the
2624 stub doesn't support qC. This is the first stop reported
2625 after an attach, so this is the main thread. Update the
2626 ptid in the thread list. */
2627 if (in_thread_list (this, ptid_t (pid
)))
2628 thread_change_ptid (this, inferior_ptid
, currthread
);
2632 = remote_add_thread (currthread
, running
, executing
, false);
2633 switch_to_thread (thr
);
2638 if (magic_null_ptid
== inferior_ptid
)
2640 /* inferior_ptid is not set yet. This can happen with the
2641 vRun -> remote_wait,"TAAthread:" path if the stub
2642 doesn't support qC. This is the first stop reported
2643 after an attach, so this is the main thread. Update the
2644 ptid in the thread list. */
2645 thread_change_ptid (this, inferior_ptid
, currthread
);
2649 /* When connecting to a target remote, or to a target
2650 extended-remote which already was debugging an inferior, we
2651 may not know about it yet. Add it before adding its child
2652 thread, so notifications are emitted in a sensible order. */
2653 if (find_inferior_pid (this, currthread
.pid ()) == NULL
)
2655 struct remote_state
*rs
= get_remote_state ();
2656 bool fake_pid_p
= !remote_multi_process_p (rs
);
2658 inf
= remote_add_inferior (fake_pid_p
,
2659 currthread
.pid (), -1, 1);
2662 /* This is really a new thread. Add it. */
2663 thread_info
*new_thr
2664 = remote_add_thread (currthread
, running
, executing
, false);
2666 /* If we found a new inferior, let the common code do whatever
2667 it needs to with it (e.g., read shared libraries, insert
2668 breakpoints), unless we're just setting up an all-stop
2672 struct remote_state
*rs
= get_remote_state ();
2674 if (!rs
->starting_up
)
2675 notice_new_inferior (new_thr
, executing
, 0);
2680 /* Return THREAD's private thread data, creating it if necessary. */
2682 static remote_thread_info
*
2683 get_remote_thread_info (thread_info
*thread
)
2685 gdb_assert (thread
!= NULL
);
2687 if (thread
->priv
== NULL
)
2688 thread
->priv
.reset (new remote_thread_info
);
2690 return static_cast<remote_thread_info
*> (thread
->priv
.get ());
2693 /* Return PTID's private thread data, creating it if necessary. */
2695 static remote_thread_info
*
2696 get_remote_thread_info (remote_target
*target
, ptid_t ptid
)
2698 thread_info
*thr
= find_thread_ptid (target
, ptid
);
2699 return get_remote_thread_info (thr
);
2702 /* Call this function as a result of
2703 1) A halt indication (T packet) containing a thread id
2704 2) A direct query of currthread
2705 3) Successful execution of set thread */
2708 record_currthread (struct remote_state
*rs
, ptid_t currthread
)
2710 rs
->general_thread
= currthread
;
2713 /* If 'QPassSignals' is supported, tell the remote stub what signals
2714 it can simply pass through to the inferior without reporting. */
2717 remote_target::pass_signals (gdb::array_view
<const unsigned char> pass_signals
)
2719 if (packet_support (PACKET_QPassSignals
) != PACKET_DISABLE
)
2721 char *pass_packet
, *p
;
2723 struct remote_state
*rs
= get_remote_state ();
2725 gdb_assert (pass_signals
.size () < 256);
2726 for (size_t i
= 0; i
< pass_signals
.size (); i
++)
2728 if (pass_signals
[i
])
2731 pass_packet
= (char *) xmalloc (count
* 3 + strlen ("QPassSignals:") + 1);
2732 strcpy (pass_packet
, "QPassSignals:");
2733 p
= pass_packet
+ strlen (pass_packet
);
2734 for (size_t i
= 0; i
< pass_signals
.size (); i
++)
2736 if (pass_signals
[i
])
2739 *p
++ = tohex (i
>> 4);
2740 *p
++ = tohex (i
& 15);
2749 if (!rs
->last_pass_packet
|| strcmp (rs
->last_pass_packet
, pass_packet
))
2751 putpkt (pass_packet
);
2752 getpkt (&rs
->buf
, 0);
2753 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QPassSignals
]);
2754 xfree (rs
->last_pass_packet
);
2755 rs
->last_pass_packet
= pass_packet
;
2758 xfree (pass_packet
);
2762 /* If 'QCatchSyscalls' is supported, tell the remote stub
2763 to report syscalls to GDB. */
2766 remote_target::set_syscall_catchpoint (int pid
, bool needed
, int any_count
,
2767 gdb::array_view
<const int> syscall_counts
)
2769 const char *catch_packet
;
2770 enum packet_result result
;
2773 if (packet_support (PACKET_QCatchSyscalls
) == PACKET_DISABLE
)
2775 /* Not supported. */
2779 if (needed
&& any_count
== 0)
2781 /* Count how many syscalls are to be caught. */
2782 for (size_t i
= 0; i
< syscall_counts
.size (); i
++)
2784 if (syscall_counts
[i
] != 0)
2789 remote_debug_printf ("pid %d needed %d any_count %d n_sysno %d",
2790 pid
, needed
, any_count
, n_sysno
);
2792 std::string built_packet
;
2795 /* Prepare a packet with the sysno list, assuming max 8+1
2796 characters for a sysno. If the resulting packet size is too
2797 big, fallback on the non-selective packet. */
2798 const int maxpktsz
= strlen ("QCatchSyscalls:1") + n_sysno
* 9 + 1;
2799 built_packet
.reserve (maxpktsz
);
2800 built_packet
= "QCatchSyscalls:1";
2803 /* Add in each syscall to be caught. */
2804 for (size_t i
= 0; i
< syscall_counts
.size (); i
++)
2806 if (syscall_counts
[i
] != 0)
2807 string_appendf (built_packet
, ";%zx", i
);
2810 if (built_packet
.size () > get_remote_packet_size ())
2812 /* catch_packet too big. Fallback to less efficient
2813 non selective mode, with GDB doing the filtering. */
2814 catch_packet
= "QCatchSyscalls:1";
2817 catch_packet
= built_packet
.c_str ();
2820 catch_packet
= "QCatchSyscalls:0";
2822 struct remote_state
*rs
= get_remote_state ();
2824 putpkt (catch_packet
);
2825 getpkt (&rs
->buf
, 0);
2826 result
= packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QCatchSyscalls
]);
2827 if (result
== PACKET_OK
)
2833 /* If 'QProgramSignals' is supported, tell the remote stub what
2834 signals it should pass through to the inferior when detaching. */
2837 remote_target::program_signals (gdb::array_view
<const unsigned char> signals
)
2839 if (packet_support (PACKET_QProgramSignals
) != PACKET_DISABLE
)
2843 struct remote_state
*rs
= get_remote_state ();
2845 gdb_assert (signals
.size () < 256);
2846 for (size_t i
= 0; i
< signals
.size (); i
++)
2851 packet
= (char *) xmalloc (count
* 3 + strlen ("QProgramSignals:") + 1);
2852 strcpy (packet
, "QProgramSignals:");
2853 p
= packet
+ strlen (packet
);
2854 for (size_t i
= 0; i
< signals
.size (); i
++)
2856 if (signal_pass_state (i
))
2859 *p
++ = tohex (i
>> 4);
2860 *p
++ = tohex (i
& 15);
2869 if (!rs
->last_program_signals_packet
2870 || strcmp (rs
->last_program_signals_packet
, packet
) != 0)
2873 getpkt (&rs
->buf
, 0);
2874 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QProgramSignals
]);
2875 xfree (rs
->last_program_signals_packet
);
2876 rs
->last_program_signals_packet
= packet
;
2883 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
2884 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
2885 thread. If GEN is set, set the general thread, if not, then set
2886 the step/continue thread. */
2888 remote_target::set_thread (ptid_t ptid
, int gen
)
2890 struct remote_state
*rs
= get_remote_state ();
2891 ptid_t state
= gen
? rs
->general_thread
: rs
->continue_thread
;
2892 char *buf
= rs
->buf
.data ();
2893 char *endbuf
= buf
+ get_remote_packet_size ();
2899 *buf
++ = gen
? 'g' : 'c';
2900 if (ptid
== magic_null_ptid
)
2901 xsnprintf (buf
, endbuf
- buf
, "0");
2902 else if (ptid
== any_thread_ptid
)
2903 xsnprintf (buf
, endbuf
- buf
, "0");
2904 else if (ptid
== minus_one_ptid
)
2905 xsnprintf (buf
, endbuf
- buf
, "-1");
2907 write_ptid (buf
, endbuf
, ptid
);
2909 getpkt (&rs
->buf
, 0);
2911 rs
->general_thread
= ptid
;
2913 rs
->continue_thread
= ptid
;
2917 remote_target::set_general_thread (ptid_t ptid
)
2919 set_thread (ptid
, 1);
2923 remote_target::set_continue_thread (ptid_t ptid
)
2925 set_thread (ptid
, 0);
2928 /* Change the remote current process. Which thread within the process
2929 ends up selected isn't important, as long as it is the same process
2930 as what INFERIOR_PTID points to.
2932 This comes from that fact that there is no explicit notion of
2933 "selected process" in the protocol. The selected process for
2934 general operations is the process the selected general thread
2938 remote_target::set_general_process ()
2940 struct remote_state
*rs
= get_remote_state ();
2942 /* If the remote can't handle multiple processes, don't bother. */
2943 if (!remote_multi_process_p (rs
))
2946 /* We only need to change the remote current thread if it's pointing
2947 at some other process. */
2948 if (rs
->general_thread
.pid () != inferior_ptid
.pid ())
2949 set_general_thread (inferior_ptid
);
2953 /* Return nonzero if this is the main thread that we made up ourselves
2954 to model non-threaded targets as single-threaded. */
2957 remote_thread_always_alive (ptid_t ptid
)
2959 if (ptid
== magic_null_ptid
)
2960 /* The main thread is always alive. */
2963 if (ptid
.pid () != 0 && ptid
.lwp () == 0)
2964 /* The main thread is always alive. This can happen after a
2965 vAttach, if the remote side doesn't support
2972 /* Return nonzero if the thread PTID is still alive on the remote
2976 remote_target::thread_alive (ptid_t ptid
)
2978 struct remote_state
*rs
= get_remote_state ();
2981 /* Check if this is a thread that we made up ourselves to model
2982 non-threaded targets as single-threaded. */
2983 if (remote_thread_always_alive (ptid
))
2986 p
= rs
->buf
.data ();
2987 endp
= p
+ get_remote_packet_size ();
2990 write_ptid (p
, endp
, ptid
);
2993 getpkt (&rs
->buf
, 0);
2994 return (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K');
2997 /* Return a pointer to a thread name if we know it and NULL otherwise.
2998 The thread_info object owns the memory for the name. */
3001 remote_target::thread_name (struct thread_info
*info
)
3003 if (info
->priv
!= NULL
)
3005 const std::string
&name
= get_remote_thread_info (info
)->name
;
3006 return !name
.empty () ? name
.c_str () : NULL
;
3012 /* About these extended threadlist and threadinfo packets. They are
3013 variable length packets but, the fields within them are often fixed
3014 length. They are redundant enough to send over UDP as is the
3015 remote protocol in general. There is a matching unit test module
3018 /* WARNING: This threadref data structure comes from the remote O.S.,
3019 libstub protocol encoding, and remote.c. It is not particularly
3022 /* Right now, the internal structure is int. We want it to be bigger.
3023 Plan to fix this. */
3025 typedef int gdb_threadref
; /* Internal GDB thread reference. */
3027 /* gdb_ext_thread_info is an internal GDB data structure which is
3028 equivalent to the reply of the remote threadinfo packet. */
3030 struct gdb_ext_thread_info
3032 threadref threadid
; /* External form of thread reference. */
3033 int active
; /* Has state interesting to GDB?
3035 char display
[256]; /* Brief state display, name,
3036 blocked/suspended. */
3037 char shortname
[32]; /* To be used to name threads. */
3038 char more_display
[256]; /* Long info, statistics, queue depth,
3042 /* The volume of remote transfers can be limited by submitting
3043 a mask containing bits specifying the desired information.
3044 Use a union of these values as the 'selection' parameter to
3045 get_thread_info. FIXME: Make these TAG names more thread specific. */
3047 #define TAG_THREADID 1
3048 #define TAG_EXISTS 2
3049 #define TAG_DISPLAY 4
3050 #define TAG_THREADNAME 8
3051 #define TAG_MOREDISPLAY 16
3053 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
3055 static const char *unpack_nibble (const char *buf
, int *val
);
3057 static const char *unpack_byte (const char *buf
, int *value
);
3059 static char *pack_int (char *buf
, int value
);
3061 static const char *unpack_int (const char *buf
, int *value
);
3063 static const char *unpack_string (const char *src
, char *dest
, int length
);
3065 static char *pack_threadid (char *pkt
, threadref
*id
);
3067 static const char *unpack_threadid (const char *inbuf
, threadref
*id
);
3069 void int_to_threadref (threadref
*id
, int value
);
3071 static int threadref_to_int (threadref
*ref
);
3073 static void copy_threadref (threadref
*dest
, threadref
*src
);
3075 static int threadmatch (threadref
*dest
, threadref
*src
);
3077 static char *pack_threadinfo_request (char *pkt
, int mode
,
3080 static char *pack_threadlist_request (char *pkt
, int startflag
,
3082 threadref
*nextthread
);
3084 static int remote_newthread_step (threadref
*ref
, void *context
);
3087 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
3088 buffer we're allowed to write to. Returns
3089 BUF+CHARACTERS_WRITTEN. */
3092 remote_target::write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
)
3095 struct remote_state
*rs
= get_remote_state ();
3097 if (remote_multi_process_p (rs
))
3101 buf
+= xsnprintf (buf
, endbuf
- buf
, "p-%x.", -pid
);
3103 buf
+= xsnprintf (buf
, endbuf
- buf
, "p%x.", pid
);
3107 buf
+= xsnprintf (buf
, endbuf
- buf
, "-%x", -tid
);
3109 buf
+= xsnprintf (buf
, endbuf
- buf
, "%x", tid
);
3114 /* Extract a PTID from BUF. If non-null, OBUF is set to one past the
3115 last parsed char. Returns null_ptid if no thread id is found, and
3116 throws an error if the thread id has an invalid format. */
3119 read_ptid (const char *buf
, const char **obuf
)
3121 const char *p
= buf
;
3123 ULONGEST pid
= 0, tid
= 0;
3127 /* Multi-process ptid. */
3128 pp
= unpack_varlen_hex (p
+ 1, &pid
);
3130 error (_("invalid remote ptid: %s"), p
);
3133 pp
= unpack_varlen_hex (p
+ 1, &tid
);
3136 return ptid_t (pid
, tid
);
3139 /* No multi-process. Just a tid. */
3140 pp
= unpack_varlen_hex (p
, &tid
);
3142 /* Return null_ptid when no thread id is found. */
3150 /* Since the stub is not sending a process id, default to what's
3151 current_inferior, unless it doesn't have a PID yet. If so,
3152 then since there's no way to know the pid of the reported
3153 threads, use the magic number. */
3154 inferior
*inf
= current_inferior ();
3156 pid
= magic_null_ptid
.pid ();
3162 return ptid_t (pid
, tid
);
3168 if (ch
>= 'a' && ch
<= 'f')
3169 return ch
- 'a' + 10;
3170 if (ch
>= '0' && ch
<= '9')
3172 if (ch
>= 'A' && ch
<= 'F')
3173 return ch
- 'A' + 10;
3178 stub_unpack_int (const char *buff
, int fieldlength
)
3185 nibble
= stubhex (*buff
++);
3189 retval
= retval
<< 4;
3195 unpack_nibble (const char *buf
, int *val
)
3197 *val
= fromhex (*buf
++);
3202 unpack_byte (const char *buf
, int *value
)
3204 *value
= stub_unpack_int (buf
, 2);
3209 pack_int (char *buf
, int value
)
3211 buf
= pack_hex_byte (buf
, (value
>> 24) & 0xff);
3212 buf
= pack_hex_byte (buf
, (value
>> 16) & 0xff);
3213 buf
= pack_hex_byte (buf
, (value
>> 8) & 0x0ff);
3214 buf
= pack_hex_byte (buf
, (value
& 0xff));
3219 unpack_int (const char *buf
, int *value
)
3221 *value
= stub_unpack_int (buf
, 8);
3225 #if 0 /* Currently unused, uncomment when needed. */
3226 static char *pack_string (char *pkt
, char *string
);
3229 pack_string (char *pkt
, char *string
)
3234 len
= strlen (string
);
3236 len
= 200; /* Bigger than most GDB packets, junk??? */
3237 pkt
= pack_hex_byte (pkt
, len
);
3241 if ((ch
== '\0') || (ch
== '#'))
3242 ch
= '*'; /* Protect encapsulation. */
3247 #endif /* 0 (unused) */
3250 unpack_string (const char *src
, char *dest
, int length
)
3259 pack_threadid (char *pkt
, threadref
*id
)
3262 unsigned char *altid
;
3264 altid
= (unsigned char *) id
;
3265 limit
= pkt
+ BUF_THREAD_ID_SIZE
;
3267 pkt
= pack_hex_byte (pkt
, *altid
++);
3273 unpack_threadid (const char *inbuf
, threadref
*id
)
3276 const char *limit
= inbuf
+ BUF_THREAD_ID_SIZE
;
3279 altref
= (char *) id
;
3281 while (inbuf
< limit
)
3283 x
= stubhex (*inbuf
++);
3284 y
= stubhex (*inbuf
++);
3285 *altref
++ = (x
<< 4) | y
;
3290 /* Externally, threadrefs are 64 bits but internally, they are still
3291 ints. This is due to a mismatch of specifications. We would like
3292 to use 64bit thread references internally. This is an adapter
3296 int_to_threadref (threadref
*id
, int value
)
3298 unsigned char *scan
;
3300 scan
= (unsigned char *) id
;
3306 *scan
++ = (value
>> 24) & 0xff;
3307 *scan
++ = (value
>> 16) & 0xff;
3308 *scan
++ = (value
>> 8) & 0xff;
3309 *scan
++ = (value
& 0xff);
3313 threadref_to_int (threadref
*ref
)
3316 unsigned char *scan
;
3322 value
= (value
<< 8) | ((*scan
++) & 0xff);
3327 copy_threadref (threadref
*dest
, threadref
*src
)
3330 unsigned char *csrc
, *cdest
;
3332 csrc
= (unsigned char *) src
;
3333 cdest
= (unsigned char *) dest
;
3340 threadmatch (threadref
*dest
, threadref
*src
)
3342 /* Things are broken right now, so just assume we got a match. */
3344 unsigned char *srcp
, *destp
;
3346 srcp
= (char *) src
;
3347 destp
= (char *) dest
;
3351 result
&= (*srcp
++ == *destp
++) ? 1 : 0;
3358 threadid:1, # always request threadid
3365 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
3368 pack_threadinfo_request (char *pkt
, int mode
, threadref
*id
)
3370 *pkt
++ = 'q'; /* Info Query */
3371 *pkt
++ = 'P'; /* process or thread info */
3372 pkt
= pack_int (pkt
, mode
); /* mode */
3373 pkt
= pack_threadid (pkt
, id
); /* threadid */
3374 *pkt
= '\0'; /* terminate */
3378 /* These values tag the fields in a thread info response packet. */
3379 /* Tagging the fields allows us to request specific fields and to
3380 add more fields as time goes by. */
3382 #define TAG_THREADID 1 /* Echo the thread identifier. */
3383 #define TAG_EXISTS 2 /* Is this process defined enough to
3384 fetch registers and its stack? */
3385 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
3386 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
3387 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
3391 remote_target::remote_unpack_thread_info_response (const char *pkt
,
3392 threadref
*expectedref
,
3393 gdb_ext_thread_info
*info
)
3395 struct remote_state
*rs
= get_remote_state ();
3399 const char *limit
= pkt
+ rs
->buf
.size (); /* Plausible parsing limit. */
3402 /* info->threadid = 0; FIXME: implement zero_threadref. */
3404 info
->display
[0] = '\0';
3405 info
->shortname
[0] = '\0';
3406 info
->more_display
[0] = '\0';
3408 /* Assume the characters indicating the packet type have been
3410 pkt
= unpack_int (pkt
, &mask
); /* arg mask */
3411 pkt
= unpack_threadid (pkt
, &ref
);
3414 warning (_("Incomplete response to threadinfo request."));
3415 if (!threadmatch (&ref
, expectedref
))
3416 { /* This is an answer to a different request. */
3417 warning (_("ERROR RMT Thread info mismatch."));
3420 copy_threadref (&info
->threadid
, &ref
);
3422 /* Loop on tagged fields , try to bail if something goes wrong. */
3424 /* Packets are terminated with nulls. */
3425 while ((pkt
< limit
) && mask
&& *pkt
)
3427 pkt
= unpack_int (pkt
, &tag
); /* tag */
3428 pkt
= unpack_byte (pkt
, &length
); /* length */
3429 if (!(tag
& mask
)) /* Tags out of synch with mask. */
3431 warning (_("ERROR RMT: threadinfo tag mismatch."));
3435 if (tag
== TAG_THREADID
)
3439 warning (_("ERROR RMT: length of threadid is not 16."));
3443 pkt
= unpack_threadid (pkt
, &ref
);
3444 mask
= mask
& ~TAG_THREADID
;
3447 if (tag
== TAG_EXISTS
)
3449 info
->active
= stub_unpack_int (pkt
, length
);
3451 mask
= mask
& ~(TAG_EXISTS
);
3454 warning (_("ERROR RMT: 'exists' length too long."));
3460 if (tag
== TAG_THREADNAME
)
3462 pkt
= unpack_string (pkt
, &info
->shortname
[0], length
);
3463 mask
= mask
& ~TAG_THREADNAME
;
3466 if (tag
== TAG_DISPLAY
)
3468 pkt
= unpack_string (pkt
, &info
->display
[0], length
);
3469 mask
= mask
& ~TAG_DISPLAY
;
3472 if (tag
== TAG_MOREDISPLAY
)
3474 pkt
= unpack_string (pkt
, &info
->more_display
[0], length
);
3475 mask
= mask
& ~TAG_MOREDISPLAY
;
3478 warning (_("ERROR RMT: unknown thread info tag."));
3479 break; /* Not a tag we know about. */
3485 remote_target::remote_get_threadinfo (threadref
*threadid
,
3487 gdb_ext_thread_info
*info
)
3489 struct remote_state
*rs
= get_remote_state ();
3492 pack_threadinfo_request (rs
->buf
.data (), fieldset
, threadid
);
3494 getpkt (&rs
->buf
, 0);
3496 if (rs
->buf
[0] == '\0')
3499 result
= remote_unpack_thread_info_response (&rs
->buf
[2],
3504 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
3507 pack_threadlist_request (char *pkt
, int startflag
, int threadcount
,
3508 threadref
*nextthread
)
3510 *pkt
++ = 'q'; /* info query packet */
3511 *pkt
++ = 'L'; /* Process LIST or threadLIST request */
3512 pkt
= pack_nibble (pkt
, startflag
); /* initflag 1 bytes */
3513 pkt
= pack_hex_byte (pkt
, threadcount
); /* threadcount 2 bytes */
3514 pkt
= pack_threadid (pkt
, nextthread
); /* 64 bit thread identifier */
3519 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
3522 remote_target::parse_threadlist_response (const char *pkt
, int result_limit
,
3523 threadref
*original_echo
,
3524 threadref
*resultlist
,
3527 struct remote_state
*rs
= get_remote_state ();
3528 int count
, resultcount
, done
;
3531 /* Assume the 'q' and 'M chars have been stripped. */
3532 const char *limit
= pkt
+ (rs
->buf
.size () - BUF_THREAD_ID_SIZE
);
3533 /* done parse past here */
3534 pkt
= unpack_byte (pkt
, &count
); /* count field */
3535 pkt
= unpack_nibble (pkt
, &done
);
3536 /* The first threadid is the argument threadid. */
3537 pkt
= unpack_threadid (pkt
, original_echo
); /* should match query packet */
3538 while ((count
-- > 0) && (pkt
< limit
))
3540 pkt
= unpack_threadid (pkt
, resultlist
++);
3541 if (resultcount
++ >= result_limit
)
3549 /* Fetch the next batch of threads from the remote. Returns -1 if the
3550 qL packet is not supported, 0 on error and 1 on success. */
3553 remote_target::remote_get_threadlist (int startflag
, threadref
*nextthread
,
3554 int result_limit
, int *done
, int *result_count
,
3555 threadref
*threadlist
)
3557 struct remote_state
*rs
= get_remote_state ();
3560 /* Truncate result limit to be smaller than the packet size. */
3561 if ((((result_limit
+ 1) * BUF_THREAD_ID_SIZE
) + 10)
3562 >= get_remote_packet_size ())
3563 result_limit
= (get_remote_packet_size () / BUF_THREAD_ID_SIZE
) - 2;
3565 pack_threadlist_request (rs
->buf
.data (), startflag
, result_limit
,
3568 getpkt (&rs
->buf
, 0);
3569 if (rs
->buf
[0] == '\0')
3571 /* Packet not supported. */
3576 parse_threadlist_response (&rs
->buf
[2], result_limit
,
3577 &rs
->echo_nextthread
, threadlist
, done
);
3579 if (!threadmatch (&rs
->echo_nextthread
, nextthread
))
3581 /* FIXME: This is a good reason to drop the packet. */
3582 /* Possibly, there is a duplicate response. */
3584 retransmit immediatly - race conditions
3585 retransmit after timeout - yes
3587 wait for packet, then exit
3589 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
3590 return 0; /* I choose simply exiting. */
3592 if (*result_count
<= 0)
3596 warning (_("RMT ERROR : failed to get remote thread list."));
3599 return result
; /* break; */
3601 if (*result_count
> result_limit
)
3604 warning (_("RMT ERROR: threadlist response longer than requested."));
3610 /* Fetch the list of remote threads, with the qL packet, and call
3611 STEPFUNCTION for each thread found. Stops iterating and returns 1
3612 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
3613 STEPFUNCTION returns false. If the packet is not supported,
3617 remote_target::remote_threadlist_iterator (rmt_thread_action stepfunction
,
3618 void *context
, int looplimit
)
3620 struct remote_state
*rs
= get_remote_state ();
3621 int done
, i
, result_count
;
3629 if (loopcount
++ > looplimit
)
3632 warning (_("Remote fetch threadlist -infinite loop-."));
3635 result
= remote_get_threadlist (startflag
, &rs
->nextthread
,
3636 MAXTHREADLISTRESULTS
,
3637 &done
, &result_count
,
3638 rs
->resultthreadlist
);
3641 /* Clear for later iterations. */
3643 /* Setup to resume next batch of thread references, set nextthread. */
3644 if (result_count
>= 1)
3645 copy_threadref (&rs
->nextthread
,
3646 &rs
->resultthreadlist
[result_count
- 1]);
3648 while (result_count
--)
3650 if (!(*stepfunction
) (&rs
->resultthreadlist
[i
++], context
))
3660 /* A thread found on the remote target. */
3664 explicit thread_item (ptid_t ptid_
)
3668 thread_item (thread_item
&&other
) = default;
3669 thread_item
&operator= (thread_item
&&other
) = default;
3671 DISABLE_COPY_AND_ASSIGN (thread_item
);
3673 /* The thread's PTID. */
3676 /* The thread's extra info. */
3679 /* The thread's name. */
3682 /* The core the thread was running on. -1 if not known. */
3685 /* The thread handle associated with the thread. */
3686 gdb::byte_vector thread_handle
;
3689 /* Context passed around to the various methods listing remote
3690 threads. As new threads are found, they're added to the ITEMS
3693 struct threads_listing_context
3695 /* Return true if this object contains an entry for a thread with ptid
3698 bool contains_thread (ptid_t ptid
) const
3700 auto match_ptid
= [&] (const thread_item
&item
)
3702 return item
.ptid
== ptid
;
3705 auto it
= std::find_if (this->items
.begin (),
3709 return it
!= this->items
.end ();
3712 /* Remove the thread with ptid PTID. */
3714 void remove_thread (ptid_t ptid
)
3716 auto match_ptid
= [&] (const thread_item
&item
)
3718 return item
.ptid
== ptid
;
3721 auto it
= std::remove_if (this->items
.begin (),
3725 if (it
!= this->items
.end ())
3726 this->items
.erase (it
);
3729 /* The threads found on the remote target. */
3730 std::vector
<thread_item
> items
;
3734 remote_newthread_step (threadref
*ref
, void *data
)
3736 struct threads_listing_context
*context
3737 = (struct threads_listing_context
*) data
;
3738 int pid
= inferior_ptid
.pid ();
3739 int lwp
= threadref_to_int (ref
);
3740 ptid_t
ptid (pid
, lwp
);
3742 context
->items
.emplace_back (ptid
);
3744 return 1; /* continue iterator */
3747 #define CRAZY_MAX_THREADS 1000
3750 remote_target::remote_current_thread (ptid_t oldpid
)
3752 struct remote_state
*rs
= get_remote_state ();
3755 getpkt (&rs
->buf
, 0);
3756 if (rs
->buf
[0] == 'Q' && rs
->buf
[1] == 'C')
3761 result
= read_ptid (&rs
->buf
[2], &obuf
);
3763 remote_debug_printf ("warning: garbage in qC reply");
3771 /* List remote threads using the deprecated qL packet. */
3774 remote_target::remote_get_threads_with_ql (threads_listing_context
*context
)
3776 if (remote_threadlist_iterator (remote_newthread_step
, context
,
3777 CRAZY_MAX_THREADS
) >= 0)
3783 #if defined(HAVE_LIBEXPAT)
3786 start_thread (struct gdb_xml_parser
*parser
,
3787 const struct gdb_xml_element
*element
,
3789 std::vector
<gdb_xml_value
> &attributes
)
3791 struct threads_listing_context
*data
3792 = (struct threads_listing_context
*) user_data
;
3793 struct gdb_xml_value
*attr
;
3795 char *id
= (char *) xml_find_attribute (attributes
, "id")->value
.get ();
3796 ptid_t ptid
= read_ptid (id
, NULL
);
3798 data
->items
.emplace_back (ptid
);
3799 thread_item
&item
= data
->items
.back ();
3801 attr
= xml_find_attribute (attributes
, "core");
3803 item
.core
= *(ULONGEST
*) attr
->value
.get ();
3805 attr
= xml_find_attribute (attributes
, "name");
3807 item
.name
= (const char *) attr
->value
.get ();
3809 attr
= xml_find_attribute (attributes
, "handle");
3811 item
.thread_handle
= hex2bin ((const char *) attr
->value
.get ());
3815 end_thread (struct gdb_xml_parser
*parser
,
3816 const struct gdb_xml_element
*element
,
3817 void *user_data
, const char *body_text
)
3819 struct threads_listing_context
*data
3820 = (struct threads_listing_context
*) user_data
;
3822 if (body_text
!= NULL
&& *body_text
!= '\0')
3823 data
->items
.back ().extra
= body_text
;
3826 const struct gdb_xml_attribute thread_attributes
[] = {
3827 { "id", GDB_XML_AF_NONE
, NULL
, NULL
},
3828 { "core", GDB_XML_AF_OPTIONAL
, gdb_xml_parse_attr_ulongest
, NULL
},
3829 { "name", GDB_XML_AF_OPTIONAL
, NULL
, NULL
},
3830 { "handle", GDB_XML_AF_OPTIONAL
, NULL
, NULL
},
3831 { NULL
, GDB_XML_AF_NONE
, NULL
, NULL
}
3834 const struct gdb_xml_element thread_children
[] = {
3835 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3838 const struct gdb_xml_element threads_children
[] = {
3839 { "thread", thread_attributes
, thread_children
,
3840 GDB_XML_EF_REPEATABLE
| GDB_XML_EF_OPTIONAL
,
3841 start_thread
, end_thread
},
3842 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3845 const struct gdb_xml_element threads_elements
[] = {
3846 { "threads", NULL
, threads_children
,
3847 GDB_XML_EF_NONE
, NULL
, NULL
},
3848 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3853 /* List remote threads using qXfer:threads:read. */
3856 remote_target::remote_get_threads_with_qxfer (threads_listing_context
*context
)
3858 #if defined(HAVE_LIBEXPAT)
3859 if (packet_support (PACKET_qXfer_threads
) == PACKET_ENABLE
)
3861 gdb::optional
<gdb::char_vector
> xml
3862 = target_read_stralloc (this, TARGET_OBJECT_THREADS
, NULL
);
3864 if (xml
&& (*xml
)[0] != '\0')
3866 gdb_xml_parse_quick (_("threads"), "threads.dtd",
3867 threads_elements
, xml
->data (), context
);
3877 /* List remote threads using qfThreadInfo/qsThreadInfo. */
3880 remote_target::remote_get_threads_with_qthreadinfo (threads_listing_context
*context
)
3882 struct remote_state
*rs
= get_remote_state ();
3884 if (rs
->use_threadinfo_query
)
3888 putpkt ("qfThreadInfo");
3889 getpkt (&rs
->buf
, 0);
3890 bufp
= rs
->buf
.data ();
3891 if (bufp
[0] != '\0') /* q packet recognized */
3893 while (*bufp
++ == 'm') /* reply contains one or more TID */
3897 ptid_t ptid
= read_ptid (bufp
, &bufp
);
3898 context
->items
.emplace_back (ptid
);
3900 while (*bufp
++ == ','); /* comma-separated list */
3901 putpkt ("qsThreadInfo");
3902 getpkt (&rs
->buf
, 0);
3903 bufp
= rs
->buf
.data ();
3909 /* Packet not recognized. */
3910 rs
->use_threadinfo_query
= 0;
3917 /* Return true if INF only has one non-exited thread. */
3920 has_single_non_exited_thread (inferior
*inf
)
3923 for (thread_info
*tp ATTRIBUTE_UNUSED
: inf
->non_exited_threads ())
3929 /* Implement the to_update_thread_list function for the remote
3933 remote_target::update_thread_list ()
3935 struct threads_listing_context context
;
3938 /* We have a few different mechanisms to fetch the thread list. Try
3939 them all, starting with the most preferred one first, falling
3940 back to older methods. */
3941 if (remote_get_threads_with_qxfer (&context
)
3942 || remote_get_threads_with_qthreadinfo (&context
)
3943 || remote_get_threads_with_ql (&context
))
3947 if (context
.items
.empty ()
3948 && remote_thread_always_alive (inferior_ptid
))
3950 /* Some targets don't really support threads, but still
3951 reply an (empty) thread list in response to the thread
3952 listing packets, instead of replying "packet not
3953 supported". Exit early so we don't delete the main
3958 /* CONTEXT now holds the current thread list on the remote
3959 target end. Delete GDB-side threads no longer found on the
3961 for (thread_info
*tp
: all_threads_safe ())
3963 if (tp
->inf
->process_target () != this)
3966 if (!context
.contains_thread (tp
->ptid
))
3968 /* Do not remove the thread if it is the last thread in
3969 the inferior. This situation happens when we have a
3970 pending exit process status to process. Otherwise we
3971 may end up with a seemingly live inferior (i.e. pid
3972 != 0) that has no threads. */
3973 if (has_single_non_exited_thread (tp
->inf
))
3981 /* Remove any unreported fork child threads from CONTEXT so
3982 that we don't interfere with follow fork, which is where
3983 creation of such threads is handled. */
3984 remove_new_fork_children (&context
);
3986 /* And now add threads we don't know about yet to our list. */
3987 for (thread_item
&item
: context
.items
)
3989 if (item
.ptid
!= null_ptid
)
3991 /* In non-stop mode, we assume new found threads are
3992 executing until proven otherwise with a stop reply.
3993 In all-stop, we can only get here if all threads are
3995 bool executing
= target_is_non_stop_p ();
3997 remote_notice_new_inferior (item
.ptid
, executing
);
3999 thread_info
*tp
= find_thread_ptid (this, item
.ptid
);
4000 remote_thread_info
*info
= get_remote_thread_info (tp
);
4001 info
->core
= item
.core
;
4002 info
->extra
= std::move (item
.extra
);
4003 info
->name
= std::move (item
.name
);
4004 info
->thread_handle
= std::move (item
.thread_handle
);
4011 /* If no thread listing method is supported, then query whether
4012 each known thread is alive, one by one, with the T packet.
4013 If the target doesn't support threads at all, then this is a
4014 no-op. See remote_thread_alive. */
4020 * Collect a descriptive string about the given thread.
4021 * The target may say anything it wants to about the thread
4022 * (typically info about its blocked / runnable state, name, etc.).
4023 * This string will appear in the info threads display.
4025 * Optional: targets are not required to implement this function.
4029 remote_target::extra_thread_info (thread_info
*tp
)
4031 struct remote_state
*rs
= get_remote_state ();
4034 struct gdb_ext_thread_info threadinfo
;
4036 if (rs
->remote_desc
== 0) /* paranoia */
4037 internal_error (__FILE__
, __LINE__
,
4038 _("remote_threads_extra_info"));
4040 if (tp
->ptid
== magic_null_ptid
4041 || (tp
->ptid
.pid () != 0 && tp
->ptid
.lwp () == 0))
4042 /* This is the main thread which was added by GDB. The remote
4043 server doesn't know about it. */
4046 std::string
&extra
= get_remote_thread_info (tp
)->extra
;
4048 /* If already have cached info, use it. */
4049 if (!extra
.empty ())
4050 return extra
.c_str ();
4052 if (packet_support (PACKET_qXfer_threads
) == PACKET_ENABLE
)
4054 /* If we're using qXfer:threads:read, then the extra info is
4055 included in the XML. So if we didn't have anything cached,
4056 it's because there's really no extra info. */
4060 if (rs
->use_threadextra_query
)
4062 char *b
= rs
->buf
.data ();
4063 char *endb
= b
+ get_remote_packet_size ();
4065 xsnprintf (b
, endb
- b
, "qThreadExtraInfo,");
4067 write_ptid (b
, endb
, tp
->ptid
);
4070 getpkt (&rs
->buf
, 0);
4071 if (rs
->buf
[0] != 0)
4073 extra
.resize (strlen (rs
->buf
.data ()) / 2);
4074 hex2bin (rs
->buf
.data (), (gdb_byte
*) &extra
[0], extra
.size ());
4075 return extra
.c_str ();
4079 /* If the above query fails, fall back to the old method. */
4080 rs
->use_threadextra_query
= 0;
4081 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
4082 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
4083 int_to_threadref (&id
, tp
->ptid
.lwp ());
4084 if (remote_get_threadinfo (&id
, set
, &threadinfo
))
4085 if (threadinfo
.active
)
4087 if (*threadinfo
.shortname
)
4088 string_appendf (extra
, " Name: %s", threadinfo
.shortname
);
4089 if (*threadinfo
.display
)
4091 if (!extra
.empty ())
4093 string_appendf (extra
, " State: %s", threadinfo
.display
);
4095 if (*threadinfo
.more_display
)
4097 if (!extra
.empty ())
4099 string_appendf (extra
, " Priority: %s", threadinfo
.more_display
);
4101 return extra
.c_str ();
4108 remote_target::static_tracepoint_marker_at (CORE_ADDR addr
,
4109 struct static_tracepoint_marker
*marker
)
4111 struct remote_state
*rs
= get_remote_state ();
4112 char *p
= rs
->buf
.data ();
4114 xsnprintf (p
, get_remote_packet_size (), "qTSTMat:");
4116 p
+= hexnumstr (p
, addr
);
4118 getpkt (&rs
->buf
, 0);
4119 p
= rs
->buf
.data ();
4122 error (_("Remote failure reply: %s"), p
);
4126 parse_static_tracepoint_marker_definition (p
, NULL
, marker
);
4133 std::vector
<static_tracepoint_marker
>
4134 remote_target::static_tracepoint_markers_by_strid (const char *strid
)
4136 struct remote_state
*rs
= get_remote_state ();
4137 std::vector
<static_tracepoint_marker
> markers
;
4139 static_tracepoint_marker marker
;
4141 /* Ask for a first packet of static tracepoint marker
4144 getpkt (&rs
->buf
, 0);
4145 p
= rs
->buf
.data ();
4147 error (_("Remote failure reply: %s"), p
);
4153 parse_static_tracepoint_marker_definition (p
, &p
, &marker
);
4155 if (strid
== NULL
|| marker
.str_id
== strid
)
4156 markers
.push_back (std::move (marker
));
4158 while (*p
++ == ','); /* comma-separated list */
4159 /* Ask for another packet of static tracepoint definition. */
4161 getpkt (&rs
->buf
, 0);
4162 p
= rs
->buf
.data ();
4169 /* Implement the to_get_ada_task_ptid function for the remote targets. */
4172 remote_target::get_ada_task_ptid (long lwp
, ULONGEST thread
)
4174 return ptid_t (inferior_ptid
.pid (), lwp
);
4178 /* Restart the remote side; this is an extended protocol operation. */
4181 remote_target::extended_remote_restart ()
4183 struct remote_state
*rs
= get_remote_state ();
4185 /* Send the restart command; for reasons I don't understand the
4186 remote side really expects a number after the "R". */
4187 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "R%x", 0);
4190 remote_fileio_reset ();
4193 /* Clean up connection to a remote debugger. */
4196 remote_target::close ()
4198 /* Make sure we leave stdin registered in the event loop. */
4201 trace_reset_local_state ();
4206 remote_target::~remote_target ()
4208 struct remote_state
*rs
= get_remote_state ();
4210 /* Check for NULL because we may get here with a partially
4211 constructed target/connection. */
4212 if (rs
->remote_desc
== nullptr)
4215 serial_close (rs
->remote_desc
);
4217 /* We are destroying the remote target, so we should discard
4218 everything of this target. */
4219 discard_pending_stop_replies_in_queue ();
4221 if (rs
->remote_async_inferior_event_token
)
4222 delete_async_event_handler (&rs
->remote_async_inferior_event_token
);
4224 delete rs
->notif_state
;
4227 /* Query the remote side for the text, data and bss offsets. */
4230 remote_target::get_offsets ()
4232 struct remote_state
*rs
= get_remote_state ();
4235 int lose
, num_segments
= 0, do_sections
, do_segments
;
4236 CORE_ADDR text_addr
, data_addr
, bss_addr
, segments
[2];
4238 if (current_program_space
->symfile_object_file
== NULL
)
4241 putpkt ("qOffsets");
4242 getpkt (&rs
->buf
, 0);
4243 buf
= rs
->buf
.data ();
4245 if (buf
[0] == '\000')
4246 return; /* Return silently. Stub doesn't support
4250 warning (_("Remote failure reply: %s"), buf
);
4254 /* Pick up each field in turn. This used to be done with scanf, but
4255 scanf will make trouble if CORE_ADDR size doesn't match
4256 conversion directives correctly. The following code will work
4257 with any size of CORE_ADDR. */
4258 text_addr
= data_addr
= bss_addr
= 0;
4262 if (startswith (ptr
, "Text="))
4265 /* Don't use strtol, could lose on big values. */
4266 while (*ptr
&& *ptr
!= ';')
4267 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
4269 if (startswith (ptr
, ";Data="))
4272 while (*ptr
&& *ptr
!= ';')
4273 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
4278 if (!lose
&& startswith (ptr
, ";Bss="))
4281 while (*ptr
&& *ptr
!= ';')
4282 bss_addr
= (bss_addr
<< 4) + fromhex (*ptr
++);
4284 if (bss_addr
!= data_addr
)
4285 warning (_("Target reported unsupported offsets: %s"), buf
);
4290 else if (startswith (ptr
, "TextSeg="))
4293 /* Don't use strtol, could lose on big values. */
4294 while (*ptr
&& *ptr
!= ';')
4295 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
4298 if (startswith (ptr
, ";DataSeg="))
4301 while (*ptr
&& *ptr
!= ';')
4302 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
4310 error (_("Malformed response to offset query, %s"), buf
);
4311 else if (*ptr
!= '\0')
4312 warning (_("Target reported unsupported offsets: %s"), buf
);
4314 objfile
*objf
= current_program_space
->symfile_object_file
;
4315 section_offsets offs
= objf
->section_offsets
;
4317 symfile_segment_data_up data
= get_symfile_segment_data (objf
->obfd
);
4318 do_segments
= (data
!= NULL
);
4319 do_sections
= num_segments
== 0;
4321 if (num_segments
> 0)
4323 segments
[0] = text_addr
;
4324 segments
[1] = data_addr
;
4326 /* If we have two segments, we can still try to relocate everything
4327 by assuming that the .text and .data offsets apply to the whole
4328 text and data segments. Convert the offsets given in the packet
4329 to base addresses for symfile_map_offsets_to_segments. */
4330 else if (data
!= nullptr && data
->segments
.size () == 2)
4332 segments
[0] = data
->segments
[0].base
+ text_addr
;
4333 segments
[1] = data
->segments
[1].base
+ data_addr
;
4336 /* If the object file has only one segment, assume that it is text
4337 rather than data; main programs with no writable data are rare,
4338 but programs with no code are useless. Of course the code might
4339 have ended up in the data segment... to detect that we would need
4340 the permissions here. */
4341 else if (data
&& data
->segments
.size () == 1)
4343 segments
[0] = data
->segments
[0].base
+ text_addr
;
4346 /* There's no way to relocate by segment. */
4352 int ret
= symfile_map_offsets_to_segments (objf
->obfd
,
4354 num_segments
, segments
);
4356 if (ret
== 0 && !do_sections
)
4357 error (_("Can not handle qOffsets TextSeg "
4358 "response with this symbol file"));
4366 offs
[SECT_OFF_TEXT (objf
)] = text_addr
;
4368 /* This is a temporary kludge to force data and bss to use the
4369 same offsets because that's what nlmconv does now. The real
4370 solution requires changes to the stub and remote.c that I
4371 don't have time to do right now. */
4373 offs
[SECT_OFF_DATA (objf
)] = data_addr
;
4374 offs
[SECT_OFF_BSS (objf
)] = data_addr
;
4377 objfile_relocate (objf
, offs
);
4380 /* Send interrupt_sequence to remote target. */
4383 remote_target::send_interrupt_sequence ()
4385 struct remote_state
*rs
= get_remote_state ();
4387 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
4388 remote_serial_write ("\x03", 1);
4389 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
4390 serial_send_break (rs
->remote_desc
);
4391 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
4393 serial_send_break (rs
->remote_desc
);
4394 remote_serial_write ("g", 1);
4397 internal_error (__FILE__
, __LINE__
,
4398 _("Invalid value for interrupt_sequence_mode: %s."),
4399 interrupt_sequence_mode
);
4403 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
4404 and extract the PTID. Returns NULL_PTID if not found. */
4407 stop_reply_extract_thread (const char *stop_reply
)
4409 if (stop_reply
[0] == 'T' && strlen (stop_reply
) > 3)
4413 /* Txx r:val ; r:val (...) */
4416 /* Look for "register" named "thread". */
4421 p1
= strchr (p
, ':');
4425 if (strncmp (p
, "thread", p1
- p
) == 0)
4426 return read_ptid (++p1
, &p
);
4428 p1
= strchr (p
, ';');
4440 /* Determine the remote side's current thread. If we have a stop
4441 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
4442 "thread" register we can extract the current thread from. If not,
4443 ask the remote which is the current thread with qC. The former
4444 method avoids a roundtrip. */
4447 remote_target::get_current_thread (const char *wait_status
)
4449 ptid_t ptid
= null_ptid
;
4451 /* Note we don't use remote_parse_stop_reply as that makes use of
4452 the target architecture, which we haven't yet fully determined at
4454 if (wait_status
!= NULL
)
4455 ptid
= stop_reply_extract_thread (wait_status
);
4456 if (ptid
== null_ptid
)
4457 ptid
= remote_current_thread (inferior_ptid
);
4462 /* Query the remote target for which is the current thread/process,
4463 add it to our tables, and update INFERIOR_PTID. The caller is
4464 responsible for setting the state such that the remote end is ready
4465 to return the current thread.
4467 This function is called after handling the '?' or 'vRun' packets,
4468 whose response is a stop reply from which we can also try
4469 extracting the thread. If the target doesn't support the explicit
4470 qC query, we infer the current thread from that stop reply, passed
4471 in in WAIT_STATUS, which may be NULL.
4473 The function returns pointer to the main thread of the inferior. */
4476 remote_target::add_current_inferior_and_thread (const char *wait_status
)
4478 struct remote_state
*rs
= get_remote_state ();
4479 bool fake_pid_p
= false;
4481 switch_to_no_thread ();
4483 /* Now, if we have thread information, update the current thread's
4485 ptid_t curr_ptid
= get_current_thread (wait_status
);
4487 if (curr_ptid
!= null_ptid
)
4489 if (!remote_multi_process_p (rs
))
4494 /* Without this, some commands which require an active target
4495 (such as kill) won't work. This variable serves (at least)
4496 double duty as both the pid of the target process (if it has
4497 such), and as a flag indicating that a target is active. */
4498 curr_ptid
= magic_null_ptid
;
4502 remote_add_inferior (fake_pid_p
, curr_ptid
.pid (), -1, 1);
4504 /* Add the main thread and switch to it. Don't try reading
4505 registers yet, since we haven't fetched the target description
4507 thread_info
*tp
= add_thread_silent (this, curr_ptid
);
4508 switch_to_thread_no_regs (tp
);
4513 /* Print info about a thread that was found already stopped on
4517 remote_target::print_one_stopped_thread (thread_info
*thread
)
4519 target_waitstatus ws
;
4521 /* If there is a pending waitstatus, use it. If there isn't it's because
4522 the thread's stop was reported with TARGET_WAITKIND_STOPPED / GDB_SIGNAL_0
4523 and process_initial_stop_replies decided it wasn't interesting to save
4524 and report to the core. */
4525 if (thread
->has_pending_waitstatus ())
4527 ws
= thread
->pending_waitstatus ();
4528 thread
->clear_pending_waitstatus ();
4532 ws
.set_stopped (GDB_SIGNAL_0
);
4535 switch_to_thread (thread
);
4536 thread
->set_stop_pc (get_frame_pc (get_current_frame ()));
4537 set_current_sal_from_frame (get_current_frame ());
4539 /* For "info program". */
4540 set_last_target_status (this, thread
->ptid
, ws
);
4542 if (ws
.kind () == TARGET_WAITKIND_STOPPED
)
4544 enum gdb_signal sig
= ws
.sig ();
4546 if (signal_print_state (sig
))
4547 gdb::observers::signal_received
.notify (sig
);
4549 gdb::observers::normal_stop
.notify (NULL
, 1);
4552 /* Process all initial stop replies the remote side sent in response
4553 to the ? packet. These indicate threads that were already stopped
4554 on initial connection. We mark these threads as stopped and print
4555 their current frame before giving the user the prompt. */
4558 remote_target::process_initial_stop_replies (int from_tty
)
4560 int pending_stop_replies
= stop_reply_queue_length ();
4561 struct thread_info
*selected
= NULL
;
4562 struct thread_info
*lowest_stopped
= NULL
;
4563 struct thread_info
*first
= NULL
;
4565 /* This is only used when the target is non-stop. */
4566 gdb_assert (target_is_non_stop_p ());
4568 /* Consume the initial pending events. */
4569 while (pending_stop_replies
-- > 0)
4571 ptid_t waiton_ptid
= minus_one_ptid
;
4573 struct target_waitstatus ws
;
4574 int ignore_event
= 0;
4576 event_ptid
= target_wait (waiton_ptid
, &ws
, TARGET_WNOHANG
);
4578 print_target_wait_results (waiton_ptid
, event_ptid
, ws
);
4582 case TARGET_WAITKIND_IGNORE
:
4583 case TARGET_WAITKIND_NO_RESUMED
:
4584 case TARGET_WAITKIND_SIGNALLED
:
4585 case TARGET_WAITKIND_EXITED
:
4586 /* We shouldn't see these, but if we do, just ignore. */
4587 remote_debug_printf ("event ignored");
4598 thread_info
*evthread
= find_thread_ptid (this, event_ptid
);
4600 if (ws
.kind () == TARGET_WAITKIND_STOPPED
)
4602 enum gdb_signal sig
= ws
.sig ();
4604 /* Stubs traditionally report SIGTRAP as initial signal,
4605 instead of signal 0. Suppress it. */
4606 if (sig
== GDB_SIGNAL_TRAP
)
4608 evthread
->set_stop_signal (sig
);
4609 ws
.set_stopped (sig
);
4612 if (ws
.kind () != TARGET_WAITKIND_STOPPED
4613 || ws
.sig () != GDB_SIGNAL_0
)
4614 evthread
->set_pending_waitstatus (ws
);
4616 set_executing (this, event_ptid
, false);
4617 set_running (this, event_ptid
, false);
4618 get_remote_thread_info (evthread
)->set_not_resumed ();
4621 /* "Notice" the new inferiors before anything related to
4622 registers/memory. */
4623 for (inferior
*inf
: all_non_exited_inferiors (this))
4625 inf
->needs_setup
= 1;
4629 thread_info
*thread
= any_live_thread_of_inferior (inf
);
4630 notice_new_inferior (thread
, thread
->state
== THREAD_RUNNING
,
4635 /* If all-stop on top of non-stop, pause all threads. Note this
4636 records the threads' stop pc, so must be done after "noticing"
4641 /* At this point, the remote target is not async. It needs to be for
4642 the poll in stop_all_threads to consider events from it, so enable
4644 gdb_assert (!this->is_async_p ());
4645 SCOPE_EXIT
{ target_async (0); };
4647 stop_all_threads ("remote connect in all-stop");
4650 /* If all threads of an inferior were already stopped, we
4651 haven't setup the inferior yet. */
4652 for (inferior
*inf
: all_non_exited_inferiors (this))
4654 if (inf
->needs_setup
)
4656 thread_info
*thread
= any_live_thread_of_inferior (inf
);
4657 switch_to_thread_no_regs (thread
);
4663 /* Now go over all threads that are stopped, and print their current
4664 frame. If all-stop, then if there's a signalled thread, pick
4666 for (thread_info
*thread
: all_non_exited_threads (this))
4672 thread
->set_running (false);
4673 else if (thread
->state
!= THREAD_STOPPED
)
4676 if (selected
== nullptr && thread
->has_pending_waitstatus ())
4679 if (lowest_stopped
== NULL
4680 || thread
->inf
->num
< lowest_stopped
->inf
->num
4681 || thread
->per_inf_num
< lowest_stopped
->per_inf_num
)
4682 lowest_stopped
= thread
;
4685 print_one_stopped_thread (thread
);
4688 /* In all-stop, we only print the status of one thread, and leave
4689 others with their status pending. */
4692 thread_info
*thread
= selected
;
4694 thread
= lowest_stopped
;
4698 print_one_stopped_thread (thread
);
4702 /* Mark a remote_target as marking (by setting the starting_up flag within
4703 its remote_state) for the lifetime of this object. The reference count
4704 on the remote target is temporarily incremented, to prevent the target
4705 being deleted under our feet. */
4707 struct scoped_mark_target_starting
4709 /* Constructor, TARGET is the target to be marked as starting, its
4710 reference count will be incremented. */
4711 scoped_mark_target_starting (remote_target
*target
)
4712 : m_remote_target (target
)
4714 m_remote_target
->incref ();
4715 remote_state
*rs
= m_remote_target
->get_remote_state ();
4716 rs
->starting_up
= true;
4719 /* Destructor, mark the target being worked on as no longer starting, and
4720 decrement the reference count. */
4721 ~scoped_mark_target_starting ()
4723 remote_state
*rs
= m_remote_target
->get_remote_state ();
4724 rs
->starting_up
= false;
4725 decref_target (m_remote_target
);
4730 /* The target on which we are operating. */
4731 remote_target
*m_remote_target
;
4734 /* Helper for remote_target::start_remote, start the remote connection and
4735 sync state. Return true if everything goes OK, otherwise, return false.
4736 This function exists so that the scoped_restore created within it will
4737 expire before we return to remote_target::start_remote. */
4740 remote_target::start_remote_1 (int from_tty
, int extended_p
)
4742 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
4744 struct remote_state
*rs
= get_remote_state ();
4745 struct packet_config
*noack_config
;
4747 /* Signal other parts that we're going through the initial setup,
4748 and so things may not be stable yet. E.g., we don't try to
4749 install tracepoints until we've relocated symbols. Also, a
4750 Ctrl-C before we're connected and synced up can't interrupt the
4751 target. Instead, it offers to drop the (potentially wedged)
4753 scoped_mark_target_starting
target_is_starting (this);
4757 if (interrupt_on_connect
)
4758 send_interrupt_sequence ();
4760 /* Ack any packet which the remote side has already sent. */
4761 remote_serial_write ("+", 1);
4763 /* The first packet we send to the target is the optional "supported
4764 packets" request. If the target can answer this, it will tell us
4765 which later probes to skip. */
4766 remote_query_supported ();
4768 /* If the stub wants to get a QAllow, compose one and send it. */
4769 if (packet_support (PACKET_QAllow
) != PACKET_DISABLE
)
4772 /* gdbserver < 7.7 (before its fix from 2013-12-11) did reply to any
4773 unknown 'v' packet with string "OK". "OK" gets interpreted by GDB
4774 as a reply to known packet. For packet "vFile:setfs:" it is an
4775 invalid reply and GDB would return error in
4776 remote_hostio_set_filesystem, making remote files access impossible.
4777 Disable "vFile:setfs:" in such case. Do not disable other 'v' packets as
4778 other "vFile" packets get correctly detected even on gdbserver < 7.7. */
4780 const char v_mustreplyempty
[] = "vMustReplyEmpty";
4782 putpkt (v_mustreplyempty
);
4783 getpkt (&rs
->buf
, 0);
4784 if (strcmp (rs
->buf
.data (), "OK") == 0)
4785 remote_protocol_packets
[PACKET_vFile_setfs
].support
= PACKET_DISABLE
;
4786 else if (strcmp (rs
->buf
.data (), "") != 0)
4787 error (_("Remote replied unexpectedly to '%s': %s"), v_mustreplyempty
,
4791 /* Next, we possibly activate noack mode.
4793 If the QStartNoAckMode packet configuration is set to AUTO,
4794 enable noack mode if the stub reported a wish for it with
4797 If set to TRUE, then enable noack mode even if the stub didn't
4798 report it in qSupported. If the stub doesn't reply OK, the
4799 session ends with an error.
4801 If FALSE, then don't activate noack mode, regardless of what the
4802 stub claimed should be the default with qSupported. */
4804 noack_config
= &remote_protocol_packets
[PACKET_QStartNoAckMode
];
4805 if (packet_config_support (noack_config
) != PACKET_DISABLE
)
4807 putpkt ("QStartNoAckMode");
4808 getpkt (&rs
->buf
, 0);
4809 if (packet_ok (rs
->buf
, noack_config
) == PACKET_OK
)
4815 /* Tell the remote that we are using the extended protocol. */
4817 getpkt (&rs
->buf
, 0);
4820 /* Let the target know which signals it is allowed to pass down to
4822 update_signals_program_target ();
4824 /* Next, if the target can specify a description, read it. We do
4825 this before anything involving memory or registers. */
4826 target_find_description ();
4828 /* Next, now that we know something about the target, update the
4829 address spaces in the program spaces. */
4830 update_address_spaces ();
4832 /* On OSs where the list of libraries is global to all
4833 processes, we fetch them early. */
4834 if (gdbarch_has_global_solist (target_gdbarch ()))
4835 solib_add (NULL
, from_tty
, auto_solib_add
);
4837 if (target_is_non_stop_p ())
4839 if (packet_support (PACKET_QNonStop
) != PACKET_ENABLE
)
4840 error (_("Non-stop mode requested, but remote "
4841 "does not support non-stop"));
4843 putpkt ("QNonStop:1");
4844 getpkt (&rs
->buf
, 0);
4846 if (strcmp (rs
->buf
.data (), "OK") != 0)
4847 error (_("Remote refused setting non-stop mode with: %s"),
4850 /* Find about threads and processes the stub is already
4851 controlling. We default to adding them in the running state.
4852 The '?' query below will then tell us about which threads are
4854 this->update_thread_list ();
4856 else if (packet_support (PACKET_QNonStop
) == PACKET_ENABLE
)
4858 /* Don't assume that the stub can operate in all-stop mode.
4859 Request it explicitly. */
4860 putpkt ("QNonStop:0");
4861 getpkt (&rs
->buf
, 0);
4863 if (strcmp (rs
->buf
.data (), "OK") != 0)
4864 error (_("Remote refused setting all-stop mode with: %s"),
4868 /* Upload TSVs regardless of whether the target is running or not. The
4869 remote stub, such as GDBserver, may have some predefined or builtin
4870 TSVs, even if the target is not running. */
4871 if (get_trace_status (current_trace_status ()) != -1)
4873 struct uploaded_tsv
*uploaded_tsvs
= NULL
;
4875 upload_trace_state_variables (&uploaded_tsvs
);
4876 merge_uploaded_trace_state_variables (&uploaded_tsvs
);
4879 /* Check whether the target is running now. */
4881 getpkt (&rs
->buf
, 0);
4883 if (!target_is_non_stop_p ())
4885 char *wait_status
= NULL
;
4887 if (rs
->buf
[0] == 'W' || rs
->buf
[0] == 'X')
4890 error (_("The target is not running (try extended-remote?)"));
4895 /* Save the reply for later. */
4896 wait_status
= (char *) alloca (strlen (rs
->buf
.data ()) + 1);
4897 strcpy (wait_status
, rs
->buf
.data ());
4900 /* Fetch thread list. */
4901 target_update_thread_list ();
4903 /* Let the stub know that we want it to return the thread. */
4904 set_continue_thread (minus_one_ptid
);
4906 if (thread_count (this) == 0)
4908 /* Target has no concept of threads at all. GDB treats
4909 non-threaded target as single-threaded; add a main
4911 thread_info
*tp
= add_current_inferior_and_thread (wait_status
);
4912 get_remote_thread_info (tp
)->set_resumed ();
4916 /* We have thread information; select the thread the target
4917 says should be current. If we're reconnecting to a
4918 multi-threaded program, this will ideally be the thread
4919 that last reported an event before GDB disconnected. */
4920 ptid_t curr_thread
= get_current_thread (wait_status
);
4921 if (curr_thread
== null_ptid
)
4923 /* Odd... The target was able to list threads, but not
4924 tell us which thread was current (no "thread"
4925 register in T stop reply?). Just pick the first
4926 thread in the thread list then. */
4928 remote_debug_printf ("warning: couldn't determine remote "
4929 "current thread; picking first in list.");
4931 for (thread_info
*tp
: all_non_exited_threads (this,
4934 switch_to_thread (tp
);
4939 switch_to_thread (find_thread_ptid (this, curr_thread
));
4942 /* init_wait_for_inferior should be called before get_offsets in order
4943 to manage `inserted' flag in bp loc in a correct state.
4944 breakpoint_init_inferior, called from init_wait_for_inferior, set
4945 `inserted' flag to 0, while before breakpoint_re_set, called from
4946 start_remote, set `inserted' flag to 1. In the initialization of
4947 inferior, breakpoint_init_inferior should be called first, and then
4948 breakpoint_re_set can be called. If this order is broken, state of
4949 `inserted' flag is wrong, and cause some problems on breakpoint
4951 init_wait_for_inferior ();
4953 get_offsets (); /* Get text, data & bss offsets. */
4955 /* If we could not find a description using qXfer, and we know
4956 how to do it some other way, try again. This is not
4957 supported for non-stop; it could be, but it is tricky if
4958 there are no stopped threads when we connect. */
4959 if (remote_read_description_p (this)
4960 && gdbarch_target_desc (target_gdbarch ()) == NULL
)
4962 target_clear_description ();
4963 target_find_description ();
4966 /* Use the previously fetched status. */
4967 gdb_assert (wait_status
!= NULL
);
4968 struct notif_event
*reply
4969 = remote_notif_parse (this, ¬if_client_stop
, wait_status
);
4970 push_stop_reply ((struct stop_reply
*) reply
);
4972 ::start_remote (from_tty
); /* Initialize gdb process mechanisms. */
4976 /* Clear WFI global state. Do this before finding about new
4977 threads and inferiors, and setting the current inferior.
4978 Otherwise we would clear the proceed status of the current
4979 inferior when we want its stop_soon state to be preserved
4980 (see notice_new_inferior). */
4981 init_wait_for_inferior ();
4983 /* In non-stop, we will either get an "OK", meaning that there
4984 are no stopped threads at this time; or, a regular stop
4985 reply. In the latter case, there may be more than one thread
4986 stopped --- we pull them all out using the vStopped
4988 if (strcmp (rs
->buf
.data (), "OK") != 0)
4990 struct notif_client
*notif
= ¬if_client_stop
;
4992 /* remote_notif_get_pending_replies acks this one, and gets
4994 rs
->notif_state
->pending_event
[notif_client_stop
.id
]
4995 = remote_notif_parse (this, notif
, rs
->buf
.data ());
4996 remote_notif_get_pending_events (notif
);
4999 if (thread_count (this) == 0)
5002 error (_("The target is not running (try extended-remote?)"));
5006 /* Report all signals during attach/startup. */
5009 /* If there are already stopped threads, mark them stopped and
5010 report their stops before giving the prompt to the user. */
5011 process_initial_stop_replies (from_tty
);
5013 if (target_can_async_p ())
5017 /* If we connected to a live target, do some additional setup. */
5018 if (target_has_execution ())
5020 /* No use without a symbol-file. */
5021 if (current_program_space
->symfile_object_file
)
5022 remote_check_symbols ();
5025 /* Possibly the target has been engaged in a trace run started
5026 previously; find out where things are at. */
5027 if (get_trace_status (current_trace_status ()) != -1)
5029 struct uploaded_tp
*uploaded_tps
= NULL
;
5031 if (current_trace_status ()->running
)
5032 gdb_printf (_("Trace is already running on the target.\n"));
5034 upload_tracepoints (&uploaded_tps
);
5036 merge_uploaded_tracepoints (&uploaded_tps
);
5039 /* Possibly the target has been engaged in a btrace record started
5040 previously; find out where things are at. */
5041 remote_btrace_maybe_reopen ();
5046 /* Start the remote connection and sync state. */
5049 remote_target::start_remote (int from_tty
, int extended_p
)
5051 if (start_remote_1 (from_tty
, extended_p
)
5052 && breakpoints_should_be_inserted_now ())
5053 insert_breakpoints ();
5057 remote_target::connection_string ()
5059 remote_state
*rs
= get_remote_state ();
5061 if (rs
->remote_desc
->name
!= NULL
)
5062 return rs
->remote_desc
->name
;
5067 /* Open a connection to a remote debugger.
5068 NAME is the filename used for communication. */
5071 remote_target::open (const char *name
, int from_tty
)
5073 open_1 (name
, from_tty
, 0);
5076 /* Open a connection to a remote debugger using the extended
5077 remote gdb protocol. NAME is the filename used for communication. */
5080 extended_remote_target::open (const char *name
, int from_tty
)
5082 open_1 (name
, from_tty
, 1 /*extended_p */);
5085 /* Reset all packets back to "unknown support". Called when opening a
5086 new connection to a remote target. */
5089 reset_all_packet_configs_support (void)
5093 for (i
= 0; i
< PACKET_MAX
; i
++)
5094 remote_protocol_packets
[i
].support
= PACKET_SUPPORT_UNKNOWN
;
5097 /* Initialize all packet configs. */
5100 init_all_packet_configs (void)
5104 for (i
= 0; i
< PACKET_MAX
; i
++)
5106 remote_protocol_packets
[i
].detect
= AUTO_BOOLEAN_AUTO
;
5107 remote_protocol_packets
[i
].support
= PACKET_SUPPORT_UNKNOWN
;
5111 /* Symbol look-up. */
5114 remote_target::remote_check_symbols ()
5119 /* The remote side has no concept of inferiors that aren't running
5120 yet, it only knows about running processes. If we're connected
5121 but our current inferior is not running, we should not invite the
5122 remote target to request symbol lookups related to its
5123 (unrelated) current process. */
5124 if (!target_has_execution ())
5127 if (packet_support (PACKET_qSymbol
) == PACKET_DISABLE
)
5130 /* Make sure the remote is pointing at the right process. Note
5131 there's no way to select "no process". */
5132 set_general_process ();
5134 /* Allocate a message buffer. We can't reuse the input buffer in RS,
5135 because we need both at the same time. */
5136 gdb::char_vector
msg (get_remote_packet_size ());
5137 gdb::char_vector
reply (get_remote_packet_size ());
5139 /* Invite target to request symbol lookups. */
5141 putpkt ("qSymbol::");
5143 packet_ok (reply
, &remote_protocol_packets
[PACKET_qSymbol
]);
5145 while (startswith (reply
.data (), "qSymbol:"))
5147 struct bound_minimal_symbol sym
;
5150 end
= hex2bin (tmp
, reinterpret_cast <gdb_byte
*> (msg
.data ()),
5153 sym
= lookup_minimal_symbol (msg
.data (), NULL
, NULL
);
5154 if (sym
.minsym
== NULL
)
5155 xsnprintf (msg
.data (), get_remote_packet_size (), "qSymbol::%s",
5159 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
5160 CORE_ADDR sym_addr
= sym
.value_address ();
5162 /* If this is a function address, return the start of code
5163 instead of any data function descriptor. */
5164 sym_addr
= gdbarch_convert_from_func_ptr_addr
5165 (target_gdbarch (), sym_addr
, current_inferior ()->top_target ());
5167 xsnprintf (msg
.data (), get_remote_packet_size (), "qSymbol:%s:%s",
5168 phex_nz (sym_addr
, addr_size
), &reply
[8]);
5171 putpkt (msg
.data ());
5176 static struct serial
*
5177 remote_serial_open (const char *name
)
5179 static int udp_warning
= 0;
5181 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
5182 of in ser-tcp.c, because it is the remote protocol assuming that the
5183 serial connection is reliable and not the serial connection promising
5185 if (!udp_warning
&& startswith (name
, "udp:"))
5187 warning (_("The remote protocol may be unreliable over UDP.\n"
5188 "Some events may be lost, rendering further debugging "
5193 return serial_open (name
);
5196 /* Inform the target of our permission settings. The permission flags
5197 work without this, but if the target knows the settings, it can do
5198 a couple things. First, it can add its own check, to catch cases
5199 that somehow manage to get by the permissions checks in target
5200 methods. Second, if the target is wired to disallow particular
5201 settings (for instance, a system in the field that is not set up to
5202 be able to stop at a breakpoint), it can object to any unavailable
5206 remote_target::set_permissions ()
5208 struct remote_state
*rs
= get_remote_state ();
5210 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QAllow:"
5211 "WriteReg:%x;WriteMem:%x;"
5212 "InsertBreak:%x;InsertTrace:%x;"
5213 "InsertFastTrace:%x;Stop:%x",
5214 may_write_registers
, may_write_memory
,
5215 may_insert_breakpoints
, may_insert_tracepoints
,
5216 may_insert_fast_tracepoints
, may_stop
);
5218 getpkt (&rs
->buf
, 0);
5220 /* If the target didn't like the packet, warn the user. Do not try
5221 to undo the user's settings, that would just be maddening. */
5222 if (strcmp (rs
->buf
.data (), "OK") != 0)
5223 warning (_("Remote refused setting permissions with: %s"),
5227 /* This type describes each known response to the qSupported
5229 struct protocol_feature
5231 /* The name of this protocol feature. */
5234 /* The default for this protocol feature. */
5235 enum packet_support default_support
;
5237 /* The function to call when this feature is reported, or after
5238 qSupported processing if the feature is not supported.
5239 The first argument points to this structure. The second
5240 argument indicates whether the packet requested support be
5241 enabled, disabled, or probed (or the default, if this function
5242 is being called at the end of processing and this feature was
5243 not reported). The third argument may be NULL; if not NULL, it
5244 is a NUL-terminated string taken from the packet following
5245 this feature's name and an equals sign. */
5246 void (*func
) (remote_target
*remote
, const struct protocol_feature
*,
5247 enum packet_support
, const char *);
5249 /* The corresponding packet for this feature. Only used if
5250 FUNC is remote_supported_packet. */
5255 remote_supported_packet (remote_target
*remote
,
5256 const struct protocol_feature
*feature
,
5257 enum packet_support support
,
5258 const char *argument
)
5262 warning (_("Remote qSupported response supplied an unexpected value for"
5263 " \"%s\"."), feature
->name
);
5267 remote_protocol_packets
[feature
->packet
].support
= support
;
5271 remote_target::remote_packet_size (const protocol_feature
*feature
,
5272 enum packet_support support
, const char *value
)
5274 struct remote_state
*rs
= get_remote_state ();
5279 if (support
!= PACKET_ENABLE
)
5282 if (value
== NULL
|| *value
== '\0')
5284 warning (_("Remote target reported \"%s\" without a size."),
5290 packet_size
= strtol (value
, &value_end
, 16);
5291 if (errno
!= 0 || *value_end
!= '\0' || packet_size
< 0)
5293 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
5294 feature
->name
, value
);
5298 /* Record the new maximum packet size. */
5299 rs
->explicit_packet_size
= packet_size
;
5303 remote_packet_size (remote_target
*remote
, const protocol_feature
*feature
,
5304 enum packet_support support
, const char *value
)
5306 remote
->remote_packet_size (feature
, support
, value
);
5309 static const struct protocol_feature remote_protocol_features
[] = {
5310 { "PacketSize", PACKET_DISABLE
, remote_packet_size
, -1 },
5311 { "qXfer:auxv:read", PACKET_DISABLE
, remote_supported_packet
,
5312 PACKET_qXfer_auxv
},
5313 { "qXfer:exec-file:read", PACKET_DISABLE
, remote_supported_packet
,
5314 PACKET_qXfer_exec_file
},
5315 { "qXfer:features:read", PACKET_DISABLE
, remote_supported_packet
,
5316 PACKET_qXfer_features
},
5317 { "qXfer:libraries:read", PACKET_DISABLE
, remote_supported_packet
,
5318 PACKET_qXfer_libraries
},
5319 { "qXfer:libraries-svr4:read", PACKET_DISABLE
, remote_supported_packet
,
5320 PACKET_qXfer_libraries_svr4
},
5321 { "augmented-libraries-svr4-read", PACKET_DISABLE
,
5322 remote_supported_packet
, PACKET_augmented_libraries_svr4_read_feature
},
5323 { "qXfer:memory-map:read", PACKET_DISABLE
, remote_supported_packet
,
5324 PACKET_qXfer_memory_map
},
5325 { "qXfer:osdata:read", PACKET_DISABLE
, remote_supported_packet
,
5326 PACKET_qXfer_osdata
},
5327 { "qXfer:threads:read", PACKET_DISABLE
, remote_supported_packet
,
5328 PACKET_qXfer_threads
},
5329 { "qXfer:traceframe-info:read", PACKET_DISABLE
, remote_supported_packet
,
5330 PACKET_qXfer_traceframe_info
},
5331 { "QPassSignals", PACKET_DISABLE
, remote_supported_packet
,
5332 PACKET_QPassSignals
},
5333 { "QCatchSyscalls", PACKET_DISABLE
, remote_supported_packet
,
5334 PACKET_QCatchSyscalls
},
5335 { "QProgramSignals", PACKET_DISABLE
, remote_supported_packet
,
5336 PACKET_QProgramSignals
},
5337 { "QSetWorkingDir", PACKET_DISABLE
, remote_supported_packet
,
5338 PACKET_QSetWorkingDir
},
5339 { "QStartupWithShell", PACKET_DISABLE
, remote_supported_packet
,
5340 PACKET_QStartupWithShell
},
5341 { "QEnvironmentHexEncoded", PACKET_DISABLE
, remote_supported_packet
,
5342 PACKET_QEnvironmentHexEncoded
},
5343 { "QEnvironmentReset", PACKET_DISABLE
, remote_supported_packet
,
5344 PACKET_QEnvironmentReset
},
5345 { "QEnvironmentUnset", PACKET_DISABLE
, remote_supported_packet
,
5346 PACKET_QEnvironmentUnset
},
5347 { "QStartNoAckMode", PACKET_DISABLE
, remote_supported_packet
,
5348 PACKET_QStartNoAckMode
},
5349 { "multiprocess", PACKET_DISABLE
, remote_supported_packet
,
5350 PACKET_multiprocess_feature
},
5351 { "QNonStop", PACKET_DISABLE
, remote_supported_packet
, PACKET_QNonStop
},
5352 { "qXfer:siginfo:read", PACKET_DISABLE
, remote_supported_packet
,
5353 PACKET_qXfer_siginfo_read
},
5354 { "qXfer:siginfo:write", PACKET_DISABLE
, remote_supported_packet
,
5355 PACKET_qXfer_siginfo_write
},
5356 { "ConditionalTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5357 PACKET_ConditionalTracepoints
},
5358 { "ConditionalBreakpoints", PACKET_DISABLE
, remote_supported_packet
,
5359 PACKET_ConditionalBreakpoints
},
5360 { "BreakpointCommands", PACKET_DISABLE
, remote_supported_packet
,
5361 PACKET_BreakpointCommands
},
5362 { "FastTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5363 PACKET_FastTracepoints
},
5364 { "StaticTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5365 PACKET_StaticTracepoints
},
5366 {"InstallInTrace", PACKET_DISABLE
, remote_supported_packet
,
5367 PACKET_InstallInTrace
},
5368 { "DisconnectedTracing", PACKET_DISABLE
, remote_supported_packet
,
5369 PACKET_DisconnectedTracing_feature
},
5370 { "ReverseContinue", PACKET_DISABLE
, remote_supported_packet
,
5372 { "ReverseStep", PACKET_DISABLE
, remote_supported_packet
,
5374 { "TracepointSource", PACKET_DISABLE
, remote_supported_packet
,
5375 PACKET_TracepointSource
},
5376 { "QAllow", PACKET_DISABLE
, remote_supported_packet
,
5378 { "EnableDisableTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5379 PACKET_EnableDisableTracepoints_feature
},
5380 { "qXfer:fdpic:read", PACKET_DISABLE
, remote_supported_packet
,
5381 PACKET_qXfer_fdpic
},
5382 { "qXfer:uib:read", PACKET_DISABLE
, remote_supported_packet
,
5384 { "QDisableRandomization", PACKET_DISABLE
, remote_supported_packet
,
5385 PACKET_QDisableRandomization
},
5386 { "QAgent", PACKET_DISABLE
, remote_supported_packet
, PACKET_QAgent
},
5387 { "QTBuffer:size", PACKET_DISABLE
,
5388 remote_supported_packet
, PACKET_QTBuffer_size
},
5389 { "tracenz", PACKET_DISABLE
, remote_supported_packet
, PACKET_tracenz_feature
},
5390 { "Qbtrace:off", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_off
},
5391 { "Qbtrace:bts", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_bts
},
5392 { "Qbtrace:pt", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_pt
},
5393 { "qXfer:btrace:read", PACKET_DISABLE
, remote_supported_packet
,
5394 PACKET_qXfer_btrace
},
5395 { "qXfer:btrace-conf:read", PACKET_DISABLE
, remote_supported_packet
,
5396 PACKET_qXfer_btrace_conf
},
5397 { "Qbtrace-conf:bts:size", PACKET_DISABLE
, remote_supported_packet
,
5398 PACKET_Qbtrace_conf_bts_size
},
5399 { "swbreak", PACKET_DISABLE
, remote_supported_packet
, PACKET_swbreak_feature
},
5400 { "hwbreak", PACKET_DISABLE
, remote_supported_packet
, PACKET_hwbreak_feature
},
5401 { "fork-events", PACKET_DISABLE
, remote_supported_packet
,
5402 PACKET_fork_event_feature
},
5403 { "vfork-events", PACKET_DISABLE
, remote_supported_packet
,
5404 PACKET_vfork_event_feature
},
5405 { "exec-events", PACKET_DISABLE
, remote_supported_packet
,
5406 PACKET_exec_event_feature
},
5407 { "Qbtrace-conf:pt:size", PACKET_DISABLE
, remote_supported_packet
,
5408 PACKET_Qbtrace_conf_pt_size
},
5409 { "vContSupported", PACKET_DISABLE
, remote_supported_packet
, PACKET_vContSupported
},
5410 { "QThreadEvents", PACKET_DISABLE
, remote_supported_packet
, PACKET_QThreadEvents
},
5411 { "no-resumed", PACKET_DISABLE
, remote_supported_packet
, PACKET_no_resumed
},
5412 { "memory-tagging", PACKET_DISABLE
, remote_supported_packet
,
5413 PACKET_memory_tagging_feature
},
5416 static char *remote_support_xml
;
5418 /* Register string appended to "xmlRegisters=" in qSupported query. */
5421 register_remote_support_xml (const char *xml
)
5423 #if defined(HAVE_LIBEXPAT)
5424 if (remote_support_xml
== NULL
)
5425 remote_support_xml
= concat ("xmlRegisters=", xml
, (char *) NULL
);
5428 char *copy
= xstrdup (remote_support_xml
+ 13);
5430 char *p
= strtok_r (copy
, ",", &saveptr
);
5434 if (strcmp (p
, xml
) == 0)
5441 while ((p
= strtok_r (NULL
, ",", &saveptr
)) != NULL
);
5444 remote_support_xml
= reconcat (remote_support_xml
,
5445 remote_support_xml
, ",", xml
,
5452 remote_query_supported_append (std::string
*msg
, const char *append
)
5456 msg
->append (append
);
5460 remote_target::remote_query_supported ()
5462 struct remote_state
*rs
= get_remote_state ();
5465 unsigned char seen
[ARRAY_SIZE (remote_protocol_features
)];
5467 /* The packet support flags are handled differently for this packet
5468 than for most others. We treat an error, a disabled packet, and
5469 an empty response identically: any features which must be reported
5470 to be used will be automatically disabled. An empty buffer
5471 accomplishes this, since that is also the representation for a list
5472 containing no features. */
5475 if (packet_support (PACKET_qSupported
) != PACKET_DISABLE
)
5479 if (packet_set_cmd_state (PACKET_multiprocess_feature
) != AUTO_BOOLEAN_FALSE
)
5480 remote_query_supported_append (&q
, "multiprocess+");
5482 if (packet_set_cmd_state (PACKET_swbreak_feature
) != AUTO_BOOLEAN_FALSE
)
5483 remote_query_supported_append (&q
, "swbreak+");
5484 if (packet_set_cmd_state (PACKET_hwbreak_feature
) != AUTO_BOOLEAN_FALSE
)
5485 remote_query_supported_append (&q
, "hwbreak+");
5487 remote_query_supported_append (&q
, "qRelocInsn+");
5489 if (packet_set_cmd_state (PACKET_fork_event_feature
)
5490 != AUTO_BOOLEAN_FALSE
)
5491 remote_query_supported_append (&q
, "fork-events+");
5492 if (packet_set_cmd_state (PACKET_vfork_event_feature
)
5493 != AUTO_BOOLEAN_FALSE
)
5494 remote_query_supported_append (&q
, "vfork-events+");
5495 if (packet_set_cmd_state (PACKET_exec_event_feature
)
5496 != AUTO_BOOLEAN_FALSE
)
5497 remote_query_supported_append (&q
, "exec-events+");
5499 if (packet_set_cmd_state (PACKET_vContSupported
) != AUTO_BOOLEAN_FALSE
)
5500 remote_query_supported_append (&q
, "vContSupported+");
5502 if (packet_set_cmd_state (PACKET_QThreadEvents
) != AUTO_BOOLEAN_FALSE
)
5503 remote_query_supported_append (&q
, "QThreadEvents+");
5505 if (packet_set_cmd_state (PACKET_no_resumed
) != AUTO_BOOLEAN_FALSE
)
5506 remote_query_supported_append (&q
, "no-resumed+");
5508 if (packet_set_cmd_state (PACKET_memory_tagging_feature
)
5509 != AUTO_BOOLEAN_FALSE
)
5510 remote_query_supported_append (&q
, "memory-tagging+");
5512 /* Keep this one last to work around a gdbserver <= 7.10 bug in
5513 the qSupported:xmlRegisters=i386 handling. */
5514 if (remote_support_xml
!= NULL
5515 && packet_support (PACKET_qXfer_features
) != PACKET_DISABLE
)
5516 remote_query_supported_append (&q
, remote_support_xml
);
5518 q
= "qSupported:" + q
;
5519 putpkt (q
.c_str ());
5521 getpkt (&rs
->buf
, 0);
5523 /* If an error occured, warn, but do not return - just reset the
5524 buffer to empty and go on to disable features. */
5525 if (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_qSupported
])
5528 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
5533 memset (seen
, 0, sizeof (seen
));
5535 next
= rs
->buf
.data ();
5538 enum packet_support is_supported
;
5539 char *p
, *end
, *name_end
, *value
;
5541 /* First separate out this item from the rest of the packet. If
5542 there's another item after this, we overwrite the separator
5543 (terminated strings are much easier to work with). */
5545 end
= strchr (p
, ';');
5548 end
= p
+ strlen (p
);
5558 warning (_("empty item in \"qSupported\" response"));
5563 name_end
= strchr (p
, '=');
5566 /* This is a name=value entry. */
5567 is_supported
= PACKET_ENABLE
;
5568 value
= name_end
+ 1;
5577 is_supported
= PACKET_ENABLE
;
5581 is_supported
= PACKET_DISABLE
;
5585 is_supported
= PACKET_SUPPORT_UNKNOWN
;
5589 warning (_("unrecognized item \"%s\" "
5590 "in \"qSupported\" response"), p
);
5596 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
5597 if (strcmp (remote_protocol_features
[i
].name
, p
) == 0)
5599 const struct protocol_feature
*feature
;
5602 feature
= &remote_protocol_features
[i
];
5603 feature
->func (this, feature
, is_supported
, value
);
5608 /* If we increased the packet size, make sure to increase the global
5609 buffer size also. We delay this until after parsing the entire
5610 qSupported packet, because this is the same buffer we were
5612 if (rs
->buf
.size () < rs
->explicit_packet_size
)
5613 rs
->buf
.resize (rs
->explicit_packet_size
);
5615 /* Handle the defaults for unmentioned features. */
5616 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
5619 const struct protocol_feature
*feature
;
5621 feature
= &remote_protocol_features
[i
];
5622 feature
->func (this, feature
, feature
->default_support
, NULL
);
5626 /* Serial QUIT handler for the remote serial descriptor.
5628 Defers handling a Ctrl-C until we're done with the current
5629 command/response packet sequence, unless:
5631 - We're setting up the connection. Don't send a remote interrupt
5632 request, as we're not fully synced yet. Quit immediately
5635 - The target has been resumed in the foreground
5636 (target_terminal::is_ours is false) with a synchronous resume
5637 packet, and we're blocked waiting for the stop reply, thus a
5638 Ctrl-C should be immediately sent to the target.
5640 - We get a second Ctrl-C while still within the same serial read or
5641 write. In that case the serial is seemingly wedged --- offer to
5644 - We see a second Ctrl-C without target response, after having
5645 previously interrupted the target. In that case the target/stub
5646 is probably wedged --- offer to quit/disconnect.
5650 remote_target::remote_serial_quit_handler ()
5652 struct remote_state
*rs
= get_remote_state ();
5654 if (check_quit_flag ())
5656 /* If we're starting up, we're not fully synced yet. Quit
5658 if (rs
->starting_up
)
5660 else if (rs
->got_ctrlc_during_io
)
5662 if (query (_("The target is not responding to GDB commands.\n"
5663 "Stop debugging it? ")))
5664 remote_unpush_and_throw (this);
5666 /* If ^C has already been sent once, offer to disconnect. */
5667 else if (!target_terminal::is_ours () && rs
->ctrlc_pending_p
)
5669 /* All-stop protocol, and blocked waiting for stop reply. Send
5670 an interrupt request. */
5671 else if (!target_terminal::is_ours () && rs
->waiting_for_stop_reply
)
5672 target_interrupt ();
5674 rs
->got_ctrlc_during_io
= 1;
5678 /* The remote_target that is current while the quit handler is
5679 overridden with remote_serial_quit_handler. */
5680 static remote_target
*curr_quit_handler_target
;
5683 remote_serial_quit_handler ()
5685 curr_quit_handler_target
->remote_serial_quit_handler ();
5688 /* Remove the remote target from the target stack of each inferior
5689 that is using it. Upper targets depend on it so remove them
5693 remote_unpush_target (remote_target
*target
)
5695 /* We have to unpush the target from all inferiors, even those that
5697 scoped_restore_current_inferior restore_current_inferior
;
5699 for (inferior
*inf
: all_inferiors (target
))
5701 switch_to_inferior_no_thread (inf
);
5702 pop_all_targets_at_and_above (process_stratum
);
5703 generic_mourn_inferior ();
5706 /* Don't rely on target_close doing this when the target is popped
5707 from the last remote inferior above, because something may be
5708 holding a reference to the target higher up on the stack, meaning
5709 target_close won't be called yet. We lost the connection to the
5710 target, so clear these now, otherwise we may later throw
5711 TARGET_CLOSE_ERROR while trying to tell the remote target to
5713 fileio_handles_invalidate_target (target
);
5717 remote_unpush_and_throw (remote_target
*target
)
5719 remote_unpush_target (target
);
5720 throw_error (TARGET_CLOSE_ERROR
, _("Disconnected from target."));
5724 remote_target::open_1 (const char *name
, int from_tty
, int extended_p
)
5726 remote_target
*curr_remote
= get_current_remote_target ();
5729 error (_("To open a remote debug connection, you need to specify what\n"
5730 "serial device is attached to the remote system\n"
5731 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
5733 /* If we're connected to a running target, target_preopen will kill it.
5734 Ask this question first, before target_preopen has a chance to kill
5736 if (curr_remote
!= NULL
&& !target_has_execution ())
5739 && !query (_("Already connected to a remote target. Disconnect? ")))
5740 error (_("Still connected."));
5743 /* Here the possibly existing remote target gets unpushed. */
5744 target_preopen (from_tty
);
5746 remote_fileio_reset ();
5747 reopen_exec_file ();
5748 reread_symbols (from_tty
);
5750 remote_target
*remote
5751 = (extended_p
? new extended_remote_target () : new remote_target ());
5752 target_ops_up
target_holder (remote
);
5754 remote_state
*rs
= remote
->get_remote_state ();
5756 /* See FIXME above. */
5757 if (!target_async_permitted
)
5758 rs
->wait_forever_enabled_p
= 1;
5760 rs
->remote_desc
= remote_serial_open (name
);
5761 if (!rs
->remote_desc
)
5762 perror_with_name (name
);
5764 if (baud_rate
!= -1)
5766 if (serial_setbaudrate (rs
->remote_desc
, baud_rate
))
5768 /* The requested speed could not be set. Error out to
5769 top level after closing remote_desc. Take care to
5770 set remote_desc to NULL to avoid closing remote_desc
5772 serial_close (rs
->remote_desc
);
5773 rs
->remote_desc
= NULL
;
5774 perror_with_name (name
);
5778 serial_setparity (rs
->remote_desc
, serial_parity
);
5779 serial_raw (rs
->remote_desc
);
5781 /* If there is something sitting in the buffer we might take it as a
5782 response to a command, which would be bad. */
5783 serial_flush_input (rs
->remote_desc
);
5787 gdb_puts ("Remote debugging using ");
5792 /* Switch to using the remote target now. */
5793 current_inferior ()->push_target (std::move (target_holder
));
5795 /* Register extra event sources in the event loop. */
5796 rs
->remote_async_inferior_event_token
5797 = create_async_event_handler (remote_async_inferior_event_handler
, nullptr,
5799 rs
->notif_state
= remote_notif_state_allocate (remote
);
5801 /* Reset the target state; these things will be queried either by
5802 remote_query_supported or as they are needed. */
5803 reset_all_packet_configs_support ();
5804 rs
->explicit_packet_size
= 0;
5806 rs
->extended
= extended_p
;
5807 rs
->waiting_for_stop_reply
= 0;
5808 rs
->ctrlc_pending_p
= 0;
5809 rs
->got_ctrlc_during_io
= 0;
5811 rs
->general_thread
= not_sent_ptid
;
5812 rs
->continue_thread
= not_sent_ptid
;
5813 rs
->remote_traceframe_number
= -1;
5815 rs
->last_resume_exec_dir
= EXEC_FORWARD
;
5817 /* Probe for ability to use "ThreadInfo" query, as required. */
5818 rs
->use_threadinfo_query
= 1;
5819 rs
->use_threadextra_query
= 1;
5821 rs
->readahead_cache
.invalidate ();
5823 if (target_async_permitted
)
5825 /* FIXME: cagney/1999-09-23: During the initial connection it is
5826 assumed that the target is already ready and able to respond to
5827 requests. Unfortunately remote_start_remote() eventually calls
5828 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
5829 around this. Eventually a mechanism that allows
5830 wait_for_inferior() to expect/get timeouts will be
5832 rs
->wait_forever_enabled_p
= 0;
5835 /* First delete any symbols previously loaded from shared libraries. */
5836 no_shared_libraries (NULL
, 0);
5838 /* Start the remote connection. If error() or QUIT, discard this
5839 target (we'd otherwise be in an inconsistent state) and then
5840 propogate the error on up the exception chain. This ensures that
5841 the caller doesn't stumble along blindly assuming that the
5842 function succeeded. The CLI doesn't have this problem but other
5843 UI's, such as MI do.
5845 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
5846 this function should return an error indication letting the
5847 caller restore the previous state. Unfortunately the command
5848 ``target remote'' is directly wired to this function making that
5849 impossible. On a positive note, the CLI side of this problem has
5850 been fixed - the function set_cmd_context() makes it possible for
5851 all the ``target ....'' commands to share a common callback
5852 function. See cli-dump.c. */
5857 remote
->start_remote (from_tty
, extended_p
);
5859 catch (const gdb_exception
&ex
)
5861 /* Pop the partially set up target - unless something else did
5862 already before throwing the exception. */
5863 if (ex
.error
!= TARGET_CLOSE_ERROR
)
5864 remote_unpush_target (remote
);
5869 remote_btrace_reset (rs
);
5871 if (target_async_permitted
)
5872 rs
->wait_forever_enabled_p
= 1;
5875 /* Determine if WS represents a fork status. */
5878 is_fork_status (target_waitkind kind
)
5880 return (kind
== TARGET_WAITKIND_FORKED
5881 || kind
== TARGET_WAITKIND_VFORKED
);
5884 /* Return THREAD's pending status if it is a pending fork parent, else
5887 static const target_waitstatus
*
5888 thread_pending_fork_status (struct thread_info
*thread
)
5890 const target_waitstatus
&ws
5891 = (thread
->has_pending_waitstatus ()
5892 ? thread
->pending_waitstatus ()
5893 : thread
->pending_follow
);
5895 if (!is_fork_status (ws
.kind ()))
5901 /* Detach the specified process. */
5904 remote_target::remote_detach_pid (int pid
)
5906 struct remote_state
*rs
= get_remote_state ();
5908 /* This should not be necessary, but the handling for D;PID in
5909 GDBserver versions prior to 8.2 incorrectly assumes that the
5910 selected process points to the same process we're detaching,
5911 leading to misbehavior (and possibly GDBserver crashing) when it
5912 does not. Since it's easy and cheap, work around it by forcing
5913 GDBserver to select GDB's current process. */
5914 set_general_process ();
5916 if (remote_multi_process_p (rs
))
5917 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "D;%x", pid
);
5919 strcpy (rs
->buf
.data (), "D");
5922 getpkt (&rs
->buf
, 0);
5924 if (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K')
5926 else if (rs
->buf
[0] == '\0')
5927 error (_("Remote doesn't know how to detach"));
5929 error (_("Can't detach process."));
5932 /* This detaches a program to which we previously attached, using
5933 inferior_ptid to identify the process. After this is done, GDB
5934 can be used to debug some other program. We better not have left
5935 any breakpoints in the target program or it'll die when it hits
5939 remote_target::remote_detach_1 (inferior
*inf
, int from_tty
)
5941 int pid
= inferior_ptid
.pid ();
5942 struct remote_state
*rs
= get_remote_state ();
5945 if (!target_has_execution ())
5946 error (_("No process to detach from."));
5948 target_announce_detach (from_tty
);
5950 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
5952 /* If we're in breakpoints-always-inserted mode, or the inferior
5953 is running, we have to remove breakpoints before detaching.
5954 We don't do this in common code instead because not all
5955 targets support removing breakpoints while the target is
5956 running. The remote target / gdbserver does, though. */
5957 remove_breakpoints_inf (current_inferior ());
5960 /* Tell the remote target to detach. */
5961 remote_detach_pid (pid
);
5963 /* Exit only if this is the only active inferior. */
5964 if (from_tty
&& !rs
->extended
&& number_of_live_inferiors (this) == 1)
5965 gdb_puts (_("Ending remote debugging.\n"));
5967 /* See if any thread of the inferior we are detaching has a pending fork
5968 status. In that case, we must detach from the child resulting from
5970 for (thread_info
*thread
: inf
->non_exited_threads ())
5972 const target_waitstatus
*ws
= thread_pending_fork_status (thread
);
5977 remote_detach_pid (ws
->child_ptid ().pid ());
5980 /* Check also for any pending fork events in the stop reply queue. */
5981 remote_notif_get_pending_events (¬if_client_stop
);
5982 for (stop_reply_up
&reply
: rs
->stop_reply_queue
)
5984 if (reply
->ptid
.pid () != pid
)
5987 if (!is_fork_status (reply
->ws
.kind ()))
5990 remote_detach_pid (reply
->ws
.child_ptid ().pid ());
5993 thread_info
*tp
= find_thread_ptid (this, inferior_ptid
);
5995 /* Check to see if we are detaching a fork parent. Note that if we
5996 are detaching a fork child, tp == NULL. */
5997 is_fork_parent
= (tp
!= NULL
5998 && tp
->pending_follow
.kind () == TARGET_WAITKIND_FORKED
);
6000 /* If doing detach-on-fork, we don't mourn, because that will delete
6001 breakpoints that should be available for the followed inferior. */
6002 if (!is_fork_parent
)
6004 /* Save the pid as a string before mourning, since that will
6005 unpush the remote target, and we need the string after. */
6006 std::string infpid
= target_pid_to_str (ptid_t (pid
));
6008 target_mourn_inferior (inferior_ptid
);
6009 if (print_inferior_events
)
6010 gdb_printf (_("[Inferior %d (%s) detached]\n"),
6011 inf
->num
, infpid
.c_str ());
6015 switch_to_no_thread ();
6016 detach_inferior (current_inferior ());
6021 remote_target::detach (inferior
*inf
, int from_tty
)
6023 remote_detach_1 (inf
, from_tty
);
6027 extended_remote_target::detach (inferior
*inf
, int from_tty
)
6029 remote_detach_1 (inf
, from_tty
);
6032 /* Target follow-fork function for remote targets. On entry, and
6033 at return, the current inferior is the fork parent.
6035 Note that although this is currently only used for extended-remote,
6036 it is named remote_follow_fork in anticipation of using it for the
6037 remote target as well. */
6040 remote_target::follow_fork (inferior
*child_inf
, ptid_t child_ptid
,
6041 target_waitkind fork_kind
, bool follow_child
,
6044 process_stratum_target::follow_fork (child_inf
, child_ptid
,
6045 fork_kind
, follow_child
, detach_fork
);
6047 struct remote_state
*rs
= get_remote_state ();
6049 if ((fork_kind
== TARGET_WAITKIND_FORKED
&& remote_fork_event_p (rs
))
6050 || (fork_kind
== TARGET_WAITKIND_VFORKED
&& remote_vfork_event_p (rs
)))
6052 /* When following the parent and detaching the child, we detach
6053 the child here. For the case of following the child and
6054 detaching the parent, the detach is done in the target-
6055 independent follow fork code in infrun.c. We can't use
6056 target_detach when detaching an unfollowed child because
6057 the client side doesn't know anything about the child. */
6058 if (detach_fork
&& !follow_child
)
6060 /* Detach the fork child. */
6061 remote_detach_pid (child_ptid
.pid ());
6066 /* Target follow-exec function for remote targets. Save EXECD_PATHNAME
6067 in the program space of the new inferior. */
6070 remote_target::follow_exec (inferior
*follow_inf
, ptid_t ptid
,
6071 const char *execd_pathname
)
6073 process_stratum_target::follow_exec (follow_inf
, ptid
, execd_pathname
);
6075 /* We know that this is a target file name, so if it has the "target:"
6076 prefix we strip it off before saving it in the program space. */
6077 if (is_target_filename (execd_pathname
))
6078 execd_pathname
+= strlen (TARGET_SYSROOT_PREFIX
);
6080 set_pspace_remote_exec_file (follow_inf
->pspace
, execd_pathname
);
6083 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
6086 remote_target::disconnect (const char *args
, int from_tty
)
6089 error (_("Argument given to \"disconnect\" when remotely debugging."));
6091 /* Make sure we unpush even the extended remote targets. Calling
6092 target_mourn_inferior won't unpush, and
6093 remote_target::mourn_inferior won't unpush if there is more than
6094 one inferior left. */
6095 remote_unpush_target (this);
6098 gdb_puts ("Ending remote debugging.\n");
6101 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
6102 be chatty about it. */
6105 extended_remote_target::attach (const char *args
, int from_tty
)
6107 struct remote_state
*rs
= get_remote_state ();
6109 char *wait_status
= NULL
;
6111 pid
= parse_pid_to_attach (args
);
6113 /* Remote PID can be freely equal to getpid, do not check it here the same
6114 way as in other targets. */
6116 if (packet_support (PACKET_vAttach
) == PACKET_DISABLE
)
6117 error (_("This target does not support attaching to a process"));
6119 target_announce_attach (from_tty
, pid
);
6121 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "vAttach;%x", pid
);
6123 getpkt (&rs
->buf
, 0);
6125 switch (packet_ok (rs
->buf
,
6126 &remote_protocol_packets
[PACKET_vAttach
]))
6129 if (!target_is_non_stop_p ())
6131 /* Save the reply for later. */
6132 wait_status
= (char *) alloca (strlen (rs
->buf
.data ()) + 1);
6133 strcpy (wait_status
, rs
->buf
.data ());
6135 else if (strcmp (rs
->buf
.data (), "OK") != 0)
6136 error (_("Attaching to %s failed with: %s"),
6137 target_pid_to_str (ptid_t (pid
)).c_str (),
6140 case PACKET_UNKNOWN
:
6141 error (_("This target does not support attaching to a process"));
6143 error (_("Attaching to %s failed"),
6144 target_pid_to_str (ptid_t (pid
)).c_str ());
6147 switch_to_inferior_no_thread (remote_add_inferior (false, pid
, 1, 0));
6149 inferior_ptid
= ptid_t (pid
);
6151 if (target_is_non_stop_p ())
6153 /* Get list of threads. */
6154 update_thread_list ();
6156 thread_info
*thread
= first_thread_of_inferior (current_inferior ());
6157 if (thread
!= nullptr)
6158 switch_to_thread (thread
);
6160 /* Invalidate our notion of the remote current thread. */
6161 record_currthread (rs
, minus_one_ptid
);
6165 /* Now, if we have thread information, update the main thread's
6167 ptid_t curr_ptid
= remote_current_thread (ptid_t (pid
));
6169 /* Add the main thread to the thread list. We add the thread
6170 silently in this case (the final true parameter). */
6171 thread_info
*thr
= remote_add_thread (curr_ptid
, true, true, true);
6173 switch_to_thread (thr
);
6176 /* Next, if the target can specify a description, read it. We do
6177 this before anything involving memory or registers. */
6178 target_find_description ();
6180 if (!target_is_non_stop_p ())
6182 /* Use the previously fetched status. */
6183 gdb_assert (wait_status
!= NULL
);
6185 struct notif_event
*reply
6186 = remote_notif_parse (this, ¬if_client_stop
, wait_status
);
6188 push_stop_reply ((struct stop_reply
*) reply
);
6192 gdb_assert (wait_status
== NULL
);
6194 gdb_assert (target_can_async_p ());
6198 /* Implementation of the to_post_attach method. */
6201 extended_remote_target::post_attach (int pid
)
6203 /* Get text, data & bss offsets. */
6206 /* In certain cases GDB might not have had the chance to start
6207 symbol lookup up until now. This could happen if the debugged
6208 binary is not using shared libraries, the vsyscall page is not
6209 present (on Linux) and the binary itself hadn't changed since the
6210 debugging process was started. */
6211 if (current_program_space
->symfile_object_file
!= NULL
)
6212 remote_check_symbols();
6216 /* Check for the availability of vCont. This function should also check
6220 remote_target::remote_vcont_probe ()
6222 remote_state
*rs
= get_remote_state ();
6225 strcpy (rs
->buf
.data (), "vCont?");
6227 getpkt (&rs
->buf
, 0);
6228 buf
= rs
->buf
.data ();
6230 /* Make sure that the features we assume are supported. */
6231 if (startswith (buf
, "vCont"))
6234 int support_c
, support_C
;
6236 rs
->supports_vCont
.s
= 0;
6237 rs
->supports_vCont
.S
= 0;
6240 rs
->supports_vCont
.t
= 0;
6241 rs
->supports_vCont
.r
= 0;
6242 while (p
&& *p
== ';')
6245 if (*p
== 's' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6246 rs
->supports_vCont
.s
= 1;
6247 else if (*p
== 'S' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6248 rs
->supports_vCont
.S
= 1;
6249 else if (*p
== 'c' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6251 else if (*p
== 'C' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6253 else if (*p
== 't' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6254 rs
->supports_vCont
.t
= 1;
6255 else if (*p
== 'r' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6256 rs
->supports_vCont
.r
= 1;
6258 p
= strchr (p
, ';');
6261 /* If c, and C are not all supported, we can't use vCont. Clearing
6262 BUF will make packet_ok disable the packet. */
6263 if (!support_c
|| !support_C
)
6267 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vCont
]);
6268 rs
->supports_vCont_probed
= true;
6271 /* Helper function for building "vCont" resumptions. Write a
6272 resumption to P. ENDP points to one-passed-the-end of the buffer
6273 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
6274 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
6275 resumed thread should be single-stepped and/or signalled. If PTID
6276 equals minus_one_ptid, then all threads are resumed; if PTID
6277 represents a process, then all threads of the process are
6281 remote_target::append_resumption (char *p
, char *endp
,
6282 ptid_t ptid
, int step
, gdb_signal siggnal
)
6284 struct remote_state
*rs
= get_remote_state ();
6286 if (step
&& siggnal
!= GDB_SIGNAL_0
)
6287 p
+= xsnprintf (p
, endp
- p
, ";S%02x", siggnal
);
6289 /* GDB is willing to range step. */
6290 && use_range_stepping
6291 /* Target supports range stepping. */
6292 && rs
->supports_vCont
.r
6293 /* We don't currently support range stepping multiple
6294 threads with a wildcard (though the protocol allows it,
6295 so stubs shouldn't make an active effort to forbid
6297 && !(remote_multi_process_p (rs
) && ptid
.is_pid ()))
6299 struct thread_info
*tp
;
6301 if (ptid
== minus_one_ptid
)
6303 /* If we don't know about the target thread's tid, then
6304 we're resuming magic_null_ptid (see caller). */
6305 tp
= find_thread_ptid (this, magic_null_ptid
);
6308 tp
= find_thread_ptid (this, ptid
);
6309 gdb_assert (tp
!= NULL
);
6311 if (tp
->control
.may_range_step
)
6313 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
6315 p
+= xsnprintf (p
, endp
- p
, ";r%s,%s",
6316 phex_nz (tp
->control
.step_range_start
,
6318 phex_nz (tp
->control
.step_range_end
,
6322 p
+= xsnprintf (p
, endp
- p
, ";s");
6325 p
+= xsnprintf (p
, endp
- p
, ";s");
6326 else if (siggnal
!= GDB_SIGNAL_0
)
6327 p
+= xsnprintf (p
, endp
- p
, ";C%02x", siggnal
);
6329 p
+= xsnprintf (p
, endp
- p
, ";c");
6331 if (remote_multi_process_p (rs
) && ptid
.is_pid ())
6335 /* All (-1) threads of process. */
6336 nptid
= ptid_t (ptid
.pid (), -1);
6338 p
+= xsnprintf (p
, endp
- p
, ":");
6339 p
= write_ptid (p
, endp
, nptid
);
6341 else if (ptid
!= minus_one_ptid
)
6343 p
+= xsnprintf (p
, endp
- p
, ":");
6344 p
= write_ptid (p
, endp
, ptid
);
6350 /* Clear the thread's private info on resume. */
6353 resume_clear_thread_private_info (struct thread_info
*thread
)
6355 if (thread
->priv
!= NULL
)
6357 remote_thread_info
*priv
= get_remote_thread_info (thread
);
6359 priv
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
6360 priv
->watch_data_address
= 0;
6364 /* Append a vCont continue-with-signal action for threads that have a
6365 non-zero stop signal. */
6368 remote_target::append_pending_thread_resumptions (char *p
, char *endp
,
6371 for (thread_info
*thread
: all_non_exited_threads (this, ptid
))
6372 if (inferior_ptid
!= thread
->ptid
6373 && thread
->stop_signal () != GDB_SIGNAL_0
)
6375 p
= append_resumption (p
, endp
, thread
->ptid
,
6376 0, thread
->stop_signal ());
6377 thread
->set_stop_signal (GDB_SIGNAL_0
);
6378 resume_clear_thread_private_info (thread
);
6384 /* Set the target running, using the packets that use Hc
6388 remote_target::remote_resume_with_hc (ptid_t ptid
, int step
,
6391 struct remote_state
*rs
= get_remote_state ();
6394 rs
->last_sent_signal
= siggnal
;
6395 rs
->last_sent_step
= step
;
6397 /* The c/s/C/S resume packets use Hc, so set the continue
6399 if (ptid
== minus_one_ptid
)
6400 set_continue_thread (any_thread_ptid
);
6402 set_continue_thread (ptid
);
6404 for (thread_info
*thread
: all_non_exited_threads (this))
6405 resume_clear_thread_private_info (thread
);
6407 buf
= rs
->buf
.data ();
6408 if (::execution_direction
== EXEC_REVERSE
)
6410 /* We don't pass signals to the target in reverse exec mode. */
6411 if (info_verbose
&& siggnal
!= GDB_SIGNAL_0
)
6412 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
6415 if (step
&& packet_support (PACKET_bs
) == PACKET_DISABLE
)
6416 error (_("Remote reverse-step not supported."));
6417 if (!step
&& packet_support (PACKET_bc
) == PACKET_DISABLE
)
6418 error (_("Remote reverse-continue not supported."));
6420 strcpy (buf
, step
? "bs" : "bc");
6422 else if (siggnal
!= GDB_SIGNAL_0
)
6424 buf
[0] = step
? 'S' : 'C';
6425 buf
[1] = tohex (((int) siggnal
>> 4) & 0xf);
6426 buf
[2] = tohex (((int) siggnal
) & 0xf);
6430 strcpy (buf
, step
? "s" : "c");
6435 /* Resume the remote inferior by using a "vCont" packet. SCOPE_PTID,
6436 STEP, and SIGGNAL have the same meaning as in target_resume. This
6437 function returns non-zero iff it resumes the inferior.
6439 This function issues a strict subset of all possible vCont commands
6443 remote_target::remote_resume_with_vcont (ptid_t scope_ptid
, int step
,
6444 enum gdb_signal siggnal
)
6446 struct remote_state
*rs
= get_remote_state ();
6450 /* No reverse execution actions defined for vCont. */
6451 if (::execution_direction
== EXEC_REVERSE
)
6454 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
6455 remote_vcont_probe ();
6457 if (packet_support (PACKET_vCont
) == PACKET_DISABLE
)
6460 p
= rs
->buf
.data ();
6461 endp
= p
+ get_remote_packet_size ();
6463 /* If we could generate a wider range of packets, we'd have to worry
6464 about overflowing BUF. Should there be a generic
6465 "multi-part-packet" packet? */
6467 p
+= xsnprintf (p
, endp
- p
, "vCont");
6469 if (scope_ptid
== magic_null_ptid
)
6471 /* MAGIC_NULL_PTID means that we don't have any active threads,
6472 so we don't have any TID numbers the inferior will
6473 understand. Make sure to only send forms that do not specify
6475 append_resumption (p
, endp
, minus_one_ptid
, step
, siggnal
);
6477 else if (scope_ptid
== minus_one_ptid
|| scope_ptid
.is_pid ())
6479 /* Resume all threads (of all processes, or of a single
6480 process), with preference for INFERIOR_PTID. This assumes
6481 inferior_ptid belongs to the set of all threads we are about
6483 if (step
|| siggnal
!= GDB_SIGNAL_0
)
6485 /* Step inferior_ptid, with or without signal. */
6486 p
= append_resumption (p
, endp
, inferior_ptid
, step
, siggnal
);
6489 /* Also pass down any pending signaled resumption for other
6490 threads not the current. */
6491 p
= append_pending_thread_resumptions (p
, endp
, scope_ptid
);
6493 /* And continue others without a signal. */
6494 append_resumption (p
, endp
, scope_ptid
, /*step=*/ 0, GDB_SIGNAL_0
);
6498 /* Scheduler locking; resume only SCOPE_PTID. */
6499 append_resumption (p
, endp
, scope_ptid
, step
, siggnal
);
6502 gdb_assert (strlen (rs
->buf
.data ()) < get_remote_packet_size ());
6505 if (target_is_non_stop_p ())
6507 /* In non-stop, the stub replies to vCont with "OK". The stop
6508 reply will be reported asynchronously by means of a `%Stop'
6510 getpkt (&rs
->buf
, 0);
6511 if (strcmp (rs
->buf
.data (), "OK") != 0)
6512 error (_("Unexpected vCont reply in non-stop mode: %s"),
6519 /* Tell the remote machine to resume. */
6522 remote_target::resume (ptid_t scope_ptid
, int step
, enum gdb_signal siggnal
)
6524 struct remote_state
*rs
= get_remote_state ();
6526 /* When connected in non-stop mode, the core resumes threads
6527 individually. Resuming remote threads directly in target_resume
6528 would thus result in sending one packet per thread. Instead, to
6529 minimize roundtrip latency, here we just store the resume
6530 request (put the thread in RESUMED_PENDING_VCONT state); the actual remote
6531 resumption will be done in remote_target::commit_resume, where we'll be
6532 able to do vCont action coalescing. */
6533 if (target_is_non_stop_p () && ::execution_direction
!= EXEC_REVERSE
)
6535 remote_thread_info
*remote_thr
6536 = get_remote_thread_info (inferior_thread ());
6538 /* We don't expect the core to ask to resume an already resumed (from
6539 its point of view) thread. */
6540 gdb_assert (remote_thr
->get_resume_state () == resume_state::NOT_RESUMED
);
6542 remote_thr
->set_resumed_pending_vcont (step
, siggnal
);
6544 /* There's actually nothing that says that the core can't
6545 request a wildcard resume in non-stop mode, though. It's
6546 just that we know it doesn't currently, so we don't bother
6548 gdb_assert (scope_ptid
== inferior_ptid
);
6552 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
6553 (explained in remote-notif.c:handle_notification) so
6554 remote_notif_process is not called. We need find a place where
6555 it is safe to start a 'vNotif' sequence. It is good to do it
6556 before resuming inferior, because inferior was stopped and no RSP
6557 traffic at that moment. */
6558 if (!target_is_non_stop_p ())
6559 remote_notif_process (rs
->notif_state
, ¬if_client_stop
);
6561 rs
->last_resume_exec_dir
= ::execution_direction
;
6563 /* Prefer vCont, and fallback to s/c/S/C, which use Hc. */
6564 if (!remote_resume_with_vcont (scope_ptid
, step
, siggnal
))
6565 remote_resume_with_hc (scope_ptid
, step
, siggnal
);
6567 /* Update resumed state tracked by the remote target. */
6568 for (thread_info
*tp
: all_non_exited_threads (this, scope_ptid
))
6569 get_remote_thread_info (tp
)->set_resumed ();
6571 /* We've just told the target to resume. The remote server will
6572 wait for the inferior to stop, and then send a stop reply. In
6573 the mean time, we can't start another command/query ourselves
6574 because the stub wouldn't be ready to process it. This applies
6575 only to the base all-stop protocol, however. In non-stop (which
6576 only supports vCont), the stub replies with an "OK", and is
6577 immediate able to process further serial input. */
6578 if (!target_is_non_stop_p ())
6579 rs
->waiting_for_stop_reply
= 1;
6582 /* Private per-inferior info for target remote processes. */
6584 struct remote_inferior
: public private_inferior
6586 /* Whether we can send a wildcard vCont for this process. */
6587 bool may_wildcard_vcont
= true;
6590 /* Get the remote private inferior data associated to INF. */
6592 static remote_inferior
*
6593 get_remote_inferior (inferior
*inf
)
6595 if (inf
->priv
== NULL
)
6596 inf
->priv
.reset (new remote_inferior
);
6598 return static_cast<remote_inferior
*> (inf
->priv
.get ());
6601 /* Class used to track the construction of a vCont packet in the
6602 outgoing packet buffer. This is used to send multiple vCont
6603 packets if we have more actions than would fit a single packet. */
6608 explicit vcont_builder (remote_target
*remote
)
6615 void push_action (ptid_t ptid
, bool step
, gdb_signal siggnal
);
6620 /* The remote target. */
6621 remote_target
*m_remote
;
6623 /* Pointer to the first action. P points here if no action has been
6625 char *m_first_action
;
6627 /* Where the next action will be appended. */
6630 /* The end of the buffer. Must never write past this. */
6634 /* Prepare the outgoing buffer for a new vCont packet. */
6637 vcont_builder::restart ()
6639 struct remote_state
*rs
= m_remote
->get_remote_state ();
6641 m_p
= rs
->buf
.data ();
6642 m_endp
= m_p
+ m_remote
->get_remote_packet_size ();
6643 m_p
+= xsnprintf (m_p
, m_endp
- m_p
, "vCont");
6644 m_first_action
= m_p
;
6647 /* If the vCont packet being built has any action, send it to the
6651 vcont_builder::flush ()
6653 struct remote_state
*rs
;
6655 if (m_p
== m_first_action
)
6658 rs
= m_remote
->get_remote_state ();
6659 m_remote
->putpkt (rs
->buf
);
6660 m_remote
->getpkt (&rs
->buf
, 0);
6661 if (strcmp (rs
->buf
.data (), "OK") != 0)
6662 error (_("Unexpected vCont reply in non-stop mode: %s"), rs
->buf
.data ());
6665 /* The largest action is range-stepping, with its two addresses. This
6666 is more than sufficient. If a new, bigger action is created, it'll
6667 quickly trigger a failed assertion in append_resumption (and we'll
6669 #define MAX_ACTION_SIZE 200
6671 /* Append a new vCont action in the outgoing packet being built. If
6672 the action doesn't fit the packet along with previous actions, push
6673 what we've got so far to the remote end and start over a new vCont
6674 packet (with the new action). */
6677 vcont_builder::push_action (ptid_t ptid
, bool step
, gdb_signal siggnal
)
6679 char buf
[MAX_ACTION_SIZE
+ 1];
6681 char *endp
= m_remote
->append_resumption (buf
, buf
+ sizeof (buf
),
6682 ptid
, step
, siggnal
);
6684 /* Check whether this new action would fit in the vCont packet along
6685 with previous actions. If not, send what we've got so far and
6686 start a new vCont packet. */
6687 size_t rsize
= endp
- buf
;
6688 if (rsize
> m_endp
- m_p
)
6693 /* Should now fit. */
6694 gdb_assert (rsize
<= m_endp
- m_p
);
6697 memcpy (m_p
, buf
, rsize
);
6702 /* to_commit_resume implementation. */
6705 remote_target::commit_resumed ()
6707 /* If connected in all-stop mode, we'd send the remote resume
6708 request directly from remote_resume. Likewise if
6709 reverse-debugging, as there are no defined vCont actions for
6710 reverse execution. */
6711 if (!target_is_non_stop_p () || ::execution_direction
== EXEC_REVERSE
)
6714 /* Try to send wildcard actions ("vCont;c" or "vCont;c:pPID.-1")
6715 instead of resuming all threads of each process individually.
6716 However, if any thread of a process must remain halted, we can't
6717 send wildcard resumes and must send one action per thread.
6719 Care must be taken to not resume threads/processes the server
6720 side already told us are stopped, but the core doesn't know about
6721 yet, because the events are still in the vStopped notification
6724 #1 => vCont s:p1.1;c
6726 #3 <= %Stopped T05 p1.1
6731 #8 (infrun handles the stop for p1.1 and continues stepping)
6732 #9 => vCont s:p1.1;c
6734 The last vCont above would resume thread p1.2 by mistake, because
6735 the server has no idea that the event for p1.2 had not been
6738 The server side must similarly ignore resume actions for the
6739 thread that has a pending %Stopped notification (and any other
6740 threads with events pending), until GDB acks the notification
6741 with vStopped. Otherwise, e.g., the following case is
6744 #1 => g (or any other packet)
6746 #3 <= %Stopped T05 p1.2
6747 #4 => vCont s:p1.1;c
6750 Above, the server must not resume thread p1.2. GDB can't know
6751 that p1.2 stopped until it acks the %Stopped notification, and
6752 since from GDB's perspective all threads should be running, it
6755 Finally, special care must also be given to handling fork/vfork
6756 events. A (v)fork event actually tells us that two processes
6757 stopped -- the parent and the child. Until we follow the fork,
6758 we must not resume the child. Therefore, if we have a pending
6759 fork follow, we must not send a global wildcard resume action
6760 (vCont;c). We can still send process-wide wildcards though. */
6762 /* Start by assuming a global wildcard (vCont;c) is possible. */
6763 bool may_global_wildcard_vcont
= true;
6765 /* And assume every process is individually wildcard-able too. */
6766 for (inferior
*inf
: all_non_exited_inferiors (this))
6768 remote_inferior
*priv
= get_remote_inferior (inf
);
6770 priv
->may_wildcard_vcont
= true;
6773 /* Check for any pending events (not reported or processed yet) and
6774 disable process and global wildcard resumes appropriately. */
6775 check_pending_events_prevent_wildcard_vcont (&may_global_wildcard_vcont
);
6777 bool any_pending_vcont_resume
= false;
6779 for (thread_info
*tp
: all_non_exited_threads (this))
6781 remote_thread_info
*priv
= get_remote_thread_info (tp
);
6783 /* If a thread of a process is not meant to be resumed, then we
6784 can't wildcard that process. */
6785 if (priv
->get_resume_state () == resume_state::NOT_RESUMED
)
6787 get_remote_inferior (tp
->inf
)->may_wildcard_vcont
= false;
6789 /* And if we can't wildcard a process, we can't wildcard
6790 everything either. */
6791 may_global_wildcard_vcont
= false;
6795 if (priv
->get_resume_state () == resume_state::RESUMED_PENDING_VCONT
)
6796 any_pending_vcont_resume
= true;
6798 /* If a thread is the parent of an unfollowed fork, then we
6799 can't do a global wildcard, as that would resume the fork
6801 if (thread_pending_fork_status (tp
) != nullptr)
6802 may_global_wildcard_vcont
= false;
6805 /* We didn't have any resumed thread pending a vCont resume, so nothing to
6807 if (!any_pending_vcont_resume
)
6810 /* Now let's build the vCont packet(s). Actions must be appended
6811 from narrower to wider scopes (thread -> process -> global). If
6812 we end up with too many actions for a single packet vcont_builder
6813 flushes the current vCont packet to the remote side and starts a
6815 struct vcont_builder
vcont_builder (this);
6817 /* Threads first. */
6818 for (thread_info
*tp
: all_non_exited_threads (this))
6820 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6822 /* If the thread was previously vCont-resumed, no need to send a specific
6823 action for it. If we didn't receive a resume request for it, don't
6824 send an action for it either. */
6825 if (remote_thr
->get_resume_state () != resume_state::RESUMED_PENDING_VCONT
)
6828 gdb_assert (!thread_is_in_step_over_chain (tp
));
6830 /* We should never be commit-resuming a thread that has a stop reply.
6831 Otherwise, we would end up reporting a stop event for a thread while
6832 it is running on the remote target. */
6833 remote_state
*rs
= get_remote_state ();
6834 for (const auto &stop_reply
: rs
->stop_reply_queue
)
6835 gdb_assert (stop_reply
->ptid
!= tp
->ptid
);
6837 const resumed_pending_vcont_info
&info
6838 = remote_thr
->resumed_pending_vcont_info ();
6840 /* Check if we need to send a specific action for this thread. If not,
6841 it will be included in a wildcard resume instead. */
6842 if (info
.step
|| info
.sig
!= GDB_SIGNAL_0
6843 || !get_remote_inferior (tp
->inf
)->may_wildcard_vcont
)
6844 vcont_builder
.push_action (tp
->ptid
, info
.step
, info
.sig
);
6846 remote_thr
->set_resumed ();
6849 /* Now check whether we can send any process-wide wildcard. This is
6850 to avoid sending a global wildcard in the case nothing is
6851 supposed to be resumed. */
6852 bool any_process_wildcard
= false;
6854 for (inferior
*inf
: all_non_exited_inferiors (this))
6856 if (get_remote_inferior (inf
)->may_wildcard_vcont
)
6858 any_process_wildcard
= true;
6863 if (any_process_wildcard
)
6865 /* If all processes are wildcard-able, then send a single "c"
6866 action, otherwise, send an "all (-1) threads of process"
6867 continue action for each running process, if any. */
6868 if (may_global_wildcard_vcont
)
6870 vcont_builder
.push_action (minus_one_ptid
,
6871 false, GDB_SIGNAL_0
);
6875 for (inferior
*inf
: all_non_exited_inferiors (this))
6877 if (get_remote_inferior (inf
)->may_wildcard_vcont
)
6879 vcont_builder
.push_action (ptid_t (inf
->pid
),
6880 false, GDB_SIGNAL_0
);
6886 vcont_builder
.flush ();
6889 /* Implementation of target_has_pending_events. */
6892 remote_target::has_pending_events ()
6894 if (target_can_async_p ())
6896 remote_state
*rs
= get_remote_state ();
6898 if (async_event_handler_marked (rs
->remote_async_inferior_event_token
))
6901 /* Note that BUFCNT can be negative, indicating sticky
6903 if (rs
->remote_desc
->bufcnt
!= 0)
6911 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
6912 thread, all threads of a remote process, or all threads of all
6916 remote_target::remote_stop_ns (ptid_t ptid
)
6918 struct remote_state
*rs
= get_remote_state ();
6919 char *p
= rs
->buf
.data ();
6920 char *endp
= p
+ get_remote_packet_size ();
6922 /* If any thread that needs to stop was resumed but pending a vCont
6923 resume, generate a phony stop_reply. However, first check
6924 whether the thread wasn't resumed with a signal. Generating a
6925 phony stop in that case would result in losing the signal. */
6926 bool needs_commit
= false;
6927 for (thread_info
*tp
: all_non_exited_threads (this, ptid
))
6929 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6931 if (remote_thr
->get_resume_state ()
6932 == resume_state::RESUMED_PENDING_VCONT
)
6934 const resumed_pending_vcont_info
&info
6935 = remote_thr
->resumed_pending_vcont_info ();
6936 if (info
.sig
!= GDB_SIGNAL_0
)
6938 /* This signal must be forwarded to the inferior. We
6939 could commit-resume just this thread, but its simpler
6940 to just commit-resume everything. */
6941 needs_commit
= true;
6950 for (thread_info
*tp
: all_non_exited_threads (this, ptid
))
6952 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6954 if (remote_thr
->get_resume_state ()
6955 == resume_state::RESUMED_PENDING_VCONT
)
6957 remote_debug_printf ("Enqueueing phony stop reply for thread pending "
6958 "vCont-resume (%d, %ld, %s)", tp
->ptid
.pid(),
6960 pulongest (tp
->ptid
.tid ()));
6962 /* Check that the thread wasn't resumed with a signal.
6963 Generating a phony stop would result in losing the
6965 const resumed_pending_vcont_info
&info
6966 = remote_thr
->resumed_pending_vcont_info ();
6967 gdb_assert (info
.sig
== GDB_SIGNAL_0
);
6969 stop_reply
*sr
= new stop_reply ();
6970 sr
->ptid
= tp
->ptid
;
6972 sr
->ws
.set_stopped (GDB_SIGNAL_0
);
6973 sr
->arch
= tp
->inf
->gdbarch
;
6974 sr
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
6975 sr
->watch_data_address
= 0;
6977 this->push_stop_reply (sr
);
6979 /* Pretend that this thread was actually resumed on the
6980 remote target, then stopped. If we leave it in the
6981 RESUMED_PENDING_VCONT state and the commit_resumed
6982 method is called while the stop reply is still in the
6983 queue, we'll end up reporting a stop event to the core
6984 for that thread while it is running on the remote
6985 target... that would be bad. */
6986 remote_thr
->set_resumed ();
6990 /* FIXME: This supports_vCont_probed check is a workaround until
6991 packet_support is per-connection. */
6992 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
6993 || !rs
->supports_vCont_probed
)
6994 remote_vcont_probe ();
6996 if (!rs
->supports_vCont
.t
)
6997 error (_("Remote server does not support stopping threads"));
6999 if (ptid
== minus_one_ptid
7000 || (!remote_multi_process_p (rs
) && ptid
.is_pid ()))
7001 p
+= xsnprintf (p
, endp
- p
, "vCont;t");
7006 p
+= xsnprintf (p
, endp
- p
, "vCont;t:");
7009 /* All (-1) threads of process. */
7010 nptid
= ptid_t (ptid
.pid (), -1);
7013 /* Small optimization: if we already have a stop reply for
7014 this thread, no use in telling the stub we want this
7016 if (peek_stop_reply (ptid
))
7022 write_ptid (p
, endp
, nptid
);
7025 /* In non-stop, we get an immediate OK reply. The stop reply will
7026 come in asynchronously by notification. */
7028 getpkt (&rs
->buf
, 0);
7029 if (strcmp (rs
->buf
.data (), "OK") != 0)
7030 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid
).c_str (),
7034 /* All-stop version of target_interrupt. Sends a break or a ^C to
7035 interrupt the remote target. It is undefined which thread of which
7036 process reports the interrupt. */
7039 remote_target::remote_interrupt_as ()
7041 struct remote_state
*rs
= get_remote_state ();
7043 rs
->ctrlc_pending_p
= 1;
7045 /* If the inferior is stopped already, but the core didn't know
7046 about it yet, just ignore the request. The pending stop events
7047 will be collected in remote_wait. */
7048 if (stop_reply_queue_length () > 0)
7051 /* Send interrupt_sequence to remote target. */
7052 send_interrupt_sequence ();
7055 /* Non-stop version of target_interrupt. Uses `vCtrlC' to interrupt
7056 the remote target. It is undefined which thread of which process
7057 reports the interrupt. Throws an error if the packet is not
7058 supported by the server. */
7061 remote_target::remote_interrupt_ns ()
7063 struct remote_state
*rs
= get_remote_state ();
7064 char *p
= rs
->buf
.data ();
7065 char *endp
= p
+ get_remote_packet_size ();
7067 xsnprintf (p
, endp
- p
, "vCtrlC");
7069 /* In non-stop, we get an immediate OK reply. The stop reply will
7070 come in asynchronously by notification. */
7072 getpkt (&rs
->buf
, 0);
7074 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vCtrlC
]))
7078 case PACKET_UNKNOWN
:
7079 error (_("No support for interrupting the remote target."));
7081 error (_("Interrupting target failed: %s"), rs
->buf
.data ());
7085 /* Implement the to_stop function for the remote targets. */
7088 remote_target::stop (ptid_t ptid
)
7090 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7092 if (target_is_non_stop_p ())
7093 remote_stop_ns (ptid
);
7096 /* We don't currently have a way to transparently pause the
7097 remote target in all-stop mode. Interrupt it instead. */
7098 remote_interrupt_as ();
7102 /* Implement the to_interrupt function for the remote targets. */
7105 remote_target::interrupt ()
7107 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7109 if (target_is_non_stop_p ())
7110 remote_interrupt_ns ();
7112 remote_interrupt_as ();
7115 /* Implement the to_pass_ctrlc function for the remote targets. */
7118 remote_target::pass_ctrlc ()
7120 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7122 struct remote_state
*rs
= get_remote_state ();
7124 /* If we're starting up, we're not fully synced yet. Quit
7126 if (rs
->starting_up
)
7128 /* If ^C has already been sent once, offer to disconnect. */
7129 else if (rs
->ctrlc_pending_p
)
7132 target_interrupt ();
7135 /* Ask the user what to do when an interrupt is received. */
7138 remote_target::interrupt_query ()
7140 struct remote_state
*rs
= get_remote_state ();
7142 if (rs
->waiting_for_stop_reply
&& rs
->ctrlc_pending_p
)
7144 if (query (_("The target is not responding to interrupt requests.\n"
7145 "Stop debugging it? ")))
7147 remote_unpush_target (this);
7148 throw_error (TARGET_CLOSE_ERROR
, _("Disconnected from target."));
7153 if (query (_("Interrupted while waiting for the program.\n"
7154 "Give up waiting? ")))
7159 /* Enable/disable target terminal ownership. Most targets can use
7160 terminal groups to control terminal ownership. Remote targets are
7161 different in that explicit transfer of ownership to/from GDB/target
7165 remote_target::terminal_inferior ()
7167 /* NOTE: At this point we could also register our selves as the
7168 recipient of all input. Any characters typed could then be
7169 passed on down to the target. */
7173 remote_target::terminal_ours ()
7178 remote_console_output (const char *msg
)
7182 for (p
= msg
; p
[0] && p
[1]; p
+= 2)
7185 char c
= fromhex (p
[0]) * 16 + fromhex (p
[1]);
7189 gdb_stdtarg
->puts (tb
);
7191 gdb_stdtarg
->flush ();
7194 /* Return the length of the stop reply queue. */
7197 remote_target::stop_reply_queue_length ()
7199 remote_state
*rs
= get_remote_state ();
7200 return rs
->stop_reply_queue
.size ();
7204 remote_notif_stop_parse (remote_target
*remote
,
7205 struct notif_client
*self
, const char *buf
,
7206 struct notif_event
*event
)
7208 remote
->remote_parse_stop_reply (buf
, (struct stop_reply
*) event
);
7212 remote_notif_stop_ack (remote_target
*remote
,
7213 struct notif_client
*self
, const char *buf
,
7214 struct notif_event
*event
)
7216 struct stop_reply
*stop_reply
= (struct stop_reply
*) event
;
7219 putpkt (remote
, self
->ack_command
);
7221 /* Kind can be TARGET_WAITKIND_IGNORE if we have meanwhile discarded
7222 the notification. It was left in the queue because we need to
7223 acknowledge it and pull the rest of the notifications out. */
7224 if (stop_reply
->ws
.kind () != TARGET_WAITKIND_IGNORE
)
7225 remote
->push_stop_reply (stop_reply
);
7229 remote_notif_stop_can_get_pending_events (remote_target
*remote
,
7230 struct notif_client
*self
)
7232 /* We can't get pending events in remote_notif_process for
7233 notification stop, and we have to do this in remote_wait_ns
7234 instead. If we fetch all queued events from stub, remote stub
7235 may exit and we have no chance to process them back in
7237 remote_state
*rs
= remote
->get_remote_state ();
7238 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7242 stop_reply::~stop_reply ()
7244 for (cached_reg_t
®
: regcache
)
7248 static notif_event_up
7249 remote_notif_stop_alloc_reply ()
7251 return notif_event_up (new struct stop_reply ());
7254 /* A client of notification Stop. */
7256 struct notif_client notif_client_stop
=
7260 remote_notif_stop_parse
,
7261 remote_notif_stop_ack
,
7262 remote_notif_stop_can_get_pending_events
,
7263 remote_notif_stop_alloc_reply
,
7267 /* If CONTEXT contains any fork child threads that have not been
7268 reported yet, remove them from the CONTEXT list. If such a
7269 thread exists it is because we are stopped at a fork catchpoint
7270 and have not yet called follow_fork, which will set up the
7271 host-side data structures for the new process. */
7274 remote_target::remove_new_fork_children (threads_listing_context
*context
)
7276 struct notif_client
*notif
= ¬if_client_stop
;
7278 /* For any threads stopped at a fork event, remove the corresponding
7279 fork child threads from the CONTEXT list. */
7280 for (thread_info
*thread
: all_non_exited_threads (this))
7282 const target_waitstatus
*ws
= thread_pending_fork_status (thread
);
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 context
->remove_thread (event
->ws
.child_ptid ());
7298 else if (event
->ws
.kind () == TARGET_WAITKIND_THREAD_EXITED
)
7299 context
->remove_thread (event
->ptid
);
7302 /* Check whether any event pending in the vStopped queue would prevent a
7303 global or process wildcard vCont action. Set *may_global_wildcard to
7304 false if we can't do a global wildcard (vCont;c), and clear the event
7305 inferior's may_wildcard_vcont flag if we can't do a process-wide
7306 wildcard resume (vCont;c:pPID.-1). */
7309 remote_target::check_pending_events_prevent_wildcard_vcont
7310 (bool *may_global_wildcard
)
7312 struct notif_client
*notif
= ¬if_client_stop
;
7314 remote_notif_get_pending_events (notif
);
7315 for (auto &event
: get_remote_state ()->stop_reply_queue
)
7317 if (event
->ws
.kind () == TARGET_WAITKIND_NO_RESUMED
7318 || event
->ws
.kind () == TARGET_WAITKIND_NO_HISTORY
)
7321 if (event
->ws
.kind () == TARGET_WAITKIND_FORKED
7322 || event
->ws
.kind () == TARGET_WAITKIND_VFORKED
)
7323 *may_global_wildcard
= false;
7325 /* This may be the first time we heard about this process.
7326 Regardless, we must not do a global wildcard resume, otherwise
7327 we'd resume this process too. */
7328 *may_global_wildcard
= false;
7329 if (event
->ptid
!= null_ptid
)
7331 inferior
*inf
= find_inferior_ptid (this, event
->ptid
);
7333 get_remote_inferior (inf
)->may_wildcard_vcont
= false;
7338 /* Discard all pending stop replies of inferior INF. */
7341 remote_target::discard_pending_stop_replies (struct inferior
*inf
)
7343 struct stop_reply
*reply
;
7344 struct remote_state
*rs
= get_remote_state ();
7345 struct remote_notif_state
*rns
= rs
->notif_state
;
7347 /* This function can be notified when an inferior exists. When the
7348 target is not remote, the notification state is NULL. */
7349 if (rs
->remote_desc
== NULL
)
7352 reply
= (struct stop_reply
*) rns
->pending_event
[notif_client_stop
.id
];
7354 /* Discard the in-flight notification. */
7355 if (reply
!= NULL
&& reply
->ptid
.pid () == inf
->pid
)
7357 /* Leave the notification pending, since the server expects that
7358 we acknowledge it with vStopped. But clear its contents, so
7359 that later on when we acknowledge it, we also discard it. */
7361 ("discarding in-flight notification: ptid: %s, ws: %s\n",
7362 reply
->ptid
.to_string().c_str(),
7363 reply
->ws
.to_string ().c_str ());
7364 reply
->ws
.set_ignore ();
7367 /* Discard the stop replies we have already pulled with
7369 auto iter
= std::remove_if (rs
->stop_reply_queue
.begin (),
7370 rs
->stop_reply_queue
.end (),
7371 [=] (const stop_reply_up
&event
)
7373 return event
->ptid
.pid () == inf
->pid
;
7375 for (auto it
= iter
; it
!= rs
->stop_reply_queue
.end (); ++it
)
7377 ("discarding queued stop reply: ptid: %s, ws: %s\n",
7378 reply
->ptid
.to_string().c_str(),
7379 reply
->ws
.to_string ().c_str ());
7380 rs
->stop_reply_queue
.erase (iter
, rs
->stop_reply_queue
.end ());
7383 /* Discard the stop replies for RS in stop_reply_queue. */
7386 remote_target::discard_pending_stop_replies_in_queue ()
7388 remote_state
*rs
= get_remote_state ();
7390 /* Discard the stop replies we have already pulled with
7392 auto iter
= std::remove_if (rs
->stop_reply_queue
.begin (),
7393 rs
->stop_reply_queue
.end (),
7394 [=] (const stop_reply_up
&event
)
7396 return event
->rs
== rs
;
7398 rs
->stop_reply_queue
.erase (iter
, rs
->stop_reply_queue
.end ());
7401 /* Remove the first reply in 'stop_reply_queue' which matches
7405 remote_target::remote_notif_remove_queued_reply (ptid_t ptid
)
7407 remote_state
*rs
= get_remote_state ();
7409 auto iter
= std::find_if (rs
->stop_reply_queue
.begin (),
7410 rs
->stop_reply_queue
.end (),
7411 [=] (const stop_reply_up
&event
)
7413 return event
->ptid
.matches (ptid
);
7415 struct stop_reply
*result
;
7416 if (iter
== rs
->stop_reply_queue
.end ())
7420 result
= iter
->release ();
7421 rs
->stop_reply_queue
.erase (iter
);
7425 gdb_printf (gdb_stdlog
,
7426 "notif: discard queued event: 'Stop' in %s\n",
7427 ptid
.to_string ().c_str ());
7432 /* Look for a queued stop reply belonging to PTID. If one is found,
7433 remove it from the queue, and return it. Returns NULL if none is
7434 found. If there are still queued events left to process, tell the
7435 event loop to get back to target_wait soon. */
7438 remote_target::queued_stop_reply (ptid_t ptid
)
7440 remote_state
*rs
= get_remote_state ();
7441 struct stop_reply
*r
= remote_notif_remove_queued_reply (ptid
);
7443 if (!rs
->stop_reply_queue
.empty () && target_can_async_p ())
7445 /* There's still at least an event left. */
7446 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7452 /* Push a fully parsed stop reply in the stop reply queue. Since we
7453 know that we now have at least one queued event left to pass to the
7454 core side, tell the event loop to get back to target_wait soon. */
7457 remote_target::push_stop_reply (struct stop_reply
*new_event
)
7459 remote_state
*rs
= get_remote_state ();
7460 rs
->stop_reply_queue
.push_back (stop_reply_up (new_event
));
7463 gdb_printf (gdb_stdlog
,
7464 "notif: push 'Stop' %s to queue %d\n",
7465 new_event
->ptid
.to_string ().c_str (),
7466 int (rs
->stop_reply_queue
.size ()));
7468 /* Mark the pending event queue only if async mode is currently enabled.
7469 If async mode is not currently enabled, then, if it later becomes
7470 enabled, and there are events in this queue, we will mark the event
7471 token at that point, see remote_target::async. */
7472 if (target_is_async_p ())
7473 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7476 /* Returns true if we have a stop reply for PTID. */
7479 remote_target::peek_stop_reply (ptid_t ptid
)
7481 remote_state
*rs
= get_remote_state ();
7482 for (auto &event
: rs
->stop_reply_queue
)
7483 if (ptid
== event
->ptid
7484 && event
->ws
.kind () == TARGET_WAITKIND_STOPPED
)
7489 /* Helper for remote_parse_stop_reply. Return nonzero if the substring
7490 starting with P and ending with PEND matches PREFIX. */
7493 strprefix (const char *p
, const char *pend
, const char *prefix
)
7495 for ( ; p
< pend
; p
++, prefix
++)
7498 return *prefix
== '\0';
7501 /* Parse the stop reply in BUF. Either the function succeeds, and the
7502 result is stored in EVENT, or throws an error. */
7505 remote_target::remote_parse_stop_reply (const char *buf
, stop_reply
*event
)
7507 remote_arch_state
*rsa
= NULL
;
7512 event
->ptid
= null_ptid
;
7513 event
->rs
= get_remote_state ();
7514 event
->ws
.set_ignore ();
7515 event
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
7516 event
->regcache
.clear ();
7521 case 'T': /* Status with PC, SP, FP, ... */
7522 /* Expedited reply, containing Signal, {regno, reg} repeat. */
7523 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
7525 n... = register number
7526 r... = register contents
7529 p
= &buf
[3]; /* after Txx */
7535 p1
= strchr (p
, ':');
7537 error (_("Malformed packet(a) (missing colon): %s\n\
7541 error (_("Malformed packet(a) (missing register number): %s\n\
7545 /* Some "registers" are actually extended stop information.
7546 Note if you're adding a new entry here: GDB 7.9 and
7547 earlier assume that all register "numbers" that start
7548 with an hex digit are real register numbers. Make sure
7549 the server only sends such a packet if it knows the
7550 client understands it. */
7552 if (strprefix (p
, p1
, "thread"))
7553 event
->ptid
= read_ptid (++p1
, &p
);
7554 else if (strprefix (p
, p1
, "syscall_entry"))
7558 p
= unpack_varlen_hex (++p1
, &sysno
);
7559 event
->ws
.set_syscall_entry ((int) sysno
);
7561 else if (strprefix (p
, p1
, "syscall_return"))
7565 p
= unpack_varlen_hex (++p1
, &sysno
);
7566 event
->ws
.set_syscall_return ((int) sysno
);
7568 else if (strprefix (p
, p1
, "watch")
7569 || strprefix (p
, p1
, "rwatch")
7570 || strprefix (p
, p1
, "awatch"))
7572 event
->stop_reason
= TARGET_STOPPED_BY_WATCHPOINT
;
7573 p
= unpack_varlen_hex (++p1
, &addr
);
7574 event
->watch_data_address
= (CORE_ADDR
) addr
;
7576 else if (strprefix (p
, p1
, "swbreak"))
7578 event
->stop_reason
= TARGET_STOPPED_BY_SW_BREAKPOINT
;
7580 /* Make sure the stub doesn't forget to indicate support
7582 if (packet_support (PACKET_swbreak_feature
) != PACKET_ENABLE
)
7583 error (_("Unexpected swbreak stop reason"));
7585 /* The value part is documented as "must be empty",
7586 though we ignore it, in case we ever decide to make
7587 use of it in a backward compatible way. */
7588 p
= strchrnul (p1
+ 1, ';');
7590 else if (strprefix (p
, p1
, "hwbreak"))
7592 event
->stop_reason
= TARGET_STOPPED_BY_HW_BREAKPOINT
;
7594 /* Make sure the stub doesn't forget to indicate support
7596 if (packet_support (PACKET_hwbreak_feature
) != PACKET_ENABLE
)
7597 error (_("Unexpected hwbreak stop reason"));
7600 p
= strchrnul (p1
+ 1, ';');
7602 else if (strprefix (p
, p1
, "library"))
7604 event
->ws
.set_loaded ();
7605 p
= strchrnul (p1
+ 1, ';');
7607 else if (strprefix (p
, p1
, "replaylog"))
7609 event
->ws
.set_no_history ();
7610 /* p1 will indicate "begin" or "end", but it makes
7611 no difference for now, so ignore it. */
7612 p
= strchrnul (p1
+ 1, ';');
7614 else if (strprefix (p
, p1
, "core"))
7618 p
= unpack_varlen_hex (++p1
, &c
);
7621 else if (strprefix (p
, p1
, "fork"))
7622 event
->ws
.set_forked (read_ptid (++p1
, &p
));
7623 else if (strprefix (p
, p1
, "vfork"))
7624 event
->ws
.set_vforked (read_ptid (++p1
, &p
));
7625 else if (strprefix (p
, p1
, "vforkdone"))
7627 event
->ws
.set_vfork_done ();
7628 p
= strchrnul (p1
+ 1, ';');
7630 else if (strprefix (p
, p1
, "exec"))
7635 /* Determine the length of the execd pathname. */
7636 p
= unpack_varlen_hex (++p1
, &ignored
);
7637 pathlen
= (p
- p1
) / 2;
7639 /* Save the pathname for event reporting and for
7640 the next run command. */
7641 gdb::unique_xmalloc_ptr
<char> pathname
7642 ((char *) xmalloc (pathlen
+ 1));
7643 hex2bin (p1
, (gdb_byte
*) pathname
.get (), pathlen
);
7644 pathname
.get ()[pathlen
] = '\0';
7646 /* This is freed during event handling. */
7647 event
->ws
.set_execd (std::move (pathname
));
7649 /* Skip the registers included in this packet, since
7650 they may be for an architecture different from the
7651 one used by the original program. */
7654 else if (strprefix (p
, p1
, "create"))
7656 event
->ws
.set_thread_created ();
7657 p
= strchrnul (p1
+ 1, ';');
7666 p
= strchrnul (p1
+ 1, ';');
7671 /* Maybe a real ``P'' register number. */
7672 p_temp
= unpack_varlen_hex (p
, &pnum
);
7673 /* If the first invalid character is the colon, we got a
7674 register number. Otherwise, it's an unknown stop
7678 /* If we haven't parsed the event's thread yet, find
7679 it now, in order to find the architecture of the
7680 reported expedited registers. */
7681 if (event
->ptid
== null_ptid
)
7683 /* If there is no thread-id information then leave
7684 the event->ptid as null_ptid. Later in
7685 process_stop_reply we will pick a suitable
7687 const char *thr
= strstr (p1
+ 1, ";thread:");
7689 event
->ptid
= read_ptid (thr
+ strlen (";thread:"),
7696 = (event
->ptid
== null_ptid
7698 : find_inferior_ptid (this, event
->ptid
));
7699 /* If this is the first time we learn anything
7700 about this process, skip the registers
7701 included in this packet, since we don't yet
7702 know which architecture to use to parse them.
7703 We'll determine the architecture later when
7704 we process the stop reply and retrieve the
7705 target description, via
7706 remote_notice_new_inferior ->
7707 post_create_inferior. */
7710 p
= strchrnul (p1
+ 1, ';');
7715 event
->arch
= inf
->gdbarch
;
7716 rsa
= event
->rs
->get_remote_arch_state (event
->arch
);
7720 = packet_reg_from_pnum (event
->arch
, rsa
, pnum
);
7721 cached_reg_t cached_reg
;
7724 error (_("Remote sent bad register number %s: %s\n\
7726 hex_string (pnum
), p
, buf
);
7728 cached_reg
.num
= reg
->regnum
;
7729 cached_reg
.data
= (gdb_byte
*)
7730 xmalloc (register_size (event
->arch
, reg
->regnum
));
7733 fieldsize
= hex2bin (p
, cached_reg
.data
,
7734 register_size (event
->arch
, reg
->regnum
));
7736 if (fieldsize
< register_size (event
->arch
, reg
->regnum
))
7737 warning (_("Remote reply is too short: %s"), buf
);
7739 event
->regcache
.push_back (cached_reg
);
7743 /* Not a number. Silently skip unknown optional
7745 p
= strchrnul (p1
+ 1, ';');
7750 error (_("Remote register badly formatted: %s\nhere: %s"),
7755 if (event
->ws
.kind () != TARGET_WAITKIND_IGNORE
)
7759 case 'S': /* Old style status, just signal only. */
7763 sig
= (fromhex (buf
[1]) << 4) + fromhex (buf
[2]);
7764 if (GDB_SIGNAL_FIRST
<= sig
&& sig
< GDB_SIGNAL_LAST
)
7765 event
->ws
.set_stopped ((enum gdb_signal
) sig
);
7767 event
->ws
.set_stopped (GDB_SIGNAL_UNKNOWN
);
7770 case 'w': /* Thread exited. */
7774 p
= unpack_varlen_hex (&buf
[1], &value
);
7775 event
->ws
.set_thread_exited (value
);
7777 error (_("stop reply packet badly formatted: %s"), buf
);
7778 event
->ptid
= read_ptid (++p
, NULL
);
7781 case 'W': /* Target exited. */
7786 /* GDB used to accept only 2 hex chars here. Stubs should
7787 only send more if they detect GDB supports multi-process
7789 p
= unpack_varlen_hex (&buf
[1], &value
);
7793 /* The remote process exited. */
7794 event
->ws
.set_exited (value
);
7798 /* The remote process exited with a signal. */
7799 if (GDB_SIGNAL_FIRST
<= value
&& value
< GDB_SIGNAL_LAST
)
7800 event
->ws
.set_signalled ((enum gdb_signal
) value
);
7802 event
->ws
.set_signalled (GDB_SIGNAL_UNKNOWN
);
7805 /* If no process is specified, return null_ptid, and let the
7806 caller figure out the right process to use. */
7816 else if (startswith (p
, "process:"))
7820 p
+= sizeof ("process:") - 1;
7821 unpack_varlen_hex (p
, &upid
);
7825 error (_("unknown stop reply packet: %s"), buf
);
7828 error (_("unknown stop reply packet: %s"), buf
);
7829 event
->ptid
= ptid_t (pid
);
7833 event
->ws
.set_no_resumed ();
7834 event
->ptid
= minus_one_ptid
;
7839 /* When the stub wants to tell GDB about a new notification reply, it
7840 sends a notification (%Stop, for example). Those can come it at
7841 any time, hence, we have to make sure that any pending
7842 putpkt/getpkt sequence we're making is finished, before querying
7843 the stub for more events with the corresponding ack command
7844 (vStopped, for example). E.g., if we started a vStopped sequence
7845 immediately upon receiving the notification, something like this
7853 1.6) <-- (registers reply to step #1.3)
7855 Obviously, the reply in step #1.6 would be unexpected to a vStopped
7858 To solve this, whenever we parse a %Stop notification successfully,
7859 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
7860 doing whatever we were doing:
7866 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
7867 2.5) <-- (registers reply to step #2.3)
7869 Eventually after step #2.5, we return to the event loop, which
7870 notices there's an event on the
7871 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
7872 associated callback --- the function below. At this point, we're
7873 always safe to start a vStopped sequence. :
7876 2.7) <-- T05 thread:2
7882 remote_target::remote_notif_get_pending_events (notif_client
*nc
)
7884 struct remote_state
*rs
= get_remote_state ();
7886 if (rs
->notif_state
->pending_event
[nc
->id
] != NULL
)
7889 gdb_printf (gdb_stdlog
,
7890 "notif: process: '%s' ack pending event\n",
7894 nc
->ack (this, nc
, rs
->buf
.data (),
7895 rs
->notif_state
->pending_event
[nc
->id
]);
7896 rs
->notif_state
->pending_event
[nc
->id
] = NULL
;
7900 getpkt (&rs
->buf
, 0);
7901 if (strcmp (rs
->buf
.data (), "OK") == 0)
7904 remote_notif_ack (this, nc
, rs
->buf
.data ());
7910 gdb_printf (gdb_stdlog
,
7911 "notif: process: '%s' no pending reply\n",
7916 /* Wrapper around remote_target::remote_notif_get_pending_events to
7917 avoid having to export the whole remote_target class. */
7920 remote_notif_get_pending_events (remote_target
*remote
, notif_client
*nc
)
7922 remote
->remote_notif_get_pending_events (nc
);
7925 /* Called from process_stop_reply when the stop packet we are responding
7926 to didn't include a process-id or thread-id. STATUS is the stop event
7927 we are responding to.
7929 It is the task of this function to select a suitable thread (or process)
7930 and return its ptid, this is the thread (or process) we will assume the
7931 stop event came from.
7933 In some cases there isn't really any choice about which thread (or
7934 process) is selected, a basic remote with a single process containing a
7935 single thread might choose not to send any process-id or thread-id in
7936 its stop packets, this function will select and return the one and only
7939 However, if a target supports multiple threads (or processes) and still
7940 doesn't include a thread-id (or process-id) in its stop packet then
7941 first, this is a badly behaving target, and second, we're going to have
7942 to select a thread (or process) at random and use that. This function
7943 will print a warning to the user if it detects that there is the
7944 possibility that GDB is guessing which thread (or process) to
7947 Note that this is called before GDB fetches the updated thread list from the
7948 target. So it's possible for the stop reply to be ambiguous and for GDB to
7949 not realize it. For example, if there's initially one thread, the target
7950 spawns a second thread, and then sends a stop reply without an id that
7951 concerns the first thread. GDB will assume the stop reply is about the
7952 first thread - the only thread it knows about - without printing a warning.
7953 Anyway, if the remote meant for the stop reply to be about the second thread,
7954 then it would be really broken, because GDB doesn't know about that thread
7958 remote_target::select_thread_for_ambiguous_stop_reply
7959 (const target_waitstatus
&status
)
7961 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7963 /* Some stop events apply to all threads in an inferior, while others
7964 only apply to a single thread. */
7965 bool process_wide_stop
7966 = (status
.kind () == TARGET_WAITKIND_EXITED
7967 || status
.kind () == TARGET_WAITKIND_SIGNALLED
);
7969 remote_debug_printf ("process_wide_stop = %d", process_wide_stop
);
7971 thread_info
*first_resumed_thread
= nullptr;
7972 bool ambiguous
= false;
7974 /* Consider all non-exited threads of the target, find the first resumed
7976 for (thread_info
*thr
: all_non_exited_threads (this))
7978 remote_thread_info
*remote_thr
= get_remote_thread_info (thr
);
7980 if (remote_thr
->get_resume_state () != resume_state::RESUMED
)
7983 if (first_resumed_thread
== nullptr)
7984 first_resumed_thread
= thr
;
7985 else if (!process_wide_stop
7986 || first_resumed_thread
->ptid
.pid () != thr
->ptid
.pid ())
7990 gdb_assert (first_resumed_thread
!= nullptr);
7992 remote_debug_printf ("first resumed thread is %s",
7993 pid_to_str (first_resumed_thread
->ptid
).c_str ());
7994 remote_debug_printf ("is this guess ambiguous? = %d", ambiguous
);
7996 /* Warn if the remote target is sending ambiguous stop replies. */
7999 static bool warned
= false;
8003 /* If you are seeing this warning then the remote target has
8004 stopped without specifying a thread-id, but the target
8005 does have multiple threads (or inferiors), and so GDB is
8006 having to guess which thread stopped.
8008 Examples of what might cause this are the target sending
8009 and 'S' stop packet, or a 'T' stop packet and not
8010 including a thread-id.
8012 Additionally, the target might send a 'W' or 'X packet
8013 without including a process-id, when the target has
8014 multiple running inferiors. */
8015 if (process_wide_stop
)
8016 warning (_("multi-inferior target stopped without "
8017 "sending a process-id, using first "
8018 "non-exited inferior"));
8020 warning (_("multi-threaded target stopped without "
8021 "sending a thread-id, using first "
8022 "non-exited thread"));
8027 /* If this is a stop for all threads then don't use a particular threads
8028 ptid, instead create a new ptid where only the pid field is set. */
8029 if (process_wide_stop
)
8030 return ptid_t (first_resumed_thread
->ptid
.pid ());
8032 return first_resumed_thread
->ptid
;
8035 /* Called when it is decided that STOP_REPLY holds the info of the
8036 event that is to be returned to the core. This function always
8037 destroys STOP_REPLY. */
8040 remote_target::process_stop_reply (struct stop_reply
*stop_reply
,
8041 struct target_waitstatus
*status
)
8043 *status
= stop_reply
->ws
;
8044 ptid_t ptid
= stop_reply
->ptid
;
8046 /* If no thread/process was reported by the stub then select a suitable
8048 if (ptid
== null_ptid
)
8049 ptid
= select_thread_for_ambiguous_stop_reply (*status
);
8050 gdb_assert (ptid
!= null_ptid
);
8052 if (status
->kind () != TARGET_WAITKIND_EXITED
8053 && status
->kind () != TARGET_WAITKIND_SIGNALLED
8054 && status
->kind () != TARGET_WAITKIND_NO_RESUMED
)
8056 /* Expedited registers. */
8057 if (!stop_reply
->regcache
.empty ())
8059 struct regcache
*regcache
8060 = get_thread_arch_regcache (this, ptid
, stop_reply
->arch
);
8062 for (cached_reg_t
®
: stop_reply
->regcache
)
8064 regcache
->raw_supply (reg
.num
, reg
.data
);
8068 stop_reply
->regcache
.clear ();
8071 remote_notice_new_inferior (ptid
, false);
8072 remote_thread_info
*remote_thr
= get_remote_thread_info (this, ptid
);
8073 remote_thr
->core
= stop_reply
->core
;
8074 remote_thr
->stop_reason
= stop_reply
->stop_reason
;
8075 remote_thr
->watch_data_address
= stop_reply
->watch_data_address
;
8077 if (target_is_non_stop_p ())
8079 /* If the target works in non-stop mode, a stop-reply indicates that
8080 only this thread stopped. */
8081 remote_thr
->set_not_resumed ();
8085 /* If the target works in all-stop mode, a stop-reply indicates that
8086 all the target's threads stopped. */
8087 for (thread_info
*tp
: all_non_exited_threads (this))
8088 get_remote_thread_info (tp
)->set_not_resumed ();
8096 /* The non-stop mode version of target_wait. */
8099 remote_target::wait_ns (ptid_t ptid
, struct target_waitstatus
*status
,
8100 target_wait_flags options
)
8102 struct remote_state
*rs
= get_remote_state ();
8103 struct stop_reply
*stop_reply
;
8107 /* If in non-stop mode, get out of getpkt even if a
8108 notification is received. */
8110 ret
= getpkt_or_notif_sane (&rs
->buf
, 0 /* forever */, &is_notif
);
8113 if (ret
!= -1 && !is_notif
)
8116 case 'E': /* Error of some sort. */
8117 /* We're out of sync with the target now. Did it continue
8118 or not? We can't tell which thread it was in non-stop,
8119 so just ignore this. */
8120 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
8122 case 'O': /* Console output. */
8123 remote_console_output (&rs
->buf
[1]);
8126 warning (_("Invalid remote reply: %s"), rs
->buf
.data ());
8130 /* Acknowledge a pending stop reply that may have arrived in the
8132 if (rs
->notif_state
->pending_event
[notif_client_stop
.id
] != NULL
)
8133 remote_notif_get_pending_events (¬if_client_stop
);
8135 /* If indeed we noticed a stop reply, we're done. */
8136 stop_reply
= queued_stop_reply (ptid
);
8137 if (stop_reply
!= NULL
)
8138 return process_stop_reply (stop_reply
, status
);
8140 /* Still no event. If we're just polling for an event, then
8141 return to the event loop. */
8142 if (options
& TARGET_WNOHANG
)
8144 status
->set_ignore ();
8145 return minus_one_ptid
;
8148 /* Otherwise do a blocking wait. */
8149 ret
= getpkt_or_notif_sane (&rs
->buf
, 1 /* forever */, &is_notif
);
8153 /* Return the first resumed thread. */
8156 first_remote_resumed_thread (remote_target
*target
)
8158 for (thread_info
*tp
: all_non_exited_threads (target
, minus_one_ptid
))
8164 /* Wait until the remote machine stops, then return, storing status in
8165 STATUS just as `wait' would. */
8168 remote_target::wait_as (ptid_t ptid
, target_waitstatus
*status
,
8169 target_wait_flags options
)
8171 struct remote_state
*rs
= get_remote_state ();
8172 ptid_t event_ptid
= null_ptid
;
8174 struct stop_reply
*stop_reply
;
8178 status
->set_ignore ();
8180 stop_reply
= queued_stop_reply (ptid
);
8181 if (stop_reply
!= NULL
)
8183 /* None of the paths that push a stop reply onto the queue should
8184 have set the waiting_for_stop_reply flag. */
8185 gdb_assert (!rs
->waiting_for_stop_reply
);
8186 event_ptid
= process_stop_reply (stop_reply
, status
);
8190 int forever
= ((options
& TARGET_WNOHANG
) == 0
8191 && rs
->wait_forever_enabled_p
);
8193 if (!rs
->waiting_for_stop_reply
)
8195 status
->set_no_resumed ();
8196 return minus_one_ptid
;
8199 /* FIXME: cagney/1999-09-27: If we're in async mode we should
8200 _never_ wait for ever -> test on target_is_async_p().
8201 However, before we do that we need to ensure that the caller
8202 knows how to take the target into/out of async mode. */
8204 int ret
= getpkt_or_notif_sane (&rs
->buf
, forever
, &is_notif
);
8206 /* GDB gets a notification. Return to core as this event is
8208 if (ret
!= -1 && is_notif
)
8209 return minus_one_ptid
;
8211 if (ret
== -1 && (options
& TARGET_WNOHANG
) != 0)
8212 return minus_one_ptid
;
8214 buf
= rs
->buf
.data ();
8216 /* Assume that the target has acknowledged Ctrl-C unless we receive
8217 an 'F' or 'O' packet. */
8218 if (buf
[0] != 'F' && buf
[0] != 'O')
8219 rs
->ctrlc_pending_p
= 0;
8223 case 'E': /* Error of some sort. */
8224 /* We're out of sync with the target now. Did it continue or
8225 not? Not is more likely, so report a stop. */
8226 rs
->waiting_for_stop_reply
= 0;
8228 warning (_("Remote failure reply: %s"), buf
);
8229 status
->set_stopped (GDB_SIGNAL_0
);
8231 case 'F': /* File-I/O request. */
8232 /* GDB may access the inferior memory while handling the File-I/O
8233 request, but we don't want GDB accessing memory while waiting
8234 for a stop reply. See the comments in putpkt_binary. Set
8235 waiting_for_stop_reply to 0 temporarily. */
8236 rs
->waiting_for_stop_reply
= 0;
8237 remote_fileio_request (this, buf
, rs
->ctrlc_pending_p
);
8238 rs
->ctrlc_pending_p
= 0;
8239 /* GDB handled the File-I/O request, and the target is running
8240 again. Keep waiting for events. */
8241 rs
->waiting_for_stop_reply
= 1;
8243 case 'N': case 'T': case 'S': case 'X': case 'W':
8245 /* There is a stop reply to handle. */
8246 rs
->waiting_for_stop_reply
= 0;
8249 = (struct stop_reply
*) remote_notif_parse (this,
8253 event_ptid
= process_stop_reply (stop_reply
, status
);
8256 case 'O': /* Console output. */
8257 remote_console_output (buf
+ 1);
8260 if (rs
->last_sent_signal
!= GDB_SIGNAL_0
)
8262 /* Zero length reply means that we tried 'S' or 'C' and the
8263 remote system doesn't support it. */
8264 target_terminal::ours_for_output ();
8266 ("Can't send signals to this remote system. %s not sent.\n",
8267 gdb_signal_to_name (rs
->last_sent_signal
));
8268 rs
->last_sent_signal
= GDB_SIGNAL_0
;
8269 target_terminal::inferior ();
8271 strcpy (buf
, rs
->last_sent_step
? "s" : "c");
8277 warning (_("Invalid remote reply: %s"), buf
);
8282 if (status
->kind () == TARGET_WAITKIND_NO_RESUMED
)
8283 return minus_one_ptid
;
8284 else if (status
->kind () == TARGET_WAITKIND_IGNORE
)
8286 /* Nothing interesting happened. If we're doing a non-blocking
8287 poll, we're done. Otherwise, go back to waiting. */
8288 if (options
& TARGET_WNOHANG
)
8289 return minus_one_ptid
;
8293 else if (status
->kind () != TARGET_WAITKIND_EXITED
8294 && status
->kind () != TARGET_WAITKIND_SIGNALLED
)
8296 if (event_ptid
!= null_ptid
)
8297 record_currthread (rs
, event_ptid
);
8299 event_ptid
= first_remote_resumed_thread (this);
8303 /* A process exit. Invalidate our notion of current thread. */
8304 record_currthread (rs
, minus_one_ptid
);
8305 /* It's possible that the packet did not include a pid. */
8306 if (event_ptid
== null_ptid
)
8307 event_ptid
= first_remote_resumed_thread (this);
8308 /* EVENT_PTID could still be NULL_PTID. Double-check. */
8309 if (event_ptid
== null_ptid
)
8310 event_ptid
= magic_null_ptid
;
8316 /* Wait until the remote machine stops, then return, storing status in
8317 STATUS just as `wait' would. */
8320 remote_target::wait (ptid_t ptid
, struct target_waitstatus
*status
,
8321 target_wait_flags options
)
8323 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
8325 remote_state
*rs
= get_remote_state ();
8327 /* Start by clearing the flag that asks for our wait method to be called,
8328 we'll mark it again at the end if needed. If the target is not in
8329 async mode then the async token should not be marked. */
8330 if (target_is_async_p ())
8331 clear_async_event_handler (rs
->remote_async_inferior_event_token
);
8333 gdb_assert (!async_event_handler_marked
8334 (rs
->remote_async_inferior_event_token
));
8338 if (target_is_non_stop_p ())
8339 event_ptid
= wait_ns (ptid
, status
, options
);
8341 event_ptid
= wait_as (ptid
, status
, options
);
8343 if (target_is_async_p ())
8345 /* If there are events left in the queue, or unacknowledged
8346 notifications, then tell the event loop to call us again. */
8347 if (!rs
->stop_reply_queue
.empty ()
8348 || rs
->notif_state
->pending_event
[notif_client_stop
.id
] != nullptr)
8349 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
8355 /* Fetch a single register using a 'p' packet. */
8358 remote_target::fetch_register_using_p (struct regcache
*regcache
,
8361 struct gdbarch
*gdbarch
= regcache
->arch ();
8362 struct remote_state
*rs
= get_remote_state ();
8364 gdb_byte
*regp
= (gdb_byte
*) alloca (register_size (gdbarch
, reg
->regnum
));
8367 if (packet_support (PACKET_p
) == PACKET_DISABLE
)
8370 if (reg
->pnum
== -1)
8373 p
= rs
->buf
.data ();
8375 p
+= hexnumstr (p
, reg
->pnum
);
8378 getpkt (&rs
->buf
, 0);
8380 buf
= rs
->buf
.data ();
8382 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_p
]))
8386 case PACKET_UNKNOWN
:
8389 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
8390 gdbarch_register_name (regcache
->arch (),
8395 /* If this register is unfetchable, tell the regcache. */
8398 regcache
->raw_supply (reg
->regnum
, NULL
);
8402 /* Otherwise, parse and supply the value. */
8408 error (_("fetch_register_using_p: early buf termination"));
8410 regp
[i
++] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
8413 regcache
->raw_supply (reg
->regnum
, regp
);
8417 /* Fetch the registers included in the target's 'g' packet. */
8420 remote_target::send_g_packet ()
8422 struct remote_state
*rs
= get_remote_state ();
8425 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "g");
8427 getpkt (&rs
->buf
, 0);
8428 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
8429 error (_("Could not read registers; remote failure reply '%s'"),
8432 /* We can get out of synch in various cases. If the first character
8433 in the buffer is not a hex character, assume that has happened
8434 and try to fetch another packet to read. */
8435 while ((rs
->buf
[0] < '0' || rs
->buf
[0] > '9')
8436 && (rs
->buf
[0] < 'A' || rs
->buf
[0] > 'F')
8437 && (rs
->buf
[0] < 'a' || rs
->buf
[0] > 'f')
8438 && rs
->buf
[0] != 'x') /* New: unavailable register value. */
8440 remote_debug_printf ("Bad register packet; fetching a new packet");
8441 getpkt (&rs
->buf
, 0);
8444 buf_len
= strlen (rs
->buf
.data ());
8446 /* Sanity check the received packet. */
8447 if (buf_len
% 2 != 0)
8448 error (_("Remote 'g' packet reply is of odd length: %s"), rs
->buf
.data ());
8454 remote_target::process_g_packet (struct regcache
*regcache
)
8456 struct gdbarch
*gdbarch
= regcache
->arch ();
8457 struct remote_state
*rs
= get_remote_state ();
8458 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8463 buf_len
= strlen (rs
->buf
.data ());
8465 /* Further sanity checks, with knowledge of the architecture. */
8466 if (buf_len
> 2 * rsa
->sizeof_g_packet
)
8467 error (_("Remote 'g' packet reply is too long (expected %ld bytes, got %d "
8469 rsa
->sizeof_g_packet
, buf_len
/ 2,
8472 /* Save the size of the packet sent to us by the target. It is used
8473 as a heuristic when determining the max size of packets that the
8474 target can safely receive. */
8475 if (rsa
->actual_register_packet_size
== 0)
8476 rsa
->actual_register_packet_size
= buf_len
;
8478 /* If this is smaller than we guessed the 'g' packet would be,
8479 update our records. A 'g' reply that doesn't include a register's
8480 value implies either that the register is not available, or that
8481 the 'p' packet must be used. */
8482 if (buf_len
< 2 * rsa
->sizeof_g_packet
)
8484 long sizeof_g_packet
= buf_len
/ 2;
8486 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8488 long offset
= rsa
->regs
[i
].offset
;
8489 long reg_size
= register_size (gdbarch
, i
);
8491 if (rsa
->regs
[i
].pnum
== -1)
8494 if (offset
>= sizeof_g_packet
)
8495 rsa
->regs
[i
].in_g_packet
= 0;
8496 else if (offset
+ reg_size
> sizeof_g_packet
)
8497 error (_("Truncated register %d in remote 'g' packet"), i
);
8499 rsa
->regs
[i
].in_g_packet
= 1;
8502 /* Looks valid enough, we can assume this is the correct length
8503 for a 'g' packet. It's important not to adjust
8504 rsa->sizeof_g_packet if we have truncated registers otherwise
8505 this "if" won't be run the next time the method is called
8506 with a packet of the same size and one of the internal errors
8507 below will trigger instead. */
8508 rsa
->sizeof_g_packet
= sizeof_g_packet
;
8511 regs
= (char *) alloca (rsa
->sizeof_g_packet
);
8513 /* Unimplemented registers read as all bits zero. */
8514 memset (regs
, 0, rsa
->sizeof_g_packet
);
8516 /* Reply describes registers byte by byte, each byte encoded as two
8517 hex characters. Suck them all up, then supply them to the
8518 register cacheing/storage mechanism. */
8520 p
= rs
->buf
.data ();
8521 for (i
= 0; i
< rsa
->sizeof_g_packet
; i
++)
8523 if (p
[0] == 0 || p
[1] == 0)
8524 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
8525 internal_error (__FILE__
, __LINE__
,
8526 _("unexpected end of 'g' packet reply"));
8528 if (p
[0] == 'x' && p
[1] == 'x')
8529 regs
[i
] = 0; /* 'x' */
8531 regs
[i
] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
8535 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8537 struct packet_reg
*r
= &rsa
->regs
[i
];
8538 long reg_size
= register_size (gdbarch
, i
);
8542 if ((r
->offset
+ reg_size
) * 2 > strlen (rs
->buf
.data ()))
8543 /* This shouldn't happen - we adjusted in_g_packet above. */
8544 internal_error (__FILE__
, __LINE__
,
8545 _("unexpected end of 'g' packet reply"));
8546 else if (rs
->buf
[r
->offset
* 2] == 'x')
8548 gdb_assert (r
->offset
* 2 < strlen (rs
->buf
.data ()));
8549 /* The register isn't available, mark it as such (at
8550 the same time setting the value to zero). */
8551 regcache
->raw_supply (r
->regnum
, NULL
);
8554 regcache
->raw_supply (r
->regnum
, regs
+ r
->offset
);
8560 remote_target::fetch_registers_using_g (struct regcache
*regcache
)
8563 process_g_packet (regcache
);
8566 /* Make the remote selected traceframe match GDB's selected
8570 remote_target::set_remote_traceframe ()
8573 struct remote_state
*rs
= get_remote_state ();
8575 if (rs
->remote_traceframe_number
== get_traceframe_number ())
8578 /* Avoid recursion, remote_trace_find calls us again. */
8579 rs
->remote_traceframe_number
= get_traceframe_number ();
8581 newnum
= target_trace_find (tfind_number
,
8582 get_traceframe_number (), 0, 0, NULL
);
8584 /* Should not happen. If it does, all bets are off. */
8585 if (newnum
!= get_traceframe_number ())
8586 warning (_("could not set remote traceframe"));
8590 remote_target::fetch_registers (struct regcache
*regcache
, int regnum
)
8592 struct gdbarch
*gdbarch
= regcache
->arch ();
8593 struct remote_state
*rs
= get_remote_state ();
8594 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8597 set_remote_traceframe ();
8598 set_general_thread (regcache
->ptid ());
8602 packet_reg
*reg
= packet_reg_from_regnum (gdbarch
, rsa
, regnum
);
8604 gdb_assert (reg
!= NULL
);
8606 /* If this register might be in the 'g' packet, try that first -
8607 we are likely to read more than one register. If this is the
8608 first 'g' packet, we might be overly optimistic about its
8609 contents, so fall back to 'p'. */
8610 if (reg
->in_g_packet
)
8612 fetch_registers_using_g (regcache
);
8613 if (reg
->in_g_packet
)
8617 if (fetch_register_using_p (regcache
, reg
))
8620 /* This register is not available. */
8621 regcache
->raw_supply (reg
->regnum
, NULL
);
8626 fetch_registers_using_g (regcache
);
8628 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8629 if (!rsa
->regs
[i
].in_g_packet
)
8630 if (!fetch_register_using_p (regcache
, &rsa
->regs
[i
]))
8632 /* This register is not available. */
8633 regcache
->raw_supply (i
, NULL
);
8637 /* Prepare to store registers. Since we may send them all (using a
8638 'G' request), we have to read out the ones we don't want to change
8642 remote_target::prepare_to_store (struct regcache
*regcache
)
8644 struct remote_state
*rs
= get_remote_state ();
8645 remote_arch_state
*rsa
= rs
->get_remote_arch_state (regcache
->arch ());
8648 /* Make sure the entire registers array is valid. */
8649 switch (packet_support (PACKET_P
))
8651 case PACKET_DISABLE
:
8652 case PACKET_SUPPORT_UNKNOWN
:
8653 /* Make sure all the necessary registers are cached. */
8654 for (i
= 0; i
< gdbarch_num_regs (regcache
->arch ()); i
++)
8655 if (rsa
->regs
[i
].in_g_packet
)
8656 regcache
->raw_update (rsa
->regs
[i
].regnum
);
8663 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
8664 packet was not recognized. */
8667 remote_target::store_register_using_P (const struct regcache
*regcache
,
8670 struct gdbarch
*gdbarch
= regcache
->arch ();
8671 struct remote_state
*rs
= get_remote_state ();
8672 /* Try storing a single register. */
8673 char *buf
= rs
->buf
.data ();
8674 gdb_byte
*regp
= (gdb_byte
*) alloca (register_size (gdbarch
, reg
->regnum
));
8677 if (packet_support (PACKET_P
) == PACKET_DISABLE
)
8680 if (reg
->pnum
== -1)
8683 xsnprintf (buf
, get_remote_packet_size (), "P%s=", phex_nz (reg
->pnum
, 0));
8684 p
= buf
+ strlen (buf
);
8685 regcache
->raw_collect (reg
->regnum
, regp
);
8686 bin2hex (regp
, p
, register_size (gdbarch
, reg
->regnum
));
8688 getpkt (&rs
->buf
, 0);
8690 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_P
]))
8695 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
8696 gdbarch_register_name (gdbarch
, reg
->regnum
), rs
->buf
.data ());
8697 case PACKET_UNKNOWN
:
8700 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
8704 /* Store register REGNUM, or all registers if REGNUM == -1, from the
8705 contents of the register cache buffer. FIXME: ignores errors. */
8708 remote_target::store_registers_using_G (const struct regcache
*regcache
)
8710 struct remote_state
*rs
= get_remote_state ();
8711 remote_arch_state
*rsa
= rs
->get_remote_arch_state (regcache
->arch ());
8715 /* Extract all the registers in the regcache copying them into a
8720 regs
= (gdb_byte
*) alloca (rsa
->sizeof_g_packet
);
8721 memset (regs
, 0, rsa
->sizeof_g_packet
);
8722 for (i
= 0; i
< gdbarch_num_regs (regcache
->arch ()); i
++)
8724 struct packet_reg
*r
= &rsa
->regs
[i
];
8727 regcache
->raw_collect (r
->regnum
, regs
+ r
->offset
);
8731 /* Command describes registers byte by byte,
8732 each byte encoded as two hex characters. */
8733 p
= rs
->buf
.data ();
8735 bin2hex (regs
, p
, rsa
->sizeof_g_packet
);
8737 getpkt (&rs
->buf
, 0);
8738 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
8739 error (_("Could not write registers; remote failure reply '%s'"),
8743 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
8744 of the register cache buffer. FIXME: ignores errors. */
8747 remote_target::store_registers (struct regcache
*regcache
, int regnum
)
8749 struct gdbarch
*gdbarch
= regcache
->arch ();
8750 struct remote_state
*rs
= get_remote_state ();
8751 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8754 set_remote_traceframe ();
8755 set_general_thread (regcache
->ptid ());
8759 packet_reg
*reg
= packet_reg_from_regnum (gdbarch
, rsa
, regnum
);
8761 gdb_assert (reg
!= NULL
);
8763 /* Always prefer to store registers using the 'P' packet if
8764 possible; we often change only a small number of registers.
8765 Sometimes we change a larger number; we'd need help from a
8766 higher layer to know to use 'G'. */
8767 if (store_register_using_P (regcache
, reg
))
8770 /* For now, don't complain if we have no way to write the
8771 register. GDB loses track of unavailable registers too
8772 easily. Some day, this may be an error. We don't have
8773 any way to read the register, either... */
8774 if (!reg
->in_g_packet
)
8777 store_registers_using_G (regcache
);
8781 store_registers_using_G (regcache
);
8783 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8784 if (!rsa
->regs
[i
].in_g_packet
)
8785 if (!store_register_using_P (regcache
, &rsa
->regs
[i
]))
8786 /* See above for why we do not issue an error here. */
8791 /* Return the number of hex digits in num. */
8794 hexnumlen (ULONGEST num
)
8798 for (i
= 0; num
!= 0; i
++)
8801 return std::max (i
, 1);
8804 /* Set BUF to the minimum number of hex digits representing NUM. */
8807 hexnumstr (char *buf
, ULONGEST num
)
8809 int len
= hexnumlen (num
);
8811 return hexnumnstr (buf
, num
, len
);
8815 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
8818 hexnumnstr (char *buf
, ULONGEST num
, int width
)
8824 for (i
= width
- 1; i
>= 0; i
--)
8826 buf
[i
] = "0123456789abcdef"[(num
& 0xf)];
8833 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
8836 remote_address_masked (CORE_ADDR addr
)
8838 unsigned int address_size
= remote_address_size
;
8840 /* If "remoteaddresssize" was not set, default to target address size. */
8842 address_size
= gdbarch_addr_bit (target_gdbarch ());
8844 if (address_size
> 0
8845 && address_size
< (sizeof (ULONGEST
) * 8))
8847 /* Only create a mask when that mask can safely be constructed
8848 in a ULONGEST variable. */
8851 mask
= (mask
<< address_size
) - 1;
8857 /* Determine whether the remote target supports binary downloading.
8858 This is accomplished by sending a no-op memory write of zero length
8859 to the target at the specified address. It does not suffice to send
8860 the whole packet, since many stubs strip the eighth bit and
8861 subsequently compute a wrong checksum, which causes real havoc with
8864 NOTE: This can still lose if the serial line is not eight-bit
8865 clean. In cases like this, the user should clear "remote
8869 remote_target::check_binary_download (CORE_ADDR addr
)
8871 struct remote_state
*rs
= get_remote_state ();
8873 switch (packet_support (PACKET_X
))
8875 case PACKET_DISABLE
:
8879 case PACKET_SUPPORT_UNKNOWN
:
8883 p
= rs
->buf
.data ();
8885 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8887 p
+= hexnumstr (p
, (ULONGEST
) 0);
8891 putpkt_binary (rs
->buf
.data (), (int) (p
- rs
->buf
.data ()));
8892 getpkt (&rs
->buf
, 0);
8894 if (rs
->buf
[0] == '\0')
8896 remote_debug_printf ("binary downloading NOT supported by target");
8897 remote_protocol_packets
[PACKET_X
].support
= PACKET_DISABLE
;
8901 remote_debug_printf ("binary downloading supported by target");
8902 remote_protocol_packets
[PACKET_X
].support
= PACKET_ENABLE
;
8909 /* Helper function to resize the payload in order to try to get a good
8910 alignment. We try to write an amount of data such that the next write will
8911 start on an address aligned on REMOTE_ALIGN_WRITES. */
8914 align_for_efficient_write (int todo
, CORE_ADDR memaddr
)
8916 return ((memaddr
+ todo
) & ~(REMOTE_ALIGN_WRITES
- 1)) - memaddr
;
8919 /* Write memory data directly to the remote machine.
8920 This does not inform the data cache; the data cache uses this.
8921 HEADER is the starting part of the packet.
8922 MEMADDR is the address in the remote memory space.
8923 MYADDR is the address of the buffer in our space.
8924 LEN_UNITS is the number of addressable units to write.
8925 UNIT_SIZE is the length in bytes of an addressable unit.
8926 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
8927 should send data as binary ('X'), or hex-encoded ('M').
8929 The function creates packet of the form
8930 <HEADER><ADDRESS>,<LENGTH>:<DATA>
8932 where encoding of <DATA> is terminated by PACKET_FORMAT.
8934 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
8937 Return the transferred status, error or OK (an
8938 'enum target_xfer_status' value). Save the number of addressable units
8939 transferred in *XFERED_LEN_UNITS. Only transfer a single packet.
8941 On a platform with an addressable memory size of 2 bytes (UNIT_SIZE == 2), an
8942 exchange between gdb and the stub could look like (?? in place of the
8948 -> $M1000,3:eeeeffffeeee#??
8952 <- eeeeffffeeeedddd */
8955 remote_target::remote_write_bytes_aux (const char *header
, CORE_ADDR memaddr
,
8956 const gdb_byte
*myaddr
,
8959 ULONGEST
*xfered_len_units
,
8960 char packet_format
, int use_length
)
8962 struct remote_state
*rs
= get_remote_state ();
8968 int payload_capacity_bytes
;
8969 int payload_length_bytes
;
8971 if (packet_format
!= 'X' && packet_format
!= 'M')
8972 internal_error (__FILE__
, __LINE__
,
8973 _("remote_write_bytes_aux: bad packet format"));
8976 return TARGET_XFER_EOF
;
8978 payload_capacity_bytes
= get_memory_write_packet_size ();
8980 /* The packet buffer will be large enough for the payload;
8981 get_memory_packet_size ensures this. */
8984 /* Compute the size of the actual payload by subtracting out the
8985 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
8987 payload_capacity_bytes
-= strlen ("$,:#NN");
8989 /* The comma won't be used. */
8990 payload_capacity_bytes
+= 1;
8991 payload_capacity_bytes
-= strlen (header
);
8992 payload_capacity_bytes
-= hexnumlen (memaddr
);
8994 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
8996 strcat (rs
->buf
.data (), header
);
8997 p
= rs
->buf
.data () + strlen (header
);
8999 /* Compute a best guess of the number of bytes actually transfered. */
9000 if (packet_format
== 'X')
9002 /* Best guess at number of bytes that will fit. */
9003 todo_units
= std::min (len_units
,
9004 (ULONGEST
) payload_capacity_bytes
/ unit_size
);
9006 payload_capacity_bytes
-= hexnumlen (todo_units
);
9007 todo_units
= std::min (todo_units
, payload_capacity_bytes
/ unit_size
);
9011 /* Number of bytes that will fit. */
9013 = std::min (len_units
,
9014 (ULONGEST
) (payload_capacity_bytes
/ unit_size
) / 2);
9016 payload_capacity_bytes
-= hexnumlen (todo_units
);
9017 todo_units
= std::min (todo_units
,
9018 (payload_capacity_bytes
/ unit_size
) / 2);
9021 if (todo_units
<= 0)
9022 internal_error (__FILE__
, __LINE__
,
9023 _("minimum packet size too small to write data"));
9025 /* If we already need another packet, then try to align the end
9026 of this packet to a useful boundary. */
9027 if (todo_units
> 2 * REMOTE_ALIGN_WRITES
&& todo_units
< len_units
)
9028 todo_units
= align_for_efficient_write (todo_units
, memaddr
);
9030 /* Append "<memaddr>". */
9031 memaddr
= remote_address_masked (memaddr
);
9032 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
9039 /* Append the length and retain its location and size. It may need to be
9040 adjusted once the packet body has been created. */
9042 plenlen
= hexnumstr (p
, (ULONGEST
) todo_units
);
9050 /* Append the packet body. */
9051 if (packet_format
== 'X')
9053 /* Binary mode. Send target system values byte by byte, in
9054 increasing byte addresses. Only escape certain critical
9056 payload_length_bytes
=
9057 remote_escape_output (myaddr
, todo_units
, unit_size
, (gdb_byte
*) p
,
9058 &units_written
, payload_capacity_bytes
);
9060 /* If not all TODO units fit, then we'll need another packet. Make
9061 a second try to keep the end of the packet aligned. Don't do
9062 this if the packet is tiny. */
9063 if (units_written
< todo_units
&& units_written
> 2 * REMOTE_ALIGN_WRITES
)
9067 new_todo_units
= align_for_efficient_write (units_written
, memaddr
);
9069 if (new_todo_units
!= units_written
)
9070 payload_length_bytes
=
9071 remote_escape_output (myaddr
, new_todo_units
, unit_size
,
9072 (gdb_byte
*) p
, &units_written
,
9073 payload_capacity_bytes
);
9076 p
+= payload_length_bytes
;
9077 if (use_length
&& units_written
< todo_units
)
9079 /* Escape chars have filled up the buffer prematurely,
9080 and we have actually sent fewer units than planned.
9081 Fix-up the length field of the packet. Use the same
9082 number of characters as before. */
9083 plen
+= hexnumnstr (plen
, (ULONGEST
) units_written
,
9085 *plen
= ':'; /* overwrite \0 from hexnumnstr() */
9090 /* Normal mode: Send target system values byte by byte, in
9091 increasing byte addresses. Each byte is encoded as a two hex
9093 p
+= 2 * bin2hex (myaddr
, p
, todo_units
* unit_size
);
9094 units_written
= todo_units
;
9097 putpkt_binary (rs
->buf
.data (), (int) (p
- rs
->buf
.data ()));
9098 getpkt (&rs
->buf
, 0);
9100 if (rs
->buf
[0] == 'E')
9101 return TARGET_XFER_E_IO
;
9103 /* Return UNITS_WRITTEN, not TODO_UNITS, in case escape chars caused us to
9104 send fewer units than we'd planned. */
9105 *xfered_len_units
= (ULONGEST
) units_written
;
9106 return (*xfered_len_units
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
9109 /* Write memory data directly to the remote machine.
9110 This does not inform the data cache; the data cache uses this.
9111 MEMADDR is the address in the remote memory space.
9112 MYADDR is the address of the buffer in our space.
9113 LEN is the number of bytes.
9115 Return the transferred status, error or OK (an
9116 'enum target_xfer_status' value). Save the number of bytes
9117 transferred in *XFERED_LEN. Only transfer a single packet. */
9120 remote_target::remote_write_bytes (CORE_ADDR memaddr
, const gdb_byte
*myaddr
,
9121 ULONGEST len
, int unit_size
,
9122 ULONGEST
*xfered_len
)
9124 const char *packet_format
= NULL
;
9126 /* Check whether the target supports binary download. */
9127 check_binary_download (memaddr
);
9129 switch (packet_support (PACKET_X
))
9132 packet_format
= "X";
9134 case PACKET_DISABLE
:
9135 packet_format
= "M";
9137 case PACKET_SUPPORT_UNKNOWN
:
9138 internal_error (__FILE__
, __LINE__
,
9139 _("remote_write_bytes: bad internal state"));
9141 internal_error (__FILE__
, __LINE__
, _("bad switch"));
9144 return remote_write_bytes_aux (packet_format
,
9145 memaddr
, myaddr
, len
, unit_size
, xfered_len
,
9146 packet_format
[0], 1);
9149 /* Read memory data directly from the remote machine.
9150 This does not use the data cache; the data cache uses this.
9151 MEMADDR is the address in the remote memory space.
9152 MYADDR is the address of the buffer in our space.
9153 LEN_UNITS is the number of addressable memory units to read..
9154 UNIT_SIZE is the length in bytes of an addressable unit.
9156 Return the transferred status, error or OK (an
9157 'enum target_xfer_status' value). Save the number of bytes
9158 transferred in *XFERED_LEN_UNITS.
9160 See the comment of remote_write_bytes_aux for an example of
9161 memory read/write exchange between gdb and the stub. */
9164 remote_target::remote_read_bytes_1 (CORE_ADDR memaddr
, gdb_byte
*myaddr
,
9166 int unit_size
, ULONGEST
*xfered_len_units
)
9168 struct remote_state
*rs
= get_remote_state ();
9169 int buf_size_bytes
; /* Max size of packet output buffer. */
9174 buf_size_bytes
= get_memory_read_packet_size ();
9175 /* The packet buffer will be large enough for the payload;
9176 get_memory_packet_size ensures this. */
9178 /* Number of units that will fit. */
9179 todo_units
= std::min (len_units
,
9180 (ULONGEST
) (buf_size_bytes
/ unit_size
) / 2);
9182 /* Construct "m"<memaddr>","<len>". */
9183 memaddr
= remote_address_masked (memaddr
);
9184 p
= rs
->buf
.data ();
9186 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
9188 p
+= hexnumstr (p
, (ULONGEST
) todo_units
);
9191 getpkt (&rs
->buf
, 0);
9192 if (rs
->buf
[0] == 'E'
9193 && isxdigit (rs
->buf
[1]) && isxdigit (rs
->buf
[2])
9194 && rs
->buf
[3] == '\0')
9195 return TARGET_XFER_E_IO
;
9196 /* Reply describes memory byte by byte, each byte encoded as two hex
9198 p
= rs
->buf
.data ();
9199 decoded_bytes
= hex2bin (p
, myaddr
, todo_units
* unit_size
);
9200 /* Return what we have. Let higher layers handle partial reads. */
9201 *xfered_len_units
= (ULONGEST
) (decoded_bytes
/ unit_size
);
9202 return (*xfered_len_units
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
9205 /* Using the set of read-only target sections of remote, read live
9208 For interface/parameters/return description see target.h,
9212 remote_target::remote_xfer_live_readonly_partial (gdb_byte
*readbuf
,
9216 ULONGEST
*xfered_len
)
9218 const struct target_section
*secp
;
9220 secp
= target_section_by_addr (this, memaddr
);
9222 && (bfd_section_flags (secp
->the_bfd_section
) & SEC_READONLY
))
9224 ULONGEST memend
= memaddr
+ len
;
9226 const target_section_table
*table
= target_get_section_table (this);
9227 for (const target_section
&p
: *table
)
9229 if (memaddr
>= p
.addr
)
9231 if (memend
<= p
.endaddr
)
9233 /* Entire transfer is within this section. */
9234 return remote_read_bytes_1 (memaddr
, readbuf
, len
, unit_size
,
9237 else if (memaddr
>= p
.endaddr
)
9239 /* This section ends before the transfer starts. */
9244 /* This section overlaps the transfer. Just do half. */
9245 len
= p
.endaddr
- memaddr
;
9246 return remote_read_bytes_1 (memaddr
, readbuf
, len
, unit_size
,
9253 return TARGET_XFER_EOF
;
9256 /* Similar to remote_read_bytes_1, but it reads from the remote stub
9257 first if the requested memory is unavailable in traceframe.
9258 Otherwise, fall back to remote_read_bytes_1. */
9261 remote_target::remote_read_bytes (CORE_ADDR memaddr
,
9262 gdb_byte
*myaddr
, ULONGEST len
, int unit_size
,
9263 ULONGEST
*xfered_len
)
9266 return TARGET_XFER_EOF
;
9268 if (get_traceframe_number () != -1)
9270 std::vector
<mem_range
> available
;
9272 /* If we fail to get the set of available memory, then the
9273 target does not support querying traceframe info, and so we
9274 attempt reading from the traceframe anyway (assuming the
9275 target implements the old QTro packet then). */
9276 if (traceframe_available_memory (&available
, memaddr
, len
))
9278 if (available
.empty () || available
[0].start
!= memaddr
)
9280 enum target_xfer_status res
;
9282 /* Don't read into the traceframe's available
9284 if (!available
.empty ())
9286 LONGEST oldlen
= len
;
9288 len
= available
[0].start
- memaddr
;
9289 gdb_assert (len
<= oldlen
);
9292 /* This goes through the topmost target again. */
9293 res
= remote_xfer_live_readonly_partial (myaddr
, memaddr
,
9294 len
, unit_size
, xfered_len
);
9295 if (res
== TARGET_XFER_OK
)
9296 return TARGET_XFER_OK
;
9299 /* No use trying further, we know some memory starting
9300 at MEMADDR isn't available. */
9302 return (*xfered_len
!= 0) ?
9303 TARGET_XFER_UNAVAILABLE
: TARGET_XFER_EOF
;
9307 /* Don't try to read more than how much is available, in
9308 case the target implements the deprecated QTro packet to
9309 cater for older GDBs (the target's knowledge of read-only
9310 sections may be outdated by now). */
9311 len
= available
[0].length
;
9315 return remote_read_bytes_1 (memaddr
, myaddr
, len
, unit_size
, xfered_len
);
9320 /* Sends a packet with content determined by the printf format string
9321 FORMAT and the remaining arguments, then gets the reply. Returns
9322 whether the packet was a success, a failure, or unknown. */
9325 remote_target::remote_send_printf (const char *format
, ...)
9327 struct remote_state
*rs
= get_remote_state ();
9328 int max_size
= get_remote_packet_size ();
9331 va_start (ap
, format
);
9334 int size
= vsnprintf (rs
->buf
.data (), max_size
, format
, ap
);
9338 if (size
>= max_size
)
9339 internal_error (__FILE__
, __LINE__
, _("Too long remote packet."));
9341 if (putpkt (rs
->buf
) < 0)
9342 error (_("Communication problem with target."));
9345 getpkt (&rs
->buf
, 0);
9347 return packet_check_result (rs
->buf
);
9350 /* Flash writing can take quite some time. We'll set
9351 effectively infinite timeout for flash operations.
9352 In future, we'll need to decide on a better approach. */
9353 static const int remote_flash_timeout
= 1000;
9356 remote_target::flash_erase (ULONGEST address
, LONGEST length
)
9358 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
9359 enum packet_result ret
;
9360 scoped_restore restore_timeout
9361 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9363 ret
= remote_send_printf ("vFlashErase:%s,%s",
9364 phex (address
, addr_size
),
9368 case PACKET_UNKNOWN
:
9369 error (_("Remote target does not support flash erase"));
9371 error (_("Error erasing flash with vFlashErase packet"));
9378 remote_target::remote_flash_write (ULONGEST address
,
9379 ULONGEST length
, ULONGEST
*xfered_len
,
9380 const gdb_byte
*data
)
9382 scoped_restore restore_timeout
9383 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9384 return remote_write_bytes_aux ("vFlashWrite:", address
, data
, length
, 1,
9389 remote_target::flash_done ()
9393 scoped_restore restore_timeout
9394 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9396 ret
= remote_send_printf ("vFlashDone");
9400 case PACKET_UNKNOWN
:
9401 error (_("Remote target does not support vFlashDone"));
9403 error (_("Error finishing flash operation"));
9410 /* Stuff for dealing with the packets which are part of this protocol.
9411 See comment at top of file for details. */
9413 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
9414 error to higher layers. Called when a serial error is detected.
9415 The exception message is STRING, followed by a colon and a blank,
9416 the system error message for errno at function entry and final dot
9417 for output compatibility with throw_perror_with_name. */
9420 unpush_and_perror (remote_target
*target
, const char *string
)
9422 int saved_errno
= errno
;
9424 remote_unpush_target (target
);
9425 throw_error (TARGET_CLOSE_ERROR
, "%s: %s.", string
,
9426 safe_strerror (saved_errno
));
9429 /* Read a single character from the remote end. The current quit
9430 handler is overridden to avoid quitting in the middle of packet
9431 sequence, as that would break communication with the remote server.
9432 See remote_serial_quit_handler for more detail. */
9435 remote_target::readchar (int timeout
)
9438 struct remote_state
*rs
= get_remote_state ();
9441 scoped_restore restore_quit_target
9442 = make_scoped_restore (&curr_quit_handler_target
, this);
9443 scoped_restore restore_quit
9444 = make_scoped_restore (&quit_handler
, ::remote_serial_quit_handler
);
9446 rs
->got_ctrlc_during_io
= 0;
9448 ch
= serial_readchar (rs
->remote_desc
, timeout
);
9450 if (rs
->got_ctrlc_during_io
)
9457 switch ((enum serial_rc
) ch
)
9460 remote_unpush_target (this);
9461 throw_error (TARGET_CLOSE_ERROR
, _("Remote connection closed"));
9464 unpush_and_perror (this, _("Remote communication error. "
9465 "Target disconnected."));
9467 case SERIAL_TIMEOUT
:
9473 /* Wrapper for serial_write that closes the target and throws if
9474 writing fails. The current quit handler is overridden to avoid
9475 quitting in the middle of packet sequence, as that would break
9476 communication with the remote server. See
9477 remote_serial_quit_handler for more detail. */
9480 remote_target::remote_serial_write (const char *str
, int len
)
9482 struct remote_state
*rs
= get_remote_state ();
9484 scoped_restore restore_quit_target
9485 = make_scoped_restore (&curr_quit_handler_target
, this);
9486 scoped_restore restore_quit
9487 = make_scoped_restore (&quit_handler
, ::remote_serial_quit_handler
);
9489 rs
->got_ctrlc_during_io
= 0;
9491 if (serial_write (rs
->remote_desc
, str
, len
))
9493 unpush_and_perror (this, _("Remote communication error. "
9494 "Target disconnected."));
9497 if (rs
->got_ctrlc_during_io
)
9501 /* Return a string representing an escaped version of BUF, of len N.
9502 E.g. \n is converted to \\n, \t to \\t, etc. */
9505 escape_buffer (const char *buf
, int n
)
9509 stb
.putstrn (buf
, n
, '\\');
9510 return stb
.release ();
9514 remote_target::putpkt (const char *buf
)
9516 return putpkt_binary (buf
, strlen (buf
));
9519 /* Wrapper around remote_target::putpkt to avoid exporting
9523 putpkt (remote_target
*remote
, const char *buf
)
9525 return remote
->putpkt (buf
);
9528 /* Send a packet to the remote machine, with error checking. The data
9529 of the packet is in BUF. The string in BUF can be at most
9530 get_remote_packet_size () - 5 to account for the $, # and checksum,
9531 and for a possible /0 if we are debugging (remote_debug) and want
9532 to print the sent packet as a string. */
9535 remote_target::putpkt_binary (const char *buf
, int cnt
)
9537 struct remote_state
*rs
= get_remote_state ();
9539 unsigned char csum
= 0;
9540 gdb::def_vector
<char> data (cnt
+ 6);
9541 char *buf2
= data
.data ();
9547 /* Catch cases like trying to read memory or listing threads while
9548 we're waiting for a stop reply. The remote server wouldn't be
9549 ready to handle this request, so we'd hang and timeout. We don't
9550 have to worry about this in synchronous mode, because in that
9551 case it's not possible to issue a command while the target is
9552 running. This is not a problem in non-stop mode, because in that
9553 case, the stub is always ready to process serial input. */
9554 if (!target_is_non_stop_p ()
9555 && target_is_async_p ()
9556 && rs
->waiting_for_stop_reply
)
9558 error (_("Cannot execute this command while the target is running.\n"
9559 "Use the \"interrupt\" command to stop the target\n"
9560 "and then try again."));
9563 /* Copy the packet into buffer BUF2, encapsulating it
9564 and giving it a checksum. */
9569 for (i
= 0; i
< cnt
; i
++)
9575 *p
++ = tohex ((csum
>> 4) & 0xf);
9576 *p
++ = tohex (csum
& 0xf);
9578 /* Send it over and over until we get a positive ack. */
9586 int len
= (int) (p
- buf2
);
9589 if (remote_packet_max_chars
< 0)
9592 max_chars
= remote_packet_max_chars
;
9595 = escape_buffer (buf2
, std::min (len
, max_chars
));
9597 if (len
> max_chars
)
9598 remote_debug_printf_nofunc
9599 ("Sending packet: %s [%d bytes omitted]", str
.c_str (),
9602 remote_debug_printf_nofunc ("Sending packet: %s", str
.c_str ());
9604 remote_serial_write (buf2
, p
- buf2
);
9606 /* If this is a no acks version of the remote protocol, send the
9607 packet and move on. */
9611 /* Read until either a timeout occurs (-2) or '+' is read.
9612 Handle any notification that arrives in the mean time. */
9615 ch
= readchar (remote_timeout
);
9620 remote_debug_printf_nofunc ("Received Ack");
9623 remote_debug_printf_nofunc ("Received Nak");
9625 case SERIAL_TIMEOUT
:
9629 break; /* Retransmit buffer. */
9632 remote_debug_printf ("Packet instead of Ack, ignoring it");
9633 /* It's probably an old response sent because an ACK
9634 was lost. Gobble up the packet and ack it so it
9635 doesn't get retransmitted when we resend this
9638 remote_serial_write ("+", 1);
9639 continue; /* Now, go look for +. */
9646 /* If we got a notification, handle it, and go back to looking
9648 /* We've found the start of a notification. Now
9649 collect the data. */
9650 val
= read_frame (&rs
->buf
);
9653 remote_debug_printf_nofunc
9654 (" Notification received: %s",
9655 escape_buffer (rs
->buf
.data (), val
).c_str ());
9657 handle_notification (rs
->notif_state
, rs
->buf
.data ());
9658 /* We're in sync now, rewait for the ack. */
9662 remote_debug_printf_nofunc ("Junk: %c%s", ch
& 0177,
9668 remote_debug_printf_nofunc ("Junk: %c%s", ch
& 0177,
9672 break; /* Here to retransmit. */
9676 /* This is wrong. If doing a long backtrace, the user should be
9677 able to get out next time we call QUIT, without anything as
9678 violent as interrupt_query. If we want to provide a way out of
9679 here without getting to the next QUIT, it should be based on
9680 hitting ^C twice as in remote_wait. */
9692 /* Come here after finding the start of a frame when we expected an
9693 ack. Do our best to discard the rest of this packet. */
9696 remote_target::skip_frame ()
9702 c
= readchar (remote_timeout
);
9705 case SERIAL_TIMEOUT
:
9706 /* Nothing we can do. */
9709 /* Discard the two bytes of checksum and stop. */
9710 c
= readchar (remote_timeout
);
9712 c
= readchar (remote_timeout
);
9715 case '*': /* Run length encoding. */
9716 /* Discard the repeat count. */
9717 c
= readchar (remote_timeout
);
9722 /* A regular character. */
9728 /* Come here after finding the start of the frame. Collect the rest
9729 into *BUF, verifying the checksum, length, and handling run-length
9730 compression. NUL terminate the buffer. If there is not enough room,
9733 Returns -1 on error, number of characters in buffer (ignoring the
9734 trailing NULL) on success. (could be extended to return one of the
9735 SERIAL status indications). */
9738 remote_target::read_frame (gdb::char_vector
*buf_p
)
9743 char *buf
= buf_p
->data ();
9744 struct remote_state
*rs
= get_remote_state ();
9751 c
= readchar (remote_timeout
);
9754 case SERIAL_TIMEOUT
:
9755 remote_debug_printf ("Timeout in mid-packet, retrying");
9759 remote_debug_printf ("Saw new packet start in middle of old one");
9760 return -1; /* Start a new packet, count retries. */
9764 unsigned char pktcsum
;
9770 check_0
= readchar (remote_timeout
);
9772 check_1
= readchar (remote_timeout
);
9774 if (check_0
== SERIAL_TIMEOUT
|| check_1
== SERIAL_TIMEOUT
)
9776 remote_debug_printf ("Timeout in checksum, retrying");
9779 else if (check_0
< 0 || check_1
< 0)
9781 remote_debug_printf ("Communication error in checksum");
9785 /* Don't recompute the checksum; with no ack packets we
9786 don't have any way to indicate a packet retransmission
9791 pktcsum
= (fromhex (check_0
) << 4) | fromhex (check_1
);
9792 if (csum
== pktcsum
)
9796 ("Bad checksum, sentsum=0x%x, csum=0x%x, buf=%s",
9797 pktcsum
, csum
, escape_buffer (buf
, bc
).c_str ());
9799 /* Number of characters in buffer ignoring trailing
9803 case '*': /* Run length encoding. */
9808 c
= readchar (remote_timeout
);
9810 repeat
= c
- ' ' + 3; /* Compute repeat count. */
9812 /* The character before ``*'' is repeated. */
9814 if (repeat
> 0 && repeat
<= 255 && bc
> 0)
9816 if (bc
+ repeat
- 1 >= buf_p
->size () - 1)
9818 /* Make some more room in the buffer. */
9819 buf_p
->resize (buf_p
->size () + repeat
);
9820 buf
= buf_p
->data ();
9823 memset (&buf
[bc
], buf
[bc
- 1], repeat
);
9829 gdb_printf (_("Invalid run length encoding: %s\n"), buf
);
9833 if (bc
>= buf_p
->size () - 1)
9835 /* Make some more room in the buffer. */
9836 buf_p
->resize (buf_p
->size () * 2);
9837 buf
= buf_p
->data ();
9847 /* Set this to the maximum number of seconds to wait instead of waiting forever
9848 in target_wait(). If this timer times out, then it generates an error and
9849 the command is aborted. This replaces most of the need for timeouts in the
9850 GDB test suite, and makes it possible to distinguish between a hung target
9851 and one with slow communications. */
9853 static int watchdog
= 0;
9855 show_watchdog (struct ui_file
*file
, int from_tty
,
9856 struct cmd_list_element
*c
, const char *value
)
9858 gdb_printf (file
, _("Watchdog timer is %s.\n"), value
);
9861 /* Read a packet from the remote machine, with error checking, and
9862 store it in *BUF. Resize *BUF if necessary to hold the result. If
9863 FOREVER, wait forever rather than timing out; this is used (in
9864 synchronous mode) to wait for a target that is is executing user
9866 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
9867 don't have to change all the calls to getpkt to deal with the
9868 return value, because at the moment I don't know what the right
9869 thing to do it for those. */
9872 remote_target::getpkt (gdb::char_vector
*buf
, int forever
)
9874 getpkt_sane (buf
, forever
);
9878 /* Read a packet from the remote machine, with error checking, and
9879 store it in *BUF. Resize *BUF if necessary to hold the result. If
9880 FOREVER, wait forever rather than timing out; this is used (in
9881 synchronous mode) to wait for a target that is is executing user
9882 code to stop. If FOREVER == 0, this function is allowed to time
9883 out gracefully and return an indication of this to the caller.
9884 Otherwise return the number of bytes read. If EXPECTING_NOTIF,
9885 consider receiving a notification enough reason to return to the
9886 caller. *IS_NOTIF is an output boolean that indicates whether *BUF
9887 holds a notification or not (a regular packet). */
9890 remote_target::getpkt_or_notif_sane_1 (gdb::char_vector
*buf
,
9891 int forever
, int expecting_notif
,
9894 struct remote_state
*rs
= get_remote_state ();
9900 strcpy (buf
->data (), "timeout");
9903 timeout
= watchdog
> 0 ? watchdog
: -1;
9904 else if (expecting_notif
)
9905 timeout
= 0; /* There should already be a char in the buffer. If
9908 timeout
= remote_timeout
;
9912 /* Process any number of notifications, and then return when
9916 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
9918 for (tries
= 1; tries
<= MAX_TRIES
; tries
++)
9920 /* This can loop forever if the remote side sends us
9921 characters continuously, but if it pauses, we'll get
9922 SERIAL_TIMEOUT from readchar because of timeout. Then
9923 we'll count that as a retry.
9925 Note that even when forever is set, we will only wait
9926 forever prior to the start of a packet. After that, we
9927 expect characters to arrive at a brisk pace. They should
9928 show up within remote_timeout intervals. */
9930 c
= readchar (timeout
);
9931 while (c
!= SERIAL_TIMEOUT
&& c
!= '$' && c
!= '%');
9933 if (c
== SERIAL_TIMEOUT
)
9935 if (expecting_notif
)
9936 return -1; /* Don't complain, it's normal to not get
9937 anything in this case. */
9939 if (forever
) /* Watchdog went off? Kill the target. */
9941 remote_unpush_target (this);
9942 throw_error (TARGET_CLOSE_ERROR
,
9943 _("Watchdog timeout has expired. "
9944 "Target detached."));
9947 remote_debug_printf ("Timed out.");
9951 /* We've found the start of a packet or notification.
9952 Now collect the data. */
9953 val
= read_frame (buf
);
9958 remote_serial_write ("-", 1);
9961 if (tries
> MAX_TRIES
)
9963 /* We have tried hard enough, and just can't receive the
9964 packet/notification. Give up. */
9965 gdb_printf (_("Ignoring packet error, continuing...\n"));
9967 /* Skip the ack char if we're in no-ack mode. */
9968 if (!rs
->noack_mode
)
9969 remote_serial_write ("+", 1);
9973 /* If we got an ordinary packet, return that to our caller. */
9980 if (remote_packet_max_chars
< 0)
9983 max_chars
= remote_packet_max_chars
;
9986 = escape_buffer (buf
->data (),
9987 std::min (val
, max_chars
));
9989 if (val
> max_chars
)
9990 remote_debug_printf_nofunc
9991 ("Packet received: %s [%d bytes omitted]", str
.c_str (),
9994 remote_debug_printf_nofunc ("Packet received: %s",
9998 /* Skip the ack char if we're in no-ack mode. */
9999 if (!rs
->noack_mode
)
10000 remote_serial_write ("+", 1);
10001 if (is_notif
!= NULL
)
10006 /* If we got a notification, handle it, and go back to looking
10010 gdb_assert (c
== '%');
10012 remote_debug_printf_nofunc
10013 (" Notification received: %s",
10014 escape_buffer (buf
->data (), val
).c_str ());
10016 if (is_notif
!= NULL
)
10019 handle_notification (rs
->notif_state
, buf
->data ());
10021 /* Notifications require no acknowledgement. */
10023 if (expecting_notif
)
10030 remote_target::getpkt_sane (gdb::char_vector
*buf
, int forever
)
10032 return getpkt_or_notif_sane_1 (buf
, forever
, 0, NULL
);
10036 remote_target::getpkt_or_notif_sane (gdb::char_vector
*buf
, int forever
,
10039 return getpkt_or_notif_sane_1 (buf
, forever
, 1, is_notif
);
10042 /* Kill any new fork children of inferior INF that haven't been
10043 processed by follow_fork. */
10046 remote_target::kill_new_fork_children (inferior
*inf
)
10048 remote_state
*rs
= get_remote_state ();
10049 struct notif_client
*notif
= ¬if_client_stop
;
10051 /* Kill the fork child threads of any threads in inferior INF that are stopped
10052 at a fork event. */
10053 for (thread_info
*thread
: inf
->non_exited_threads ())
10055 const target_waitstatus
*ws
= thread_pending_fork_status (thread
);
10060 int child_pid
= ws
->child_ptid ().pid ();
10061 int res
= remote_vkill (child_pid
);
10064 error (_("Can't kill fork child process %d"), child_pid
);
10067 /* Check for any pending fork events (not reported or processed yet)
10068 in inferior INF and kill those fork child threads as well. */
10069 remote_notif_get_pending_events (notif
);
10070 for (auto &event
: rs
->stop_reply_queue
)
10072 if (event
->ptid
.pid () != inf
->pid
)
10075 if (!is_fork_status (event
->ws
.kind ()))
10078 int child_pid
= event
->ws
.child_ptid ().pid ();
10079 int res
= remote_vkill (child_pid
);
10082 error (_("Can't kill fork child process %d"), child_pid
);
10087 /* Target hook to kill the current inferior. */
10090 remote_target::kill ()
10093 inferior
*inf
= find_inferior_pid (this, inferior_ptid
.pid ());
10094 struct remote_state
*rs
= get_remote_state ();
10096 gdb_assert (inf
!= nullptr);
10098 if (packet_support (PACKET_vKill
) != PACKET_DISABLE
)
10100 /* If we're stopped while forking and we haven't followed yet,
10101 kill the child task. We need to do this before killing the
10102 parent task because if this is a vfork then the parent will
10104 kill_new_fork_children (inf
);
10106 res
= remote_vkill (inf
->pid
);
10109 target_mourn_inferior (inferior_ptid
);
10114 /* If we are in 'target remote' mode and we are killing the only
10115 inferior, then we will tell gdbserver to exit and unpush the
10117 if (res
== -1 && !remote_multi_process_p (rs
)
10118 && number_of_live_inferiors (this) == 1)
10122 /* We've killed the remote end, we get to mourn it. If we are
10123 not in extended mode, mourning the inferior also unpushes
10124 remote_ops from the target stack, which closes the remote
10126 target_mourn_inferior (inferior_ptid
);
10131 error (_("Can't kill process"));
10134 /* Send a kill request to the target using the 'vKill' packet. */
10137 remote_target::remote_vkill (int pid
)
10139 if (packet_support (PACKET_vKill
) == PACKET_DISABLE
)
10142 remote_state
*rs
= get_remote_state ();
10144 /* Tell the remote target to detach. */
10145 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "vKill;%x", pid
);
10147 getpkt (&rs
->buf
, 0);
10149 switch (packet_ok (rs
->buf
,
10150 &remote_protocol_packets
[PACKET_vKill
]))
10156 case PACKET_UNKNOWN
:
10159 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
10163 /* Send a kill request to the target using the 'k' packet. */
10166 remote_target::remote_kill_k ()
10168 /* Catch errors so the user can quit from gdb even when we
10169 aren't on speaking terms with the remote system. */
10174 catch (const gdb_exception_error
&ex
)
10176 if (ex
.error
== TARGET_CLOSE_ERROR
)
10178 /* If we got an (EOF) error that caused the target
10179 to go away, then we're done, that's what we wanted.
10180 "k" is susceptible to cause a premature EOF, given
10181 that the remote server isn't actually required to
10182 reply to "k", and it can happen that it doesn't
10183 even get to reply ACK to the "k". */
10187 /* Otherwise, something went wrong. We didn't actually kill
10188 the target. Just propagate the exception, and let the
10189 user or higher layers decide what to do. */
10195 remote_target::mourn_inferior ()
10197 struct remote_state
*rs
= get_remote_state ();
10199 /* We're no longer interested in notification events of an inferior
10200 that exited or was killed/detached. */
10201 discard_pending_stop_replies (current_inferior ());
10203 /* In 'target remote' mode with one inferior, we close the connection. */
10204 if (!rs
->extended
&& number_of_live_inferiors (this) <= 1)
10206 remote_unpush_target (this);
10210 /* In case we got here due to an error, but we're going to stay
10212 rs
->waiting_for_stop_reply
= 0;
10214 /* If the current general thread belonged to the process we just
10215 detached from or has exited, the remote side current general
10216 thread becomes undefined. Considering a case like this:
10218 - We just got here due to a detach.
10219 - The process that we're detaching from happens to immediately
10220 report a global breakpoint being hit in non-stop mode, in the
10221 same thread we had selected before.
10222 - GDB attaches to this process again.
10223 - This event happens to be the next event we handle.
10225 GDB would consider that the current general thread didn't need to
10226 be set on the stub side (with Hg), since for all it knew,
10227 GENERAL_THREAD hadn't changed.
10229 Notice that although in all-stop mode, the remote server always
10230 sets the current thread to the thread reporting the stop event,
10231 that doesn't happen in non-stop mode; in non-stop, the stub *must
10232 not* change the current thread when reporting a breakpoint hit,
10233 due to the decoupling of event reporting and event handling.
10235 To keep things simple, we always invalidate our notion of the
10237 record_currthread (rs
, minus_one_ptid
);
10239 /* Call common code to mark the inferior as not running. */
10240 generic_mourn_inferior ();
10244 extended_remote_target::supports_disable_randomization ()
10246 return packet_support (PACKET_QDisableRandomization
) == PACKET_ENABLE
;
10250 remote_target::extended_remote_disable_randomization (int val
)
10252 struct remote_state
*rs
= get_remote_state ();
10255 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10256 "QDisableRandomization:%x", val
);
10258 reply
= remote_get_noisy_reply ();
10259 if (*reply
== '\0')
10260 error (_("Target does not support QDisableRandomization."));
10261 if (strcmp (reply
, "OK") != 0)
10262 error (_("Bogus QDisableRandomization reply from target: %s"), reply
);
10266 remote_target::extended_remote_run (const std::string
&args
)
10268 struct remote_state
*rs
= get_remote_state ();
10270 const char *remote_exec_file
= get_remote_exec_file ();
10272 /* If the user has disabled vRun support, or we have detected that
10273 support is not available, do not try it. */
10274 if (packet_support (PACKET_vRun
) == PACKET_DISABLE
)
10277 strcpy (rs
->buf
.data (), "vRun;");
10278 len
= strlen (rs
->buf
.data ());
10280 if (strlen (remote_exec_file
) * 2 + len
>= get_remote_packet_size ())
10281 error (_("Remote file name too long for run packet"));
10282 len
+= 2 * bin2hex ((gdb_byte
*) remote_exec_file
, rs
->buf
.data () + len
,
10283 strlen (remote_exec_file
));
10285 if (!args
.empty ())
10289 gdb_argv
argv (args
.c_str ());
10290 for (i
= 0; argv
[i
] != NULL
; i
++)
10292 if (strlen (argv
[i
]) * 2 + 1 + len
>= get_remote_packet_size ())
10293 error (_("Argument list too long for run packet"));
10294 rs
->buf
[len
++] = ';';
10295 len
+= 2 * bin2hex ((gdb_byte
*) argv
[i
], rs
->buf
.data () + len
,
10300 rs
->buf
[len
++] = '\0';
10303 getpkt (&rs
->buf
, 0);
10305 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vRun
]))
10308 /* We have a wait response. All is well. */
10310 case PACKET_UNKNOWN
:
10313 if (remote_exec_file
[0] == '\0')
10314 error (_("Running the default executable on the remote target failed; "
10315 "try \"set remote exec-file\"?"));
10317 error (_("Running \"%s\" on the remote target failed"),
10320 gdb_assert_not_reached ("bad switch");
10324 /* Helper function to send set/unset environment packets. ACTION is
10325 either "set" or "unset". PACKET is either "QEnvironmentHexEncoded"
10326 or "QEnvironmentUnsetVariable". VALUE is the variable to be
10330 remote_target::send_environment_packet (const char *action
,
10331 const char *packet
,
10334 remote_state
*rs
= get_remote_state ();
10336 /* Convert the environment variable to an hex string, which
10337 is the best format to be transmitted over the wire. */
10338 std::string encoded_value
= bin2hex ((const gdb_byte
*) value
,
10341 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10342 "%s:%s", packet
, encoded_value
.c_str ());
10345 getpkt (&rs
->buf
, 0);
10346 if (strcmp (rs
->buf
.data (), "OK") != 0)
10347 warning (_("Unable to %s environment variable '%s' on remote."),
10351 /* Helper function to handle the QEnvironment* packets. */
10354 remote_target::extended_remote_environment_support ()
10356 remote_state
*rs
= get_remote_state ();
10358 if (packet_support (PACKET_QEnvironmentReset
) != PACKET_DISABLE
)
10360 putpkt ("QEnvironmentReset");
10361 getpkt (&rs
->buf
, 0);
10362 if (strcmp (rs
->buf
.data (), "OK") != 0)
10363 warning (_("Unable to reset environment on remote."));
10366 gdb_environ
*e
= ¤t_inferior ()->environment
;
10368 if (packet_support (PACKET_QEnvironmentHexEncoded
) != PACKET_DISABLE
)
10369 for (const std::string
&el
: e
->user_set_env ())
10370 send_environment_packet ("set", "QEnvironmentHexEncoded",
10373 if (packet_support (PACKET_QEnvironmentUnset
) != PACKET_DISABLE
)
10374 for (const std::string
&el
: e
->user_unset_env ())
10375 send_environment_packet ("unset", "QEnvironmentUnset", el
.c_str ());
10378 /* Helper function to set the current working directory for the
10379 inferior in the remote target. */
10382 remote_target::extended_remote_set_inferior_cwd ()
10384 if (packet_support (PACKET_QSetWorkingDir
) != PACKET_DISABLE
)
10386 const std::string
&inferior_cwd
= current_inferior ()->cwd ();
10387 remote_state
*rs
= get_remote_state ();
10389 if (!inferior_cwd
.empty ())
10391 std::string hexpath
10392 = bin2hex ((const gdb_byte
*) inferior_cwd
.data (),
10393 inferior_cwd
.size ());
10395 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10396 "QSetWorkingDir:%s", hexpath
.c_str ());
10400 /* An empty inferior_cwd means that the user wants us to
10401 reset the remote server's inferior's cwd. */
10402 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10403 "QSetWorkingDir:");
10407 getpkt (&rs
->buf
, 0);
10408 if (packet_ok (rs
->buf
,
10409 &remote_protocol_packets
[PACKET_QSetWorkingDir
])
10412 Remote replied unexpectedly while setting the inferior's working\n\
10419 /* In the extended protocol we want to be able to do things like
10420 "run" and have them basically work as expected. So we need
10421 a special create_inferior function. We support changing the
10422 executable file and the command line arguments, but not the
10426 extended_remote_target::create_inferior (const char *exec_file
,
10427 const std::string
&args
,
10428 char **env
, int from_tty
)
10432 struct remote_state
*rs
= get_remote_state ();
10433 const char *remote_exec_file
= get_remote_exec_file ();
10435 /* If running asynchronously, register the target file descriptor
10436 with the event loop. */
10437 if (target_can_async_p ())
10440 /* Disable address space randomization if requested (and supported). */
10441 if (supports_disable_randomization ())
10442 extended_remote_disable_randomization (disable_randomization
);
10444 /* If startup-with-shell is on, we inform gdbserver to start the
10445 remote inferior using a shell. */
10446 if (packet_support (PACKET_QStartupWithShell
) != PACKET_DISABLE
)
10448 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10449 "QStartupWithShell:%d", startup_with_shell
? 1 : 0);
10451 getpkt (&rs
->buf
, 0);
10452 if (strcmp (rs
->buf
.data (), "OK") != 0)
10454 Remote replied unexpectedly while setting startup-with-shell: %s"),
10458 extended_remote_environment_support ();
10460 extended_remote_set_inferior_cwd ();
10462 /* Now restart the remote server. */
10463 run_worked
= extended_remote_run (args
) != -1;
10466 /* vRun was not supported. Fail if we need it to do what the
10468 if (remote_exec_file
[0])
10469 error (_("Remote target does not support \"set remote exec-file\""));
10470 if (!args
.empty ())
10471 error (_("Remote target does not support \"set args\" or run ARGS"));
10473 /* Fall back to "R". */
10474 extended_remote_restart ();
10477 /* vRun's success return is a stop reply. */
10478 stop_reply
= run_worked
? rs
->buf
.data () : NULL
;
10479 add_current_inferior_and_thread (stop_reply
);
10481 /* Get updated offsets, if the stub uses qOffsets. */
10486 /* Given a location's target info BP_TGT and the packet buffer BUF, output
10487 the list of conditions (in agent expression bytecode format), if any, the
10488 target needs to evaluate. The output is placed into the packet buffer
10489 started from BUF and ended at BUF_END. */
10492 remote_add_target_side_condition (struct gdbarch
*gdbarch
,
10493 struct bp_target_info
*bp_tgt
, char *buf
,
10496 if (bp_tgt
->conditions
.empty ())
10499 buf
+= strlen (buf
);
10500 xsnprintf (buf
, buf_end
- buf
, "%s", ";");
10503 /* Send conditions to the target. */
10504 for (agent_expr
*aexpr
: bp_tgt
->conditions
)
10506 xsnprintf (buf
, buf_end
- buf
, "X%x,", aexpr
->len
);
10507 buf
+= strlen (buf
);
10508 for (int i
= 0; i
< aexpr
->len
; ++i
)
10509 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
10516 remote_add_target_side_commands (struct gdbarch
*gdbarch
,
10517 struct bp_target_info
*bp_tgt
, char *buf
)
10519 if (bp_tgt
->tcommands
.empty ())
10522 buf
+= strlen (buf
);
10524 sprintf (buf
, ";cmds:%x,", bp_tgt
->persist
);
10525 buf
+= strlen (buf
);
10527 /* Concatenate all the agent expressions that are commands into the
10529 for (agent_expr
*aexpr
: bp_tgt
->tcommands
)
10531 sprintf (buf
, "X%x,", aexpr
->len
);
10532 buf
+= strlen (buf
);
10533 for (int i
= 0; i
< aexpr
->len
; ++i
)
10534 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
10539 /* Insert a breakpoint. On targets that have software breakpoint
10540 support, we ask the remote target to do the work; on targets
10541 which don't, we insert a traditional memory breakpoint. */
10544 remote_target::insert_breakpoint (struct gdbarch
*gdbarch
,
10545 struct bp_target_info
*bp_tgt
)
10547 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
10548 If it succeeds, then set the support to PACKET_ENABLE. If it
10549 fails, and the user has explicitly requested the Z support then
10550 report an error, otherwise, mark it disabled and go on. */
10552 if (packet_support (PACKET_Z0
) != PACKET_DISABLE
)
10554 CORE_ADDR addr
= bp_tgt
->reqstd_address
;
10555 struct remote_state
*rs
;
10558 /* Make sure the remote is pointing at the right process, if
10560 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10561 set_general_process ();
10563 rs
= get_remote_state ();
10564 p
= rs
->buf
.data ();
10565 endbuf
= p
+ get_remote_packet_size ();
10570 addr
= (ULONGEST
) remote_address_masked (addr
);
10571 p
+= hexnumstr (p
, addr
);
10572 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->kind
);
10574 if (supports_evaluation_of_breakpoint_conditions ())
10575 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
10577 if (can_run_breakpoint_commands ())
10578 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
10581 getpkt (&rs
->buf
, 0);
10583 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
]))
10589 case PACKET_UNKNOWN
:
10594 /* If this breakpoint has target-side commands but this stub doesn't
10595 support Z0 packets, throw error. */
10596 if (!bp_tgt
->tcommands
.empty ())
10597 throw_error (NOT_SUPPORTED_ERROR
, _("\
10598 Target doesn't support breakpoints that have target side commands."));
10600 return memory_insert_breakpoint (this, gdbarch
, bp_tgt
);
10604 remote_target::remove_breakpoint (struct gdbarch
*gdbarch
,
10605 struct bp_target_info
*bp_tgt
,
10606 enum remove_bp_reason reason
)
10608 CORE_ADDR addr
= bp_tgt
->placed_address
;
10609 struct remote_state
*rs
= get_remote_state ();
10611 if (packet_support (PACKET_Z0
) != PACKET_DISABLE
)
10613 char *p
= rs
->buf
.data ();
10614 char *endbuf
= p
+ get_remote_packet_size ();
10616 /* Make sure the remote is pointing at the right process, if
10618 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10619 set_general_process ();
10625 addr
= (ULONGEST
) remote_address_masked (bp_tgt
->placed_address
);
10626 p
+= hexnumstr (p
, addr
);
10627 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->kind
);
10630 getpkt (&rs
->buf
, 0);
10632 return (rs
->buf
[0] == 'E');
10635 return memory_remove_breakpoint (this, gdbarch
, bp_tgt
, reason
);
10638 static enum Z_packet_type
10639 watchpoint_to_Z_packet (int type
)
10644 return Z_PACKET_WRITE_WP
;
10647 return Z_PACKET_READ_WP
;
10650 return Z_PACKET_ACCESS_WP
;
10653 internal_error (__FILE__
, __LINE__
,
10654 _("hw_bp_to_z: bad watchpoint type %d"), type
);
10659 remote_target::insert_watchpoint (CORE_ADDR addr
, int len
,
10660 enum target_hw_bp_type type
, struct expression
*cond
)
10662 struct remote_state
*rs
= get_remote_state ();
10663 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
10665 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
10667 if (packet_support (PACKET_Z0
+ packet
) == PACKET_DISABLE
)
10670 /* Make sure the remote is pointing at the right process, if
10672 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10673 set_general_process ();
10675 xsnprintf (rs
->buf
.data (), endbuf
- rs
->buf
.data (), "Z%x,", packet
);
10676 p
= strchr (rs
->buf
.data (), '\0');
10677 addr
= remote_address_masked (addr
);
10678 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10679 xsnprintf (p
, endbuf
- p
, ",%x", len
);
10682 getpkt (&rs
->buf
, 0);
10684 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
10688 case PACKET_UNKNOWN
:
10693 internal_error (__FILE__
, __LINE__
,
10694 _("remote_insert_watchpoint: reached end of function"));
10698 remote_target::watchpoint_addr_within_range (CORE_ADDR addr
,
10699 CORE_ADDR start
, int length
)
10701 CORE_ADDR diff
= remote_address_masked (addr
- start
);
10703 return diff
< length
;
10708 remote_target::remove_watchpoint (CORE_ADDR addr
, int len
,
10709 enum target_hw_bp_type type
, struct expression
*cond
)
10711 struct remote_state
*rs
= get_remote_state ();
10712 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
10714 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
10716 if (packet_support (PACKET_Z0
+ packet
) == PACKET_DISABLE
)
10719 /* Make sure the remote is pointing at the right process, if
10721 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10722 set_general_process ();
10724 xsnprintf (rs
->buf
.data (), endbuf
- rs
->buf
.data (), "z%x,", packet
);
10725 p
= strchr (rs
->buf
.data (), '\0');
10726 addr
= remote_address_masked (addr
);
10727 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10728 xsnprintf (p
, endbuf
- p
, ",%x", len
);
10730 getpkt (&rs
->buf
, 0);
10732 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
10735 case PACKET_UNKNOWN
:
10740 internal_error (__FILE__
, __LINE__
,
10741 _("remote_remove_watchpoint: reached end of function"));
10745 static int remote_hw_watchpoint_limit
= -1;
10746 static int remote_hw_watchpoint_length_limit
= -1;
10747 static int remote_hw_breakpoint_limit
= -1;
10750 remote_target::region_ok_for_hw_watchpoint (CORE_ADDR addr
, int len
)
10752 if (remote_hw_watchpoint_length_limit
== 0)
10754 else if (remote_hw_watchpoint_length_limit
< 0)
10756 else if (len
<= remote_hw_watchpoint_length_limit
)
10763 remote_target::can_use_hw_breakpoint (enum bptype type
, int cnt
, int ot
)
10765 if (type
== bp_hardware_breakpoint
)
10767 if (remote_hw_breakpoint_limit
== 0)
10769 else if (remote_hw_breakpoint_limit
< 0)
10771 else if (cnt
<= remote_hw_breakpoint_limit
)
10776 if (remote_hw_watchpoint_limit
== 0)
10778 else if (remote_hw_watchpoint_limit
< 0)
10782 else if (cnt
<= remote_hw_watchpoint_limit
)
10788 /* The to_stopped_by_sw_breakpoint method of target remote. */
10791 remote_target::stopped_by_sw_breakpoint ()
10793 struct thread_info
*thread
= inferior_thread ();
10795 return (thread
->priv
!= NULL
10796 && (get_remote_thread_info (thread
)->stop_reason
10797 == TARGET_STOPPED_BY_SW_BREAKPOINT
));
10800 /* The to_supports_stopped_by_sw_breakpoint method of target
10804 remote_target::supports_stopped_by_sw_breakpoint ()
10806 return (packet_support (PACKET_swbreak_feature
) == PACKET_ENABLE
);
10809 /* The to_stopped_by_hw_breakpoint method of target remote. */
10812 remote_target::stopped_by_hw_breakpoint ()
10814 struct thread_info
*thread
= inferior_thread ();
10816 return (thread
->priv
!= NULL
10817 && (get_remote_thread_info (thread
)->stop_reason
10818 == TARGET_STOPPED_BY_HW_BREAKPOINT
));
10821 /* The to_supports_stopped_by_hw_breakpoint method of target
10825 remote_target::supports_stopped_by_hw_breakpoint ()
10827 return (packet_support (PACKET_hwbreak_feature
) == PACKET_ENABLE
);
10831 remote_target::stopped_by_watchpoint ()
10833 struct thread_info
*thread
= inferior_thread ();
10835 return (thread
->priv
!= NULL
10836 && (get_remote_thread_info (thread
)->stop_reason
10837 == TARGET_STOPPED_BY_WATCHPOINT
));
10841 remote_target::stopped_data_address (CORE_ADDR
*addr_p
)
10843 struct thread_info
*thread
= inferior_thread ();
10845 if (thread
->priv
!= NULL
10846 && (get_remote_thread_info (thread
)->stop_reason
10847 == TARGET_STOPPED_BY_WATCHPOINT
))
10849 *addr_p
= get_remote_thread_info (thread
)->watch_data_address
;
10858 remote_target::insert_hw_breakpoint (struct gdbarch
*gdbarch
,
10859 struct bp_target_info
*bp_tgt
)
10861 CORE_ADDR addr
= bp_tgt
->reqstd_address
;
10862 struct remote_state
*rs
;
10866 if (packet_support (PACKET_Z1
) == PACKET_DISABLE
)
10869 /* Make sure the remote is pointing at the right process, if
10871 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10872 set_general_process ();
10874 rs
= get_remote_state ();
10875 p
= rs
->buf
.data ();
10876 endbuf
= p
+ get_remote_packet_size ();
10882 addr
= remote_address_masked (addr
);
10883 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10884 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->kind
);
10886 if (supports_evaluation_of_breakpoint_conditions ())
10887 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
10889 if (can_run_breakpoint_commands ())
10890 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
10893 getpkt (&rs
->buf
, 0);
10895 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
10898 if (rs
->buf
[1] == '.')
10900 message
= strchr (&rs
->buf
[2], '.');
10902 error (_("Remote failure reply: %s"), message
+ 1);
10905 case PACKET_UNKNOWN
:
10910 internal_error (__FILE__
, __LINE__
,
10911 _("remote_insert_hw_breakpoint: reached end of function"));
10916 remote_target::remove_hw_breakpoint (struct gdbarch
*gdbarch
,
10917 struct bp_target_info
*bp_tgt
)
10920 struct remote_state
*rs
= get_remote_state ();
10921 char *p
= rs
->buf
.data ();
10922 char *endbuf
= p
+ get_remote_packet_size ();
10924 if (packet_support (PACKET_Z1
) == PACKET_DISABLE
)
10927 /* Make sure the remote is pointing at the right process, if
10929 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10930 set_general_process ();
10936 addr
= remote_address_masked (bp_tgt
->placed_address
);
10937 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10938 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->kind
);
10941 getpkt (&rs
->buf
, 0);
10943 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
10946 case PACKET_UNKNOWN
:
10951 internal_error (__FILE__
, __LINE__
,
10952 _("remote_remove_hw_breakpoint: reached end of function"));
10955 /* Verify memory using the "qCRC:" request. */
10958 remote_target::verify_memory (const gdb_byte
*data
, CORE_ADDR lma
, ULONGEST size
)
10960 struct remote_state
*rs
= get_remote_state ();
10961 unsigned long host_crc
, target_crc
;
10964 /* It doesn't make sense to use qCRC if the remote target is
10965 connected but not running. */
10966 if (target_has_execution ()
10967 && packet_support (PACKET_qCRC
) != PACKET_DISABLE
)
10969 enum packet_result result
;
10971 /* Make sure the remote is pointing at the right process. */
10972 set_general_process ();
10974 /* FIXME: assumes lma can fit into long. */
10975 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qCRC:%lx,%lx",
10976 (long) lma
, (long) size
);
10979 /* Be clever; compute the host_crc before waiting for target
10981 host_crc
= xcrc32 (data
, size
, 0xffffffff);
10983 getpkt (&rs
->buf
, 0);
10985 result
= packet_ok (rs
->buf
,
10986 &remote_protocol_packets
[PACKET_qCRC
]);
10987 if (result
== PACKET_ERROR
)
10989 else if (result
== PACKET_OK
)
10991 for (target_crc
= 0, tmp
= &rs
->buf
[1]; *tmp
; tmp
++)
10992 target_crc
= target_crc
* 16 + fromhex (*tmp
);
10994 return (host_crc
== target_crc
);
10998 return simple_verify_memory (this, data
, lma
, size
);
11001 /* compare-sections command
11003 With no arguments, compares each loadable section in the exec bfd
11004 with the same memory range on the target, and reports mismatches.
11005 Useful for verifying the image on the target against the exec file. */
11008 compare_sections_command (const char *args
, int from_tty
)
11011 const char *sectname
;
11012 bfd_size_type size
;
11015 int mismatched
= 0;
11019 if (!current_program_space
->exec_bfd ())
11020 error (_("command cannot be used without an exec file"));
11022 if (args
!= NULL
&& strcmp (args
, "-r") == 0)
11028 for (s
= current_program_space
->exec_bfd ()->sections
; s
; s
= s
->next
)
11030 if (!(s
->flags
& SEC_LOAD
))
11031 continue; /* Skip non-loadable section. */
11033 if (read_only
&& (s
->flags
& SEC_READONLY
) == 0)
11034 continue; /* Skip writeable sections */
11036 size
= bfd_section_size (s
);
11038 continue; /* Skip zero-length section. */
11040 sectname
= bfd_section_name (s
);
11041 if (args
&& strcmp (args
, sectname
) != 0)
11042 continue; /* Not the section selected by user. */
11044 matched
= 1; /* Do this section. */
11047 gdb::byte_vector
sectdata (size
);
11048 bfd_get_section_contents (current_program_space
->exec_bfd (), s
,
11049 sectdata
.data (), 0, size
);
11051 res
= target_verify_memory (sectdata
.data (), lma
, size
);
11054 error (_("target memory fault, section %s, range %s -- %s"), sectname
,
11055 paddress (target_gdbarch (), lma
),
11056 paddress (target_gdbarch (), lma
+ size
));
11058 gdb_printf ("Section %s, range %s -- %s: ", sectname
,
11059 paddress (target_gdbarch (), lma
),
11060 paddress (target_gdbarch (), lma
+ size
));
11062 gdb_printf ("matched.\n");
11065 gdb_printf ("MIS-MATCHED!\n");
11069 if (mismatched
> 0)
11070 warning (_("One or more sections of the target image does not match\n\
11071 the loaded file\n"));
11072 if (args
&& !matched
)
11073 gdb_printf (_("No loaded section named '%s'.\n"), args
);
11076 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
11077 into remote target. The number of bytes written to the remote
11078 target is returned, or -1 for error. */
11081 remote_target::remote_write_qxfer (const char *object_name
,
11082 const char *annex
, const gdb_byte
*writebuf
,
11083 ULONGEST offset
, LONGEST len
,
11084 ULONGEST
*xfered_len
,
11085 struct packet_config
*packet
)
11089 struct remote_state
*rs
= get_remote_state ();
11090 int max_size
= get_memory_write_packet_size ();
11092 if (packet_config_support (packet
) == PACKET_DISABLE
)
11093 return TARGET_XFER_E_IO
;
11095 /* Insert header. */
11096 i
= snprintf (rs
->buf
.data (), max_size
,
11097 "qXfer:%s:write:%s:%s:",
11098 object_name
, annex
? annex
: "",
11099 phex_nz (offset
, sizeof offset
));
11100 max_size
-= (i
+ 1);
11102 /* Escape as much data as fits into rs->buf. */
11103 buf_len
= remote_escape_output
11104 (writebuf
, len
, 1, (gdb_byte
*) rs
->buf
.data () + i
, &max_size
, max_size
);
11106 if (putpkt_binary (rs
->buf
.data (), i
+ buf_len
) < 0
11107 || getpkt_sane (&rs
->buf
, 0) < 0
11108 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11109 return TARGET_XFER_E_IO
;
11111 unpack_varlen_hex (rs
->buf
.data (), &n
);
11114 return (*xfered_len
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
11117 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
11118 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
11119 number of bytes read is returned, or 0 for EOF, or -1 for error.
11120 The number of bytes read may be less than LEN without indicating an
11121 EOF. PACKET is checked and updated to indicate whether the remote
11122 target supports this object. */
11125 remote_target::remote_read_qxfer (const char *object_name
,
11127 gdb_byte
*readbuf
, ULONGEST offset
,
11129 ULONGEST
*xfered_len
,
11130 struct packet_config
*packet
)
11132 struct remote_state
*rs
= get_remote_state ();
11133 LONGEST i
, n
, packet_len
;
11135 if (packet_config_support (packet
) == PACKET_DISABLE
)
11136 return TARGET_XFER_E_IO
;
11138 /* Check whether we've cached an end-of-object packet that matches
11140 if (rs
->finished_object
)
11142 if (strcmp (object_name
, rs
->finished_object
) == 0
11143 && strcmp (annex
? annex
: "", rs
->finished_annex
) == 0
11144 && offset
== rs
->finished_offset
)
11145 return TARGET_XFER_EOF
;
11148 /* Otherwise, we're now reading something different. Discard
11150 xfree (rs
->finished_object
);
11151 xfree (rs
->finished_annex
);
11152 rs
->finished_object
= NULL
;
11153 rs
->finished_annex
= NULL
;
11156 /* Request only enough to fit in a single packet. The actual data
11157 may not, since we don't know how much of it will need to be escaped;
11158 the target is free to respond with slightly less data. We subtract
11159 five to account for the response type and the protocol frame. */
11160 n
= std::min
<LONGEST
> (get_remote_packet_size () - 5, len
);
11161 snprintf (rs
->buf
.data (), get_remote_packet_size () - 4,
11162 "qXfer:%s:read:%s:%s,%s",
11163 object_name
, annex
? annex
: "",
11164 phex_nz (offset
, sizeof offset
),
11165 phex_nz (n
, sizeof n
));
11166 i
= putpkt (rs
->buf
);
11168 return TARGET_XFER_E_IO
;
11171 packet_len
= getpkt_sane (&rs
->buf
, 0);
11172 if (packet_len
< 0 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11173 return TARGET_XFER_E_IO
;
11175 if (rs
->buf
[0] != 'l' && rs
->buf
[0] != 'm')
11176 error (_("Unknown remote qXfer reply: %s"), rs
->buf
.data ());
11178 /* 'm' means there is (or at least might be) more data after this
11179 batch. That does not make sense unless there's at least one byte
11180 of data in this reply. */
11181 if (rs
->buf
[0] == 'm' && packet_len
== 1)
11182 error (_("Remote qXfer reply contained no data."));
11184 /* Got some data. */
11185 i
= remote_unescape_input ((gdb_byte
*) rs
->buf
.data () + 1,
11186 packet_len
- 1, readbuf
, n
);
11188 /* 'l' is an EOF marker, possibly including a final block of data,
11189 or possibly empty. If we have the final block of a non-empty
11190 object, record this fact to bypass a subsequent partial read. */
11191 if (rs
->buf
[0] == 'l' && offset
+ i
> 0)
11193 rs
->finished_object
= xstrdup (object_name
);
11194 rs
->finished_annex
= xstrdup (annex
? annex
: "");
11195 rs
->finished_offset
= offset
+ i
;
11199 return TARGET_XFER_EOF
;
11203 return TARGET_XFER_OK
;
11207 enum target_xfer_status
11208 remote_target::xfer_partial (enum target_object object
,
11209 const char *annex
, gdb_byte
*readbuf
,
11210 const gdb_byte
*writebuf
, ULONGEST offset
, ULONGEST len
,
11211 ULONGEST
*xfered_len
)
11213 struct remote_state
*rs
;
11217 int unit_size
= gdbarch_addressable_memory_unit_size (target_gdbarch ());
11219 set_remote_traceframe ();
11220 set_general_thread (inferior_ptid
);
11222 rs
= get_remote_state ();
11224 /* Handle memory using the standard memory routines. */
11225 if (object
== TARGET_OBJECT_MEMORY
)
11227 /* If the remote target is connected but not running, we should
11228 pass this request down to a lower stratum (e.g. the executable
11230 if (!target_has_execution ())
11231 return TARGET_XFER_EOF
;
11233 if (writebuf
!= NULL
)
11234 return remote_write_bytes (offset
, writebuf
, len
, unit_size
,
11237 return remote_read_bytes (offset
, readbuf
, len
, unit_size
,
11241 /* Handle extra signal info using qxfer packets. */
11242 if (object
== TARGET_OBJECT_SIGNAL_INFO
)
11245 return remote_read_qxfer ("siginfo", annex
, readbuf
, offset
, len
,
11246 xfered_len
, &remote_protocol_packets
11247 [PACKET_qXfer_siginfo_read
]);
11249 return remote_write_qxfer ("siginfo", annex
,
11250 writebuf
, offset
, len
, xfered_len
,
11251 &remote_protocol_packets
11252 [PACKET_qXfer_siginfo_write
]);
11255 if (object
== TARGET_OBJECT_STATIC_TRACE_DATA
)
11258 return remote_read_qxfer ("statictrace", annex
,
11259 readbuf
, offset
, len
, xfered_len
,
11260 &remote_protocol_packets
11261 [PACKET_qXfer_statictrace_read
]);
11263 return TARGET_XFER_E_IO
;
11266 /* Only handle flash writes. */
11267 if (writebuf
!= NULL
)
11271 case TARGET_OBJECT_FLASH
:
11272 return remote_flash_write (offset
, len
, xfered_len
,
11276 return TARGET_XFER_E_IO
;
11280 /* Map pre-existing objects onto letters. DO NOT do this for new
11281 objects!!! Instead specify new query packets. */
11284 case TARGET_OBJECT_AVR
:
11288 case TARGET_OBJECT_AUXV
:
11289 gdb_assert (annex
== NULL
);
11290 return remote_read_qxfer ("auxv", annex
, readbuf
, offset
, len
,
11292 &remote_protocol_packets
[PACKET_qXfer_auxv
]);
11294 case TARGET_OBJECT_AVAILABLE_FEATURES
:
11295 return remote_read_qxfer
11296 ("features", annex
, readbuf
, offset
, len
, xfered_len
,
11297 &remote_protocol_packets
[PACKET_qXfer_features
]);
11299 case TARGET_OBJECT_LIBRARIES
:
11300 return remote_read_qxfer
11301 ("libraries", annex
, readbuf
, offset
, len
, xfered_len
,
11302 &remote_protocol_packets
[PACKET_qXfer_libraries
]);
11304 case TARGET_OBJECT_LIBRARIES_SVR4
:
11305 return remote_read_qxfer
11306 ("libraries-svr4", annex
, readbuf
, offset
, len
, xfered_len
,
11307 &remote_protocol_packets
[PACKET_qXfer_libraries_svr4
]);
11309 case TARGET_OBJECT_MEMORY_MAP
:
11310 gdb_assert (annex
== NULL
);
11311 return remote_read_qxfer ("memory-map", annex
, readbuf
, offset
, len
,
11313 &remote_protocol_packets
[PACKET_qXfer_memory_map
]);
11315 case TARGET_OBJECT_OSDATA
:
11316 /* Should only get here if we're connected. */
11317 gdb_assert (rs
->remote_desc
);
11318 return remote_read_qxfer
11319 ("osdata", annex
, readbuf
, offset
, len
, xfered_len
,
11320 &remote_protocol_packets
[PACKET_qXfer_osdata
]);
11322 case TARGET_OBJECT_THREADS
:
11323 gdb_assert (annex
== NULL
);
11324 return remote_read_qxfer ("threads", annex
, readbuf
, offset
, len
,
11326 &remote_protocol_packets
[PACKET_qXfer_threads
]);
11328 case TARGET_OBJECT_TRACEFRAME_INFO
:
11329 gdb_assert (annex
== NULL
);
11330 return remote_read_qxfer
11331 ("traceframe-info", annex
, readbuf
, offset
, len
, xfered_len
,
11332 &remote_protocol_packets
[PACKET_qXfer_traceframe_info
]);
11334 case TARGET_OBJECT_FDPIC
:
11335 return remote_read_qxfer ("fdpic", annex
, readbuf
, offset
, len
,
11337 &remote_protocol_packets
[PACKET_qXfer_fdpic
]);
11339 case TARGET_OBJECT_OPENVMS_UIB
:
11340 return remote_read_qxfer ("uib", annex
, readbuf
, offset
, len
,
11342 &remote_protocol_packets
[PACKET_qXfer_uib
]);
11344 case TARGET_OBJECT_BTRACE
:
11345 return remote_read_qxfer ("btrace", annex
, readbuf
, offset
, len
,
11347 &remote_protocol_packets
[PACKET_qXfer_btrace
]);
11349 case TARGET_OBJECT_BTRACE_CONF
:
11350 return remote_read_qxfer ("btrace-conf", annex
, readbuf
, offset
,
11352 &remote_protocol_packets
[PACKET_qXfer_btrace_conf
]);
11354 case TARGET_OBJECT_EXEC_FILE
:
11355 return remote_read_qxfer ("exec-file", annex
, readbuf
, offset
,
11357 &remote_protocol_packets
[PACKET_qXfer_exec_file
]);
11360 return TARGET_XFER_E_IO
;
11363 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
11364 large enough let the caller deal with it. */
11365 if (len
< get_remote_packet_size ())
11366 return TARGET_XFER_E_IO
;
11367 len
= get_remote_packet_size ();
11369 /* Except for querying the minimum buffer size, target must be open. */
11370 if (!rs
->remote_desc
)
11371 error (_("remote query is only available after target open"));
11373 gdb_assert (annex
!= NULL
);
11374 gdb_assert (readbuf
!= NULL
);
11376 p2
= rs
->buf
.data ();
11378 *p2
++ = query_type
;
11380 /* We used one buffer char for the remote protocol q command and
11381 another for the query type. As the remote protocol encapsulation
11382 uses 4 chars plus one extra in case we are debugging
11383 (remote_debug), we have PBUFZIZ - 7 left to pack the query
11386 while (annex
[i
] && (i
< (get_remote_packet_size () - 8)))
11388 /* Bad caller may have sent forbidden characters. */
11389 gdb_assert (isprint (annex
[i
]) && annex
[i
] != '$' && annex
[i
] != '#');
11394 gdb_assert (annex
[i
] == '\0');
11396 i
= putpkt (rs
->buf
);
11398 return TARGET_XFER_E_IO
;
11400 getpkt (&rs
->buf
, 0);
11401 strcpy ((char *) readbuf
, rs
->buf
.data ());
11403 *xfered_len
= strlen ((char *) readbuf
);
11404 return (*xfered_len
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
11407 /* Implementation of to_get_memory_xfer_limit. */
11410 remote_target::get_memory_xfer_limit ()
11412 return get_memory_write_packet_size ();
11416 remote_target::search_memory (CORE_ADDR start_addr
, ULONGEST search_space_len
,
11417 const gdb_byte
*pattern
, ULONGEST pattern_len
,
11418 CORE_ADDR
*found_addrp
)
11420 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
11421 struct remote_state
*rs
= get_remote_state ();
11422 int max_size
= get_memory_write_packet_size ();
11423 struct packet_config
*packet
=
11424 &remote_protocol_packets
[PACKET_qSearch_memory
];
11425 /* Number of packet bytes used to encode the pattern;
11426 this could be more than PATTERN_LEN due to escape characters. */
11427 int escaped_pattern_len
;
11428 /* Amount of pattern that was encodable in the packet. */
11429 int used_pattern_len
;
11432 ULONGEST found_addr
;
11434 auto read_memory
= [=] (CORE_ADDR addr
, gdb_byte
*result
, size_t len
)
11436 return (target_read (this, TARGET_OBJECT_MEMORY
, NULL
, result
, addr
, len
)
11440 /* Don't go to the target if we don't have to. This is done before
11441 checking packet_config_support to avoid the possibility that a
11442 success for this edge case means the facility works in
11444 if (pattern_len
> search_space_len
)
11446 if (pattern_len
== 0)
11448 *found_addrp
= start_addr
;
11452 /* If we already know the packet isn't supported, fall back to the simple
11453 way of searching memory. */
11455 if (packet_config_support (packet
) == PACKET_DISABLE
)
11457 /* Target doesn't provided special support, fall back and use the
11458 standard support (copy memory and do the search here). */
11459 return simple_search_memory (read_memory
, start_addr
, search_space_len
,
11460 pattern
, pattern_len
, found_addrp
);
11463 /* Make sure the remote is pointing at the right process. */
11464 set_general_process ();
11466 /* Insert header. */
11467 i
= snprintf (rs
->buf
.data (), max_size
,
11468 "qSearch:memory:%s;%s;",
11469 phex_nz (start_addr
, addr_size
),
11470 phex_nz (search_space_len
, sizeof (search_space_len
)));
11471 max_size
-= (i
+ 1);
11473 /* Escape as much data as fits into rs->buf. */
11474 escaped_pattern_len
=
11475 remote_escape_output (pattern
, pattern_len
, 1,
11476 (gdb_byte
*) rs
->buf
.data () + i
,
11477 &used_pattern_len
, max_size
);
11479 /* Bail if the pattern is too large. */
11480 if (used_pattern_len
!= pattern_len
)
11481 error (_("Pattern is too large to transmit to remote target."));
11483 if (putpkt_binary (rs
->buf
.data (), i
+ escaped_pattern_len
) < 0
11484 || getpkt_sane (&rs
->buf
, 0) < 0
11485 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11487 /* The request may not have worked because the command is not
11488 supported. If so, fall back to the simple way. */
11489 if (packet_config_support (packet
) == PACKET_DISABLE
)
11491 return simple_search_memory (read_memory
, start_addr
, search_space_len
,
11492 pattern
, pattern_len
, found_addrp
);
11497 if (rs
->buf
[0] == '0')
11499 else if (rs
->buf
[0] == '1')
11502 if (rs
->buf
[1] != ',')
11503 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
.data ());
11504 unpack_varlen_hex (&rs
->buf
[2], &found_addr
);
11505 *found_addrp
= found_addr
;
11508 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
.data ());
11514 remote_target::rcmd (const char *command
, struct ui_file
*outbuf
)
11516 struct remote_state
*rs
= get_remote_state ();
11517 char *p
= rs
->buf
.data ();
11519 if (!rs
->remote_desc
)
11520 error (_("remote rcmd is only available after target open"));
11522 /* Send a NULL command across as an empty command. */
11523 if (command
== NULL
)
11526 /* The query prefix. */
11527 strcpy (rs
->buf
.data (), "qRcmd,");
11528 p
= strchr (rs
->buf
.data (), '\0');
11530 if ((strlen (rs
->buf
.data ()) + strlen (command
) * 2 + 8/*misc*/)
11531 > get_remote_packet_size ())
11532 error (_("\"monitor\" command ``%s'' is too long."), command
);
11534 /* Encode the actual command. */
11535 bin2hex ((const gdb_byte
*) command
, p
, strlen (command
));
11537 if (putpkt (rs
->buf
) < 0)
11538 error (_("Communication problem with target."));
11540 /* get/display the response */
11545 /* XXX - see also remote_get_noisy_reply(). */
11546 QUIT
; /* Allow user to bail out with ^C. */
11548 if (getpkt_sane (&rs
->buf
, 0) == -1)
11550 /* Timeout. Continue to (try to) read responses.
11551 This is better than stopping with an error, assuming the stub
11552 is still executing the (long) monitor command.
11553 If needed, the user can interrupt gdb using C-c, obtaining
11554 an effect similar to stop on timeout. */
11557 buf
= rs
->buf
.data ();
11558 if (buf
[0] == '\0')
11559 error (_("Target does not support this command."));
11560 if (buf
[0] == 'O' && buf
[1] != 'K')
11562 remote_console_output (buf
+ 1); /* 'O' message from stub. */
11565 if (strcmp (buf
, "OK") == 0)
11567 if (strlen (buf
) == 3 && buf
[0] == 'E'
11568 && isxdigit (buf
[1]) && isxdigit (buf
[2]))
11570 error (_("Protocol error with Rcmd"));
11572 for (p
= buf
; p
[0] != '\0' && p
[1] != '\0'; p
+= 2)
11574 char c
= (fromhex (p
[0]) << 4) + fromhex (p
[1]);
11576 gdb_putc (c
, outbuf
);
11582 std::vector
<mem_region
>
11583 remote_target::memory_map ()
11585 std::vector
<mem_region
> result
;
11586 gdb::optional
<gdb::char_vector
> text
11587 = target_read_stralloc (current_inferior ()->top_target (),
11588 TARGET_OBJECT_MEMORY_MAP
, NULL
);
11591 result
= parse_memory_map (text
->data ());
11596 /* Set of callbacks used to implement the 'maint packet' command. */
11598 struct cli_packet_command_callbacks
: public send_remote_packet_callbacks
11600 /* Called before the packet is sent. BUF is the packet content before
11601 the protocol specific prefix, suffix, and escaping is added. */
11603 void sending (gdb::array_view
<const char> &buf
) override
11605 gdb_puts ("sending: ");
11606 print_packet (buf
);
11610 /* Called with BUF, the reply from the remote target. */
11612 void received (gdb::array_view
<const char> &buf
) override
11614 gdb_puts ("received: \"");
11615 print_packet (buf
);
11621 /* Print BUF o gdb_stdout. Any non-printable bytes in BUF are printed as
11622 '\x??' with '??' replaced by the hexadecimal value of the byte. */
11625 print_packet (gdb::array_view
<const char> &buf
)
11629 for (int i
= 0; i
< buf
.size (); ++i
)
11631 gdb_byte c
= buf
[i
];
11633 gdb_putc (c
, &stb
);
11635 gdb_printf (&stb
, "\\x%02x", (unsigned char) c
);
11638 gdb_puts (stb
.string ().c_str ());
11642 /* See remote.h. */
11645 send_remote_packet (gdb::array_view
<const char> &buf
,
11646 send_remote_packet_callbacks
*callbacks
)
11648 if (buf
.size () == 0 || buf
.data ()[0] == '\0')
11649 error (_("a remote packet must not be empty"));
11651 remote_target
*remote
= get_current_remote_target ();
11652 if (remote
== nullptr)
11653 error (_("packets can only be sent to a remote target"));
11655 callbacks
->sending (buf
);
11657 remote
->putpkt_binary (buf
.data (), buf
.size ());
11658 remote_state
*rs
= remote
->get_remote_state ();
11659 int bytes
= remote
->getpkt_sane (&rs
->buf
, 0);
11662 error (_("error while fetching packet from remote target"));
11664 gdb::array_view
<const char> view (&rs
->buf
[0], bytes
);
11665 callbacks
->received (view
);
11668 /* Entry point for the 'maint packet' command. */
11671 cli_packet_command (const char *args
, int from_tty
)
11673 cli_packet_command_callbacks cb
;
11674 gdb::array_view
<const char> view
11675 = gdb::make_array_view (args
, args
== nullptr ? 0 : strlen (args
));
11676 send_remote_packet (view
, &cb
);
11680 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
11682 static void display_thread_info (struct gdb_ext_thread_info
*info
);
11684 static void threadset_test_cmd (char *cmd
, int tty
);
11686 static void threadalive_test (char *cmd
, int tty
);
11688 static void threadlist_test_cmd (char *cmd
, int tty
);
11690 int get_and_display_threadinfo (threadref
*ref
);
11692 static void threadinfo_test_cmd (char *cmd
, int tty
);
11694 static int thread_display_step (threadref
*ref
, void *context
);
11696 static void threadlist_update_test_cmd (char *cmd
, int tty
);
11698 static void init_remote_threadtests (void);
11700 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
11703 threadset_test_cmd (const char *cmd
, int tty
)
11705 int sample_thread
= SAMPLE_THREAD
;
11707 gdb_printf (_("Remote threadset test\n"));
11708 set_general_thread (sample_thread
);
11713 threadalive_test (const char *cmd
, int tty
)
11715 int sample_thread
= SAMPLE_THREAD
;
11716 int pid
= inferior_ptid
.pid ();
11717 ptid_t ptid
= ptid_t (pid
, sample_thread
, 0);
11719 if (remote_thread_alive (ptid
))
11720 gdb_printf ("PASS: Thread alive test\n");
11722 gdb_printf ("FAIL: Thread alive test\n");
11725 void output_threadid (char *title
, threadref
*ref
);
11728 output_threadid (char *title
, threadref
*ref
)
11732 pack_threadid (&hexid
[0], ref
); /* Convert thread id into hex. */
11734 gdb_printf ("%s %s\n", title
, (&hexid
[0]));
11738 threadlist_test_cmd (const char *cmd
, int tty
)
11741 threadref nextthread
;
11742 int done
, result_count
;
11743 threadref threadlist
[3];
11745 gdb_printf ("Remote Threadlist test\n");
11746 if (!remote_get_threadlist (startflag
, &nextthread
, 3, &done
,
11747 &result_count
, &threadlist
[0]))
11748 gdb_printf ("FAIL: threadlist test\n");
11751 threadref
*scan
= threadlist
;
11752 threadref
*limit
= scan
+ result_count
;
11754 while (scan
< limit
)
11755 output_threadid (" thread ", scan
++);
11760 display_thread_info (struct gdb_ext_thread_info
*info
)
11762 output_threadid ("Threadid: ", &info
->threadid
);
11763 gdb_printf ("Name: %s\n ", info
->shortname
);
11764 gdb_printf ("State: %s\n", info
->display
);
11765 gdb_printf ("other: %s\n\n", info
->more_display
);
11769 get_and_display_threadinfo (threadref
*ref
)
11773 struct gdb_ext_thread_info threadinfo
;
11775 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
11776 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
11777 if (0 != (result
= remote_get_threadinfo (ref
, set
, &threadinfo
)))
11778 display_thread_info (&threadinfo
);
11783 threadinfo_test_cmd (const char *cmd
, int tty
)
11785 int athread
= SAMPLE_THREAD
;
11789 int_to_threadref (&thread
, athread
);
11790 gdb_printf ("Remote Threadinfo test\n");
11791 if (!get_and_display_threadinfo (&thread
))
11792 gdb_printf ("FAIL cannot get thread info\n");
11796 thread_display_step (threadref
*ref
, void *context
)
11798 /* output_threadid(" threadstep ",ref); *//* simple test */
11799 return get_and_display_threadinfo (ref
);
11803 threadlist_update_test_cmd (const char *cmd
, int tty
)
11805 gdb_printf ("Remote Threadlist update test\n");
11806 remote_threadlist_iterator (thread_display_step
, 0, CRAZY_MAX_THREADS
);
11810 init_remote_threadtests (void)
11812 add_com ("tlist", class_obscure
, threadlist_test_cmd
,
11813 _("Fetch and print the remote list of "
11814 "thread identifiers, one pkt only."));
11815 add_com ("tinfo", class_obscure
, threadinfo_test_cmd
,
11816 _("Fetch and display info about one thread."));
11817 add_com ("tset", class_obscure
, threadset_test_cmd
,
11818 _("Test setting to a different thread."));
11819 add_com ("tupd", class_obscure
, threadlist_update_test_cmd
,
11820 _("Iterate through updating all remote thread info."));
11821 add_com ("talive", class_obscure
, threadalive_test
,
11822 _("Remote thread alive test."));
11827 /* Convert a thread ID to a string. */
11830 remote_target::pid_to_str (ptid_t ptid
)
11832 struct remote_state
*rs
= get_remote_state ();
11834 if (ptid
== null_ptid
)
11835 return normal_pid_to_str (ptid
);
11836 else if (ptid
.is_pid ())
11838 /* Printing an inferior target id. */
11840 /* When multi-process extensions are off, there's no way in the
11841 remote protocol to know the remote process id, if there's any
11842 at all. There's one exception --- when we're connected with
11843 target extended-remote, and we manually attached to a process
11844 with "attach PID". We don't record anywhere a flag that
11845 allows us to distinguish that case from the case of
11846 connecting with extended-remote and the stub already being
11847 attached to a process, and reporting yes to qAttached, hence
11848 no smart special casing here. */
11849 if (!remote_multi_process_p (rs
))
11850 return "Remote target";
11852 return normal_pid_to_str (ptid
);
11856 if (magic_null_ptid
== ptid
)
11857 return "Thread <main>";
11858 else if (remote_multi_process_p (rs
))
11859 if (ptid
.lwp () == 0)
11860 return normal_pid_to_str (ptid
);
11862 return string_printf ("Thread %d.%ld",
11863 ptid
.pid (), ptid
.lwp ());
11865 return string_printf ("Thread %ld", ptid
.lwp ());
11869 /* Get the address of the thread local variable in OBJFILE which is
11870 stored at OFFSET within the thread local storage for thread PTID. */
11873 remote_target::get_thread_local_address (ptid_t ptid
, CORE_ADDR lm
,
11876 if (packet_support (PACKET_qGetTLSAddr
) != PACKET_DISABLE
)
11878 struct remote_state
*rs
= get_remote_state ();
11879 char *p
= rs
->buf
.data ();
11880 char *endp
= p
+ get_remote_packet_size ();
11881 enum packet_result result
;
11883 strcpy (p
, "qGetTLSAddr:");
11885 p
= write_ptid (p
, endp
, ptid
);
11887 p
+= hexnumstr (p
, offset
);
11889 p
+= hexnumstr (p
, lm
);
11893 getpkt (&rs
->buf
, 0);
11894 result
= packet_ok (rs
->buf
,
11895 &remote_protocol_packets
[PACKET_qGetTLSAddr
]);
11896 if (result
== PACKET_OK
)
11900 unpack_varlen_hex (rs
->buf
.data (), &addr
);
11903 else if (result
== PACKET_UNKNOWN
)
11904 throw_error (TLS_GENERIC_ERROR
,
11905 _("Remote target doesn't support qGetTLSAddr packet"));
11907 throw_error (TLS_GENERIC_ERROR
,
11908 _("Remote target failed to process qGetTLSAddr request"));
11911 throw_error (TLS_GENERIC_ERROR
,
11912 _("TLS not supported or disabled on this target"));
11917 /* Provide thread local base, i.e. Thread Information Block address.
11918 Returns 1 if ptid is found and thread_local_base is non zero. */
11921 remote_target::get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
)
11923 if (packet_support (PACKET_qGetTIBAddr
) != PACKET_DISABLE
)
11925 struct remote_state
*rs
= get_remote_state ();
11926 char *p
= rs
->buf
.data ();
11927 char *endp
= p
+ get_remote_packet_size ();
11928 enum packet_result result
;
11930 strcpy (p
, "qGetTIBAddr:");
11932 p
= write_ptid (p
, endp
, ptid
);
11936 getpkt (&rs
->buf
, 0);
11937 result
= packet_ok (rs
->buf
,
11938 &remote_protocol_packets
[PACKET_qGetTIBAddr
]);
11939 if (result
== PACKET_OK
)
11942 unpack_varlen_hex (rs
->buf
.data (), &val
);
11944 *addr
= (CORE_ADDR
) val
;
11947 else if (result
== PACKET_UNKNOWN
)
11948 error (_("Remote target doesn't support qGetTIBAddr packet"));
11950 error (_("Remote target failed to process qGetTIBAddr request"));
11953 error (_("qGetTIBAddr not supported or disabled on this target"));
11958 /* Support for inferring a target description based on the current
11959 architecture and the size of a 'g' packet. While the 'g' packet
11960 can have any size (since optional registers can be left off the
11961 end), some sizes are easily recognizable given knowledge of the
11962 approximate architecture. */
11964 struct remote_g_packet_guess
11966 remote_g_packet_guess (int bytes_
, const struct target_desc
*tdesc_
)
11973 const struct target_desc
*tdesc
;
11976 struct remote_g_packet_data
: public allocate_on_obstack
11978 std::vector
<remote_g_packet_guess
> guesses
;
11981 static struct gdbarch_data
*remote_g_packet_data_handle
;
11984 remote_g_packet_data_init (struct obstack
*obstack
)
11986 return new (obstack
) remote_g_packet_data
;
11990 register_remote_g_packet_guess (struct gdbarch
*gdbarch
, int bytes
,
11991 const struct target_desc
*tdesc
)
11993 struct remote_g_packet_data
*data
11994 = ((struct remote_g_packet_data
*)
11995 gdbarch_data (gdbarch
, remote_g_packet_data_handle
));
11997 gdb_assert (tdesc
!= NULL
);
11999 for (const remote_g_packet_guess
&guess
: data
->guesses
)
12000 if (guess
.bytes
== bytes
)
12001 internal_error (__FILE__
, __LINE__
,
12002 _("Duplicate g packet description added for size %d"),
12005 data
->guesses
.emplace_back (bytes
, tdesc
);
12008 /* Return true if remote_read_description would do anything on this target
12009 and architecture, false otherwise. */
12012 remote_read_description_p (struct target_ops
*target
)
12014 struct remote_g_packet_data
*data
12015 = ((struct remote_g_packet_data
*)
12016 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
));
12018 return !data
->guesses
.empty ();
12021 const struct target_desc
*
12022 remote_target::read_description ()
12024 struct remote_g_packet_data
*data
12025 = ((struct remote_g_packet_data
*)
12026 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
));
12028 /* Do not try this during initial connection, when we do not know
12029 whether there is a running but stopped thread. */
12030 if (!target_has_execution () || inferior_ptid
== null_ptid
)
12031 return beneath ()->read_description ();
12033 if (!data
->guesses
.empty ())
12035 int bytes
= send_g_packet ();
12037 for (const remote_g_packet_guess
&guess
: data
->guesses
)
12038 if (guess
.bytes
== bytes
)
12039 return guess
.tdesc
;
12041 /* We discard the g packet. A minor optimization would be to
12042 hold on to it, and fill the register cache once we have selected
12043 an architecture, but it's too tricky to do safely. */
12046 return beneath ()->read_description ();
12049 /* Remote file transfer support. This is host-initiated I/O, not
12050 target-initiated; for target-initiated, see remote-fileio.c. */
12052 /* If *LEFT is at least the length of STRING, copy STRING to
12053 *BUFFER, update *BUFFER to point to the new end of the buffer, and
12054 decrease *LEFT. Otherwise raise an error. */
12057 remote_buffer_add_string (char **buffer
, int *left
, const char *string
)
12059 int len
= strlen (string
);
12062 error (_("Packet too long for target."));
12064 memcpy (*buffer
, string
, len
);
12068 /* NUL-terminate the buffer as a convenience, if there is
12074 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
12075 *BUFFER, update *BUFFER to point to the new end of the buffer, and
12076 decrease *LEFT. Otherwise raise an error. */
12079 remote_buffer_add_bytes (char **buffer
, int *left
, const gdb_byte
*bytes
,
12082 if (2 * len
> *left
)
12083 error (_("Packet too long for target."));
12085 bin2hex (bytes
, *buffer
, len
);
12086 *buffer
+= 2 * len
;
12089 /* NUL-terminate the buffer as a convenience, if there is
12095 /* If *LEFT is large enough, convert VALUE to hex and add it to
12096 *BUFFER, update *BUFFER to point to the new end of the buffer, and
12097 decrease *LEFT. Otherwise raise an error. */
12100 remote_buffer_add_int (char **buffer
, int *left
, ULONGEST value
)
12102 int len
= hexnumlen (value
);
12105 error (_("Packet too long for target."));
12107 hexnumstr (*buffer
, value
);
12111 /* NUL-terminate the buffer as a convenience, if there is
12117 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
12118 value, *REMOTE_ERRNO to the remote error number or zero if none
12119 was included, and *ATTACHMENT to point to the start of the annex
12120 if any. The length of the packet isn't needed here; there may
12121 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
12123 Return 0 if the packet could be parsed, -1 if it could not. If
12124 -1 is returned, the other variables may not be initialized. */
12127 remote_hostio_parse_result (const char *buffer
, int *retcode
,
12128 int *remote_errno
, const char **attachment
)
12133 *attachment
= NULL
;
12135 if (buffer
[0] != 'F')
12139 *retcode
= strtol (&buffer
[1], &p
, 16);
12140 if (errno
!= 0 || p
== &buffer
[1])
12143 /* Check for ",errno". */
12147 *remote_errno
= strtol (p
+ 1, &p2
, 16);
12148 if (errno
!= 0 || p
+ 1 == p2
)
12153 /* Check for ";attachment". If there is no attachment, the
12154 packet should end here. */
12157 *attachment
= p
+ 1;
12160 else if (*p
== '\0')
12166 /* Send a prepared I/O packet to the target and read its response.
12167 The prepared packet is in the global RS->BUF before this function
12168 is called, and the answer is there when we return.
12170 COMMAND_BYTES is the length of the request to send, which may include
12171 binary data. WHICH_PACKET is the packet configuration to check
12172 before attempting a packet. If an error occurs, *REMOTE_ERRNO
12173 is set to the error number and -1 is returned. Otherwise the value
12174 returned by the function is returned.
12176 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
12177 attachment is expected; an error will be reported if there's a
12178 mismatch. If one is found, *ATTACHMENT will be set to point into
12179 the packet buffer and *ATTACHMENT_LEN will be set to the
12180 attachment's length. */
12183 remote_target::remote_hostio_send_command (int command_bytes
, int which_packet
,
12184 int *remote_errno
, const char **attachment
,
12185 int *attachment_len
)
12187 struct remote_state
*rs
= get_remote_state ();
12188 int ret
, bytes_read
;
12189 const char *attachment_tmp
;
12191 if (packet_support (which_packet
) == PACKET_DISABLE
)
12193 *remote_errno
= FILEIO_ENOSYS
;
12197 putpkt_binary (rs
->buf
.data (), command_bytes
);
12198 bytes_read
= getpkt_sane (&rs
->buf
, 0);
12200 /* If it timed out, something is wrong. Don't try to parse the
12202 if (bytes_read
< 0)
12204 *remote_errno
= FILEIO_EINVAL
;
12208 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[which_packet
]))
12211 *remote_errno
= FILEIO_EINVAL
;
12213 case PACKET_UNKNOWN
:
12214 *remote_errno
= FILEIO_ENOSYS
;
12220 if (remote_hostio_parse_result (rs
->buf
.data (), &ret
, remote_errno
,
12223 *remote_errno
= FILEIO_EINVAL
;
12227 /* Make sure we saw an attachment if and only if we expected one. */
12228 if ((attachment_tmp
== NULL
&& attachment
!= NULL
)
12229 || (attachment_tmp
!= NULL
&& attachment
== NULL
))
12231 *remote_errno
= FILEIO_EINVAL
;
12235 /* If an attachment was found, it must point into the packet buffer;
12236 work out how many bytes there were. */
12237 if (attachment_tmp
!= NULL
)
12239 *attachment
= attachment_tmp
;
12240 *attachment_len
= bytes_read
- (*attachment
- rs
->buf
.data ());
12246 /* See declaration.h. */
12249 readahead_cache::invalidate ()
12254 /* See declaration.h. */
12257 readahead_cache::invalidate_fd (int fd
)
12259 if (this->fd
== fd
)
12263 /* Set the filesystem remote_hostio functions that take FILENAME
12264 arguments will use. Return 0 on success, or -1 if an error
12265 occurs (and set *REMOTE_ERRNO). */
12268 remote_target::remote_hostio_set_filesystem (struct inferior
*inf
,
12271 struct remote_state
*rs
= get_remote_state ();
12272 int required_pid
= (inf
== NULL
|| inf
->fake_pid_p
) ? 0 : inf
->pid
;
12273 char *p
= rs
->buf
.data ();
12274 int left
= get_remote_packet_size () - 1;
12278 if (packet_support (PACKET_vFile_setfs
) == PACKET_DISABLE
)
12281 if (rs
->fs_pid
!= -1 && required_pid
== rs
->fs_pid
)
12284 remote_buffer_add_string (&p
, &left
, "vFile:setfs:");
12286 xsnprintf (arg
, sizeof (arg
), "%x", required_pid
);
12287 remote_buffer_add_string (&p
, &left
, arg
);
12289 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_setfs
,
12290 remote_errno
, NULL
, NULL
);
12292 if (packet_support (PACKET_vFile_setfs
) == PACKET_DISABLE
)
12296 rs
->fs_pid
= required_pid
;
12301 /* Implementation of to_fileio_open. */
12304 remote_target::remote_hostio_open (inferior
*inf
, const char *filename
,
12305 int flags
, int mode
, int warn_if_slow
,
12308 struct remote_state
*rs
= get_remote_state ();
12309 char *p
= rs
->buf
.data ();
12310 int left
= get_remote_packet_size () - 1;
12314 static int warning_issued
= 0;
12316 gdb_printf (_("Reading %s from remote target...\n"),
12319 if (!warning_issued
)
12321 warning (_("File transfers from remote targets can be slow."
12322 " Use \"set sysroot\" to access files locally"
12324 warning_issued
= 1;
12328 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12331 remote_buffer_add_string (&p
, &left
, "vFile:open:");
12333 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12334 strlen (filename
));
12335 remote_buffer_add_string (&p
, &left
, ",");
12337 remote_buffer_add_int (&p
, &left
, flags
);
12338 remote_buffer_add_string (&p
, &left
, ",");
12340 remote_buffer_add_int (&p
, &left
, mode
);
12342 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_open
,
12343 remote_errno
, NULL
, NULL
);
12347 remote_target::fileio_open (struct inferior
*inf
, const char *filename
,
12348 int flags
, int mode
, int warn_if_slow
,
12351 return remote_hostio_open (inf
, filename
, flags
, mode
, warn_if_slow
,
12355 /* Implementation of to_fileio_pwrite. */
12358 remote_target::remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
12359 ULONGEST offset
, int *remote_errno
)
12361 struct remote_state
*rs
= get_remote_state ();
12362 char *p
= rs
->buf
.data ();
12363 int left
= get_remote_packet_size ();
12366 rs
->readahead_cache
.invalidate_fd (fd
);
12368 remote_buffer_add_string (&p
, &left
, "vFile:pwrite:");
12370 remote_buffer_add_int (&p
, &left
, fd
);
12371 remote_buffer_add_string (&p
, &left
, ",");
12373 remote_buffer_add_int (&p
, &left
, offset
);
12374 remote_buffer_add_string (&p
, &left
, ",");
12376 p
+= remote_escape_output (write_buf
, len
, 1, (gdb_byte
*) p
, &out_len
,
12377 (get_remote_packet_size ()
12378 - (p
- rs
->buf
.data ())));
12380 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_pwrite
,
12381 remote_errno
, NULL
, NULL
);
12385 remote_target::fileio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
12386 ULONGEST offset
, int *remote_errno
)
12388 return remote_hostio_pwrite (fd
, write_buf
, len
, offset
, remote_errno
);
12391 /* Helper for the implementation of to_fileio_pread. Read the file
12392 from the remote side with vFile:pread. */
12395 remote_target::remote_hostio_pread_vFile (int fd
, gdb_byte
*read_buf
, int len
,
12396 ULONGEST offset
, int *remote_errno
)
12398 struct remote_state
*rs
= get_remote_state ();
12399 char *p
= rs
->buf
.data ();
12400 const char *attachment
;
12401 int left
= get_remote_packet_size ();
12402 int ret
, attachment_len
;
12405 remote_buffer_add_string (&p
, &left
, "vFile:pread:");
12407 remote_buffer_add_int (&p
, &left
, fd
);
12408 remote_buffer_add_string (&p
, &left
, ",");
12410 remote_buffer_add_int (&p
, &left
, len
);
12411 remote_buffer_add_string (&p
, &left
, ",");
12413 remote_buffer_add_int (&p
, &left
, offset
);
12415 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_pread
,
12416 remote_errno
, &attachment
,
12422 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12424 if (read_len
!= ret
)
12425 error (_("Read returned %d, but %d bytes."), ret
, (int) read_len
);
12430 /* See declaration.h. */
12433 readahead_cache::pread (int fd
, gdb_byte
*read_buf
, size_t len
,
12437 && this->offset
<= offset
12438 && offset
< this->offset
+ this->bufsize
)
12440 ULONGEST max
= this->offset
+ this->bufsize
;
12442 if (offset
+ len
> max
)
12443 len
= max
- offset
;
12445 memcpy (read_buf
, this->buf
+ offset
- this->offset
, len
);
12452 /* Implementation of to_fileio_pread. */
12455 remote_target::remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
12456 ULONGEST offset
, int *remote_errno
)
12459 struct remote_state
*rs
= get_remote_state ();
12460 readahead_cache
*cache
= &rs
->readahead_cache
;
12462 ret
= cache
->pread (fd
, read_buf
, len
, offset
);
12465 cache
->hit_count
++;
12467 remote_debug_printf ("readahead cache hit %s",
12468 pulongest (cache
->hit_count
));
12472 cache
->miss_count
++;
12474 remote_debug_printf ("readahead cache miss %s",
12475 pulongest (cache
->miss_count
));
12478 cache
->offset
= offset
;
12479 cache
->bufsize
= get_remote_packet_size ();
12480 cache
->buf
= (gdb_byte
*) xrealloc (cache
->buf
, cache
->bufsize
);
12482 ret
= remote_hostio_pread_vFile (cache
->fd
, cache
->buf
, cache
->bufsize
,
12483 cache
->offset
, remote_errno
);
12486 cache
->invalidate_fd (fd
);
12490 cache
->bufsize
= ret
;
12491 return cache
->pread (fd
, read_buf
, len
, offset
);
12495 remote_target::fileio_pread (int fd
, gdb_byte
*read_buf
, int len
,
12496 ULONGEST offset
, int *remote_errno
)
12498 return remote_hostio_pread (fd
, read_buf
, len
, offset
, remote_errno
);
12501 /* Implementation of to_fileio_close. */
12504 remote_target::remote_hostio_close (int fd
, int *remote_errno
)
12506 struct remote_state
*rs
= get_remote_state ();
12507 char *p
= rs
->buf
.data ();
12508 int left
= get_remote_packet_size () - 1;
12510 rs
->readahead_cache
.invalidate_fd (fd
);
12512 remote_buffer_add_string (&p
, &left
, "vFile:close:");
12514 remote_buffer_add_int (&p
, &left
, fd
);
12516 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_close
,
12517 remote_errno
, NULL
, NULL
);
12521 remote_target::fileio_close (int fd
, int *remote_errno
)
12523 return remote_hostio_close (fd
, remote_errno
);
12526 /* Implementation of to_fileio_unlink. */
12529 remote_target::remote_hostio_unlink (inferior
*inf
, const char *filename
,
12532 struct remote_state
*rs
= get_remote_state ();
12533 char *p
= rs
->buf
.data ();
12534 int left
= get_remote_packet_size () - 1;
12536 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12539 remote_buffer_add_string (&p
, &left
, "vFile:unlink:");
12541 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12542 strlen (filename
));
12544 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_unlink
,
12545 remote_errno
, NULL
, NULL
);
12549 remote_target::fileio_unlink (struct inferior
*inf
, const char *filename
,
12552 return remote_hostio_unlink (inf
, filename
, remote_errno
);
12555 /* Implementation of to_fileio_readlink. */
12557 gdb::optional
<std::string
>
12558 remote_target::fileio_readlink (struct inferior
*inf
, const char *filename
,
12561 struct remote_state
*rs
= get_remote_state ();
12562 char *p
= rs
->buf
.data ();
12563 const char *attachment
;
12564 int left
= get_remote_packet_size ();
12565 int len
, attachment_len
;
12568 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12571 remote_buffer_add_string (&p
, &left
, "vFile:readlink:");
12573 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12574 strlen (filename
));
12576 len
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_readlink
,
12577 remote_errno
, &attachment
,
12583 std::string
ret (len
, '\0');
12585 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12586 (gdb_byte
*) &ret
[0], len
);
12587 if (read_len
!= len
)
12588 error (_("Readlink returned %d, but %d bytes."), len
, read_len
);
12593 /* Implementation of to_fileio_fstat. */
12596 remote_target::fileio_fstat (int fd
, struct stat
*st
, int *remote_errno
)
12598 struct remote_state
*rs
= get_remote_state ();
12599 char *p
= rs
->buf
.data ();
12600 int left
= get_remote_packet_size ();
12601 int attachment_len
, ret
;
12602 const char *attachment
;
12603 struct fio_stat fst
;
12606 remote_buffer_add_string (&p
, &left
, "vFile:fstat:");
12608 remote_buffer_add_int (&p
, &left
, fd
);
12610 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_fstat
,
12611 remote_errno
, &attachment
,
12615 if (*remote_errno
!= FILEIO_ENOSYS
)
12618 /* Strictly we should return -1, ENOSYS here, but when
12619 "set sysroot remote:" was implemented in August 2008
12620 BFD's need for a stat function was sidestepped with
12621 this hack. This was not remedied until March 2015
12622 so we retain the previous behavior to avoid breaking
12625 Note that the memset is a March 2015 addition; older
12626 GDBs set st_size *and nothing else* so the structure
12627 would have garbage in all other fields. This might
12628 break something but retaining the previous behavior
12629 here would be just too wrong. */
12631 memset (st
, 0, sizeof (struct stat
));
12632 st
->st_size
= INT_MAX
;
12636 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12637 (gdb_byte
*) &fst
, sizeof (fst
));
12639 if (read_len
!= ret
)
12640 error (_("vFile:fstat returned %d, but %d bytes."), ret
, read_len
);
12642 if (read_len
!= sizeof (fst
))
12643 error (_("vFile:fstat returned %d bytes, but expecting %d."),
12644 read_len
, (int) sizeof (fst
));
12646 remote_fileio_to_host_stat (&fst
, st
);
12651 /* Implementation of to_filesystem_is_local. */
12654 remote_target::filesystem_is_local ()
12656 /* Valgrind GDB presents itself as a remote target but works
12657 on the local filesystem: it does not implement remote get
12658 and users are not expected to set a sysroot. To handle
12659 this case we treat the remote filesystem as local if the
12660 sysroot is exactly TARGET_SYSROOT_PREFIX and if the stub
12661 does not support vFile:open. */
12662 if (gdb_sysroot
== TARGET_SYSROOT_PREFIX
)
12664 enum packet_support ps
= packet_support (PACKET_vFile_open
);
12666 if (ps
== PACKET_SUPPORT_UNKNOWN
)
12668 int fd
, remote_errno
;
12670 /* Try opening a file to probe support. The supplied
12671 filename is irrelevant, we only care about whether
12672 the stub recognizes the packet or not. */
12673 fd
= remote_hostio_open (NULL
, "just probing",
12674 FILEIO_O_RDONLY
, 0700, 0,
12678 remote_hostio_close (fd
, &remote_errno
);
12680 ps
= packet_support (PACKET_vFile_open
);
12683 if (ps
== PACKET_DISABLE
)
12685 static int warning_issued
= 0;
12687 if (!warning_issued
)
12689 warning (_("remote target does not support file"
12690 " transfer, attempting to access files"
12691 " from local filesystem."));
12692 warning_issued
= 1;
12703 remote_fileio_errno_to_host (int errnum
)
12709 case FILEIO_ENOENT
:
12717 case FILEIO_EACCES
:
12719 case FILEIO_EFAULT
:
12723 case FILEIO_EEXIST
:
12725 case FILEIO_ENODEV
:
12727 case FILEIO_ENOTDIR
:
12729 case FILEIO_EISDIR
:
12731 case FILEIO_EINVAL
:
12733 case FILEIO_ENFILE
:
12735 case FILEIO_EMFILE
:
12739 case FILEIO_ENOSPC
:
12741 case FILEIO_ESPIPE
:
12745 case FILEIO_ENOSYS
:
12747 case FILEIO_ENAMETOOLONG
:
12748 return ENAMETOOLONG
;
12754 remote_hostio_error (int errnum
)
12756 int host_error
= remote_fileio_errno_to_host (errnum
);
12758 if (host_error
== -1)
12759 error (_("Unknown remote I/O error %d"), errnum
);
12761 error (_("Remote I/O error: %s"), safe_strerror (host_error
));
12764 /* A RAII wrapper around a remote file descriptor. */
12766 class scoped_remote_fd
12769 scoped_remote_fd (remote_target
*remote
, int fd
)
12770 : m_remote (remote
), m_fd (fd
)
12774 ~scoped_remote_fd ()
12781 m_remote
->remote_hostio_close (m_fd
, &remote_errno
);
12785 /* Swallow exception before it escapes the dtor. If
12786 something goes wrong, likely the connection is gone,
12787 and there's nothing else that can be done. */
12792 DISABLE_COPY_AND_ASSIGN (scoped_remote_fd
);
12794 /* Release ownership of the file descriptor, and return it. */
12795 ATTRIBUTE_UNUSED_RESULT
int release () noexcept
12802 /* Return the owned file descriptor. */
12803 int get () const noexcept
12809 /* The remote target. */
12810 remote_target
*m_remote
;
12812 /* The owned remote I/O file descriptor. */
12817 remote_file_put (const char *local_file
, const char *remote_file
, int from_tty
)
12819 remote_target
*remote
= get_current_remote_target ();
12821 if (remote
== nullptr)
12822 error (_("command can only be used with remote target"));
12824 remote
->remote_file_put (local_file
, remote_file
, from_tty
);
12828 remote_target::remote_file_put (const char *local_file
, const char *remote_file
,
12831 int retcode
, remote_errno
, bytes
, io_size
;
12832 int bytes_in_buffer
;
12836 gdb_file_up file
= gdb_fopen_cloexec (local_file
, "rb");
12838 perror_with_name (local_file
);
12840 scoped_remote_fd fd
12841 (this, remote_hostio_open (NULL
,
12842 remote_file
, (FILEIO_O_WRONLY
| FILEIO_O_CREAT
12844 0700, 0, &remote_errno
));
12845 if (fd
.get () == -1)
12846 remote_hostio_error (remote_errno
);
12848 /* Send up to this many bytes at once. They won't all fit in the
12849 remote packet limit, so we'll transfer slightly fewer. */
12850 io_size
= get_remote_packet_size ();
12851 gdb::byte_vector
buffer (io_size
);
12853 bytes_in_buffer
= 0;
12856 while (bytes_in_buffer
|| !saw_eof
)
12860 bytes
= fread (buffer
.data () + bytes_in_buffer
, 1,
12861 io_size
- bytes_in_buffer
,
12865 if (ferror (file
.get ()))
12866 error (_("Error reading %s."), local_file
);
12869 /* EOF. Unless there is something still in the
12870 buffer from the last iteration, we are done. */
12872 if (bytes_in_buffer
== 0)
12880 bytes
+= bytes_in_buffer
;
12881 bytes_in_buffer
= 0;
12883 retcode
= remote_hostio_pwrite (fd
.get (), buffer
.data (), bytes
,
12884 offset
, &remote_errno
);
12887 remote_hostio_error (remote_errno
);
12888 else if (retcode
== 0)
12889 error (_("Remote write of %d bytes returned 0!"), bytes
);
12890 else if (retcode
< bytes
)
12892 /* Short write. Save the rest of the read data for the next
12894 bytes_in_buffer
= bytes
- retcode
;
12895 memmove (buffer
.data (), buffer
.data () + retcode
, bytes_in_buffer
);
12901 if (remote_hostio_close (fd
.release (), &remote_errno
))
12902 remote_hostio_error (remote_errno
);
12905 gdb_printf (_("Successfully sent file \"%s\".\n"), local_file
);
12909 remote_file_get (const char *remote_file
, const char *local_file
, int from_tty
)
12911 remote_target
*remote
= get_current_remote_target ();
12913 if (remote
== nullptr)
12914 error (_("command can only be used with remote target"));
12916 remote
->remote_file_get (remote_file
, local_file
, from_tty
);
12920 remote_target::remote_file_get (const char *remote_file
, const char *local_file
,
12923 int remote_errno
, bytes
, io_size
;
12926 scoped_remote_fd fd
12927 (this, remote_hostio_open (NULL
,
12928 remote_file
, FILEIO_O_RDONLY
, 0, 0,
12930 if (fd
.get () == -1)
12931 remote_hostio_error (remote_errno
);
12933 gdb_file_up file
= gdb_fopen_cloexec (local_file
, "wb");
12935 perror_with_name (local_file
);
12937 /* Send up to this many bytes at once. They won't all fit in the
12938 remote packet limit, so we'll transfer slightly fewer. */
12939 io_size
= get_remote_packet_size ();
12940 gdb::byte_vector
buffer (io_size
);
12945 bytes
= remote_hostio_pread (fd
.get (), buffer
.data (), io_size
, offset
,
12948 /* Success, but no bytes, means end-of-file. */
12951 remote_hostio_error (remote_errno
);
12955 bytes
= fwrite (buffer
.data (), 1, bytes
, file
.get ());
12957 perror_with_name (local_file
);
12960 if (remote_hostio_close (fd
.release (), &remote_errno
))
12961 remote_hostio_error (remote_errno
);
12964 gdb_printf (_("Successfully fetched file \"%s\".\n"), remote_file
);
12968 remote_file_delete (const char *remote_file
, int from_tty
)
12970 remote_target
*remote
= get_current_remote_target ();
12972 if (remote
== nullptr)
12973 error (_("command can only be used with remote target"));
12975 remote
->remote_file_delete (remote_file
, from_tty
);
12979 remote_target::remote_file_delete (const char *remote_file
, int from_tty
)
12981 int retcode
, remote_errno
;
12983 retcode
= remote_hostio_unlink (NULL
, remote_file
, &remote_errno
);
12985 remote_hostio_error (remote_errno
);
12988 gdb_printf (_("Successfully deleted file \"%s\".\n"), remote_file
);
12992 remote_put_command (const char *args
, int from_tty
)
12995 error_no_arg (_("file to put"));
12997 gdb_argv
argv (args
);
12998 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
12999 error (_("Invalid parameters to remote put"));
13001 remote_file_put (argv
[0], argv
[1], from_tty
);
13005 remote_get_command (const char *args
, int from_tty
)
13008 error_no_arg (_("file to get"));
13010 gdb_argv
argv (args
);
13011 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
13012 error (_("Invalid parameters to remote get"));
13014 remote_file_get (argv
[0], argv
[1], from_tty
);
13018 remote_delete_command (const char *args
, int from_tty
)
13021 error_no_arg (_("file to delete"));
13023 gdb_argv
argv (args
);
13024 if (argv
[0] == NULL
|| argv
[1] != NULL
)
13025 error (_("Invalid parameters to remote delete"));
13027 remote_file_delete (argv
[0], from_tty
);
13031 remote_target::can_execute_reverse ()
13033 if (packet_support (PACKET_bs
) == PACKET_ENABLE
13034 || packet_support (PACKET_bc
) == PACKET_ENABLE
)
13041 remote_target::supports_non_stop ()
13047 remote_target::supports_disable_randomization ()
13049 /* Only supported in extended mode. */
13054 remote_target::supports_multi_process ()
13056 struct remote_state
*rs
= get_remote_state ();
13058 return remote_multi_process_p (rs
);
13062 remote_supports_cond_tracepoints ()
13064 return packet_support (PACKET_ConditionalTracepoints
) == PACKET_ENABLE
;
13068 remote_target::supports_evaluation_of_breakpoint_conditions ()
13070 return packet_support (PACKET_ConditionalBreakpoints
) == PACKET_ENABLE
;
13074 remote_supports_fast_tracepoints ()
13076 return packet_support (PACKET_FastTracepoints
) == PACKET_ENABLE
;
13080 remote_supports_static_tracepoints ()
13082 return packet_support (PACKET_StaticTracepoints
) == PACKET_ENABLE
;
13086 remote_supports_install_in_trace ()
13088 return packet_support (PACKET_InstallInTrace
) == PACKET_ENABLE
;
13092 remote_target::supports_enable_disable_tracepoint ()
13094 return (packet_support (PACKET_EnableDisableTracepoints_feature
)
13099 remote_target::supports_string_tracing ()
13101 return packet_support (PACKET_tracenz_feature
) == PACKET_ENABLE
;
13105 remote_target::can_run_breakpoint_commands ()
13107 return packet_support (PACKET_BreakpointCommands
) == PACKET_ENABLE
;
13111 remote_target::trace_init ()
13113 struct remote_state
*rs
= get_remote_state ();
13116 remote_get_noisy_reply ();
13117 if (strcmp (rs
->buf
.data (), "OK") != 0)
13118 error (_("Target does not support this command."));
13121 /* Recursive routine to walk through command list including loops, and
13122 download packets for each command. */
13125 remote_target::remote_download_command_source (int num
, ULONGEST addr
,
13126 struct command_line
*cmds
)
13128 struct remote_state
*rs
= get_remote_state ();
13129 struct command_line
*cmd
;
13131 for (cmd
= cmds
; cmd
; cmd
= cmd
->next
)
13133 QUIT
; /* Allow user to bail out with ^C. */
13134 strcpy (rs
->buf
.data (), "QTDPsrc:");
13135 encode_source_string (num
, addr
, "cmd", cmd
->line
,
13136 rs
->buf
.data () + strlen (rs
->buf
.data ()),
13137 rs
->buf
.size () - strlen (rs
->buf
.data ()));
13139 remote_get_noisy_reply ();
13140 if (strcmp (rs
->buf
.data (), "OK"))
13141 warning (_("Target does not support source download."));
13143 if (cmd
->control_type
== while_control
13144 || cmd
->control_type
== while_stepping_control
)
13146 remote_download_command_source (num
, addr
, cmd
->body_list_0
.get ());
13148 QUIT
; /* Allow user to bail out with ^C. */
13149 strcpy (rs
->buf
.data (), "QTDPsrc:");
13150 encode_source_string (num
, addr
, "cmd", "end",
13151 rs
->buf
.data () + strlen (rs
->buf
.data ()),
13152 rs
->buf
.size () - strlen (rs
->buf
.data ()));
13154 remote_get_noisy_reply ();
13155 if (strcmp (rs
->buf
.data (), "OK"))
13156 warning (_("Target does not support source download."));
13162 remote_target::download_tracepoint (struct bp_location
*loc
)
13166 std::vector
<std::string
> tdp_actions
;
13167 std::vector
<std::string
> stepping_actions
;
13169 struct breakpoint
*b
= loc
->owner
;
13170 struct tracepoint
*t
= (struct tracepoint
*) b
;
13171 struct remote_state
*rs
= get_remote_state ();
13173 const char *err_msg
= _("Tracepoint packet too large for target.");
13176 /* We use a buffer other than rs->buf because we'll build strings
13177 across multiple statements, and other statements in between could
13179 gdb::char_vector
buf (get_remote_packet_size ());
13181 encode_actions_rsp (loc
, &tdp_actions
, &stepping_actions
);
13183 tpaddr
= loc
->address
;
13184 strcpy (addrbuf
, phex (tpaddr
, sizeof (CORE_ADDR
)));
13185 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:%x:%s:%c:%lx:%x",
13186 b
->number
, addrbuf
, /* address */
13187 (b
->enable_state
== bp_enabled
? 'E' : 'D'),
13188 t
->step_count
, t
->pass_count
);
13190 if (ret
< 0 || ret
>= buf
.size ())
13191 error ("%s", err_msg
);
13193 /* Fast tracepoints are mostly handled by the target, but we can
13194 tell the target how big of an instruction block should be moved
13196 if (b
->type
== bp_fast_tracepoint
)
13198 /* Only test for support at download time; we may not know
13199 target capabilities at definition time. */
13200 if (remote_supports_fast_tracepoints ())
13202 if (gdbarch_fast_tracepoint_valid_at (loc
->gdbarch
, tpaddr
,
13205 size_left
= buf
.size () - strlen (buf
.data ());
13206 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13208 gdb_insn_length (loc
->gdbarch
, tpaddr
));
13210 if (ret
< 0 || ret
>= size_left
)
13211 error ("%s", err_msg
);
13214 /* If it passed validation at definition but fails now,
13215 something is very wrong. */
13216 internal_error (__FILE__
, __LINE__
,
13217 _("Fast tracepoint not "
13218 "valid during download"));
13221 /* Fast tracepoints are functionally identical to regular
13222 tracepoints, so don't take lack of support as a reason to
13223 give up on the trace run. */
13224 warning (_("Target does not support fast tracepoints, "
13225 "downloading %d as regular tracepoint"), b
->number
);
13227 else if (b
->type
== bp_static_tracepoint
)
13229 /* Only test for support at download time; we may not know
13230 target capabilities at definition time. */
13231 if (remote_supports_static_tracepoints ())
13233 struct static_tracepoint_marker marker
;
13235 if (target_static_tracepoint_marker_at (tpaddr
, &marker
))
13237 size_left
= buf
.size () - strlen (buf
.data ());
13238 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13241 if (ret
< 0 || ret
>= size_left
)
13242 error ("%s", err_msg
);
13245 error (_("Static tracepoint not valid during download"));
13248 /* Fast tracepoints are functionally identical to regular
13249 tracepoints, so don't take lack of support as a reason
13250 to give up on the trace run. */
13251 error (_("Target does not support static tracepoints"));
13253 /* If the tracepoint has a conditional, make it into an agent
13254 expression and append to the definition. */
13257 /* Only test support at download time, we may not know target
13258 capabilities at definition time. */
13259 if (remote_supports_cond_tracepoints ())
13261 agent_expr_up aexpr
= gen_eval_for_expr (tpaddr
,
13264 size_left
= buf
.size () - strlen (buf
.data ());
13266 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13267 size_left
, ":X%x,", aexpr
->len
);
13269 if (ret
< 0 || ret
>= size_left
)
13270 error ("%s", err_msg
);
13272 size_left
= buf
.size () - strlen (buf
.data ());
13274 /* Two bytes to encode each aexpr byte, plus the terminating
13276 if (aexpr
->len
* 2 + 1 > size_left
)
13277 error ("%s", err_msg
);
13279 pkt
= buf
.data () + strlen (buf
.data ());
13281 for (int ndx
= 0; ndx
< aexpr
->len
; ++ndx
)
13282 pkt
= pack_hex_byte (pkt
, aexpr
->buf
[ndx
]);
13286 warning (_("Target does not support conditional tracepoints, "
13287 "ignoring tp %d cond"), b
->number
);
13290 if (b
->commands
|| !default_collect
.empty ())
13292 size_left
= buf
.size () - strlen (buf
.data ());
13294 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13297 if (ret
< 0 || ret
>= size_left
)
13298 error ("%s", err_msg
);
13301 putpkt (buf
.data ());
13302 remote_get_noisy_reply ();
13303 if (strcmp (rs
->buf
.data (), "OK"))
13304 error (_("Target does not support tracepoints."));
13306 /* do_single_steps (t); */
13307 for (auto action_it
= tdp_actions
.begin ();
13308 action_it
!= tdp_actions
.end (); action_it
++)
13310 QUIT
; /* Allow user to bail out with ^C. */
13312 bool has_more
= ((action_it
+ 1) != tdp_actions
.end ()
13313 || !stepping_actions
.empty ());
13315 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:-%x:%s:%s%c",
13316 b
->number
, addrbuf
, /* address */
13317 action_it
->c_str (),
13318 has_more
? '-' : 0);
13320 if (ret
< 0 || ret
>= buf
.size ())
13321 error ("%s", err_msg
);
13323 putpkt (buf
.data ());
13324 remote_get_noisy_reply ();
13325 if (strcmp (rs
->buf
.data (), "OK"))
13326 error (_("Error on target while setting tracepoints."));
13329 for (auto action_it
= stepping_actions
.begin ();
13330 action_it
!= stepping_actions
.end (); action_it
++)
13332 QUIT
; /* Allow user to bail out with ^C. */
13334 bool is_first
= action_it
== stepping_actions
.begin ();
13335 bool has_more
= (action_it
+ 1) != stepping_actions
.end ();
13337 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:-%x:%s:%s%s%s",
13338 b
->number
, addrbuf
, /* address */
13339 is_first
? "S" : "",
13340 action_it
->c_str (),
13341 has_more
? "-" : "");
13343 if (ret
< 0 || ret
>= buf
.size ())
13344 error ("%s", err_msg
);
13346 putpkt (buf
.data ());
13347 remote_get_noisy_reply ();
13348 if (strcmp (rs
->buf
.data (), "OK"))
13349 error (_("Error on target while setting tracepoints."));
13352 if (packet_support (PACKET_TracepointSource
) == PACKET_ENABLE
)
13354 if (b
->location
!= NULL
)
13356 ret
= snprintf (buf
.data (), buf
.size (), "QTDPsrc:");
13358 if (ret
< 0 || ret
>= buf
.size ())
13359 error ("%s", err_msg
);
13361 encode_source_string (b
->number
, loc
->address
, "at",
13362 event_location_to_string (b
->location
.get ()),
13363 buf
.data () + strlen (buf
.data ()),
13364 buf
.size () - strlen (buf
.data ()));
13365 putpkt (buf
.data ());
13366 remote_get_noisy_reply ();
13367 if (strcmp (rs
->buf
.data (), "OK"))
13368 warning (_("Target does not support source download."));
13370 if (b
->cond_string
)
13372 ret
= snprintf (buf
.data (), buf
.size (), "QTDPsrc:");
13374 if (ret
< 0 || ret
>= buf
.size ())
13375 error ("%s", err_msg
);
13377 encode_source_string (b
->number
, loc
->address
,
13378 "cond", b
->cond_string
.get (),
13379 buf
.data () + strlen (buf
.data ()),
13380 buf
.size () - strlen (buf
.data ()));
13381 putpkt (buf
.data ());
13382 remote_get_noisy_reply ();
13383 if (strcmp (rs
->buf
.data (), "OK"))
13384 warning (_("Target does not support source download."));
13386 remote_download_command_source (b
->number
, loc
->address
,
13387 breakpoint_commands (b
));
13392 remote_target::can_download_tracepoint ()
13394 struct remote_state
*rs
= get_remote_state ();
13395 struct trace_status
*ts
;
13398 /* Don't try to install tracepoints until we've relocated our
13399 symbols, and fetched and merged the target's tracepoint list with
13401 if (rs
->starting_up
)
13404 ts
= current_trace_status ();
13405 status
= get_trace_status (ts
);
13407 if (status
== -1 || !ts
->running_known
|| !ts
->running
)
13410 /* If we are in a tracing experiment, but remote stub doesn't support
13411 installing tracepoint in trace, we have to return. */
13412 if (!remote_supports_install_in_trace ())
13420 remote_target::download_trace_state_variable (const trace_state_variable
&tsv
)
13422 struct remote_state
*rs
= get_remote_state ();
13425 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTDV:%x:%s:%x:",
13426 tsv
.number
, phex ((ULONGEST
) tsv
.initial_value
, 8),
13428 p
= rs
->buf
.data () + strlen (rs
->buf
.data ());
13429 if ((p
- rs
->buf
.data ()) + tsv
.name
.length () * 2
13430 >= get_remote_packet_size ())
13431 error (_("Trace state variable name too long for tsv definition packet"));
13432 p
+= 2 * bin2hex ((gdb_byte
*) (tsv
.name
.data ()), p
, tsv
.name
.length ());
13435 remote_get_noisy_reply ();
13436 if (rs
->buf
[0] == '\0')
13437 error (_("Target does not support this command."));
13438 if (strcmp (rs
->buf
.data (), "OK") != 0)
13439 error (_("Error on target while downloading trace state variable."));
13443 remote_target::enable_tracepoint (struct bp_location
*location
)
13445 struct remote_state
*rs
= get_remote_state ();
13447 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTEnable:%x:%s",
13448 location
->owner
->number
,
13449 phex (location
->address
, sizeof (CORE_ADDR
)));
13451 remote_get_noisy_reply ();
13452 if (rs
->buf
[0] == '\0')
13453 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
13454 if (strcmp (rs
->buf
.data (), "OK") != 0)
13455 error (_("Error on target while enabling tracepoint."));
13459 remote_target::disable_tracepoint (struct bp_location
*location
)
13461 struct remote_state
*rs
= get_remote_state ();
13463 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTDisable:%x:%s",
13464 location
->owner
->number
,
13465 phex (location
->address
, sizeof (CORE_ADDR
)));
13467 remote_get_noisy_reply ();
13468 if (rs
->buf
[0] == '\0')
13469 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
13470 if (strcmp (rs
->buf
.data (), "OK") != 0)
13471 error (_("Error on target while disabling tracepoint."));
13475 remote_target::trace_set_readonly_regions ()
13478 bfd_size_type size
;
13483 if (!current_program_space
->exec_bfd ())
13484 return; /* No information to give. */
13486 struct remote_state
*rs
= get_remote_state ();
13488 strcpy (rs
->buf
.data (), "QTro");
13489 offset
= strlen (rs
->buf
.data ());
13490 for (s
= current_program_space
->exec_bfd ()->sections
; s
; s
= s
->next
)
13492 char tmp1
[40], tmp2
[40];
13495 if ((s
->flags
& SEC_LOAD
) == 0 ||
13496 /* (s->flags & SEC_CODE) == 0 || */
13497 (s
->flags
& SEC_READONLY
) == 0)
13501 vma
= bfd_section_vma (s
);
13502 size
= bfd_section_size (s
);
13503 sprintf_vma (tmp1
, vma
);
13504 sprintf_vma (tmp2
, vma
+ size
);
13505 sec_length
= 1 + strlen (tmp1
) + 1 + strlen (tmp2
);
13506 if (offset
+ sec_length
+ 1 > rs
->buf
.size ())
13508 if (packet_support (PACKET_qXfer_traceframe_info
) != PACKET_ENABLE
)
13510 Too many sections for read-only sections definition packet."));
13513 xsnprintf (rs
->buf
.data () + offset
, rs
->buf
.size () - offset
, ":%s,%s",
13515 offset
+= sec_length
;
13520 getpkt (&rs
->buf
, 0);
13525 remote_target::trace_start ()
13527 struct remote_state
*rs
= get_remote_state ();
13529 putpkt ("QTStart");
13530 remote_get_noisy_reply ();
13531 if (rs
->buf
[0] == '\0')
13532 error (_("Target does not support this command."));
13533 if (strcmp (rs
->buf
.data (), "OK") != 0)
13534 error (_("Bogus reply from target: %s"), rs
->buf
.data ());
13538 remote_target::get_trace_status (struct trace_status
*ts
)
13540 /* Initialize it just to avoid a GCC false warning. */
13542 enum packet_result result
;
13543 struct remote_state
*rs
= get_remote_state ();
13545 if (packet_support (PACKET_qTStatus
) == PACKET_DISABLE
)
13548 /* FIXME we need to get register block size some other way. */
13549 trace_regblock_size
13550 = rs
->get_remote_arch_state (target_gdbarch ())->sizeof_g_packet
;
13552 putpkt ("qTStatus");
13556 p
= remote_get_noisy_reply ();
13558 catch (const gdb_exception_error
&ex
)
13560 if (ex
.error
!= TARGET_CLOSE_ERROR
)
13562 exception_fprintf (gdb_stderr
, ex
, "qTStatus: ");
13568 result
= packet_ok (p
, &remote_protocol_packets
[PACKET_qTStatus
]);
13570 /* If the remote target doesn't do tracing, flag it. */
13571 if (result
== PACKET_UNKNOWN
)
13574 /* We're working with a live target. */
13575 ts
->filename
= NULL
;
13578 error (_("Bogus trace status reply from target: %s"), rs
->buf
.data ());
13580 /* Function 'parse_trace_status' sets default value of each field of
13581 'ts' at first, so we don't have to do it here. */
13582 parse_trace_status (p
, ts
);
13584 return ts
->running
;
13588 remote_target::get_tracepoint_status (struct breakpoint
*bp
,
13589 struct uploaded_tp
*utp
)
13591 struct remote_state
*rs
= get_remote_state ();
13593 struct tracepoint
*tp
= (struct tracepoint
*) bp
;
13594 size_t size
= get_remote_packet_size ();
13599 tp
->traceframe_usage
= 0;
13600 for (bp_location
*loc
: tp
->locations ())
13602 /* If the tracepoint was never downloaded, don't go asking for
13604 if (tp
->number_on_target
== 0)
13606 xsnprintf (rs
->buf
.data (), size
, "qTP:%x:%s", tp
->number_on_target
,
13607 phex_nz (loc
->address
, 0));
13609 reply
= remote_get_noisy_reply ();
13610 if (reply
&& *reply
)
13613 parse_tracepoint_status (reply
+ 1, bp
, utp
);
13619 utp
->hit_count
= 0;
13620 utp
->traceframe_usage
= 0;
13621 xsnprintf (rs
->buf
.data (), size
, "qTP:%x:%s", utp
->number
,
13622 phex_nz (utp
->addr
, 0));
13624 reply
= remote_get_noisy_reply ();
13625 if (reply
&& *reply
)
13628 parse_tracepoint_status (reply
+ 1, bp
, utp
);
13634 remote_target::trace_stop ()
13636 struct remote_state
*rs
= get_remote_state ();
13639 remote_get_noisy_reply ();
13640 if (rs
->buf
[0] == '\0')
13641 error (_("Target does not support this command."));
13642 if (strcmp (rs
->buf
.data (), "OK") != 0)
13643 error (_("Bogus reply from target: %s"), rs
->buf
.data ());
13647 remote_target::trace_find (enum trace_find_type type
, int num
,
13648 CORE_ADDR addr1
, CORE_ADDR addr2
,
13651 struct remote_state
*rs
= get_remote_state ();
13652 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
13654 int target_frameno
= -1, target_tracept
= -1;
13656 /* Lookups other than by absolute frame number depend on the current
13657 trace selected, so make sure it is correct on the remote end
13659 if (type
!= tfind_number
)
13660 set_remote_traceframe ();
13662 p
= rs
->buf
.data ();
13663 strcpy (p
, "QTFrame:");
13664 p
= strchr (p
, '\0');
13668 xsnprintf (p
, endbuf
- p
, "%x", num
);
13671 xsnprintf (p
, endbuf
- p
, "pc:%s", phex_nz (addr1
, 0));
13674 xsnprintf (p
, endbuf
- p
, "tdp:%x", num
);
13677 xsnprintf (p
, endbuf
- p
, "range:%s:%s", phex_nz (addr1
, 0),
13678 phex_nz (addr2
, 0));
13680 case tfind_outside
:
13681 xsnprintf (p
, endbuf
- p
, "outside:%s:%s", phex_nz (addr1
, 0),
13682 phex_nz (addr2
, 0));
13685 error (_("Unknown trace find type %d"), type
);
13689 reply
= remote_get_noisy_reply ();
13690 if (*reply
== '\0')
13691 error (_("Target does not support this command."));
13693 while (reply
&& *reply
)
13698 target_frameno
= (int) strtol (p
, &reply
, 16);
13700 error (_("Unable to parse trace frame number"));
13701 /* Don't update our remote traceframe number cache on failure
13702 to select a remote traceframe. */
13703 if (target_frameno
== -1)
13708 target_tracept
= (int) strtol (p
, &reply
, 16);
13710 error (_("Unable to parse tracepoint number"));
13712 case 'O': /* "OK"? */
13713 if (reply
[1] == 'K' && reply
[2] == '\0')
13716 error (_("Bogus reply from target: %s"), reply
);
13719 error (_("Bogus reply from target: %s"), reply
);
13722 *tpp
= target_tracept
;
13724 rs
->remote_traceframe_number
= target_frameno
;
13725 return target_frameno
;
13729 remote_target::get_trace_state_variable_value (int tsvnum
, LONGEST
*val
)
13731 struct remote_state
*rs
= get_remote_state ();
13735 set_remote_traceframe ();
13737 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qTV:%x", tsvnum
);
13739 reply
= remote_get_noisy_reply ();
13740 if (reply
&& *reply
)
13744 unpack_varlen_hex (reply
+ 1, &uval
);
13745 *val
= (LONGEST
) uval
;
13753 remote_target::save_trace_data (const char *filename
)
13755 struct remote_state
*rs
= get_remote_state ();
13758 p
= rs
->buf
.data ();
13759 strcpy (p
, "QTSave:");
13761 if ((p
- rs
->buf
.data ()) + strlen (filename
) * 2
13762 >= get_remote_packet_size ())
13763 error (_("Remote file name too long for trace save packet"));
13764 p
+= 2 * bin2hex ((gdb_byte
*) filename
, p
, strlen (filename
));
13767 reply
= remote_get_noisy_reply ();
13768 if (*reply
== '\0')
13769 error (_("Target does not support this command."));
13770 if (strcmp (reply
, "OK") != 0)
13771 error (_("Bogus reply from target: %s"), reply
);
13775 /* This is basically a memory transfer, but needs to be its own packet
13776 because we don't know how the target actually organizes its trace
13777 memory, plus we want to be able to ask for as much as possible, but
13778 not be unhappy if we don't get as much as we ask for. */
13781 remote_target::get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
)
13783 struct remote_state
*rs
= get_remote_state ();
13788 p
= rs
->buf
.data ();
13789 strcpy (p
, "qTBuffer:");
13791 p
+= hexnumstr (p
, offset
);
13793 p
+= hexnumstr (p
, len
);
13797 reply
= remote_get_noisy_reply ();
13798 if (reply
&& *reply
)
13800 /* 'l' by itself means we're at the end of the buffer and
13801 there is nothing more to get. */
13805 /* Convert the reply into binary. Limit the number of bytes to
13806 convert according to our passed-in buffer size, rather than
13807 what was returned in the packet; if the target is
13808 unexpectedly generous and gives us a bigger reply than we
13809 asked for, we don't want to crash. */
13810 rslt
= hex2bin (reply
, buf
, len
);
13814 /* Something went wrong, flag as an error. */
13819 remote_target::set_disconnected_tracing (int val
)
13821 struct remote_state
*rs
= get_remote_state ();
13823 if (packet_support (PACKET_DisconnectedTracing_feature
) == PACKET_ENABLE
)
13827 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
13828 "QTDisconnected:%x", val
);
13830 reply
= remote_get_noisy_reply ();
13831 if (*reply
== '\0')
13832 error (_("Target does not support this command."));
13833 if (strcmp (reply
, "OK") != 0)
13834 error (_("Bogus reply from target: %s"), reply
);
13837 warning (_("Target does not support disconnected tracing."));
13841 remote_target::core_of_thread (ptid_t ptid
)
13843 thread_info
*info
= find_thread_ptid (this, ptid
);
13845 if (info
!= NULL
&& info
->priv
!= NULL
)
13846 return get_remote_thread_info (info
)->core
;
13852 remote_target::set_circular_trace_buffer (int val
)
13854 struct remote_state
*rs
= get_remote_state ();
13857 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
13858 "QTBuffer:circular:%x", val
);
13860 reply
= remote_get_noisy_reply ();
13861 if (*reply
== '\0')
13862 error (_("Target does not support this command."));
13863 if (strcmp (reply
, "OK") != 0)
13864 error (_("Bogus reply from target: %s"), reply
);
13868 remote_target::traceframe_info ()
13870 gdb::optional
<gdb::char_vector
> text
13871 = target_read_stralloc (current_inferior ()->top_target (),
13872 TARGET_OBJECT_TRACEFRAME_INFO
,
13875 return parse_traceframe_info (text
->data ());
13880 /* Handle the qTMinFTPILen packet. Returns the minimum length of
13881 instruction on which a fast tracepoint may be placed. Returns -1
13882 if the packet is not supported, and 0 if the minimum instruction
13883 length is unknown. */
13886 remote_target::get_min_fast_tracepoint_insn_len ()
13888 struct remote_state
*rs
= get_remote_state ();
13891 /* If we're not debugging a process yet, the IPA can't be
13893 if (!target_has_execution ())
13896 /* Make sure the remote is pointing at the right process. */
13897 set_general_process ();
13899 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qTMinFTPILen");
13901 reply
= remote_get_noisy_reply ();
13902 if (*reply
== '\0')
13906 ULONGEST min_insn_len
;
13908 unpack_varlen_hex (reply
, &min_insn_len
);
13910 return (int) min_insn_len
;
13915 remote_target::set_trace_buffer_size (LONGEST val
)
13917 if (packet_support (PACKET_QTBuffer_size
) != PACKET_DISABLE
)
13919 struct remote_state
*rs
= get_remote_state ();
13920 char *buf
= rs
->buf
.data ();
13921 char *endbuf
= buf
+ get_remote_packet_size ();
13922 enum packet_result result
;
13924 gdb_assert (val
>= 0 || val
== -1);
13925 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTBuffer:size:");
13926 /* Send -1 as literal "-1" to avoid host size dependency. */
13930 buf
+= hexnumstr (buf
, (ULONGEST
) -val
);
13933 buf
+= hexnumstr (buf
, (ULONGEST
) val
);
13936 remote_get_noisy_reply ();
13937 result
= packet_ok (rs
->buf
,
13938 &remote_protocol_packets
[PACKET_QTBuffer_size
]);
13940 if (result
!= PACKET_OK
)
13941 warning (_("Bogus reply from target: %s"), rs
->buf
.data ());
13946 remote_target::set_trace_notes (const char *user
, const char *notes
,
13947 const char *stop_notes
)
13949 struct remote_state
*rs
= get_remote_state ();
13951 char *buf
= rs
->buf
.data ();
13952 char *endbuf
= buf
+ get_remote_packet_size ();
13955 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTNotes:");
13958 buf
+= xsnprintf (buf
, endbuf
- buf
, "user:");
13959 nbytes
= bin2hex ((gdb_byte
*) user
, buf
, strlen (user
));
13965 buf
+= xsnprintf (buf
, endbuf
- buf
, "notes:");
13966 nbytes
= bin2hex ((gdb_byte
*) notes
, buf
, strlen (notes
));
13972 buf
+= xsnprintf (buf
, endbuf
- buf
, "tstop:");
13973 nbytes
= bin2hex ((gdb_byte
*) stop_notes
, buf
, strlen (stop_notes
));
13977 /* Ensure the buffer is terminated. */
13981 reply
= remote_get_noisy_reply ();
13982 if (*reply
== '\0')
13985 if (strcmp (reply
, "OK") != 0)
13986 error (_("Bogus reply from target: %s"), reply
);
13992 remote_target::use_agent (bool use
)
13994 if (packet_support (PACKET_QAgent
) != PACKET_DISABLE
)
13996 struct remote_state
*rs
= get_remote_state ();
13998 /* If the stub supports QAgent. */
13999 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QAgent:%d", use
);
14001 getpkt (&rs
->buf
, 0);
14003 if (strcmp (rs
->buf
.data (), "OK") == 0)
14014 remote_target::can_use_agent ()
14016 return (packet_support (PACKET_QAgent
) != PACKET_DISABLE
);
14019 struct btrace_target_info
14021 /* The ptid of the traced thread. */
14024 /* The obtained branch trace configuration. */
14025 struct btrace_config conf
;
14028 /* Reset our idea of our target's btrace configuration. */
14031 remote_btrace_reset (remote_state
*rs
)
14033 memset (&rs
->btrace_config
, 0, sizeof (rs
->btrace_config
));
14036 /* Synchronize the configuration with the target. */
14039 remote_target::btrace_sync_conf (const btrace_config
*conf
)
14041 struct packet_config
*packet
;
14042 struct remote_state
*rs
;
14043 char *buf
, *pos
, *endbuf
;
14045 rs
= get_remote_state ();
14046 buf
= rs
->buf
.data ();
14047 endbuf
= buf
+ get_remote_packet_size ();
14049 packet
= &remote_protocol_packets
[PACKET_Qbtrace_conf_bts_size
];
14050 if (packet_config_support (packet
) == PACKET_ENABLE
14051 && conf
->bts
.size
!= rs
->btrace_config
.bts
.size
)
14054 pos
+= xsnprintf (pos
, endbuf
- pos
, "%s=0x%x", packet
->name
,
14058 getpkt (&rs
->buf
, 0);
14060 if (packet_ok (buf
, packet
) == PACKET_ERROR
)
14062 if (buf
[0] == 'E' && buf
[1] == '.')
14063 error (_("Failed to configure the BTS buffer size: %s"), buf
+ 2);
14065 error (_("Failed to configure the BTS buffer size."));
14068 rs
->btrace_config
.bts
.size
= conf
->bts
.size
;
14071 packet
= &remote_protocol_packets
[PACKET_Qbtrace_conf_pt_size
];
14072 if (packet_config_support (packet
) == PACKET_ENABLE
14073 && conf
->pt
.size
!= rs
->btrace_config
.pt
.size
)
14076 pos
+= xsnprintf (pos
, endbuf
- pos
, "%s=0x%x", packet
->name
,
14080 getpkt (&rs
->buf
, 0);
14082 if (packet_ok (buf
, packet
) == PACKET_ERROR
)
14084 if (buf
[0] == 'E' && buf
[1] == '.')
14085 error (_("Failed to configure the trace buffer size: %s"), buf
+ 2);
14087 error (_("Failed to configure the trace buffer size."));
14090 rs
->btrace_config
.pt
.size
= conf
->pt
.size
;
14094 /* Read TP's btrace configuration from the target and store it into CONF. */
14097 btrace_read_config (thread_info
*tp
, struct btrace_config
*conf
)
14099 /* target_read_stralloc relies on INFERIOR_PTID. */
14100 scoped_restore_current_thread restore_thread
;
14101 switch_to_thread (tp
);
14103 gdb::optional
<gdb::char_vector
> xml
14104 = target_read_stralloc (current_inferior ()->top_target (),
14105 TARGET_OBJECT_BTRACE_CONF
, "");
14107 parse_xml_btrace_conf (conf
, xml
->data ());
14110 /* Maybe reopen target btrace. */
14113 remote_target::remote_btrace_maybe_reopen ()
14115 struct remote_state
*rs
= get_remote_state ();
14116 int btrace_target_pushed
= 0;
14117 #if !defined (HAVE_LIBIPT)
14121 /* Don't bother walking the entirety of the remote thread list when
14122 we know the feature isn't supported by the remote. */
14123 if (packet_support (PACKET_qXfer_btrace_conf
) != PACKET_ENABLE
)
14126 for (thread_info
*tp
: all_non_exited_threads (this))
14128 memset (&rs
->btrace_config
, 0x00, sizeof (struct btrace_config
));
14129 btrace_read_config (tp
, &rs
->btrace_config
);
14131 if (rs
->btrace_config
.format
== BTRACE_FORMAT_NONE
)
14134 #if !defined (HAVE_LIBIPT)
14135 if (rs
->btrace_config
.format
== BTRACE_FORMAT_PT
)
14140 warning (_("Target is recording using Intel Processor Trace "
14141 "but support was disabled at compile time."));
14146 #endif /* !defined (HAVE_LIBIPT) */
14148 /* Push target, once, but before anything else happens. This way our
14149 changes to the threads will be cleaned up by unpushing the target
14150 in case btrace_read_config () throws. */
14151 if (!btrace_target_pushed
)
14153 btrace_target_pushed
= 1;
14154 record_btrace_push_target ();
14155 gdb_printf (_("Target is recording using %s.\n"),
14156 btrace_format_string (rs
->btrace_config
.format
));
14159 tp
->btrace
.target
= XCNEW (struct btrace_target_info
);
14160 tp
->btrace
.target
->ptid
= tp
->ptid
;
14161 tp
->btrace
.target
->conf
= rs
->btrace_config
;
14165 /* Enable branch tracing. */
14167 struct btrace_target_info
*
14168 remote_target::enable_btrace (thread_info
*tp
,
14169 const struct btrace_config
*conf
)
14171 struct btrace_target_info
*tinfo
= NULL
;
14172 struct packet_config
*packet
= NULL
;
14173 struct remote_state
*rs
= get_remote_state ();
14174 char *buf
= rs
->buf
.data ();
14175 char *endbuf
= buf
+ get_remote_packet_size ();
14177 switch (conf
->format
)
14179 case BTRACE_FORMAT_BTS
:
14180 packet
= &remote_protocol_packets
[PACKET_Qbtrace_bts
];
14183 case BTRACE_FORMAT_PT
:
14184 packet
= &remote_protocol_packets
[PACKET_Qbtrace_pt
];
14188 if (packet
== NULL
|| packet_config_support (packet
) != PACKET_ENABLE
)
14189 error (_("Target does not support branch tracing."));
14191 btrace_sync_conf (conf
);
14193 ptid_t ptid
= tp
->ptid
;
14194 set_general_thread (ptid
);
14196 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
14198 getpkt (&rs
->buf
, 0);
14200 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
14202 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
14203 error (_("Could not enable branch tracing for %s: %s"),
14204 target_pid_to_str (ptid
).c_str (), &rs
->buf
[2]);
14206 error (_("Could not enable branch tracing for %s."),
14207 target_pid_to_str (ptid
).c_str ());
14210 tinfo
= XCNEW (struct btrace_target_info
);
14211 tinfo
->ptid
= ptid
;
14213 /* If we fail to read the configuration, we lose some information, but the
14214 tracing itself is not impacted. */
14217 btrace_read_config (tp
, &tinfo
->conf
);
14219 catch (const gdb_exception_error
&err
)
14221 if (err
.message
!= NULL
)
14222 warning ("%s", err
.what ());
14228 /* Disable branch tracing. */
14231 remote_target::disable_btrace (struct btrace_target_info
*tinfo
)
14233 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_Qbtrace_off
];
14234 struct remote_state
*rs
= get_remote_state ();
14235 char *buf
= rs
->buf
.data ();
14236 char *endbuf
= buf
+ get_remote_packet_size ();
14238 if (packet_config_support (packet
) != PACKET_ENABLE
)
14239 error (_("Target does not support branch tracing."));
14241 set_general_thread (tinfo
->ptid
);
14243 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
14245 getpkt (&rs
->buf
, 0);
14247 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
14249 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
14250 error (_("Could not disable branch tracing for %s: %s"),
14251 target_pid_to_str (tinfo
->ptid
).c_str (), &rs
->buf
[2]);
14253 error (_("Could not disable branch tracing for %s."),
14254 target_pid_to_str (tinfo
->ptid
).c_str ());
14260 /* Teardown branch tracing. */
14263 remote_target::teardown_btrace (struct btrace_target_info
*tinfo
)
14265 /* We must not talk to the target during teardown. */
14269 /* Read the branch trace. */
14272 remote_target::read_btrace (struct btrace_data
*btrace
,
14273 struct btrace_target_info
*tinfo
,
14274 enum btrace_read_type type
)
14276 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_qXfer_btrace
];
14279 if (packet_config_support (packet
) != PACKET_ENABLE
)
14280 error (_("Target does not support branch tracing."));
14282 #if !defined(HAVE_LIBEXPAT)
14283 error (_("Cannot process branch tracing result. XML parsing not supported."));
14288 case BTRACE_READ_ALL
:
14291 case BTRACE_READ_NEW
:
14294 case BTRACE_READ_DELTA
:
14298 internal_error (__FILE__
, __LINE__
,
14299 _("Bad branch tracing read type: %u."),
14300 (unsigned int) type
);
14303 gdb::optional
<gdb::char_vector
> xml
14304 = target_read_stralloc (current_inferior ()->top_target (),
14305 TARGET_OBJECT_BTRACE
, annex
);
14307 return BTRACE_ERR_UNKNOWN
;
14309 parse_xml_btrace (btrace
, xml
->data ());
14311 return BTRACE_ERR_NONE
;
14314 const struct btrace_config
*
14315 remote_target::btrace_conf (const struct btrace_target_info
*tinfo
)
14317 return &tinfo
->conf
;
14321 remote_target::augmented_libraries_svr4_read ()
14323 return (packet_support (PACKET_augmented_libraries_svr4_read_feature
)
14327 /* Implementation of to_load. */
14330 remote_target::load (const char *name
, int from_tty
)
14332 generic_load (name
, from_tty
);
14335 /* Accepts an integer PID; returns a string representing a file that
14336 can be opened on the remote side to get the symbols for the child
14337 process. Returns NULL if the operation is not supported. */
14340 remote_target::pid_to_exec_file (int pid
)
14342 static gdb::optional
<gdb::char_vector
> filename
;
14343 char *annex
= NULL
;
14345 if (packet_support (PACKET_qXfer_exec_file
) != PACKET_ENABLE
)
14348 inferior
*inf
= find_inferior_pid (this, pid
);
14350 internal_error (__FILE__
, __LINE__
,
14351 _("not currently attached to process %d"), pid
);
14353 if (!inf
->fake_pid_p
)
14355 const int annex_size
= 9;
14357 annex
= (char *) alloca (annex_size
);
14358 xsnprintf (annex
, annex_size
, "%x", pid
);
14361 filename
= target_read_stralloc (current_inferior ()->top_target (),
14362 TARGET_OBJECT_EXEC_FILE
, annex
);
14364 return filename
? filename
->data () : nullptr;
14367 /* Implement the to_can_do_single_step target_ops method. */
14370 remote_target::can_do_single_step ()
14372 /* We can only tell whether target supports single step or not by
14373 supported s and S vCont actions if the stub supports vContSupported
14374 feature. If the stub doesn't support vContSupported feature,
14375 we have conservatively to think target doesn't supports single
14377 if (packet_support (PACKET_vContSupported
) == PACKET_ENABLE
)
14379 struct remote_state
*rs
= get_remote_state ();
14381 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
14382 remote_vcont_probe ();
14384 return rs
->supports_vCont
.s
&& rs
->supports_vCont
.S
;
14390 /* Implementation of the to_execution_direction method for the remote
14393 enum exec_direction_kind
14394 remote_target::execution_direction ()
14396 struct remote_state
*rs
= get_remote_state ();
14398 return rs
->last_resume_exec_dir
;
14401 /* Return pointer to the thread_info struct which corresponds to
14402 THREAD_HANDLE (having length HANDLE_LEN). */
14405 remote_target::thread_handle_to_thread_info (const gdb_byte
*thread_handle
,
14409 for (thread_info
*tp
: all_non_exited_threads (this))
14411 remote_thread_info
*priv
= get_remote_thread_info (tp
);
14413 if (tp
->inf
== inf
&& priv
!= NULL
)
14415 if (handle_len
!= priv
->thread_handle
.size ())
14416 error (_("Thread handle size mismatch: %d vs %zu (from remote)"),
14417 handle_len
, priv
->thread_handle
.size ());
14418 if (memcmp (thread_handle
, priv
->thread_handle
.data (),
14428 remote_target::thread_info_to_thread_handle (struct thread_info
*tp
)
14430 remote_thread_info
*priv
= get_remote_thread_info (tp
);
14431 return priv
->thread_handle
;
14435 remote_target::can_async_p ()
14437 /* This flag should be checked in the common target.c code. */
14438 gdb_assert (target_async_permitted
);
14440 /* We're async whenever the serial device can. */
14441 struct remote_state
*rs
= get_remote_state ();
14442 return serial_can_async_p (rs
->remote_desc
);
14446 remote_target::is_async_p ()
14448 /* We're async whenever the serial device is. */
14449 struct remote_state
*rs
= get_remote_state ();
14450 return serial_is_async_p (rs
->remote_desc
);
14453 /* Pass the SERIAL event on and up to the client. One day this code
14454 will be able to delay notifying the client of an event until the
14455 point where an entire packet has been received. */
14457 static serial_event_ftype remote_async_serial_handler
;
14460 remote_async_serial_handler (struct serial
*scb
, void *context
)
14462 /* Don't propogate error information up to the client. Instead let
14463 the client find out about the error by querying the target. */
14464 inferior_event_handler (INF_REG_EVENT
);
14468 remote_async_inferior_event_handler (gdb_client_data data
)
14470 inferior_event_handler (INF_REG_EVENT
);
14474 remote_target::async_wait_fd ()
14476 struct remote_state
*rs
= get_remote_state ();
14477 return rs
->remote_desc
->fd
;
14481 remote_target::async (int enable
)
14483 struct remote_state
*rs
= get_remote_state ();
14487 serial_async (rs
->remote_desc
, remote_async_serial_handler
, rs
);
14489 /* If there are pending events in the stop reply queue tell the
14490 event loop to process them. */
14491 if (!rs
->stop_reply_queue
.empty ())
14492 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
14493 /* For simplicity, below we clear the pending events token
14494 without remembering whether it is marked, so here we always
14495 mark it. If there's actually no pending notification to
14496 process, this ends up being a no-op (other than a spurious
14497 event-loop wakeup). */
14498 if (target_is_non_stop_p ())
14499 mark_async_event_handler (rs
->notif_state
->get_pending_events_token
);
14503 serial_async (rs
->remote_desc
, NULL
, NULL
);
14504 /* If the core is disabling async, it doesn't want to be
14505 disturbed with target events. Clear all async event sources
14507 clear_async_event_handler (rs
->remote_async_inferior_event_token
);
14508 if (target_is_non_stop_p ())
14509 clear_async_event_handler (rs
->notif_state
->get_pending_events_token
);
14513 /* Implementation of the to_thread_events method. */
14516 remote_target::thread_events (int enable
)
14518 struct remote_state
*rs
= get_remote_state ();
14519 size_t size
= get_remote_packet_size ();
14521 if (packet_support (PACKET_QThreadEvents
) == PACKET_DISABLE
)
14524 xsnprintf (rs
->buf
.data (), size
, "QThreadEvents:%x", enable
? 1 : 0);
14526 getpkt (&rs
->buf
, 0);
14528 switch (packet_ok (rs
->buf
,
14529 &remote_protocol_packets
[PACKET_QThreadEvents
]))
14532 if (strcmp (rs
->buf
.data (), "OK") != 0)
14533 error (_("Remote refused setting thread events: %s"), rs
->buf
.data ());
14536 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
14538 case PACKET_UNKNOWN
:
14544 show_remote_cmd (const char *args
, int from_tty
)
14546 /* We can't just use cmd_show_list here, because we want to skip
14547 the redundant "show remote Z-packet" and the legacy aliases. */
14548 struct cmd_list_element
*list
= remote_show_cmdlist
;
14549 struct ui_out
*uiout
= current_uiout
;
14551 ui_out_emit_tuple
tuple_emitter (uiout
, "showlist");
14552 for (; list
!= NULL
; list
= list
->next
)
14553 if (strcmp (list
->name
, "Z-packet") == 0)
14555 else if (list
->type
== not_set_cmd
)
14556 /* Alias commands are exactly like the original, except they
14557 don't have the normal type. */
14561 ui_out_emit_tuple
option_emitter (uiout
, "option");
14563 uiout
->field_string ("name", list
->name
);
14564 uiout
->text (": ");
14565 if (list
->type
== show_cmd
)
14566 do_show_command (NULL
, from_tty
, list
);
14568 cmd_func (list
, NULL
, from_tty
);
14573 /* Function to be called whenever a new objfile (shlib) is detected. */
14575 remote_new_objfile (struct objfile
*objfile
)
14577 remote_target
*remote
= get_current_remote_target ();
14579 /* First, check whether the current inferior's process target is a remote
14581 if (remote
== nullptr)
14584 /* When we are attaching or handling a fork child and the shared library
14585 subsystem reads the list of loaded libraries, we receive new objfile
14586 events in between each found library. The libraries are read in an
14587 undefined order, so if we gave the remote side a chance to look up
14588 symbols between each objfile, we might give it an inconsistent picture
14589 of the inferior. It could appear that a library A appears loaded but
14590 a library B does not, even though library A requires library B. That
14591 would present a state that couldn't normally exist in the inferior.
14593 So, skip these events, we'll give the remote a chance to look up symbols
14594 once all the loaded libraries and their symbols are known to GDB. */
14595 if (current_inferior ()->in_initial_library_scan
)
14598 remote
->remote_check_symbols ();
14601 /* Pull all the tracepoints defined on the target and create local
14602 data structures representing them. We don't want to create real
14603 tracepoints yet, we don't want to mess up the user's existing
14607 remote_target::upload_tracepoints (struct uploaded_tp
**utpp
)
14609 struct remote_state
*rs
= get_remote_state ();
14612 /* Ask for a first packet of tracepoint definition. */
14614 getpkt (&rs
->buf
, 0);
14615 p
= rs
->buf
.data ();
14616 while (*p
&& *p
!= 'l')
14618 parse_tracepoint_definition (p
, utpp
);
14619 /* Ask for another packet of tracepoint definition. */
14621 getpkt (&rs
->buf
, 0);
14622 p
= rs
->buf
.data ();
14628 remote_target::upload_trace_state_variables (struct uploaded_tsv
**utsvp
)
14630 struct remote_state
*rs
= get_remote_state ();
14633 /* Ask for a first packet of variable definition. */
14635 getpkt (&rs
->buf
, 0);
14636 p
= rs
->buf
.data ();
14637 while (*p
&& *p
!= 'l')
14639 parse_tsv_definition (p
, utsvp
);
14640 /* Ask for another packet of variable definition. */
14642 getpkt (&rs
->buf
, 0);
14643 p
= rs
->buf
.data ();
14648 /* The "set/show range-stepping" show hook. */
14651 show_range_stepping (struct ui_file
*file
, int from_tty
,
14652 struct cmd_list_element
*c
,
14656 _("Debugger's willingness to use range stepping "
14657 "is %s.\n"), value
);
14660 /* Return true if the vCont;r action is supported by the remote
14664 remote_target::vcont_r_supported ()
14666 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
14667 remote_vcont_probe ();
14669 return (packet_support (PACKET_vCont
) == PACKET_ENABLE
14670 && get_remote_state ()->supports_vCont
.r
);
14673 /* The "set/show range-stepping" set hook. */
14676 set_range_stepping (const char *ignore_args
, int from_tty
,
14677 struct cmd_list_element
*c
)
14679 /* When enabling, check whether range stepping is actually supported
14680 by the target, and warn if not. */
14681 if (use_range_stepping
)
14683 remote_target
*remote
= get_current_remote_target ();
14685 || !remote
->vcont_r_supported ())
14686 warning (_("Range stepping is not supported by the current target"));
14691 show_remote_debug (struct ui_file
*file
, int from_tty
,
14692 struct cmd_list_element
*c
, const char *value
)
14694 gdb_printf (file
, _("Debugging of remote protocol is %s.\n"),
14699 show_remote_timeout (struct ui_file
*file
, int from_tty
,
14700 struct cmd_list_element
*c
, const char *value
)
14703 _("Timeout limit to wait for target to respond is %s.\n"),
14707 /* Implement the "supports_memory_tagging" target_ops method. */
14710 remote_target::supports_memory_tagging ()
14712 return remote_memory_tagging_p ();
14715 /* Create the qMemTags packet given ADDRESS, LEN and TYPE. */
14718 create_fetch_memtags_request (gdb::char_vector
&packet
, CORE_ADDR address
,
14719 size_t len
, int type
)
14721 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
14723 std::string request
= string_printf ("qMemTags:%s,%s:%s",
14724 phex_nz (address
, addr_size
),
14725 phex_nz (len
, sizeof (len
)),
14726 phex_nz (type
, sizeof (type
)));
14728 strcpy (packet
.data (), request
.c_str ());
14731 /* Parse the qMemTags packet reply into TAGS.
14733 Return true if successful, false otherwise. */
14736 parse_fetch_memtags_reply (const gdb::char_vector
&reply
,
14737 gdb::byte_vector
&tags
)
14739 if (reply
.empty () || reply
[0] == 'E' || reply
[0] != 'm')
14742 /* Copy the tag data. */
14743 tags
= hex2bin (reply
.data () + 1);
14748 /* Create the QMemTags packet given ADDRESS, LEN, TYPE and TAGS. */
14751 create_store_memtags_request (gdb::char_vector
&packet
, CORE_ADDR address
,
14752 size_t len
, int type
,
14753 const gdb::byte_vector
&tags
)
14755 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
14757 /* Put together the main packet, address and length. */
14758 std::string request
= string_printf ("QMemTags:%s,%s:%s:",
14759 phex_nz (address
, addr_size
),
14760 phex_nz (len
, sizeof (len
)),
14761 phex_nz (type
, sizeof (type
)));
14762 request
+= bin2hex (tags
.data (), tags
.size ());
14764 /* Check if we have exceeded the maximum packet size. */
14765 if (packet
.size () < request
.length ())
14766 error (_("Contents too big for packet QMemTags."));
14768 strcpy (packet
.data (), request
.c_str ());
14771 /* Implement the "fetch_memtags" target_ops method. */
14774 remote_target::fetch_memtags (CORE_ADDR address
, size_t len
,
14775 gdb::byte_vector
&tags
, int type
)
14777 /* Make sure the qMemTags packet is supported. */
14778 if (!remote_memory_tagging_p ())
14779 gdb_assert_not_reached ("remote fetch_memtags called with packet disabled");
14781 struct remote_state
*rs
= get_remote_state ();
14783 create_fetch_memtags_request (rs
->buf
, address
, len
, type
);
14786 getpkt (&rs
->buf
, 0);
14788 return parse_fetch_memtags_reply (rs
->buf
, tags
);
14791 /* Implement the "store_memtags" target_ops method. */
14794 remote_target::store_memtags (CORE_ADDR address
, size_t len
,
14795 const gdb::byte_vector
&tags
, int type
)
14797 /* Make sure the QMemTags packet is supported. */
14798 if (!remote_memory_tagging_p ())
14799 gdb_assert_not_reached ("remote store_memtags called with packet disabled");
14801 struct remote_state
*rs
= get_remote_state ();
14803 create_store_memtags_request (rs
->buf
, address
, len
, type
, tags
);
14806 getpkt (&rs
->buf
, 0);
14808 /* Verify if the request was successful. */
14809 return packet_check_result (rs
->buf
.data ()) == PACKET_OK
;
14812 /* Return true if remote target T is non-stop. */
14815 remote_target_is_non_stop_p (remote_target
*t
)
14817 scoped_restore_current_thread restore_thread
;
14818 switch_to_target_no_thread (t
);
14820 return target_is_non_stop_p ();
14825 namespace selftests
{
14828 test_memory_tagging_functions ()
14830 remote_target remote
;
14832 struct packet_config
*config
14833 = &remote_protocol_packets
[PACKET_memory_tagging_feature
];
14835 scoped_restore restore_memtag_support_
14836 = make_scoped_restore (&config
->support
);
14838 /* Test memory tagging packet support. */
14839 config
->support
= PACKET_SUPPORT_UNKNOWN
;
14840 SELF_CHECK (remote
.supports_memory_tagging () == false);
14841 config
->support
= PACKET_DISABLE
;
14842 SELF_CHECK (remote
.supports_memory_tagging () == false);
14843 config
->support
= PACKET_ENABLE
;
14844 SELF_CHECK (remote
.supports_memory_tagging () == true);
14846 /* Setup testing. */
14847 gdb::char_vector packet
;
14848 gdb::byte_vector tags
, bv
;
14849 std::string expected
, reply
;
14850 packet
.resize (32000);
14852 /* Test creating a qMemTags request. */
14854 expected
= "qMemTags:0,0:0";
14855 create_fetch_memtags_request (packet
, 0x0, 0x0, 0);
14856 SELF_CHECK (strcmp (packet
.data (), expected
.c_str ()) == 0);
14858 expected
= "qMemTags:deadbeef,10:1";
14859 create_fetch_memtags_request (packet
, 0xdeadbeef, 16, 1);
14860 SELF_CHECK (strcmp (packet
.data (), expected
.c_str ()) == 0);
14862 /* Test parsing a qMemTags reply. */
14864 /* Error reply, tags vector unmodified. */
14866 strcpy (packet
.data (), reply
.c_str ());
14868 SELF_CHECK (parse_fetch_memtags_reply (packet
, tags
) == false);
14869 SELF_CHECK (tags
.size () == 0);
14871 /* Valid reply, tags vector updated. */
14875 for (int i
= 0; i
< 5; i
++)
14878 reply
= "m" + bin2hex (bv
.data (), bv
.size ());
14879 strcpy (packet
.data (), reply
.c_str ());
14881 SELF_CHECK (parse_fetch_memtags_reply (packet
, tags
) == true);
14882 SELF_CHECK (tags
.size () == 5);
14884 for (int i
= 0; i
< 5; i
++)
14885 SELF_CHECK (tags
[i
] == i
);
14887 /* Test creating a QMemTags request. */
14889 /* Empty tag data. */
14891 expected
= "QMemTags:0,0:0:";
14892 create_store_memtags_request (packet
, 0x0, 0x0, 0, tags
);
14893 SELF_CHECK (memcmp (packet
.data (), expected
.c_str (),
14894 expected
.length ()) == 0);
14896 /* Non-empty tag data. */
14898 for (int i
= 0; i
< 5; i
++)
14899 tags
.push_back (i
);
14900 expected
= "QMemTags:deadbeef,ff:1:0001020304";
14901 create_store_memtags_request (packet
, 0xdeadbeef, 255, 1, tags
);
14902 SELF_CHECK (memcmp (packet
.data (), expected
.c_str (),
14903 expected
.length ()) == 0);
14906 } // namespace selftests
14907 #endif /* GDB_SELF_TEST */
14909 void _initialize_remote ();
14911 _initialize_remote ()
14913 /* architecture specific data */
14914 remote_g_packet_data_handle
=
14915 gdbarch_data_register_pre_init (remote_g_packet_data_init
);
14917 add_target (remote_target_info
, remote_target::open
);
14918 add_target (extended_remote_target_info
, extended_remote_target::open
);
14920 /* Hook into new objfile notification. */
14921 gdb::observers::new_objfile
.attach (remote_new_objfile
, "remote");
14924 init_remote_threadtests ();
14927 /* set/show remote ... */
14929 add_basic_prefix_cmd ("remote", class_maintenance
, _("\
14930 Remote protocol specific variables.\n\
14931 Configure various remote-protocol specific variables such as\n\
14932 the packets being used."),
14933 &remote_set_cmdlist
,
14934 0 /* allow-unknown */, &setlist
);
14935 add_prefix_cmd ("remote", class_maintenance
, show_remote_cmd
, _("\
14936 Remote protocol specific variables.\n\
14937 Configure various remote-protocol specific variables such as\n\
14938 the packets being used."),
14939 &remote_show_cmdlist
,
14940 0 /* allow-unknown */, &showlist
);
14942 add_cmd ("compare-sections", class_obscure
, compare_sections_command
, _("\
14943 Compare section data on target to the exec file.\n\
14944 Argument is a single section name (default: all loaded sections).\n\
14945 To compare only read-only loaded sections, specify the -r option."),
14948 add_cmd ("packet", class_maintenance
, cli_packet_command
, _("\
14949 Send an arbitrary packet to a remote target.\n\
14950 maintenance packet TEXT\n\
14951 If GDB is talking to an inferior via the GDB serial protocol, then\n\
14952 this command sends the string TEXT to the inferior, and displays the\n\
14953 response packet. GDB supplies the initial `$' character, and the\n\
14954 terminating `#' character and checksum."),
14957 set_show_commands remotebreak_cmds
14958 = add_setshow_boolean_cmd ("remotebreak", no_class
, &remote_break
, _("\
14959 Set whether to send break if interrupted."), _("\
14960 Show whether to send break if interrupted."), _("\
14961 If set, a break, instead of a cntrl-c, is sent to the remote target."),
14962 set_remotebreak
, show_remotebreak
,
14963 &setlist
, &showlist
);
14964 deprecate_cmd (remotebreak_cmds
.set
, "set remote interrupt-sequence");
14965 deprecate_cmd (remotebreak_cmds
.show
, "show remote interrupt-sequence");
14967 add_setshow_enum_cmd ("interrupt-sequence", class_support
,
14968 interrupt_sequence_modes
, &interrupt_sequence_mode
,
14970 Set interrupt sequence to remote target."), _("\
14971 Show interrupt sequence to remote target."), _("\
14972 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
14973 NULL
, show_interrupt_sequence
,
14974 &remote_set_cmdlist
,
14975 &remote_show_cmdlist
);
14977 add_setshow_boolean_cmd ("interrupt-on-connect", class_support
,
14978 &interrupt_on_connect
, _("\
14979 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _("\
14980 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _("\
14981 If set, interrupt sequence is sent to remote target."),
14983 &remote_set_cmdlist
, &remote_show_cmdlist
);
14985 /* Install commands for configuring memory read/write packets. */
14987 add_cmd ("remotewritesize", no_class
, set_memory_write_packet_size
, _("\
14988 Set the maximum number of bytes per memory write packet (deprecated)."),
14990 add_cmd ("remotewritesize", no_class
, show_memory_write_packet_size
, _("\
14991 Show the maximum number of bytes per memory write packet (deprecated)."),
14993 add_cmd ("memory-write-packet-size", no_class
,
14994 set_memory_write_packet_size
, _("\
14995 Set the maximum number of bytes per memory-write 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-read-packet-size", no_class
,
15002 set_memory_read_packet_size
, _("\
15003 Set the maximum number of bytes per memory-read packet.\n\
15004 Specify the number of bytes in a packet or 0 (zero) for the\n\
15005 default packet size. The actual limit is further reduced\n\
15006 dependent on the target. Specify ``fixed'' to disable the\n\
15007 further restriction and ``limit'' to enable that restriction."),
15008 &remote_set_cmdlist
);
15009 add_cmd ("memory-write-packet-size", no_class
,
15010 show_memory_write_packet_size
,
15011 _("Show the maximum number of bytes per memory-write packet."),
15012 &remote_show_cmdlist
);
15013 add_cmd ("memory-read-packet-size", no_class
,
15014 show_memory_read_packet_size
,
15015 _("Show the maximum number of bytes per memory-read packet."),
15016 &remote_show_cmdlist
);
15018 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-limit", no_class
,
15019 &remote_hw_watchpoint_limit
, _("\
15020 Set the maximum number of target hardware watchpoints."), _("\
15021 Show the maximum number of target hardware watchpoints."), _("\
15022 Specify \"unlimited\" for unlimited hardware watchpoints."),
15023 NULL
, show_hardware_watchpoint_limit
,
15024 &remote_set_cmdlist
,
15025 &remote_show_cmdlist
);
15026 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-length-limit",
15028 &remote_hw_watchpoint_length_limit
, _("\
15029 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
15030 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
15031 Specify \"unlimited\" to allow watchpoints of unlimited size."),
15032 NULL
, show_hardware_watchpoint_length_limit
,
15033 &remote_set_cmdlist
, &remote_show_cmdlist
);
15034 add_setshow_zuinteger_unlimited_cmd ("hardware-breakpoint-limit", no_class
,
15035 &remote_hw_breakpoint_limit
, _("\
15036 Set the maximum number of target hardware breakpoints."), _("\
15037 Show the maximum number of target hardware breakpoints."), _("\
15038 Specify \"unlimited\" for unlimited hardware breakpoints."),
15039 NULL
, show_hardware_breakpoint_limit
,
15040 &remote_set_cmdlist
, &remote_show_cmdlist
);
15042 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure
,
15043 &remote_address_size
, _("\
15044 Set the maximum size of the address (in bits) in a memory packet."), _("\
15045 Show the maximum size of the address (in bits) in a memory packet."), NULL
,
15047 NULL
, /* FIXME: i18n: */
15048 &setlist
, &showlist
);
15050 init_all_packet_configs ();
15052 add_packet_config_cmd (&remote_protocol_packets
[PACKET_X
],
15053 "X", "binary-download", 1);
15055 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCont
],
15056 "vCont", "verbose-resume", 0);
15058 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QPassSignals
],
15059 "QPassSignals", "pass-signals", 0);
15061 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QCatchSyscalls
],
15062 "QCatchSyscalls", "catch-syscalls", 0);
15064 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QProgramSignals
],
15065 "QProgramSignals", "program-signals", 0);
15067 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QSetWorkingDir
],
15068 "QSetWorkingDir", "set-working-dir", 0);
15070 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartupWithShell
],
15071 "QStartupWithShell", "startup-with-shell", 0);
15073 add_packet_config_cmd (&remote_protocol_packets
15074 [PACKET_QEnvironmentHexEncoded
],
15075 "QEnvironmentHexEncoded", "environment-hex-encoded",
15078 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QEnvironmentReset
],
15079 "QEnvironmentReset", "environment-reset",
15082 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QEnvironmentUnset
],
15083 "QEnvironmentUnset", "environment-unset",
15086 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSymbol
],
15087 "qSymbol", "symbol-lookup", 0);
15089 add_packet_config_cmd (&remote_protocol_packets
[PACKET_P
],
15090 "P", "set-register", 1);
15092 add_packet_config_cmd (&remote_protocol_packets
[PACKET_p
],
15093 "p", "fetch-register", 1);
15095 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
],
15096 "Z0", "software-breakpoint", 0);
15098 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z1
],
15099 "Z1", "hardware-breakpoint", 0);
15101 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z2
],
15102 "Z2", "write-watchpoint", 0);
15104 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z3
],
15105 "Z3", "read-watchpoint", 0);
15107 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z4
],
15108 "Z4", "access-watchpoint", 0);
15110 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_auxv
],
15111 "qXfer:auxv:read", "read-aux-vector", 0);
15113 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_exec_file
],
15114 "qXfer:exec-file:read", "pid-to-exec-file", 0);
15116 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_features
],
15117 "qXfer:features:read", "target-features", 0);
15119 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries
],
15120 "qXfer:libraries:read", "library-info", 0);
15122 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries_svr4
],
15123 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
15125 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_memory_map
],
15126 "qXfer:memory-map:read", "memory-map", 0);
15128 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_osdata
],
15129 "qXfer:osdata:read", "osdata", 0);
15131 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_threads
],
15132 "qXfer:threads:read", "threads", 0);
15134 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_read
],
15135 "qXfer:siginfo:read", "read-siginfo-object", 0);
15137 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_write
],
15138 "qXfer:siginfo:write", "write-siginfo-object", 0);
15140 add_packet_config_cmd
15141 (&remote_protocol_packets
[PACKET_qXfer_traceframe_info
],
15142 "qXfer:traceframe-info:read", "traceframe-info", 0);
15144 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_uib
],
15145 "qXfer:uib:read", "unwind-info-block", 0);
15147 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTLSAddr
],
15148 "qGetTLSAddr", "get-thread-local-storage-address",
15151 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTIBAddr
],
15152 "qGetTIBAddr", "get-thread-information-block-address",
15155 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bc
],
15156 "bc", "reverse-continue", 0);
15158 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bs
],
15159 "bs", "reverse-step", 0);
15161 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSupported
],
15162 "qSupported", "supported-packets", 0);
15164 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSearch_memory
],
15165 "qSearch:memory", "search-memory", 0);
15167 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qTStatus
],
15168 "qTStatus", "trace-status", 0);
15170 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_setfs
],
15171 "vFile:setfs", "hostio-setfs", 0);
15173 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_open
],
15174 "vFile:open", "hostio-open", 0);
15176 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pread
],
15177 "vFile:pread", "hostio-pread", 0);
15179 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pwrite
],
15180 "vFile:pwrite", "hostio-pwrite", 0);
15182 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_close
],
15183 "vFile:close", "hostio-close", 0);
15185 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_unlink
],
15186 "vFile:unlink", "hostio-unlink", 0);
15188 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_readlink
],
15189 "vFile:readlink", "hostio-readlink", 0);
15191 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_fstat
],
15192 "vFile:fstat", "hostio-fstat", 0);
15194 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vAttach
],
15195 "vAttach", "attach", 0);
15197 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vRun
],
15200 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartNoAckMode
],
15201 "QStartNoAckMode", "noack", 0);
15203 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vKill
],
15204 "vKill", "kill", 0);
15206 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qAttached
],
15207 "qAttached", "query-attached", 0);
15209 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalTracepoints
],
15210 "ConditionalTracepoints",
15211 "conditional-tracepoints", 0);
15213 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalBreakpoints
],
15214 "ConditionalBreakpoints",
15215 "conditional-breakpoints", 0);
15217 add_packet_config_cmd (&remote_protocol_packets
[PACKET_BreakpointCommands
],
15218 "BreakpointCommands",
15219 "breakpoint-commands", 0);
15221 add_packet_config_cmd (&remote_protocol_packets
[PACKET_FastTracepoints
],
15222 "FastTracepoints", "fast-tracepoints", 0);
15224 add_packet_config_cmd (&remote_protocol_packets
[PACKET_TracepointSource
],
15225 "TracepointSource", "TracepointSource", 0);
15227 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAllow
],
15228 "QAllow", "allow", 0);
15230 add_packet_config_cmd (&remote_protocol_packets
[PACKET_StaticTracepoints
],
15231 "StaticTracepoints", "static-tracepoints", 0);
15233 add_packet_config_cmd (&remote_protocol_packets
[PACKET_InstallInTrace
],
15234 "InstallInTrace", "install-in-trace", 0);
15236 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_statictrace_read
],
15237 "qXfer:statictrace:read", "read-sdata-object", 0);
15239 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_fdpic
],
15240 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
15242 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QDisableRandomization
],
15243 "QDisableRandomization", "disable-randomization", 0);
15245 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAgent
],
15246 "QAgent", "agent", 0);
15248 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QTBuffer_size
],
15249 "QTBuffer:size", "trace-buffer-size", 0);
15251 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_off
],
15252 "Qbtrace:off", "disable-btrace", 0);
15254 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_bts
],
15255 "Qbtrace:bts", "enable-btrace-bts", 0);
15257 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_pt
],
15258 "Qbtrace:pt", "enable-btrace-pt", 0);
15260 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace
],
15261 "qXfer:btrace", "read-btrace", 0);
15263 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace_conf
],
15264 "qXfer:btrace-conf", "read-btrace-conf", 0);
15266 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_conf_bts_size
],
15267 "Qbtrace-conf:bts:size", "btrace-conf-bts-size", 0);
15269 add_packet_config_cmd (&remote_protocol_packets
[PACKET_multiprocess_feature
],
15270 "multiprocess-feature", "multiprocess-feature", 0);
15272 add_packet_config_cmd (&remote_protocol_packets
[PACKET_swbreak_feature
],
15273 "swbreak-feature", "swbreak-feature", 0);
15275 add_packet_config_cmd (&remote_protocol_packets
[PACKET_hwbreak_feature
],
15276 "hwbreak-feature", "hwbreak-feature", 0);
15278 add_packet_config_cmd (&remote_protocol_packets
[PACKET_fork_event_feature
],
15279 "fork-event-feature", "fork-event-feature", 0);
15281 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vfork_event_feature
],
15282 "vfork-event-feature", "vfork-event-feature", 0);
15284 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_conf_pt_size
],
15285 "Qbtrace-conf:pt:size", "btrace-conf-pt-size", 0);
15287 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vContSupported
],
15288 "vContSupported", "verbose-resume-supported", 0);
15290 add_packet_config_cmd (&remote_protocol_packets
[PACKET_exec_event_feature
],
15291 "exec-event-feature", "exec-event-feature", 0);
15293 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCtrlC
],
15294 "vCtrlC", "ctrl-c", 0);
15296 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QThreadEvents
],
15297 "QThreadEvents", "thread-events", 0);
15299 add_packet_config_cmd (&remote_protocol_packets
[PACKET_no_resumed
],
15300 "N stop reply", "no-resumed-stop-reply", 0);
15302 add_packet_config_cmd (&remote_protocol_packets
[PACKET_memory_tagging_feature
],
15303 "memory-tagging-feature", "memory-tagging-feature", 0);
15305 /* Assert that we've registered "set remote foo-packet" commands
15306 for all packet configs. */
15310 for (i
= 0; i
< PACKET_MAX
; i
++)
15312 /* Ideally all configs would have a command associated. Some
15313 still don't though. */
15318 case PACKET_QNonStop
:
15319 case PACKET_EnableDisableTracepoints_feature
:
15320 case PACKET_tracenz_feature
:
15321 case PACKET_DisconnectedTracing_feature
:
15322 case PACKET_augmented_libraries_svr4_read_feature
:
15324 /* Additions to this list need to be well justified:
15325 pre-existing packets are OK; new packets are not. */
15333 /* This catches both forgetting to add a config command, and
15334 forgetting to remove a packet from the exception list. */
15335 gdb_assert (excepted
== (remote_protocol_packets
[i
].name
== NULL
));
15339 /* Keep the old ``set remote Z-packet ...'' working. Each individual
15340 Z sub-packet has its own set and show commands, but users may
15341 have sets to this variable in their .gdbinit files (or in their
15343 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure
,
15344 &remote_Z_packet_detect
, _("\
15345 Set use of remote protocol `Z' packets."), _("\
15346 Show use of remote protocol `Z' packets."), _("\
15347 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
15349 set_remote_protocol_Z_packet_cmd
,
15350 show_remote_protocol_Z_packet_cmd
,
15351 /* FIXME: i18n: Use of remote protocol
15352 `Z' packets is %s. */
15353 &remote_set_cmdlist
, &remote_show_cmdlist
);
15355 add_basic_prefix_cmd ("remote", class_files
, _("\
15356 Manipulate files on the remote system.\n\
15357 Transfer files to and from the remote target system."),
15359 0 /* allow-unknown */, &cmdlist
);
15361 add_cmd ("put", class_files
, remote_put_command
,
15362 _("Copy a local file to the remote system."),
15365 add_cmd ("get", class_files
, remote_get_command
,
15366 _("Copy a remote file to the local system."),
15369 add_cmd ("delete", class_files
, remote_delete_command
,
15370 _("Delete a remote file."),
15373 add_setshow_string_noescape_cmd ("exec-file", class_files
,
15374 &remote_exec_file_var
, _("\
15375 Set the remote pathname for \"run\"."), _("\
15376 Show the remote pathname for \"run\"."), NULL
,
15377 set_remote_exec_file
,
15378 show_remote_exec_file
,
15379 &remote_set_cmdlist
,
15380 &remote_show_cmdlist
);
15382 add_setshow_boolean_cmd ("range-stepping", class_run
,
15383 &use_range_stepping
, _("\
15384 Enable or disable range stepping."), _("\
15385 Show whether target-assisted range stepping is enabled."), _("\
15386 If on, and the target supports it, when stepping a source line, GDB\n\
15387 tells the target to step the corresponding range of addresses itself instead\n\
15388 of issuing multiple single-steps. This speeds up source level\n\
15389 stepping. If off, GDB always issues single-steps, even if range\n\
15390 stepping is supported by the target. The default is on."),
15391 set_range_stepping
,
15392 show_range_stepping
,
15396 add_setshow_zinteger_cmd ("watchdog", class_maintenance
, &watchdog
, _("\
15397 Set watchdog timer."), _("\
15398 Show watchdog timer."), _("\
15399 When non-zero, this timeout is used instead of waiting forever for a target\n\
15400 to finish a low-level step or continue operation. If the specified amount\n\
15401 of time passes without a response from the target, an error occurs."),
15404 &setlist
, &showlist
);
15406 add_setshow_zuinteger_unlimited_cmd ("remote-packet-max-chars", no_class
,
15407 &remote_packet_max_chars
, _("\
15408 Set the maximum number of characters to display for each remote packet."), _("\
15409 Show the maximum number of characters to display for each remote packet."), _("\
15410 Specify \"unlimited\" to display all the characters."),
15411 NULL
, show_remote_packet_max_chars
,
15412 &setdebuglist
, &showdebuglist
);
15414 add_setshow_boolean_cmd ("remote", no_class
, &remote_debug
,
15415 _("Set debugging of remote protocol."),
15416 _("Show debugging of remote protocol."),
15418 When enabled, each packet sent or received with the remote target\n\
15422 &setdebuglist
, &showdebuglist
);
15424 add_setshow_zuinteger_unlimited_cmd ("remotetimeout", no_class
,
15425 &remote_timeout
, _("\
15426 Set timeout limit to wait for target to respond."), _("\
15427 Show timeout limit to wait for target to respond."), _("\
15428 This value is used to set the time limit for gdb to wait for a response\n\
15429 from the target."),
15431 show_remote_timeout
,
15432 &setlist
, &showlist
);
15434 /* Eventually initialize fileio. See fileio.c */
15435 initialize_remote_fileio (&remote_set_cmdlist
, &remote_show_cmdlist
);
15438 selftests::register_test ("remote_memory_tagging",
15439 selftests::test_memory_tagging_functions
);