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 serial target in 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 void files_info () override
;
431 int insert_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
433 int remove_breakpoint (struct gdbarch
*, struct bp_target_info
*,
434 enum remove_bp_reason
) override
;
437 bool stopped_by_sw_breakpoint () override
;
438 bool supports_stopped_by_sw_breakpoint () override
;
440 bool stopped_by_hw_breakpoint () override
;
442 bool supports_stopped_by_hw_breakpoint () override
;
444 bool stopped_by_watchpoint () override
;
446 bool stopped_data_address (CORE_ADDR
*) override
;
448 bool watchpoint_addr_within_range (CORE_ADDR
, CORE_ADDR
, int) override
;
450 int can_use_hw_breakpoint (enum bptype
, int, int) override
;
452 int insert_hw_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
454 int remove_hw_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
456 int region_ok_for_hw_watchpoint (CORE_ADDR
, int) override
;
458 int insert_watchpoint (CORE_ADDR
, int, enum target_hw_bp_type
,
459 struct expression
*) override
;
461 int remove_watchpoint (CORE_ADDR
, int, enum target_hw_bp_type
,
462 struct expression
*) override
;
464 void kill () override
;
466 void load (const char *, int) override
;
468 void mourn_inferior () override
;
470 void pass_signals (gdb::array_view
<const unsigned char>) override
;
472 int set_syscall_catchpoint (int, bool, int,
473 gdb::array_view
<const int>) override
;
475 void program_signals (gdb::array_view
<const unsigned char>) override
;
477 bool thread_alive (ptid_t ptid
) override
;
479 const char *thread_name (struct thread_info
*) override
;
481 void update_thread_list () override
;
483 std::string
pid_to_str (ptid_t
) override
;
485 const char *extra_thread_info (struct thread_info
*) override
;
487 ptid_t
get_ada_task_ptid (long lwp
, ULONGEST thread
) override
;
489 thread_info
*thread_handle_to_thread_info (const gdb_byte
*thread_handle
,
491 inferior
*inf
) override
;
493 gdb::byte_vector
thread_info_to_thread_handle (struct thread_info
*tp
)
496 void stop (ptid_t
) override
;
498 void interrupt () override
;
500 void pass_ctrlc () override
;
502 enum target_xfer_status
xfer_partial (enum target_object object
,
505 const gdb_byte
*writebuf
,
506 ULONGEST offset
, ULONGEST len
,
507 ULONGEST
*xfered_len
) override
;
509 ULONGEST
get_memory_xfer_limit () override
;
511 void rcmd (const char *command
, struct ui_file
*output
) override
;
513 char *pid_to_exec_file (int pid
) override
;
515 void log_command (const char *cmd
) override
517 serial_log_command (this, cmd
);
520 CORE_ADDR
get_thread_local_address (ptid_t ptid
,
521 CORE_ADDR load_module_addr
,
522 CORE_ADDR offset
) override
;
524 bool can_execute_reverse () override
;
526 std::vector
<mem_region
> memory_map () override
;
528 void flash_erase (ULONGEST address
, LONGEST length
) override
;
530 void flash_done () override
;
532 const struct target_desc
*read_description () override
;
534 int search_memory (CORE_ADDR start_addr
, ULONGEST search_space_len
,
535 const gdb_byte
*pattern
, ULONGEST pattern_len
,
536 CORE_ADDR
*found_addrp
) override
;
538 bool can_async_p () override
;
540 bool is_async_p () override
;
542 void async (int) override
;
544 int async_wait_fd () override
;
546 void thread_events (int) override
;
548 int can_do_single_step () override
;
550 void terminal_inferior () override
;
552 void terminal_ours () override
;
554 bool supports_non_stop () override
;
556 bool supports_multi_process () override
;
558 bool supports_disable_randomization () override
;
560 bool filesystem_is_local () override
;
563 int fileio_open (struct inferior
*inf
, const char *filename
,
564 int flags
, int mode
, int warn_if_slow
,
565 int *target_errno
) override
;
567 int fileio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
568 ULONGEST offset
, int *target_errno
) override
;
570 int fileio_pread (int fd
, gdb_byte
*read_buf
, int len
,
571 ULONGEST offset
, int *target_errno
) override
;
573 int fileio_fstat (int fd
, struct stat
*sb
, int *target_errno
) override
;
575 int fileio_close (int fd
, int *target_errno
) override
;
577 int fileio_unlink (struct inferior
*inf
,
578 const char *filename
,
579 int *target_errno
) override
;
581 gdb::optional
<std::string
>
582 fileio_readlink (struct inferior
*inf
,
583 const char *filename
,
584 int *target_errno
) override
;
586 bool supports_enable_disable_tracepoint () override
;
588 bool supports_string_tracing () override
;
590 bool supports_evaluation_of_breakpoint_conditions () override
;
592 bool can_run_breakpoint_commands () override
;
594 void trace_init () override
;
596 void download_tracepoint (struct bp_location
*location
) override
;
598 bool can_download_tracepoint () override
;
600 void download_trace_state_variable (const trace_state_variable
&tsv
) override
;
602 void enable_tracepoint (struct bp_location
*location
) override
;
604 void disable_tracepoint (struct bp_location
*location
) override
;
606 void trace_set_readonly_regions () override
;
608 void trace_start () override
;
610 int get_trace_status (struct trace_status
*ts
) override
;
612 void get_tracepoint_status (struct breakpoint
*tp
, struct uploaded_tp
*utp
)
615 void trace_stop () override
;
617 int trace_find (enum trace_find_type type
, int num
,
618 CORE_ADDR addr1
, CORE_ADDR addr2
, int *tpp
) override
;
620 bool get_trace_state_variable_value (int tsv
, LONGEST
*val
) override
;
622 int save_trace_data (const char *filename
) override
;
624 int upload_tracepoints (struct uploaded_tp
**utpp
) override
;
626 int upload_trace_state_variables (struct uploaded_tsv
**utsvp
) override
;
628 LONGEST
get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
) override
;
630 int get_min_fast_tracepoint_insn_len () override
;
632 void set_disconnected_tracing (int val
) override
;
634 void set_circular_trace_buffer (int val
) override
;
636 void set_trace_buffer_size (LONGEST val
) override
;
638 bool set_trace_notes (const char *user
, const char *notes
,
639 const char *stopnotes
) override
;
641 int core_of_thread (ptid_t ptid
) override
;
643 int verify_memory (const gdb_byte
*data
,
644 CORE_ADDR memaddr
, ULONGEST size
) override
;
647 bool get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
) override
;
649 void set_permissions () override
;
651 bool static_tracepoint_marker_at (CORE_ADDR
,
652 struct static_tracepoint_marker
*marker
)
655 std::vector
<static_tracepoint_marker
>
656 static_tracepoint_markers_by_strid (const char *id
) override
;
658 traceframe_info_up
traceframe_info () override
;
660 bool use_agent (bool use
) override
;
661 bool can_use_agent () override
;
663 struct btrace_target_info
*enable_btrace (ptid_t ptid
,
664 const struct btrace_config
*conf
) override
;
666 void disable_btrace (struct btrace_target_info
*tinfo
) override
;
668 void teardown_btrace (struct btrace_target_info
*tinfo
) override
;
670 enum btrace_error
read_btrace (struct btrace_data
*data
,
671 struct btrace_target_info
*btinfo
,
672 enum btrace_read_type type
) override
;
674 const struct btrace_config
*btrace_conf (const struct btrace_target_info
*) override
;
675 bool augmented_libraries_svr4_read () override
;
676 void follow_fork (inferior
*, ptid_t
, target_waitkind
, bool, bool) override
;
677 void follow_exec (inferior
*, ptid_t
, const char *) override
;
678 int insert_fork_catchpoint (int) override
;
679 int remove_fork_catchpoint (int) override
;
680 int insert_vfork_catchpoint (int) override
;
681 int remove_vfork_catchpoint (int) override
;
682 int insert_exec_catchpoint (int) override
;
683 int remove_exec_catchpoint (int) override
;
684 enum exec_direction_kind
execution_direction () override
;
686 bool supports_memory_tagging () override
;
688 bool fetch_memtags (CORE_ADDR address
, size_t len
,
689 gdb::byte_vector
&tags
, int type
) override
;
691 bool store_memtags (CORE_ADDR address
, size_t len
,
692 const gdb::byte_vector
&tags
, int type
) override
;
694 public: /* Remote specific methods. */
696 void remote_download_command_source (int num
, ULONGEST addr
,
697 struct command_line
*cmds
);
699 void remote_file_put (const char *local_file
, const char *remote_file
,
701 void remote_file_get (const char *remote_file
, const char *local_file
,
703 void remote_file_delete (const char *remote_file
, int from_tty
);
705 int remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
706 ULONGEST offset
, int *remote_errno
);
707 int remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
708 ULONGEST offset
, int *remote_errno
);
709 int remote_hostio_pread_vFile (int fd
, gdb_byte
*read_buf
, int len
,
710 ULONGEST offset
, int *remote_errno
);
712 int remote_hostio_send_command (int command_bytes
, int which_packet
,
713 int *remote_errno
, const char **attachment
,
714 int *attachment_len
);
715 int remote_hostio_set_filesystem (struct inferior
*inf
,
717 /* We should get rid of this and use fileio_open directly. */
718 int remote_hostio_open (struct inferior
*inf
, const char *filename
,
719 int flags
, int mode
, int warn_if_slow
,
721 int remote_hostio_close (int fd
, int *remote_errno
);
723 int remote_hostio_unlink (inferior
*inf
, const char *filename
,
726 struct remote_state
*get_remote_state ();
728 long get_remote_packet_size (void);
729 long get_memory_packet_size (struct memory_packet_config
*config
);
731 long get_memory_write_packet_size ();
732 long get_memory_read_packet_size ();
734 char *append_pending_thread_resumptions (char *p
, char *endp
,
736 static void open_1 (const char *name
, int from_tty
, int extended_p
);
737 void start_remote (int from_tty
, int extended_p
);
738 void remote_detach_1 (struct inferior
*inf
, int from_tty
);
740 char *append_resumption (char *p
, char *endp
,
741 ptid_t ptid
, int step
, gdb_signal siggnal
);
742 int remote_resume_with_vcont (ptid_t ptid
, int step
,
745 thread_info
*add_current_inferior_and_thread (const char *wait_status
);
747 ptid_t
wait_ns (ptid_t ptid
, struct target_waitstatus
*status
,
748 target_wait_flags options
);
749 ptid_t
wait_as (ptid_t ptid
, target_waitstatus
*status
,
750 target_wait_flags options
);
752 ptid_t
process_stop_reply (struct stop_reply
*stop_reply
,
753 target_waitstatus
*status
);
755 ptid_t select_thread_for_ambiguous_stop_reply
756 (const struct target_waitstatus
&status
);
758 void remote_notice_new_inferior (ptid_t currthread
, bool executing
);
760 void print_one_stopped_thread (thread_info
*thread
);
761 void process_initial_stop_replies (int from_tty
);
763 thread_info
*remote_add_thread (ptid_t ptid
, bool running
, bool executing
,
766 void btrace_sync_conf (const btrace_config
*conf
);
768 void remote_btrace_maybe_reopen ();
770 void remove_new_fork_children (threads_listing_context
*context
);
771 void kill_new_fork_children (inferior
*inf
);
772 void discard_pending_stop_replies (struct inferior
*inf
);
773 int stop_reply_queue_length ();
775 void check_pending_events_prevent_wildcard_vcont
776 (bool *may_global_wildcard_vcont
);
778 void discard_pending_stop_replies_in_queue ();
779 struct stop_reply
*remote_notif_remove_queued_reply (ptid_t ptid
);
780 struct stop_reply
*queued_stop_reply (ptid_t ptid
);
781 int peek_stop_reply (ptid_t ptid
);
782 void remote_parse_stop_reply (const char *buf
, stop_reply
*event
);
784 void remote_stop_ns (ptid_t ptid
);
785 void remote_interrupt_as ();
786 void remote_interrupt_ns ();
788 char *remote_get_noisy_reply ();
789 int remote_query_attached (int pid
);
790 inferior
*remote_add_inferior (bool fake_pid_p
, int pid
, int attached
,
793 ptid_t
remote_current_thread (ptid_t oldpid
);
794 ptid_t
get_current_thread (const char *wait_status
);
796 void set_thread (ptid_t ptid
, int gen
);
797 void set_general_thread (ptid_t ptid
);
798 void set_continue_thread (ptid_t ptid
);
799 void set_general_process ();
801 char *write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
);
803 int remote_unpack_thread_info_response (const char *pkt
, threadref
*expectedref
,
804 gdb_ext_thread_info
*info
);
805 int remote_get_threadinfo (threadref
*threadid
, int fieldset
,
806 gdb_ext_thread_info
*info
);
808 int parse_threadlist_response (const char *pkt
, int result_limit
,
809 threadref
*original_echo
,
810 threadref
*resultlist
,
812 int remote_get_threadlist (int startflag
, threadref
*nextthread
,
813 int result_limit
, int *done
, int *result_count
,
814 threadref
*threadlist
);
816 int remote_threadlist_iterator (rmt_thread_action stepfunction
,
817 void *context
, int looplimit
);
819 int remote_get_threads_with_ql (threads_listing_context
*context
);
820 int remote_get_threads_with_qxfer (threads_listing_context
*context
);
821 int remote_get_threads_with_qthreadinfo (threads_listing_context
*context
);
823 void extended_remote_restart ();
827 void remote_check_symbols ();
829 void remote_supported_packet (const struct protocol_feature
*feature
,
830 enum packet_support support
,
831 const char *argument
);
833 void remote_query_supported ();
835 void remote_packet_size (const protocol_feature
*feature
,
836 packet_support support
, const char *value
);
838 void remote_serial_quit_handler ();
840 void remote_detach_pid (int pid
);
842 void remote_vcont_probe ();
844 void remote_resume_with_hc (ptid_t ptid
, int step
,
847 void send_interrupt_sequence ();
848 void interrupt_query ();
850 void remote_notif_get_pending_events (notif_client
*nc
);
852 int fetch_register_using_p (struct regcache
*regcache
,
854 int send_g_packet ();
855 void process_g_packet (struct regcache
*regcache
);
856 void fetch_registers_using_g (struct regcache
*regcache
);
857 int store_register_using_P (const struct regcache
*regcache
,
859 void store_registers_using_G (const struct regcache
*regcache
);
861 void set_remote_traceframe ();
863 void check_binary_download (CORE_ADDR addr
);
865 target_xfer_status
remote_write_bytes_aux (const char *header
,
867 const gdb_byte
*myaddr
,
870 ULONGEST
*xfered_len_units
,
874 target_xfer_status
remote_write_bytes (CORE_ADDR memaddr
,
875 const gdb_byte
*myaddr
, ULONGEST len
,
876 int unit_size
, ULONGEST
*xfered_len
);
878 target_xfer_status
remote_read_bytes_1 (CORE_ADDR memaddr
, gdb_byte
*myaddr
,
880 int unit_size
, ULONGEST
*xfered_len_units
);
882 target_xfer_status
remote_xfer_live_readonly_partial (gdb_byte
*readbuf
,
886 ULONGEST
*xfered_len
);
888 target_xfer_status
remote_read_bytes (CORE_ADDR memaddr
,
889 gdb_byte
*myaddr
, ULONGEST len
,
891 ULONGEST
*xfered_len
);
893 packet_result
remote_send_printf (const char *format
, ...)
894 ATTRIBUTE_PRINTF (2, 3);
896 target_xfer_status
remote_flash_write (ULONGEST address
,
897 ULONGEST length
, ULONGEST
*xfered_len
,
898 const gdb_byte
*data
);
900 int readchar (int timeout
);
902 void remote_serial_write (const char *str
, int len
);
904 int putpkt (const char *buf
);
905 int putpkt_binary (const char *buf
, int cnt
);
907 int putpkt (const gdb::char_vector
&buf
)
909 return putpkt (buf
.data ());
913 long read_frame (gdb::char_vector
*buf_p
);
914 void getpkt (gdb::char_vector
*buf
, int forever
);
915 int getpkt_or_notif_sane_1 (gdb::char_vector
*buf
, int forever
,
916 int expecting_notif
, int *is_notif
);
917 int getpkt_sane (gdb::char_vector
*buf
, int forever
);
918 int getpkt_or_notif_sane (gdb::char_vector
*buf
, int forever
,
920 int remote_vkill (int pid
);
921 void remote_kill_k ();
923 void extended_remote_disable_randomization (int val
);
924 int extended_remote_run (const std::string
&args
);
926 void send_environment_packet (const char *action
,
930 void extended_remote_environment_support ();
931 void extended_remote_set_inferior_cwd ();
933 target_xfer_status
remote_write_qxfer (const char *object_name
,
935 const gdb_byte
*writebuf
,
936 ULONGEST offset
, LONGEST len
,
937 ULONGEST
*xfered_len
,
938 struct packet_config
*packet
);
940 target_xfer_status
remote_read_qxfer (const char *object_name
,
942 gdb_byte
*readbuf
, ULONGEST offset
,
944 ULONGEST
*xfered_len
,
945 struct packet_config
*packet
);
947 void push_stop_reply (struct stop_reply
*new_event
);
949 bool vcont_r_supported ();
953 bool start_remote_1 (int from_tty
, int extended_p
);
955 /* The remote state. Don't reference this directly. Use the
956 get_remote_state method instead. */
957 remote_state m_remote_state
;
960 static const target_info extended_remote_target_info
= {
962 N_("Extended remote serial target in gdb-specific protocol"),
966 /* Set up the extended remote target by extending the standard remote
967 target and adding to it. */
969 class extended_remote_target final
: public remote_target
972 const target_info
&info () const override
973 { return extended_remote_target_info
; }
975 /* Open an extended-remote connection. */
976 static void open (const char *, int);
978 bool can_create_inferior () override
{ return true; }
979 void create_inferior (const char *, const std::string
&,
980 char **, int) override
;
982 void detach (inferior
*, int) override
;
984 bool can_attach () override
{ return true; }
985 void attach (const char *, int) override
;
987 void post_attach (int) override
;
988 bool supports_disable_randomization () override
;
991 struct stop_reply
: public notif_event
995 /* The identifier of the thread about this event */
998 /* The remote state this event is associated with. When the remote
999 connection, represented by a remote_state object, is closed,
1000 all the associated stop_reply events should be released. */
1001 struct remote_state
*rs
;
1003 struct target_waitstatus ws
;
1005 /* The architecture associated with the expedited registers. */
1008 /* Expedited registers. This makes remote debugging a bit more
1009 efficient for those targets that provide critical registers as
1010 part of their normal status mechanism (as another roundtrip to
1011 fetch them is avoided). */
1012 std::vector
<cached_reg_t
> regcache
;
1014 enum target_stop_reason stop_reason
;
1016 CORE_ADDR watch_data_address
;
1024 is_remote_target (process_stratum_target
*target
)
1026 remote_target
*rt
= dynamic_cast<remote_target
*> (target
);
1027 return rt
!= nullptr;
1030 /* Per-program-space data key. */
1031 static const struct program_space_key
<char, gdb::xfree_deleter
<char>>
1034 /* The variable registered as the control variable used by the
1035 remote exec-file commands. While the remote exec-file setting is
1036 per-program-space, the set/show machinery uses this as the
1037 location of the remote exec-file value. */
1038 static std::string remote_exec_file_var
;
1040 /* The size to align memory write packets, when practical. The protocol
1041 does not guarantee any alignment, and gdb will generate short
1042 writes and unaligned writes, but even as a best-effort attempt this
1043 can improve bulk transfers. For instance, if a write is misaligned
1044 relative to the target's data bus, the stub may need to make an extra
1045 round trip fetching data from the target. This doesn't make a
1046 huge difference, but it's easy to do, so we try to be helpful.
1048 The alignment chosen is arbitrary; usually data bus width is
1049 important here, not the possibly larger cache line size. */
1050 enum { REMOTE_ALIGN_WRITES
= 16 };
1052 /* Prototypes for local functions. */
1054 static int hexnumlen (ULONGEST num
);
1056 static int stubhex (int ch
);
1058 static int hexnumstr (char *, ULONGEST
);
1060 static int hexnumnstr (char *, ULONGEST
, int);
1062 static CORE_ADDR
remote_address_masked (CORE_ADDR
);
1064 static int stub_unpack_int (const char *buff
, int fieldlength
);
1066 struct packet_config
;
1068 static void show_remote_protocol_packet_cmd (struct ui_file
*file
,
1070 struct cmd_list_element
*c
,
1073 static ptid_t
read_ptid (const char *buf
, const char **obuf
);
1075 static void remote_async_inferior_event_handler (gdb_client_data
);
1077 static bool remote_read_description_p (struct target_ops
*target
);
1079 static void remote_console_output (const char *msg
);
1081 static void remote_btrace_reset (remote_state
*rs
);
1083 static void remote_unpush_and_throw (remote_target
*target
);
1087 static struct cmd_list_element
*remote_cmdlist
;
1089 /* For "set remote" and "show remote". */
1091 static struct cmd_list_element
*remote_set_cmdlist
;
1092 static struct cmd_list_element
*remote_show_cmdlist
;
1094 /* Controls whether GDB is willing to use range stepping. */
1096 static bool use_range_stepping
= true;
1098 /* From the remote target's point of view, each thread is in one of these three
1100 enum class resume_state
1102 /* Not resumed - we haven't been asked to resume this thread. */
1105 /* We have been asked to resume this thread, but haven't sent a vCont action
1106 for it yet. We'll need to consider it next time commit_resume is
1108 RESUMED_PENDING_VCONT
,
1110 /* We have been asked to resume this thread, and we have sent a vCont action
1115 /* Information about a thread's pending vCont-resume. Used when a thread is in
1116 the remote_resume_state::RESUMED_PENDING_VCONT state. remote_target::resume
1117 stores this information which is then picked up by
1118 remote_target::commit_resume to know which is the proper action for this
1119 thread to include in the vCont packet. */
1120 struct resumed_pending_vcont_info
1122 /* True if the last resume call for this thread was a step request, false
1123 if a continue request. */
1126 /* The signal specified in the last resume call for this thread. */
1130 /* Private data that we'll store in (struct thread_info)->priv. */
1131 struct remote_thread_info
: public private_thread_info
1137 /* Thread handle, perhaps a pthread_t or thread_t value, stored as a
1138 sequence of bytes. */
1139 gdb::byte_vector thread_handle
;
1141 /* Whether the target stopped for a breakpoint/watchpoint. */
1142 enum target_stop_reason stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
1144 /* This is set to the data address of the access causing the target
1145 to stop for a watchpoint. */
1146 CORE_ADDR watch_data_address
= 0;
1148 /* Get the thread's resume state. */
1149 enum resume_state
get_resume_state () const
1151 return m_resume_state
;
1154 /* Put the thread in the NOT_RESUMED state. */
1155 void set_not_resumed ()
1157 m_resume_state
= resume_state::NOT_RESUMED
;
1160 /* Put the thread in the RESUMED_PENDING_VCONT state. */
1161 void set_resumed_pending_vcont (bool step
, gdb_signal sig
)
1163 m_resume_state
= resume_state::RESUMED_PENDING_VCONT
;
1164 m_resumed_pending_vcont_info
.step
= step
;
1165 m_resumed_pending_vcont_info
.sig
= sig
;
1168 /* Get the information this thread's pending vCont-resumption.
1170 Must only be called if the thread is in the RESUMED_PENDING_VCONT resume
1172 const struct resumed_pending_vcont_info
&resumed_pending_vcont_info () const
1174 gdb_assert (m_resume_state
== resume_state::RESUMED_PENDING_VCONT
);
1176 return m_resumed_pending_vcont_info
;
1179 /* Put the thread in the VCONT_RESUMED state. */
1182 m_resume_state
= resume_state::RESUMED
;
1186 /* Resume state for this thread. This is used to implement vCont action
1187 coalescing (only when the target operates in non-stop mode).
1189 remote_target::resume moves the thread to the RESUMED_PENDING_VCONT state,
1190 which notes that this thread must be considered in the next commit_resume
1193 remote_target::commit_resume sends a vCont packet with actions for the
1194 threads in the RESUMED_PENDING_VCONT state and moves them to the
1195 VCONT_RESUMED state.
1197 When reporting a stop to the core for a thread, that thread is moved back
1198 to the NOT_RESUMED state. */
1199 enum resume_state m_resume_state
= resume_state::NOT_RESUMED
;
1201 /* Extra info used if the thread is in the RESUMED_PENDING_VCONT state. */
1202 struct resumed_pending_vcont_info m_resumed_pending_vcont_info
;
1205 remote_state::remote_state ()
1210 remote_state::~remote_state ()
1212 xfree (this->last_pass_packet
);
1213 xfree (this->last_program_signals_packet
);
1214 xfree (this->finished_object
);
1215 xfree (this->finished_annex
);
1218 /* Utility: generate error from an incoming stub packet. */
1220 trace_error (char *buf
)
1223 return; /* not an error msg */
1226 case '1': /* malformed packet error */
1227 if (*++buf
== '0') /* general case: */
1228 error (_("remote.c: error in outgoing packet."));
1230 error (_("remote.c: error in outgoing packet at field #%ld."),
1231 strtol (buf
, NULL
, 16));
1233 error (_("Target returns error code '%s'."), buf
);
1237 /* Utility: wait for reply from stub, while accepting "O" packets. */
1240 remote_target::remote_get_noisy_reply ()
1242 struct remote_state
*rs
= get_remote_state ();
1244 do /* Loop on reply from remote stub. */
1248 QUIT
; /* Allow user to bail out with ^C. */
1249 getpkt (&rs
->buf
, 0);
1250 buf
= rs
->buf
.data ();
1253 else if (startswith (buf
, "qRelocInsn:"))
1256 CORE_ADDR from
, to
, org_to
;
1258 int adjusted_size
= 0;
1261 p
= buf
+ strlen ("qRelocInsn:");
1262 pp
= unpack_varlen_hex (p
, &ul
);
1264 error (_("invalid qRelocInsn packet: %s"), buf
);
1268 unpack_varlen_hex (p
, &ul
);
1275 gdbarch_relocate_instruction (target_gdbarch (), &to
, from
);
1278 catch (const gdb_exception
&ex
)
1280 if (ex
.error
== MEMORY_ERROR
)
1282 /* Propagate memory errors silently back to the
1283 target. The stub may have limited the range of
1284 addresses we can write to, for example. */
1288 /* Something unexpectedly bad happened. Be verbose
1289 so we can tell what, and propagate the error back
1290 to the stub, so it doesn't get stuck waiting for
1292 exception_fprintf (gdb_stderr
, ex
,
1293 _("warning: relocating instruction: "));
1300 adjusted_size
= to
- org_to
;
1302 xsnprintf (buf
, rs
->buf
.size (), "qRelocInsn:%x", adjusted_size
);
1306 else if (buf
[0] == 'O' && buf
[1] != 'K')
1307 remote_console_output (buf
+ 1); /* 'O' message from stub */
1309 return buf
; /* Here's the actual reply. */
1314 struct remote_arch_state
*
1315 remote_state::get_remote_arch_state (struct gdbarch
*gdbarch
)
1317 remote_arch_state
*rsa
;
1319 auto it
= this->m_arch_states
.find (gdbarch
);
1320 if (it
== this->m_arch_states
.end ())
1322 auto p
= this->m_arch_states
.emplace (std::piecewise_construct
,
1323 std::forward_as_tuple (gdbarch
),
1324 std::forward_as_tuple (gdbarch
));
1325 rsa
= &p
.first
->second
;
1327 /* Make sure that the packet buffer is plenty big enough for
1328 this architecture. */
1329 if (this->buf
.size () < rsa
->remote_packet_size
)
1330 this->buf
.resize (2 * rsa
->remote_packet_size
);
1338 /* Fetch the global remote target state. */
1341 remote_target::get_remote_state ()
1343 /* Make sure that the remote architecture state has been
1344 initialized, because doing so might reallocate rs->buf. Any
1345 function which calls getpkt also needs to be mindful of changes
1346 to rs->buf, but this call limits the number of places which run
1348 m_remote_state
.get_remote_arch_state (target_gdbarch ());
1350 return &m_remote_state
;
1353 /* Fetch the remote exec-file from the current program space. */
1356 get_remote_exec_file (void)
1358 char *remote_exec_file
;
1360 remote_exec_file
= remote_pspace_data
.get (current_program_space
);
1361 if (remote_exec_file
== NULL
)
1364 return remote_exec_file
;
1367 /* Set the remote exec file for PSPACE. */
1370 set_pspace_remote_exec_file (struct program_space
*pspace
,
1371 const char *remote_exec_file
)
1373 char *old_file
= remote_pspace_data
.get (pspace
);
1376 remote_pspace_data
.set (pspace
, xstrdup (remote_exec_file
));
1379 /* The "set/show remote exec-file" set command hook. */
1382 set_remote_exec_file (const char *ignored
, int from_tty
,
1383 struct cmd_list_element
*c
)
1385 set_pspace_remote_exec_file (current_program_space
,
1386 remote_exec_file_var
.c_str ());
1389 /* The "set/show remote exec-file" show command hook. */
1392 show_remote_exec_file (struct ui_file
*file
, int from_tty
,
1393 struct cmd_list_element
*cmd
, const char *value
)
1395 fprintf_filtered (file
, "%s\n", get_remote_exec_file ());
1399 map_regcache_remote_table (struct gdbarch
*gdbarch
, struct packet_reg
*regs
)
1401 int regnum
, num_remote_regs
, offset
;
1402 struct packet_reg
**remote_regs
;
1404 for (regnum
= 0; regnum
< gdbarch_num_regs (gdbarch
); regnum
++)
1406 struct packet_reg
*r
= ®s
[regnum
];
1408 if (register_size (gdbarch
, regnum
) == 0)
1409 /* Do not try to fetch zero-sized (placeholder) registers. */
1412 r
->pnum
= gdbarch_remote_register_number (gdbarch
, regnum
);
1417 /* Define the g/G packet format as the contents of each register
1418 with a remote protocol number, in order of ascending protocol
1421 remote_regs
= XALLOCAVEC (struct packet_reg
*, gdbarch_num_regs (gdbarch
));
1422 for (num_remote_regs
= 0, regnum
= 0;
1423 regnum
< gdbarch_num_regs (gdbarch
);
1425 if (regs
[regnum
].pnum
!= -1)
1426 remote_regs
[num_remote_regs
++] = ®s
[regnum
];
1428 std::sort (remote_regs
, remote_regs
+ num_remote_regs
,
1429 [] (const packet_reg
*a
, const packet_reg
*b
)
1430 { return a
->pnum
< b
->pnum
; });
1432 for (regnum
= 0, offset
= 0; regnum
< num_remote_regs
; regnum
++)
1434 remote_regs
[regnum
]->in_g_packet
= 1;
1435 remote_regs
[regnum
]->offset
= offset
;
1436 offset
+= register_size (gdbarch
, remote_regs
[regnum
]->regnum
);
1442 /* Given the architecture described by GDBARCH, return the remote
1443 protocol register's number and the register's offset in the g/G
1444 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
1445 If the target does not have a mapping for REGNUM, return false,
1446 otherwise, return true. */
1449 remote_register_number_and_offset (struct gdbarch
*gdbarch
, int regnum
,
1450 int *pnum
, int *poffset
)
1452 gdb_assert (regnum
< gdbarch_num_regs (gdbarch
));
1454 std::vector
<packet_reg
> regs (gdbarch_num_regs (gdbarch
));
1456 map_regcache_remote_table (gdbarch
, regs
.data ());
1458 *pnum
= regs
[regnum
].pnum
;
1459 *poffset
= regs
[regnum
].offset
;
1464 remote_arch_state::remote_arch_state (struct gdbarch
*gdbarch
)
1466 /* Use the architecture to build a regnum<->pnum table, which will be
1467 1:1 unless a feature set specifies otherwise. */
1468 this->regs
.reset (new packet_reg
[gdbarch_num_regs (gdbarch
)] ());
1470 /* Record the maximum possible size of the g packet - it may turn out
1472 this->sizeof_g_packet
1473 = map_regcache_remote_table (gdbarch
, this->regs
.get ());
1475 /* Default maximum number of characters in a packet body. Many
1476 remote stubs have a hardwired buffer size of 400 bytes
1477 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
1478 as the maximum packet-size to ensure that the packet and an extra
1479 NUL character can always fit in the buffer. This stops GDB
1480 trashing stubs that try to squeeze an extra NUL into what is
1481 already a full buffer (As of 1999-12-04 that was most stubs). */
1482 this->remote_packet_size
= 400 - 1;
1484 /* This one is filled in when a ``g'' packet is received. */
1485 this->actual_register_packet_size
= 0;
1487 /* Should rsa->sizeof_g_packet needs more space than the
1488 default, adjust the size accordingly. Remember that each byte is
1489 encoded as two characters. 32 is the overhead for the packet
1490 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
1491 (``$NN:G...#NN'') is a better guess, the below has been padded a
1493 if (this->sizeof_g_packet
> ((this->remote_packet_size
- 32) / 2))
1494 this->remote_packet_size
= (this->sizeof_g_packet
* 2 + 32);
1497 /* Get a pointer to the current remote target. If not connected to a
1498 remote target, return NULL. */
1500 static remote_target
*
1501 get_current_remote_target ()
1503 target_ops
*proc_target
= current_inferior ()->process_target ();
1504 return dynamic_cast<remote_target
*> (proc_target
);
1507 /* Return the current allowed size of a remote packet. This is
1508 inferred from the current architecture, and should be used to
1509 limit the length of outgoing packets. */
1511 remote_target::get_remote_packet_size ()
1513 struct remote_state
*rs
= get_remote_state ();
1514 remote_arch_state
*rsa
= rs
->get_remote_arch_state (target_gdbarch ());
1516 if (rs
->explicit_packet_size
)
1517 return rs
->explicit_packet_size
;
1519 return rsa
->remote_packet_size
;
1522 static struct packet_reg
*
1523 packet_reg_from_regnum (struct gdbarch
*gdbarch
, struct remote_arch_state
*rsa
,
1526 if (regnum
< 0 && regnum
>= gdbarch_num_regs (gdbarch
))
1530 struct packet_reg
*r
= &rsa
->regs
[regnum
];
1532 gdb_assert (r
->regnum
== regnum
);
1537 static struct packet_reg
*
1538 packet_reg_from_pnum (struct gdbarch
*gdbarch
, struct remote_arch_state
*rsa
,
1543 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
1545 struct packet_reg
*r
= &rsa
->regs
[i
];
1547 if (r
->pnum
== pnum
)
1553 /* Allow the user to specify what sequence to send to the remote
1554 when he requests a program interruption: Although ^C is usually
1555 what remote systems expect (this is the default, here), it is
1556 sometimes preferable to send a break. On other systems such
1557 as the Linux kernel, a break followed by g, which is Magic SysRq g
1558 is required in order to interrupt the execution. */
1559 const char interrupt_sequence_control_c
[] = "Ctrl-C";
1560 const char interrupt_sequence_break
[] = "BREAK";
1561 const char interrupt_sequence_break_g
[] = "BREAK-g";
1562 static const char *const interrupt_sequence_modes
[] =
1564 interrupt_sequence_control_c
,
1565 interrupt_sequence_break
,
1566 interrupt_sequence_break_g
,
1569 static const char *interrupt_sequence_mode
= interrupt_sequence_control_c
;
1572 show_interrupt_sequence (struct ui_file
*file
, int from_tty
,
1573 struct cmd_list_element
*c
,
1576 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
1577 fprintf_filtered (file
,
1578 _("Send the ASCII ETX character (Ctrl-c) "
1579 "to the remote target to interrupt the "
1580 "execution of the program.\n"));
1581 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
1582 fprintf_filtered (file
,
1583 _("send a break signal to the remote target "
1584 "to interrupt the execution of the program.\n"));
1585 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
1586 fprintf_filtered (file
,
1587 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
1588 "the remote target to interrupt the execution "
1589 "of Linux kernel.\n"));
1591 internal_error (__FILE__
, __LINE__
,
1592 _("Invalid value for interrupt_sequence_mode: %s."),
1593 interrupt_sequence_mode
);
1596 /* This boolean variable specifies whether interrupt_sequence is sent
1597 to the remote target when gdb connects to it.
1598 This is mostly needed when you debug the Linux kernel: The Linux kernel
1599 expects BREAK g which is Magic SysRq g for connecting gdb. */
1600 static bool interrupt_on_connect
= false;
1602 /* This variable is used to implement the "set/show remotebreak" commands.
1603 Since these commands are now deprecated in favor of "set/show remote
1604 interrupt-sequence", it no longer has any effect on the code. */
1605 static bool remote_break
;
1608 set_remotebreak (const char *args
, int from_tty
, struct cmd_list_element
*c
)
1611 interrupt_sequence_mode
= interrupt_sequence_break
;
1613 interrupt_sequence_mode
= interrupt_sequence_control_c
;
1617 show_remotebreak (struct ui_file
*file
, int from_tty
,
1618 struct cmd_list_element
*c
,
1623 /* This variable sets the number of bits in an address that are to be
1624 sent in a memory ("M" or "m") packet. Normally, after stripping
1625 leading zeros, the entire address would be sent. This variable
1626 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
1627 initial implementation of remote.c restricted the address sent in
1628 memory packets to ``host::sizeof long'' bytes - (typically 32
1629 bits). Consequently, for 64 bit targets, the upper 32 bits of an
1630 address was never sent. Since fixing this bug may cause a break in
1631 some remote targets this variable is principally provided to
1632 facilitate backward compatibility. */
1634 static unsigned int remote_address_size
;
1637 /* User configurable variables for the number of characters in a
1638 memory read/write packet. MIN (rsa->remote_packet_size,
1639 rsa->sizeof_g_packet) is the default. Some targets need smaller
1640 values (fifo overruns, et.al.) and some users need larger values
1641 (speed up transfers). The variables ``preferred_*'' (the user
1642 request), ``current_*'' (what was actually set) and ``forced_*''
1643 (Positive - a soft limit, negative - a hard limit). */
1645 struct memory_packet_config
1652 /* The default max memory-write-packet-size, when the setting is
1653 "fixed". The 16k is historical. (It came from older GDB's using
1654 alloca for buffers and the knowledge (folklore?) that some hosts
1655 don't cope very well with large alloca calls.) */
1656 #define DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED 16384
1658 /* The minimum remote packet size for memory transfers. Ensures we
1659 can write at least one byte. */
1660 #define MIN_MEMORY_PACKET_SIZE 20
1662 /* Get the memory packet size, assuming it is fixed. */
1665 get_fixed_memory_packet_size (struct memory_packet_config
*config
)
1667 gdb_assert (config
->fixed_p
);
1669 if (config
->size
<= 0)
1670 return DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
;
1672 return config
->size
;
1675 /* Compute the current size of a read/write packet. Since this makes
1676 use of ``actual_register_packet_size'' the computation is dynamic. */
1679 remote_target::get_memory_packet_size (struct memory_packet_config
*config
)
1681 struct remote_state
*rs
= get_remote_state ();
1682 remote_arch_state
*rsa
= rs
->get_remote_arch_state (target_gdbarch ());
1685 if (config
->fixed_p
)
1686 what_they_get
= get_fixed_memory_packet_size (config
);
1689 what_they_get
= get_remote_packet_size ();
1690 /* Limit the packet to the size specified by the user. */
1691 if (config
->size
> 0
1692 && what_they_get
> config
->size
)
1693 what_they_get
= config
->size
;
1695 /* Limit it to the size of the targets ``g'' response unless we have
1696 permission from the stub to use a larger packet size. */
1697 if (rs
->explicit_packet_size
== 0
1698 && rsa
->actual_register_packet_size
> 0
1699 && what_they_get
> rsa
->actual_register_packet_size
)
1700 what_they_get
= rsa
->actual_register_packet_size
;
1702 if (what_they_get
< MIN_MEMORY_PACKET_SIZE
)
1703 what_they_get
= MIN_MEMORY_PACKET_SIZE
;
1705 /* Make sure there is room in the global buffer for this packet
1706 (including its trailing NUL byte). */
1707 if (rs
->buf
.size () < what_they_get
+ 1)
1708 rs
->buf
.resize (2 * what_they_get
);
1710 return what_they_get
;
1713 /* Update the size of a read/write packet. If they user wants
1714 something really big then do a sanity check. */
1717 set_memory_packet_size (const char *args
, struct memory_packet_config
*config
)
1719 int fixed_p
= config
->fixed_p
;
1720 long size
= config
->size
;
1723 error (_("Argument required (integer, `fixed' or `limited')."));
1724 else if (strcmp (args
, "hard") == 0
1725 || strcmp (args
, "fixed") == 0)
1727 else if (strcmp (args
, "soft") == 0
1728 || strcmp (args
, "limit") == 0)
1734 size
= strtoul (args
, &end
, 0);
1736 error (_("Invalid %s (bad syntax)."), config
->name
);
1738 /* Instead of explicitly capping the size of a packet to or
1739 disallowing it, the user is allowed to set the size to
1740 something arbitrarily large. */
1744 if (fixed_p
&& !config
->fixed_p
)
1746 /* So that the query shows the correct value. */
1747 long query_size
= (size
<= 0
1748 ? DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
1751 if (! query (_("The target may not be able to correctly handle a %s\n"
1752 "of %ld bytes. Change the packet size? "),
1753 config
->name
, query_size
))
1754 error (_("Packet size not changed."));
1756 /* Update the config. */
1757 config
->fixed_p
= fixed_p
;
1758 config
->size
= size
;
1762 show_memory_packet_size (struct memory_packet_config
*config
)
1764 if (config
->size
== 0)
1765 printf_filtered (_("The %s is 0 (default). "), config
->name
);
1767 printf_filtered (_("The %s is %ld. "), config
->name
, config
->size
);
1768 if (config
->fixed_p
)
1769 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
1770 get_fixed_memory_packet_size (config
));
1773 remote_target
*remote
= get_current_remote_target ();
1776 printf_filtered (_("Packets are limited to %ld bytes.\n"),
1777 remote
->get_memory_packet_size (config
));
1779 puts_filtered ("The actual limit will be further reduced "
1780 "dependent on the target.\n");
1784 /* FIXME: needs to be per-remote-target. */
1785 static struct memory_packet_config memory_write_packet_config
=
1787 "memory-write-packet-size",
1791 set_memory_write_packet_size (const char *args
, int from_tty
)
1793 set_memory_packet_size (args
, &memory_write_packet_config
);
1797 show_memory_write_packet_size (const char *args
, int from_tty
)
1799 show_memory_packet_size (&memory_write_packet_config
);
1802 /* Show the number of hardware watchpoints that can be used. */
1805 show_hardware_watchpoint_limit (struct ui_file
*file
, int from_tty
,
1806 struct cmd_list_element
*c
,
1809 fprintf_filtered (file
, _("The maximum number of target hardware "
1810 "watchpoints is %s.\n"), value
);
1813 /* Show the length limit (in bytes) for hardware watchpoints. */
1816 show_hardware_watchpoint_length_limit (struct ui_file
*file
, int from_tty
,
1817 struct cmd_list_element
*c
,
1820 fprintf_filtered (file
, _("The maximum length (in bytes) of a target "
1821 "hardware watchpoint is %s.\n"), value
);
1824 /* Show the number of hardware breakpoints that can be used. */
1827 show_hardware_breakpoint_limit (struct ui_file
*file
, int from_tty
,
1828 struct cmd_list_element
*c
,
1831 fprintf_filtered (file
, _("The maximum number of target hardware "
1832 "breakpoints is %s.\n"), value
);
1835 /* Controls the maximum number of characters to display in the debug output
1836 for each remote packet. The remaining characters are omitted. */
1838 static int remote_packet_max_chars
= 512;
1840 /* Show the maximum number of characters to display for each remote packet
1841 when remote debugging is enabled. */
1844 show_remote_packet_max_chars (struct ui_file
*file
, int from_tty
,
1845 struct cmd_list_element
*c
,
1848 fprintf_filtered (file
, _("Number of remote packet characters to "
1849 "display is %s.\n"), value
);
1853 remote_target::get_memory_write_packet_size ()
1855 return get_memory_packet_size (&memory_write_packet_config
);
1858 /* FIXME: needs to be per-remote-target. */
1859 static struct memory_packet_config memory_read_packet_config
=
1861 "memory-read-packet-size",
1865 set_memory_read_packet_size (const char *args
, int from_tty
)
1867 set_memory_packet_size (args
, &memory_read_packet_config
);
1871 show_memory_read_packet_size (const char *args
, int from_tty
)
1873 show_memory_packet_size (&memory_read_packet_config
);
1877 remote_target::get_memory_read_packet_size ()
1879 long size
= get_memory_packet_size (&memory_read_packet_config
);
1881 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1882 extra buffer size argument before the memory read size can be
1883 increased beyond this. */
1884 if (size
> get_remote_packet_size ())
1885 size
= get_remote_packet_size ();
1891 struct packet_config
1896 /* If auto, GDB auto-detects support for this packet or feature,
1897 either through qSupported, or by trying the packet and looking
1898 at the response. If true, GDB assumes the target supports this
1899 packet. If false, the packet is disabled. Configs that don't
1900 have an associated command always have this set to auto. */
1901 enum auto_boolean detect
;
1903 /* The "show remote foo-packet" command created for this packet. */
1904 cmd_list_element
*show_cmd
;
1906 /* Does the target support this packet? */
1907 enum packet_support support
;
1910 static enum packet_support
packet_config_support (struct packet_config
*config
);
1911 static enum packet_support
packet_support (int packet
);
1914 show_packet_config_cmd (ui_file
*file
, struct packet_config
*config
)
1916 const char *support
= "internal-error";
1918 switch (packet_config_support (config
))
1921 support
= "enabled";
1923 case PACKET_DISABLE
:
1924 support
= "disabled";
1926 case PACKET_SUPPORT_UNKNOWN
:
1927 support
= "unknown";
1930 switch (config
->detect
)
1932 case AUTO_BOOLEAN_AUTO
:
1933 fprintf_filtered (file
,
1934 _("Support for the `%s' packet "
1935 "is auto-detected, currently %s.\n"),
1936 config
->name
, support
);
1938 case AUTO_BOOLEAN_TRUE
:
1939 case AUTO_BOOLEAN_FALSE
:
1940 fprintf_filtered (file
,
1941 _("Support for the `%s' packet is currently %s.\n"),
1942 config
->name
, support
);
1948 add_packet_config_cmd (struct packet_config
*config
, const char *name
,
1949 const char *title
, int legacy
)
1951 config
->name
= name
;
1952 config
->title
= title
;
1953 gdb::unique_xmalloc_ptr
<char> set_doc
1954 = xstrprintf ("Set use of remote protocol `%s' (%s) packet.",
1956 gdb::unique_xmalloc_ptr
<char> show_doc
1957 = xstrprintf ("Show current use of remote protocol `%s' (%s) packet.",
1959 /* set/show TITLE-packet {auto,on,off} */
1960 gdb::unique_xmalloc_ptr
<char> cmd_name
= xstrprintf ("%s-packet", title
);
1961 set_show_commands cmds
1962 = add_setshow_auto_boolean_cmd (cmd_name
.release (), class_obscure
,
1963 &config
->detect
, set_doc
.get (),
1964 show_doc
.get (), NULL
, /* help_doc */
1966 show_remote_protocol_packet_cmd
,
1967 &remote_set_cmdlist
, &remote_show_cmdlist
);
1968 config
->show_cmd
= cmds
.show
;
1970 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1973 /* It's not clear who should take ownership of this string, so, for
1974 now, make it static, and give copies to each of the add_alias_cmd
1976 static gdb::unique_xmalloc_ptr
<char> legacy_name
1977 = xstrprintf ("%s-packet", name
);
1978 add_alias_cmd (legacy_name
.get (), cmds
.set
, class_obscure
, 0,
1979 &remote_set_cmdlist
);
1980 add_alias_cmd (legacy_name
.get (), cmds
.show
, class_obscure
, 0,
1981 &remote_show_cmdlist
);
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, then default to
3151 what's in inferior_ptid, unless it's null at this point. If so,
3152 then since there's no way to know the pid of the reported
3153 threads, use the magic number. */
3154 if (inferior_ptid
== null_ptid
)
3155 pid
= magic_null_ptid
.pid ();
3157 pid
= inferior_ptid
.pid ();
3161 return ptid_t (pid
, tid
);
3167 if (ch
>= 'a' && ch
<= 'f')
3168 return ch
- 'a' + 10;
3169 if (ch
>= '0' && ch
<= '9')
3171 if (ch
>= 'A' && ch
<= 'F')
3172 return ch
- 'A' + 10;
3177 stub_unpack_int (const char *buff
, int fieldlength
)
3184 nibble
= stubhex (*buff
++);
3188 retval
= retval
<< 4;
3194 unpack_nibble (const char *buf
, int *val
)
3196 *val
= fromhex (*buf
++);
3201 unpack_byte (const char *buf
, int *value
)
3203 *value
= stub_unpack_int (buf
, 2);
3208 pack_int (char *buf
, int value
)
3210 buf
= pack_hex_byte (buf
, (value
>> 24) & 0xff);
3211 buf
= pack_hex_byte (buf
, (value
>> 16) & 0xff);
3212 buf
= pack_hex_byte (buf
, (value
>> 8) & 0x0ff);
3213 buf
= pack_hex_byte (buf
, (value
& 0xff));
3218 unpack_int (const char *buf
, int *value
)
3220 *value
= stub_unpack_int (buf
, 8);
3224 #if 0 /* Currently unused, uncomment when needed. */
3225 static char *pack_string (char *pkt
, char *string
);
3228 pack_string (char *pkt
, char *string
)
3233 len
= strlen (string
);
3235 len
= 200; /* Bigger than most GDB packets, junk??? */
3236 pkt
= pack_hex_byte (pkt
, len
);
3240 if ((ch
== '\0') || (ch
== '#'))
3241 ch
= '*'; /* Protect encapsulation. */
3246 #endif /* 0 (unused) */
3249 unpack_string (const char *src
, char *dest
, int length
)
3258 pack_threadid (char *pkt
, threadref
*id
)
3261 unsigned char *altid
;
3263 altid
= (unsigned char *) id
;
3264 limit
= pkt
+ BUF_THREAD_ID_SIZE
;
3266 pkt
= pack_hex_byte (pkt
, *altid
++);
3272 unpack_threadid (const char *inbuf
, threadref
*id
)
3275 const char *limit
= inbuf
+ BUF_THREAD_ID_SIZE
;
3278 altref
= (char *) id
;
3280 while (inbuf
< limit
)
3282 x
= stubhex (*inbuf
++);
3283 y
= stubhex (*inbuf
++);
3284 *altref
++ = (x
<< 4) | y
;
3289 /* Externally, threadrefs are 64 bits but internally, they are still
3290 ints. This is due to a mismatch of specifications. We would like
3291 to use 64bit thread references internally. This is an adapter
3295 int_to_threadref (threadref
*id
, int value
)
3297 unsigned char *scan
;
3299 scan
= (unsigned char *) id
;
3305 *scan
++ = (value
>> 24) & 0xff;
3306 *scan
++ = (value
>> 16) & 0xff;
3307 *scan
++ = (value
>> 8) & 0xff;
3308 *scan
++ = (value
& 0xff);
3312 threadref_to_int (threadref
*ref
)
3315 unsigned char *scan
;
3321 value
= (value
<< 8) | ((*scan
++) & 0xff);
3326 copy_threadref (threadref
*dest
, threadref
*src
)
3329 unsigned char *csrc
, *cdest
;
3331 csrc
= (unsigned char *) src
;
3332 cdest
= (unsigned char *) dest
;
3339 threadmatch (threadref
*dest
, threadref
*src
)
3341 /* Things are broken right now, so just assume we got a match. */
3343 unsigned char *srcp
, *destp
;
3345 srcp
= (char *) src
;
3346 destp
= (char *) dest
;
3350 result
&= (*srcp
++ == *destp
++) ? 1 : 0;
3357 threadid:1, # always request threadid
3364 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
3367 pack_threadinfo_request (char *pkt
, int mode
, threadref
*id
)
3369 *pkt
++ = 'q'; /* Info Query */
3370 *pkt
++ = 'P'; /* process or thread info */
3371 pkt
= pack_int (pkt
, mode
); /* mode */
3372 pkt
= pack_threadid (pkt
, id
); /* threadid */
3373 *pkt
= '\0'; /* terminate */
3377 /* These values tag the fields in a thread info response packet. */
3378 /* Tagging the fields allows us to request specific fields and to
3379 add more fields as time goes by. */
3381 #define TAG_THREADID 1 /* Echo the thread identifier. */
3382 #define TAG_EXISTS 2 /* Is this process defined enough to
3383 fetch registers and its stack? */
3384 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
3385 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
3386 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
3390 remote_target::remote_unpack_thread_info_response (const char *pkt
,
3391 threadref
*expectedref
,
3392 gdb_ext_thread_info
*info
)
3394 struct remote_state
*rs
= get_remote_state ();
3398 const char *limit
= pkt
+ rs
->buf
.size (); /* Plausible parsing limit. */
3401 /* info->threadid = 0; FIXME: implement zero_threadref. */
3403 info
->display
[0] = '\0';
3404 info
->shortname
[0] = '\0';
3405 info
->more_display
[0] = '\0';
3407 /* Assume the characters indicating the packet type have been
3409 pkt
= unpack_int (pkt
, &mask
); /* arg mask */
3410 pkt
= unpack_threadid (pkt
, &ref
);
3413 warning (_("Incomplete response to threadinfo request."));
3414 if (!threadmatch (&ref
, expectedref
))
3415 { /* This is an answer to a different request. */
3416 warning (_("ERROR RMT Thread info mismatch."));
3419 copy_threadref (&info
->threadid
, &ref
);
3421 /* Loop on tagged fields , try to bail if something goes wrong. */
3423 /* Packets are terminated with nulls. */
3424 while ((pkt
< limit
) && mask
&& *pkt
)
3426 pkt
= unpack_int (pkt
, &tag
); /* tag */
3427 pkt
= unpack_byte (pkt
, &length
); /* length */
3428 if (!(tag
& mask
)) /* Tags out of synch with mask. */
3430 warning (_("ERROR RMT: threadinfo tag mismatch."));
3434 if (tag
== TAG_THREADID
)
3438 warning (_("ERROR RMT: length of threadid is not 16."));
3442 pkt
= unpack_threadid (pkt
, &ref
);
3443 mask
= mask
& ~TAG_THREADID
;
3446 if (tag
== TAG_EXISTS
)
3448 info
->active
= stub_unpack_int (pkt
, length
);
3450 mask
= mask
& ~(TAG_EXISTS
);
3453 warning (_("ERROR RMT: 'exists' length too long."));
3459 if (tag
== TAG_THREADNAME
)
3461 pkt
= unpack_string (pkt
, &info
->shortname
[0], length
);
3462 mask
= mask
& ~TAG_THREADNAME
;
3465 if (tag
== TAG_DISPLAY
)
3467 pkt
= unpack_string (pkt
, &info
->display
[0], length
);
3468 mask
= mask
& ~TAG_DISPLAY
;
3471 if (tag
== TAG_MOREDISPLAY
)
3473 pkt
= unpack_string (pkt
, &info
->more_display
[0], length
);
3474 mask
= mask
& ~TAG_MOREDISPLAY
;
3477 warning (_("ERROR RMT: unknown thread info tag."));
3478 break; /* Not a tag we know about. */
3484 remote_target::remote_get_threadinfo (threadref
*threadid
,
3486 gdb_ext_thread_info
*info
)
3488 struct remote_state
*rs
= get_remote_state ();
3491 pack_threadinfo_request (rs
->buf
.data (), fieldset
, threadid
);
3493 getpkt (&rs
->buf
, 0);
3495 if (rs
->buf
[0] == '\0')
3498 result
= remote_unpack_thread_info_response (&rs
->buf
[2],
3503 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
3506 pack_threadlist_request (char *pkt
, int startflag
, int threadcount
,
3507 threadref
*nextthread
)
3509 *pkt
++ = 'q'; /* info query packet */
3510 *pkt
++ = 'L'; /* Process LIST or threadLIST request */
3511 pkt
= pack_nibble (pkt
, startflag
); /* initflag 1 bytes */
3512 pkt
= pack_hex_byte (pkt
, threadcount
); /* threadcount 2 bytes */
3513 pkt
= pack_threadid (pkt
, nextthread
); /* 64 bit thread identifier */
3518 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
3521 remote_target::parse_threadlist_response (const char *pkt
, int result_limit
,
3522 threadref
*original_echo
,
3523 threadref
*resultlist
,
3526 struct remote_state
*rs
= get_remote_state ();
3527 int count
, resultcount
, done
;
3530 /* Assume the 'q' and 'M chars have been stripped. */
3531 const char *limit
= pkt
+ (rs
->buf
.size () - BUF_THREAD_ID_SIZE
);
3532 /* done parse past here */
3533 pkt
= unpack_byte (pkt
, &count
); /* count field */
3534 pkt
= unpack_nibble (pkt
, &done
);
3535 /* The first threadid is the argument threadid. */
3536 pkt
= unpack_threadid (pkt
, original_echo
); /* should match query packet */
3537 while ((count
-- > 0) && (pkt
< limit
))
3539 pkt
= unpack_threadid (pkt
, resultlist
++);
3540 if (resultcount
++ >= result_limit
)
3548 /* Fetch the next batch of threads from the remote. Returns -1 if the
3549 qL packet is not supported, 0 on error and 1 on success. */
3552 remote_target::remote_get_threadlist (int startflag
, threadref
*nextthread
,
3553 int result_limit
, int *done
, int *result_count
,
3554 threadref
*threadlist
)
3556 struct remote_state
*rs
= get_remote_state ();
3559 /* Truncate result limit to be smaller than the packet size. */
3560 if ((((result_limit
+ 1) * BUF_THREAD_ID_SIZE
) + 10)
3561 >= get_remote_packet_size ())
3562 result_limit
= (get_remote_packet_size () / BUF_THREAD_ID_SIZE
) - 2;
3564 pack_threadlist_request (rs
->buf
.data (), startflag
, result_limit
,
3567 getpkt (&rs
->buf
, 0);
3568 if (rs
->buf
[0] == '\0')
3570 /* Packet not supported. */
3575 parse_threadlist_response (&rs
->buf
[2], result_limit
,
3576 &rs
->echo_nextthread
, threadlist
, done
);
3578 if (!threadmatch (&rs
->echo_nextthread
, nextthread
))
3580 /* FIXME: This is a good reason to drop the packet. */
3581 /* Possibly, there is a duplicate response. */
3583 retransmit immediatly - race conditions
3584 retransmit after timeout - yes
3586 wait for packet, then exit
3588 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
3589 return 0; /* I choose simply exiting. */
3591 if (*result_count
<= 0)
3595 warning (_("RMT ERROR : failed to get remote thread list."));
3598 return result
; /* break; */
3600 if (*result_count
> result_limit
)
3603 warning (_("RMT ERROR: threadlist response longer than requested."));
3609 /* Fetch the list of remote threads, with the qL packet, and call
3610 STEPFUNCTION for each thread found. Stops iterating and returns 1
3611 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
3612 STEPFUNCTION returns false. If the packet is not supported,
3616 remote_target::remote_threadlist_iterator (rmt_thread_action stepfunction
,
3617 void *context
, int looplimit
)
3619 struct remote_state
*rs
= get_remote_state ();
3620 int done
, i
, result_count
;
3628 if (loopcount
++ > looplimit
)
3631 warning (_("Remote fetch threadlist -infinite loop-."));
3634 result
= remote_get_threadlist (startflag
, &rs
->nextthread
,
3635 MAXTHREADLISTRESULTS
,
3636 &done
, &result_count
,
3637 rs
->resultthreadlist
);
3640 /* Clear for later iterations. */
3642 /* Setup to resume next batch of thread references, set nextthread. */
3643 if (result_count
>= 1)
3644 copy_threadref (&rs
->nextthread
,
3645 &rs
->resultthreadlist
[result_count
- 1]);
3647 while (result_count
--)
3649 if (!(*stepfunction
) (&rs
->resultthreadlist
[i
++], context
))
3659 /* A thread found on the remote target. */
3663 explicit thread_item (ptid_t ptid_
)
3667 thread_item (thread_item
&&other
) = default;
3668 thread_item
&operator= (thread_item
&&other
) = default;
3670 DISABLE_COPY_AND_ASSIGN (thread_item
);
3672 /* The thread's PTID. */
3675 /* The thread's extra info. */
3678 /* The thread's name. */
3681 /* The core the thread was running on. -1 if not known. */
3684 /* The thread handle associated with the thread. */
3685 gdb::byte_vector thread_handle
;
3688 /* Context passed around to the various methods listing remote
3689 threads. As new threads are found, they're added to the ITEMS
3692 struct threads_listing_context
3694 /* Return true if this object contains an entry for a thread with ptid
3697 bool contains_thread (ptid_t ptid
) const
3699 auto match_ptid
= [&] (const thread_item
&item
)
3701 return item
.ptid
== ptid
;
3704 auto it
= std::find_if (this->items
.begin (),
3708 return it
!= this->items
.end ();
3711 /* Remove the thread with ptid PTID. */
3713 void remove_thread (ptid_t ptid
)
3715 auto match_ptid
= [&] (const thread_item
&item
)
3717 return item
.ptid
== ptid
;
3720 auto it
= std::remove_if (this->items
.begin (),
3724 if (it
!= this->items
.end ())
3725 this->items
.erase (it
);
3728 /* The threads found on the remote target. */
3729 std::vector
<thread_item
> items
;
3733 remote_newthread_step (threadref
*ref
, void *data
)
3735 struct threads_listing_context
*context
3736 = (struct threads_listing_context
*) data
;
3737 int pid
= inferior_ptid
.pid ();
3738 int lwp
= threadref_to_int (ref
);
3739 ptid_t
ptid (pid
, lwp
);
3741 context
->items
.emplace_back (ptid
);
3743 return 1; /* continue iterator */
3746 #define CRAZY_MAX_THREADS 1000
3749 remote_target::remote_current_thread (ptid_t oldpid
)
3751 struct remote_state
*rs
= get_remote_state ();
3754 getpkt (&rs
->buf
, 0);
3755 if (rs
->buf
[0] == 'Q' && rs
->buf
[1] == 'C')
3760 result
= read_ptid (&rs
->buf
[2], &obuf
);
3762 remote_debug_printf ("warning: garbage in qC reply");
3770 /* List remote threads using the deprecated qL packet. */
3773 remote_target::remote_get_threads_with_ql (threads_listing_context
*context
)
3775 if (remote_threadlist_iterator (remote_newthread_step
, context
,
3776 CRAZY_MAX_THREADS
) >= 0)
3782 #if defined(HAVE_LIBEXPAT)
3785 start_thread (struct gdb_xml_parser
*parser
,
3786 const struct gdb_xml_element
*element
,
3788 std::vector
<gdb_xml_value
> &attributes
)
3790 struct threads_listing_context
*data
3791 = (struct threads_listing_context
*) user_data
;
3792 struct gdb_xml_value
*attr
;
3794 char *id
= (char *) xml_find_attribute (attributes
, "id")->value
.get ();
3795 ptid_t ptid
= read_ptid (id
, NULL
);
3797 data
->items
.emplace_back (ptid
);
3798 thread_item
&item
= data
->items
.back ();
3800 attr
= xml_find_attribute (attributes
, "core");
3802 item
.core
= *(ULONGEST
*) attr
->value
.get ();
3804 attr
= xml_find_attribute (attributes
, "name");
3806 item
.name
= (const char *) attr
->value
.get ();
3808 attr
= xml_find_attribute (attributes
, "handle");
3810 item
.thread_handle
= hex2bin ((const char *) attr
->value
.get ());
3814 end_thread (struct gdb_xml_parser
*parser
,
3815 const struct gdb_xml_element
*element
,
3816 void *user_data
, const char *body_text
)
3818 struct threads_listing_context
*data
3819 = (struct threads_listing_context
*) user_data
;
3821 if (body_text
!= NULL
&& *body_text
!= '\0')
3822 data
->items
.back ().extra
= body_text
;
3825 const struct gdb_xml_attribute thread_attributes
[] = {
3826 { "id", GDB_XML_AF_NONE
, NULL
, NULL
},
3827 { "core", GDB_XML_AF_OPTIONAL
, gdb_xml_parse_attr_ulongest
, NULL
},
3828 { "name", GDB_XML_AF_OPTIONAL
, NULL
, NULL
},
3829 { "handle", GDB_XML_AF_OPTIONAL
, NULL
, NULL
},
3830 { NULL
, GDB_XML_AF_NONE
, NULL
, NULL
}
3833 const struct gdb_xml_element thread_children
[] = {
3834 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3837 const struct gdb_xml_element threads_children
[] = {
3838 { "thread", thread_attributes
, thread_children
,
3839 GDB_XML_EF_REPEATABLE
| GDB_XML_EF_OPTIONAL
,
3840 start_thread
, end_thread
},
3841 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3844 const struct gdb_xml_element threads_elements
[] = {
3845 { "threads", NULL
, threads_children
,
3846 GDB_XML_EF_NONE
, NULL
, NULL
},
3847 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3852 /* List remote threads using qXfer:threads:read. */
3855 remote_target::remote_get_threads_with_qxfer (threads_listing_context
*context
)
3857 #if defined(HAVE_LIBEXPAT)
3858 if (packet_support (PACKET_qXfer_threads
) == PACKET_ENABLE
)
3860 gdb::optional
<gdb::char_vector
> xml
3861 = target_read_stralloc (this, TARGET_OBJECT_THREADS
, NULL
);
3863 if (xml
&& (*xml
)[0] != '\0')
3865 gdb_xml_parse_quick (_("threads"), "threads.dtd",
3866 threads_elements
, xml
->data (), context
);
3876 /* List remote threads using qfThreadInfo/qsThreadInfo. */
3879 remote_target::remote_get_threads_with_qthreadinfo (threads_listing_context
*context
)
3881 struct remote_state
*rs
= get_remote_state ();
3883 if (rs
->use_threadinfo_query
)
3887 putpkt ("qfThreadInfo");
3888 getpkt (&rs
->buf
, 0);
3889 bufp
= rs
->buf
.data ();
3890 if (bufp
[0] != '\0') /* q packet recognized */
3892 while (*bufp
++ == 'm') /* reply contains one or more TID */
3896 ptid_t ptid
= read_ptid (bufp
, &bufp
);
3897 context
->items
.emplace_back (ptid
);
3899 while (*bufp
++ == ','); /* comma-separated list */
3900 putpkt ("qsThreadInfo");
3901 getpkt (&rs
->buf
, 0);
3902 bufp
= rs
->buf
.data ();
3908 /* Packet not recognized. */
3909 rs
->use_threadinfo_query
= 0;
3916 /* Return true if INF only has one non-exited thread. */
3919 has_single_non_exited_thread (inferior
*inf
)
3922 for (thread_info
*tp ATTRIBUTE_UNUSED
: inf
->non_exited_threads ())
3928 /* Implement the to_update_thread_list function for the remote
3932 remote_target::update_thread_list ()
3934 struct threads_listing_context context
;
3937 /* We have a few different mechanisms to fetch the thread list. Try
3938 them all, starting with the most preferred one first, falling
3939 back to older methods. */
3940 if (remote_get_threads_with_qxfer (&context
)
3941 || remote_get_threads_with_qthreadinfo (&context
)
3942 || remote_get_threads_with_ql (&context
))
3946 if (context
.items
.empty ()
3947 && remote_thread_always_alive (inferior_ptid
))
3949 /* Some targets don't really support threads, but still
3950 reply an (empty) thread list in response to the thread
3951 listing packets, instead of replying "packet not
3952 supported". Exit early so we don't delete the main
3957 /* CONTEXT now holds the current thread list on the remote
3958 target end. Delete GDB-side threads no longer found on the
3960 for (thread_info
*tp
: all_threads_safe ())
3962 if (tp
->inf
->process_target () != this)
3965 if (!context
.contains_thread (tp
->ptid
))
3967 /* Do not remove the thread if it is the last thread in
3968 the inferior. This situation happens when we have a
3969 pending exit process status to process. Otherwise we
3970 may end up with a seemingly live inferior (i.e. pid
3971 != 0) that has no threads. */
3972 if (has_single_non_exited_thread (tp
->inf
))
3980 /* Remove any unreported fork child threads from CONTEXT so
3981 that we don't interfere with follow fork, which is where
3982 creation of such threads is handled. */
3983 remove_new_fork_children (&context
);
3985 /* And now add threads we don't know about yet to our list. */
3986 for (thread_item
&item
: context
.items
)
3988 if (item
.ptid
!= null_ptid
)
3990 /* In non-stop mode, we assume new found threads are
3991 executing until proven otherwise with a stop reply.
3992 In all-stop, we can only get here if all threads are
3994 bool executing
= target_is_non_stop_p ();
3996 remote_notice_new_inferior (item
.ptid
, executing
);
3998 thread_info
*tp
= find_thread_ptid (this, item
.ptid
);
3999 remote_thread_info
*info
= get_remote_thread_info (tp
);
4000 info
->core
= item
.core
;
4001 info
->extra
= std::move (item
.extra
);
4002 info
->name
= std::move (item
.name
);
4003 info
->thread_handle
= std::move (item
.thread_handle
);
4010 /* If no thread listing method is supported, then query whether
4011 each known thread is alive, one by one, with the T packet.
4012 If the target doesn't support threads at all, then this is a
4013 no-op. See remote_thread_alive. */
4019 * Collect a descriptive string about the given thread.
4020 * The target may say anything it wants to about the thread
4021 * (typically info about its blocked / runnable state, name, etc.).
4022 * This string will appear in the info threads display.
4024 * Optional: targets are not required to implement this function.
4028 remote_target::extra_thread_info (thread_info
*tp
)
4030 struct remote_state
*rs
= get_remote_state ();
4033 struct gdb_ext_thread_info threadinfo
;
4035 if (rs
->remote_desc
== 0) /* paranoia */
4036 internal_error (__FILE__
, __LINE__
,
4037 _("remote_threads_extra_info"));
4039 if (tp
->ptid
== magic_null_ptid
4040 || (tp
->ptid
.pid () != 0 && tp
->ptid
.lwp () == 0))
4041 /* This is the main thread which was added by GDB. The remote
4042 server doesn't know about it. */
4045 std::string
&extra
= get_remote_thread_info (tp
)->extra
;
4047 /* If already have cached info, use it. */
4048 if (!extra
.empty ())
4049 return extra
.c_str ();
4051 if (packet_support (PACKET_qXfer_threads
) == PACKET_ENABLE
)
4053 /* If we're using qXfer:threads:read, then the extra info is
4054 included in the XML. So if we didn't have anything cached,
4055 it's because there's really no extra info. */
4059 if (rs
->use_threadextra_query
)
4061 char *b
= rs
->buf
.data ();
4062 char *endb
= b
+ get_remote_packet_size ();
4064 xsnprintf (b
, endb
- b
, "qThreadExtraInfo,");
4066 write_ptid (b
, endb
, tp
->ptid
);
4069 getpkt (&rs
->buf
, 0);
4070 if (rs
->buf
[0] != 0)
4072 extra
.resize (strlen (rs
->buf
.data ()) / 2);
4073 hex2bin (rs
->buf
.data (), (gdb_byte
*) &extra
[0], extra
.size ());
4074 return extra
.c_str ();
4078 /* If the above query fails, fall back to the old method. */
4079 rs
->use_threadextra_query
= 0;
4080 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
4081 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
4082 int_to_threadref (&id
, tp
->ptid
.lwp ());
4083 if (remote_get_threadinfo (&id
, set
, &threadinfo
))
4084 if (threadinfo
.active
)
4086 if (*threadinfo
.shortname
)
4087 string_appendf (extra
, " Name: %s", threadinfo
.shortname
);
4088 if (*threadinfo
.display
)
4090 if (!extra
.empty ())
4092 string_appendf (extra
, " State: %s", threadinfo
.display
);
4094 if (*threadinfo
.more_display
)
4096 if (!extra
.empty ())
4098 string_appendf (extra
, " Priority: %s", threadinfo
.more_display
);
4100 return extra
.c_str ();
4107 remote_target::static_tracepoint_marker_at (CORE_ADDR addr
,
4108 struct static_tracepoint_marker
*marker
)
4110 struct remote_state
*rs
= get_remote_state ();
4111 char *p
= rs
->buf
.data ();
4113 xsnprintf (p
, get_remote_packet_size (), "qTSTMat:");
4115 p
+= hexnumstr (p
, addr
);
4117 getpkt (&rs
->buf
, 0);
4118 p
= rs
->buf
.data ();
4121 error (_("Remote failure reply: %s"), p
);
4125 parse_static_tracepoint_marker_definition (p
, NULL
, marker
);
4132 std::vector
<static_tracepoint_marker
>
4133 remote_target::static_tracepoint_markers_by_strid (const char *strid
)
4135 struct remote_state
*rs
= get_remote_state ();
4136 std::vector
<static_tracepoint_marker
> markers
;
4138 static_tracepoint_marker marker
;
4140 /* Ask for a first packet of static tracepoint marker
4143 getpkt (&rs
->buf
, 0);
4144 p
= rs
->buf
.data ();
4146 error (_("Remote failure reply: %s"), p
);
4152 parse_static_tracepoint_marker_definition (p
, &p
, &marker
);
4154 if (strid
== NULL
|| marker
.str_id
== strid
)
4155 markers
.push_back (std::move (marker
));
4157 while (*p
++ == ','); /* comma-separated list */
4158 /* Ask for another packet of static tracepoint definition. */
4160 getpkt (&rs
->buf
, 0);
4161 p
= rs
->buf
.data ();
4168 /* Implement the to_get_ada_task_ptid function for the remote targets. */
4171 remote_target::get_ada_task_ptid (long lwp
, ULONGEST thread
)
4173 return ptid_t (inferior_ptid
.pid (), lwp
);
4177 /* Restart the remote side; this is an extended protocol operation. */
4180 remote_target::extended_remote_restart ()
4182 struct remote_state
*rs
= get_remote_state ();
4184 /* Send the restart command; for reasons I don't understand the
4185 remote side really expects a number after the "R". */
4186 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "R%x", 0);
4189 remote_fileio_reset ();
4192 /* Clean up connection to a remote debugger. */
4195 remote_target::close ()
4197 /* Make sure we leave stdin registered in the event loop. */
4200 trace_reset_local_state ();
4205 remote_target::~remote_target ()
4207 struct remote_state
*rs
= get_remote_state ();
4209 /* Check for NULL because we may get here with a partially
4210 constructed target/connection. */
4211 if (rs
->remote_desc
== nullptr)
4214 serial_close (rs
->remote_desc
);
4216 /* We are destroying the remote target, so we should discard
4217 everything of this target. */
4218 discard_pending_stop_replies_in_queue ();
4220 if (rs
->remote_async_inferior_event_token
)
4221 delete_async_event_handler (&rs
->remote_async_inferior_event_token
);
4223 delete rs
->notif_state
;
4226 /* Query the remote side for the text, data and bss offsets. */
4229 remote_target::get_offsets ()
4231 struct remote_state
*rs
= get_remote_state ();
4234 int lose
, num_segments
= 0, do_sections
, do_segments
;
4235 CORE_ADDR text_addr
, data_addr
, bss_addr
, segments
[2];
4237 if (current_program_space
->symfile_object_file
== NULL
)
4240 putpkt ("qOffsets");
4241 getpkt (&rs
->buf
, 0);
4242 buf
= rs
->buf
.data ();
4244 if (buf
[0] == '\000')
4245 return; /* Return silently. Stub doesn't support
4249 warning (_("Remote failure reply: %s"), buf
);
4253 /* Pick up each field in turn. This used to be done with scanf, but
4254 scanf will make trouble if CORE_ADDR size doesn't match
4255 conversion directives correctly. The following code will work
4256 with any size of CORE_ADDR. */
4257 text_addr
= data_addr
= bss_addr
= 0;
4261 if (startswith (ptr
, "Text="))
4264 /* Don't use strtol, could lose on big values. */
4265 while (*ptr
&& *ptr
!= ';')
4266 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
4268 if (startswith (ptr
, ";Data="))
4271 while (*ptr
&& *ptr
!= ';')
4272 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
4277 if (!lose
&& startswith (ptr
, ";Bss="))
4280 while (*ptr
&& *ptr
!= ';')
4281 bss_addr
= (bss_addr
<< 4) + fromhex (*ptr
++);
4283 if (bss_addr
!= data_addr
)
4284 warning (_("Target reported unsupported offsets: %s"), buf
);
4289 else if (startswith (ptr
, "TextSeg="))
4292 /* Don't use strtol, could lose on big values. */
4293 while (*ptr
&& *ptr
!= ';')
4294 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
4297 if (startswith (ptr
, ";DataSeg="))
4300 while (*ptr
&& *ptr
!= ';')
4301 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
4309 error (_("Malformed response to offset query, %s"), buf
);
4310 else if (*ptr
!= '\0')
4311 warning (_("Target reported unsupported offsets: %s"), buf
);
4313 objfile
*objf
= current_program_space
->symfile_object_file
;
4314 section_offsets offs
= objf
->section_offsets
;
4316 symfile_segment_data_up data
= get_symfile_segment_data (objf
->obfd
);
4317 do_segments
= (data
!= NULL
);
4318 do_sections
= num_segments
== 0;
4320 if (num_segments
> 0)
4322 segments
[0] = text_addr
;
4323 segments
[1] = data_addr
;
4325 /* If we have two segments, we can still try to relocate everything
4326 by assuming that the .text and .data offsets apply to the whole
4327 text and data segments. Convert the offsets given in the packet
4328 to base addresses for symfile_map_offsets_to_segments. */
4329 else if (data
!= nullptr && data
->segments
.size () == 2)
4331 segments
[0] = data
->segments
[0].base
+ text_addr
;
4332 segments
[1] = data
->segments
[1].base
+ data_addr
;
4335 /* If the object file has only one segment, assume that it is text
4336 rather than data; main programs with no writable data are rare,
4337 but programs with no code are useless. Of course the code might
4338 have ended up in the data segment... to detect that we would need
4339 the permissions here. */
4340 else if (data
&& data
->segments
.size () == 1)
4342 segments
[0] = data
->segments
[0].base
+ text_addr
;
4345 /* There's no way to relocate by segment. */
4351 int ret
= symfile_map_offsets_to_segments (objf
->obfd
,
4353 num_segments
, segments
);
4355 if (ret
== 0 && !do_sections
)
4356 error (_("Can not handle qOffsets TextSeg "
4357 "response with this symbol file"));
4365 offs
[SECT_OFF_TEXT (objf
)] = text_addr
;
4367 /* This is a temporary kludge to force data and bss to use the
4368 same offsets because that's what nlmconv does now. The real
4369 solution requires changes to the stub and remote.c that I
4370 don't have time to do right now. */
4372 offs
[SECT_OFF_DATA (objf
)] = data_addr
;
4373 offs
[SECT_OFF_BSS (objf
)] = data_addr
;
4376 objfile_relocate (objf
, offs
);
4379 /* Send interrupt_sequence to remote target. */
4382 remote_target::send_interrupt_sequence ()
4384 struct remote_state
*rs
= get_remote_state ();
4386 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
4387 remote_serial_write ("\x03", 1);
4388 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
4389 serial_send_break (rs
->remote_desc
);
4390 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
4392 serial_send_break (rs
->remote_desc
);
4393 remote_serial_write ("g", 1);
4396 internal_error (__FILE__
, __LINE__
,
4397 _("Invalid value for interrupt_sequence_mode: %s."),
4398 interrupt_sequence_mode
);
4402 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
4403 and extract the PTID. Returns NULL_PTID if not found. */
4406 stop_reply_extract_thread (const char *stop_reply
)
4408 if (stop_reply
[0] == 'T' && strlen (stop_reply
) > 3)
4412 /* Txx r:val ; r:val (...) */
4415 /* Look for "register" named "thread". */
4420 p1
= strchr (p
, ':');
4424 if (strncmp (p
, "thread", p1
- p
) == 0)
4425 return read_ptid (++p1
, &p
);
4427 p1
= strchr (p
, ';');
4439 /* Determine the remote side's current thread. If we have a stop
4440 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
4441 "thread" register we can extract the current thread from. If not,
4442 ask the remote which is the current thread with qC. The former
4443 method avoids a roundtrip. */
4446 remote_target::get_current_thread (const char *wait_status
)
4448 ptid_t ptid
= null_ptid
;
4450 /* Note we don't use remote_parse_stop_reply as that makes use of
4451 the target architecture, which we haven't yet fully determined at
4453 if (wait_status
!= NULL
)
4454 ptid
= stop_reply_extract_thread (wait_status
);
4455 if (ptid
== null_ptid
)
4456 ptid
= remote_current_thread (inferior_ptid
);
4461 /* Query the remote target for which is the current thread/process,
4462 add it to our tables, and update INFERIOR_PTID. The caller is
4463 responsible for setting the state such that the remote end is ready
4464 to return the current thread.
4466 This function is called after handling the '?' or 'vRun' packets,
4467 whose response is a stop reply from which we can also try
4468 extracting the thread. If the target doesn't support the explicit
4469 qC query, we infer the current thread from that stop reply, passed
4470 in in WAIT_STATUS, which may be NULL.
4472 The function returns pointer to the main thread of the inferior. */
4475 remote_target::add_current_inferior_and_thread (const char *wait_status
)
4477 struct remote_state
*rs
= get_remote_state ();
4478 bool fake_pid_p
= false;
4480 switch_to_no_thread ();
4482 /* Now, if we have thread information, update the current thread's
4484 ptid_t curr_ptid
= get_current_thread (wait_status
);
4486 if (curr_ptid
!= null_ptid
)
4488 if (!remote_multi_process_p (rs
))
4493 /* Without this, some commands which require an active target
4494 (such as kill) won't work. This variable serves (at least)
4495 double duty as both the pid of the target process (if it has
4496 such), and as a flag indicating that a target is active. */
4497 curr_ptid
= magic_null_ptid
;
4501 remote_add_inferior (fake_pid_p
, curr_ptid
.pid (), -1, 1);
4503 /* Add the main thread and switch to it. Don't try reading
4504 registers yet, since we haven't fetched the target description
4506 thread_info
*tp
= add_thread_silent (this, curr_ptid
);
4507 switch_to_thread_no_regs (tp
);
4512 /* Print info about a thread that was found already stopped on
4516 remote_target::print_one_stopped_thread (thread_info
*thread
)
4518 target_waitstatus ws
;
4520 /* If there is a pending waitstatus, use it. If there isn't it's because
4521 the thread's stop was reported with TARGET_WAITKIND_STOPPED / GDB_SIGNAL_0
4522 and process_initial_stop_replies decided it wasn't interesting to save
4523 and report to the core. */
4524 if (thread
->has_pending_waitstatus ())
4526 ws
= thread
->pending_waitstatus ();
4527 thread
->clear_pending_waitstatus ();
4531 ws
.set_stopped (GDB_SIGNAL_0
);
4534 switch_to_thread (thread
);
4535 thread
->set_stop_pc (get_frame_pc (get_current_frame ()));
4536 set_current_sal_from_frame (get_current_frame ());
4538 /* For "info program". */
4539 set_last_target_status (this, thread
->ptid
, ws
);
4541 if (ws
.kind () == TARGET_WAITKIND_STOPPED
)
4543 enum gdb_signal sig
= ws
.sig ();
4545 if (signal_print_state (sig
))
4546 gdb::observers::signal_received
.notify (sig
);
4548 gdb::observers::normal_stop
.notify (NULL
, 1);
4551 /* Process all initial stop replies the remote side sent in response
4552 to the ? packet. These indicate threads that were already stopped
4553 on initial connection. We mark these threads as stopped and print
4554 their current frame before giving the user the prompt. */
4557 remote_target::process_initial_stop_replies (int from_tty
)
4559 int pending_stop_replies
= stop_reply_queue_length ();
4560 struct thread_info
*selected
= NULL
;
4561 struct thread_info
*lowest_stopped
= NULL
;
4562 struct thread_info
*first
= NULL
;
4564 /* This is only used when the target is non-stop. */
4565 gdb_assert (target_is_non_stop_p ());
4567 /* Consume the initial pending events. */
4568 while (pending_stop_replies
-- > 0)
4570 ptid_t waiton_ptid
= minus_one_ptid
;
4572 struct target_waitstatus ws
;
4573 int ignore_event
= 0;
4575 event_ptid
= target_wait (waiton_ptid
, &ws
, TARGET_WNOHANG
);
4577 print_target_wait_results (waiton_ptid
, event_ptid
, ws
);
4581 case TARGET_WAITKIND_IGNORE
:
4582 case TARGET_WAITKIND_NO_RESUMED
:
4583 case TARGET_WAITKIND_SIGNALLED
:
4584 case TARGET_WAITKIND_EXITED
:
4585 /* We shouldn't see these, but if we do, just ignore. */
4586 remote_debug_printf ("event ignored");
4597 thread_info
*evthread
= find_thread_ptid (this, event_ptid
);
4599 if (ws
.kind () == TARGET_WAITKIND_STOPPED
)
4601 enum gdb_signal sig
= ws
.sig ();
4603 /* Stubs traditionally report SIGTRAP as initial signal,
4604 instead of signal 0. Suppress it. */
4605 if (sig
== GDB_SIGNAL_TRAP
)
4607 evthread
->set_stop_signal (sig
);
4608 ws
.set_stopped (sig
);
4611 if (ws
.kind () != TARGET_WAITKIND_STOPPED
4612 || ws
.sig () != GDB_SIGNAL_0
)
4613 evthread
->set_pending_waitstatus (ws
);
4615 set_executing (this, event_ptid
, false);
4616 set_running (this, event_ptid
, false);
4617 get_remote_thread_info (evthread
)->set_not_resumed ();
4620 /* "Notice" the new inferiors before anything related to
4621 registers/memory. */
4622 for (inferior
*inf
: all_non_exited_inferiors (this))
4624 inf
->needs_setup
= 1;
4628 thread_info
*thread
= any_live_thread_of_inferior (inf
);
4629 notice_new_inferior (thread
, thread
->state
== THREAD_RUNNING
,
4634 /* If all-stop on top of non-stop, pause all threads. Note this
4635 records the threads' stop pc, so must be done after "noticing"
4640 /* At this point, the remote target is not async. It needs to be for
4641 the poll in stop_all_threads to consider events from it, so enable
4643 gdb_assert (!this->is_async_p ());
4644 SCOPE_EXIT
{ target_async (0); };
4646 stop_all_threads ();
4649 /* If all threads of an inferior were already stopped, we
4650 haven't setup the inferior yet. */
4651 for (inferior
*inf
: all_non_exited_inferiors (this))
4653 if (inf
->needs_setup
)
4655 thread_info
*thread
= any_live_thread_of_inferior (inf
);
4656 switch_to_thread_no_regs (thread
);
4662 /* Now go over all threads that are stopped, and print their current
4663 frame. If all-stop, then if there's a signalled thread, pick
4665 for (thread_info
*thread
: all_non_exited_threads (this))
4671 thread
->set_running (false);
4672 else if (thread
->state
!= THREAD_STOPPED
)
4675 if (selected
== nullptr && thread
->has_pending_waitstatus ())
4678 if (lowest_stopped
== NULL
4679 || thread
->inf
->num
< lowest_stopped
->inf
->num
4680 || thread
->per_inf_num
< lowest_stopped
->per_inf_num
)
4681 lowest_stopped
= thread
;
4684 print_one_stopped_thread (thread
);
4687 /* In all-stop, we only print the status of one thread, and leave
4688 others with their status pending. */
4691 thread_info
*thread
= selected
;
4693 thread
= lowest_stopped
;
4697 print_one_stopped_thread (thread
);
4701 /* Mark a remote_target as marking (by setting the starting_up flag within
4702 its remote_state) for the lifetime of this object. The reference count
4703 on the remote target is temporarily incremented, to prevent the target
4704 being deleted under our feet. */
4706 struct scoped_mark_target_starting
4708 /* Constructor, TARGET is the target to be marked as starting, its
4709 reference count will be incremented. */
4710 scoped_mark_target_starting (remote_target
*target
)
4711 : m_remote_target (target
)
4713 m_remote_target
->incref ();
4714 remote_state
*rs
= m_remote_target
->get_remote_state ();
4715 rs
->starting_up
= true;
4718 /* Destructor, mark the target being worked on as no longer starting, and
4719 decrement the reference count. */
4720 ~scoped_mark_target_starting ()
4722 remote_state
*rs
= m_remote_target
->get_remote_state ();
4723 rs
->starting_up
= false;
4724 decref_target (m_remote_target
);
4729 /* The target on which we are operating. */
4730 remote_target
*m_remote_target
;
4733 /* Helper for remote_target::start_remote, start the remote connection and
4734 sync state. Return true if everything goes OK, otherwise, return false.
4735 This function exists so that the scoped_restore created within it will
4736 expire before we return to remote_target::start_remote. */
4739 remote_target::start_remote_1 (int from_tty
, int extended_p
)
4741 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
4743 struct remote_state
*rs
= get_remote_state ();
4744 struct packet_config
*noack_config
;
4746 /* Signal other parts that we're going through the initial setup,
4747 and so things may not be stable yet. E.g., we don't try to
4748 install tracepoints until we've relocated symbols. Also, a
4749 Ctrl-C before we're connected and synced up can't interrupt the
4750 target. Instead, it offers to drop the (potentially wedged)
4752 scoped_mark_target_starting
target_is_starting (this);
4756 if (interrupt_on_connect
)
4757 send_interrupt_sequence ();
4759 /* Ack any packet which the remote side has already sent. */
4760 remote_serial_write ("+", 1);
4762 /* The first packet we send to the target is the optional "supported
4763 packets" request. If the target can answer this, it will tell us
4764 which later probes to skip. */
4765 remote_query_supported ();
4767 /* If the stub wants to get a QAllow, compose one and send it. */
4768 if (packet_support (PACKET_QAllow
) != PACKET_DISABLE
)
4771 /* gdbserver < 7.7 (before its fix from 2013-12-11) did reply to any
4772 unknown 'v' packet with string "OK". "OK" gets interpreted by GDB
4773 as a reply to known packet. For packet "vFile:setfs:" it is an
4774 invalid reply and GDB would return error in
4775 remote_hostio_set_filesystem, making remote files access impossible.
4776 Disable "vFile:setfs:" in such case. Do not disable other 'v' packets as
4777 other "vFile" packets get correctly detected even on gdbserver < 7.7. */
4779 const char v_mustreplyempty
[] = "vMustReplyEmpty";
4781 putpkt (v_mustreplyempty
);
4782 getpkt (&rs
->buf
, 0);
4783 if (strcmp (rs
->buf
.data (), "OK") == 0)
4784 remote_protocol_packets
[PACKET_vFile_setfs
].support
= PACKET_DISABLE
;
4785 else if (strcmp (rs
->buf
.data (), "") != 0)
4786 error (_("Remote replied unexpectedly to '%s': %s"), v_mustreplyempty
,
4790 /* Next, we possibly activate noack mode.
4792 If the QStartNoAckMode packet configuration is set to AUTO,
4793 enable noack mode if the stub reported a wish for it with
4796 If set to TRUE, then enable noack mode even if the stub didn't
4797 report it in qSupported. If the stub doesn't reply OK, the
4798 session ends with an error.
4800 If FALSE, then don't activate noack mode, regardless of what the
4801 stub claimed should be the default with qSupported. */
4803 noack_config
= &remote_protocol_packets
[PACKET_QStartNoAckMode
];
4804 if (packet_config_support (noack_config
) != PACKET_DISABLE
)
4806 putpkt ("QStartNoAckMode");
4807 getpkt (&rs
->buf
, 0);
4808 if (packet_ok (rs
->buf
, noack_config
) == PACKET_OK
)
4814 /* Tell the remote that we are using the extended protocol. */
4816 getpkt (&rs
->buf
, 0);
4819 /* Let the target know which signals it is allowed to pass down to
4821 update_signals_program_target ();
4823 /* Next, if the target can specify a description, read it. We do
4824 this before anything involving memory or registers. */
4825 target_find_description ();
4827 /* Next, now that we know something about the target, update the
4828 address spaces in the program spaces. */
4829 update_address_spaces ();
4831 /* On OSs where the list of libraries is global to all
4832 processes, we fetch them early. */
4833 if (gdbarch_has_global_solist (target_gdbarch ()))
4834 solib_add (NULL
, from_tty
, auto_solib_add
);
4836 if (target_is_non_stop_p ())
4838 if (packet_support (PACKET_QNonStop
) != PACKET_ENABLE
)
4839 error (_("Non-stop mode requested, but remote "
4840 "does not support non-stop"));
4842 putpkt ("QNonStop:1");
4843 getpkt (&rs
->buf
, 0);
4845 if (strcmp (rs
->buf
.data (), "OK") != 0)
4846 error (_("Remote refused setting non-stop mode with: %s"),
4849 /* Find about threads and processes the stub is already
4850 controlling. We default to adding them in the running state.
4851 The '?' query below will then tell us about which threads are
4853 this->update_thread_list ();
4855 else if (packet_support (PACKET_QNonStop
) == PACKET_ENABLE
)
4857 /* Don't assume that the stub can operate in all-stop mode.
4858 Request it explicitly. */
4859 putpkt ("QNonStop:0");
4860 getpkt (&rs
->buf
, 0);
4862 if (strcmp (rs
->buf
.data (), "OK") != 0)
4863 error (_("Remote refused setting all-stop mode with: %s"),
4867 /* Upload TSVs regardless of whether the target is running or not. The
4868 remote stub, such as GDBserver, may have some predefined or builtin
4869 TSVs, even if the target is not running. */
4870 if (get_trace_status (current_trace_status ()) != -1)
4872 struct uploaded_tsv
*uploaded_tsvs
= NULL
;
4874 upload_trace_state_variables (&uploaded_tsvs
);
4875 merge_uploaded_trace_state_variables (&uploaded_tsvs
);
4878 /* Check whether the target is running now. */
4880 getpkt (&rs
->buf
, 0);
4882 if (!target_is_non_stop_p ())
4884 char *wait_status
= NULL
;
4886 if (rs
->buf
[0] == 'W' || rs
->buf
[0] == 'X')
4889 error (_("The target is not running (try extended-remote?)"));
4894 /* Save the reply for later. */
4895 wait_status
= (char *) alloca (strlen (rs
->buf
.data ()) + 1);
4896 strcpy (wait_status
, rs
->buf
.data ());
4899 /* Fetch thread list. */
4900 target_update_thread_list ();
4902 /* Let the stub know that we want it to return the thread. */
4903 set_continue_thread (minus_one_ptid
);
4905 if (thread_count (this) == 0)
4907 /* Target has no concept of threads at all. GDB treats
4908 non-threaded target as single-threaded; add a main
4910 thread_info
*tp
= add_current_inferior_and_thread (wait_status
);
4911 get_remote_thread_info (tp
)->set_resumed ();
4915 /* We have thread information; select the thread the target
4916 says should be current. If we're reconnecting to a
4917 multi-threaded program, this will ideally be the thread
4918 that last reported an event before GDB disconnected. */
4919 ptid_t curr_thread
= get_current_thread (wait_status
);
4920 if (curr_thread
== null_ptid
)
4922 /* Odd... The target was able to list threads, but not
4923 tell us which thread was current (no "thread"
4924 register in T stop reply?). Just pick the first
4925 thread in the thread list then. */
4927 remote_debug_printf ("warning: couldn't determine remote "
4928 "current thread; picking first in list.");
4930 for (thread_info
*tp
: all_non_exited_threads (this,
4933 switch_to_thread (tp
);
4938 switch_to_thread (find_thread_ptid (this, curr_thread
));
4941 /* init_wait_for_inferior should be called before get_offsets in order
4942 to manage `inserted' flag in bp loc in a correct state.
4943 breakpoint_init_inferior, called from init_wait_for_inferior, set
4944 `inserted' flag to 0, while before breakpoint_re_set, called from
4945 start_remote, set `inserted' flag to 1. In the initialization of
4946 inferior, breakpoint_init_inferior should be called first, and then
4947 breakpoint_re_set can be called. If this order is broken, state of
4948 `inserted' flag is wrong, and cause some problems on breakpoint
4950 init_wait_for_inferior ();
4952 get_offsets (); /* Get text, data & bss offsets. */
4954 /* If we could not find a description using qXfer, and we know
4955 how to do it some other way, try again. This is not
4956 supported for non-stop; it could be, but it is tricky if
4957 there are no stopped threads when we connect. */
4958 if (remote_read_description_p (this)
4959 && gdbarch_target_desc (target_gdbarch ()) == NULL
)
4961 target_clear_description ();
4962 target_find_description ();
4965 /* Use the previously fetched status. */
4966 gdb_assert (wait_status
!= NULL
);
4967 struct notif_event
*reply
4968 = remote_notif_parse (this, ¬if_client_stop
, wait_status
);
4969 push_stop_reply ((struct stop_reply
*) reply
);
4971 ::start_remote (from_tty
); /* Initialize gdb process mechanisms. */
4975 /* Clear WFI global state. Do this before finding about new
4976 threads and inferiors, and setting the current inferior.
4977 Otherwise we would clear the proceed status of the current
4978 inferior when we want its stop_soon state to be preserved
4979 (see notice_new_inferior). */
4980 init_wait_for_inferior ();
4982 /* In non-stop, we will either get an "OK", meaning that there
4983 are no stopped threads at this time; or, a regular stop
4984 reply. In the latter case, there may be more than one thread
4985 stopped --- we pull them all out using the vStopped
4987 if (strcmp (rs
->buf
.data (), "OK") != 0)
4989 struct notif_client
*notif
= ¬if_client_stop
;
4991 /* remote_notif_get_pending_replies acks this one, and gets
4993 rs
->notif_state
->pending_event
[notif_client_stop
.id
]
4994 = remote_notif_parse (this, notif
, rs
->buf
.data ());
4995 remote_notif_get_pending_events (notif
);
4998 if (thread_count (this) == 0)
5001 error (_("The target is not running (try extended-remote?)"));
5005 /* Report all signals during attach/startup. */
5008 /* If there are already stopped threads, mark them stopped and
5009 report their stops before giving the prompt to the user. */
5010 process_initial_stop_replies (from_tty
);
5012 if (target_can_async_p ())
5016 /* If we connected to a live target, do some additional setup. */
5017 if (target_has_execution ())
5019 /* No use without a symbol-file. */
5020 if (current_program_space
->symfile_object_file
)
5021 remote_check_symbols ();
5024 /* Possibly the target has been engaged in a trace run started
5025 previously; find out where things are at. */
5026 if (get_trace_status (current_trace_status ()) != -1)
5028 struct uploaded_tp
*uploaded_tps
= NULL
;
5030 if (current_trace_status ()->running
)
5031 printf_filtered (_("Trace is already running on the target.\n"));
5033 upload_tracepoints (&uploaded_tps
);
5035 merge_uploaded_tracepoints (&uploaded_tps
);
5038 /* Possibly the target has been engaged in a btrace record started
5039 previously; find out where things are at. */
5040 remote_btrace_maybe_reopen ();
5045 /* Start the remote connection and sync state. */
5048 remote_target::start_remote (int from_tty
, int extended_p
)
5050 if (start_remote_1 (from_tty
, extended_p
)
5051 && breakpoints_should_be_inserted_now ())
5052 insert_breakpoints ();
5056 remote_target::connection_string ()
5058 remote_state
*rs
= get_remote_state ();
5060 if (rs
->remote_desc
->name
!= NULL
)
5061 return rs
->remote_desc
->name
;
5066 /* Open a connection to a remote debugger.
5067 NAME is the filename used for communication. */
5070 remote_target::open (const char *name
, int from_tty
)
5072 open_1 (name
, from_tty
, 0);
5075 /* Open a connection to a remote debugger using the extended
5076 remote gdb protocol. NAME is the filename used for communication. */
5079 extended_remote_target::open (const char *name
, int from_tty
)
5081 open_1 (name
, from_tty
, 1 /*extended_p */);
5084 /* Reset all packets back to "unknown support". Called when opening a
5085 new connection to a remote target. */
5088 reset_all_packet_configs_support (void)
5092 for (i
= 0; i
< PACKET_MAX
; i
++)
5093 remote_protocol_packets
[i
].support
= PACKET_SUPPORT_UNKNOWN
;
5096 /* Initialize all packet configs. */
5099 init_all_packet_configs (void)
5103 for (i
= 0; i
< PACKET_MAX
; i
++)
5105 remote_protocol_packets
[i
].detect
= AUTO_BOOLEAN_AUTO
;
5106 remote_protocol_packets
[i
].support
= PACKET_SUPPORT_UNKNOWN
;
5110 /* Symbol look-up. */
5113 remote_target::remote_check_symbols ()
5118 /* The remote side has no concept of inferiors that aren't running
5119 yet, it only knows about running processes. If we're connected
5120 but our current inferior is not running, we should not invite the
5121 remote target to request symbol lookups related to its
5122 (unrelated) current process. */
5123 if (!target_has_execution ())
5126 if (packet_support (PACKET_qSymbol
) == PACKET_DISABLE
)
5129 /* Make sure the remote is pointing at the right process. Note
5130 there's no way to select "no process". */
5131 set_general_process ();
5133 /* Allocate a message buffer. We can't reuse the input buffer in RS,
5134 because we need both at the same time. */
5135 gdb::char_vector
msg (get_remote_packet_size ());
5136 gdb::char_vector
reply (get_remote_packet_size ());
5138 /* Invite target to request symbol lookups. */
5140 putpkt ("qSymbol::");
5142 packet_ok (reply
, &remote_protocol_packets
[PACKET_qSymbol
]);
5144 while (startswith (reply
.data (), "qSymbol:"))
5146 struct bound_minimal_symbol sym
;
5149 end
= hex2bin (tmp
, reinterpret_cast <gdb_byte
*> (msg
.data ()),
5152 sym
= lookup_minimal_symbol (msg
.data (), NULL
, NULL
);
5153 if (sym
.minsym
== NULL
)
5154 xsnprintf (msg
.data (), get_remote_packet_size (), "qSymbol::%s",
5158 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
5159 CORE_ADDR sym_addr
= BMSYMBOL_VALUE_ADDRESS (sym
);
5161 /* If this is a function address, return the start of code
5162 instead of any data function descriptor. */
5163 sym_addr
= gdbarch_convert_from_func_ptr_addr
5164 (target_gdbarch (), sym_addr
, current_inferior ()->top_target ());
5166 xsnprintf (msg
.data (), get_remote_packet_size (), "qSymbol:%s:%s",
5167 phex_nz (sym_addr
, addr_size
), &reply
[8]);
5170 putpkt (msg
.data ());
5175 static struct serial
*
5176 remote_serial_open (const char *name
)
5178 static int udp_warning
= 0;
5180 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
5181 of in ser-tcp.c, because it is the remote protocol assuming that the
5182 serial connection is reliable and not the serial connection promising
5184 if (!udp_warning
&& startswith (name
, "udp:"))
5186 warning (_("The remote protocol may be unreliable over UDP.\n"
5187 "Some events may be lost, rendering further debugging "
5192 return serial_open (name
);
5195 /* Inform the target of our permission settings. The permission flags
5196 work without this, but if the target knows the settings, it can do
5197 a couple things. First, it can add its own check, to catch cases
5198 that somehow manage to get by the permissions checks in target
5199 methods. Second, if the target is wired to disallow particular
5200 settings (for instance, a system in the field that is not set up to
5201 be able to stop at a breakpoint), it can object to any unavailable
5205 remote_target::set_permissions ()
5207 struct remote_state
*rs
= get_remote_state ();
5209 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QAllow:"
5210 "WriteReg:%x;WriteMem:%x;"
5211 "InsertBreak:%x;InsertTrace:%x;"
5212 "InsertFastTrace:%x;Stop:%x",
5213 may_write_registers
, may_write_memory
,
5214 may_insert_breakpoints
, may_insert_tracepoints
,
5215 may_insert_fast_tracepoints
, may_stop
);
5217 getpkt (&rs
->buf
, 0);
5219 /* If the target didn't like the packet, warn the user. Do not try
5220 to undo the user's settings, that would just be maddening. */
5221 if (strcmp (rs
->buf
.data (), "OK") != 0)
5222 warning (_("Remote refused setting permissions with: %s"),
5226 /* This type describes each known response to the qSupported
5228 struct protocol_feature
5230 /* The name of this protocol feature. */
5233 /* The default for this protocol feature. */
5234 enum packet_support default_support
;
5236 /* The function to call when this feature is reported, or after
5237 qSupported processing if the feature is not supported.
5238 The first argument points to this structure. The second
5239 argument indicates whether the packet requested support be
5240 enabled, disabled, or probed (or the default, if this function
5241 is being called at the end of processing and this feature was
5242 not reported). The third argument may be NULL; if not NULL, it
5243 is a NUL-terminated string taken from the packet following
5244 this feature's name and an equals sign. */
5245 void (*func
) (remote_target
*remote
, const struct protocol_feature
*,
5246 enum packet_support
, const char *);
5248 /* The corresponding packet for this feature. Only used if
5249 FUNC is remote_supported_packet. */
5254 remote_supported_packet (remote_target
*remote
,
5255 const struct protocol_feature
*feature
,
5256 enum packet_support support
,
5257 const char *argument
)
5261 warning (_("Remote qSupported response supplied an unexpected value for"
5262 " \"%s\"."), feature
->name
);
5266 remote_protocol_packets
[feature
->packet
].support
= support
;
5270 remote_target::remote_packet_size (const protocol_feature
*feature
,
5271 enum packet_support support
, const char *value
)
5273 struct remote_state
*rs
= get_remote_state ();
5278 if (support
!= PACKET_ENABLE
)
5281 if (value
== NULL
|| *value
== '\0')
5283 warning (_("Remote target reported \"%s\" without a size."),
5289 packet_size
= strtol (value
, &value_end
, 16);
5290 if (errno
!= 0 || *value_end
!= '\0' || packet_size
< 0)
5292 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
5293 feature
->name
, value
);
5297 /* Record the new maximum packet size. */
5298 rs
->explicit_packet_size
= packet_size
;
5302 remote_packet_size (remote_target
*remote
, const protocol_feature
*feature
,
5303 enum packet_support support
, const char *value
)
5305 remote
->remote_packet_size (feature
, support
, value
);
5308 static const struct protocol_feature remote_protocol_features
[] = {
5309 { "PacketSize", PACKET_DISABLE
, remote_packet_size
, -1 },
5310 { "qXfer:auxv:read", PACKET_DISABLE
, remote_supported_packet
,
5311 PACKET_qXfer_auxv
},
5312 { "qXfer:exec-file:read", PACKET_DISABLE
, remote_supported_packet
,
5313 PACKET_qXfer_exec_file
},
5314 { "qXfer:features:read", PACKET_DISABLE
, remote_supported_packet
,
5315 PACKET_qXfer_features
},
5316 { "qXfer:libraries:read", PACKET_DISABLE
, remote_supported_packet
,
5317 PACKET_qXfer_libraries
},
5318 { "qXfer:libraries-svr4:read", PACKET_DISABLE
, remote_supported_packet
,
5319 PACKET_qXfer_libraries_svr4
},
5320 { "augmented-libraries-svr4-read", PACKET_DISABLE
,
5321 remote_supported_packet
, PACKET_augmented_libraries_svr4_read_feature
},
5322 { "qXfer:memory-map:read", PACKET_DISABLE
, remote_supported_packet
,
5323 PACKET_qXfer_memory_map
},
5324 { "qXfer:osdata:read", PACKET_DISABLE
, remote_supported_packet
,
5325 PACKET_qXfer_osdata
},
5326 { "qXfer:threads:read", PACKET_DISABLE
, remote_supported_packet
,
5327 PACKET_qXfer_threads
},
5328 { "qXfer:traceframe-info:read", PACKET_DISABLE
, remote_supported_packet
,
5329 PACKET_qXfer_traceframe_info
},
5330 { "QPassSignals", PACKET_DISABLE
, remote_supported_packet
,
5331 PACKET_QPassSignals
},
5332 { "QCatchSyscalls", PACKET_DISABLE
, remote_supported_packet
,
5333 PACKET_QCatchSyscalls
},
5334 { "QProgramSignals", PACKET_DISABLE
, remote_supported_packet
,
5335 PACKET_QProgramSignals
},
5336 { "QSetWorkingDir", PACKET_DISABLE
, remote_supported_packet
,
5337 PACKET_QSetWorkingDir
},
5338 { "QStartupWithShell", PACKET_DISABLE
, remote_supported_packet
,
5339 PACKET_QStartupWithShell
},
5340 { "QEnvironmentHexEncoded", PACKET_DISABLE
, remote_supported_packet
,
5341 PACKET_QEnvironmentHexEncoded
},
5342 { "QEnvironmentReset", PACKET_DISABLE
, remote_supported_packet
,
5343 PACKET_QEnvironmentReset
},
5344 { "QEnvironmentUnset", PACKET_DISABLE
, remote_supported_packet
,
5345 PACKET_QEnvironmentUnset
},
5346 { "QStartNoAckMode", PACKET_DISABLE
, remote_supported_packet
,
5347 PACKET_QStartNoAckMode
},
5348 { "multiprocess", PACKET_DISABLE
, remote_supported_packet
,
5349 PACKET_multiprocess_feature
},
5350 { "QNonStop", PACKET_DISABLE
, remote_supported_packet
, PACKET_QNonStop
},
5351 { "qXfer:siginfo:read", PACKET_DISABLE
, remote_supported_packet
,
5352 PACKET_qXfer_siginfo_read
},
5353 { "qXfer:siginfo:write", PACKET_DISABLE
, remote_supported_packet
,
5354 PACKET_qXfer_siginfo_write
},
5355 { "ConditionalTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5356 PACKET_ConditionalTracepoints
},
5357 { "ConditionalBreakpoints", PACKET_DISABLE
, remote_supported_packet
,
5358 PACKET_ConditionalBreakpoints
},
5359 { "BreakpointCommands", PACKET_DISABLE
, remote_supported_packet
,
5360 PACKET_BreakpointCommands
},
5361 { "FastTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5362 PACKET_FastTracepoints
},
5363 { "StaticTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5364 PACKET_StaticTracepoints
},
5365 {"InstallInTrace", PACKET_DISABLE
, remote_supported_packet
,
5366 PACKET_InstallInTrace
},
5367 { "DisconnectedTracing", PACKET_DISABLE
, remote_supported_packet
,
5368 PACKET_DisconnectedTracing_feature
},
5369 { "ReverseContinue", PACKET_DISABLE
, remote_supported_packet
,
5371 { "ReverseStep", PACKET_DISABLE
, remote_supported_packet
,
5373 { "TracepointSource", PACKET_DISABLE
, remote_supported_packet
,
5374 PACKET_TracepointSource
},
5375 { "QAllow", PACKET_DISABLE
, remote_supported_packet
,
5377 { "EnableDisableTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5378 PACKET_EnableDisableTracepoints_feature
},
5379 { "qXfer:fdpic:read", PACKET_DISABLE
, remote_supported_packet
,
5380 PACKET_qXfer_fdpic
},
5381 { "qXfer:uib:read", PACKET_DISABLE
, remote_supported_packet
,
5383 { "QDisableRandomization", PACKET_DISABLE
, remote_supported_packet
,
5384 PACKET_QDisableRandomization
},
5385 { "QAgent", PACKET_DISABLE
, remote_supported_packet
, PACKET_QAgent
},
5386 { "QTBuffer:size", PACKET_DISABLE
,
5387 remote_supported_packet
, PACKET_QTBuffer_size
},
5388 { "tracenz", PACKET_DISABLE
, remote_supported_packet
, PACKET_tracenz_feature
},
5389 { "Qbtrace:off", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_off
},
5390 { "Qbtrace:bts", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_bts
},
5391 { "Qbtrace:pt", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_pt
},
5392 { "qXfer:btrace:read", PACKET_DISABLE
, remote_supported_packet
,
5393 PACKET_qXfer_btrace
},
5394 { "qXfer:btrace-conf:read", PACKET_DISABLE
, remote_supported_packet
,
5395 PACKET_qXfer_btrace_conf
},
5396 { "Qbtrace-conf:bts:size", PACKET_DISABLE
, remote_supported_packet
,
5397 PACKET_Qbtrace_conf_bts_size
},
5398 { "swbreak", PACKET_DISABLE
, remote_supported_packet
, PACKET_swbreak_feature
},
5399 { "hwbreak", PACKET_DISABLE
, remote_supported_packet
, PACKET_hwbreak_feature
},
5400 { "fork-events", PACKET_DISABLE
, remote_supported_packet
,
5401 PACKET_fork_event_feature
},
5402 { "vfork-events", PACKET_DISABLE
, remote_supported_packet
,
5403 PACKET_vfork_event_feature
},
5404 { "exec-events", PACKET_DISABLE
, remote_supported_packet
,
5405 PACKET_exec_event_feature
},
5406 { "Qbtrace-conf:pt:size", PACKET_DISABLE
, remote_supported_packet
,
5407 PACKET_Qbtrace_conf_pt_size
},
5408 { "vContSupported", PACKET_DISABLE
, remote_supported_packet
, PACKET_vContSupported
},
5409 { "QThreadEvents", PACKET_DISABLE
, remote_supported_packet
, PACKET_QThreadEvents
},
5410 { "no-resumed", PACKET_DISABLE
, remote_supported_packet
, PACKET_no_resumed
},
5411 { "memory-tagging", PACKET_DISABLE
, remote_supported_packet
,
5412 PACKET_memory_tagging_feature
},
5415 static char *remote_support_xml
;
5417 /* Register string appended to "xmlRegisters=" in qSupported query. */
5420 register_remote_support_xml (const char *xml
)
5422 #if defined(HAVE_LIBEXPAT)
5423 if (remote_support_xml
== NULL
)
5424 remote_support_xml
= concat ("xmlRegisters=", xml
, (char *) NULL
);
5427 char *copy
= xstrdup (remote_support_xml
+ 13);
5429 char *p
= strtok_r (copy
, ",", &saveptr
);
5433 if (strcmp (p
, xml
) == 0)
5440 while ((p
= strtok_r (NULL
, ",", &saveptr
)) != NULL
);
5443 remote_support_xml
= reconcat (remote_support_xml
,
5444 remote_support_xml
, ",", xml
,
5451 remote_query_supported_append (std::string
*msg
, const char *append
)
5455 msg
->append (append
);
5459 remote_target::remote_query_supported ()
5461 struct remote_state
*rs
= get_remote_state ();
5464 unsigned char seen
[ARRAY_SIZE (remote_protocol_features
)];
5466 /* The packet support flags are handled differently for this packet
5467 than for most others. We treat an error, a disabled packet, and
5468 an empty response identically: any features which must be reported
5469 to be used will be automatically disabled. An empty buffer
5470 accomplishes this, since that is also the representation for a list
5471 containing no features. */
5474 if (packet_support (PACKET_qSupported
) != PACKET_DISABLE
)
5478 if (packet_set_cmd_state (PACKET_multiprocess_feature
) != AUTO_BOOLEAN_FALSE
)
5479 remote_query_supported_append (&q
, "multiprocess+");
5481 if (packet_set_cmd_state (PACKET_swbreak_feature
) != AUTO_BOOLEAN_FALSE
)
5482 remote_query_supported_append (&q
, "swbreak+");
5483 if (packet_set_cmd_state (PACKET_hwbreak_feature
) != AUTO_BOOLEAN_FALSE
)
5484 remote_query_supported_append (&q
, "hwbreak+");
5486 remote_query_supported_append (&q
, "qRelocInsn+");
5488 if (packet_set_cmd_state (PACKET_fork_event_feature
)
5489 != AUTO_BOOLEAN_FALSE
)
5490 remote_query_supported_append (&q
, "fork-events+");
5491 if (packet_set_cmd_state (PACKET_vfork_event_feature
)
5492 != AUTO_BOOLEAN_FALSE
)
5493 remote_query_supported_append (&q
, "vfork-events+");
5494 if (packet_set_cmd_state (PACKET_exec_event_feature
)
5495 != AUTO_BOOLEAN_FALSE
)
5496 remote_query_supported_append (&q
, "exec-events+");
5498 if (packet_set_cmd_state (PACKET_vContSupported
) != AUTO_BOOLEAN_FALSE
)
5499 remote_query_supported_append (&q
, "vContSupported+");
5501 if (packet_set_cmd_state (PACKET_QThreadEvents
) != AUTO_BOOLEAN_FALSE
)
5502 remote_query_supported_append (&q
, "QThreadEvents+");
5504 if (packet_set_cmd_state (PACKET_no_resumed
) != AUTO_BOOLEAN_FALSE
)
5505 remote_query_supported_append (&q
, "no-resumed+");
5507 if (packet_set_cmd_state (PACKET_memory_tagging_feature
)
5508 != AUTO_BOOLEAN_FALSE
)
5509 remote_query_supported_append (&q
, "memory-tagging+");
5511 /* Keep this one last to work around a gdbserver <= 7.10 bug in
5512 the qSupported:xmlRegisters=i386 handling. */
5513 if (remote_support_xml
!= NULL
5514 && packet_support (PACKET_qXfer_features
) != PACKET_DISABLE
)
5515 remote_query_supported_append (&q
, remote_support_xml
);
5517 q
= "qSupported:" + q
;
5518 putpkt (q
.c_str ());
5520 getpkt (&rs
->buf
, 0);
5522 /* If an error occured, warn, but do not return - just reset the
5523 buffer to empty and go on to disable features. */
5524 if (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_qSupported
])
5527 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
5532 memset (seen
, 0, sizeof (seen
));
5534 next
= rs
->buf
.data ();
5537 enum packet_support is_supported
;
5538 char *p
, *end
, *name_end
, *value
;
5540 /* First separate out this item from the rest of the packet. If
5541 there's another item after this, we overwrite the separator
5542 (terminated strings are much easier to work with). */
5544 end
= strchr (p
, ';');
5547 end
= p
+ strlen (p
);
5557 warning (_("empty item in \"qSupported\" response"));
5562 name_end
= strchr (p
, '=');
5565 /* This is a name=value entry. */
5566 is_supported
= PACKET_ENABLE
;
5567 value
= name_end
+ 1;
5576 is_supported
= PACKET_ENABLE
;
5580 is_supported
= PACKET_DISABLE
;
5584 is_supported
= PACKET_SUPPORT_UNKNOWN
;
5588 warning (_("unrecognized item \"%s\" "
5589 "in \"qSupported\" response"), p
);
5595 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
5596 if (strcmp (remote_protocol_features
[i
].name
, p
) == 0)
5598 const struct protocol_feature
*feature
;
5601 feature
= &remote_protocol_features
[i
];
5602 feature
->func (this, feature
, is_supported
, value
);
5607 /* If we increased the packet size, make sure to increase the global
5608 buffer size also. We delay this until after parsing the entire
5609 qSupported packet, because this is the same buffer we were
5611 if (rs
->buf
.size () < rs
->explicit_packet_size
)
5612 rs
->buf
.resize (rs
->explicit_packet_size
);
5614 /* Handle the defaults for unmentioned features. */
5615 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
5618 const struct protocol_feature
*feature
;
5620 feature
= &remote_protocol_features
[i
];
5621 feature
->func (this, feature
, feature
->default_support
, NULL
);
5625 /* Serial QUIT handler for the remote serial descriptor.
5627 Defers handling a Ctrl-C until we're done with the current
5628 command/response packet sequence, unless:
5630 - We're setting up the connection. Don't send a remote interrupt
5631 request, as we're not fully synced yet. Quit immediately
5634 - The target has been resumed in the foreground
5635 (target_terminal::is_ours is false) with a synchronous resume
5636 packet, and we're blocked waiting for the stop reply, thus a
5637 Ctrl-C should be immediately sent to the target.
5639 - We get a second Ctrl-C while still within the same serial read or
5640 write. In that case the serial is seemingly wedged --- offer to
5643 - We see a second Ctrl-C without target response, after having
5644 previously interrupted the target. In that case the target/stub
5645 is probably wedged --- offer to quit/disconnect.
5649 remote_target::remote_serial_quit_handler ()
5651 struct remote_state
*rs
= get_remote_state ();
5653 if (check_quit_flag ())
5655 /* If we're starting up, we're not fully synced yet. Quit
5657 if (rs
->starting_up
)
5659 else if (rs
->got_ctrlc_during_io
)
5661 if (query (_("The target is not responding to GDB commands.\n"
5662 "Stop debugging it? ")))
5663 remote_unpush_and_throw (this);
5665 /* If ^C has already been sent once, offer to disconnect. */
5666 else if (!target_terminal::is_ours () && rs
->ctrlc_pending_p
)
5668 /* All-stop protocol, and blocked waiting for stop reply. Send
5669 an interrupt request. */
5670 else if (!target_terminal::is_ours () && rs
->waiting_for_stop_reply
)
5671 target_interrupt ();
5673 rs
->got_ctrlc_during_io
= 1;
5677 /* The remote_target that is current while the quit handler is
5678 overridden with remote_serial_quit_handler. */
5679 static remote_target
*curr_quit_handler_target
;
5682 remote_serial_quit_handler ()
5684 curr_quit_handler_target
->remote_serial_quit_handler ();
5687 /* Remove the remote target from the target stack of each inferior
5688 that is using it. Upper targets depend on it so remove them
5692 remote_unpush_target (remote_target
*target
)
5694 /* We have to unpush the target from all inferiors, even those that
5696 scoped_restore_current_inferior restore_current_inferior
;
5698 for (inferior
*inf
: all_inferiors (target
))
5700 switch_to_inferior_no_thread (inf
);
5701 pop_all_targets_at_and_above (process_stratum
);
5702 generic_mourn_inferior ();
5705 /* Don't rely on target_close doing this when the target is popped
5706 from the last remote inferior above, because something may be
5707 holding a reference to the target higher up on the stack, meaning
5708 target_close won't be called yet. We lost the connection to the
5709 target, so clear these now, otherwise we may later throw
5710 TARGET_CLOSE_ERROR while trying to tell the remote target to
5712 fileio_handles_invalidate_target (target
);
5716 remote_unpush_and_throw (remote_target
*target
)
5718 remote_unpush_target (target
);
5719 throw_error (TARGET_CLOSE_ERROR
, _("Disconnected from target."));
5723 remote_target::open_1 (const char *name
, int from_tty
, int extended_p
)
5725 remote_target
*curr_remote
= get_current_remote_target ();
5728 error (_("To open a remote debug connection, you need to specify what\n"
5729 "serial device is attached to the remote system\n"
5730 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
5732 /* If we're connected to a running target, target_preopen will kill it.
5733 Ask this question first, before target_preopen has a chance to kill
5735 if (curr_remote
!= NULL
&& !target_has_execution ())
5738 && !query (_("Already connected to a remote target. Disconnect? ")))
5739 error (_("Still connected."));
5742 /* Here the possibly existing remote target gets unpushed. */
5743 target_preopen (from_tty
);
5745 remote_fileio_reset ();
5746 reopen_exec_file ();
5747 reread_symbols (from_tty
);
5749 remote_target
*remote
5750 = (extended_p
? new extended_remote_target () : new remote_target ());
5751 target_ops_up
target_holder (remote
);
5753 remote_state
*rs
= remote
->get_remote_state ();
5755 /* See FIXME above. */
5756 if (!target_async_permitted
)
5757 rs
->wait_forever_enabled_p
= 1;
5759 rs
->remote_desc
= remote_serial_open (name
);
5760 if (!rs
->remote_desc
)
5761 perror_with_name (name
);
5763 if (baud_rate
!= -1)
5765 if (serial_setbaudrate (rs
->remote_desc
, baud_rate
))
5767 /* The requested speed could not be set. Error out to
5768 top level after closing remote_desc. Take care to
5769 set remote_desc to NULL to avoid closing remote_desc
5771 serial_close (rs
->remote_desc
);
5772 rs
->remote_desc
= NULL
;
5773 perror_with_name (name
);
5777 serial_setparity (rs
->remote_desc
, serial_parity
);
5778 serial_raw (rs
->remote_desc
);
5780 /* If there is something sitting in the buffer we might take it as a
5781 response to a command, which would be bad. */
5782 serial_flush_input (rs
->remote_desc
);
5786 puts_filtered ("Remote debugging using ");
5787 puts_filtered (name
);
5788 puts_filtered ("\n");
5791 /* Switch to using the remote target now. */
5792 current_inferior ()->push_target (std::move (target_holder
));
5794 /* Register extra event sources in the event loop. */
5795 rs
->remote_async_inferior_event_token
5796 = create_async_event_handler (remote_async_inferior_event_handler
, nullptr,
5798 rs
->notif_state
= remote_notif_state_allocate (remote
);
5800 /* Reset the target state; these things will be queried either by
5801 remote_query_supported or as they are needed. */
5802 reset_all_packet_configs_support ();
5803 rs
->explicit_packet_size
= 0;
5805 rs
->extended
= extended_p
;
5806 rs
->waiting_for_stop_reply
= 0;
5807 rs
->ctrlc_pending_p
= 0;
5808 rs
->got_ctrlc_during_io
= 0;
5810 rs
->general_thread
= not_sent_ptid
;
5811 rs
->continue_thread
= not_sent_ptid
;
5812 rs
->remote_traceframe_number
= -1;
5814 rs
->last_resume_exec_dir
= EXEC_FORWARD
;
5816 /* Probe for ability to use "ThreadInfo" query, as required. */
5817 rs
->use_threadinfo_query
= 1;
5818 rs
->use_threadextra_query
= 1;
5820 rs
->readahead_cache
.invalidate ();
5822 if (target_async_permitted
)
5824 /* FIXME: cagney/1999-09-23: During the initial connection it is
5825 assumed that the target is already ready and able to respond to
5826 requests. Unfortunately remote_start_remote() eventually calls
5827 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
5828 around this. Eventually a mechanism that allows
5829 wait_for_inferior() to expect/get timeouts will be
5831 rs
->wait_forever_enabled_p
= 0;
5834 /* First delete any symbols previously loaded from shared libraries. */
5835 no_shared_libraries (NULL
, 0);
5837 /* Start the remote connection. If error() or QUIT, discard this
5838 target (we'd otherwise be in an inconsistent state) and then
5839 propogate the error on up the exception chain. This ensures that
5840 the caller doesn't stumble along blindly assuming that the
5841 function succeeded. The CLI doesn't have this problem but other
5842 UI's, such as MI do.
5844 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
5845 this function should return an error indication letting the
5846 caller restore the previous state. Unfortunately the command
5847 ``target remote'' is directly wired to this function making that
5848 impossible. On a positive note, the CLI side of this problem has
5849 been fixed - the function set_cmd_context() makes it possible for
5850 all the ``target ....'' commands to share a common callback
5851 function. See cli-dump.c. */
5856 remote
->start_remote (from_tty
, extended_p
);
5858 catch (const gdb_exception
&ex
)
5860 /* Pop the partially set up target - unless something else did
5861 already before throwing the exception. */
5862 if (ex
.error
!= TARGET_CLOSE_ERROR
)
5863 remote_unpush_target (remote
);
5868 remote_btrace_reset (rs
);
5870 if (target_async_permitted
)
5871 rs
->wait_forever_enabled_p
= 1;
5874 /* Determine if WS represents a fork status. */
5877 is_fork_status (target_waitkind kind
)
5879 return (kind
== TARGET_WAITKIND_FORKED
5880 || kind
== TARGET_WAITKIND_VFORKED
);
5883 /* Return THREAD's pending status if it is a pending fork parent, else
5886 static const target_waitstatus
*
5887 thread_pending_fork_status (struct thread_info
*thread
)
5889 const target_waitstatus
&ws
5890 = (thread
->has_pending_waitstatus ()
5891 ? thread
->pending_waitstatus ()
5892 : thread
->pending_follow
);
5894 if (!is_fork_status (ws
.kind ()))
5900 /* Detach the specified process. */
5903 remote_target::remote_detach_pid (int pid
)
5905 struct remote_state
*rs
= get_remote_state ();
5907 /* This should not be necessary, but the handling for D;PID in
5908 GDBserver versions prior to 8.2 incorrectly assumes that the
5909 selected process points to the same process we're detaching,
5910 leading to misbehavior (and possibly GDBserver crashing) when it
5911 does not. Since it's easy and cheap, work around it by forcing
5912 GDBserver to select GDB's current process. */
5913 set_general_process ();
5915 if (remote_multi_process_p (rs
))
5916 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "D;%x", pid
);
5918 strcpy (rs
->buf
.data (), "D");
5921 getpkt (&rs
->buf
, 0);
5923 if (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K')
5925 else if (rs
->buf
[0] == '\0')
5926 error (_("Remote doesn't know how to detach"));
5928 error (_("Can't detach process."));
5931 /* This detaches a program to which we previously attached, using
5932 inferior_ptid to identify the process. After this is done, GDB
5933 can be used to debug some other program. We better not have left
5934 any breakpoints in the target program or it'll die when it hits
5938 remote_target::remote_detach_1 (inferior
*inf
, int from_tty
)
5940 int pid
= inferior_ptid
.pid ();
5941 struct remote_state
*rs
= get_remote_state ();
5944 if (!target_has_execution ())
5945 error (_("No process to detach from."));
5947 target_announce_detach (from_tty
);
5949 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
5951 /* If we're in breakpoints-always-inserted mode, or the inferior
5952 is running, we have to remove breakpoints before detaching.
5953 We don't do this in common code instead because not all
5954 targets support removing breakpoints while the target is
5955 running. The remote target / gdbserver does, though. */
5956 remove_breakpoints_inf (current_inferior ());
5959 /* Tell the remote target to detach. */
5960 remote_detach_pid (pid
);
5962 /* Exit only if this is the only active inferior. */
5963 if (from_tty
&& !rs
->extended
&& number_of_live_inferiors (this) == 1)
5964 puts_filtered (_("Ending remote debugging.\n"));
5966 /* See if any thread of the inferior we are detaching has a pending fork
5967 status. In that case, we must detach from the child resulting from
5969 for (thread_info
*thread
: inf
->non_exited_threads ())
5971 const target_waitstatus
*ws
= thread_pending_fork_status (thread
);
5976 remote_detach_pid (ws
->child_ptid ().pid ());
5979 /* Check also for any pending fork events in the stop reply queue. */
5980 remote_notif_get_pending_events (¬if_client_stop
);
5981 for (stop_reply_up
&reply
: rs
->stop_reply_queue
)
5983 if (reply
->ptid
.pid () != pid
)
5986 if (!is_fork_status (reply
->ws
.kind ()))
5989 remote_detach_pid (reply
->ws
.child_ptid ().pid ());
5992 thread_info
*tp
= find_thread_ptid (this, inferior_ptid
);
5994 /* Check to see if we are detaching a fork parent. Note that if we
5995 are detaching a fork child, tp == NULL. */
5996 is_fork_parent
= (tp
!= NULL
5997 && tp
->pending_follow
.kind () == TARGET_WAITKIND_FORKED
);
5999 /* If doing detach-on-fork, we don't mourn, because that will delete
6000 breakpoints that should be available for the followed inferior. */
6001 if (!is_fork_parent
)
6003 /* Save the pid as a string before mourning, since that will
6004 unpush the remote target, and we need the string after. */
6005 std::string infpid
= target_pid_to_str (ptid_t (pid
));
6007 target_mourn_inferior (inferior_ptid
);
6008 if (print_inferior_events
)
6009 printf_unfiltered (_("[Inferior %d (%s) detached]\n"),
6010 inf
->num
, infpid
.c_str ());
6014 switch_to_no_thread ();
6015 detach_inferior (current_inferior ());
6020 remote_target::detach (inferior
*inf
, int from_tty
)
6022 remote_detach_1 (inf
, from_tty
);
6026 extended_remote_target::detach (inferior
*inf
, int from_tty
)
6028 remote_detach_1 (inf
, from_tty
);
6031 /* Target follow-fork function for remote targets. On entry, and
6032 at return, the current inferior is the fork parent.
6034 Note that although this is currently only used for extended-remote,
6035 it is named remote_follow_fork in anticipation of using it for the
6036 remote target as well. */
6039 remote_target::follow_fork (inferior
*child_inf
, ptid_t child_ptid
,
6040 target_waitkind fork_kind
, bool follow_child
,
6043 process_stratum_target::follow_fork (child_inf
, child_ptid
,
6044 fork_kind
, follow_child
, detach_fork
);
6046 struct remote_state
*rs
= get_remote_state ();
6048 if ((fork_kind
== TARGET_WAITKIND_FORKED
&& remote_fork_event_p (rs
))
6049 || (fork_kind
== TARGET_WAITKIND_VFORKED
&& remote_vfork_event_p (rs
)))
6051 /* When following the parent and detaching the child, we detach
6052 the child here. For the case of following the child and
6053 detaching the parent, the detach is done in the target-
6054 independent follow fork code in infrun.c. We can't use
6055 target_detach when detaching an unfollowed child because
6056 the client side doesn't know anything about the child. */
6057 if (detach_fork
&& !follow_child
)
6059 /* Detach the fork child. */
6060 remote_detach_pid (child_ptid
.pid ());
6065 /* Target follow-exec function for remote targets. Save EXECD_PATHNAME
6066 in the program space of the new inferior. */
6069 remote_target::follow_exec (inferior
*follow_inf
, ptid_t ptid
,
6070 const char *execd_pathname
)
6072 process_stratum_target::follow_exec (follow_inf
, ptid
, execd_pathname
);
6074 /* We know that this is a target file name, so if it has the "target:"
6075 prefix we strip it off before saving it in the program space. */
6076 if (is_target_filename (execd_pathname
))
6077 execd_pathname
+= strlen (TARGET_SYSROOT_PREFIX
);
6079 set_pspace_remote_exec_file (follow_inf
->pspace
, execd_pathname
);
6082 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
6085 remote_target::disconnect (const char *args
, int from_tty
)
6088 error (_("Argument given to \"disconnect\" when remotely debugging."));
6090 /* Make sure we unpush even the extended remote targets. Calling
6091 target_mourn_inferior won't unpush, and
6092 remote_target::mourn_inferior won't unpush if there is more than
6093 one inferior left. */
6094 remote_unpush_target (this);
6097 puts_filtered ("Ending remote debugging.\n");
6100 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
6101 be chatty about it. */
6104 extended_remote_target::attach (const char *args
, int from_tty
)
6106 struct remote_state
*rs
= get_remote_state ();
6108 char *wait_status
= NULL
;
6110 pid
= parse_pid_to_attach (args
);
6112 /* Remote PID can be freely equal to getpid, do not check it here the same
6113 way as in other targets. */
6115 if (packet_support (PACKET_vAttach
) == PACKET_DISABLE
)
6116 error (_("This target does not support attaching to a process"));
6120 const char *exec_file
= get_exec_file (0);
6123 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file
,
6124 target_pid_to_str (ptid_t (pid
)).c_str ());
6126 printf_unfiltered (_("Attaching to %s\n"),
6127 target_pid_to_str (ptid_t (pid
)).c_str ());
6130 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "vAttach;%x", pid
);
6132 getpkt (&rs
->buf
, 0);
6134 switch (packet_ok (rs
->buf
,
6135 &remote_protocol_packets
[PACKET_vAttach
]))
6138 if (!target_is_non_stop_p ())
6140 /* Save the reply for later. */
6141 wait_status
= (char *) alloca (strlen (rs
->buf
.data ()) + 1);
6142 strcpy (wait_status
, rs
->buf
.data ());
6144 else if (strcmp (rs
->buf
.data (), "OK") != 0)
6145 error (_("Attaching to %s failed with: %s"),
6146 target_pid_to_str (ptid_t (pid
)).c_str (),
6149 case PACKET_UNKNOWN
:
6150 error (_("This target does not support attaching to a process"));
6152 error (_("Attaching to %s failed"),
6153 target_pid_to_str (ptid_t (pid
)).c_str ());
6156 switch_to_inferior_no_thread (remote_add_inferior (false, pid
, 1, 0));
6158 inferior_ptid
= ptid_t (pid
);
6160 if (target_is_non_stop_p ())
6162 /* Get list of threads. */
6163 update_thread_list ();
6165 thread_info
*thread
= first_thread_of_inferior (current_inferior ());
6166 if (thread
!= nullptr)
6167 switch_to_thread (thread
);
6169 /* Invalidate our notion of the remote current thread. */
6170 record_currthread (rs
, minus_one_ptid
);
6174 /* Now, if we have thread information, update the main thread's
6176 ptid_t curr_ptid
= remote_current_thread (ptid_t (pid
));
6178 /* Add the main thread to the thread list. We add the thread
6179 silently in this case (the final true parameter). */
6180 thread_info
*thr
= remote_add_thread (curr_ptid
, true, true, true);
6182 switch_to_thread (thr
);
6185 /* Next, if the target can specify a description, read it. We do
6186 this before anything involving memory or registers. */
6187 target_find_description ();
6189 if (!target_is_non_stop_p ())
6191 /* Use the previously fetched status. */
6192 gdb_assert (wait_status
!= NULL
);
6194 struct notif_event
*reply
6195 = remote_notif_parse (this, ¬if_client_stop
, wait_status
);
6197 push_stop_reply ((struct stop_reply
*) reply
);
6199 if (target_can_async_p ())
6204 gdb_assert (wait_status
== NULL
);
6206 gdb_assert (target_can_async_p ());
6211 /* Implementation of the to_post_attach method. */
6214 extended_remote_target::post_attach (int pid
)
6216 /* Get text, data & bss offsets. */
6219 /* In certain cases GDB might not have had the chance to start
6220 symbol lookup up until now. This could happen if the debugged
6221 binary is not using shared libraries, the vsyscall page is not
6222 present (on Linux) and the binary itself hadn't changed since the
6223 debugging process was started. */
6224 if (current_program_space
->symfile_object_file
!= NULL
)
6225 remote_check_symbols();
6229 /* Check for the availability of vCont. This function should also check
6233 remote_target::remote_vcont_probe ()
6235 remote_state
*rs
= get_remote_state ();
6238 strcpy (rs
->buf
.data (), "vCont?");
6240 getpkt (&rs
->buf
, 0);
6241 buf
= rs
->buf
.data ();
6243 /* Make sure that the features we assume are supported. */
6244 if (startswith (buf
, "vCont"))
6247 int support_c
, support_C
;
6249 rs
->supports_vCont
.s
= 0;
6250 rs
->supports_vCont
.S
= 0;
6253 rs
->supports_vCont
.t
= 0;
6254 rs
->supports_vCont
.r
= 0;
6255 while (p
&& *p
== ';')
6258 if (*p
== 's' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6259 rs
->supports_vCont
.s
= 1;
6260 else if (*p
== 'S' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6261 rs
->supports_vCont
.S
= 1;
6262 else if (*p
== 'c' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6264 else if (*p
== 'C' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6266 else if (*p
== 't' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6267 rs
->supports_vCont
.t
= 1;
6268 else if (*p
== 'r' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6269 rs
->supports_vCont
.r
= 1;
6271 p
= strchr (p
, ';');
6274 /* If c, and C are not all supported, we can't use vCont. Clearing
6275 BUF will make packet_ok disable the packet. */
6276 if (!support_c
|| !support_C
)
6280 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vCont
]);
6281 rs
->supports_vCont_probed
= true;
6284 /* Helper function for building "vCont" resumptions. Write a
6285 resumption to P. ENDP points to one-passed-the-end of the buffer
6286 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
6287 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
6288 resumed thread should be single-stepped and/or signalled. If PTID
6289 equals minus_one_ptid, then all threads are resumed; if PTID
6290 represents a process, then all threads of the process are resumed;
6291 the thread to be stepped and/or signalled is given in the global
6295 remote_target::append_resumption (char *p
, char *endp
,
6296 ptid_t ptid
, int step
, gdb_signal siggnal
)
6298 struct remote_state
*rs
= get_remote_state ();
6300 if (step
&& siggnal
!= GDB_SIGNAL_0
)
6301 p
+= xsnprintf (p
, endp
- p
, ";S%02x", siggnal
);
6303 /* GDB is willing to range step. */
6304 && use_range_stepping
6305 /* Target supports range stepping. */
6306 && rs
->supports_vCont
.r
6307 /* We don't currently support range stepping multiple
6308 threads with a wildcard (though the protocol allows it,
6309 so stubs shouldn't make an active effort to forbid
6311 && !(remote_multi_process_p (rs
) && ptid
.is_pid ()))
6313 struct thread_info
*tp
;
6315 if (ptid
== minus_one_ptid
)
6317 /* If we don't know about the target thread's tid, then
6318 we're resuming magic_null_ptid (see caller). */
6319 tp
= find_thread_ptid (this, magic_null_ptid
);
6322 tp
= find_thread_ptid (this, ptid
);
6323 gdb_assert (tp
!= NULL
);
6325 if (tp
->control
.may_range_step
)
6327 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
6329 p
+= xsnprintf (p
, endp
- p
, ";r%s,%s",
6330 phex_nz (tp
->control
.step_range_start
,
6332 phex_nz (tp
->control
.step_range_end
,
6336 p
+= xsnprintf (p
, endp
- p
, ";s");
6339 p
+= xsnprintf (p
, endp
- p
, ";s");
6340 else if (siggnal
!= GDB_SIGNAL_0
)
6341 p
+= xsnprintf (p
, endp
- p
, ";C%02x", siggnal
);
6343 p
+= xsnprintf (p
, endp
- p
, ";c");
6345 if (remote_multi_process_p (rs
) && ptid
.is_pid ())
6349 /* All (-1) threads of process. */
6350 nptid
= ptid_t (ptid
.pid (), -1);
6352 p
+= xsnprintf (p
, endp
- p
, ":");
6353 p
= write_ptid (p
, endp
, nptid
);
6355 else if (ptid
!= minus_one_ptid
)
6357 p
+= xsnprintf (p
, endp
- p
, ":");
6358 p
= write_ptid (p
, endp
, ptid
);
6364 /* Clear the thread's private info on resume. */
6367 resume_clear_thread_private_info (struct thread_info
*thread
)
6369 if (thread
->priv
!= NULL
)
6371 remote_thread_info
*priv
= get_remote_thread_info (thread
);
6373 priv
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
6374 priv
->watch_data_address
= 0;
6378 /* Append a vCont continue-with-signal action for threads that have a
6379 non-zero stop signal. */
6382 remote_target::append_pending_thread_resumptions (char *p
, char *endp
,
6385 for (thread_info
*thread
: all_non_exited_threads (this, ptid
))
6386 if (inferior_ptid
!= thread
->ptid
6387 && thread
->stop_signal () != GDB_SIGNAL_0
)
6389 p
= append_resumption (p
, endp
, thread
->ptid
,
6390 0, thread
->stop_signal ());
6391 thread
->set_stop_signal (GDB_SIGNAL_0
);
6392 resume_clear_thread_private_info (thread
);
6398 /* Set the target running, using the packets that use Hc
6402 remote_target::remote_resume_with_hc (ptid_t ptid
, int step
,
6405 struct remote_state
*rs
= get_remote_state ();
6408 rs
->last_sent_signal
= siggnal
;
6409 rs
->last_sent_step
= step
;
6411 /* The c/s/C/S resume packets use Hc, so set the continue
6413 if (ptid
== minus_one_ptid
)
6414 set_continue_thread (any_thread_ptid
);
6416 set_continue_thread (ptid
);
6418 for (thread_info
*thread
: all_non_exited_threads (this))
6419 resume_clear_thread_private_info (thread
);
6421 buf
= rs
->buf
.data ();
6422 if (::execution_direction
== EXEC_REVERSE
)
6424 /* We don't pass signals to the target in reverse exec mode. */
6425 if (info_verbose
&& siggnal
!= GDB_SIGNAL_0
)
6426 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
6429 if (step
&& packet_support (PACKET_bs
) == PACKET_DISABLE
)
6430 error (_("Remote reverse-step not supported."));
6431 if (!step
&& packet_support (PACKET_bc
) == PACKET_DISABLE
)
6432 error (_("Remote reverse-continue not supported."));
6434 strcpy (buf
, step
? "bs" : "bc");
6436 else if (siggnal
!= GDB_SIGNAL_0
)
6438 buf
[0] = step
? 'S' : 'C';
6439 buf
[1] = tohex (((int) siggnal
>> 4) & 0xf);
6440 buf
[2] = tohex (((int) siggnal
) & 0xf);
6444 strcpy (buf
, step
? "s" : "c");
6449 /* Resume the remote inferior by using a "vCont" packet. The thread
6450 to be resumed is PTID; STEP and SIGGNAL indicate whether the
6451 resumed thread should be single-stepped and/or signalled. If PTID
6452 equals minus_one_ptid, then all threads are resumed; the thread to
6453 be stepped and/or signalled is given in the global INFERIOR_PTID.
6454 This function returns non-zero iff it resumes the inferior.
6456 This function issues a strict subset of all possible vCont commands
6460 remote_target::remote_resume_with_vcont (ptid_t ptid
, int step
,
6461 enum gdb_signal siggnal
)
6463 struct remote_state
*rs
= get_remote_state ();
6467 /* No reverse execution actions defined for vCont. */
6468 if (::execution_direction
== EXEC_REVERSE
)
6471 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
6472 remote_vcont_probe ();
6474 if (packet_support (PACKET_vCont
) == PACKET_DISABLE
)
6477 p
= rs
->buf
.data ();
6478 endp
= p
+ get_remote_packet_size ();
6480 /* If we could generate a wider range of packets, we'd have to worry
6481 about overflowing BUF. Should there be a generic
6482 "multi-part-packet" packet? */
6484 p
+= xsnprintf (p
, endp
- p
, "vCont");
6486 if (ptid
== magic_null_ptid
)
6488 /* MAGIC_NULL_PTID means that we don't have any active threads,
6489 so we don't have any TID numbers the inferior will
6490 understand. Make sure to only send forms that do not specify
6492 append_resumption (p
, endp
, minus_one_ptid
, step
, siggnal
);
6494 else if (ptid
== minus_one_ptid
|| ptid
.is_pid ())
6496 /* Resume all threads (of all processes, or of a single
6497 process), with preference for INFERIOR_PTID. This assumes
6498 inferior_ptid belongs to the set of all threads we are about
6500 if (step
|| siggnal
!= GDB_SIGNAL_0
)
6502 /* Step inferior_ptid, with or without signal. */
6503 p
= append_resumption (p
, endp
, inferior_ptid
, step
, siggnal
);
6506 /* Also pass down any pending signaled resumption for other
6507 threads not the current. */
6508 p
= append_pending_thread_resumptions (p
, endp
, ptid
);
6510 /* And continue others without a signal. */
6511 append_resumption (p
, endp
, ptid
, /*step=*/ 0, GDB_SIGNAL_0
);
6515 /* Scheduler locking; resume only PTID. */
6516 append_resumption (p
, endp
, ptid
, step
, siggnal
);
6519 gdb_assert (strlen (rs
->buf
.data ()) < get_remote_packet_size ());
6522 if (target_is_non_stop_p ())
6524 /* In non-stop, the stub replies to vCont with "OK". The stop
6525 reply will be reported asynchronously by means of a `%Stop'
6527 getpkt (&rs
->buf
, 0);
6528 if (strcmp (rs
->buf
.data (), "OK") != 0)
6529 error (_("Unexpected vCont reply in non-stop mode: %s"),
6536 /* Tell the remote machine to resume. */
6539 remote_target::resume (ptid_t ptid
, int step
, enum gdb_signal siggnal
)
6541 struct remote_state
*rs
= get_remote_state ();
6543 /* When connected in non-stop mode, the core resumes threads
6544 individually. Resuming remote threads directly in target_resume
6545 would thus result in sending one packet per thread. Instead, to
6546 minimize roundtrip latency, here we just store the resume
6547 request (put the thread in RESUMED_PENDING_VCONT state); the actual remote
6548 resumption will be done in remote_target::commit_resume, where we'll be
6549 able to do vCont action coalescing. */
6550 if (target_is_non_stop_p () && ::execution_direction
!= EXEC_REVERSE
)
6552 remote_thread_info
*remote_thr
;
6554 if (minus_one_ptid
== ptid
|| ptid
.is_pid ())
6555 remote_thr
= get_remote_thread_info (this, inferior_ptid
);
6557 remote_thr
= get_remote_thread_info (this, ptid
);
6559 /* We don't expect the core to ask to resume an already resumed (from
6560 its point of view) thread. */
6561 gdb_assert (remote_thr
->get_resume_state () == resume_state::NOT_RESUMED
);
6563 remote_thr
->set_resumed_pending_vcont (step
, siggnal
);
6567 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
6568 (explained in remote-notif.c:handle_notification) so
6569 remote_notif_process is not called. We need find a place where
6570 it is safe to start a 'vNotif' sequence. It is good to do it
6571 before resuming inferior, because inferior was stopped and no RSP
6572 traffic at that moment. */
6573 if (!target_is_non_stop_p ())
6574 remote_notif_process (rs
->notif_state
, ¬if_client_stop
);
6576 rs
->last_resume_exec_dir
= ::execution_direction
;
6578 /* Prefer vCont, and fallback to s/c/S/C, which use Hc. */
6579 if (!remote_resume_with_vcont (ptid
, step
, siggnal
))
6580 remote_resume_with_hc (ptid
, step
, siggnal
);
6582 /* Update resumed state tracked by the remote target. */
6583 for (thread_info
*tp
: all_non_exited_threads (this, ptid
))
6584 get_remote_thread_info (tp
)->set_resumed ();
6586 /* We are about to start executing the inferior, let's register it
6587 with the event loop. NOTE: this is the one place where all the
6588 execution commands end up. We could alternatively do this in each
6589 of the execution commands in infcmd.c. */
6590 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
6591 into infcmd.c in order to allow inferior function calls to work
6592 NOT asynchronously. */
6593 if (target_can_async_p ())
6596 /* We've just told the target to resume. The remote server will
6597 wait for the inferior to stop, and then send a stop reply. In
6598 the mean time, we can't start another command/query ourselves
6599 because the stub wouldn't be ready to process it. This applies
6600 only to the base all-stop protocol, however. In non-stop (which
6601 only supports vCont), the stub replies with an "OK", and is
6602 immediate able to process further serial input. */
6603 if (!target_is_non_stop_p ())
6604 rs
->waiting_for_stop_reply
= 1;
6607 /* Private per-inferior info for target remote processes. */
6609 struct remote_inferior
: public private_inferior
6611 /* Whether we can send a wildcard vCont for this process. */
6612 bool may_wildcard_vcont
= true;
6615 /* Get the remote private inferior data associated to INF. */
6617 static remote_inferior
*
6618 get_remote_inferior (inferior
*inf
)
6620 if (inf
->priv
== NULL
)
6621 inf
->priv
.reset (new remote_inferior
);
6623 return static_cast<remote_inferior
*> (inf
->priv
.get ());
6626 /* Class used to track the construction of a vCont packet in the
6627 outgoing packet buffer. This is used to send multiple vCont
6628 packets if we have more actions than would fit a single packet. */
6633 explicit vcont_builder (remote_target
*remote
)
6640 void push_action (ptid_t ptid
, bool step
, gdb_signal siggnal
);
6645 /* The remote target. */
6646 remote_target
*m_remote
;
6648 /* Pointer to the first action. P points here if no action has been
6650 char *m_first_action
;
6652 /* Where the next action will be appended. */
6655 /* The end of the buffer. Must never write past this. */
6659 /* Prepare the outgoing buffer for a new vCont packet. */
6662 vcont_builder::restart ()
6664 struct remote_state
*rs
= m_remote
->get_remote_state ();
6666 m_p
= rs
->buf
.data ();
6667 m_endp
= m_p
+ m_remote
->get_remote_packet_size ();
6668 m_p
+= xsnprintf (m_p
, m_endp
- m_p
, "vCont");
6669 m_first_action
= m_p
;
6672 /* If the vCont packet being built has any action, send it to the
6676 vcont_builder::flush ()
6678 struct remote_state
*rs
;
6680 if (m_p
== m_first_action
)
6683 rs
= m_remote
->get_remote_state ();
6684 m_remote
->putpkt (rs
->buf
);
6685 m_remote
->getpkt (&rs
->buf
, 0);
6686 if (strcmp (rs
->buf
.data (), "OK") != 0)
6687 error (_("Unexpected vCont reply in non-stop mode: %s"), rs
->buf
.data ());
6690 /* The largest action is range-stepping, with its two addresses. This
6691 is more than sufficient. If a new, bigger action is created, it'll
6692 quickly trigger a failed assertion in append_resumption (and we'll
6694 #define MAX_ACTION_SIZE 200
6696 /* Append a new vCont action in the outgoing packet being built. If
6697 the action doesn't fit the packet along with previous actions, push
6698 what we've got so far to the remote end and start over a new vCont
6699 packet (with the new action). */
6702 vcont_builder::push_action (ptid_t ptid
, bool step
, gdb_signal siggnal
)
6704 char buf
[MAX_ACTION_SIZE
+ 1];
6706 char *endp
= m_remote
->append_resumption (buf
, buf
+ sizeof (buf
),
6707 ptid
, step
, siggnal
);
6709 /* Check whether this new action would fit in the vCont packet along
6710 with previous actions. If not, send what we've got so far and
6711 start a new vCont packet. */
6712 size_t rsize
= endp
- buf
;
6713 if (rsize
> m_endp
- m_p
)
6718 /* Should now fit. */
6719 gdb_assert (rsize
<= m_endp
- m_p
);
6722 memcpy (m_p
, buf
, rsize
);
6727 /* to_commit_resume implementation. */
6730 remote_target::commit_resumed ()
6732 /* If connected in all-stop mode, we'd send the remote resume
6733 request directly from remote_resume. Likewise if
6734 reverse-debugging, as there are no defined vCont actions for
6735 reverse execution. */
6736 if (!target_is_non_stop_p () || ::execution_direction
== EXEC_REVERSE
)
6739 /* Try to send wildcard actions ("vCont;c" or "vCont;c:pPID.-1")
6740 instead of resuming all threads of each process individually.
6741 However, if any thread of a process must remain halted, we can't
6742 send wildcard resumes and must send one action per thread.
6744 Care must be taken to not resume threads/processes the server
6745 side already told us are stopped, but the core doesn't know about
6746 yet, because the events are still in the vStopped notification
6749 #1 => vCont s:p1.1;c
6751 #3 <= %Stopped T05 p1.1
6756 #8 (infrun handles the stop for p1.1 and continues stepping)
6757 #9 => vCont s:p1.1;c
6759 The last vCont above would resume thread p1.2 by mistake, because
6760 the server has no idea that the event for p1.2 had not been
6763 The server side must similarly ignore resume actions for the
6764 thread that has a pending %Stopped notification (and any other
6765 threads with events pending), until GDB acks the notification
6766 with vStopped. Otherwise, e.g., the following case is
6769 #1 => g (or any other packet)
6771 #3 <= %Stopped T05 p1.2
6772 #4 => vCont s:p1.1;c
6775 Above, the server must not resume thread p1.2. GDB can't know
6776 that p1.2 stopped until it acks the %Stopped notification, and
6777 since from GDB's perspective all threads should be running, it
6780 Finally, special care must also be given to handling fork/vfork
6781 events. A (v)fork event actually tells us that two processes
6782 stopped -- the parent and the child. Until we follow the fork,
6783 we must not resume the child. Therefore, if we have a pending
6784 fork follow, we must not send a global wildcard resume action
6785 (vCont;c). We can still send process-wide wildcards though. */
6787 /* Start by assuming a global wildcard (vCont;c) is possible. */
6788 bool may_global_wildcard_vcont
= true;
6790 /* And assume every process is individually wildcard-able too. */
6791 for (inferior
*inf
: all_non_exited_inferiors (this))
6793 remote_inferior
*priv
= get_remote_inferior (inf
);
6795 priv
->may_wildcard_vcont
= true;
6798 /* Check for any pending events (not reported or processed yet) and
6799 disable process and global wildcard resumes appropriately. */
6800 check_pending_events_prevent_wildcard_vcont (&may_global_wildcard_vcont
);
6802 bool any_pending_vcont_resume
= false;
6804 for (thread_info
*tp
: all_non_exited_threads (this))
6806 remote_thread_info
*priv
= get_remote_thread_info (tp
);
6808 /* If a thread of a process is not meant to be resumed, then we
6809 can't wildcard that process. */
6810 if (priv
->get_resume_state () == resume_state::NOT_RESUMED
)
6812 get_remote_inferior (tp
->inf
)->may_wildcard_vcont
= false;
6814 /* And if we can't wildcard a process, we can't wildcard
6815 everything either. */
6816 may_global_wildcard_vcont
= false;
6820 if (priv
->get_resume_state () == resume_state::RESUMED_PENDING_VCONT
)
6821 any_pending_vcont_resume
= true;
6823 /* If a thread is the parent of an unfollowed fork, then we
6824 can't do a global wildcard, as that would resume the fork
6826 if (thread_pending_fork_status (tp
) != nullptr)
6827 may_global_wildcard_vcont
= false;
6830 /* We didn't have any resumed thread pending a vCont resume, so nothing to
6832 if (!any_pending_vcont_resume
)
6835 /* Now let's build the vCont packet(s). Actions must be appended
6836 from narrower to wider scopes (thread -> process -> global). If
6837 we end up with too many actions for a single packet vcont_builder
6838 flushes the current vCont packet to the remote side and starts a
6840 struct vcont_builder
vcont_builder (this);
6842 /* Threads first. */
6843 for (thread_info
*tp
: all_non_exited_threads (this))
6845 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6847 /* If the thread was previously vCont-resumed, no need to send a specific
6848 action for it. If we didn't receive a resume request for it, don't
6849 send an action for it either. */
6850 if (remote_thr
->get_resume_state () != resume_state::RESUMED_PENDING_VCONT
)
6853 gdb_assert (!thread_is_in_step_over_chain (tp
));
6855 /* We should never be commit-resuming a thread that has a stop reply.
6856 Otherwise, we would end up reporting a stop event for a thread while
6857 it is running on the remote target. */
6858 remote_state
*rs
= get_remote_state ();
6859 for (const auto &stop_reply
: rs
->stop_reply_queue
)
6860 gdb_assert (stop_reply
->ptid
!= tp
->ptid
);
6862 const resumed_pending_vcont_info
&info
6863 = remote_thr
->resumed_pending_vcont_info ();
6865 /* Check if we need to send a specific action for this thread. If not,
6866 it will be included in a wildcard resume instead. */
6867 if (info
.step
|| info
.sig
!= GDB_SIGNAL_0
6868 || !get_remote_inferior (tp
->inf
)->may_wildcard_vcont
)
6869 vcont_builder
.push_action (tp
->ptid
, info
.step
, info
.sig
);
6871 remote_thr
->set_resumed ();
6874 /* Now check whether we can send any process-wide wildcard. This is
6875 to avoid sending a global wildcard in the case nothing is
6876 supposed to be resumed. */
6877 bool any_process_wildcard
= false;
6879 for (inferior
*inf
: all_non_exited_inferiors (this))
6881 if (get_remote_inferior (inf
)->may_wildcard_vcont
)
6883 any_process_wildcard
= true;
6888 if (any_process_wildcard
)
6890 /* If all processes are wildcard-able, then send a single "c"
6891 action, otherwise, send an "all (-1) threads of process"
6892 continue action for each running process, if any. */
6893 if (may_global_wildcard_vcont
)
6895 vcont_builder
.push_action (minus_one_ptid
,
6896 false, GDB_SIGNAL_0
);
6900 for (inferior
*inf
: all_non_exited_inferiors (this))
6902 if (get_remote_inferior (inf
)->may_wildcard_vcont
)
6904 vcont_builder
.push_action (ptid_t (inf
->pid
),
6905 false, GDB_SIGNAL_0
);
6911 vcont_builder
.flush ();
6914 /* Implementation of target_has_pending_events. */
6917 remote_target::has_pending_events ()
6919 if (target_can_async_p ())
6921 remote_state
*rs
= get_remote_state ();
6923 if (async_event_handler_marked (rs
->remote_async_inferior_event_token
))
6926 /* Note that BUFCNT can be negative, indicating sticky
6928 if (rs
->remote_desc
->bufcnt
!= 0)
6936 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
6937 thread, all threads of a remote process, or all threads of all
6941 remote_target::remote_stop_ns (ptid_t ptid
)
6943 struct remote_state
*rs
= get_remote_state ();
6944 char *p
= rs
->buf
.data ();
6945 char *endp
= p
+ get_remote_packet_size ();
6947 /* If any thread that needs to stop was resumed but pending a vCont
6948 resume, generate a phony stop_reply. However, first check
6949 whether the thread wasn't resumed with a signal. Generating a
6950 phony stop in that case would result in losing the signal. */
6951 bool needs_commit
= false;
6952 for (thread_info
*tp
: all_non_exited_threads (this, ptid
))
6954 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6956 if (remote_thr
->get_resume_state ()
6957 == resume_state::RESUMED_PENDING_VCONT
)
6959 const resumed_pending_vcont_info
&info
6960 = remote_thr
->resumed_pending_vcont_info ();
6961 if (info
.sig
!= GDB_SIGNAL_0
)
6963 /* This signal must be forwarded to the inferior. We
6964 could commit-resume just this thread, but its simpler
6965 to just commit-resume everything. */
6966 needs_commit
= true;
6975 for (thread_info
*tp
: all_non_exited_threads (this, ptid
))
6977 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6979 if (remote_thr
->get_resume_state ()
6980 == resume_state::RESUMED_PENDING_VCONT
)
6982 remote_debug_printf ("Enqueueing phony stop reply for thread pending "
6983 "vCont-resume (%d, %ld, %s)", tp
->ptid
.pid(),
6985 pulongest (tp
->ptid
.tid ()));
6987 /* Check that the thread wasn't resumed with a signal.
6988 Generating a phony stop would result in losing the
6990 const resumed_pending_vcont_info
&info
6991 = remote_thr
->resumed_pending_vcont_info ();
6992 gdb_assert (info
.sig
== GDB_SIGNAL_0
);
6994 stop_reply
*sr
= new stop_reply ();
6995 sr
->ptid
= tp
->ptid
;
6997 sr
->ws
.set_stopped (GDB_SIGNAL_0
);
6998 sr
->arch
= tp
->inf
->gdbarch
;
6999 sr
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
7000 sr
->watch_data_address
= 0;
7002 this->push_stop_reply (sr
);
7004 /* Pretend that this thread was actually resumed on the
7005 remote target, then stopped. If we leave it in the
7006 RESUMED_PENDING_VCONT state and the commit_resumed
7007 method is called while the stop reply is still in the
7008 queue, we'll end up reporting a stop event to the core
7009 for that thread while it is running on the remote
7010 target... that would be bad. */
7011 remote_thr
->set_resumed ();
7015 /* FIXME: This supports_vCont_probed check is a workaround until
7016 packet_support is per-connection. */
7017 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
7018 || !rs
->supports_vCont_probed
)
7019 remote_vcont_probe ();
7021 if (!rs
->supports_vCont
.t
)
7022 error (_("Remote server does not support stopping threads"));
7024 if (ptid
== minus_one_ptid
7025 || (!remote_multi_process_p (rs
) && ptid
.is_pid ()))
7026 p
+= xsnprintf (p
, endp
- p
, "vCont;t");
7031 p
+= xsnprintf (p
, endp
- p
, "vCont;t:");
7034 /* All (-1) threads of process. */
7035 nptid
= ptid_t (ptid
.pid (), -1);
7038 /* Small optimization: if we already have a stop reply for
7039 this thread, no use in telling the stub we want this
7041 if (peek_stop_reply (ptid
))
7047 write_ptid (p
, endp
, nptid
);
7050 /* In non-stop, we get an immediate OK reply. The stop reply will
7051 come in asynchronously by notification. */
7053 getpkt (&rs
->buf
, 0);
7054 if (strcmp (rs
->buf
.data (), "OK") != 0)
7055 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid
).c_str (),
7059 /* All-stop version of target_interrupt. Sends a break or a ^C to
7060 interrupt the remote target. It is undefined which thread of which
7061 process reports the interrupt. */
7064 remote_target::remote_interrupt_as ()
7066 struct remote_state
*rs
= get_remote_state ();
7068 rs
->ctrlc_pending_p
= 1;
7070 /* If the inferior is stopped already, but the core didn't know
7071 about it yet, just ignore the request. The pending stop events
7072 will be collected in remote_wait. */
7073 if (stop_reply_queue_length () > 0)
7076 /* Send interrupt_sequence to remote target. */
7077 send_interrupt_sequence ();
7080 /* Non-stop version of target_interrupt. Uses `vCtrlC' to interrupt
7081 the remote target. It is undefined which thread of which process
7082 reports the interrupt. Throws an error if the packet is not
7083 supported by the server. */
7086 remote_target::remote_interrupt_ns ()
7088 struct remote_state
*rs
= get_remote_state ();
7089 char *p
= rs
->buf
.data ();
7090 char *endp
= p
+ get_remote_packet_size ();
7092 xsnprintf (p
, endp
- p
, "vCtrlC");
7094 /* In non-stop, we get an immediate OK reply. The stop reply will
7095 come in asynchronously by notification. */
7097 getpkt (&rs
->buf
, 0);
7099 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vCtrlC
]))
7103 case PACKET_UNKNOWN
:
7104 error (_("No support for interrupting the remote target."));
7106 error (_("Interrupting target failed: %s"), rs
->buf
.data ());
7110 /* Implement the to_stop function for the remote targets. */
7113 remote_target::stop (ptid_t ptid
)
7115 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7117 if (target_is_non_stop_p ())
7118 remote_stop_ns (ptid
);
7121 /* We don't currently have a way to transparently pause the
7122 remote target in all-stop mode. Interrupt it instead. */
7123 remote_interrupt_as ();
7127 /* Implement the to_interrupt function for the remote targets. */
7130 remote_target::interrupt ()
7132 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7134 if (target_is_non_stop_p ())
7135 remote_interrupt_ns ();
7137 remote_interrupt_as ();
7140 /* Implement the to_pass_ctrlc function for the remote targets. */
7143 remote_target::pass_ctrlc ()
7145 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7147 struct remote_state
*rs
= get_remote_state ();
7149 /* If we're starting up, we're not fully synced yet. Quit
7151 if (rs
->starting_up
)
7153 /* If ^C has already been sent once, offer to disconnect. */
7154 else if (rs
->ctrlc_pending_p
)
7157 target_interrupt ();
7160 /* Ask the user what to do when an interrupt is received. */
7163 remote_target::interrupt_query ()
7165 struct remote_state
*rs
= get_remote_state ();
7167 if (rs
->waiting_for_stop_reply
&& rs
->ctrlc_pending_p
)
7169 if (query (_("The target is not responding to interrupt requests.\n"
7170 "Stop debugging it? ")))
7172 remote_unpush_target (this);
7173 throw_error (TARGET_CLOSE_ERROR
, _("Disconnected from target."));
7178 if (query (_("Interrupted while waiting for the program.\n"
7179 "Give up waiting? ")))
7184 /* Enable/disable target terminal ownership. Most targets can use
7185 terminal groups to control terminal ownership. Remote targets are
7186 different in that explicit transfer of ownership to/from GDB/target
7190 remote_target::terminal_inferior ()
7192 /* NOTE: At this point we could also register our selves as the
7193 recipient of all input. Any characters typed could then be
7194 passed on down to the target. */
7198 remote_target::terminal_ours ()
7203 remote_console_output (const char *msg
)
7207 for (p
= msg
; p
[0] && p
[1]; p
+= 2)
7210 char c
= fromhex (p
[0]) * 16 + fromhex (p
[1]);
7214 gdb_stdtarg
->puts (tb
);
7216 gdb_stdtarg
->flush ();
7219 /* Return the length of the stop reply queue. */
7222 remote_target::stop_reply_queue_length ()
7224 remote_state
*rs
= get_remote_state ();
7225 return rs
->stop_reply_queue
.size ();
7229 remote_notif_stop_parse (remote_target
*remote
,
7230 struct notif_client
*self
, const char *buf
,
7231 struct notif_event
*event
)
7233 remote
->remote_parse_stop_reply (buf
, (struct stop_reply
*) event
);
7237 remote_notif_stop_ack (remote_target
*remote
,
7238 struct notif_client
*self
, const char *buf
,
7239 struct notif_event
*event
)
7241 struct stop_reply
*stop_reply
= (struct stop_reply
*) event
;
7244 putpkt (remote
, self
->ack_command
);
7246 /* Kind can be TARGET_WAITKIND_IGNORE if we have meanwhile discarded
7247 the notification. It was left in the queue because we need to
7248 acknowledge it and pull the rest of the notifications out. */
7249 if (stop_reply
->ws
.kind () != TARGET_WAITKIND_IGNORE
)
7250 remote
->push_stop_reply (stop_reply
);
7254 remote_notif_stop_can_get_pending_events (remote_target
*remote
,
7255 struct notif_client
*self
)
7257 /* We can't get pending events in remote_notif_process for
7258 notification stop, and we have to do this in remote_wait_ns
7259 instead. If we fetch all queued events from stub, remote stub
7260 may exit and we have no chance to process them back in
7262 remote_state
*rs
= remote
->get_remote_state ();
7263 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7267 stop_reply::~stop_reply ()
7269 for (cached_reg_t
®
: regcache
)
7273 static notif_event_up
7274 remote_notif_stop_alloc_reply ()
7276 return notif_event_up (new struct stop_reply ());
7279 /* A client of notification Stop. */
7281 struct notif_client notif_client_stop
=
7285 remote_notif_stop_parse
,
7286 remote_notif_stop_ack
,
7287 remote_notif_stop_can_get_pending_events
,
7288 remote_notif_stop_alloc_reply
,
7292 /* If CONTEXT contains any fork child threads that have not been
7293 reported yet, remove them from the CONTEXT list. If such a
7294 thread exists it is because we are stopped at a fork catchpoint
7295 and have not yet called follow_fork, which will set up the
7296 host-side data structures for the new process. */
7299 remote_target::remove_new_fork_children (threads_listing_context
*context
)
7301 struct notif_client
*notif
= ¬if_client_stop
;
7303 /* For any threads stopped at a fork event, remove the corresponding
7304 fork child threads from the CONTEXT list. */
7305 for (thread_info
*thread
: all_non_exited_threads (this))
7307 const target_waitstatus
*ws
= thread_pending_fork_status (thread
);
7312 context
->remove_thread (ws
->child_ptid ());
7315 /* Check for any pending fork events (not reported or processed yet)
7316 in process PID and remove those fork child threads from the
7317 CONTEXT list as well. */
7318 remote_notif_get_pending_events (notif
);
7319 for (auto &event
: get_remote_state ()->stop_reply_queue
)
7320 if (event
->ws
.kind () == TARGET_WAITKIND_FORKED
7321 || event
->ws
.kind () == TARGET_WAITKIND_VFORKED
7322 || event
->ws
.kind () == TARGET_WAITKIND_THREAD_EXITED
)
7323 context
->remove_thread (event
->ws
.child_ptid ());
7326 /* Check whether any event pending in the vStopped queue would prevent a
7327 global or process wildcard vCont action. Set *may_global_wildcard to
7328 false if we can't do a global wildcard (vCont;c), and clear the event
7329 inferior's may_wildcard_vcont flag if we can't do a process-wide
7330 wildcard resume (vCont;c:pPID.-1). */
7333 remote_target::check_pending_events_prevent_wildcard_vcont
7334 (bool *may_global_wildcard
)
7336 struct notif_client
*notif
= ¬if_client_stop
;
7338 remote_notif_get_pending_events (notif
);
7339 for (auto &event
: get_remote_state ()->stop_reply_queue
)
7341 if (event
->ws
.kind () == TARGET_WAITKIND_NO_RESUMED
7342 || event
->ws
.kind () == TARGET_WAITKIND_NO_HISTORY
)
7345 if (event
->ws
.kind () == TARGET_WAITKIND_FORKED
7346 || event
->ws
.kind () == TARGET_WAITKIND_VFORKED
)
7347 *may_global_wildcard
= false;
7349 /* This may be the first time we heard about this process.
7350 Regardless, we must not do a global wildcard resume, otherwise
7351 we'd resume this process too. */
7352 *may_global_wildcard
= false;
7353 if (event
->ptid
!= null_ptid
)
7355 inferior
*inf
= find_inferior_ptid (this, event
->ptid
);
7357 get_remote_inferior (inf
)->may_wildcard_vcont
= false;
7362 /* Discard all pending stop replies of inferior INF. */
7365 remote_target::discard_pending_stop_replies (struct inferior
*inf
)
7367 struct stop_reply
*reply
;
7368 struct remote_state
*rs
= get_remote_state ();
7369 struct remote_notif_state
*rns
= rs
->notif_state
;
7371 /* This function can be notified when an inferior exists. When the
7372 target is not remote, the notification state is NULL. */
7373 if (rs
->remote_desc
== NULL
)
7376 reply
= (struct stop_reply
*) rns
->pending_event
[notif_client_stop
.id
];
7378 /* Discard the in-flight notification. */
7379 if (reply
!= NULL
&& reply
->ptid
.pid () == inf
->pid
)
7381 /* Leave the notification pending, since the server expects that
7382 we acknowledge it with vStopped. But clear its contents, so
7383 that later on when we acknowledge it, we also discard it. */
7385 ("discarding in-flight notification: ptid: %s, ws: %s\n",
7386 reply
->ptid
.to_string().c_str(),
7387 reply
->ws
.to_string ().c_str ());
7388 reply
->ws
.set_ignore ();
7391 /* Discard the stop replies we have already pulled with
7393 auto iter
= std::remove_if (rs
->stop_reply_queue
.begin (),
7394 rs
->stop_reply_queue
.end (),
7395 [=] (const stop_reply_up
&event
)
7397 return event
->ptid
.pid () == inf
->pid
;
7399 for (auto it
= iter
; it
!= rs
->stop_reply_queue
.end (); ++it
)
7401 ("discarding queued stop reply: ptid: %s, ws: %s\n",
7402 reply
->ptid
.to_string().c_str(),
7403 reply
->ws
.to_string ().c_str ());
7404 rs
->stop_reply_queue
.erase (iter
, rs
->stop_reply_queue
.end ());
7407 /* Discard the stop replies for RS in stop_reply_queue. */
7410 remote_target::discard_pending_stop_replies_in_queue ()
7412 remote_state
*rs
= get_remote_state ();
7414 /* Discard the stop replies we have already pulled with
7416 auto iter
= std::remove_if (rs
->stop_reply_queue
.begin (),
7417 rs
->stop_reply_queue
.end (),
7418 [=] (const stop_reply_up
&event
)
7420 return event
->rs
== rs
;
7422 rs
->stop_reply_queue
.erase (iter
, rs
->stop_reply_queue
.end ());
7425 /* Remove the first reply in 'stop_reply_queue' which matches
7429 remote_target::remote_notif_remove_queued_reply (ptid_t ptid
)
7431 remote_state
*rs
= get_remote_state ();
7433 auto iter
= std::find_if (rs
->stop_reply_queue
.begin (),
7434 rs
->stop_reply_queue
.end (),
7435 [=] (const stop_reply_up
&event
)
7437 return event
->ptid
.matches (ptid
);
7439 struct stop_reply
*result
;
7440 if (iter
== rs
->stop_reply_queue
.end ())
7444 result
= iter
->release ();
7445 rs
->stop_reply_queue
.erase (iter
);
7449 fprintf_unfiltered (gdb_stdlog
,
7450 "notif: discard queued event: 'Stop' in %s\n",
7451 target_pid_to_str (ptid
).c_str ());
7456 /* Look for a queued stop reply belonging to PTID. If one is found,
7457 remove it from the queue, and return it. Returns NULL if none is
7458 found. If there are still queued events left to process, tell the
7459 event loop to get back to target_wait soon. */
7462 remote_target::queued_stop_reply (ptid_t ptid
)
7464 remote_state
*rs
= get_remote_state ();
7465 struct stop_reply
*r
= remote_notif_remove_queued_reply (ptid
);
7467 if (!rs
->stop_reply_queue
.empty () && target_can_async_p ())
7469 /* There's still at least an event left. */
7470 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7476 /* Push a fully parsed stop reply in the stop reply queue. Since we
7477 know that we now have at least one queued event left to pass to the
7478 core side, tell the event loop to get back to target_wait soon. */
7481 remote_target::push_stop_reply (struct stop_reply
*new_event
)
7483 remote_state
*rs
= get_remote_state ();
7484 rs
->stop_reply_queue
.push_back (stop_reply_up (new_event
));
7487 fprintf_unfiltered (gdb_stdlog
,
7488 "notif: push 'Stop' %s to queue %d\n",
7489 target_pid_to_str (new_event
->ptid
).c_str (),
7490 int (rs
->stop_reply_queue
.size ()));
7492 /* Mark the pending event queue only if async mode is currently enabled.
7493 If async mode is not currently enabled, then, if it later becomes
7494 enabled, and there are events in this queue, we will mark the event
7495 token at that point, see remote_target::async. */
7496 if (target_is_async_p ())
7497 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7500 /* Returns true if we have a stop reply for PTID. */
7503 remote_target::peek_stop_reply (ptid_t ptid
)
7505 remote_state
*rs
= get_remote_state ();
7506 for (auto &event
: rs
->stop_reply_queue
)
7507 if (ptid
== event
->ptid
7508 && event
->ws
.kind () == TARGET_WAITKIND_STOPPED
)
7513 /* Helper for remote_parse_stop_reply. Return nonzero if the substring
7514 starting with P and ending with PEND matches PREFIX. */
7517 strprefix (const char *p
, const char *pend
, const char *prefix
)
7519 for ( ; p
< pend
; p
++, prefix
++)
7522 return *prefix
== '\0';
7525 /* Parse the stop reply in BUF. Either the function succeeds, and the
7526 result is stored in EVENT, or throws an error. */
7529 remote_target::remote_parse_stop_reply (const char *buf
, stop_reply
*event
)
7531 remote_arch_state
*rsa
= NULL
;
7536 event
->ptid
= null_ptid
;
7537 event
->rs
= get_remote_state ();
7538 event
->ws
.set_ignore ();
7539 event
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
7540 event
->regcache
.clear ();
7545 case 'T': /* Status with PC, SP, FP, ... */
7546 /* Expedited reply, containing Signal, {regno, reg} repeat. */
7547 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
7549 n... = register number
7550 r... = register contents
7553 p
= &buf
[3]; /* after Txx */
7559 p1
= strchr (p
, ':');
7561 error (_("Malformed packet(a) (missing colon): %s\n\
7565 error (_("Malformed packet(a) (missing register number): %s\n\
7569 /* Some "registers" are actually extended stop information.
7570 Note if you're adding a new entry here: GDB 7.9 and
7571 earlier assume that all register "numbers" that start
7572 with an hex digit are real register numbers. Make sure
7573 the server only sends such a packet if it knows the
7574 client understands it. */
7576 if (strprefix (p
, p1
, "thread"))
7577 event
->ptid
= read_ptid (++p1
, &p
);
7578 else if (strprefix (p
, p1
, "syscall_entry"))
7582 p
= unpack_varlen_hex (++p1
, &sysno
);
7583 event
->ws
.set_syscall_entry ((int) sysno
);
7585 else if (strprefix (p
, p1
, "syscall_return"))
7589 p
= unpack_varlen_hex (++p1
, &sysno
);
7590 event
->ws
.set_syscall_return ((int) sysno
);
7592 else if (strprefix (p
, p1
, "watch")
7593 || strprefix (p
, p1
, "rwatch")
7594 || strprefix (p
, p1
, "awatch"))
7596 event
->stop_reason
= TARGET_STOPPED_BY_WATCHPOINT
;
7597 p
= unpack_varlen_hex (++p1
, &addr
);
7598 event
->watch_data_address
= (CORE_ADDR
) addr
;
7600 else if (strprefix (p
, p1
, "swbreak"))
7602 event
->stop_reason
= TARGET_STOPPED_BY_SW_BREAKPOINT
;
7604 /* Make sure the stub doesn't forget to indicate support
7606 if (packet_support (PACKET_swbreak_feature
) != PACKET_ENABLE
)
7607 error (_("Unexpected swbreak stop reason"));
7609 /* The value part is documented as "must be empty",
7610 though we ignore it, in case we ever decide to make
7611 use of it in a backward compatible way. */
7612 p
= strchrnul (p1
+ 1, ';');
7614 else if (strprefix (p
, p1
, "hwbreak"))
7616 event
->stop_reason
= TARGET_STOPPED_BY_HW_BREAKPOINT
;
7618 /* Make sure the stub doesn't forget to indicate support
7620 if (packet_support (PACKET_hwbreak_feature
) != PACKET_ENABLE
)
7621 error (_("Unexpected hwbreak stop reason"));
7624 p
= strchrnul (p1
+ 1, ';');
7626 else if (strprefix (p
, p1
, "library"))
7628 event
->ws
.set_loaded ();
7629 p
= strchrnul (p1
+ 1, ';');
7631 else if (strprefix (p
, p1
, "replaylog"))
7633 event
->ws
.set_no_history ();
7634 /* p1 will indicate "begin" or "end", but it makes
7635 no difference for now, so ignore it. */
7636 p
= strchrnul (p1
+ 1, ';');
7638 else if (strprefix (p
, p1
, "core"))
7642 p
= unpack_varlen_hex (++p1
, &c
);
7645 else if (strprefix (p
, p1
, "fork"))
7646 event
->ws
.set_forked (read_ptid (++p1
, &p
));
7647 else if (strprefix (p
, p1
, "vfork"))
7648 event
->ws
.set_vforked (read_ptid (++p1
, &p
));
7649 else if (strprefix (p
, p1
, "vforkdone"))
7651 event
->ws
.set_vfork_done ();
7652 p
= strchrnul (p1
+ 1, ';');
7654 else if (strprefix (p
, p1
, "exec"))
7659 /* Determine the length of the execd pathname. */
7660 p
= unpack_varlen_hex (++p1
, &ignored
);
7661 pathlen
= (p
- p1
) / 2;
7663 /* Save the pathname for event reporting and for
7664 the next run command. */
7665 gdb::unique_xmalloc_ptr
<char> pathname
7666 ((char *) xmalloc (pathlen
+ 1));
7667 hex2bin (p1
, (gdb_byte
*) pathname
.get (), pathlen
);
7668 pathname
.get ()[pathlen
] = '\0';
7670 /* This is freed during event handling. */
7671 event
->ws
.set_execd (std::move (pathname
));
7673 /* Skip the registers included in this packet, since
7674 they may be for an architecture different from the
7675 one used by the original program. */
7678 else if (strprefix (p
, p1
, "create"))
7680 event
->ws
.set_thread_created ();
7681 p
= strchrnul (p1
+ 1, ';');
7690 p
= strchrnul (p1
+ 1, ';');
7695 /* Maybe a real ``P'' register number. */
7696 p_temp
= unpack_varlen_hex (p
, &pnum
);
7697 /* If the first invalid character is the colon, we got a
7698 register number. Otherwise, it's an unknown stop
7702 /* If we haven't parsed the event's thread yet, find
7703 it now, in order to find the architecture of the
7704 reported expedited registers. */
7705 if (event
->ptid
== null_ptid
)
7707 /* If there is no thread-id information then leave
7708 the event->ptid as null_ptid. Later in
7709 process_stop_reply we will pick a suitable
7711 const char *thr
= strstr (p1
+ 1, ";thread:");
7713 event
->ptid
= read_ptid (thr
+ strlen (";thread:"),
7720 = (event
->ptid
== null_ptid
7722 : find_inferior_ptid (this, event
->ptid
));
7723 /* If this is the first time we learn anything
7724 about this process, skip the registers
7725 included in this packet, since we don't yet
7726 know which architecture to use to parse them.
7727 We'll determine the architecture later when
7728 we process the stop reply and retrieve the
7729 target description, via
7730 remote_notice_new_inferior ->
7731 post_create_inferior. */
7734 p
= strchrnul (p1
+ 1, ';');
7739 event
->arch
= inf
->gdbarch
;
7740 rsa
= event
->rs
->get_remote_arch_state (event
->arch
);
7744 = packet_reg_from_pnum (event
->arch
, rsa
, pnum
);
7745 cached_reg_t cached_reg
;
7748 error (_("Remote sent bad register number %s: %s\n\
7750 hex_string (pnum
), p
, buf
);
7752 cached_reg
.num
= reg
->regnum
;
7753 cached_reg
.data
= (gdb_byte
*)
7754 xmalloc (register_size (event
->arch
, reg
->regnum
));
7757 fieldsize
= hex2bin (p
, cached_reg
.data
,
7758 register_size (event
->arch
, reg
->regnum
));
7760 if (fieldsize
< register_size (event
->arch
, reg
->regnum
))
7761 warning (_("Remote reply is too short: %s"), buf
);
7763 event
->regcache
.push_back (cached_reg
);
7767 /* Not a number. Silently skip unknown optional
7769 p
= strchrnul (p1
+ 1, ';');
7774 error (_("Remote register badly formatted: %s\nhere: %s"),
7779 if (event
->ws
.kind () != TARGET_WAITKIND_IGNORE
)
7783 case 'S': /* Old style status, just signal only. */
7787 sig
= (fromhex (buf
[1]) << 4) + fromhex (buf
[2]);
7788 if (GDB_SIGNAL_FIRST
<= sig
&& sig
< GDB_SIGNAL_LAST
)
7789 event
->ws
.set_stopped ((enum gdb_signal
) sig
);
7791 event
->ws
.set_stopped (GDB_SIGNAL_UNKNOWN
);
7794 case 'w': /* Thread exited. */
7798 p
= unpack_varlen_hex (&buf
[1], &value
);
7799 event
->ws
.set_thread_exited (value
);
7801 error (_("stop reply packet badly formatted: %s"), buf
);
7802 event
->ptid
= read_ptid (++p
, NULL
);
7805 case 'W': /* Target exited. */
7810 /* GDB used to accept only 2 hex chars here. Stubs should
7811 only send more if they detect GDB supports multi-process
7813 p
= unpack_varlen_hex (&buf
[1], &value
);
7817 /* The remote process exited. */
7818 event
->ws
.set_exited (value
);
7822 /* The remote process exited with a signal. */
7823 if (GDB_SIGNAL_FIRST
<= value
&& value
< GDB_SIGNAL_LAST
)
7824 event
->ws
.set_signalled ((enum gdb_signal
) value
);
7826 event
->ws
.set_signalled (GDB_SIGNAL_UNKNOWN
);
7829 /* If no process is specified, return null_ptid, and let the
7830 caller figure out the right process to use. */
7840 else if (startswith (p
, "process:"))
7844 p
+= sizeof ("process:") - 1;
7845 unpack_varlen_hex (p
, &upid
);
7849 error (_("unknown stop reply packet: %s"), buf
);
7852 error (_("unknown stop reply packet: %s"), buf
);
7853 event
->ptid
= ptid_t (pid
);
7857 event
->ws
.set_no_resumed ();
7858 event
->ptid
= minus_one_ptid
;
7863 /* When the stub wants to tell GDB about a new notification reply, it
7864 sends a notification (%Stop, for example). Those can come it at
7865 any time, hence, we have to make sure that any pending
7866 putpkt/getpkt sequence we're making is finished, before querying
7867 the stub for more events with the corresponding ack command
7868 (vStopped, for example). E.g., if we started a vStopped sequence
7869 immediately upon receiving the notification, something like this
7877 1.6) <-- (registers reply to step #1.3)
7879 Obviously, the reply in step #1.6 would be unexpected to a vStopped
7882 To solve this, whenever we parse a %Stop notification successfully,
7883 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
7884 doing whatever we were doing:
7890 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
7891 2.5) <-- (registers reply to step #2.3)
7893 Eventually after step #2.5, we return to the event loop, which
7894 notices there's an event on the
7895 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
7896 associated callback --- the function below. At this point, we're
7897 always safe to start a vStopped sequence. :
7900 2.7) <-- T05 thread:2
7906 remote_target::remote_notif_get_pending_events (notif_client
*nc
)
7908 struct remote_state
*rs
= get_remote_state ();
7910 if (rs
->notif_state
->pending_event
[nc
->id
] != NULL
)
7913 fprintf_unfiltered (gdb_stdlog
,
7914 "notif: process: '%s' ack pending event\n",
7918 nc
->ack (this, nc
, rs
->buf
.data (),
7919 rs
->notif_state
->pending_event
[nc
->id
]);
7920 rs
->notif_state
->pending_event
[nc
->id
] = NULL
;
7924 getpkt (&rs
->buf
, 0);
7925 if (strcmp (rs
->buf
.data (), "OK") == 0)
7928 remote_notif_ack (this, nc
, rs
->buf
.data ());
7934 fprintf_unfiltered (gdb_stdlog
,
7935 "notif: process: '%s' no pending reply\n",
7940 /* Wrapper around remote_target::remote_notif_get_pending_events to
7941 avoid having to export the whole remote_target class. */
7944 remote_notif_get_pending_events (remote_target
*remote
, notif_client
*nc
)
7946 remote
->remote_notif_get_pending_events (nc
);
7949 /* Called from process_stop_reply when the stop packet we are responding
7950 to didn't include a process-id or thread-id. STATUS is the stop event
7951 we are responding to.
7953 It is the task of this function to select a suitable thread (or process)
7954 and return its ptid, this is the thread (or process) we will assume the
7955 stop event came from.
7957 In some cases there isn't really any choice about which thread (or
7958 process) is selected, a basic remote with a single process containing a
7959 single thread might choose not to send any process-id or thread-id in
7960 its stop packets, this function will select and return the one and only
7963 However, if a target supports multiple threads (or processes) and still
7964 doesn't include a thread-id (or process-id) in its stop packet then
7965 first, this is a badly behaving target, and second, we're going to have
7966 to select a thread (or process) at random and use that. This function
7967 will print a warning to the user if it detects that there is the
7968 possibility that GDB is guessing which thread (or process) to
7971 Note that this is called before GDB fetches the updated thread list from the
7972 target. So it's possible for the stop reply to be ambiguous and for GDB to
7973 not realize it. For example, if there's initially one thread, the target
7974 spawns a second thread, and then sends a stop reply without an id that
7975 concerns the first thread. GDB will assume the stop reply is about the
7976 first thread - the only thread it knows about - without printing a warning.
7977 Anyway, if the remote meant for the stop reply to be about the second thread,
7978 then it would be really broken, because GDB doesn't know about that thread
7982 remote_target::select_thread_for_ambiguous_stop_reply
7983 (const target_waitstatus
&status
)
7985 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7987 /* Some stop events apply to all threads in an inferior, while others
7988 only apply to a single thread. */
7989 bool process_wide_stop
7990 = (status
.kind () == TARGET_WAITKIND_EXITED
7991 || status
.kind () == TARGET_WAITKIND_SIGNALLED
);
7993 remote_debug_printf ("process_wide_stop = %d", process_wide_stop
);
7995 thread_info
*first_resumed_thread
= nullptr;
7996 bool ambiguous
= false;
7998 /* Consider all non-exited threads of the target, find the first resumed
8000 for (thread_info
*thr
: all_non_exited_threads (this))
8002 remote_thread_info
*remote_thr
= get_remote_thread_info (thr
);
8004 if (remote_thr
->get_resume_state () != resume_state::RESUMED
)
8007 if (first_resumed_thread
== nullptr)
8008 first_resumed_thread
= thr
;
8009 else if (!process_wide_stop
8010 || first_resumed_thread
->ptid
.pid () != thr
->ptid
.pid ())
8014 gdb_assert (first_resumed_thread
!= nullptr);
8016 remote_debug_printf ("first resumed thread is %s",
8017 pid_to_str (first_resumed_thread
->ptid
).c_str ());
8018 remote_debug_printf ("is this guess ambiguous? = %d", ambiguous
);
8020 /* Warn if the remote target is sending ambiguous stop replies. */
8023 static bool warned
= false;
8027 /* If you are seeing this warning then the remote target has
8028 stopped without specifying a thread-id, but the target
8029 does have multiple threads (or inferiors), and so GDB is
8030 having to guess which thread stopped.
8032 Examples of what might cause this are the target sending
8033 and 'S' stop packet, or a 'T' stop packet and not
8034 including a thread-id.
8036 Additionally, the target might send a 'W' or 'X packet
8037 without including a process-id, when the target has
8038 multiple running inferiors. */
8039 if (process_wide_stop
)
8040 warning (_("multi-inferior target stopped without "
8041 "sending a process-id, using first "
8042 "non-exited inferior"));
8044 warning (_("multi-threaded target stopped without "
8045 "sending a thread-id, using first "
8046 "non-exited thread"));
8051 /* If this is a stop for all threads then don't use a particular threads
8052 ptid, instead create a new ptid where only the pid field is set. */
8053 if (process_wide_stop
)
8054 return ptid_t (first_resumed_thread
->ptid
.pid ());
8056 return first_resumed_thread
->ptid
;
8059 /* Called when it is decided that STOP_REPLY holds the info of the
8060 event that is to be returned to the core. This function always
8061 destroys STOP_REPLY. */
8064 remote_target::process_stop_reply (struct stop_reply
*stop_reply
,
8065 struct target_waitstatus
*status
)
8067 *status
= stop_reply
->ws
;
8068 ptid_t ptid
= stop_reply
->ptid
;
8070 /* If no thread/process was reported by the stub then select a suitable
8072 if (ptid
== null_ptid
)
8073 ptid
= select_thread_for_ambiguous_stop_reply (*status
);
8074 gdb_assert (ptid
!= null_ptid
);
8076 if (status
->kind () != TARGET_WAITKIND_EXITED
8077 && status
->kind () != TARGET_WAITKIND_SIGNALLED
8078 && status
->kind () != TARGET_WAITKIND_NO_RESUMED
)
8080 /* Expedited registers. */
8081 if (!stop_reply
->regcache
.empty ())
8083 struct regcache
*regcache
8084 = get_thread_arch_regcache (this, ptid
, stop_reply
->arch
);
8086 for (cached_reg_t
®
: stop_reply
->regcache
)
8088 regcache
->raw_supply (reg
.num
, reg
.data
);
8092 stop_reply
->regcache
.clear ();
8095 remote_notice_new_inferior (ptid
, false);
8096 remote_thread_info
*remote_thr
= get_remote_thread_info (this, ptid
);
8097 remote_thr
->core
= stop_reply
->core
;
8098 remote_thr
->stop_reason
= stop_reply
->stop_reason
;
8099 remote_thr
->watch_data_address
= stop_reply
->watch_data_address
;
8101 if (target_is_non_stop_p ())
8103 /* If the target works in non-stop mode, a stop-reply indicates that
8104 only this thread stopped. */
8105 remote_thr
->set_not_resumed ();
8109 /* If the target works in all-stop mode, a stop-reply indicates that
8110 all the target's threads stopped. */
8111 for (thread_info
*tp
: all_non_exited_threads (this))
8112 get_remote_thread_info (tp
)->set_not_resumed ();
8120 /* The non-stop mode version of target_wait. */
8123 remote_target::wait_ns (ptid_t ptid
, struct target_waitstatus
*status
,
8124 target_wait_flags options
)
8126 struct remote_state
*rs
= get_remote_state ();
8127 struct stop_reply
*stop_reply
;
8131 /* If in non-stop mode, get out of getpkt even if a
8132 notification is received. */
8134 ret
= getpkt_or_notif_sane (&rs
->buf
, 0 /* forever */, &is_notif
);
8137 if (ret
!= -1 && !is_notif
)
8140 case 'E': /* Error of some sort. */
8141 /* We're out of sync with the target now. Did it continue
8142 or not? We can't tell which thread it was in non-stop,
8143 so just ignore this. */
8144 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
8146 case 'O': /* Console output. */
8147 remote_console_output (&rs
->buf
[1]);
8150 warning (_("Invalid remote reply: %s"), rs
->buf
.data ());
8154 /* Acknowledge a pending stop reply that may have arrived in the
8156 if (rs
->notif_state
->pending_event
[notif_client_stop
.id
] != NULL
)
8157 remote_notif_get_pending_events (¬if_client_stop
);
8159 /* If indeed we noticed a stop reply, we're done. */
8160 stop_reply
= queued_stop_reply (ptid
);
8161 if (stop_reply
!= NULL
)
8162 return process_stop_reply (stop_reply
, status
);
8164 /* Still no event. If we're just polling for an event, then
8165 return to the event loop. */
8166 if (options
& TARGET_WNOHANG
)
8168 status
->set_ignore ();
8169 return minus_one_ptid
;
8172 /* Otherwise do a blocking wait. */
8173 ret
= getpkt_or_notif_sane (&rs
->buf
, 1 /* forever */, &is_notif
);
8177 /* Return the first resumed thread. */
8180 first_remote_resumed_thread (remote_target
*target
)
8182 for (thread_info
*tp
: all_non_exited_threads (target
, minus_one_ptid
))
8188 /* Wait until the remote machine stops, then return, storing status in
8189 STATUS just as `wait' would. */
8192 remote_target::wait_as (ptid_t ptid
, target_waitstatus
*status
,
8193 target_wait_flags options
)
8195 struct remote_state
*rs
= get_remote_state ();
8196 ptid_t event_ptid
= null_ptid
;
8198 struct stop_reply
*stop_reply
;
8202 status
->set_ignore ();
8204 stop_reply
= queued_stop_reply (ptid
);
8205 if (stop_reply
!= NULL
)
8207 /* None of the paths that push a stop reply onto the queue should
8208 have set the waiting_for_stop_reply flag. */
8209 gdb_assert (!rs
->waiting_for_stop_reply
);
8210 event_ptid
= process_stop_reply (stop_reply
, status
);
8214 int forever
= ((options
& TARGET_WNOHANG
) == 0
8215 && rs
->wait_forever_enabled_p
);
8217 if (!rs
->waiting_for_stop_reply
)
8219 status
->set_no_resumed ();
8220 return minus_one_ptid
;
8223 /* FIXME: cagney/1999-09-27: If we're in async mode we should
8224 _never_ wait for ever -> test on target_is_async_p().
8225 However, before we do that we need to ensure that the caller
8226 knows how to take the target into/out of async mode. */
8228 int ret
= getpkt_or_notif_sane (&rs
->buf
, forever
, &is_notif
);
8230 /* GDB gets a notification. Return to core as this event is
8232 if (ret
!= -1 && is_notif
)
8233 return minus_one_ptid
;
8235 if (ret
== -1 && (options
& TARGET_WNOHANG
) != 0)
8236 return minus_one_ptid
;
8238 buf
= rs
->buf
.data ();
8240 /* Assume that the target has acknowledged Ctrl-C unless we receive
8241 an 'F' or 'O' packet. */
8242 if (buf
[0] != 'F' && buf
[0] != 'O')
8243 rs
->ctrlc_pending_p
= 0;
8247 case 'E': /* Error of some sort. */
8248 /* We're out of sync with the target now. Did it continue or
8249 not? Not is more likely, so report a stop. */
8250 rs
->waiting_for_stop_reply
= 0;
8252 warning (_("Remote failure reply: %s"), buf
);
8253 status
->set_stopped (GDB_SIGNAL_0
);
8255 case 'F': /* File-I/O request. */
8256 /* GDB may access the inferior memory while handling the File-I/O
8257 request, but we don't want GDB accessing memory while waiting
8258 for a stop reply. See the comments in putpkt_binary. Set
8259 waiting_for_stop_reply to 0 temporarily. */
8260 rs
->waiting_for_stop_reply
= 0;
8261 remote_fileio_request (this, buf
, rs
->ctrlc_pending_p
);
8262 rs
->ctrlc_pending_p
= 0;
8263 /* GDB handled the File-I/O request, and the target is running
8264 again. Keep waiting for events. */
8265 rs
->waiting_for_stop_reply
= 1;
8267 case 'N': case 'T': case 'S': case 'X': case 'W':
8269 /* There is a stop reply to handle. */
8270 rs
->waiting_for_stop_reply
= 0;
8273 = (struct stop_reply
*) remote_notif_parse (this,
8277 event_ptid
= process_stop_reply (stop_reply
, status
);
8280 case 'O': /* Console output. */
8281 remote_console_output (buf
+ 1);
8284 if (rs
->last_sent_signal
!= GDB_SIGNAL_0
)
8286 /* Zero length reply means that we tried 'S' or 'C' and the
8287 remote system doesn't support it. */
8288 target_terminal::ours_for_output ();
8290 ("Can't send signals to this remote system. %s not sent.\n",
8291 gdb_signal_to_name (rs
->last_sent_signal
));
8292 rs
->last_sent_signal
= GDB_SIGNAL_0
;
8293 target_terminal::inferior ();
8295 strcpy (buf
, rs
->last_sent_step
? "s" : "c");
8301 warning (_("Invalid remote reply: %s"), buf
);
8306 if (status
->kind () == TARGET_WAITKIND_NO_RESUMED
)
8307 return minus_one_ptid
;
8308 else if (status
->kind () == TARGET_WAITKIND_IGNORE
)
8310 /* Nothing interesting happened. If we're doing a non-blocking
8311 poll, we're done. Otherwise, go back to waiting. */
8312 if (options
& TARGET_WNOHANG
)
8313 return minus_one_ptid
;
8317 else if (status
->kind () != TARGET_WAITKIND_EXITED
8318 && status
->kind () != TARGET_WAITKIND_SIGNALLED
)
8320 if (event_ptid
!= null_ptid
)
8321 record_currthread (rs
, event_ptid
);
8323 event_ptid
= first_remote_resumed_thread (this);
8327 /* A process exit. Invalidate our notion of current thread. */
8328 record_currthread (rs
, minus_one_ptid
);
8329 /* It's possible that the packet did not include a pid. */
8330 if (event_ptid
== null_ptid
)
8331 event_ptid
= first_remote_resumed_thread (this);
8332 /* EVENT_PTID could still be NULL_PTID. Double-check. */
8333 if (event_ptid
== null_ptid
)
8334 event_ptid
= magic_null_ptid
;
8340 /* Wait until the remote machine stops, then return, storing status in
8341 STATUS just as `wait' would. */
8344 remote_target::wait (ptid_t ptid
, struct target_waitstatus
*status
,
8345 target_wait_flags options
)
8347 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
8349 remote_state
*rs
= get_remote_state ();
8351 /* Start by clearing the flag that asks for our wait method to be called,
8352 we'll mark it again at the end if needed. If the target is not in
8353 async mode then the async token should not be marked. */
8354 if (target_is_async_p ())
8355 clear_async_event_handler (rs
->remote_async_inferior_event_token
);
8357 gdb_assert (!async_event_handler_marked
8358 (rs
->remote_async_inferior_event_token
));
8362 if (target_is_non_stop_p ())
8363 event_ptid
= wait_ns (ptid
, status
, options
);
8365 event_ptid
= wait_as (ptid
, status
, options
);
8367 if (target_is_async_p ())
8369 /* If there are events left in the queue, or unacknowledged
8370 notifications, then tell the event loop to call us again. */
8371 if (!rs
->stop_reply_queue
.empty ()
8372 || rs
->notif_state
->pending_event
[notif_client_stop
.id
] != nullptr)
8373 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
8379 /* Fetch a single register using a 'p' packet. */
8382 remote_target::fetch_register_using_p (struct regcache
*regcache
,
8385 struct gdbarch
*gdbarch
= regcache
->arch ();
8386 struct remote_state
*rs
= get_remote_state ();
8388 gdb_byte
*regp
= (gdb_byte
*) alloca (register_size (gdbarch
, reg
->regnum
));
8391 if (packet_support (PACKET_p
) == PACKET_DISABLE
)
8394 if (reg
->pnum
== -1)
8397 p
= rs
->buf
.data ();
8399 p
+= hexnumstr (p
, reg
->pnum
);
8402 getpkt (&rs
->buf
, 0);
8404 buf
= rs
->buf
.data ();
8406 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_p
]))
8410 case PACKET_UNKNOWN
:
8413 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
8414 gdbarch_register_name (regcache
->arch (),
8419 /* If this register is unfetchable, tell the regcache. */
8422 regcache
->raw_supply (reg
->regnum
, NULL
);
8426 /* Otherwise, parse and supply the value. */
8432 error (_("fetch_register_using_p: early buf termination"));
8434 regp
[i
++] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
8437 regcache
->raw_supply (reg
->regnum
, regp
);
8441 /* Fetch the registers included in the target's 'g' packet. */
8444 remote_target::send_g_packet ()
8446 struct remote_state
*rs
= get_remote_state ();
8449 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "g");
8451 getpkt (&rs
->buf
, 0);
8452 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
8453 error (_("Could not read registers; remote failure reply '%s'"),
8456 /* We can get out of synch in various cases. If the first character
8457 in the buffer is not a hex character, assume that has happened
8458 and try to fetch another packet to read. */
8459 while ((rs
->buf
[0] < '0' || rs
->buf
[0] > '9')
8460 && (rs
->buf
[0] < 'A' || rs
->buf
[0] > 'F')
8461 && (rs
->buf
[0] < 'a' || rs
->buf
[0] > 'f')
8462 && rs
->buf
[0] != 'x') /* New: unavailable register value. */
8464 remote_debug_printf ("Bad register packet; fetching a new packet");
8465 getpkt (&rs
->buf
, 0);
8468 buf_len
= strlen (rs
->buf
.data ());
8470 /* Sanity check the received packet. */
8471 if (buf_len
% 2 != 0)
8472 error (_("Remote 'g' packet reply is of odd length: %s"), rs
->buf
.data ());
8478 remote_target::process_g_packet (struct regcache
*regcache
)
8480 struct gdbarch
*gdbarch
= regcache
->arch ();
8481 struct remote_state
*rs
= get_remote_state ();
8482 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8487 buf_len
= strlen (rs
->buf
.data ());
8489 /* Further sanity checks, with knowledge of the architecture. */
8490 if (buf_len
> 2 * rsa
->sizeof_g_packet
)
8491 error (_("Remote 'g' packet reply is too long (expected %ld bytes, got %d "
8493 rsa
->sizeof_g_packet
, buf_len
/ 2,
8496 /* Save the size of the packet sent to us by the target. It is used
8497 as a heuristic when determining the max size of packets that the
8498 target can safely receive. */
8499 if (rsa
->actual_register_packet_size
== 0)
8500 rsa
->actual_register_packet_size
= buf_len
;
8502 /* If this is smaller than we guessed the 'g' packet would be,
8503 update our records. A 'g' reply that doesn't include a register's
8504 value implies either that the register is not available, or that
8505 the 'p' packet must be used. */
8506 if (buf_len
< 2 * rsa
->sizeof_g_packet
)
8508 long sizeof_g_packet
= buf_len
/ 2;
8510 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8512 long offset
= rsa
->regs
[i
].offset
;
8513 long reg_size
= register_size (gdbarch
, i
);
8515 if (rsa
->regs
[i
].pnum
== -1)
8518 if (offset
>= sizeof_g_packet
)
8519 rsa
->regs
[i
].in_g_packet
= 0;
8520 else if (offset
+ reg_size
> sizeof_g_packet
)
8521 error (_("Truncated register %d in remote 'g' packet"), i
);
8523 rsa
->regs
[i
].in_g_packet
= 1;
8526 /* Looks valid enough, we can assume this is the correct length
8527 for a 'g' packet. It's important not to adjust
8528 rsa->sizeof_g_packet if we have truncated registers otherwise
8529 this "if" won't be run the next time the method is called
8530 with a packet of the same size and one of the internal errors
8531 below will trigger instead. */
8532 rsa
->sizeof_g_packet
= sizeof_g_packet
;
8535 regs
= (char *) alloca (rsa
->sizeof_g_packet
);
8537 /* Unimplemented registers read as all bits zero. */
8538 memset (regs
, 0, rsa
->sizeof_g_packet
);
8540 /* Reply describes registers byte by byte, each byte encoded as two
8541 hex characters. Suck them all up, then supply them to the
8542 register cacheing/storage mechanism. */
8544 p
= rs
->buf
.data ();
8545 for (i
= 0; i
< rsa
->sizeof_g_packet
; i
++)
8547 if (p
[0] == 0 || p
[1] == 0)
8548 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
8549 internal_error (__FILE__
, __LINE__
,
8550 _("unexpected end of 'g' packet reply"));
8552 if (p
[0] == 'x' && p
[1] == 'x')
8553 regs
[i
] = 0; /* 'x' */
8555 regs
[i
] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
8559 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8561 struct packet_reg
*r
= &rsa
->regs
[i
];
8562 long reg_size
= register_size (gdbarch
, i
);
8566 if ((r
->offset
+ reg_size
) * 2 > strlen (rs
->buf
.data ()))
8567 /* This shouldn't happen - we adjusted in_g_packet above. */
8568 internal_error (__FILE__
, __LINE__
,
8569 _("unexpected end of 'g' packet reply"));
8570 else if (rs
->buf
[r
->offset
* 2] == 'x')
8572 gdb_assert (r
->offset
* 2 < strlen (rs
->buf
.data ()));
8573 /* The register isn't available, mark it as such (at
8574 the same time setting the value to zero). */
8575 regcache
->raw_supply (r
->regnum
, NULL
);
8578 regcache
->raw_supply (r
->regnum
, regs
+ r
->offset
);
8584 remote_target::fetch_registers_using_g (struct regcache
*regcache
)
8587 process_g_packet (regcache
);
8590 /* Make the remote selected traceframe match GDB's selected
8594 remote_target::set_remote_traceframe ()
8597 struct remote_state
*rs
= get_remote_state ();
8599 if (rs
->remote_traceframe_number
== get_traceframe_number ())
8602 /* Avoid recursion, remote_trace_find calls us again. */
8603 rs
->remote_traceframe_number
= get_traceframe_number ();
8605 newnum
= target_trace_find (tfind_number
,
8606 get_traceframe_number (), 0, 0, NULL
);
8608 /* Should not happen. If it does, all bets are off. */
8609 if (newnum
!= get_traceframe_number ())
8610 warning (_("could not set remote traceframe"));
8614 remote_target::fetch_registers (struct regcache
*regcache
, int regnum
)
8616 struct gdbarch
*gdbarch
= regcache
->arch ();
8617 struct remote_state
*rs
= get_remote_state ();
8618 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8621 set_remote_traceframe ();
8622 set_general_thread (regcache
->ptid ());
8626 packet_reg
*reg
= packet_reg_from_regnum (gdbarch
, rsa
, regnum
);
8628 gdb_assert (reg
!= NULL
);
8630 /* If this register might be in the 'g' packet, try that first -
8631 we are likely to read more than one register. If this is the
8632 first 'g' packet, we might be overly optimistic about its
8633 contents, so fall back to 'p'. */
8634 if (reg
->in_g_packet
)
8636 fetch_registers_using_g (regcache
);
8637 if (reg
->in_g_packet
)
8641 if (fetch_register_using_p (regcache
, reg
))
8644 /* This register is not available. */
8645 regcache
->raw_supply (reg
->regnum
, NULL
);
8650 fetch_registers_using_g (regcache
);
8652 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8653 if (!rsa
->regs
[i
].in_g_packet
)
8654 if (!fetch_register_using_p (regcache
, &rsa
->regs
[i
]))
8656 /* This register is not available. */
8657 regcache
->raw_supply (i
, NULL
);
8661 /* Prepare to store registers. Since we may send them all (using a
8662 'G' request), we have to read out the ones we don't want to change
8666 remote_target::prepare_to_store (struct regcache
*regcache
)
8668 struct remote_state
*rs
= get_remote_state ();
8669 remote_arch_state
*rsa
= rs
->get_remote_arch_state (regcache
->arch ());
8672 /* Make sure the entire registers array is valid. */
8673 switch (packet_support (PACKET_P
))
8675 case PACKET_DISABLE
:
8676 case PACKET_SUPPORT_UNKNOWN
:
8677 /* Make sure all the necessary registers are cached. */
8678 for (i
= 0; i
< gdbarch_num_regs (regcache
->arch ()); i
++)
8679 if (rsa
->regs
[i
].in_g_packet
)
8680 regcache
->raw_update (rsa
->regs
[i
].regnum
);
8687 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
8688 packet was not recognized. */
8691 remote_target::store_register_using_P (const struct regcache
*regcache
,
8694 struct gdbarch
*gdbarch
= regcache
->arch ();
8695 struct remote_state
*rs
= get_remote_state ();
8696 /* Try storing a single register. */
8697 char *buf
= rs
->buf
.data ();
8698 gdb_byte
*regp
= (gdb_byte
*) alloca (register_size (gdbarch
, reg
->regnum
));
8701 if (packet_support (PACKET_P
) == PACKET_DISABLE
)
8704 if (reg
->pnum
== -1)
8707 xsnprintf (buf
, get_remote_packet_size (), "P%s=", phex_nz (reg
->pnum
, 0));
8708 p
= buf
+ strlen (buf
);
8709 regcache
->raw_collect (reg
->regnum
, regp
);
8710 bin2hex (regp
, p
, register_size (gdbarch
, reg
->regnum
));
8712 getpkt (&rs
->buf
, 0);
8714 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_P
]))
8719 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
8720 gdbarch_register_name (gdbarch
, reg
->regnum
), rs
->buf
.data ());
8721 case PACKET_UNKNOWN
:
8724 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
8728 /* Store register REGNUM, or all registers if REGNUM == -1, from the
8729 contents of the register cache buffer. FIXME: ignores errors. */
8732 remote_target::store_registers_using_G (const struct regcache
*regcache
)
8734 struct remote_state
*rs
= get_remote_state ();
8735 remote_arch_state
*rsa
= rs
->get_remote_arch_state (regcache
->arch ());
8739 /* Extract all the registers in the regcache copying them into a
8744 regs
= (gdb_byte
*) alloca (rsa
->sizeof_g_packet
);
8745 memset (regs
, 0, rsa
->sizeof_g_packet
);
8746 for (i
= 0; i
< gdbarch_num_regs (regcache
->arch ()); i
++)
8748 struct packet_reg
*r
= &rsa
->regs
[i
];
8751 regcache
->raw_collect (r
->regnum
, regs
+ r
->offset
);
8755 /* Command describes registers byte by byte,
8756 each byte encoded as two hex characters. */
8757 p
= rs
->buf
.data ();
8759 bin2hex (regs
, p
, rsa
->sizeof_g_packet
);
8761 getpkt (&rs
->buf
, 0);
8762 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
8763 error (_("Could not write registers; remote failure reply '%s'"),
8767 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
8768 of the register cache buffer. FIXME: ignores errors. */
8771 remote_target::store_registers (struct regcache
*regcache
, int regnum
)
8773 struct gdbarch
*gdbarch
= regcache
->arch ();
8774 struct remote_state
*rs
= get_remote_state ();
8775 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8778 set_remote_traceframe ();
8779 set_general_thread (regcache
->ptid ());
8783 packet_reg
*reg
= packet_reg_from_regnum (gdbarch
, rsa
, regnum
);
8785 gdb_assert (reg
!= NULL
);
8787 /* Always prefer to store registers using the 'P' packet if
8788 possible; we often change only a small number of registers.
8789 Sometimes we change a larger number; we'd need help from a
8790 higher layer to know to use 'G'. */
8791 if (store_register_using_P (regcache
, reg
))
8794 /* For now, don't complain if we have no way to write the
8795 register. GDB loses track of unavailable registers too
8796 easily. Some day, this may be an error. We don't have
8797 any way to read the register, either... */
8798 if (!reg
->in_g_packet
)
8801 store_registers_using_G (regcache
);
8805 store_registers_using_G (regcache
);
8807 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8808 if (!rsa
->regs
[i
].in_g_packet
)
8809 if (!store_register_using_P (regcache
, &rsa
->regs
[i
]))
8810 /* See above for why we do not issue an error here. */
8815 /* Return the number of hex digits in num. */
8818 hexnumlen (ULONGEST num
)
8822 for (i
= 0; num
!= 0; i
++)
8825 return std::max (i
, 1);
8828 /* Set BUF to the minimum number of hex digits representing NUM. */
8831 hexnumstr (char *buf
, ULONGEST num
)
8833 int len
= hexnumlen (num
);
8835 return hexnumnstr (buf
, num
, len
);
8839 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
8842 hexnumnstr (char *buf
, ULONGEST num
, int width
)
8848 for (i
= width
- 1; i
>= 0; i
--)
8850 buf
[i
] = "0123456789abcdef"[(num
& 0xf)];
8857 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
8860 remote_address_masked (CORE_ADDR addr
)
8862 unsigned int address_size
= remote_address_size
;
8864 /* If "remoteaddresssize" was not set, default to target address size. */
8866 address_size
= gdbarch_addr_bit (target_gdbarch ());
8868 if (address_size
> 0
8869 && address_size
< (sizeof (ULONGEST
) * 8))
8871 /* Only create a mask when that mask can safely be constructed
8872 in a ULONGEST variable. */
8875 mask
= (mask
<< address_size
) - 1;
8881 /* Determine whether the remote target supports binary downloading.
8882 This is accomplished by sending a no-op memory write of zero length
8883 to the target at the specified address. It does not suffice to send
8884 the whole packet, since many stubs strip the eighth bit and
8885 subsequently compute a wrong checksum, which causes real havoc with
8888 NOTE: This can still lose if the serial line is not eight-bit
8889 clean. In cases like this, the user should clear "remote
8893 remote_target::check_binary_download (CORE_ADDR addr
)
8895 struct remote_state
*rs
= get_remote_state ();
8897 switch (packet_support (PACKET_X
))
8899 case PACKET_DISABLE
:
8903 case PACKET_SUPPORT_UNKNOWN
:
8907 p
= rs
->buf
.data ();
8909 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8911 p
+= hexnumstr (p
, (ULONGEST
) 0);
8915 putpkt_binary (rs
->buf
.data (), (int) (p
- rs
->buf
.data ()));
8916 getpkt (&rs
->buf
, 0);
8918 if (rs
->buf
[0] == '\0')
8920 remote_debug_printf ("binary downloading NOT supported by target");
8921 remote_protocol_packets
[PACKET_X
].support
= PACKET_DISABLE
;
8925 remote_debug_printf ("binary downloading supported by target");
8926 remote_protocol_packets
[PACKET_X
].support
= PACKET_ENABLE
;
8933 /* Helper function to resize the payload in order to try to get a good
8934 alignment. We try to write an amount of data such that the next write will
8935 start on an address aligned on REMOTE_ALIGN_WRITES. */
8938 align_for_efficient_write (int todo
, CORE_ADDR memaddr
)
8940 return ((memaddr
+ todo
) & ~(REMOTE_ALIGN_WRITES
- 1)) - memaddr
;
8943 /* Write memory data directly to the remote machine.
8944 This does not inform the data cache; the data cache uses this.
8945 HEADER is the starting part of the packet.
8946 MEMADDR is the address in the remote memory space.
8947 MYADDR is the address of the buffer in our space.
8948 LEN_UNITS is the number of addressable units to write.
8949 UNIT_SIZE is the length in bytes of an addressable unit.
8950 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
8951 should send data as binary ('X'), or hex-encoded ('M').
8953 The function creates packet of the form
8954 <HEADER><ADDRESS>,<LENGTH>:<DATA>
8956 where encoding of <DATA> is terminated by PACKET_FORMAT.
8958 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
8961 Return the transferred status, error or OK (an
8962 'enum target_xfer_status' value). Save the number of addressable units
8963 transferred in *XFERED_LEN_UNITS. Only transfer a single packet.
8965 On a platform with an addressable memory size of 2 bytes (UNIT_SIZE == 2), an
8966 exchange between gdb and the stub could look like (?? in place of the
8972 -> $M1000,3:eeeeffffeeee#??
8976 <- eeeeffffeeeedddd */
8979 remote_target::remote_write_bytes_aux (const char *header
, CORE_ADDR memaddr
,
8980 const gdb_byte
*myaddr
,
8983 ULONGEST
*xfered_len_units
,
8984 char packet_format
, int use_length
)
8986 struct remote_state
*rs
= get_remote_state ();
8992 int payload_capacity_bytes
;
8993 int payload_length_bytes
;
8995 if (packet_format
!= 'X' && packet_format
!= 'M')
8996 internal_error (__FILE__
, __LINE__
,
8997 _("remote_write_bytes_aux: bad packet format"));
9000 return TARGET_XFER_EOF
;
9002 payload_capacity_bytes
= get_memory_write_packet_size ();
9004 /* The packet buffer will be large enough for the payload;
9005 get_memory_packet_size ensures this. */
9008 /* Compute the size of the actual payload by subtracting out the
9009 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
9011 payload_capacity_bytes
-= strlen ("$,:#NN");
9013 /* The comma won't be used. */
9014 payload_capacity_bytes
+= 1;
9015 payload_capacity_bytes
-= strlen (header
);
9016 payload_capacity_bytes
-= hexnumlen (memaddr
);
9018 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
9020 strcat (rs
->buf
.data (), header
);
9021 p
= rs
->buf
.data () + strlen (header
);
9023 /* Compute a best guess of the number of bytes actually transfered. */
9024 if (packet_format
== 'X')
9026 /* Best guess at number of bytes that will fit. */
9027 todo_units
= std::min (len_units
,
9028 (ULONGEST
) payload_capacity_bytes
/ unit_size
);
9030 payload_capacity_bytes
-= hexnumlen (todo_units
);
9031 todo_units
= std::min (todo_units
, payload_capacity_bytes
/ unit_size
);
9035 /* Number of bytes that will fit. */
9037 = std::min (len_units
,
9038 (ULONGEST
) (payload_capacity_bytes
/ unit_size
) / 2);
9040 payload_capacity_bytes
-= hexnumlen (todo_units
);
9041 todo_units
= std::min (todo_units
,
9042 (payload_capacity_bytes
/ unit_size
) / 2);
9045 if (todo_units
<= 0)
9046 internal_error (__FILE__
, __LINE__
,
9047 _("minimum packet size too small to write data"));
9049 /* If we already need another packet, then try to align the end
9050 of this packet to a useful boundary. */
9051 if (todo_units
> 2 * REMOTE_ALIGN_WRITES
&& todo_units
< len_units
)
9052 todo_units
= align_for_efficient_write (todo_units
, memaddr
);
9054 /* Append "<memaddr>". */
9055 memaddr
= remote_address_masked (memaddr
);
9056 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
9063 /* Append the length and retain its location and size. It may need to be
9064 adjusted once the packet body has been created. */
9066 plenlen
= hexnumstr (p
, (ULONGEST
) todo_units
);
9074 /* Append the packet body. */
9075 if (packet_format
== 'X')
9077 /* Binary mode. Send target system values byte by byte, in
9078 increasing byte addresses. Only escape certain critical
9080 payload_length_bytes
=
9081 remote_escape_output (myaddr
, todo_units
, unit_size
, (gdb_byte
*) p
,
9082 &units_written
, payload_capacity_bytes
);
9084 /* If not all TODO units fit, then we'll need another packet. Make
9085 a second try to keep the end of the packet aligned. Don't do
9086 this if the packet is tiny. */
9087 if (units_written
< todo_units
&& units_written
> 2 * REMOTE_ALIGN_WRITES
)
9091 new_todo_units
= align_for_efficient_write (units_written
, memaddr
);
9093 if (new_todo_units
!= units_written
)
9094 payload_length_bytes
=
9095 remote_escape_output (myaddr
, new_todo_units
, unit_size
,
9096 (gdb_byte
*) p
, &units_written
,
9097 payload_capacity_bytes
);
9100 p
+= payload_length_bytes
;
9101 if (use_length
&& units_written
< todo_units
)
9103 /* Escape chars have filled up the buffer prematurely,
9104 and we have actually sent fewer units than planned.
9105 Fix-up the length field of the packet. Use the same
9106 number of characters as before. */
9107 plen
+= hexnumnstr (plen
, (ULONGEST
) units_written
,
9109 *plen
= ':'; /* overwrite \0 from hexnumnstr() */
9114 /* Normal mode: Send target system values byte by byte, in
9115 increasing byte addresses. Each byte is encoded as a two hex
9117 p
+= 2 * bin2hex (myaddr
, p
, todo_units
* unit_size
);
9118 units_written
= todo_units
;
9121 putpkt_binary (rs
->buf
.data (), (int) (p
- rs
->buf
.data ()));
9122 getpkt (&rs
->buf
, 0);
9124 if (rs
->buf
[0] == 'E')
9125 return TARGET_XFER_E_IO
;
9127 /* Return UNITS_WRITTEN, not TODO_UNITS, in case escape chars caused us to
9128 send fewer units than we'd planned. */
9129 *xfered_len_units
= (ULONGEST
) units_written
;
9130 return (*xfered_len_units
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
9133 /* Write memory data directly to the remote machine.
9134 This does not inform the data cache; the data cache uses this.
9135 MEMADDR is the address in the remote memory space.
9136 MYADDR is the address of the buffer in our space.
9137 LEN is the number of bytes.
9139 Return the transferred status, error or OK (an
9140 'enum target_xfer_status' value). Save the number of bytes
9141 transferred in *XFERED_LEN. Only transfer a single packet. */
9144 remote_target::remote_write_bytes (CORE_ADDR memaddr
, const gdb_byte
*myaddr
,
9145 ULONGEST len
, int unit_size
,
9146 ULONGEST
*xfered_len
)
9148 const char *packet_format
= NULL
;
9150 /* Check whether the target supports binary download. */
9151 check_binary_download (memaddr
);
9153 switch (packet_support (PACKET_X
))
9156 packet_format
= "X";
9158 case PACKET_DISABLE
:
9159 packet_format
= "M";
9161 case PACKET_SUPPORT_UNKNOWN
:
9162 internal_error (__FILE__
, __LINE__
,
9163 _("remote_write_bytes: bad internal state"));
9165 internal_error (__FILE__
, __LINE__
, _("bad switch"));
9168 return remote_write_bytes_aux (packet_format
,
9169 memaddr
, myaddr
, len
, unit_size
, xfered_len
,
9170 packet_format
[0], 1);
9173 /* Read memory data directly from the remote machine.
9174 This does not use the data cache; the data cache uses this.
9175 MEMADDR is the address in the remote memory space.
9176 MYADDR is the address of the buffer in our space.
9177 LEN_UNITS is the number of addressable memory units to read..
9178 UNIT_SIZE is the length in bytes of an addressable unit.
9180 Return the transferred status, error or OK (an
9181 'enum target_xfer_status' value). Save the number of bytes
9182 transferred in *XFERED_LEN_UNITS.
9184 See the comment of remote_write_bytes_aux for an example of
9185 memory read/write exchange between gdb and the stub. */
9188 remote_target::remote_read_bytes_1 (CORE_ADDR memaddr
, gdb_byte
*myaddr
,
9190 int unit_size
, ULONGEST
*xfered_len_units
)
9192 struct remote_state
*rs
= get_remote_state ();
9193 int buf_size_bytes
; /* Max size of packet output buffer. */
9198 buf_size_bytes
= get_memory_read_packet_size ();
9199 /* The packet buffer will be large enough for the payload;
9200 get_memory_packet_size ensures this. */
9202 /* Number of units that will fit. */
9203 todo_units
= std::min (len_units
,
9204 (ULONGEST
) (buf_size_bytes
/ unit_size
) / 2);
9206 /* Construct "m"<memaddr>","<len>". */
9207 memaddr
= remote_address_masked (memaddr
);
9208 p
= rs
->buf
.data ();
9210 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
9212 p
+= hexnumstr (p
, (ULONGEST
) todo_units
);
9215 getpkt (&rs
->buf
, 0);
9216 if (rs
->buf
[0] == 'E'
9217 && isxdigit (rs
->buf
[1]) && isxdigit (rs
->buf
[2])
9218 && rs
->buf
[3] == '\0')
9219 return TARGET_XFER_E_IO
;
9220 /* Reply describes memory byte by byte, each byte encoded as two hex
9222 p
= rs
->buf
.data ();
9223 decoded_bytes
= hex2bin (p
, myaddr
, todo_units
* unit_size
);
9224 /* Return what we have. Let higher layers handle partial reads. */
9225 *xfered_len_units
= (ULONGEST
) (decoded_bytes
/ unit_size
);
9226 return (*xfered_len_units
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
9229 /* Using the set of read-only target sections of remote, read live
9232 For interface/parameters/return description see target.h,
9236 remote_target::remote_xfer_live_readonly_partial (gdb_byte
*readbuf
,
9240 ULONGEST
*xfered_len
)
9242 const struct target_section
*secp
;
9244 secp
= target_section_by_addr (this, memaddr
);
9246 && (bfd_section_flags (secp
->the_bfd_section
) & SEC_READONLY
))
9248 ULONGEST memend
= memaddr
+ len
;
9250 const target_section_table
*table
= target_get_section_table (this);
9251 for (const target_section
&p
: *table
)
9253 if (memaddr
>= p
.addr
)
9255 if (memend
<= p
.endaddr
)
9257 /* Entire transfer is within this section. */
9258 return remote_read_bytes_1 (memaddr
, readbuf
, len
, unit_size
,
9261 else if (memaddr
>= p
.endaddr
)
9263 /* This section ends before the transfer starts. */
9268 /* This section overlaps the transfer. Just do half. */
9269 len
= p
.endaddr
- memaddr
;
9270 return remote_read_bytes_1 (memaddr
, readbuf
, len
, unit_size
,
9277 return TARGET_XFER_EOF
;
9280 /* Similar to remote_read_bytes_1, but it reads from the remote stub
9281 first if the requested memory is unavailable in traceframe.
9282 Otherwise, fall back to remote_read_bytes_1. */
9285 remote_target::remote_read_bytes (CORE_ADDR memaddr
,
9286 gdb_byte
*myaddr
, ULONGEST len
, int unit_size
,
9287 ULONGEST
*xfered_len
)
9290 return TARGET_XFER_EOF
;
9292 if (get_traceframe_number () != -1)
9294 std::vector
<mem_range
> available
;
9296 /* If we fail to get the set of available memory, then the
9297 target does not support querying traceframe info, and so we
9298 attempt reading from the traceframe anyway (assuming the
9299 target implements the old QTro packet then). */
9300 if (traceframe_available_memory (&available
, memaddr
, len
))
9302 if (available
.empty () || available
[0].start
!= memaddr
)
9304 enum target_xfer_status res
;
9306 /* Don't read into the traceframe's available
9308 if (!available
.empty ())
9310 LONGEST oldlen
= len
;
9312 len
= available
[0].start
- memaddr
;
9313 gdb_assert (len
<= oldlen
);
9316 /* This goes through the topmost target again. */
9317 res
= remote_xfer_live_readonly_partial (myaddr
, memaddr
,
9318 len
, unit_size
, xfered_len
);
9319 if (res
== TARGET_XFER_OK
)
9320 return TARGET_XFER_OK
;
9323 /* No use trying further, we know some memory starting
9324 at MEMADDR isn't available. */
9326 return (*xfered_len
!= 0) ?
9327 TARGET_XFER_UNAVAILABLE
: TARGET_XFER_EOF
;
9331 /* Don't try to read more than how much is available, in
9332 case the target implements the deprecated QTro packet to
9333 cater for older GDBs (the target's knowledge of read-only
9334 sections may be outdated by now). */
9335 len
= available
[0].length
;
9339 return remote_read_bytes_1 (memaddr
, myaddr
, len
, unit_size
, xfered_len
);
9344 /* Sends a packet with content determined by the printf format string
9345 FORMAT and the remaining arguments, then gets the reply. Returns
9346 whether the packet was a success, a failure, or unknown. */
9349 remote_target::remote_send_printf (const char *format
, ...)
9351 struct remote_state
*rs
= get_remote_state ();
9352 int max_size
= get_remote_packet_size ();
9355 va_start (ap
, format
);
9358 int size
= vsnprintf (rs
->buf
.data (), max_size
, format
, ap
);
9362 if (size
>= max_size
)
9363 internal_error (__FILE__
, __LINE__
, _("Too long remote packet."));
9365 if (putpkt (rs
->buf
) < 0)
9366 error (_("Communication problem with target."));
9369 getpkt (&rs
->buf
, 0);
9371 return packet_check_result (rs
->buf
);
9374 /* Flash writing can take quite some time. We'll set
9375 effectively infinite timeout for flash operations.
9376 In future, we'll need to decide on a better approach. */
9377 static const int remote_flash_timeout
= 1000;
9380 remote_target::flash_erase (ULONGEST address
, LONGEST length
)
9382 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
9383 enum packet_result ret
;
9384 scoped_restore restore_timeout
9385 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9387 ret
= remote_send_printf ("vFlashErase:%s,%s",
9388 phex (address
, addr_size
),
9392 case PACKET_UNKNOWN
:
9393 error (_("Remote target does not support flash erase"));
9395 error (_("Error erasing flash with vFlashErase packet"));
9402 remote_target::remote_flash_write (ULONGEST address
,
9403 ULONGEST length
, ULONGEST
*xfered_len
,
9404 const gdb_byte
*data
)
9406 scoped_restore restore_timeout
9407 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9408 return remote_write_bytes_aux ("vFlashWrite:", address
, data
, length
, 1,
9413 remote_target::flash_done ()
9417 scoped_restore restore_timeout
9418 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9420 ret
= remote_send_printf ("vFlashDone");
9424 case PACKET_UNKNOWN
:
9425 error (_("Remote target does not support vFlashDone"));
9427 error (_("Error finishing flash operation"));
9434 remote_target::files_info ()
9436 puts_filtered ("Debugging a target over a serial line.\n");
9439 /* Stuff for dealing with the packets which are part of this protocol.
9440 See comment at top of file for details. */
9442 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
9443 error to higher layers. Called when a serial error is detected.
9444 The exception message is STRING, followed by a colon and a blank,
9445 the system error message for errno at function entry and final dot
9446 for output compatibility with throw_perror_with_name. */
9449 unpush_and_perror (remote_target
*target
, const char *string
)
9451 int saved_errno
= errno
;
9453 remote_unpush_target (target
);
9454 throw_error (TARGET_CLOSE_ERROR
, "%s: %s.", string
,
9455 safe_strerror (saved_errno
));
9458 /* Read a single character from the remote end. The current quit
9459 handler is overridden to avoid quitting in the middle of packet
9460 sequence, as that would break communication with the remote server.
9461 See remote_serial_quit_handler for more detail. */
9464 remote_target::readchar (int timeout
)
9467 struct remote_state
*rs
= get_remote_state ();
9470 scoped_restore restore_quit_target
9471 = make_scoped_restore (&curr_quit_handler_target
, this);
9472 scoped_restore restore_quit
9473 = make_scoped_restore (&quit_handler
, ::remote_serial_quit_handler
);
9475 rs
->got_ctrlc_during_io
= 0;
9477 ch
= serial_readchar (rs
->remote_desc
, timeout
);
9479 if (rs
->got_ctrlc_during_io
)
9486 switch ((enum serial_rc
) ch
)
9489 remote_unpush_target (this);
9490 throw_error (TARGET_CLOSE_ERROR
, _("Remote connection closed"));
9493 unpush_and_perror (this, _("Remote communication error. "
9494 "Target disconnected."));
9496 case SERIAL_TIMEOUT
:
9502 /* Wrapper for serial_write that closes the target and throws if
9503 writing fails. The current quit handler is overridden to avoid
9504 quitting in the middle of packet sequence, as that would break
9505 communication with the remote server. See
9506 remote_serial_quit_handler for more detail. */
9509 remote_target::remote_serial_write (const char *str
, int len
)
9511 struct remote_state
*rs
= get_remote_state ();
9513 scoped_restore restore_quit_target
9514 = make_scoped_restore (&curr_quit_handler_target
, this);
9515 scoped_restore restore_quit
9516 = make_scoped_restore (&quit_handler
, ::remote_serial_quit_handler
);
9518 rs
->got_ctrlc_during_io
= 0;
9520 if (serial_write (rs
->remote_desc
, str
, len
))
9522 unpush_and_perror (this, _("Remote communication error. "
9523 "Target disconnected."));
9526 if (rs
->got_ctrlc_during_io
)
9530 /* Return a string representing an escaped version of BUF, of len N.
9531 E.g. \n is converted to \\n, \t to \\t, etc. */
9534 escape_buffer (const char *buf
, int n
)
9538 stb
.putstrn (buf
, n
, '\\');
9539 return std::move (stb
.string ());
9543 remote_target::putpkt (const char *buf
)
9545 return putpkt_binary (buf
, strlen (buf
));
9548 /* Wrapper around remote_target::putpkt to avoid exporting
9552 putpkt (remote_target
*remote
, const char *buf
)
9554 return remote
->putpkt (buf
);
9557 /* Send a packet to the remote machine, with error checking. The data
9558 of the packet is in BUF. The string in BUF can be at most
9559 get_remote_packet_size () - 5 to account for the $, # and checksum,
9560 and for a possible /0 if we are debugging (remote_debug) and want
9561 to print the sent packet as a string. */
9564 remote_target::putpkt_binary (const char *buf
, int cnt
)
9566 struct remote_state
*rs
= get_remote_state ();
9568 unsigned char csum
= 0;
9569 gdb::def_vector
<char> data (cnt
+ 6);
9570 char *buf2
= data
.data ();
9576 /* Catch cases like trying to read memory or listing threads while
9577 we're waiting for a stop reply. The remote server wouldn't be
9578 ready to handle this request, so we'd hang and timeout. We don't
9579 have to worry about this in synchronous mode, because in that
9580 case it's not possible to issue a command while the target is
9581 running. This is not a problem in non-stop mode, because in that
9582 case, the stub is always ready to process serial input. */
9583 if (!target_is_non_stop_p ()
9584 && target_is_async_p ()
9585 && rs
->waiting_for_stop_reply
)
9587 error (_("Cannot execute this command while the target is running.\n"
9588 "Use the \"interrupt\" command to stop the target\n"
9589 "and then try again."));
9592 /* Copy the packet into buffer BUF2, encapsulating it
9593 and giving it a checksum. */
9598 for (i
= 0; i
< cnt
; i
++)
9604 *p
++ = tohex ((csum
>> 4) & 0xf);
9605 *p
++ = tohex (csum
& 0xf);
9607 /* Send it over and over until we get a positive ack. */
9615 int len
= (int) (p
- buf2
);
9618 if (remote_packet_max_chars
< 0)
9621 max_chars
= remote_packet_max_chars
;
9624 = escape_buffer (buf2
, std::min (len
, max_chars
));
9626 if (len
> max_chars
)
9627 remote_debug_printf_nofunc
9628 ("Sending packet: %s [%d bytes omitted]", str
.c_str (),
9631 remote_debug_printf_nofunc ("Sending packet: %s", str
.c_str ());
9633 remote_serial_write (buf2
, p
- buf2
);
9635 /* If this is a no acks version of the remote protocol, send the
9636 packet and move on. */
9640 /* Read until either a timeout occurs (-2) or '+' is read.
9641 Handle any notification that arrives in the mean time. */
9644 ch
= readchar (remote_timeout
);
9649 remote_debug_printf_nofunc ("Received Ack");
9652 remote_debug_printf_nofunc ("Received Nak");
9654 case SERIAL_TIMEOUT
:
9658 break; /* Retransmit buffer. */
9661 remote_debug_printf ("Packet instead of Ack, ignoring it");
9662 /* It's probably an old response sent because an ACK
9663 was lost. Gobble up the packet and ack it so it
9664 doesn't get retransmitted when we resend this
9667 remote_serial_write ("+", 1);
9668 continue; /* Now, go look for +. */
9675 /* If we got a notification, handle it, and go back to looking
9677 /* We've found the start of a notification. Now
9678 collect the data. */
9679 val
= read_frame (&rs
->buf
);
9682 remote_debug_printf_nofunc
9683 (" Notification received: %s",
9684 escape_buffer (rs
->buf
.data (), val
).c_str ());
9686 handle_notification (rs
->notif_state
, rs
->buf
.data ());
9687 /* We're in sync now, rewait for the ack. */
9691 remote_debug_printf_nofunc ("Junk: %c%s", ch
& 0177,
9697 remote_debug_printf_nofunc ("Junk: %c%s", ch
& 0177,
9701 break; /* Here to retransmit. */
9705 /* This is wrong. If doing a long backtrace, the user should be
9706 able to get out next time we call QUIT, without anything as
9707 violent as interrupt_query. If we want to provide a way out of
9708 here without getting to the next QUIT, it should be based on
9709 hitting ^C twice as in remote_wait. */
9721 /* Come here after finding the start of a frame when we expected an
9722 ack. Do our best to discard the rest of this packet. */
9725 remote_target::skip_frame ()
9731 c
= readchar (remote_timeout
);
9734 case SERIAL_TIMEOUT
:
9735 /* Nothing we can do. */
9738 /* Discard the two bytes of checksum and stop. */
9739 c
= readchar (remote_timeout
);
9741 c
= readchar (remote_timeout
);
9744 case '*': /* Run length encoding. */
9745 /* Discard the repeat count. */
9746 c
= readchar (remote_timeout
);
9751 /* A regular character. */
9757 /* Come here after finding the start of the frame. Collect the rest
9758 into *BUF, verifying the checksum, length, and handling run-length
9759 compression. NUL terminate the buffer. If there is not enough room,
9762 Returns -1 on error, number of characters in buffer (ignoring the
9763 trailing NULL) on success. (could be extended to return one of the
9764 SERIAL status indications). */
9767 remote_target::read_frame (gdb::char_vector
*buf_p
)
9772 char *buf
= buf_p
->data ();
9773 struct remote_state
*rs
= get_remote_state ();
9780 c
= readchar (remote_timeout
);
9783 case SERIAL_TIMEOUT
:
9784 remote_debug_printf ("Timeout in mid-packet, retrying");
9788 remote_debug_printf ("Saw new packet start in middle of old one");
9789 return -1; /* Start a new packet, count retries. */
9793 unsigned char pktcsum
;
9799 check_0
= readchar (remote_timeout
);
9801 check_1
= readchar (remote_timeout
);
9803 if (check_0
== SERIAL_TIMEOUT
|| check_1
== SERIAL_TIMEOUT
)
9805 remote_debug_printf ("Timeout in checksum, retrying");
9808 else if (check_0
< 0 || check_1
< 0)
9810 remote_debug_printf ("Communication error in checksum");
9814 /* Don't recompute the checksum; with no ack packets we
9815 don't have any way to indicate a packet retransmission
9820 pktcsum
= (fromhex (check_0
) << 4) | fromhex (check_1
);
9821 if (csum
== pktcsum
)
9825 ("Bad checksum, sentsum=0x%x, csum=0x%x, buf=%s",
9826 pktcsum
, csum
, escape_buffer (buf
, bc
).c_str ());
9828 /* Number of characters in buffer ignoring trailing
9832 case '*': /* Run length encoding. */
9837 c
= readchar (remote_timeout
);
9839 repeat
= c
- ' ' + 3; /* Compute repeat count. */
9841 /* The character before ``*'' is repeated. */
9843 if (repeat
> 0 && repeat
<= 255 && bc
> 0)
9845 if (bc
+ repeat
- 1 >= buf_p
->size () - 1)
9847 /* Make some more room in the buffer. */
9848 buf_p
->resize (buf_p
->size () + repeat
);
9849 buf
= buf_p
->data ();
9852 memset (&buf
[bc
], buf
[bc
- 1], repeat
);
9858 printf_filtered (_("Invalid run length encoding: %s\n"), buf
);
9862 if (bc
>= buf_p
->size () - 1)
9864 /* Make some more room in the buffer. */
9865 buf_p
->resize (buf_p
->size () * 2);
9866 buf
= buf_p
->data ();
9876 /* Set this to the maximum number of seconds to wait instead of waiting forever
9877 in target_wait(). If this timer times out, then it generates an error and
9878 the command is aborted. This replaces most of the need for timeouts in the
9879 GDB test suite, and makes it possible to distinguish between a hung target
9880 and one with slow communications. */
9882 static int watchdog
= 0;
9884 show_watchdog (struct ui_file
*file
, int from_tty
,
9885 struct cmd_list_element
*c
, const char *value
)
9887 fprintf_filtered (file
, _("Watchdog timer is %s.\n"), value
);
9890 /* Read a packet from the remote machine, with error checking, and
9891 store it in *BUF. Resize *BUF if necessary to hold the result. If
9892 FOREVER, wait forever rather than timing out; this is used (in
9893 synchronous mode) to wait for a target that is is executing user
9895 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
9896 don't have to change all the calls to getpkt to deal with the
9897 return value, because at the moment I don't know what the right
9898 thing to do it for those. */
9901 remote_target::getpkt (gdb::char_vector
*buf
, int forever
)
9903 getpkt_sane (buf
, forever
);
9907 /* Read a packet from the remote machine, with error checking, and
9908 store it in *BUF. Resize *BUF if necessary to hold the result. If
9909 FOREVER, wait forever rather than timing out; this is used (in
9910 synchronous mode) to wait for a target that is is executing user
9911 code to stop. If FOREVER == 0, this function is allowed to time
9912 out gracefully and return an indication of this to the caller.
9913 Otherwise return the number of bytes read. If EXPECTING_NOTIF,
9914 consider receiving a notification enough reason to return to the
9915 caller. *IS_NOTIF is an output boolean that indicates whether *BUF
9916 holds a notification or not (a regular packet). */
9919 remote_target::getpkt_or_notif_sane_1 (gdb::char_vector
*buf
,
9920 int forever
, int expecting_notif
,
9923 struct remote_state
*rs
= get_remote_state ();
9929 strcpy (buf
->data (), "timeout");
9932 timeout
= watchdog
> 0 ? watchdog
: -1;
9933 else if (expecting_notif
)
9934 timeout
= 0; /* There should already be a char in the buffer. If
9937 timeout
= remote_timeout
;
9941 /* Process any number of notifications, and then return when
9945 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
9947 for (tries
= 1; tries
<= MAX_TRIES
; tries
++)
9949 /* This can loop forever if the remote side sends us
9950 characters continuously, but if it pauses, we'll get
9951 SERIAL_TIMEOUT from readchar because of timeout. Then
9952 we'll count that as a retry.
9954 Note that even when forever is set, we will only wait
9955 forever prior to the start of a packet. After that, we
9956 expect characters to arrive at a brisk pace. They should
9957 show up within remote_timeout intervals. */
9959 c
= readchar (timeout
);
9960 while (c
!= SERIAL_TIMEOUT
&& c
!= '$' && c
!= '%');
9962 if (c
== SERIAL_TIMEOUT
)
9964 if (expecting_notif
)
9965 return -1; /* Don't complain, it's normal to not get
9966 anything in this case. */
9968 if (forever
) /* Watchdog went off? Kill the target. */
9970 remote_unpush_target (this);
9971 throw_error (TARGET_CLOSE_ERROR
,
9972 _("Watchdog timeout has expired. "
9973 "Target detached."));
9976 remote_debug_printf ("Timed out.");
9980 /* We've found the start of a packet or notification.
9981 Now collect the data. */
9982 val
= read_frame (buf
);
9987 remote_serial_write ("-", 1);
9990 if (tries
> MAX_TRIES
)
9992 /* We have tried hard enough, and just can't receive the
9993 packet/notification. Give up. */
9994 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
9996 /* Skip the ack char if we're in no-ack mode. */
9997 if (!rs
->noack_mode
)
9998 remote_serial_write ("+", 1);
10002 /* If we got an ordinary packet, return that to our caller. */
10009 if (remote_packet_max_chars
< 0)
10012 max_chars
= remote_packet_max_chars
;
10015 = escape_buffer (buf
->data (),
10016 std::min (val
, max_chars
));
10018 if (val
> max_chars
)
10019 remote_debug_printf_nofunc
10020 ("Packet received: %s [%d bytes omitted]", str
.c_str (),
10023 remote_debug_printf_nofunc ("Packet received: %s",
10027 /* Skip the ack char if we're in no-ack mode. */
10028 if (!rs
->noack_mode
)
10029 remote_serial_write ("+", 1);
10030 if (is_notif
!= NULL
)
10035 /* If we got a notification, handle it, and go back to looking
10039 gdb_assert (c
== '%');
10041 remote_debug_printf_nofunc
10042 (" Notification received: %s",
10043 escape_buffer (buf
->data (), val
).c_str ());
10045 if (is_notif
!= NULL
)
10048 handle_notification (rs
->notif_state
, buf
->data ());
10050 /* Notifications require no acknowledgement. */
10052 if (expecting_notif
)
10059 remote_target::getpkt_sane (gdb::char_vector
*buf
, int forever
)
10061 return getpkt_or_notif_sane_1 (buf
, forever
, 0, NULL
);
10065 remote_target::getpkt_or_notif_sane (gdb::char_vector
*buf
, int forever
,
10068 return getpkt_or_notif_sane_1 (buf
, forever
, 1, is_notif
);
10071 /* Kill any new fork children of inferior INF that haven't been
10072 processed by follow_fork. */
10075 remote_target::kill_new_fork_children (inferior
*inf
)
10077 remote_state
*rs
= get_remote_state ();
10078 struct notif_client
*notif
= ¬if_client_stop
;
10080 /* Kill the fork child threads of any threads in inferior INF that are stopped
10081 at a fork event. */
10082 for (thread_info
*thread
: inf
->non_exited_threads ())
10084 const target_waitstatus
*ws
= thread_pending_fork_status (thread
);
10089 int child_pid
= ws
->child_ptid ().pid ();
10090 int res
= remote_vkill (child_pid
);
10093 error (_("Can't kill fork child process %d"), child_pid
);
10096 /* Check for any pending fork events (not reported or processed yet)
10097 in inferior INF and kill those fork child threads as well. */
10098 remote_notif_get_pending_events (notif
);
10099 for (auto &event
: rs
->stop_reply_queue
)
10101 if (event
->ptid
.pid () != inf
->pid
)
10104 if (!is_fork_status (event
->ws
.kind ()))
10107 int child_pid
= event
->ws
.child_ptid ().pid ();
10108 int res
= remote_vkill (child_pid
);
10111 error (_("Can't kill fork child process %d"), child_pid
);
10116 /* Target hook to kill the current inferior. */
10119 remote_target::kill ()
10122 inferior
*inf
= find_inferior_pid (this, inferior_ptid
.pid ());
10123 struct remote_state
*rs
= get_remote_state ();
10125 gdb_assert (inf
!= nullptr);
10127 if (packet_support (PACKET_vKill
) != PACKET_DISABLE
)
10129 /* If we're stopped while forking and we haven't followed yet,
10130 kill the child task. We need to do this before killing the
10131 parent task because if this is a vfork then the parent will
10133 kill_new_fork_children (inf
);
10135 res
= remote_vkill (inf
->pid
);
10138 target_mourn_inferior (inferior_ptid
);
10143 /* If we are in 'target remote' mode and we are killing the only
10144 inferior, then we will tell gdbserver to exit and unpush the
10146 if (res
== -1 && !remote_multi_process_p (rs
)
10147 && number_of_live_inferiors (this) == 1)
10151 /* We've killed the remote end, we get to mourn it. If we are
10152 not in extended mode, mourning the inferior also unpushes
10153 remote_ops from the target stack, which closes the remote
10155 target_mourn_inferior (inferior_ptid
);
10160 error (_("Can't kill process"));
10163 /* Send a kill request to the target using the 'vKill' packet. */
10166 remote_target::remote_vkill (int pid
)
10168 if (packet_support (PACKET_vKill
) == PACKET_DISABLE
)
10171 remote_state
*rs
= get_remote_state ();
10173 /* Tell the remote target to detach. */
10174 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "vKill;%x", pid
);
10176 getpkt (&rs
->buf
, 0);
10178 switch (packet_ok (rs
->buf
,
10179 &remote_protocol_packets
[PACKET_vKill
]))
10185 case PACKET_UNKNOWN
:
10188 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
10192 /* Send a kill request to the target using the 'k' packet. */
10195 remote_target::remote_kill_k ()
10197 /* Catch errors so the user can quit from gdb even when we
10198 aren't on speaking terms with the remote system. */
10203 catch (const gdb_exception_error
&ex
)
10205 if (ex
.error
== TARGET_CLOSE_ERROR
)
10207 /* If we got an (EOF) error that caused the target
10208 to go away, then we're done, that's what we wanted.
10209 "k" is susceptible to cause a premature EOF, given
10210 that the remote server isn't actually required to
10211 reply to "k", and it can happen that it doesn't
10212 even get to reply ACK to the "k". */
10216 /* Otherwise, something went wrong. We didn't actually kill
10217 the target. Just propagate the exception, and let the
10218 user or higher layers decide what to do. */
10224 remote_target::mourn_inferior ()
10226 struct remote_state
*rs
= get_remote_state ();
10228 /* We're no longer interested in notification events of an inferior
10229 that exited or was killed/detached. */
10230 discard_pending_stop_replies (current_inferior ());
10232 /* In 'target remote' mode with one inferior, we close the connection. */
10233 if (!rs
->extended
&& number_of_live_inferiors (this) <= 1)
10235 remote_unpush_target (this);
10239 /* In case we got here due to an error, but we're going to stay
10241 rs
->waiting_for_stop_reply
= 0;
10243 /* If the current general thread belonged to the process we just
10244 detached from or has exited, the remote side current general
10245 thread becomes undefined. Considering a case like this:
10247 - We just got here due to a detach.
10248 - The process that we're detaching from happens to immediately
10249 report a global breakpoint being hit in non-stop mode, in the
10250 same thread we had selected before.
10251 - GDB attaches to this process again.
10252 - This event happens to be the next event we handle.
10254 GDB would consider that the current general thread didn't need to
10255 be set on the stub side (with Hg), since for all it knew,
10256 GENERAL_THREAD hadn't changed.
10258 Notice that although in all-stop mode, the remote server always
10259 sets the current thread to the thread reporting the stop event,
10260 that doesn't happen in non-stop mode; in non-stop, the stub *must
10261 not* change the current thread when reporting a breakpoint hit,
10262 due to the decoupling of event reporting and event handling.
10264 To keep things simple, we always invalidate our notion of the
10266 record_currthread (rs
, minus_one_ptid
);
10268 /* Call common code to mark the inferior as not running. */
10269 generic_mourn_inferior ();
10273 extended_remote_target::supports_disable_randomization ()
10275 return packet_support (PACKET_QDisableRandomization
) == PACKET_ENABLE
;
10279 remote_target::extended_remote_disable_randomization (int val
)
10281 struct remote_state
*rs
= get_remote_state ();
10284 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10285 "QDisableRandomization:%x", val
);
10287 reply
= remote_get_noisy_reply ();
10288 if (*reply
== '\0')
10289 error (_("Target does not support QDisableRandomization."));
10290 if (strcmp (reply
, "OK") != 0)
10291 error (_("Bogus QDisableRandomization reply from target: %s"), reply
);
10295 remote_target::extended_remote_run (const std::string
&args
)
10297 struct remote_state
*rs
= get_remote_state ();
10299 const char *remote_exec_file
= get_remote_exec_file ();
10301 /* If the user has disabled vRun support, or we have detected that
10302 support is not available, do not try it. */
10303 if (packet_support (PACKET_vRun
) == PACKET_DISABLE
)
10306 strcpy (rs
->buf
.data (), "vRun;");
10307 len
= strlen (rs
->buf
.data ());
10309 if (strlen (remote_exec_file
) * 2 + len
>= get_remote_packet_size ())
10310 error (_("Remote file name too long for run packet"));
10311 len
+= 2 * bin2hex ((gdb_byte
*) remote_exec_file
, rs
->buf
.data () + len
,
10312 strlen (remote_exec_file
));
10314 if (!args
.empty ())
10318 gdb_argv
argv (args
.c_str ());
10319 for (i
= 0; argv
[i
] != NULL
; i
++)
10321 if (strlen (argv
[i
]) * 2 + 1 + len
>= get_remote_packet_size ())
10322 error (_("Argument list too long for run packet"));
10323 rs
->buf
[len
++] = ';';
10324 len
+= 2 * bin2hex ((gdb_byte
*) argv
[i
], rs
->buf
.data () + len
,
10329 rs
->buf
[len
++] = '\0';
10332 getpkt (&rs
->buf
, 0);
10334 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vRun
]))
10337 /* We have a wait response. All is well. */
10339 case PACKET_UNKNOWN
:
10342 if (remote_exec_file
[0] == '\0')
10343 error (_("Running the default executable on the remote target failed; "
10344 "try \"set remote exec-file\"?"));
10346 error (_("Running \"%s\" on the remote target failed"),
10349 gdb_assert_not_reached ("bad switch");
10353 /* Helper function to send set/unset environment packets. ACTION is
10354 either "set" or "unset". PACKET is either "QEnvironmentHexEncoded"
10355 or "QEnvironmentUnsetVariable". VALUE is the variable to be
10359 remote_target::send_environment_packet (const char *action
,
10360 const char *packet
,
10363 remote_state
*rs
= get_remote_state ();
10365 /* Convert the environment variable to an hex string, which
10366 is the best format to be transmitted over the wire. */
10367 std::string encoded_value
= bin2hex ((const gdb_byte
*) value
,
10370 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10371 "%s:%s", packet
, encoded_value
.c_str ());
10374 getpkt (&rs
->buf
, 0);
10375 if (strcmp (rs
->buf
.data (), "OK") != 0)
10376 warning (_("Unable to %s environment variable '%s' on remote."),
10380 /* Helper function to handle the QEnvironment* packets. */
10383 remote_target::extended_remote_environment_support ()
10385 remote_state
*rs
= get_remote_state ();
10387 if (packet_support (PACKET_QEnvironmentReset
) != PACKET_DISABLE
)
10389 putpkt ("QEnvironmentReset");
10390 getpkt (&rs
->buf
, 0);
10391 if (strcmp (rs
->buf
.data (), "OK") != 0)
10392 warning (_("Unable to reset environment on remote."));
10395 gdb_environ
*e
= ¤t_inferior ()->environment
;
10397 if (packet_support (PACKET_QEnvironmentHexEncoded
) != PACKET_DISABLE
)
10398 for (const std::string
&el
: e
->user_set_env ())
10399 send_environment_packet ("set", "QEnvironmentHexEncoded",
10402 if (packet_support (PACKET_QEnvironmentUnset
) != PACKET_DISABLE
)
10403 for (const std::string
&el
: e
->user_unset_env ())
10404 send_environment_packet ("unset", "QEnvironmentUnset", el
.c_str ());
10407 /* Helper function to set the current working directory for the
10408 inferior in the remote target. */
10411 remote_target::extended_remote_set_inferior_cwd ()
10413 if (packet_support (PACKET_QSetWorkingDir
) != PACKET_DISABLE
)
10415 const std::string
&inferior_cwd
= current_inferior ()->cwd ();
10416 remote_state
*rs
= get_remote_state ();
10418 if (!inferior_cwd
.empty ())
10420 std::string hexpath
10421 = bin2hex ((const gdb_byte
*) inferior_cwd
.data (),
10422 inferior_cwd
.size ());
10424 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10425 "QSetWorkingDir:%s", hexpath
.c_str ());
10429 /* An empty inferior_cwd means that the user wants us to
10430 reset the remote server's inferior's cwd. */
10431 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10432 "QSetWorkingDir:");
10436 getpkt (&rs
->buf
, 0);
10437 if (packet_ok (rs
->buf
,
10438 &remote_protocol_packets
[PACKET_QSetWorkingDir
])
10441 Remote replied unexpectedly while setting the inferior's working\n\
10448 /* In the extended protocol we want to be able to do things like
10449 "run" and have them basically work as expected. So we need
10450 a special create_inferior function. We support changing the
10451 executable file and the command line arguments, but not the
10455 extended_remote_target::create_inferior (const char *exec_file
,
10456 const std::string
&args
,
10457 char **env
, int from_tty
)
10461 struct remote_state
*rs
= get_remote_state ();
10462 const char *remote_exec_file
= get_remote_exec_file ();
10464 /* If running asynchronously, register the target file descriptor
10465 with the event loop. */
10466 if (target_can_async_p ())
10469 /* Disable address space randomization if requested (and supported). */
10470 if (supports_disable_randomization ())
10471 extended_remote_disable_randomization (disable_randomization
);
10473 /* If startup-with-shell is on, we inform gdbserver to start the
10474 remote inferior using a shell. */
10475 if (packet_support (PACKET_QStartupWithShell
) != PACKET_DISABLE
)
10477 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10478 "QStartupWithShell:%d", startup_with_shell
? 1 : 0);
10480 getpkt (&rs
->buf
, 0);
10481 if (strcmp (rs
->buf
.data (), "OK") != 0)
10483 Remote replied unexpectedly while setting startup-with-shell: %s"),
10487 extended_remote_environment_support ();
10489 extended_remote_set_inferior_cwd ();
10491 /* Now restart the remote server. */
10492 run_worked
= extended_remote_run (args
) != -1;
10495 /* vRun was not supported. Fail if we need it to do what the
10497 if (remote_exec_file
[0])
10498 error (_("Remote target does not support \"set remote exec-file\""));
10499 if (!args
.empty ())
10500 error (_("Remote target does not support \"set args\" or run ARGS"));
10502 /* Fall back to "R". */
10503 extended_remote_restart ();
10506 /* vRun's success return is a stop reply. */
10507 stop_reply
= run_worked
? rs
->buf
.data () : NULL
;
10508 add_current_inferior_and_thread (stop_reply
);
10510 /* Get updated offsets, if the stub uses qOffsets. */
10515 /* Given a location's target info BP_TGT and the packet buffer BUF, output
10516 the list of conditions (in agent expression bytecode format), if any, the
10517 target needs to evaluate. The output is placed into the packet buffer
10518 started from BUF and ended at BUF_END. */
10521 remote_add_target_side_condition (struct gdbarch
*gdbarch
,
10522 struct bp_target_info
*bp_tgt
, char *buf
,
10525 if (bp_tgt
->conditions
.empty ())
10528 buf
+= strlen (buf
);
10529 xsnprintf (buf
, buf_end
- buf
, "%s", ";");
10532 /* Send conditions to the target. */
10533 for (agent_expr
*aexpr
: bp_tgt
->conditions
)
10535 xsnprintf (buf
, buf_end
- buf
, "X%x,", aexpr
->len
);
10536 buf
+= strlen (buf
);
10537 for (int i
= 0; i
< aexpr
->len
; ++i
)
10538 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
10545 remote_add_target_side_commands (struct gdbarch
*gdbarch
,
10546 struct bp_target_info
*bp_tgt
, char *buf
)
10548 if (bp_tgt
->tcommands
.empty ())
10551 buf
+= strlen (buf
);
10553 sprintf (buf
, ";cmds:%x,", bp_tgt
->persist
);
10554 buf
+= strlen (buf
);
10556 /* Concatenate all the agent expressions that are commands into the
10558 for (agent_expr
*aexpr
: bp_tgt
->tcommands
)
10560 sprintf (buf
, "X%x,", aexpr
->len
);
10561 buf
+= strlen (buf
);
10562 for (int i
= 0; i
< aexpr
->len
; ++i
)
10563 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
10568 /* Insert a breakpoint. On targets that have software breakpoint
10569 support, we ask the remote target to do the work; on targets
10570 which don't, we insert a traditional memory breakpoint. */
10573 remote_target::insert_breakpoint (struct gdbarch
*gdbarch
,
10574 struct bp_target_info
*bp_tgt
)
10576 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
10577 If it succeeds, then set the support to PACKET_ENABLE. If it
10578 fails, and the user has explicitly requested the Z support then
10579 report an error, otherwise, mark it disabled and go on. */
10581 if (packet_support (PACKET_Z0
) != PACKET_DISABLE
)
10583 CORE_ADDR addr
= bp_tgt
->reqstd_address
;
10584 struct remote_state
*rs
;
10587 /* Make sure the remote is pointing at the right process, if
10589 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10590 set_general_process ();
10592 rs
= get_remote_state ();
10593 p
= rs
->buf
.data ();
10594 endbuf
= p
+ get_remote_packet_size ();
10599 addr
= (ULONGEST
) remote_address_masked (addr
);
10600 p
+= hexnumstr (p
, addr
);
10601 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->kind
);
10603 if (supports_evaluation_of_breakpoint_conditions ())
10604 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
10606 if (can_run_breakpoint_commands ())
10607 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
10610 getpkt (&rs
->buf
, 0);
10612 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
]))
10618 case PACKET_UNKNOWN
:
10623 /* If this breakpoint has target-side commands but this stub doesn't
10624 support Z0 packets, throw error. */
10625 if (!bp_tgt
->tcommands
.empty ())
10626 throw_error (NOT_SUPPORTED_ERROR
, _("\
10627 Target doesn't support breakpoints that have target side commands."));
10629 return memory_insert_breakpoint (this, gdbarch
, bp_tgt
);
10633 remote_target::remove_breakpoint (struct gdbarch
*gdbarch
,
10634 struct bp_target_info
*bp_tgt
,
10635 enum remove_bp_reason reason
)
10637 CORE_ADDR addr
= bp_tgt
->placed_address
;
10638 struct remote_state
*rs
= get_remote_state ();
10640 if (packet_support (PACKET_Z0
) != PACKET_DISABLE
)
10642 char *p
= rs
->buf
.data ();
10643 char *endbuf
= p
+ get_remote_packet_size ();
10645 /* Make sure the remote is pointing at the right process, if
10647 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10648 set_general_process ();
10654 addr
= (ULONGEST
) remote_address_masked (bp_tgt
->placed_address
);
10655 p
+= hexnumstr (p
, addr
);
10656 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->kind
);
10659 getpkt (&rs
->buf
, 0);
10661 return (rs
->buf
[0] == 'E');
10664 return memory_remove_breakpoint (this, gdbarch
, bp_tgt
, reason
);
10667 static enum Z_packet_type
10668 watchpoint_to_Z_packet (int type
)
10673 return Z_PACKET_WRITE_WP
;
10676 return Z_PACKET_READ_WP
;
10679 return Z_PACKET_ACCESS_WP
;
10682 internal_error (__FILE__
, __LINE__
,
10683 _("hw_bp_to_z: bad watchpoint type %d"), type
);
10688 remote_target::insert_watchpoint (CORE_ADDR addr
, int len
,
10689 enum target_hw_bp_type type
, struct expression
*cond
)
10691 struct remote_state
*rs
= get_remote_state ();
10692 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
10694 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
10696 if (packet_support (PACKET_Z0
+ packet
) == PACKET_DISABLE
)
10699 /* Make sure the remote is pointing at the right process, if
10701 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10702 set_general_process ();
10704 xsnprintf (rs
->buf
.data (), endbuf
- rs
->buf
.data (), "Z%x,", packet
);
10705 p
= strchr (rs
->buf
.data (), '\0');
10706 addr
= remote_address_masked (addr
);
10707 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10708 xsnprintf (p
, endbuf
- p
, ",%x", len
);
10711 getpkt (&rs
->buf
, 0);
10713 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
10717 case PACKET_UNKNOWN
:
10722 internal_error (__FILE__
, __LINE__
,
10723 _("remote_insert_watchpoint: reached end of function"));
10727 remote_target::watchpoint_addr_within_range (CORE_ADDR addr
,
10728 CORE_ADDR start
, int length
)
10730 CORE_ADDR diff
= remote_address_masked (addr
- start
);
10732 return diff
< length
;
10737 remote_target::remove_watchpoint (CORE_ADDR addr
, int len
,
10738 enum target_hw_bp_type type
, struct expression
*cond
)
10740 struct remote_state
*rs
= get_remote_state ();
10741 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
10743 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
10745 if (packet_support (PACKET_Z0
+ packet
) == PACKET_DISABLE
)
10748 /* Make sure the remote is pointing at the right process, if
10750 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10751 set_general_process ();
10753 xsnprintf (rs
->buf
.data (), endbuf
- rs
->buf
.data (), "z%x,", packet
);
10754 p
= strchr (rs
->buf
.data (), '\0');
10755 addr
= remote_address_masked (addr
);
10756 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10757 xsnprintf (p
, endbuf
- p
, ",%x", len
);
10759 getpkt (&rs
->buf
, 0);
10761 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
10764 case PACKET_UNKNOWN
:
10769 internal_error (__FILE__
, __LINE__
,
10770 _("remote_remove_watchpoint: reached end of function"));
10774 static int remote_hw_watchpoint_limit
= -1;
10775 static int remote_hw_watchpoint_length_limit
= -1;
10776 static int remote_hw_breakpoint_limit
= -1;
10779 remote_target::region_ok_for_hw_watchpoint (CORE_ADDR addr
, int len
)
10781 if (remote_hw_watchpoint_length_limit
== 0)
10783 else if (remote_hw_watchpoint_length_limit
< 0)
10785 else if (len
<= remote_hw_watchpoint_length_limit
)
10792 remote_target::can_use_hw_breakpoint (enum bptype type
, int cnt
, int ot
)
10794 if (type
== bp_hardware_breakpoint
)
10796 if (remote_hw_breakpoint_limit
== 0)
10798 else if (remote_hw_breakpoint_limit
< 0)
10800 else if (cnt
<= remote_hw_breakpoint_limit
)
10805 if (remote_hw_watchpoint_limit
== 0)
10807 else if (remote_hw_watchpoint_limit
< 0)
10811 else if (cnt
<= remote_hw_watchpoint_limit
)
10817 /* The to_stopped_by_sw_breakpoint method of target remote. */
10820 remote_target::stopped_by_sw_breakpoint ()
10822 struct thread_info
*thread
= inferior_thread ();
10824 return (thread
->priv
!= NULL
10825 && (get_remote_thread_info (thread
)->stop_reason
10826 == TARGET_STOPPED_BY_SW_BREAKPOINT
));
10829 /* The to_supports_stopped_by_sw_breakpoint method of target
10833 remote_target::supports_stopped_by_sw_breakpoint ()
10835 return (packet_support (PACKET_swbreak_feature
) == PACKET_ENABLE
);
10838 /* The to_stopped_by_hw_breakpoint method of target remote. */
10841 remote_target::stopped_by_hw_breakpoint ()
10843 struct thread_info
*thread
= inferior_thread ();
10845 return (thread
->priv
!= NULL
10846 && (get_remote_thread_info (thread
)->stop_reason
10847 == TARGET_STOPPED_BY_HW_BREAKPOINT
));
10850 /* The to_supports_stopped_by_hw_breakpoint method of target
10854 remote_target::supports_stopped_by_hw_breakpoint ()
10856 return (packet_support (PACKET_hwbreak_feature
) == PACKET_ENABLE
);
10860 remote_target::stopped_by_watchpoint ()
10862 struct thread_info
*thread
= inferior_thread ();
10864 return (thread
->priv
!= NULL
10865 && (get_remote_thread_info (thread
)->stop_reason
10866 == TARGET_STOPPED_BY_WATCHPOINT
));
10870 remote_target::stopped_data_address (CORE_ADDR
*addr_p
)
10872 struct thread_info
*thread
= inferior_thread ();
10874 if (thread
->priv
!= NULL
10875 && (get_remote_thread_info (thread
)->stop_reason
10876 == TARGET_STOPPED_BY_WATCHPOINT
))
10878 *addr_p
= get_remote_thread_info (thread
)->watch_data_address
;
10887 remote_target::insert_hw_breakpoint (struct gdbarch
*gdbarch
,
10888 struct bp_target_info
*bp_tgt
)
10890 CORE_ADDR addr
= bp_tgt
->reqstd_address
;
10891 struct remote_state
*rs
;
10895 if (packet_support (PACKET_Z1
) == PACKET_DISABLE
)
10898 /* Make sure the remote is pointing at the right process, if
10900 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10901 set_general_process ();
10903 rs
= get_remote_state ();
10904 p
= rs
->buf
.data ();
10905 endbuf
= p
+ get_remote_packet_size ();
10911 addr
= remote_address_masked (addr
);
10912 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10913 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->kind
);
10915 if (supports_evaluation_of_breakpoint_conditions ())
10916 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
10918 if (can_run_breakpoint_commands ())
10919 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
10922 getpkt (&rs
->buf
, 0);
10924 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
10927 if (rs
->buf
[1] == '.')
10929 message
= strchr (&rs
->buf
[2], '.');
10931 error (_("Remote failure reply: %s"), message
+ 1);
10934 case PACKET_UNKNOWN
:
10939 internal_error (__FILE__
, __LINE__
,
10940 _("remote_insert_hw_breakpoint: reached end of function"));
10945 remote_target::remove_hw_breakpoint (struct gdbarch
*gdbarch
,
10946 struct bp_target_info
*bp_tgt
)
10949 struct remote_state
*rs
= get_remote_state ();
10950 char *p
= rs
->buf
.data ();
10951 char *endbuf
= p
+ get_remote_packet_size ();
10953 if (packet_support (PACKET_Z1
) == PACKET_DISABLE
)
10956 /* Make sure the remote is pointing at the right process, if
10958 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10959 set_general_process ();
10965 addr
= remote_address_masked (bp_tgt
->placed_address
);
10966 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10967 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->kind
);
10970 getpkt (&rs
->buf
, 0);
10972 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
10975 case PACKET_UNKNOWN
:
10980 internal_error (__FILE__
, __LINE__
,
10981 _("remote_remove_hw_breakpoint: reached end of function"));
10984 /* Verify memory using the "qCRC:" request. */
10987 remote_target::verify_memory (const gdb_byte
*data
, CORE_ADDR lma
, ULONGEST size
)
10989 struct remote_state
*rs
= get_remote_state ();
10990 unsigned long host_crc
, target_crc
;
10993 /* It doesn't make sense to use qCRC if the remote target is
10994 connected but not running. */
10995 if (target_has_execution ()
10996 && packet_support (PACKET_qCRC
) != PACKET_DISABLE
)
10998 enum packet_result result
;
11000 /* Make sure the remote is pointing at the right process. */
11001 set_general_process ();
11003 /* FIXME: assumes lma can fit into long. */
11004 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qCRC:%lx,%lx",
11005 (long) lma
, (long) size
);
11008 /* Be clever; compute the host_crc before waiting for target
11010 host_crc
= xcrc32 (data
, size
, 0xffffffff);
11012 getpkt (&rs
->buf
, 0);
11014 result
= packet_ok (rs
->buf
,
11015 &remote_protocol_packets
[PACKET_qCRC
]);
11016 if (result
== PACKET_ERROR
)
11018 else if (result
== PACKET_OK
)
11020 for (target_crc
= 0, tmp
= &rs
->buf
[1]; *tmp
; tmp
++)
11021 target_crc
= target_crc
* 16 + fromhex (*tmp
);
11023 return (host_crc
== target_crc
);
11027 return simple_verify_memory (this, data
, lma
, size
);
11030 /* compare-sections command
11032 With no arguments, compares each loadable section in the exec bfd
11033 with the same memory range on the target, and reports mismatches.
11034 Useful for verifying the image on the target against the exec file. */
11037 compare_sections_command (const char *args
, int from_tty
)
11040 const char *sectname
;
11041 bfd_size_type size
;
11044 int mismatched
= 0;
11048 if (!current_program_space
->exec_bfd ())
11049 error (_("command cannot be used without an exec file"));
11051 if (args
!= NULL
&& strcmp (args
, "-r") == 0)
11057 for (s
= current_program_space
->exec_bfd ()->sections
; s
; s
= s
->next
)
11059 if (!(s
->flags
& SEC_LOAD
))
11060 continue; /* Skip non-loadable section. */
11062 if (read_only
&& (s
->flags
& SEC_READONLY
) == 0)
11063 continue; /* Skip writeable sections */
11065 size
= bfd_section_size (s
);
11067 continue; /* Skip zero-length section. */
11069 sectname
= bfd_section_name (s
);
11070 if (args
&& strcmp (args
, sectname
) != 0)
11071 continue; /* Not the section selected by user. */
11073 matched
= 1; /* Do this section. */
11076 gdb::byte_vector
sectdata (size
);
11077 bfd_get_section_contents (current_program_space
->exec_bfd (), s
,
11078 sectdata
.data (), 0, size
);
11080 res
= target_verify_memory (sectdata
.data (), lma
, size
);
11083 error (_("target memory fault, section %s, range %s -- %s"), sectname
,
11084 paddress (target_gdbarch (), lma
),
11085 paddress (target_gdbarch (), lma
+ size
));
11087 printf_filtered ("Section %s, range %s -- %s: ", sectname
,
11088 paddress (target_gdbarch (), lma
),
11089 paddress (target_gdbarch (), lma
+ size
));
11091 printf_filtered ("matched.\n");
11094 printf_filtered ("MIS-MATCHED!\n");
11098 if (mismatched
> 0)
11099 warning (_("One or more sections of the target image does not match\n\
11100 the loaded file\n"));
11101 if (args
&& !matched
)
11102 printf_filtered (_("No loaded section named '%s'.\n"), args
);
11105 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
11106 into remote target. The number of bytes written to the remote
11107 target is returned, or -1 for error. */
11110 remote_target::remote_write_qxfer (const char *object_name
,
11111 const char *annex
, const gdb_byte
*writebuf
,
11112 ULONGEST offset
, LONGEST len
,
11113 ULONGEST
*xfered_len
,
11114 struct packet_config
*packet
)
11118 struct remote_state
*rs
= get_remote_state ();
11119 int max_size
= get_memory_write_packet_size ();
11121 if (packet_config_support (packet
) == PACKET_DISABLE
)
11122 return TARGET_XFER_E_IO
;
11124 /* Insert header. */
11125 i
= snprintf (rs
->buf
.data (), max_size
,
11126 "qXfer:%s:write:%s:%s:",
11127 object_name
, annex
? annex
: "",
11128 phex_nz (offset
, sizeof offset
));
11129 max_size
-= (i
+ 1);
11131 /* Escape as much data as fits into rs->buf. */
11132 buf_len
= remote_escape_output
11133 (writebuf
, len
, 1, (gdb_byte
*) rs
->buf
.data () + i
, &max_size
, max_size
);
11135 if (putpkt_binary (rs
->buf
.data (), i
+ buf_len
) < 0
11136 || getpkt_sane (&rs
->buf
, 0) < 0
11137 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11138 return TARGET_XFER_E_IO
;
11140 unpack_varlen_hex (rs
->buf
.data (), &n
);
11143 return (*xfered_len
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
11146 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
11147 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
11148 number of bytes read is returned, or 0 for EOF, or -1 for error.
11149 The number of bytes read may be less than LEN without indicating an
11150 EOF. PACKET is checked and updated to indicate whether the remote
11151 target supports this object. */
11154 remote_target::remote_read_qxfer (const char *object_name
,
11156 gdb_byte
*readbuf
, ULONGEST offset
,
11158 ULONGEST
*xfered_len
,
11159 struct packet_config
*packet
)
11161 struct remote_state
*rs
= get_remote_state ();
11162 LONGEST i
, n
, packet_len
;
11164 if (packet_config_support (packet
) == PACKET_DISABLE
)
11165 return TARGET_XFER_E_IO
;
11167 /* Check whether we've cached an end-of-object packet that matches
11169 if (rs
->finished_object
)
11171 if (strcmp (object_name
, rs
->finished_object
) == 0
11172 && strcmp (annex
? annex
: "", rs
->finished_annex
) == 0
11173 && offset
== rs
->finished_offset
)
11174 return TARGET_XFER_EOF
;
11177 /* Otherwise, we're now reading something different. Discard
11179 xfree (rs
->finished_object
);
11180 xfree (rs
->finished_annex
);
11181 rs
->finished_object
= NULL
;
11182 rs
->finished_annex
= NULL
;
11185 /* Request only enough to fit in a single packet. The actual data
11186 may not, since we don't know how much of it will need to be escaped;
11187 the target is free to respond with slightly less data. We subtract
11188 five to account for the response type and the protocol frame. */
11189 n
= std::min
<LONGEST
> (get_remote_packet_size () - 5, len
);
11190 snprintf (rs
->buf
.data (), get_remote_packet_size () - 4,
11191 "qXfer:%s:read:%s:%s,%s",
11192 object_name
, annex
? annex
: "",
11193 phex_nz (offset
, sizeof offset
),
11194 phex_nz (n
, sizeof n
));
11195 i
= putpkt (rs
->buf
);
11197 return TARGET_XFER_E_IO
;
11200 packet_len
= getpkt_sane (&rs
->buf
, 0);
11201 if (packet_len
< 0 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11202 return TARGET_XFER_E_IO
;
11204 if (rs
->buf
[0] != 'l' && rs
->buf
[0] != 'm')
11205 error (_("Unknown remote qXfer reply: %s"), rs
->buf
.data ());
11207 /* 'm' means there is (or at least might be) more data after this
11208 batch. That does not make sense unless there's at least one byte
11209 of data in this reply. */
11210 if (rs
->buf
[0] == 'm' && packet_len
== 1)
11211 error (_("Remote qXfer reply contained no data."));
11213 /* Got some data. */
11214 i
= remote_unescape_input ((gdb_byte
*) rs
->buf
.data () + 1,
11215 packet_len
- 1, readbuf
, n
);
11217 /* 'l' is an EOF marker, possibly including a final block of data,
11218 or possibly empty. If we have the final block of a non-empty
11219 object, record this fact to bypass a subsequent partial read. */
11220 if (rs
->buf
[0] == 'l' && offset
+ i
> 0)
11222 rs
->finished_object
= xstrdup (object_name
);
11223 rs
->finished_annex
= xstrdup (annex
? annex
: "");
11224 rs
->finished_offset
= offset
+ i
;
11228 return TARGET_XFER_EOF
;
11232 return TARGET_XFER_OK
;
11236 enum target_xfer_status
11237 remote_target::xfer_partial (enum target_object object
,
11238 const char *annex
, gdb_byte
*readbuf
,
11239 const gdb_byte
*writebuf
, ULONGEST offset
, ULONGEST len
,
11240 ULONGEST
*xfered_len
)
11242 struct remote_state
*rs
;
11246 int unit_size
= gdbarch_addressable_memory_unit_size (target_gdbarch ());
11248 set_remote_traceframe ();
11249 set_general_thread (inferior_ptid
);
11251 rs
= get_remote_state ();
11253 /* Handle memory using the standard memory routines. */
11254 if (object
== TARGET_OBJECT_MEMORY
)
11256 /* If the remote target is connected but not running, we should
11257 pass this request down to a lower stratum (e.g. the executable
11259 if (!target_has_execution ())
11260 return TARGET_XFER_EOF
;
11262 if (writebuf
!= NULL
)
11263 return remote_write_bytes (offset
, writebuf
, len
, unit_size
,
11266 return remote_read_bytes (offset
, readbuf
, len
, unit_size
,
11270 /* Handle extra signal info using qxfer packets. */
11271 if (object
== TARGET_OBJECT_SIGNAL_INFO
)
11274 return remote_read_qxfer ("siginfo", annex
, readbuf
, offset
, len
,
11275 xfered_len
, &remote_protocol_packets
11276 [PACKET_qXfer_siginfo_read
]);
11278 return remote_write_qxfer ("siginfo", annex
,
11279 writebuf
, offset
, len
, xfered_len
,
11280 &remote_protocol_packets
11281 [PACKET_qXfer_siginfo_write
]);
11284 if (object
== TARGET_OBJECT_STATIC_TRACE_DATA
)
11287 return remote_read_qxfer ("statictrace", annex
,
11288 readbuf
, offset
, len
, xfered_len
,
11289 &remote_protocol_packets
11290 [PACKET_qXfer_statictrace_read
]);
11292 return TARGET_XFER_E_IO
;
11295 /* Only handle flash writes. */
11296 if (writebuf
!= NULL
)
11300 case TARGET_OBJECT_FLASH
:
11301 return remote_flash_write (offset
, len
, xfered_len
,
11305 return TARGET_XFER_E_IO
;
11309 /* Map pre-existing objects onto letters. DO NOT do this for new
11310 objects!!! Instead specify new query packets. */
11313 case TARGET_OBJECT_AVR
:
11317 case TARGET_OBJECT_AUXV
:
11318 gdb_assert (annex
== NULL
);
11319 return remote_read_qxfer ("auxv", annex
, readbuf
, offset
, len
,
11321 &remote_protocol_packets
[PACKET_qXfer_auxv
]);
11323 case TARGET_OBJECT_AVAILABLE_FEATURES
:
11324 return remote_read_qxfer
11325 ("features", annex
, readbuf
, offset
, len
, xfered_len
,
11326 &remote_protocol_packets
[PACKET_qXfer_features
]);
11328 case TARGET_OBJECT_LIBRARIES
:
11329 return remote_read_qxfer
11330 ("libraries", annex
, readbuf
, offset
, len
, xfered_len
,
11331 &remote_protocol_packets
[PACKET_qXfer_libraries
]);
11333 case TARGET_OBJECT_LIBRARIES_SVR4
:
11334 return remote_read_qxfer
11335 ("libraries-svr4", annex
, readbuf
, offset
, len
, xfered_len
,
11336 &remote_protocol_packets
[PACKET_qXfer_libraries_svr4
]);
11338 case TARGET_OBJECT_MEMORY_MAP
:
11339 gdb_assert (annex
== NULL
);
11340 return remote_read_qxfer ("memory-map", annex
, readbuf
, offset
, len
,
11342 &remote_protocol_packets
[PACKET_qXfer_memory_map
]);
11344 case TARGET_OBJECT_OSDATA
:
11345 /* Should only get here if we're connected. */
11346 gdb_assert (rs
->remote_desc
);
11347 return remote_read_qxfer
11348 ("osdata", annex
, readbuf
, offset
, len
, xfered_len
,
11349 &remote_protocol_packets
[PACKET_qXfer_osdata
]);
11351 case TARGET_OBJECT_THREADS
:
11352 gdb_assert (annex
== NULL
);
11353 return remote_read_qxfer ("threads", annex
, readbuf
, offset
, len
,
11355 &remote_protocol_packets
[PACKET_qXfer_threads
]);
11357 case TARGET_OBJECT_TRACEFRAME_INFO
:
11358 gdb_assert (annex
== NULL
);
11359 return remote_read_qxfer
11360 ("traceframe-info", annex
, readbuf
, offset
, len
, xfered_len
,
11361 &remote_protocol_packets
[PACKET_qXfer_traceframe_info
]);
11363 case TARGET_OBJECT_FDPIC
:
11364 return remote_read_qxfer ("fdpic", annex
, readbuf
, offset
, len
,
11366 &remote_protocol_packets
[PACKET_qXfer_fdpic
]);
11368 case TARGET_OBJECT_OPENVMS_UIB
:
11369 return remote_read_qxfer ("uib", annex
, readbuf
, offset
, len
,
11371 &remote_protocol_packets
[PACKET_qXfer_uib
]);
11373 case TARGET_OBJECT_BTRACE
:
11374 return remote_read_qxfer ("btrace", annex
, readbuf
, offset
, len
,
11376 &remote_protocol_packets
[PACKET_qXfer_btrace
]);
11378 case TARGET_OBJECT_BTRACE_CONF
:
11379 return remote_read_qxfer ("btrace-conf", annex
, readbuf
, offset
,
11381 &remote_protocol_packets
[PACKET_qXfer_btrace_conf
]);
11383 case TARGET_OBJECT_EXEC_FILE
:
11384 return remote_read_qxfer ("exec-file", annex
, readbuf
, offset
,
11386 &remote_protocol_packets
[PACKET_qXfer_exec_file
]);
11389 return TARGET_XFER_E_IO
;
11392 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
11393 large enough let the caller deal with it. */
11394 if (len
< get_remote_packet_size ())
11395 return TARGET_XFER_E_IO
;
11396 len
= get_remote_packet_size ();
11398 /* Except for querying the minimum buffer size, target must be open. */
11399 if (!rs
->remote_desc
)
11400 error (_("remote query is only available after target open"));
11402 gdb_assert (annex
!= NULL
);
11403 gdb_assert (readbuf
!= NULL
);
11405 p2
= rs
->buf
.data ();
11407 *p2
++ = query_type
;
11409 /* We used one buffer char for the remote protocol q command and
11410 another for the query type. As the remote protocol encapsulation
11411 uses 4 chars plus one extra in case we are debugging
11412 (remote_debug), we have PBUFZIZ - 7 left to pack the query
11415 while (annex
[i
] && (i
< (get_remote_packet_size () - 8)))
11417 /* Bad caller may have sent forbidden characters. */
11418 gdb_assert (isprint (annex
[i
]) && annex
[i
] != '$' && annex
[i
] != '#');
11423 gdb_assert (annex
[i
] == '\0');
11425 i
= putpkt (rs
->buf
);
11427 return TARGET_XFER_E_IO
;
11429 getpkt (&rs
->buf
, 0);
11430 strcpy ((char *) readbuf
, rs
->buf
.data ());
11432 *xfered_len
= strlen ((char *) readbuf
);
11433 return (*xfered_len
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
11436 /* Implementation of to_get_memory_xfer_limit. */
11439 remote_target::get_memory_xfer_limit ()
11441 return get_memory_write_packet_size ();
11445 remote_target::search_memory (CORE_ADDR start_addr
, ULONGEST search_space_len
,
11446 const gdb_byte
*pattern
, ULONGEST pattern_len
,
11447 CORE_ADDR
*found_addrp
)
11449 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
11450 struct remote_state
*rs
= get_remote_state ();
11451 int max_size
= get_memory_write_packet_size ();
11452 struct packet_config
*packet
=
11453 &remote_protocol_packets
[PACKET_qSearch_memory
];
11454 /* Number of packet bytes used to encode the pattern;
11455 this could be more than PATTERN_LEN due to escape characters. */
11456 int escaped_pattern_len
;
11457 /* Amount of pattern that was encodable in the packet. */
11458 int used_pattern_len
;
11461 ULONGEST found_addr
;
11463 auto read_memory
= [=] (CORE_ADDR addr
, gdb_byte
*result
, size_t len
)
11465 return (target_read (this, TARGET_OBJECT_MEMORY
, NULL
, result
, addr
, len
)
11469 /* Don't go to the target if we don't have to. This is done before
11470 checking packet_config_support to avoid the possibility that a
11471 success for this edge case means the facility works in
11473 if (pattern_len
> search_space_len
)
11475 if (pattern_len
== 0)
11477 *found_addrp
= start_addr
;
11481 /* If we already know the packet isn't supported, fall back to the simple
11482 way of searching memory. */
11484 if (packet_config_support (packet
) == PACKET_DISABLE
)
11486 /* Target doesn't provided special support, fall back and use the
11487 standard support (copy memory and do the search here). */
11488 return simple_search_memory (read_memory
, start_addr
, search_space_len
,
11489 pattern
, pattern_len
, found_addrp
);
11492 /* Make sure the remote is pointing at the right process. */
11493 set_general_process ();
11495 /* Insert header. */
11496 i
= snprintf (rs
->buf
.data (), max_size
,
11497 "qSearch:memory:%s;%s;",
11498 phex_nz (start_addr
, addr_size
),
11499 phex_nz (search_space_len
, sizeof (search_space_len
)));
11500 max_size
-= (i
+ 1);
11502 /* Escape as much data as fits into rs->buf. */
11503 escaped_pattern_len
=
11504 remote_escape_output (pattern
, pattern_len
, 1,
11505 (gdb_byte
*) rs
->buf
.data () + i
,
11506 &used_pattern_len
, max_size
);
11508 /* Bail if the pattern is too large. */
11509 if (used_pattern_len
!= pattern_len
)
11510 error (_("Pattern is too large to transmit to remote target."));
11512 if (putpkt_binary (rs
->buf
.data (), i
+ escaped_pattern_len
) < 0
11513 || getpkt_sane (&rs
->buf
, 0) < 0
11514 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11516 /* The request may not have worked because the command is not
11517 supported. If so, fall back to the simple way. */
11518 if (packet_config_support (packet
) == PACKET_DISABLE
)
11520 return simple_search_memory (read_memory
, start_addr
, search_space_len
,
11521 pattern
, pattern_len
, found_addrp
);
11526 if (rs
->buf
[0] == '0')
11528 else if (rs
->buf
[0] == '1')
11531 if (rs
->buf
[1] != ',')
11532 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
.data ());
11533 unpack_varlen_hex (&rs
->buf
[2], &found_addr
);
11534 *found_addrp
= found_addr
;
11537 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
.data ());
11543 remote_target::rcmd (const char *command
, struct ui_file
*outbuf
)
11545 struct remote_state
*rs
= get_remote_state ();
11546 char *p
= rs
->buf
.data ();
11548 if (!rs
->remote_desc
)
11549 error (_("remote rcmd is only available after target open"));
11551 /* Send a NULL command across as an empty command. */
11552 if (command
== NULL
)
11555 /* The query prefix. */
11556 strcpy (rs
->buf
.data (), "qRcmd,");
11557 p
= strchr (rs
->buf
.data (), '\0');
11559 if ((strlen (rs
->buf
.data ()) + strlen (command
) * 2 + 8/*misc*/)
11560 > get_remote_packet_size ())
11561 error (_("\"monitor\" command ``%s'' is too long."), command
);
11563 /* Encode the actual command. */
11564 bin2hex ((const gdb_byte
*) command
, p
, strlen (command
));
11566 if (putpkt (rs
->buf
) < 0)
11567 error (_("Communication problem with target."));
11569 /* get/display the response */
11574 /* XXX - see also remote_get_noisy_reply(). */
11575 QUIT
; /* Allow user to bail out with ^C. */
11577 if (getpkt_sane (&rs
->buf
, 0) == -1)
11579 /* Timeout. Continue to (try to) read responses.
11580 This is better than stopping with an error, assuming the stub
11581 is still executing the (long) monitor command.
11582 If needed, the user can interrupt gdb using C-c, obtaining
11583 an effect similar to stop on timeout. */
11586 buf
= rs
->buf
.data ();
11587 if (buf
[0] == '\0')
11588 error (_("Target does not support this command."));
11589 if (buf
[0] == 'O' && buf
[1] != 'K')
11591 remote_console_output (buf
+ 1); /* 'O' message from stub. */
11594 if (strcmp (buf
, "OK") == 0)
11596 if (strlen (buf
) == 3 && buf
[0] == 'E'
11597 && isdigit (buf
[1]) && isdigit (buf
[2]))
11599 error (_("Protocol error with Rcmd"));
11601 for (p
= buf
; p
[0] != '\0' && p
[1] != '\0'; p
+= 2)
11603 char c
= (fromhex (p
[0]) << 4) + fromhex (p
[1]);
11605 fputc_unfiltered (c
, outbuf
);
11611 std::vector
<mem_region
>
11612 remote_target::memory_map ()
11614 std::vector
<mem_region
> result
;
11615 gdb::optional
<gdb::char_vector
> text
11616 = target_read_stralloc (current_inferior ()->top_target (),
11617 TARGET_OBJECT_MEMORY_MAP
, NULL
);
11620 result
= parse_memory_map (text
->data ());
11625 /* Set of callbacks used to implement the 'maint packet' command. */
11627 struct cli_packet_command_callbacks
: public send_remote_packet_callbacks
11629 /* Called before the packet is sent. BUF is the packet content before
11630 the protocol specific prefix, suffix, and escaping is added. */
11632 void sending (gdb::array_view
<const char> &buf
) override
11634 puts_filtered ("sending: ");
11635 print_packet (buf
);
11636 puts_filtered ("\n");
11639 /* Called with BUF, the reply from the remote target. */
11641 void received (gdb::array_view
<const char> &buf
) override
11643 puts_filtered ("received: \"");
11644 print_packet (buf
);
11645 puts_filtered ("\"\n");
11650 /* Print BUF o gdb_stdout. Any non-printable bytes in BUF are printed as
11651 '\x??' with '??' replaced by the hexadecimal value of the byte. */
11654 print_packet (gdb::array_view
<const char> &buf
)
11658 for (int i
= 0; i
< buf
.size (); ++i
)
11660 gdb_byte c
= buf
[i
];
11662 fputc_unfiltered (c
, &stb
);
11664 fprintf_unfiltered (&stb
, "\\x%02x", (unsigned char) c
);
11667 puts_filtered (stb
.string ().c_str ());
11671 /* See remote.h. */
11674 send_remote_packet (gdb::array_view
<const char> &buf
,
11675 send_remote_packet_callbacks
*callbacks
)
11677 if (buf
.size () == 0 || buf
.data ()[0] == '\0')
11678 error (_("a remote packet must not be empty"));
11680 remote_target
*remote
= get_current_remote_target ();
11681 if (remote
== nullptr)
11682 error (_("packets can only be sent to a remote target"));
11684 callbacks
->sending (buf
);
11686 remote
->putpkt_binary (buf
.data (), buf
.size ());
11687 remote_state
*rs
= remote
->get_remote_state ();
11688 int bytes
= remote
->getpkt_sane (&rs
->buf
, 0);
11691 error (_("error while fetching packet from remote target"));
11693 gdb::array_view
<const char> view (&rs
->buf
[0], bytes
);
11694 callbacks
->received (view
);
11697 /* Entry point for the 'maint packet' command. */
11700 cli_packet_command (const char *args
, int from_tty
)
11702 cli_packet_command_callbacks cb
;
11703 gdb::array_view
<const char> view
11704 = gdb::make_array_view (args
, args
== nullptr ? 0 : strlen (args
));
11705 send_remote_packet (view
, &cb
);
11709 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
11711 static void display_thread_info (struct gdb_ext_thread_info
*info
);
11713 static void threadset_test_cmd (char *cmd
, int tty
);
11715 static void threadalive_test (char *cmd
, int tty
);
11717 static void threadlist_test_cmd (char *cmd
, int tty
);
11719 int get_and_display_threadinfo (threadref
*ref
);
11721 static void threadinfo_test_cmd (char *cmd
, int tty
);
11723 static int thread_display_step (threadref
*ref
, void *context
);
11725 static void threadlist_update_test_cmd (char *cmd
, int tty
);
11727 static void init_remote_threadtests (void);
11729 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
11732 threadset_test_cmd (const char *cmd
, int tty
)
11734 int sample_thread
= SAMPLE_THREAD
;
11736 printf_filtered (_("Remote threadset test\n"));
11737 set_general_thread (sample_thread
);
11742 threadalive_test (const char *cmd
, int tty
)
11744 int sample_thread
= SAMPLE_THREAD
;
11745 int pid
= inferior_ptid
.pid ();
11746 ptid_t ptid
= ptid_t (pid
, sample_thread
, 0);
11748 if (remote_thread_alive (ptid
))
11749 printf_filtered ("PASS: Thread alive test\n");
11751 printf_filtered ("FAIL: Thread alive test\n");
11754 void output_threadid (char *title
, threadref
*ref
);
11757 output_threadid (char *title
, threadref
*ref
)
11761 pack_threadid (&hexid
[0], ref
); /* Convert thread id into hex. */
11763 printf_filtered ("%s %s\n", title
, (&hexid
[0]));
11767 threadlist_test_cmd (const char *cmd
, int tty
)
11770 threadref nextthread
;
11771 int done
, result_count
;
11772 threadref threadlist
[3];
11774 printf_filtered ("Remote Threadlist test\n");
11775 if (!remote_get_threadlist (startflag
, &nextthread
, 3, &done
,
11776 &result_count
, &threadlist
[0]))
11777 printf_filtered ("FAIL: threadlist test\n");
11780 threadref
*scan
= threadlist
;
11781 threadref
*limit
= scan
+ result_count
;
11783 while (scan
< limit
)
11784 output_threadid (" thread ", scan
++);
11789 display_thread_info (struct gdb_ext_thread_info
*info
)
11791 output_threadid ("Threadid: ", &info
->threadid
);
11792 printf_filtered ("Name: %s\n ", info
->shortname
);
11793 printf_filtered ("State: %s\n", info
->display
);
11794 printf_filtered ("other: %s\n\n", info
->more_display
);
11798 get_and_display_threadinfo (threadref
*ref
)
11802 struct gdb_ext_thread_info threadinfo
;
11804 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
11805 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
11806 if (0 != (result
= remote_get_threadinfo (ref
, set
, &threadinfo
)))
11807 display_thread_info (&threadinfo
);
11812 threadinfo_test_cmd (const char *cmd
, int tty
)
11814 int athread
= SAMPLE_THREAD
;
11818 int_to_threadref (&thread
, athread
);
11819 printf_filtered ("Remote Threadinfo test\n");
11820 if (!get_and_display_threadinfo (&thread
))
11821 printf_filtered ("FAIL cannot get thread info\n");
11825 thread_display_step (threadref
*ref
, void *context
)
11827 /* output_threadid(" threadstep ",ref); *//* simple test */
11828 return get_and_display_threadinfo (ref
);
11832 threadlist_update_test_cmd (const char *cmd
, int tty
)
11834 printf_filtered ("Remote Threadlist update test\n");
11835 remote_threadlist_iterator (thread_display_step
, 0, CRAZY_MAX_THREADS
);
11839 init_remote_threadtests (void)
11841 add_com ("tlist", class_obscure
, threadlist_test_cmd
,
11842 _("Fetch and print the remote list of "
11843 "thread identifiers, one pkt only."));
11844 add_com ("tinfo", class_obscure
, threadinfo_test_cmd
,
11845 _("Fetch and display info about one thread."));
11846 add_com ("tset", class_obscure
, threadset_test_cmd
,
11847 _("Test setting to a different thread."));
11848 add_com ("tupd", class_obscure
, threadlist_update_test_cmd
,
11849 _("Iterate through updating all remote thread info."));
11850 add_com ("talive", class_obscure
, threadalive_test
,
11851 _("Remote thread alive test."));
11856 /* Convert a thread ID to a string. */
11859 remote_target::pid_to_str (ptid_t ptid
)
11861 struct remote_state
*rs
= get_remote_state ();
11863 if (ptid
== null_ptid
)
11864 return normal_pid_to_str (ptid
);
11865 else if (ptid
.is_pid ())
11867 /* Printing an inferior target id. */
11869 /* When multi-process extensions are off, there's no way in the
11870 remote protocol to know the remote process id, if there's any
11871 at all. There's one exception --- when we're connected with
11872 target extended-remote, and we manually attached to a process
11873 with "attach PID". We don't record anywhere a flag that
11874 allows us to distinguish that case from the case of
11875 connecting with extended-remote and the stub already being
11876 attached to a process, and reporting yes to qAttached, hence
11877 no smart special casing here. */
11878 if (!remote_multi_process_p (rs
))
11879 return "Remote target";
11881 return normal_pid_to_str (ptid
);
11885 if (magic_null_ptid
== ptid
)
11886 return "Thread <main>";
11887 else if (remote_multi_process_p (rs
))
11888 if (ptid
.lwp () == 0)
11889 return normal_pid_to_str (ptid
);
11891 return string_printf ("Thread %d.%ld",
11892 ptid
.pid (), ptid
.lwp ());
11894 return string_printf ("Thread %ld", ptid
.lwp ());
11898 /* Get the address of the thread local variable in OBJFILE which is
11899 stored at OFFSET within the thread local storage for thread PTID. */
11902 remote_target::get_thread_local_address (ptid_t ptid
, CORE_ADDR lm
,
11905 if (packet_support (PACKET_qGetTLSAddr
) != PACKET_DISABLE
)
11907 struct remote_state
*rs
= get_remote_state ();
11908 char *p
= rs
->buf
.data ();
11909 char *endp
= p
+ get_remote_packet_size ();
11910 enum packet_result result
;
11912 strcpy (p
, "qGetTLSAddr:");
11914 p
= write_ptid (p
, endp
, ptid
);
11916 p
+= hexnumstr (p
, offset
);
11918 p
+= hexnumstr (p
, lm
);
11922 getpkt (&rs
->buf
, 0);
11923 result
= packet_ok (rs
->buf
,
11924 &remote_protocol_packets
[PACKET_qGetTLSAddr
]);
11925 if (result
== PACKET_OK
)
11929 unpack_varlen_hex (rs
->buf
.data (), &addr
);
11932 else if (result
== PACKET_UNKNOWN
)
11933 throw_error (TLS_GENERIC_ERROR
,
11934 _("Remote target doesn't support qGetTLSAddr packet"));
11936 throw_error (TLS_GENERIC_ERROR
,
11937 _("Remote target failed to process qGetTLSAddr request"));
11940 throw_error (TLS_GENERIC_ERROR
,
11941 _("TLS not supported or disabled on this target"));
11946 /* Provide thread local base, i.e. Thread Information Block address.
11947 Returns 1 if ptid is found and thread_local_base is non zero. */
11950 remote_target::get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
)
11952 if (packet_support (PACKET_qGetTIBAddr
) != PACKET_DISABLE
)
11954 struct remote_state
*rs
= get_remote_state ();
11955 char *p
= rs
->buf
.data ();
11956 char *endp
= p
+ get_remote_packet_size ();
11957 enum packet_result result
;
11959 strcpy (p
, "qGetTIBAddr:");
11961 p
= write_ptid (p
, endp
, ptid
);
11965 getpkt (&rs
->buf
, 0);
11966 result
= packet_ok (rs
->buf
,
11967 &remote_protocol_packets
[PACKET_qGetTIBAddr
]);
11968 if (result
== PACKET_OK
)
11971 unpack_varlen_hex (rs
->buf
.data (), &val
);
11973 *addr
= (CORE_ADDR
) val
;
11976 else if (result
== PACKET_UNKNOWN
)
11977 error (_("Remote target doesn't support qGetTIBAddr packet"));
11979 error (_("Remote target failed to process qGetTIBAddr request"));
11982 error (_("qGetTIBAddr not supported or disabled on this target"));
11987 /* Support for inferring a target description based on the current
11988 architecture and the size of a 'g' packet. While the 'g' packet
11989 can have any size (since optional registers can be left off the
11990 end), some sizes are easily recognizable given knowledge of the
11991 approximate architecture. */
11993 struct remote_g_packet_guess
11995 remote_g_packet_guess (int bytes_
, const struct target_desc
*tdesc_
)
12002 const struct target_desc
*tdesc
;
12005 struct remote_g_packet_data
: public allocate_on_obstack
12007 std::vector
<remote_g_packet_guess
> guesses
;
12010 static struct gdbarch_data
*remote_g_packet_data_handle
;
12013 remote_g_packet_data_init (struct obstack
*obstack
)
12015 return new (obstack
) remote_g_packet_data
;
12019 register_remote_g_packet_guess (struct gdbarch
*gdbarch
, int bytes
,
12020 const struct target_desc
*tdesc
)
12022 struct remote_g_packet_data
*data
12023 = ((struct remote_g_packet_data
*)
12024 gdbarch_data (gdbarch
, remote_g_packet_data_handle
));
12026 gdb_assert (tdesc
!= NULL
);
12028 for (const remote_g_packet_guess
&guess
: data
->guesses
)
12029 if (guess
.bytes
== bytes
)
12030 internal_error (__FILE__
, __LINE__
,
12031 _("Duplicate g packet description added for size %d"),
12034 data
->guesses
.emplace_back (bytes
, tdesc
);
12037 /* Return true if remote_read_description would do anything on this target
12038 and architecture, false otherwise. */
12041 remote_read_description_p (struct target_ops
*target
)
12043 struct remote_g_packet_data
*data
12044 = ((struct remote_g_packet_data
*)
12045 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
));
12047 return !data
->guesses
.empty ();
12050 const struct target_desc
*
12051 remote_target::read_description ()
12053 struct remote_g_packet_data
*data
12054 = ((struct remote_g_packet_data
*)
12055 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
));
12057 /* Do not try this during initial connection, when we do not know
12058 whether there is a running but stopped thread. */
12059 if (!target_has_execution () || inferior_ptid
== null_ptid
)
12060 return beneath ()->read_description ();
12062 if (!data
->guesses
.empty ())
12064 int bytes
= send_g_packet ();
12066 for (const remote_g_packet_guess
&guess
: data
->guesses
)
12067 if (guess
.bytes
== bytes
)
12068 return guess
.tdesc
;
12070 /* We discard the g packet. A minor optimization would be to
12071 hold on to it, and fill the register cache once we have selected
12072 an architecture, but it's too tricky to do safely. */
12075 return beneath ()->read_description ();
12078 /* Remote file transfer support. This is host-initiated I/O, not
12079 target-initiated; for target-initiated, see remote-fileio.c. */
12081 /* If *LEFT is at least the length of STRING, copy STRING to
12082 *BUFFER, update *BUFFER to point to the new end of the buffer, and
12083 decrease *LEFT. Otherwise raise an error. */
12086 remote_buffer_add_string (char **buffer
, int *left
, const char *string
)
12088 int len
= strlen (string
);
12091 error (_("Packet too long for target."));
12093 memcpy (*buffer
, string
, len
);
12097 /* NUL-terminate the buffer as a convenience, if there is
12103 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
12104 *BUFFER, update *BUFFER to point to the new end of the buffer, and
12105 decrease *LEFT. Otherwise raise an error. */
12108 remote_buffer_add_bytes (char **buffer
, int *left
, const gdb_byte
*bytes
,
12111 if (2 * len
> *left
)
12112 error (_("Packet too long for target."));
12114 bin2hex (bytes
, *buffer
, len
);
12115 *buffer
+= 2 * len
;
12118 /* NUL-terminate the buffer as a convenience, if there is
12124 /* If *LEFT is large enough, convert VALUE to hex and add it to
12125 *BUFFER, update *BUFFER to point to the new end of the buffer, and
12126 decrease *LEFT. Otherwise raise an error. */
12129 remote_buffer_add_int (char **buffer
, int *left
, ULONGEST value
)
12131 int len
= hexnumlen (value
);
12134 error (_("Packet too long for target."));
12136 hexnumstr (*buffer
, value
);
12140 /* NUL-terminate the buffer as a convenience, if there is
12146 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
12147 value, *REMOTE_ERRNO to the remote error number or zero if none
12148 was included, and *ATTACHMENT to point to the start of the annex
12149 if any. The length of the packet isn't needed here; there may
12150 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
12152 Return 0 if the packet could be parsed, -1 if it could not. If
12153 -1 is returned, the other variables may not be initialized. */
12156 remote_hostio_parse_result (const char *buffer
, int *retcode
,
12157 int *remote_errno
, const char **attachment
)
12162 *attachment
= NULL
;
12164 if (buffer
[0] != 'F')
12168 *retcode
= strtol (&buffer
[1], &p
, 16);
12169 if (errno
!= 0 || p
== &buffer
[1])
12172 /* Check for ",errno". */
12176 *remote_errno
= strtol (p
+ 1, &p2
, 16);
12177 if (errno
!= 0 || p
+ 1 == p2
)
12182 /* Check for ";attachment". If there is no attachment, the
12183 packet should end here. */
12186 *attachment
= p
+ 1;
12189 else if (*p
== '\0')
12195 /* Send a prepared I/O packet to the target and read its response.
12196 The prepared packet is in the global RS->BUF before this function
12197 is called, and the answer is there when we return.
12199 COMMAND_BYTES is the length of the request to send, which may include
12200 binary data. WHICH_PACKET is the packet configuration to check
12201 before attempting a packet. If an error occurs, *REMOTE_ERRNO
12202 is set to the error number and -1 is returned. Otherwise the value
12203 returned by the function is returned.
12205 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
12206 attachment is expected; an error will be reported if there's a
12207 mismatch. If one is found, *ATTACHMENT will be set to point into
12208 the packet buffer and *ATTACHMENT_LEN will be set to the
12209 attachment's length. */
12212 remote_target::remote_hostio_send_command (int command_bytes
, int which_packet
,
12213 int *remote_errno
, const char **attachment
,
12214 int *attachment_len
)
12216 struct remote_state
*rs
= get_remote_state ();
12217 int ret
, bytes_read
;
12218 const char *attachment_tmp
;
12220 if (packet_support (which_packet
) == PACKET_DISABLE
)
12222 *remote_errno
= FILEIO_ENOSYS
;
12226 putpkt_binary (rs
->buf
.data (), command_bytes
);
12227 bytes_read
= getpkt_sane (&rs
->buf
, 0);
12229 /* If it timed out, something is wrong. Don't try to parse the
12231 if (bytes_read
< 0)
12233 *remote_errno
= FILEIO_EINVAL
;
12237 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[which_packet
]))
12240 *remote_errno
= FILEIO_EINVAL
;
12242 case PACKET_UNKNOWN
:
12243 *remote_errno
= FILEIO_ENOSYS
;
12249 if (remote_hostio_parse_result (rs
->buf
.data (), &ret
, remote_errno
,
12252 *remote_errno
= FILEIO_EINVAL
;
12256 /* Make sure we saw an attachment if and only if we expected one. */
12257 if ((attachment_tmp
== NULL
&& attachment
!= NULL
)
12258 || (attachment_tmp
!= NULL
&& attachment
== NULL
))
12260 *remote_errno
= FILEIO_EINVAL
;
12264 /* If an attachment was found, it must point into the packet buffer;
12265 work out how many bytes there were. */
12266 if (attachment_tmp
!= NULL
)
12268 *attachment
= attachment_tmp
;
12269 *attachment_len
= bytes_read
- (*attachment
- rs
->buf
.data ());
12275 /* See declaration.h. */
12278 readahead_cache::invalidate ()
12283 /* See declaration.h. */
12286 readahead_cache::invalidate_fd (int fd
)
12288 if (this->fd
== fd
)
12292 /* Set the filesystem remote_hostio functions that take FILENAME
12293 arguments will use. Return 0 on success, or -1 if an error
12294 occurs (and set *REMOTE_ERRNO). */
12297 remote_target::remote_hostio_set_filesystem (struct inferior
*inf
,
12300 struct remote_state
*rs
= get_remote_state ();
12301 int required_pid
= (inf
== NULL
|| inf
->fake_pid_p
) ? 0 : inf
->pid
;
12302 char *p
= rs
->buf
.data ();
12303 int left
= get_remote_packet_size () - 1;
12307 if (packet_support (PACKET_vFile_setfs
) == PACKET_DISABLE
)
12310 if (rs
->fs_pid
!= -1 && required_pid
== rs
->fs_pid
)
12313 remote_buffer_add_string (&p
, &left
, "vFile:setfs:");
12315 xsnprintf (arg
, sizeof (arg
), "%x", required_pid
);
12316 remote_buffer_add_string (&p
, &left
, arg
);
12318 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_setfs
,
12319 remote_errno
, NULL
, NULL
);
12321 if (packet_support (PACKET_vFile_setfs
) == PACKET_DISABLE
)
12325 rs
->fs_pid
= required_pid
;
12330 /* Implementation of to_fileio_open. */
12333 remote_target::remote_hostio_open (inferior
*inf
, const char *filename
,
12334 int flags
, int mode
, int warn_if_slow
,
12337 struct remote_state
*rs
= get_remote_state ();
12338 char *p
= rs
->buf
.data ();
12339 int left
= get_remote_packet_size () - 1;
12343 static int warning_issued
= 0;
12345 printf_unfiltered (_("Reading %s from remote target...\n"),
12348 if (!warning_issued
)
12350 warning (_("File transfers from remote targets can be slow."
12351 " Use \"set sysroot\" to access files locally"
12353 warning_issued
= 1;
12357 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12360 remote_buffer_add_string (&p
, &left
, "vFile:open:");
12362 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12363 strlen (filename
));
12364 remote_buffer_add_string (&p
, &left
, ",");
12366 remote_buffer_add_int (&p
, &left
, flags
);
12367 remote_buffer_add_string (&p
, &left
, ",");
12369 remote_buffer_add_int (&p
, &left
, mode
);
12371 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_open
,
12372 remote_errno
, NULL
, NULL
);
12376 remote_target::fileio_open (struct inferior
*inf
, const char *filename
,
12377 int flags
, int mode
, int warn_if_slow
,
12380 return remote_hostio_open (inf
, filename
, flags
, mode
, warn_if_slow
,
12384 /* Implementation of to_fileio_pwrite. */
12387 remote_target::remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
12388 ULONGEST offset
, int *remote_errno
)
12390 struct remote_state
*rs
= get_remote_state ();
12391 char *p
= rs
->buf
.data ();
12392 int left
= get_remote_packet_size ();
12395 rs
->readahead_cache
.invalidate_fd (fd
);
12397 remote_buffer_add_string (&p
, &left
, "vFile:pwrite:");
12399 remote_buffer_add_int (&p
, &left
, fd
);
12400 remote_buffer_add_string (&p
, &left
, ",");
12402 remote_buffer_add_int (&p
, &left
, offset
);
12403 remote_buffer_add_string (&p
, &left
, ",");
12405 p
+= remote_escape_output (write_buf
, len
, 1, (gdb_byte
*) p
, &out_len
,
12406 (get_remote_packet_size ()
12407 - (p
- rs
->buf
.data ())));
12409 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_pwrite
,
12410 remote_errno
, NULL
, NULL
);
12414 remote_target::fileio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
12415 ULONGEST offset
, int *remote_errno
)
12417 return remote_hostio_pwrite (fd
, write_buf
, len
, offset
, remote_errno
);
12420 /* Helper for the implementation of to_fileio_pread. Read the file
12421 from the remote side with vFile:pread. */
12424 remote_target::remote_hostio_pread_vFile (int fd
, gdb_byte
*read_buf
, int len
,
12425 ULONGEST offset
, int *remote_errno
)
12427 struct remote_state
*rs
= get_remote_state ();
12428 char *p
= rs
->buf
.data ();
12429 const char *attachment
;
12430 int left
= get_remote_packet_size ();
12431 int ret
, attachment_len
;
12434 remote_buffer_add_string (&p
, &left
, "vFile:pread:");
12436 remote_buffer_add_int (&p
, &left
, fd
);
12437 remote_buffer_add_string (&p
, &left
, ",");
12439 remote_buffer_add_int (&p
, &left
, len
);
12440 remote_buffer_add_string (&p
, &left
, ",");
12442 remote_buffer_add_int (&p
, &left
, offset
);
12444 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_pread
,
12445 remote_errno
, &attachment
,
12451 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12453 if (read_len
!= ret
)
12454 error (_("Read returned %d, but %d bytes."), ret
, (int) read_len
);
12459 /* See declaration.h. */
12462 readahead_cache::pread (int fd
, gdb_byte
*read_buf
, size_t len
,
12466 && this->offset
<= offset
12467 && offset
< this->offset
+ this->bufsize
)
12469 ULONGEST max
= this->offset
+ this->bufsize
;
12471 if (offset
+ len
> max
)
12472 len
= max
- offset
;
12474 memcpy (read_buf
, this->buf
+ offset
- this->offset
, len
);
12481 /* Implementation of to_fileio_pread. */
12484 remote_target::remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
12485 ULONGEST offset
, int *remote_errno
)
12488 struct remote_state
*rs
= get_remote_state ();
12489 readahead_cache
*cache
= &rs
->readahead_cache
;
12491 ret
= cache
->pread (fd
, read_buf
, len
, offset
);
12494 cache
->hit_count
++;
12496 remote_debug_printf ("readahead cache hit %s",
12497 pulongest (cache
->hit_count
));
12501 cache
->miss_count
++;
12503 remote_debug_printf ("readahead cache miss %s",
12504 pulongest (cache
->miss_count
));
12507 cache
->offset
= offset
;
12508 cache
->bufsize
= get_remote_packet_size ();
12509 cache
->buf
= (gdb_byte
*) xrealloc (cache
->buf
, cache
->bufsize
);
12511 ret
= remote_hostio_pread_vFile (cache
->fd
, cache
->buf
, cache
->bufsize
,
12512 cache
->offset
, remote_errno
);
12515 cache
->invalidate_fd (fd
);
12519 cache
->bufsize
= ret
;
12520 return cache
->pread (fd
, read_buf
, len
, offset
);
12524 remote_target::fileio_pread (int fd
, gdb_byte
*read_buf
, int len
,
12525 ULONGEST offset
, int *remote_errno
)
12527 return remote_hostio_pread (fd
, read_buf
, len
, offset
, remote_errno
);
12530 /* Implementation of to_fileio_close. */
12533 remote_target::remote_hostio_close (int fd
, int *remote_errno
)
12535 struct remote_state
*rs
= get_remote_state ();
12536 char *p
= rs
->buf
.data ();
12537 int left
= get_remote_packet_size () - 1;
12539 rs
->readahead_cache
.invalidate_fd (fd
);
12541 remote_buffer_add_string (&p
, &left
, "vFile:close:");
12543 remote_buffer_add_int (&p
, &left
, fd
);
12545 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_close
,
12546 remote_errno
, NULL
, NULL
);
12550 remote_target::fileio_close (int fd
, int *remote_errno
)
12552 return remote_hostio_close (fd
, remote_errno
);
12555 /* Implementation of to_fileio_unlink. */
12558 remote_target::remote_hostio_unlink (inferior
*inf
, const char *filename
,
12561 struct remote_state
*rs
= get_remote_state ();
12562 char *p
= rs
->buf
.data ();
12563 int left
= get_remote_packet_size () - 1;
12565 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12568 remote_buffer_add_string (&p
, &left
, "vFile:unlink:");
12570 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12571 strlen (filename
));
12573 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_unlink
,
12574 remote_errno
, NULL
, NULL
);
12578 remote_target::fileio_unlink (struct inferior
*inf
, const char *filename
,
12581 return remote_hostio_unlink (inf
, filename
, remote_errno
);
12584 /* Implementation of to_fileio_readlink. */
12586 gdb::optional
<std::string
>
12587 remote_target::fileio_readlink (struct inferior
*inf
, const char *filename
,
12590 struct remote_state
*rs
= get_remote_state ();
12591 char *p
= rs
->buf
.data ();
12592 const char *attachment
;
12593 int left
= get_remote_packet_size ();
12594 int len
, attachment_len
;
12597 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12600 remote_buffer_add_string (&p
, &left
, "vFile:readlink:");
12602 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12603 strlen (filename
));
12605 len
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_readlink
,
12606 remote_errno
, &attachment
,
12612 std::string
ret (len
, '\0');
12614 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12615 (gdb_byte
*) &ret
[0], len
);
12616 if (read_len
!= len
)
12617 error (_("Readlink returned %d, but %d bytes."), len
, read_len
);
12622 /* Implementation of to_fileio_fstat. */
12625 remote_target::fileio_fstat (int fd
, struct stat
*st
, int *remote_errno
)
12627 struct remote_state
*rs
= get_remote_state ();
12628 char *p
= rs
->buf
.data ();
12629 int left
= get_remote_packet_size ();
12630 int attachment_len
, ret
;
12631 const char *attachment
;
12632 struct fio_stat fst
;
12635 remote_buffer_add_string (&p
, &left
, "vFile:fstat:");
12637 remote_buffer_add_int (&p
, &left
, fd
);
12639 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_fstat
,
12640 remote_errno
, &attachment
,
12644 if (*remote_errno
!= FILEIO_ENOSYS
)
12647 /* Strictly we should return -1, ENOSYS here, but when
12648 "set sysroot remote:" was implemented in August 2008
12649 BFD's need for a stat function was sidestepped with
12650 this hack. This was not remedied until March 2015
12651 so we retain the previous behavior to avoid breaking
12654 Note that the memset is a March 2015 addition; older
12655 GDBs set st_size *and nothing else* so the structure
12656 would have garbage in all other fields. This might
12657 break something but retaining the previous behavior
12658 here would be just too wrong. */
12660 memset (st
, 0, sizeof (struct stat
));
12661 st
->st_size
= INT_MAX
;
12665 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12666 (gdb_byte
*) &fst
, sizeof (fst
));
12668 if (read_len
!= ret
)
12669 error (_("vFile:fstat returned %d, but %d bytes."), ret
, read_len
);
12671 if (read_len
!= sizeof (fst
))
12672 error (_("vFile:fstat returned %d bytes, but expecting %d."),
12673 read_len
, (int) sizeof (fst
));
12675 remote_fileio_to_host_stat (&fst
, st
);
12680 /* Implementation of to_filesystem_is_local. */
12683 remote_target::filesystem_is_local ()
12685 /* Valgrind GDB presents itself as a remote target but works
12686 on the local filesystem: it does not implement remote get
12687 and users are not expected to set a sysroot. To handle
12688 this case we treat the remote filesystem as local if the
12689 sysroot is exactly TARGET_SYSROOT_PREFIX and if the stub
12690 does not support vFile:open. */
12691 if (gdb_sysroot
== TARGET_SYSROOT_PREFIX
)
12693 enum packet_support ps
= packet_support (PACKET_vFile_open
);
12695 if (ps
== PACKET_SUPPORT_UNKNOWN
)
12697 int fd
, remote_errno
;
12699 /* Try opening a file to probe support. The supplied
12700 filename is irrelevant, we only care about whether
12701 the stub recognizes the packet or not. */
12702 fd
= remote_hostio_open (NULL
, "just probing",
12703 FILEIO_O_RDONLY
, 0700, 0,
12707 remote_hostio_close (fd
, &remote_errno
);
12709 ps
= packet_support (PACKET_vFile_open
);
12712 if (ps
== PACKET_DISABLE
)
12714 static int warning_issued
= 0;
12716 if (!warning_issued
)
12718 warning (_("remote target does not support file"
12719 " transfer, attempting to access files"
12720 " from local filesystem."));
12721 warning_issued
= 1;
12732 remote_fileio_errno_to_host (int errnum
)
12738 case FILEIO_ENOENT
:
12746 case FILEIO_EACCES
:
12748 case FILEIO_EFAULT
:
12752 case FILEIO_EEXIST
:
12754 case FILEIO_ENODEV
:
12756 case FILEIO_ENOTDIR
:
12758 case FILEIO_EISDIR
:
12760 case FILEIO_EINVAL
:
12762 case FILEIO_ENFILE
:
12764 case FILEIO_EMFILE
:
12768 case FILEIO_ENOSPC
:
12770 case FILEIO_ESPIPE
:
12774 case FILEIO_ENOSYS
:
12776 case FILEIO_ENAMETOOLONG
:
12777 return ENAMETOOLONG
;
12783 remote_hostio_error (int errnum
)
12785 int host_error
= remote_fileio_errno_to_host (errnum
);
12787 if (host_error
== -1)
12788 error (_("Unknown remote I/O error %d"), errnum
);
12790 error (_("Remote I/O error: %s"), safe_strerror (host_error
));
12793 /* A RAII wrapper around a remote file descriptor. */
12795 class scoped_remote_fd
12798 scoped_remote_fd (remote_target
*remote
, int fd
)
12799 : m_remote (remote
), m_fd (fd
)
12803 ~scoped_remote_fd ()
12810 m_remote
->remote_hostio_close (m_fd
, &remote_errno
);
12814 /* Swallow exception before it escapes the dtor. If
12815 something goes wrong, likely the connection is gone,
12816 and there's nothing else that can be done. */
12821 DISABLE_COPY_AND_ASSIGN (scoped_remote_fd
);
12823 /* Release ownership of the file descriptor, and return it. */
12824 ATTRIBUTE_UNUSED_RESULT
int release () noexcept
12831 /* Return the owned file descriptor. */
12832 int get () const noexcept
12838 /* The remote target. */
12839 remote_target
*m_remote
;
12841 /* The owned remote I/O file descriptor. */
12846 remote_file_put (const char *local_file
, const char *remote_file
, int from_tty
)
12848 remote_target
*remote
= get_current_remote_target ();
12850 if (remote
== nullptr)
12851 error (_("command can only be used with remote target"));
12853 remote
->remote_file_put (local_file
, remote_file
, from_tty
);
12857 remote_target::remote_file_put (const char *local_file
, const char *remote_file
,
12860 int retcode
, remote_errno
, bytes
, io_size
;
12861 int bytes_in_buffer
;
12865 gdb_file_up file
= gdb_fopen_cloexec (local_file
, "rb");
12867 perror_with_name (local_file
);
12869 scoped_remote_fd fd
12870 (this, remote_hostio_open (NULL
,
12871 remote_file
, (FILEIO_O_WRONLY
| FILEIO_O_CREAT
12873 0700, 0, &remote_errno
));
12874 if (fd
.get () == -1)
12875 remote_hostio_error (remote_errno
);
12877 /* Send up to this many bytes at once. They won't all fit in the
12878 remote packet limit, so we'll transfer slightly fewer. */
12879 io_size
= get_remote_packet_size ();
12880 gdb::byte_vector
buffer (io_size
);
12882 bytes_in_buffer
= 0;
12885 while (bytes_in_buffer
|| !saw_eof
)
12889 bytes
= fread (buffer
.data () + bytes_in_buffer
, 1,
12890 io_size
- bytes_in_buffer
,
12894 if (ferror (file
.get ()))
12895 error (_("Error reading %s."), local_file
);
12898 /* EOF. Unless there is something still in the
12899 buffer from the last iteration, we are done. */
12901 if (bytes_in_buffer
== 0)
12909 bytes
+= bytes_in_buffer
;
12910 bytes_in_buffer
= 0;
12912 retcode
= remote_hostio_pwrite (fd
.get (), buffer
.data (), bytes
,
12913 offset
, &remote_errno
);
12916 remote_hostio_error (remote_errno
);
12917 else if (retcode
== 0)
12918 error (_("Remote write of %d bytes returned 0!"), bytes
);
12919 else if (retcode
< bytes
)
12921 /* Short write. Save the rest of the read data for the next
12923 bytes_in_buffer
= bytes
- retcode
;
12924 memmove (buffer
.data (), buffer
.data () + retcode
, bytes_in_buffer
);
12930 if (remote_hostio_close (fd
.release (), &remote_errno
))
12931 remote_hostio_error (remote_errno
);
12934 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file
);
12938 remote_file_get (const char *remote_file
, const char *local_file
, int from_tty
)
12940 remote_target
*remote
= get_current_remote_target ();
12942 if (remote
== nullptr)
12943 error (_("command can only be used with remote target"));
12945 remote
->remote_file_get (remote_file
, local_file
, from_tty
);
12949 remote_target::remote_file_get (const char *remote_file
, const char *local_file
,
12952 int remote_errno
, bytes
, io_size
;
12955 scoped_remote_fd fd
12956 (this, remote_hostio_open (NULL
,
12957 remote_file
, FILEIO_O_RDONLY
, 0, 0,
12959 if (fd
.get () == -1)
12960 remote_hostio_error (remote_errno
);
12962 gdb_file_up file
= gdb_fopen_cloexec (local_file
, "wb");
12964 perror_with_name (local_file
);
12966 /* Send up to this many bytes at once. They won't all fit in the
12967 remote packet limit, so we'll transfer slightly fewer. */
12968 io_size
= get_remote_packet_size ();
12969 gdb::byte_vector
buffer (io_size
);
12974 bytes
= remote_hostio_pread (fd
.get (), buffer
.data (), io_size
, offset
,
12977 /* Success, but no bytes, means end-of-file. */
12980 remote_hostio_error (remote_errno
);
12984 bytes
= fwrite (buffer
.data (), 1, bytes
, file
.get ());
12986 perror_with_name (local_file
);
12989 if (remote_hostio_close (fd
.release (), &remote_errno
))
12990 remote_hostio_error (remote_errno
);
12993 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file
);
12997 remote_file_delete (const char *remote_file
, int from_tty
)
12999 remote_target
*remote
= get_current_remote_target ();
13001 if (remote
== nullptr)
13002 error (_("command can only be used with remote target"));
13004 remote
->remote_file_delete (remote_file
, from_tty
);
13008 remote_target::remote_file_delete (const char *remote_file
, int from_tty
)
13010 int retcode
, remote_errno
;
13012 retcode
= remote_hostio_unlink (NULL
, remote_file
, &remote_errno
);
13014 remote_hostio_error (remote_errno
);
13017 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file
);
13021 remote_put_command (const char *args
, int from_tty
)
13024 error_no_arg (_("file to put"));
13026 gdb_argv
argv (args
);
13027 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
13028 error (_("Invalid parameters to remote put"));
13030 remote_file_put (argv
[0], argv
[1], from_tty
);
13034 remote_get_command (const char *args
, int from_tty
)
13037 error_no_arg (_("file to get"));
13039 gdb_argv
argv (args
);
13040 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
13041 error (_("Invalid parameters to remote get"));
13043 remote_file_get (argv
[0], argv
[1], from_tty
);
13047 remote_delete_command (const char *args
, int from_tty
)
13050 error_no_arg (_("file to delete"));
13052 gdb_argv
argv (args
);
13053 if (argv
[0] == NULL
|| argv
[1] != NULL
)
13054 error (_("Invalid parameters to remote delete"));
13056 remote_file_delete (argv
[0], from_tty
);
13060 remote_target::can_execute_reverse ()
13062 if (packet_support (PACKET_bs
) == PACKET_ENABLE
13063 || packet_support (PACKET_bc
) == PACKET_ENABLE
)
13070 remote_target::supports_non_stop ()
13076 remote_target::supports_disable_randomization ()
13078 /* Only supported in extended mode. */
13083 remote_target::supports_multi_process ()
13085 struct remote_state
*rs
= get_remote_state ();
13087 return remote_multi_process_p (rs
);
13091 remote_supports_cond_tracepoints ()
13093 return packet_support (PACKET_ConditionalTracepoints
) == PACKET_ENABLE
;
13097 remote_target::supports_evaluation_of_breakpoint_conditions ()
13099 return packet_support (PACKET_ConditionalBreakpoints
) == PACKET_ENABLE
;
13103 remote_supports_fast_tracepoints ()
13105 return packet_support (PACKET_FastTracepoints
) == PACKET_ENABLE
;
13109 remote_supports_static_tracepoints ()
13111 return packet_support (PACKET_StaticTracepoints
) == PACKET_ENABLE
;
13115 remote_supports_install_in_trace ()
13117 return packet_support (PACKET_InstallInTrace
) == PACKET_ENABLE
;
13121 remote_target::supports_enable_disable_tracepoint ()
13123 return (packet_support (PACKET_EnableDisableTracepoints_feature
)
13128 remote_target::supports_string_tracing ()
13130 return packet_support (PACKET_tracenz_feature
) == PACKET_ENABLE
;
13134 remote_target::can_run_breakpoint_commands ()
13136 return packet_support (PACKET_BreakpointCommands
) == PACKET_ENABLE
;
13140 remote_target::trace_init ()
13142 struct remote_state
*rs
= get_remote_state ();
13145 remote_get_noisy_reply ();
13146 if (strcmp (rs
->buf
.data (), "OK") != 0)
13147 error (_("Target does not support this command."));
13150 /* Recursive routine to walk through command list including loops, and
13151 download packets for each command. */
13154 remote_target::remote_download_command_source (int num
, ULONGEST addr
,
13155 struct command_line
*cmds
)
13157 struct remote_state
*rs
= get_remote_state ();
13158 struct command_line
*cmd
;
13160 for (cmd
= cmds
; cmd
; cmd
= cmd
->next
)
13162 QUIT
; /* Allow user to bail out with ^C. */
13163 strcpy (rs
->buf
.data (), "QTDPsrc:");
13164 encode_source_string (num
, addr
, "cmd", cmd
->line
,
13165 rs
->buf
.data () + strlen (rs
->buf
.data ()),
13166 rs
->buf
.size () - strlen (rs
->buf
.data ()));
13168 remote_get_noisy_reply ();
13169 if (strcmp (rs
->buf
.data (), "OK"))
13170 warning (_("Target does not support source download."));
13172 if (cmd
->control_type
== while_control
13173 || cmd
->control_type
== while_stepping_control
)
13175 remote_download_command_source (num
, addr
, cmd
->body_list_0
.get ());
13177 QUIT
; /* Allow user to bail out with ^C. */
13178 strcpy (rs
->buf
.data (), "QTDPsrc:");
13179 encode_source_string (num
, addr
, "cmd", "end",
13180 rs
->buf
.data () + strlen (rs
->buf
.data ()),
13181 rs
->buf
.size () - strlen (rs
->buf
.data ()));
13183 remote_get_noisy_reply ();
13184 if (strcmp (rs
->buf
.data (), "OK"))
13185 warning (_("Target does not support source download."));
13191 remote_target::download_tracepoint (struct bp_location
*loc
)
13195 std::vector
<std::string
> tdp_actions
;
13196 std::vector
<std::string
> stepping_actions
;
13198 struct breakpoint
*b
= loc
->owner
;
13199 struct tracepoint
*t
= (struct tracepoint
*) b
;
13200 struct remote_state
*rs
= get_remote_state ();
13202 const char *err_msg
= _("Tracepoint packet too large for target.");
13205 /* We use a buffer other than rs->buf because we'll build strings
13206 across multiple statements, and other statements in between could
13208 gdb::char_vector
buf (get_remote_packet_size ());
13210 encode_actions_rsp (loc
, &tdp_actions
, &stepping_actions
);
13212 tpaddr
= loc
->address
;
13213 strcpy (addrbuf
, phex (tpaddr
, sizeof (CORE_ADDR
)));
13214 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:%x:%s:%c:%lx:%x",
13215 b
->number
, addrbuf
, /* address */
13216 (b
->enable_state
== bp_enabled
? 'E' : 'D'),
13217 t
->step_count
, t
->pass_count
);
13219 if (ret
< 0 || ret
>= buf
.size ())
13220 error ("%s", err_msg
);
13222 /* Fast tracepoints are mostly handled by the target, but we can
13223 tell the target how big of an instruction block should be moved
13225 if (b
->type
== bp_fast_tracepoint
)
13227 /* Only test for support at download time; we may not know
13228 target capabilities at definition time. */
13229 if (remote_supports_fast_tracepoints ())
13231 if (gdbarch_fast_tracepoint_valid_at (loc
->gdbarch
, tpaddr
,
13234 size_left
= buf
.size () - strlen (buf
.data ());
13235 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13237 gdb_insn_length (loc
->gdbarch
, tpaddr
));
13239 if (ret
< 0 || ret
>= size_left
)
13240 error ("%s", err_msg
);
13243 /* If it passed validation at definition but fails now,
13244 something is very wrong. */
13245 internal_error (__FILE__
, __LINE__
,
13246 _("Fast tracepoint not "
13247 "valid during download"));
13250 /* Fast tracepoints are functionally identical to regular
13251 tracepoints, so don't take lack of support as a reason to
13252 give up on the trace run. */
13253 warning (_("Target does not support fast tracepoints, "
13254 "downloading %d as regular tracepoint"), b
->number
);
13256 else if (b
->type
== bp_static_tracepoint
)
13258 /* Only test for support at download time; we may not know
13259 target capabilities at definition time. */
13260 if (remote_supports_static_tracepoints ())
13262 struct static_tracepoint_marker marker
;
13264 if (target_static_tracepoint_marker_at (tpaddr
, &marker
))
13266 size_left
= buf
.size () - strlen (buf
.data ());
13267 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13270 if (ret
< 0 || ret
>= size_left
)
13271 error ("%s", err_msg
);
13274 error (_("Static tracepoint not valid during download"));
13277 /* Fast tracepoints are functionally identical to regular
13278 tracepoints, so don't take lack of support as a reason
13279 to give up on the trace run. */
13280 error (_("Target does not support static tracepoints"));
13282 /* If the tracepoint has a conditional, make it into an agent
13283 expression and append to the definition. */
13286 /* Only test support at download time, we may not know target
13287 capabilities at definition time. */
13288 if (remote_supports_cond_tracepoints ())
13290 agent_expr_up aexpr
= gen_eval_for_expr (tpaddr
,
13293 size_left
= buf
.size () - strlen (buf
.data ());
13295 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13296 size_left
, ":X%x,", aexpr
->len
);
13298 if (ret
< 0 || ret
>= size_left
)
13299 error ("%s", err_msg
);
13301 size_left
= buf
.size () - strlen (buf
.data ());
13303 /* Two bytes to encode each aexpr byte, plus the terminating
13305 if (aexpr
->len
* 2 + 1 > size_left
)
13306 error ("%s", err_msg
);
13308 pkt
= buf
.data () + strlen (buf
.data ());
13310 for (int ndx
= 0; ndx
< aexpr
->len
; ++ndx
)
13311 pkt
= pack_hex_byte (pkt
, aexpr
->buf
[ndx
]);
13315 warning (_("Target does not support conditional tracepoints, "
13316 "ignoring tp %d cond"), b
->number
);
13319 if (b
->commands
|| !default_collect
.empty ())
13321 size_left
= buf
.size () - strlen (buf
.data ());
13323 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13326 if (ret
< 0 || ret
>= size_left
)
13327 error ("%s", err_msg
);
13330 putpkt (buf
.data ());
13331 remote_get_noisy_reply ();
13332 if (strcmp (rs
->buf
.data (), "OK"))
13333 error (_("Target does not support tracepoints."));
13335 /* do_single_steps (t); */
13336 for (auto action_it
= tdp_actions
.begin ();
13337 action_it
!= tdp_actions
.end (); action_it
++)
13339 QUIT
; /* Allow user to bail out with ^C. */
13341 bool has_more
= ((action_it
+ 1) != tdp_actions
.end ()
13342 || !stepping_actions
.empty ());
13344 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:-%x:%s:%s%c",
13345 b
->number
, addrbuf
, /* address */
13346 action_it
->c_str (),
13347 has_more
? '-' : 0);
13349 if (ret
< 0 || ret
>= buf
.size ())
13350 error ("%s", err_msg
);
13352 putpkt (buf
.data ());
13353 remote_get_noisy_reply ();
13354 if (strcmp (rs
->buf
.data (), "OK"))
13355 error (_("Error on target while setting tracepoints."));
13358 for (auto action_it
= stepping_actions
.begin ();
13359 action_it
!= stepping_actions
.end (); action_it
++)
13361 QUIT
; /* Allow user to bail out with ^C. */
13363 bool is_first
= action_it
== stepping_actions
.begin ();
13364 bool has_more
= (action_it
+ 1) != stepping_actions
.end ();
13366 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:-%x:%s:%s%s%s",
13367 b
->number
, addrbuf
, /* address */
13368 is_first
? "S" : "",
13369 action_it
->c_str (),
13370 has_more
? "-" : "");
13372 if (ret
< 0 || ret
>= buf
.size ())
13373 error ("%s", err_msg
);
13375 putpkt (buf
.data ());
13376 remote_get_noisy_reply ();
13377 if (strcmp (rs
->buf
.data (), "OK"))
13378 error (_("Error on target while setting tracepoints."));
13381 if (packet_support (PACKET_TracepointSource
) == PACKET_ENABLE
)
13383 if (b
->location
!= NULL
)
13385 ret
= snprintf (buf
.data (), buf
.size (), "QTDPsrc:");
13387 if (ret
< 0 || ret
>= buf
.size ())
13388 error ("%s", err_msg
);
13390 encode_source_string (b
->number
, loc
->address
, "at",
13391 event_location_to_string (b
->location
.get ()),
13392 buf
.data () + strlen (buf
.data ()),
13393 buf
.size () - strlen (buf
.data ()));
13394 putpkt (buf
.data ());
13395 remote_get_noisy_reply ();
13396 if (strcmp (rs
->buf
.data (), "OK"))
13397 warning (_("Target does not support source download."));
13399 if (b
->cond_string
)
13401 ret
= snprintf (buf
.data (), buf
.size (), "QTDPsrc:");
13403 if (ret
< 0 || ret
>= buf
.size ())
13404 error ("%s", err_msg
);
13406 encode_source_string (b
->number
, loc
->address
,
13407 "cond", b
->cond_string
.get (),
13408 buf
.data () + strlen (buf
.data ()),
13409 buf
.size () - strlen (buf
.data ()));
13410 putpkt (buf
.data ());
13411 remote_get_noisy_reply ();
13412 if (strcmp (rs
->buf
.data (), "OK"))
13413 warning (_("Target does not support source download."));
13415 remote_download_command_source (b
->number
, loc
->address
,
13416 breakpoint_commands (b
));
13421 remote_target::can_download_tracepoint ()
13423 struct remote_state
*rs
= get_remote_state ();
13424 struct trace_status
*ts
;
13427 /* Don't try to install tracepoints until we've relocated our
13428 symbols, and fetched and merged the target's tracepoint list with
13430 if (rs
->starting_up
)
13433 ts
= current_trace_status ();
13434 status
= get_trace_status (ts
);
13436 if (status
== -1 || !ts
->running_known
|| !ts
->running
)
13439 /* If we are in a tracing experiment, but remote stub doesn't support
13440 installing tracepoint in trace, we have to return. */
13441 if (!remote_supports_install_in_trace ())
13449 remote_target::download_trace_state_variable (const trace_state_variable
&tsv
)
13451 struct remote_state
*rs
= get_remote_state ();
13454 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTDV:%x:%s:%x:",
13455 tsv
.number
, phex ((ULONGEST
) tsv
.initial_value
, 8),
13457 p
= rs
->buf
.data () + strlen (rs
->buf
.data ());
13458 if ((p
- rs
->buf
.data ()) + tsv
.name
.length () * 2
13459 >= get_remote_packet_size ())
13460 error (_("Trace state variable name too long for tsv definition packet"));
13461 p
+= 2 * bin2hex ((gdb_byte
*) (tsv
.name
.data ()), p
, tsv
.name
.length ());
13464 remote_get_noisy_reply ();
13465 if (rs
->buf
[0] == '\0')
13466 error (_("Target does not support this command."));
13467 if (strcmp (rs
->buf
.data (), "OK") != 0)
13468 error (_("Error on target while downloading trace state variable."));
13472 remote_target::enable_tracepoint (struct bp_location
*location
)
13474 struct remote_state
*rs
= get_remote_state ();
13476 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTEnable:%x:%s",
13477 location
->owner
->number
,
13478 phex (location
->address
, sizeof (CORE_ADDR
)));
13480 remote_get_noisy_reply ();
13481 if (rs
->buf
[0] == '\0')
13482 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
13483 if (strcmp (rs
->buf
.data (), "OK") != 0)
13484 error (_("Error on target while enabling tracepoint."));
13488 remote_target::disable_tracepoint (struct bp_location
*location
)
13490 struct remote_state
*rs
= get_remote_state ();
13492 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTDisable:%x:%s",
13493 location
->owner
->number
,
13494 phex (location
->address
, sizeof (CORE_ADDR
)));
13496 remote_get_noisy_reply ();
13497 if (rs
->buf
[0] == '\0')
13498 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
13499 if (strcmp (rs
->buf
.data (), "OK") != 0)
13500 error (_("Error on target while disabling tracepoint."));
13504 remote_target::trace_set_readonly_regions ()
13507 bfd_size_type size
;
13512 if (!current_program_space
->exec_bfd ())
13513 return; /* No information to give. */
13515 struct remote_state
*rs
= get_remote_state ();
13517 strcpy (rs
->buf
.data (), "QTro");
13518 offset
= strlen (rs
->buf
.data ());
13519 for (s
= current_program_space
->exec_bfd ()->sections
; s
; s
= s
->next
)
13521 char tmp1
[40], tmp2
[40];
13524 if ((s
->flags
& SEC_LOAD
) == 0 ||
13525 /* (s->flags & SEC_CODE) == 0 || */
13526 (s
->flags
& SEC_READONLY
) == 0)
13530 vma
= bfd_section_vma (s
);
13531 size
= bfd_section_size (s
);
13532 sprintf_vma (tmp1
, vma
);
13533 sprintf_vma (tmp2
, vma
+ size
);
13534 sec_length
= 1 + strlen (tmp1
) + 1 + strlen (tmp2
);
13535 if (offset
+ sec_length
+ 1 > rs
->buf
.size ())
13537 if (packet_support (PACKET_qXfer_traceframe_info
) != PACKET_ENABLE
)
13539 Too many sections for read-only sections definition packet."));
13542 xsnprintf (rs
->buf
.data () + offset
, rs
->buf
.size () - offset
, ":%s,%s",
13544 offset
+= sec_length
;
13549 getpkt (&rs
->buf
, 0);
13554 remote_target::trace_start ()
13556 struct remote_state
*rs
= get_remote_state ();
13558 putpkt ("QTStart");
13559 remote_get_noisy_reply ();
13560 if (rs
->buf
[0] == '\0')
13561 error (_("Target does not support this command."));
13562 if (strcmp (rs
->buf
.data (), "OK") != 0)
13563 error (_("Bogus reply from target: %s"), rs
->buf
.data ());
13567 remote_target::get_trace_status (struct trace_status
*ts
)
13569 /* Initialize it just to avoid a GCC false warning. */
13571 enum packet_result result
;
13572 struct remote_state
*rs
= get_remote_state ();
13574 if (packet_support (PACKET_qTStatus
) == PACKET_DISABLE
)
13577 /* FIXME we need to get register block size some other way. */
13578 trace_regblock_size
13579 = rs
->get_remote_arch_state (target_gdbarch ())->sizeof_g_packet
;
13581 putpkt ("qTStatus");
13585 p
= remote_get_noisy_reply ();
13587 catch (const gdb_exception_error
&ex
)
13589 if (ex
.error
!= TARGET_CLOSE_ERROR
)
13591 exception_fprintf (gdb_stderr
, ex
, "qTStatus: ");
13597 result
= packet_ok (p
, &remote_protocol_packets
[PACKET_qTStatus
]);
13599 /* If the remote target doesn't do tracing, flag it. */
13600 if (result
== PACKET_UNKNOWN
)
13603 /* We're working with a live target. */
13604 ts
->filename
= NULL
;
13607 error (_("Bogus trace status reply from target: %s"), rs
->buf
.data ());
13609 /* Function 'parse_trace_status' sets default value of each field of
13610 'ts' at first, so we don't have to do it here. */
13611 parse_trace_status (p
, ts
);
13613 return ts
->running
;
13617 remote_target::get_tracepoint_status (struct breakpoint
*bp
,
13618 struct uploaded_tp
*utp
)
13620 struct remote_state
*rs
= get_remote_state ();
13622 struct tracepoint
*tp
= (struct tracepoint
*) bp
;
13623 size_t size
= get_remote_packet_size ();
13628 tp
->traceframe_usage
= 0;
13629 for (bp_location
*loc
: tp
->locations ())
13631 /* If the tracepoint was never downloaded, don't go asking for
13633 if (tp
->number_on_target
== 0)
13635 xsnprintf (rs
->buf
.data (), size
, "qTP:%x:%s", tp
->number_on_target
,
13636 phex_nz (loc
->address
, 0));
13638 reply
= remote_get_noisy_reply ();
13639 if (reply
&& *reply
)
13642 parse_tracepoint_status (reply
+ 1, bp
, utp
);
13648 utp
->hit_count
= 0;
13649 utp
->traceframe_usage
= 0;
13650 xsnprintf (rs
->buf
.data (), size
, "qTP:%x:%s", utp
->number
,
13651 phex_nz (utp
->addr
, 0));
13653 reply
= remote_get_noisy_reply ();
13654 if (reply
&& *reply
)
13657 parse_tracepoint_status (reply
+ 1, bp
, utp
);
13663 remote_target::trace_stop ()
13665 struct remote_state
*rs
= get_remote_state ();
13668 remote_get_noisy_reply ();
13669 if (rs
->buf
[0] == '\0')
13670 error (_("Target does not support this command."));
13671 if (strcmp (rs
->buf
.data (), "OK") != 0)
13672 error (_("Bogus reply from target: %s"), rs
->buf
.data ());
13676 remote_target::trace_find (enum trace_find_type type
, int num
,
13677 CORE_ADDR addr1
, CORE_ADDR addr2
,
13680 struct remote_state
*rs
= get_remote_state ();
13681 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
13683 int target_frameno
= -1, target_tracept
= -1;
13685 /* Lookups other than by absolute frame number depend on the current
13686 trace selected, so make sure it is correct on the remote end
13688 if (type
!= tfind_number
)
13689 set_remote_traceframe ();
13691 p
= rs
->buf
.data ();
13692 strcpy (p
, "QTFrame:");
13693 p
= strchr (p
, '\0');
13697 xsnprintf (p
, endbuf
- p
, "%x", num
);
13700 xsnprintf (p
, endbuf
- p
, "pc:%s", phex_nz (addr1
, 0));
13703 xsnprintf (p
, endbuf
- p
, "tdp:%x", num
);
13706 xsnprintf (p
, endbuf
- p
, "range:%s:%s", phex_nz (addr1
, 0),
13707 phex_nz (addr2
, 0));
13709 case tfind_outside
:
13710 xsnprintf (p
, endbuf
- p
, "outside:%s:%s", phex_nz (addr1
, 0),
13711 phex_nz (addr2
, 0));
13714 error (_("Unknown trace find type %d"), type
);
13718 reply
= remote_get_noisy_reply ();
13719 if (*reply
== '\0')
13720 error (_("Target does not support this command."));
13722 while (reply
&& *reply
)
13727 target_frameno
= (int) strtol (p
, &reply
, 16);
13729 error (_("Unable to parse trace frame number"));
13730 /* Don't update our remote traceframe number cache on failure
13731 to select a remote traceframe. */
13732 if (target_frameno
== -1)
13737 target_tracept
= (int) strtol (p
, &reply
, 16);
13739 error (_("Unable to parse tracepoint number"));
13741 case 'O': /* "OK"? */
13742 if (reply
[1] == 'K' && reply
[2] == '\0')
13745 error (_("Bogus reply from target: %s"), reply
);
13748 error (_("Bogus reply from target: %s"), reply
);
13751 *tpp
= target_tracept
;
13753 rs
->remote_traceframe_number
= target_frameno
;
13754 return target_frameno
;
13758 remote_target::get_trace_state_variable_value (int tsvnum
, LONGEST
*val
)
13760 struct remote_state
*rs
= get_remote_state ();
13764 set_remote_traceframe ();
13766 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qTV:%x", tsvnum
);
13768 reply
= remote_get_noisy_reply ();
13769 if (reply
&& *reply
)
13773 unpack_varlen_hex (reply
+ 1, &uval
);
13774 *val
= (LONGEST
) uval
;
13782 remote_target::save_trace_data (const char *filename
)
13784 struct remote_state
*rs
= get_remote_state ();
13787 p
= rs
->buf
.data ();
13788 strcpy (p
, "QTSave:");
13790 if ((p
- rs
->buf
.data ()) + strlen (filename
) * 2
13791 >= get_remote_packet_size ())
13792 error (_("Remote file name too long for trace save packet"));
13793 p
+= 2 * bin2hex ((gdb_byte
*) filename
, p
, strlen (filename
));
13796 reply
= remote_get_noisy_reply ();
13797 if (*reply
== '\0')
13798 error (_("Target does not support this command."));
13799 if (strcmp (reply
, "OK") != 0)
13800 error (_("Bogus reply from target: %s"), reply
);
13804 /* This is basically a memory transfer, but needs to be its own packet
13805 because we don't know how the target actually organizes its trace
13806 memory, plus we want to be able to ask for as much as possible, but
13807 not be unhappy if we don't get as much as we ask for. */
13810 remote_target::get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
)
13812 struct remote_state
*rs
= get_remote_state ();
13817 p
= rs
->buf
.data ();
13818 strcpy (p
, "qTBuffer:");
13820 p
+= hexnumstr (p
, offset
);
13822 p
+= hexnumstr (p
, len
);
13826 reply
= remote_get_noisy_reply ();
13827 if (reply
&& *reply
)
13829 /* 'l' by itself means we're at the end of the buffer and
13830 there is nothing more to get. */
13834 /* Convert the reply into binary. Limit the number of bytes to
13835 convert according to our passed-in buffer size, rather than
13836 what was returned in the packet; if the target is
13837 unexpectedly generous and gives us a bigger reply than we
13838 asked for, we don't want to crash. */
13839 rslt
= hex2bin (reply
, buf
, len
);
13843 /* Something went wrong, flag as an error. */
13848 remote_target::set_disconnected_tracing (int val
)
13850 struct remote_state
*rs
= get_remote_state ();
13852 if (packet_support (PACKET_DisconnectedTracing_feature
) == PACKET_ENABLE
)
13856 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
13857 "QTDisconnected:%x", val
);
13859 reply
= remote_get_noisy_reply ();
13860 if (*reply
== '\0')
13861 error (_("Target does not support this command."));
13862 if (strcmp (reply
, "OK") != 0)
13863 error (_("Bogus reply from target: %s"), reply
);
13866 warning (_("Target does not support disconnected tracing."));
13870 remote_target::core_of_thread (ptid_t ptid
)
13872 thread_info
*info
= find_thread_ptid (this, ptid
);
13874 if (info
!= NULL
&& info
->priv
!= NULL
)
13875 return get_remote_thread_info (info
)->core
;
13881 remote_target::set_circular_trace_buffer (int val
)
13883 struct remote_state
*rs
= get_remote_state ();
13886 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
13887 "QTBuffer:circular:%x", val
);
13889 reply
= remote_get_noisy_reply ();
13890 if (*reply
== '\0')
13891 error (_("Target does not support this command."));
13892 if (strcmp (reply
, "OK") != 0)
13893 error (_("Bogus reply from target: %s"), reply
);
13897 remote_target::traceframe_info ()
13899 gdb::optional
<gdb::char_vector
> text
13900 = target_read_stralloc (current_inferior ()->top_target (),
13901 TARGET_OBJECT_TRACEFRAME_INFO
,
13904 return parse_traceframe_info (text
->data ());
13909 /* Handle the qTMinFTPILen packet. Returns the minimum length of
13910 instruction on which a fast tracepoint may be placed. Returns -1
13911 if the packet is not supported, and 0 if the minimum instruction
13912 length is unknown. */
13915 remote_target::get_min_fast_tracepoint_insn_len ()
13917 struct remote_state
*rs
= get_remote_state ();
13920 /* If we're not debugging a process yet, the IPA can't be
13922 if (!target_has_execution ())
13925 /* Make sure the remote is pointing at the right process. */
13926 set_general_process ();
13928 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qTMinFTPILen");
13930 reply
= remote_get_noisy_reply ();
13931 if (*reply
== '\0')
13935 ULONGEST min_insn_len
;
13937 unpack_varlen_hex (reply
, &min_insn_len
);
13939 return (int) min_insn_len
;
13944 remote_target::set_trace_buffer_size (LONGEST val
)
13946 if (packet_support (PACKET_QTBuffer_size
) != PACKET_DISABLE
)
13948 struct remote_state
*rs
= get_remote_state ();
13949 char *buf
= rs
->buf
.data ();
13950 char *endbuf
= buf
+ get_remote_packet_size ();
13951 enum packet_result result
;
13953 gdb_assert (val
>= 0 || val
== -1);
13954 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTBuffer:size:");
13955 /* Send -1 as literal "-1" to avoid host size dependency. */
13959 buf
+= hexnumstr (buf
, (ULONGEST
) -val
);
13962 buf
+= hexnumstr (buf
, (ULONGEST
) val
);
13965 remote_get_noisy_reply ();
13966 result
= packet_ok (rs
->buf
,
13967 &remote_protocol_packets
[PACKET_QTBuffer_size
]);
13969 if (result
!= PACKET_OK
)
13970 warning (_("Bogus reply from target: %s"), rs
->buf
.data ());
13975 remote_target::set_trace_notes (const char *user
, const char *notes
,
13976 const char *stop_notes
)
13978 struct remote_state
*rs
= get_remote_state ();
13980 char *buf
= rs
->buf
.data ();
13981 char *endbuf
= buf
+ get_remote_packet_size ();
13984 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTNotes:");
13987 buf
+= xsnprintf (buf
, endbuf
- buf
, "user:");
13988 nbytes
= bin2hex ((gdb_byte
*) user
, buf
, strlen (user
));
13994 buf
+= xsnprintf (buf
, endbuf
- buf
, "notes:");
13995 nbytes
= bin2hex ((gdb_byte
*) notes
, buf
, strlen (notes
));
14001 buf
+= xsnprintf (buf
, endbuf
- buf
, "tstop:");
14002 nbytes
= bin2hex ((gdb_byte
*) stop_notes
, buf
, strlen (stop_notes
));
14006 /* Ensure the buffer is terminated. */
14010 reply
= remote_get_noisy_reply ();
14011 if (*reply
== '\0')
14014 if (strcmp (reply
, "OK") != 0)
14015 error (_("Bogus reply from target: %s"), reply
);
14021 remote_target::use_agent (bool use
)
14023 if (packet_support (PACKET_QAgent
) != PACKET_DISABLE
)
14025 struct remote_state
*rs
= get_remote_state ();
14027 /* If the stub supports QAgent. */
14028 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QAgent:%d", use
);
14030 getpkt (&rs
->buf
, 0);
14032 if (strcmp (rs
->buf
.data (), "OK") == 0)
14043 remote_target::can_use_agent ()
14045 return (packet_support (PACKET_QAgent
) != PACKET_DISABLE
);
14048 struct btrace_target_info
14050 /* The ptid of the traced thread. */
14053 /* The obtained branch trace configuration. */
14054 struct btrace_config conf
;
14057 /* Reset our idea of our target's btrace configuration. */
14060 remote_btrace_reset (remote_state
*rs
)
14062 memset (&rs
->btrace_config
, 0, sizeof (rs
->btrace_config
));
14065 /* Synchronize the configuration with the target. */
14068 remote_target::btrace_sync_conf (const btrace_config
*conf
)
14070 struct packet_config
*packet
;
14071 struct remote_state
*rs
;
14072 char *buf
, *pos
, *endbuf
;
14074 rs
= get_remote_state ();
14075 buf
= rs
->buf
.data ();
14076 endbuf
= buf
+ get_remote_packet_size ();
14078 packet
= &remote_protocol_packets
[PACKET_Qbtrace_conf_bts_size
];
14079 if (packet_config_support (packet
) == PACKET_ENABLE
14080 && conf
->bts
.size
!= rs
->btrace_config
.bts
.size
)
14083 pos
+= xsnprintf (pos
, endbuf
- pos
, "%s=0x%x", packet
->name
,
14087 getpkt (&rs
->buf
, 0);
14089 if (packet_ok (buf
, packet
) == PACKET_ERROR
)
14091 if (buf
[0] == 'E' && buf
[1] == '.')
14092 error (_("Failed to configure the BTS buffer size: %s"), buf
+ 2);
14094 error (_("Failed to configure the BTS buffer size."));
14097 rs
->btrace_config
.bts
.size
= conf
->bts
.size
;
14100 packet
= &remote_protocol_packets
[PACKET_Qbtrace_conf_pt_size
];
14101 if (packet_config_support (packet
) == PACKET_ENABLE
14102 && conf
->pt
.size
!= rs
->btrace_config
.pt
.size
)
14105 pos
+= xsnprintf (pos
, endbuf
- pos
, "%s=0x%x", packet
->name
,
14109 getpkt (&rs
->buf
, 0);
14111 if (packet_ok (buf
, packet
) == PACKET_ERROR
)
14113 if (buf
[0] == 'E' && buf
[1] == '.')
14114 error (_("Failed to configure the trace buffer size: %s"), buf
+ 2);
14116 error (_("Failed to configure the trace buffer size."));
14119 rs
->btrace_config
.pt
.size
= conf
->pt
.size
;
14123 /* Read the current thread's btrace configuration from the target and
14124 store it into CONF. */
14127 btrace_read_config (struct btrace_config
*conf
)
14129 gdb::optional
<gdb::char_vector
> xml
14130 = target_read_stralloc (current_inferior ()->top_target (),
14131 TARGET_OBJECT_BTRACE_CONF
, "");
14133 parse_xml_btrace_conf (conf
, xml
->data ());
14136 /* Maybe reopen target btrace. */
14139 remote_target::remote_btrace_maybe_reopen ()
14141 struct remote_state
*rs
= get_remote_state ();
14142 int btrace_target_pushed
= 0;
14143 #if !defined (HAVE_LIBIPT)
14147 /* Don't bother walking the entirety of the remote thread list when
14148 we know the feature isn't supported by the remote. */
14149 if (packet_support (PACKET_qXfer_btrace_conf
) != PACKET_ENABLE
)
14152 scoped_restore_current_thread restore_thread
;
14154 for (thread_info
*tp
: all_non_exited_threads (this))
14156 set_general_thread (tp
->ptid
);
14158 memset (&rs
->btrace_config
, 0x00, sizeof (struct btrace_config
));
14159 btrace_read_config (&rs
->btrace_config
);
14161 if (rs
->btrace_config
.format
== BTRACE_FORMAT_NONE
)
14164 #if !defined (HAVE_LIBIPT)
14165 if (rs
->btrace_config
.format
== BTRACE_FORMAT_PT
)
14170 warning (_("Target is recording using Intel Processor Trace "
14171 "but support was disabled at compile time."));
14176 #endif /* !defined (HAVE_LIBIPT) */
14178 /* Push target, once, but before anything else happens. This way our
14179 changes to the threads will be cleaned up by unpushing the target
14180 in case btrace_read_config () throws. */
14181 if (!btrace_target_pushed
)
14183 btrace_target_pushed
= 1;
14184 record_btrace_push_target ();
14185 printf_filtered (_("Target is recording using %s.\n"),
14186 btrace_format_string (rs
->btrace_config
.format
));
14189 tp
->btrace
.target
= XCNEW (struct btrace_target_info
);
14190 tp
->btrace
.target
->ptid
= tp
->ptid
;
14191 tp
->btrace
.target
->conf
= rs
->btrace_config
;
14195 /* Enable branch tracing. */
14197 struct btrace_target_info
*
14198 remote_target::enable_btrace (ptid_t ptid
, const struct btrace_config
*conf
)
14200 struct btrace_target_info
*tinfo
= NULL
;
14201 struct packet_config
*packet
= NULL
;
14202 struct remote_state
*rs
= get_remote_state ();
14203 char *buf
= rs
->buf
.data ();
14204 char *endbuf
= buf
+ get_remote_packet_size ();
14206 switch (conf
->format
)
14208 case BTRACE_FORMAT_BTS
:
14209 packet
= &remote_protocol_packets
[PACKET_Qbtrace_bts
];
14212 case BTRACE_FORMAT_PT
:
14213 packet
= &remote_protocol_packets
[PACKET_Qbtrace_pt
];
14217 if (packet
== NULL
|| packet_config_support (packet
) != PACKET_ENABLE
)
14218 error (_("Target does not support branch tracing."));
14220 btrace_sync_conf (conf
);
14222 set_general_thread (ptid
);
14224 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
14226 getpkt (&rs
->buf
, 0);
14228 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
14230 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
14231 error (_("Could not enable branch tracing for %s: %s"),
14232 target_pid_to_str (ptid
).c_str (), &rs
->buf
[2]);
14234 error (_("Could not enable branch tracing for %s."),
14235 target_pid_to_str (ptid
).c_str ());
14238 tinfo
= XCNEW (struct btrace_target_info
);
14239 tinfo
->ptid
= ptid
;
14241 /* If we fail to read the configuration, we lose some information, but the
14242 tracing itself is not impacted. */
14245 btrace_read_config (&tinfo
->conf
);
14247 catch (const gdb_exception_error
&err
)
14249 if (err
.message
!= NULL
)
14250 warning ("%s", err
.what ());
14256 /* Disable branch tracing. */
14259 remote_target::disable_btrace (struct btrace_target_info
*tinfo
)
14261 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_Qbtrace_off
];
14262 struct remote_state
*rs
= get_remote_state ();
14263 char *buf
= rs
->buf
.data ();
14264 char *endbuf
= buf
+ get_remote_packet_size ();
14266 if (packet_config_support (packet
) != PACKET_ENABLE
)
14267 error (_("Target does not support branch tracing."));
14269 set_general_thread (tinfo
->ptid
);
14271 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
14273 getpkt (&rs
->buf
, 0);
14275 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
14277 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
14278 error (_("Could not disable branch tracing for %s: %s"),
14279 target_pid_to_str (tinfo
->ptid
).c_str (), &rs
->buf
[2]);
14281 error (_("Could not disable branch tracing for %s."),
14282 target_pid_to_str (tinfo
->ptid
).c_str ());
14288 /* Teardown branch tracing. */
14291 remote_target::teardown_btrace (struct btrace_target_info
*tinfo
)
14293 /* We must not talk to the target during teardown. */
14297 /* Read the branch trace. */
14300 remote_target::read_btrace (struct btrace_data
*btrace
,
14301 struct btrace_target_info
*tinfo
,
14302 enum btrace_read_type type
)
14304 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_qXfer_btrace
];
14307 if (packet_config_support (packet
) != PACKET_ENABLE
)
14308 error (_("Target does not support branch tracing."));
14310 #if !defined(HAVE_LIBEXPAT)
14311 error (_("Cannot process branch tracing result. XML parsing not supported."));
14316 case BTRACE_READ_ALL
:
14319 case BTRACE_READ_NEW
:
14322 case BTRACE_READ_DELTA
:
14326 internal_error (__FILE__
, __LINE__
,
14327 _("Bad branch tracing read type: %u."),
14328 (unsigned int) type
);
14331 gdb::optional
<gdb::char_vector
> xml
14332 = target_read_stralloc (current_inferior ()->top_target (),
14333 TARGET_OBJECT_BTRACE
, annex
);
14335 return BTRACE_ERR_UNKNOWN
;
14337 parse_xml_btrace (btrace
, xml
->data ());
14339 return BTRACE_ERR_NONE
;
14342 const struct btrace_config
*
14343 remote_target::btrace_conf (const struct btrace_target_info
*tinfo
)
14345 return &tinfo
->conf
;
14349 remote_target::augmented_libraries_svr4_read ()
14351 return (packet_support (PACKET_augmented_libraries_svr4_read_feature
)
14355 /* Implementation of to_load. */
14358 remote_target::load (const char *name
, int from_tty
)
14360 generic_load (name
, from_tty
);
14363 /* Accepts an integer PID; returns a string representing a file that
14364 can be opened on the remote side to get the symbols for the child
14365 process. Returns NULL if the operation is not supported. */
14368 remote_target::pid_to_exec_file (int pid
)
14370 static gdb::optional
<gdb::char_vector
> filename
;
14371 char *annex
= NULL
;
14373 if (packet_support (PACKET_qXfer_exec_file
) != PACKET_ENABLE
)
14376 inferior
*inf
= find_inferior_pid (this, pid
);
14378 internal_error (__FILE__
, __LINE__
,
14379 _("not currently attached to process %d"), pid
);
14381 if (!inf
->fake_pid_p
)
14383 const int annex_size
= 9;
14385 annex
= (char *) alloca (annex_size
);
14386 xsnprintf (annex
, annex_size
, "%x", pid
);
14389 filename
= target_read_stralloc (current_inferior ()->top_target (),
14390 TARGET_OBJECT_EXEC_FILE
, annex
);
14392 return filename
? filename
->data () : nullptr;
14395 /* Implement the to_can_do_single_step target_ops method. */
14398 remote_target::can_do_single_step ()
14400 /* We can only tell whether target supports single step or not by
14401 supported s and S vCont actions if the stub supports vContSupported
14402 feature. If the stub doesn't support vContSupported feature,
14403 we have conservatively to think target doesn't supports single
14405 if (packet_support (PACKET_vContSupported
) == PACKET_ENABLE
)
14407 struct remote_state
*rs
= get_remote_state ();
14409 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
14410 remote_vcont_probe ();
14412 return rs
->supports_vCont
.s
&& rs
->supports_vCont
.S
;
14418 /* Implementation of the to_execution_direction method for the remote
14421 enum exec_direction_kind
14422 remote_target::execution_direction ()
14424 struct remote_state
*rs
= get_remote_state ();
14426 return rs
->last_resume_exec_dir
;
14429 /* Return pointer to the thread_info struct which corresponds to
14430 THREAD_HANDLE (having length HANDLE_LEN). */
14433 remote_target::thread_handle_to_thread_info (const gdb_byte
*thread_handle
,
14437 for (thread_info
*tp
: all_non_exited_threads (this))
14439 remote_thread_info
*priv
= get_remote_thread_info (tp
);
14441 if (tp
->inf
== inf
&& priv
!= NULL
)
14443 if (handle_len
!= priv
->thread_handle
.size ())
14444 error (_("Thread handle size mismatch: %d vs %zu (from remote)"),
14445 handle_len
, priv
->thread_handle
.size ());
14446 if (memcmp (thread_handle
, priv
->thread_handle
.data (),
14456 remote_target::thread_info_to_thread_handle (struct thread_info
*tp
)
14458 remote_thread_info
*priv
= get_remote_thread_info (tp
);
14459 return priv
->thread_handle
;
14463 remote_target::can_async_p ()
14465 /* This flag should be checked in the common target.c code. */
14466 gdb_assert (target_async_permitted
);
14468 /* We're async whenever the serial device can. */
14469 struct remote_state
*rs
= get_remote_state ();
14470 return serial_can_async_p (rs
->remote_desc
);
14474 remote_target::is_async_p ()
14476 /* We're async whenever the serial device is. */
14477 struct remote_state
*rs
= get_remote_state ();
14478 return serial_is_async_p (rs
->remote_desc
);
14481 /* Pass the SERIAL event on and up to the client. One day this code
14482 will be able to delay notifying the client of an event until the
14483 point where an entire packet has been received. */
14485 static serial_event_ftype remote_async_serial_handler
;
14488 remote_async_serial_handler (struct serial
*scb
, void *context
)
14490 /* Don't propogate error information up to the client. Instead let
14491 the client find out about the error by querying the target. */
14492 inferior_event_handler (INF_REG_EVENT
);
14496 remote_async_inferior_event_handler (gdb_client_data data
)
14498 inferior_event_handler (INF_REG_EVENT
);
14502 remote_target::async_wait_fd ()
14504 struct remote_state
*rs
= get_remote_state ();
14505 return rs
->remote_desc
->fd
;
14509 remote_target::async (int enable
)
14511 struct remote_state
*rs
= get_remote_state ();
14515 serial_async (rs
->remote_desc
, remote_async_serial_handler
, rs
);
14517 /* If there are pending events in the stop reply queue tell the
14518 event loop to process them. */
14519 if (!rs
->stop_reply_queue
.empty ())
14520 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
14521 /* For simplicity, below we clear the pending events token
14522 without remembering whether it is marked, so here we always
14523 mark it. If there's actually no pending notification to
14524 process, this ends up being a no-op (other than a spurious
14525 event-loop wakeup). */
14526 if (target_is_non_stop_p ())
14527 mark_async_event_handler (rs
->notif_state
->get_pending_events_token
);
14531 serial_async (rs
->remote_desc
, NULL
, NULL
);
14532 /* If the core is disabling async, it doesn't want to be
14533 disturbed with target events. Clear all async event sources
14535 clear_async_event_handler (rs
->remote_async_inferior_event_token
);
14536 if (target_is_non_stop_p ())
14537 clear_async_event_handler (rs
->notif_state
->get_pending_events_token
);
14541 /* Implementation of the to_thread_events method. */
14544 remote_target::thread_events (int enable
)
14546 struct remote_state
*rs
= get_remote_state ();
14547 size_t size
= get_remote_packet_size ();
14549 if (packet_support (PACKET_QThreadEvents
) == PACKET_DISABLE
)
14552 xsnprintf (rs
->buf
.data (), size
, "QThreadEvents:%x", enable
? 1 : 0);
14554 getpkt (&rs
->buf
, 0);
14556 switch (packet_ok (rs
->buf
,
14557 &remote_protocol_packets
[PACKET_QThreadEvents
]))
14560 if (strcmp (rs
->buf
.data (), "OK") != 0)
14561 error (_("Remote refused setting thread events: %s"), rs
->buf
.data ());
14564 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
14566 case PACKET_UNKNOWN
:
14572 show_remote_cmd (const char *args
, int from_tty
)
14574 /* We can't just use cmd_show_list here, because we want to skip
14575 the redundant "show remote Z-packet" and the legacy aliases. */
14576 struct cmd_list_element
*list
= remote_show_cmdlist
;
14577 struct ui_out
*uiout
= current_uiout
;
14579 ui_out_emit_tuple
tuple_emitter (uiout
, "showlist");
14580 for (; list
!= NULL
; list
= list
->next
)
14581 if (strcmp (list
->name
, "Z-packet") == 0)
14583 else if (list
->type
== not_set_cmd
)
14584 /* Alias commands are exactly like the original, except they
14585 don't have the normal type. */
14589 ui_out_emit_tuple
option_emitter (uiout
, "option");
14591 uiout
->field_string ("name", list
->name
);
14592 uiout
->text (": ");
14593 if (list
->type
== show_cmd
)
14594 do_show_command (NULL
, from_tty
, list
);
14596 cmd_func (list
, NULL
, from_tty
);
14601 /* Function to be called whenever a new objfile (shlib) is detected. */
14603 remote_new_objfile (struct objfile
*objfile
)
14605 remote_target
*remote
= get_current_remote_target ();
14607 /* First, check whether the current inferior's process target is a remote
14609 if (remote
== nullptr)
14612 /* When we are attaching or handling a fork child and the shared library
14613 subsystem reads the list of loaded libraries, we receive new objfile
14614 events in between each found library. The libraries are read in an
14615 undefined order, so if we gave the remote side a chance to look up
14616 symbols between each objfile, we might give it an inconsistent picture
14617 of the inferior. It could appear that a library A appears loaded but
14618 a library B does not, even though library A requires library B. That
14619 would present a state that couldn't normally exist in the inferior.
14621 So, skip these events, we'll give the remote a chance to look up symbols
14622 once all the loaded libraries and their symbols are known to GDB. */
14623 if (current_inferior ()->in_initial_library_scan
)
14626 remote
->remote_check_symbols ();
14629 /* Pull all the tracepoints defined on the target and create local
14630 data structures representing them. We don't want to create real
14631 tracepoints yet, we don't want to mess up the user's existing
14635 remote_target::upload_tracepoints (struct uploaded_tp
**utpp
)
14637 struct remote_state
*rs
= get_remote_state ();
14640 /* Ask for a first packet of tracepoint definition. */
14642 getpkt (&rs
->buf
, 0);
14643 p
= rs
->buf
.data ();
14644 while (*p
&& *p
!= 'l')
14646 parse_tracepoint_definition (p
, utpp
);
14647 /* Ask for another packet of tracepoint definition. */
14649 getpkt (&rs
->buf
, 0);
14650 p
= rs
->buf
.data ();
14656 remote_target::upload_trace_state_variables (struct uploaded_tsv
**utsvp
)
14658 struct remote_state
*rs
= get_remote_state ();
14661 /* Ask for a first packet of variable definition. */
14663 getpkt (&rs
->buf
, 0);
14664 p
= rs
->buf
.data ();
14665 while (*p
&& *p
!= 'l')
14667 parse_tsv_definition (p
, utsvp
);
14668 /* Ask for another packet of variable definition. */
14670 getpkt (&rs
->buf
, 0);
14671 p
= rs
->buf
.data ();
14676 /* The "set/show range-stepping" show hook. */
14679 show_range_stepping (struct ui_file
*file
, int from_tty
,
14680 struct cmd_list_element
*c
,
14683 fprintf_filtered (file
,
14684 _("Debugger's willingness to use range stepping "
14685 "is %s.\n"), value
);
14688 /* Return true if the vCont;r action is supported by the remote
14692 remote_target::vcont_r_supported ()
14694 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
14695 remote_vcont_probe ();
14697 return (packet_support (PACKET_vCont
) == PACKET_ENABLE
14698 && get_remote_state ()->supports_vCont
.r
);
14701 /* The "set/show range-stepping" set hook. */
14704 set_range_stepping (const char *ignore_args
, int from_tty
,
14705 struct cmd_list_element
*c
)
14707 /* When enabling, check whether range stepping is actually supported
14708 by the target, and warn if not. */
14709 if (use_range_stepping
)
14711 remote_target
*remote
= get_current_remote_target ();
14713 || !remote
->vcont_r_supported ())
14714 warning (_("Range stepping is not supported by the current target"));
14719 show_remote_debug (struct ui_file
*file
, int from_tty
,
14720 struct cmd_list_element
*c
, const char *value
)
14722 fprintf_filtered (file
, _("Debugging of remote protocol is %s.\n"),
14727 show_remote_timeout (struct ui_file
*file
, int from_tty
,
14728 struct cmd_list_element
*c
, const char *value
)
14730 fprintf_filtered (file
,
14731 _("Timeout limit to wait for target to respond is %s.\n"),
14735 /* Implement the "supports_memory_tagging" target_ops method. */
14738 remote_target::supports_memory_tagging ()
14740 return remote_memory_tagging_p ();
14743 /* Create the qMemTags packet given ADDRESS, LEN and TYPE. */
14746 create_fetch_memtags_request (gdb::char_vector
&packet
, CORE_ADDR address
,
14747 size_t len
, int type
)
14749 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
14751 std::string request
= string_printf ("qMemTags:%s,%s:%s",
14752 phex_nz (address
, addr_size
),
14753 phex_nz (len
, sizeof (len
)),
14754 phex_nz (type
, sizeof (type
)));
14756 strcpy (packet
.data (), request
.c_str ());
14759 /* Parse the qMemTags packet reply into TAGS.
14761 Return true if successful, false otherwise. */
14764 parse_fetch_memtags_reply (const gdb::char_vector
&reply
,
14765 gdb::byte_vector
&tags
)
14767 if (reply
.empty () || reply
[0] == 'E' || reply
[0] != 'm')
14770 /* Copy the tag data. */
14771 tags
= hex2bin (reply
.data () + 1);
14776 /* Create the QMemTags packet given ADDRESS, LEN, TYPE and TAGS. */
14779 create_store_memtags_request (gdb::char_vector
&packet
, CORE_ADDR address
,
14780 size_t len
, int type
,
14781 const gdb::byte_vector
&tags
)
14783 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
14785 /* Put together the main packet, address and length. */
14786 std::string request
= string_printf ("QMemTags:%s,%s:%s:",
14787 phex_nz (address
, addr_size
),
14788 phex_nz (len
, sizeof (len
)),
14789 phex_nz (type
, sizeof (type
)));
14790 request
+= bin2hex (tags
.data (), tags
.size ());
14792 /* Check if we have exceeded the maximum packet size. */
14793 if (packet
.size () < request
.length ())
14794 error (_("Contents too big for packet QMemTags."));
14796 strcpy (packet
.data (), request
.c_str ());
14799 /* Implement the "fetch_memtags" target_ops method. */
14802 remote_target::fetch_memtags (CORE_ADDR address
, size_t len
,
14803 gdb::byte_vector
&tags
, int type
)
14805 /* Make sure the qMemTags packet is supported. */
14806 if (!remote_memory_tagging_p ())
14807 gdb_assert_not_reached ("remote fetch_memtags called with packet disabled");
14809 struct remote_state
*rs
= get_remote_state ();
14811 create_fetch_memtags_request (rs
->buf
, address
, len
, type
);
14814 getpkt (&rs
->buf
, 0);
14816 return parse_fetch_memtags_reply (rs
->buf
, tags
);
14819 /* Implement the "store_memtags" target_ops method. */
14822 remote_target::store_memtags (CORE_ADDR address
, size_t len
,
14823 const gdb::byte_vector
&tags
, int type
)
14825 /* Make sure the QMemTags packet is supported. */
14826 if (!remote_memory_tagging_p ())
14827 gdb_assert_not_reached ("remote store_memtags called with packet disabled");
14829 struct remote_state
*rs
= get_remote_state ();
14831 create_store_memtags_request (rs
->buf
, address
, len
, type
, tags
);
14834 getpkt (&rs
->buf
, 0);
14836 /* Verify if the request was successful. */
14837 return packet_check_result (rs
->buf
.data ()) == PACKET_OK
;
14840 /* Return true if remote target T is non-stop. */
14843 remote_target_is_non_stop_p (remote_target
*t
)
14845 scoped_restore_current_thread restore_thread
;
14846 switch_to_target_no_thread (t
);
14848 return target_is_non_stop_p ();
14853 namespace selftests
{
14856 test_memory_tagging_functions ()
14858 remote_target remote
;
14860 struct packet_config
*config
14861 = &remote_protocol_packets
[PACKET_memory_tagging_feature
];
14863 scoped_restore restore_memtag_support_
14864 = make_scoped_restore (&config
->support
);
14866 /* Test memory tagging packet support. */
14867 config
->support
= PACKET_SUPPORT_UNKNOWN
;
14868 SELF_CHECK (remote
.supports_memory_tagging () == false);
14869 config
->support
= PACKET_DISABLE
;
14870 SELF_CHECK (remote
.supports_memory_tagging () == false);
14871 config
->support
= PACKET_ENABLE
;
14872 SELF_CHECK (remote
.supports_memory_tagging () == true);
14874 /* Setup testing. */
14875 gdb::char_vector packet
;
14876 gdb::byte_vector tags
, bv
;
14877 std::string expected
, reply
;
14878 packet
.resize (32000);
14880 /* Test creating a qMemTags request. */
14882 expected
= "qMemTags:0,0:0";
14883 create_fetch_memtags_request (packet
, 0x0, 0x0, 0);
14884 SELF_CHECK (strcmp (packet
.data (), expected
.c_str ()) == 0);
14886 expected
= "qMemTags:deadbeef,10:1";
14887 create_fetch_memtags_request (packet
, 0xdeadbeef, 16, 1);
14888 SELF_CHECK (strcmp (packet
.data (), expected
.c_str ()) == 0);
14890 /* Test parsing a qMemTags reply. */
14892 /* Error reply, tags vector unmodified. */
14894 strcpy (packet
.data (), reply
.c_str ());
14896 SELF_CHECK (parse_fetch_memtags_reply (packet
, tags
) == false);
14897 SELF_CHECK (tags
.size () == 0);
14899 /* Valid reply, tags vector updated. */
14903 for (int i
= 0; i
< 5; i
++)
14906 reply
= "m" + bin2hex (bv
.data (), bv
.size ());
14907 strcpy (packet
.data (), reply
.c_str ());
14909 SELF_CHECK (parse_fetch_memtags_reply (packet
, tags
) == true);
14910 SELF_CHECK (tags
.size () == 5);
14912 for (int i
= 0; i
< 5; i
++)
14913 SELF_CHECK (tags
[i
] == i
);
14915 /* Test creating a QMemTags request. */
14917 /* Empty tag data. */
14919 expected
= "QMemTags:0,0:0:";
14920 create_store_memtags_request (packet
, 0x0, 0x0, 0, tags
);
14921 SELF_CHECK (memcmp (packet
.data (), expected
.c_str (),
14922 expected
.length ()) == 0);
14924 /* Non-empty tag data. */
14926 for (int i
= 0; i
< 5; i
++)
14927 tags
.push_back (i
);
14928 expected
= "QMemTags:deadbeef,ff:1:0001020304";
14929 create_store_memtags_request (packet
, 0xdeadbeef, 255, 1, tags
);
14930 SELF_CHECK (memcmp (packet
.data (), expected
.c_str (),
14931 expected
.length ()) == 0);
14934 } // namespace selftests
14935 #endif /* GDB_SELF_TEST */
14937 void _initialize_remote ();
14939 _initialize_remote ()
14941 /* architecture specific data */
14942 remote_g_packet_data_handle
=
14943 gdbarch_data_register_pre_init (remote_g_packet_data_init
);
14945 add_target (remote_target_info
, remote_target::open
);
14946 add_target (extended_remote_target_info
, extended_remote_target::open
);
14948 /* Hook into new objfile notification. */
14949 gdb::observers::new_objfile
.attach (remote_new_objfile
, "remote");
14952 init_remote_threadtests ();
14955 /* set/show remote ... */
14957 add_basic_prefix_cmd ("remote", class_maintenance
, _("\
14958 Remote protocol specific variables.\n\
14959 Configure various remote-protocol specific variables such as\n\
14960 the packets being used."),
14961 &remote_set_cmdlist
,
14962 0 /* allow-unknown */, &setlist
);
14963 add_prefix_cmd ("remote", class_maintenance
, show_remote_cmd
, _("\
14964 Remote protocol specific variables.\n\
14965 Configure various remote-protocol specific variables such as\n\
14966 the packets being used."),
14967 &remote_show_cmdlist
,
14968 0 /* allow-unknown */, &showlist
);
14970 add_cmd ("compare-sections", class_obscure
, compare_sections_command
, _("\
14971 Compare section data on target to the exec file.\n\
14972 Argument is a single section name (default: all loaded sections).\n\
14973 To compare only read-only loaded sections, specify the -r option."),
14976 add_cmd ("packet", class_maintenance
, cli_packet_command
, _("\
14977 Send an arbitrary packet to a remote target.\n\
14978 maintenance packet TEXT\n\
14979 If GDB is talking to an inferior via the GDB serial protocol, then\n\
14980 this command sends the string TEXT to the inferior, and displays the\n\
14981 response packet. GDB supplies the initial `$' character, and the\n\
14982 terminating `#' character and checksum."),
14985 set_show_commands remotebreak_cmds
14986 = add_setshow_boolean_cmd ("remotebreak", no_class
, &remote_break
, _("\
14987 Set whether to send break if interrupted."), _("\
14988 Show whether to send break if interrupted."), _("\
14989 If set, a break, instead of a cntrl-c, is sent to the remote target."),
14990 set_remotebreak
, show_remotebreak
,
14991 &setlist
, &showlist
);
14992 deprecate_cmd (remotebreak_cmds
.set
, "set remote interrupt-sequence");
14993 deprecate_cmd (remotebreak_cmds
.show
, "show remote interrupt-sequence");
14995 add_setshow_enum_cmd ("interrupt-sequence", class_support
,
14996 interrupt_sequence_modes
, &interrupt_sequence_mode
,
14998 Set interrupt sequence to remote target."), _("\
14999 Show interrupt sequence to remote target."), _("\
15000 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
15001 NULL
, show_interrupt_sequence
,
15002 &remote_set_cmdlist
,
15003 &remote_show_cmdlist
);
15005 add_setshow_boolean_cmd ("interrupt-on-connect", class_support
,
15006 &interrupt_on_connect
, _("\
15007 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _("\
15008 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _("\
15009 If set, interrupt sequence is sent to remote target."),
15011 &remote_set_cmdlist
, &remote_show_cmdlist
);
15013 /* Install commands for configuring memory read/write packets. */
15015 add_cmd ("remotewritesize", no_class
, set_memory_write_packet_size
, _("\
15016 Set the maximum number of bytes per memory write packet (deprecated)."),
15018 add_cmd ("remotewritesize", no_class
, show_memory_write_packet_size
, _("\
15019 Show the maximum number of bytes per memory write packet (deprecated)."),
15021 add_cmd ("memory-write-packet-size", no_class
,
15022 set_memory_write_packet_size
, _("\
15023 Set the maximum number of bytes per memory-write packet.\n\
15024 Specify the number of bytes in a packet or 0 (zero) for the\n\
15025 default packet size. The actual limit is further reduced\n\
15026 dependent on the target. Specify ``fixed'' to disable the\n\
15027 further restriction and ``limit'' to enable that restriction."),
15028 &remote_set_cmdlist
);
15029 add_cmd ("memory-read-packet-size", no_class
,
15030 set_memory_read_packet_size
, _("\
15031 Set the maximum number of bytes per memory-read packet.\n\
15032 Specify the number of bytes in a packet or 0 (zero) for the\n\
15033 default packet size. The actual limit is further reduced\n\
15034 dependent on the target. Specify ``fixed'' to disable the\n\
15035 further restriction and ``limit'' to enable that restriction."),
15036 &remote_set_cmdlist
);
15037 add_cmd ("memory-write-packet-size", no_class
,
15038 show_memory_write_packet_size
,
15039 _("Show the maximum number of bytes per memory-write packet."),
15040 &remote_show_cmdlist
);
15041 add_cmd ("memory-read-packet-size", no_class
,
15042 show_memory_read_packet_size
,
15043 _("Show the maximum number of bytes per memory-read packet."),
15044 &remote_show_cmdlist
);
15046 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-limit", no_class
,
15047 &remote_hw_watchpoint_limit
, _("\
15048 Set the maximum number of target hardware watchpoints."), _("\
15049 Show the maximum number of target hardware watchpoints."), _("\
15050 Specify \"unlimited\" for unlimited hardware watchpoints."),
15051 NULL
, show_hardware_watchpoint_limit
,
15052 &remote_set_cmdlist
,
15053 &remote_show_cmdlist
);
15054 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-length-limit",
15056 &remote_hw_watchpoint_length_limit
, _("\
15057 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
15058 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
15059 Specify \"unlimited\" to allow watchpoints of unlimited size."),
15060 NULL
, show_hardware_watchpoint_length_limit
,
15061 &remote_set_cmdlist
, &remote_show_cmdlist
);
15062 add_setshow_zuinteger_unlimited_cmd ("hardware-breakpoint-limit", no_class
,
15063 &remote_hw_breakpoint_limit
, _("\
15064 Set the maximum number of target hardware breakpoints."), _("\
15065 Show the maximum number of target hardware breakpoints."), _("\
15066 Specify \"unlimited\" for unlimited hardware breakpoints."),
15067 NULL
, show_hardware_breakpoint_limit
,
15068 &remote_set_cmdlist
, &remote_show_cmdlist
);
15070 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure
,
15071 &remote_address_size
, _("\
15072 Set the maximum size of the address (in bits) in a memory packet."), _("\
15073 Show the maximum size of the address (in bits) in a memory packet."), NULL
,
15075 NULL
, /* FIXME: i18n: */
15076 &setlist
, &showlist
);
15078 init_all_packet_configs ();
15080 add_packet_config_cmd (&remote_protocol_packets
[PACKET_X
],
15081 "X", "binary-download", 1);
15083 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCont
],
15084 "vCont", "verbose-resume", 0);
15086 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QPassSignals
],
15087 "QPassSignals", "pass-signals", 0);
15089 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QCatchSyscalls
],
15090 "QCatchSyscalls", "catch-syscalls", 0);
15092 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QProgramSignals
],
15093 "QProgramSignals", "program-signals", 0);
15095 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QSetWorkingDir
],
15096 "QSetWorkingDir", "set-working-dir", 0);
15098 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartupWithShell
],
15099 "QStartupWithShell", "startup-with-shell", 0);
15101 add_packet_config_cmd (&remote_protocol_packets
15102 [PACKET_QEnvironmentHexEncoded
],
15103 "QEnvironmentHexEncoded", "environment-hex-encoded",
15106 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QEnvironmentReset
],
15107 "QEnvironmentReset", "environment-reset",
15110 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QEnvironmentUnset
],
15111 "QEnvironmentUnset", "environment-unset",
15114 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSymbol
],
15115 "qSymbol", "symbol-lookup", 0);
15117 add_packet_config_cmd (&remote_protocol_packets
[PACKET_P
],
15118 "P", "set-register", 1);
15120 add_packet_config_cmd (&remote_protocol_packets
[PACKET_p
],
15121 "p", "fetch-register", 1);
15123 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
],
15124 "Z0", "software-breakpoint", 0);
15126 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z1
],
15127 "Z1", "hardware-breakpoint", 0);
15129 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z2
],
15130 "Z2", "write-watchpoint", 0);
15132 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z3
],
15133 "Z3", "read-watchpoint", 0);
15135 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z4
],
15136 "Z4", "access-watchpoint", 0);
15138 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_auxv
],
15139 "qXfer:auxv:read", "read-aux-vector", 0);
15141 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_exec_file
],
15142 "qXfer:exec-file:read", "pid-to-exec-file", 0);
15144 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_features
],
15145 "qXfer:features:read", "target-features", 0);
15147 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries
],
15148 "qXfer:libraries:read", "library-info", 0);
15150 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries_svr4
],
15151 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
15153 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_memory_map
],
15154 "qXfer:memory-map:read", "memory-map", 0);
15156 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_osdata
],
15157 "qXfer:osdata:read", "osdata", 0);
15159 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_threads
],
15160 "qXfer:threads:read", "threads", 0);
15162 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_read
],
15163 "qXfer:siginfo:read", "read-siginfo-object", 0);
15165 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_write
],
15166 "qXfer:siginfo:write", "write-siginfo-object", 0);
15168 add_packet_config_cmd
15169 (&remote_protocol_packets
[PACKET_qXfer_traceframe_info
],
15170 "qXfer:traceframe-info:read", "traceframe-info", 0);
15172 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_uib
],
15173 "qXfer:uib:read", "unwind-info-block", 0);
15175 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTLSAddr
],
15176 "qGetTLSAddr", "get-thread-local-storage-address",
15179 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTIBAddr
],
15180 "qGetTIBAddr", "get-thread-information-block-address",
15183 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bc
],
15184 "bc", "reverse-continue", 0);
15186 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bs
],
15187 "bs", "reverse-step", 0);
15189 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSupported
],
15190 "qSupported", "supported-packets", 0);
15192 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSearch_memory
],
15193 "qSearch:memory", "search-memory", 0);
15195 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qTStatus
],
15196 "qTStatus", "trace-status", 0);
15198 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_setfs
],
15199 "vFile:setfs", "hostio-setfs", 0);
15201 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_open
],
15202 "vFile:open", "hostio-open", 0);
15204 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pread
],
15205 "vFile:pread", "hostio-pread", 0);
15207 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pwrite
],
15208 "vFile:pwrite", "hostio-pwrite", 0);
15210 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_close
],
15211 "vFile:close", "hostio-close", 0);
15213 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_unlink
],
15214 "vFile:unlink", "hostio-unlink", 0);
15216 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_readlink
],
15217 "vFile:readlink", "hostio-readlink", 0);
15219 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_fstat
],
15220 "vFile:fstat", "hostio-fstat", 0);
15222 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vAttach
],
15223 "vAttach", "attach", 0);
15225 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vRun
],
15228 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartNoAckMode
],
15229 "QStartNoAckMode", "noack", 0);
15231 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vKill
],
15232 "vKill", "kill", 0);
15234 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qAttached
],
15235 "qAttached", "query-attached", 0);
15237 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalTracepoints
],
15238 "ConditionalTracepoints",
15239 "conditional-tracepoints", 0);
15241 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalBreakpoints
],
15242 "ConditionalBreakpoints",
15243 "conditional-breakpoints", 0);
15245 add_packet_config_cmd (&remote_protocol_packets
[PACKET_BreakpointCommands
],
15246 "BreakpointCommands",
15247 "breakpoint-commands", 0);
15249 add_packet_config_cmd (&remote_protocol_packets
[PACKET_FastTracepoints
],
15250 "FastTracepoints", "fast-tracepoints", 0);
15252 add_packet_config_cmd (&remote_protocol_packets
[PACKET_TracepointSource
],
15253 "TracepointSource", "TracepointSource", 0);
15255 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAllow
],
15256 "QAllow", "allow", 0);
15258 add_packet_config_cmd (&remote_protocol_packets
[PACKET_StaticTracepoints
],
15259 "StaticTracepoints", "static-tracepoints", 0);
15261 add_packet_config_cmd (&remote_protocol_packets
[PACKET_InstallInTrace
],
15262 "InstallInTrace", "install-in-trace", 0);
15264 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_statictrace_read
],
15265 "qXfer:statictrace:read", "read-sdata-object", 0);
15267 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_fdpic
],
15268 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
15270 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QDisableRandomization
],
15271 "QDisableRandomization", "disable-randomization", 0);
15273 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAgent
],
15274 "QAgent", "agent", 0);
15276 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QTBuffer_size
],
15277 "QTBuffer:size", "trace-buffer-size", 0);
15279 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_off
],
15280 "Qbtrace:off", "disable-btrace", 0);
15282 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_bts
],
15283 "Qbtrace:bts", "enable-btrace-bts", 0);
15285 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_pt
],
15286 "Qbtrace:pt", "enable-btrace-pt", 0);
15288 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace
],
15289 "qXfer:btrace", "read-btrace", 0);
15291 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace_conf
],
15292 "qXfer:btrace-conf", "read-btrace-conf", 0);
15294 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_conf_bts_size
],
15295 "Qbtrace-conf:bts:size", "btrace-conf-bts-size", 0);
15297 add_packet_config_cmd (&remote_protocol_packets
[PACKET_multiprocess_feature
],
15298 "multiprocess-feature", "multiprocess-feature", 0);
15300 add_packet_config_cmd (&remote_protocol_packets
[PACKET_swbreak_feature
],
15301 "swbreak-feature", "swbreak-feature", 0);
15303 add_packet_config_cmd (&remote_protocol_packets
[PACKET_hwbreak_feature
],
15304 "hwbreak-feature", "hwbreak-feature", 0);
15306 add_packet_config_cmd (&remote_protocol_packets
[PACKET_fork_event_feature
],
15307 "fork-event-feature", "fork-event-feature", 0);
15309 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vfork_event_feature
],
15310 "vfork-event-feature", "vfork-event-feature", 0);
15312 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_conf_pt_size
],
15313 "Qbtrace-conf:pt:size", "btrace-conf-pt-size", 0);
15315 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vContSupported
],
15316 "vContSupported", "verbose-resume-supported", 0);
15318 add_packet_config_cmd (&remote_protocol_packets
[PACKET_exec_event_feature
],
15319 "exec-event-feature", "exec-event-feature", 0);
15321 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCtrlC
],
15322 "vCtrlC", "ctrl-c", 0);
15324 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QThreadEvents
],
15325 "QThreadEvents", "thread-events", 0);
15327 add_packet_config_cmd (&remote_protocol_packets
[PACKET_no_resumed
],
15328 "N stop reply", "no-resumed-stop-reply", 0);
15330 add_packet_config_cmd (&remote_protocol_packets
[PACKET_memory_tagging_feature
],
15331 "memory-tagging-feature", "memory-tagging-feature", 0);
15333 /* Assert that we've registered "set remote foo-packet" commands
15334 for all packet configs. */
15338 for (i
= 0; i
< PACKET_MAX
; i
++)
15340 /* Ideally all configs would have a command associated. Some
15341 still don't though. */
15346 case PACKET_QNonStop
:
15347 case PACKET_EnableDisableTracepoints_feature
:
15348 case PACKET_tracenz_feature
:
15349 case PACKET_DisconnectedTracing_feature
:
15350 case PACKET_augmented_libraries_svr4_read_feature
:
15352 /* Additions to this list need to be well justified:
15353 pre-existing packets are OK; new packets are not. */
15361 /* This catches both forgetting to add a config command, and
15362 forgetting to remove a packet from the exception list. */
15363 gdb_assert (excepted
== (remote_protocol_packets
[i
].name
== NULL
));
15367 /* Keep the old ``set remote Z-packet ...'' working. Each individual
15368 Z sub-packet has its own set and show commands, but users may
15369 have sets to this variable in their .gdbinit files (or in their
15371 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure
,
15372 &remote_Z_packet_detect
, _("\
15373 Set use of remote protocol `Z' packets."), _("\
15374 Show use of remote protocol `Z' packets."), _("\
15375 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
15377 set_remote_protocol_Z_packet_cmd
,
15378 show_remote_protocol_Z_packet_cmd
,
15379 /* FIXME: i18n: Use of remote protocol
15380 `Z' packets is %s. */
15381 &remote_set_cmdlist
, &remote_show_cmdlist
);
15383 add_basic_prefix_cmd ("remote", class_files
, _("\
15384 Manipulate files on the remote system.\n\
15385 Transfer files to and from the remote target system."),
15387 0 /* allow-unknown */, &cmdlist
);
15389 add_cmd ("put", class_files
, remote_put_command
,
15390 _("Copy a local file to the remote system."),
15393 add_cmd ("get", class_files
, remote_get_command
,
15394 _("Copy a remote file to the local system."),
15397 add_cmd ("delete", class_files
, remote_delete_command
,
15398 _("Delete a remote file."),
15401 add_setshow_string_noescape_cmd ("exec-file", class_files
,
15402 &remote_exec_file_var
, _("\
15403 Set the remote pathname for \"run\"."), _("\
15404 Show the remote pathname for \"run\"."), NULL
,
15405 set_remote_exec_file
,
15406 show_remote_exec_file
,
15407 &remote_set_cmdlist
,
15408 &remote_show_cmdlist
);
15410 add_setshow_boolean_cmd ("range-stepping", class_run
,
15411 &use_range_stepping
, _("\
15412 Enable or disable range stepping."), _("\
15413 Show whether target-assisted range stepping is enabled."), _("\
15414 If on, and the target supports it, when stepping a source line, GDB\n\
15415 tells the target to step the corresponding range of addresses itself instead\n\
15416 of issuing multiple single-steps. This speeds up source level\n\
15417 stepping. If off, GDB always issues single-steps, even if range\n\
15418 stepping is supported by the target. The default is on."),
15419 set_range_stepping
,
15420 show_range_stepping
,
15424 add_setshow_zinteger_cmd ("watchdog", class_maintenance
, &watchdog
, _("\
15425 Set watchdog timer."), _("\
15426 Show watchdog timer."), _("\
15427 When non-zero, this timeout is used instead of waiting forever for a target\n\
15428 to finish a low-level step or continue operation. If the specified amount\n\
15429 of time passes without a response from the target, an error occurs."),
15432 &setlist
, &showlist
);
15434 add_setshow_zuinteger_unlimited_cmd ("remote-packet-max-chars", no_class
,
15435 &remote_packet_max_chars
, _("\
15436 Set the maximum number of characters to display for each remote packet."), _("\
15437 Show the maximum number of characters to display for each remote packet."), _("\
15438 Specify \"unlimited\" to display all the characters."),
15439 NULL
, show_remote_packet_max_chars
,
15440 &setdebuglist
, &showdebuglist
);
15442 add_setshow_boolean_cmd ("remote", no_class
, &remote_debug
,
15443 _("Set debugging of remote protocol."),
15444 _("Show debugging of remote protocol."),
15446 When enabled, each packet sent or received with the remote target\n\
15450 &setdebuglist
, &showdebuglist
);
15452 add_setshow_zuinteger_unlimited_cmd ("remotetimeout", no_class
,
15453 &remote_timeout
, _("\
15454 Set timeout limit to wait for target to respond."), _("\
15455 Show timeout limit to wait for target to respond."), _("\
15456 This value is used to set the time limit for gdb to wait for a response\n\
15457 from the target."),
15459 show_remote_timeout
,
15460 &setlist
, &showlist
);
15462 /* Eventually initialize fileio. See fileio.c */
15463 initialize_remote_fileio (&remote_set_cmdlist
, &remote_show_cmdlist
);
15466 selftests::register_test ("remote_memory_tagging",
15467 selftests::test_memory_tagging_functions
);