1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2019 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"
31 /*#include "terminal.h" */
34 #include "gdb-stabs.h"
35 #include "gdbthread.h"
37 #include "remote-notif.h"
40 #include "observable.h"
42 #include "cli/cli-decode.h"
43 #include "cli/cli-setshow.h"
44 #include "target-descriptions.h"
46 #include "filestuff.h"
51 #include "gdb_sys_time.h"
53 #include "event-loop.h"
54 #include "event-top.h"
60 #include "gdbcore.h" /* for exec_bfd */
62 #include "remote-fileio.h"
63 #include "gdb/fileio.h"
65 #include "xml-support.h"
67 #include "memory-map.h"
69 #include "tracepoint.h"
74 #include "record-btrace.h"
76 #include "common/scoped_restore.h"
78 #include "common/byte-vector.h"
79 #include <unordered_map>
81 /* The remote target. */
83 static const char remote_doc[] = N_("\
84 Use a remote computer via a serial line, using a gdb-specific protocol.\n\
85 Specify the serial device it is connected to\n\
86 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).");
88 #define OPAQUETHREADBYTES 8
90 /* a 64 bit opaque identifier */
91 typedef unsigned char threadref[OPAQUETHREADBYTES];
93 struct gdb_ext_thread_info;
94 struct threads_listing_context;
95 typedef int (*rmt_thread_action) (threadref *ref, void *context);
96 struct protocol_feature;
100 static void stop_reply_xfree (struct stop_reply *);
102 struct stop_reply_deleter
104 void operator() (stop_reply *r) const
106 stop_reply_xfree (r);
110 typedef std::unique_ptr<stop_reply, stop_reply_deleter> stop_reply_up;
112 /* Generic configuration support for packets the stub optionally
113 supports. Allows the user to specify the use of the packet as well
114 as allowing GDB to auto-detect support in the remote stub. */
118 PACKET_SUPPORT_UNKNOWN = 0,
123 /* Analyze a packet's return value and update the packet config
133 struct threads_listing_context;
135 /* Stub vCont actions support.
137 Each field is a boolean flag indicating whether the stub reports
138 support for the corresponding action. */
140 struct vCont_action_support
155 /* About this many threadisds fit in a packet. */
157 #define MAXTHREADLISTRESULTS 32
159 /* Data for the vFile:pread readahead cache. */
161 struct readahead_cache
163 /* Invalidate the readahead cache. */
166 /* Invalidate the readahead cache if it is holding data for FD. */
167 void invalidate_fd (int fd);
169 /* Serve pread from the readahead cache. Returns number of bytes
170 read, or 0 if the request can't be served from the cache. */
171 int pread (int fd, gdb_byte *read_buf, size_t len, ULONGEST offset);
173 /* The file descriptor for the file that is being cached. -1 if the
177 /* The offset into the file that the cache buffer corresponds
181 /* The buffer holding the cache contents. */
182 gdb_byte *buf = nullptr;
183 /* The buffer's size. We try to read as much as fits into a packet
187 /* Cache hit and miss counters. */
188 ULONGEST hit_count = 0;
189 ULONGEST miss_count = 0;
192 /* Description of the remote protocol for a given architecture. */
196 long offset; /* Offset into G packet. */
197 long regnum; /* GDB's internal register number. */
198 LONGEST pnum; /* Remote protocol register number. */
199 int in_g_packet; /* Always part of G packet. */
200 /* long size in bytes; == register_size (target_gdbarch (), regnum);
202 /* char *name; == gdbarch_register_name (target_gdbarch (), regnum);
206 struct remote_arch_state
208 explicit remote_arch_state (struct gdbarch *gdbarch);
210 /* Description of the remote protocol registers. */
211 long sizeof_g_packet;
213 /* Description of the remote protocol registers indexed by REGNUM
214 (making an array gdbarch_num_regs in size). */
215 std::unique_ptr<packet_reg[]> regs;
217 /* This is the size (in chars) of the first response to the ``g''
218 packet. It is used as a heuristic when determining the maximum
219 size of memory-read and memory-write packets. A target will
220 typically only reserve a buffer large enough to hold the ``g''
221 packet. The size does not include packet overhead (headers and
223 long actual_register_packet_size;
225 /* This is the maximum size (in chars) of a non read/write packet.
226 It is also used as a cap on the size of read/write packets. */
227 long remote_packet_size;
230 /* Description of the remote protocol state for the currently
231 connected target. This is per-target state, and independent of the
232 selected architecture. */
241 /* Get the remote arch state for GDBARCH. */
242 struct remote_arch_state *get_remote_arch_state (struct gdbarch *gdbarch);
246 /* A buffer to use for incoming packets, and its current size. The
247 buffer is grown dynamically for larger incoming packets.
248 Outgoing packets may also be constructed in this buffer.
249 The size of the buffer is always at least REMOTE_PACKET_SIZE;
250 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
252 gdb::char_vector buf;
254 /* True if we're going through initial connection setup (finding out
255 about the remote side's threads, relocating symbols, etc.). */
256 bool starting_up = false;
258 /* If we negotiated packet size explicitly (and thus can bypass
259 heuristics for the largest packet size that will not overflow
260 a buffer in the stub), this will be set to that packet size.
261 Otherwise zero, meaning to use the guessed size. */
262 long explicit_packet_size = 0;
264 /* remote_wait is normally called when the target is running and
265 waits for a stop reply packet. But sometimes we need to call it
266 when the target is already stopped. We can send a "?" packet
267 and have remote_wait read the response. Or, if we already have
268 the response, we can stash it in BUF and tell remote_wait to
269 skip calling getpkt. This flag is set when BUF contains a
270 stop reply packet and the target is not waiting. */
271 int cached_wait_status = 0;
273 /* True, if in no ack mode. That is, neither GDB nor the stub will
274 expect acks from each other. The connection is assumed to be
276 bool noack_mode = false;
278 /* True if we're connected in extended remote mode. */
279 bool extended = false;
281 /* True if we resumed the target and we're waiting for the target to
282 stop. In the mean time, we can't start another command/query.
283 The remote server wouldn't be ready to process it, so we'd
284 timeout waiting for a reply that would never come and eventually
285 we'd close the connection. This can happen in asynchronous mode
286 because we allow GDB commands while the target is running. */
287 bool waiting_for_stop_reply = false;
289 /* The status of the stub support for the various vCont actions. */
290 vCont_action_support supports_vCont;
292 /* True if the user has pressed Ctrl-C, but the target hasn't
293 responded to that. */
294 bool ctrlc_pending_p = false;
296 /* True if we saw a Ctrl-C while reading or writing from/to the
297 remote descriptor. At that point it is not safe to send a remote
298 interrupt packet, so we instead remember we saw the Ctrl-C and
299 process it once we're done with sending/receiving the current
300 packet, which should be shortly. If however that takes too long,
301 and the user presses Ctrl-C again, we offer to disconnect. */
302 bool got_ctrlc_during_io = false;
304 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
305 remote_open knows that we don't have a file open when the program
307 struct serial *remote_desc = nullptr;
309 /* These are the threads which we last sent to the remote system. The
310 TID member will be -1 for all or -2 for not sent yet. */
311 ptid_t general_thread = null_ptid;
312 ptid_t continue_thread = null_ptid;
314 /* This is the traceframe which we last selected on the remote system.
315 It will be -1 if no traceframe is selected. */
316 int remote_traceframe_number = -1;
318 char *last_pass_packet = nullptr;
320 /* The last QProgramSignals packet sent to the target. We bypass
321 sending a new program signals list down to the target if the new
322 packet is exactly the same as the last we sent. IOW, we only let
323 the target know about program signals list changes. */
324 char *last_program_signals_packet = nullptr;
326 gdb_signal last_sent_signal = GDB_SIGNAL_0;
328 bool last_sent_step = false;
330 /* The execution direction of the last resume we got. */
331 exec_direction_kind last_resume_exec_dir = EXEC_FORWARD;
333 char *finished_object = nullptr;
334 char *finished_annex = nullptr;
335 ULONGEST finished_offset = 0;
337 /* Should we try the 'ThreadInfo' query packet?
339 This variable (NOT available to the user: auto-detect only!)
340 determines whether GDB will use the new, simpler "ThreadInfo"
341 query or the older, more complex syntax for thread queries.
342 This is an auto-detect variable (set to true at each connect,
343 and set to false when the target fails to recognize it). */
344 bool use_threadinfo_query = false;
345 bool use_threadextra_query = false;
347 threadref echo_nextthread {};
348 threadref nextthread {};
349 threadref resultthreadlist[MAXTHREADLISTRESULTS] {};
351 /* The state of remote notification. */
352 struct remote_notif_state *notif_state = nullptr;
354 /* The branch trace configuration. */
355 struct btrace_config btrace_config {};
357 /* The argument to the last "vFile:setfs:" packet we sent, used
358 to avoid sending repeated unnecessary "vFile:setfs:" packets.
359 Initialized to -1 to indicate that no "vFile:setfs:" packet
360 has yet been sent. */
363 /* A readahead cache for vFile:pread. Often, reading a binary
364 involves a sequence of small reads. E.g., when parsing an ELF
365 file. A readahead cache helps mostly the case of remote
366 debugging on a connection with higher latency, due to the
367 request/reply nature of the RSP. We only cache data for a single
368 file descriptor at a time. */
369 struct readahead_cache readahead_cache;
371 /* The list of already fetched and acknowledged stop events. This
372 queue is used for notification Stop, and other notifications
373 don't need queue for their events, because the notification
374 events of Stop can't be consumed immediately, so that events
375 should be queued first, and be consumed by remote_wait_{ns,as}
376 one per time. Other notifications can consume their events
377 immediately, so queue is not needed for them. */
378 std::vector<stop_reply_up> stop_reply_queue;
380 /* Asynchronous signal handle registered as event loop source for
381 when we have pending events ready to be passed to the core. */
382 struct async_event_handler *remote_async_inferior_event_token = nullptr;
384 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
385 ``forever'' still use the normal timeout mechanism. This is
386 currently used by the ASYNC code to guarentee that target reads
387 during the initial connect always time-out. Once getpkt has been
388 modified to return a timeout indication and, in turn
389 remote_wait()/wait_for_inferior() have gained a timeout parameter
391 int wait_forever_enabled_p = 1;
394 /* Mapping of remote protocol data for each gdbarch. Usually there
395 is only one entry here, though we may see more with stubs that
396 support multi-process. */
397 std::unordered_map<struct gdbarch *, remote_arch_state>
401 static const target_info remote_target_info = {
403 N_("Remote serial target in gdb-specific protocol"),
407 class remote_target : public process_stratum_target
410 remote_target () = default;
411 ~remote_target () override;
413 const target_info &info () const override
414 { return remote_target_info; }
416 thread_control_capabilities get_thread_control_capabilities () override
417 { return tc_schedlock; }
419 /* Open a remote connection. */
420 static void open (const char *, int);
422 void close () override;
424 void detach (inferior *, int) override;
425 void disconnect (const char *, int) override;
427 void commit_resume () override;
428 void resume (ptid_t, int, enum gdb_signal) override;
429 ptid_t wait (ptid_t, struct target_waitstatus *, int) override;
431 void fetch_registers (struct regcache *, int) override;
432 void store_registers (struct regcache *, int) override;
433 void prepare_to_store (struct regcache *) override;
435 void files_info () override;
437 int insert_breakpoint (struct gdbarch *, struct bp_target_info *) override;
439 int remove_breakpoint (struct gdbarch *, struct bp_target_info *,
440 enum remove_bp_reason) override;
443 bool stopped_by_sw_breakpoint () override;
444 bool supports_stopped_by_sw_breakpoint () override;
446 bool stopped_by_hw_breakpoint () override;
448 bool supports_stopped_by_hw_breakpoint () override;
450 bool stopped_by_watchpoint () override;
452 bool stopped_data_address (CORE_ADDR *) override;
454 bool watchpoint_addr_within_range (CORE_ADDR, CORE_ADDR, int) override;
456 int can_use_hw_breakpoint (enum bptype, int, int) override;
458 int insert_hw_breakpoint (struct gdbarch *, struct bp_target_info *) override;
460 int remove_hw_breakpoint (struct gdbarch *, struct bp_target_info *) override;
462 int region_ok_for_hw_watchpoint (CORE_ADDR, int) override;
464 int insert_watchpoint (CORE_ADDR, int, enum target_hw_bp_type,
465 struct expression *) override;
467 int remove_watchpoint (CORE_ADDR, int, enum target_hw_bp_type,
468 struct expression *) override;
470 void kill () override;
472 void load (const char *, int) override;
474 void mourn_inferior () override;
476 void pass_signals (int, const unsigned char *) override;
478 int set_syscall_catchpoint (int, bool, int,
479 gdb::array_view<const int>) override;
481 void program_signals (int, const unsigned char *) override;
483 bool thread_alive (ptid_t ptid) override;
485 const char *thread_name (struct thread_info *) override;
487 void update_thread_list () override;
489 const char *pid_to_str (ptid_t) override;
491 const char *extra_thread_info (struct thread_info *) override;
493 ptid_t get_ada_task_ptid (long lwp, long thread) override;
495 thread_info *thread_handle_to_thread_info (const gdb_byte *thread_handle,
497 inferior *inf) override;
499 void stop (ptid_t) override;
501 void interrupt () override;
503 void pass_ctrlc () override;
505 enum target_xfer_status xfer_partial (enum target_object object,
508 const gdb_byte *writebuf,
509 ULONGEST offset, ULONGEST len,
510 ULONGEST *xfered_len) override;
512 ULONGEST get_memory_xfer_limit () override;
514 void rcmd (const char *command, struct ui_file *output) override;
516 char *pid_to_exec_file (int pid) override;
518 void log_command (const char *cmd) override
520 serial_log_command (this, cmd);
523 CORE_ADDR get_thread_local_address (ptid_t ptid,
524 CORE_ADDR load_module_addr,
525 CORE_ADDR offset) override;
527 bool can_execute_reverse () override;
529 std::vector<mem_region> memory_map () override;
531 void flash_erase (ULONGEST address, LONGEST length) override;
533 void flash_done () override;
535 const struct target_desc *read_description () override;
537 int search_memory (CORE_ADDR start_addr, ULONGEST search_space_len,
538 const gdb_byte *pattern, ULONGEST pattern_len,
539 CORE_ADDR *found_addrp) override;
541 bool can_async_p () override;
543 bool is_async_p () override;
545 void async (int) override;
547 void thread_events (int) override;
549 int can_do_single_step () override;
551 void terminal_inferior () override;
553 void terminal_ours () override;
555 bool supports_non_stop () override;
557 bool supports_multi_process () override;
559 bool supports_disable_randomization () override;
561 bool filesystem_is_local () override;
564 int fileio_open (struct inferior *inf, const char *filename,
565 int flags, int mode, int warn_if_slow,
566 int *target_errno) override;
568 int fileio_pwrite (int fd, const gdb_byte *write_buf, int len,
569 ULONGEST offset, int *target_errno) override;
571 int fileio_pread (int fd, gdb_byte *read_buf, int len,
572 ULONGEST offset, int *target_errno) override;
574 int fileio_fstat (int fd, struct stat *sb, int *target_errno) override;
576 int fileio_close (int fd, int *target_errno) override;
578 int fileio_unlink (struct inferior *inf,
579 const char *filename,
580 int *target_errno) override;
582 gdb::optional<std::string>
583 fileio_readlink (struct inferior *inf,
584 const char *filename,
585 int *target_errno) override;
587 bool supports_enable_disable_tracepoint () override;
589 bool supports_string_tracing () override;
591 bool supports_evaluation_of_breakpoint_conditions () override;
593 bool can_run_breakpoint_commands () override;
595 void trace_init () override;
597 void download_tracepoint (struct bp_location *location) override;
599 bool can_download_tracepoint () override;
601 void download_trace_state_variable (const trace_state_variable &tsv) override;
603 void enable_tracepoint (struct bp_location *location) override;
605 void disable_tracepoint (struct bp_location *location) override;
607 void trace_set_readonly_regions () override;
609 void trace_start () override;
611 int get_trace_status (struct trace_status *ts) override;
613 void get_tracepoint_status (struct breakpoint *tp, struct uploaded_tp *utp)
616 void trace_stop () override;
618 int trace_find (enum trace_find_type type, int num,
619 CORE_ADDR addr1, CORE_ADDR addr2, int *tpp) override;
621 bool get_trace_state_variable_value (int tsv, LONGEST *val) override;
623 int save_trace_data (const char *filename) override;
625 int upload_tracepoints (struct uploaded_tp **utpp) override;
627 int upload_trace_state_variables (struct uploaded_tsv **utsvp) override;
629 LONGEST get_raw_trace_data (gdb_byte *buf, ULONGEST offset, LONGEST len) override;
631 int get_min_fast_tracepoint_insn_len () override;
633 void set_disconnected_tracing (int val) override;
635 void set_circular_trace_buffer (int val) override;
637 void set_trace_buffer_size (LONGEST val) override;
639 bool set_trace_notes (const char *user, const char *notes,
640 const char *stopnotes) override;
642 int core_of_thread (ptid_t ptid) override;
644 int verify_memory (const gdb_byte *data,
645 CORE_ADDR memaddr, ULONGEST size) override;
648 bool get_tib_address (ptid_t ptid, CORE_ADDR *addr) override;
650 void set_permissions () override;
652 bool static_tracepoint_marker_at (CORE_ADDR,
653 struct static_tracepoint_marker *marker)
656 std::vector<static_tracepoint_marker>
657 static_tracepoint_markers_by_strid (const char *id) override;
659 traceframe_info_up traceframe_info () override;
661 bool use_agent (bool use) override;
662 bool can_use_agent () override;
664 struct btrace_target_info *enable_btrace (ptid_t ptid,
665 const struct btrace_config *conf) override;
667 void disable_btrace (struct btrace_target_info *tinfo) override;
669 void teardown_btrace (struct btrace_target_info *tinfo) override;
671 enum btrace_error read_btrace (struct btrace_data *data,
672 struct btrace_target_info *btinfo,
673 enum btrace_read_type type) override;
675 const struct btrace_config *btrace_conf (const struct btrace_target_info *) override;
676 bool augmented_libraries_svr4_read () override;
677 int follow_fork (int, int) override;
678 void follow_exec (struct inferior *, char *) override;
679 int insert_fork_catchpoint (int) override;
680 int remove_fork_catchpoint (int) override;
681 int insert_vfork_catchpoint (int) override;
682 int remove_vfork_catchpoint (int) override;
683 int insert_exec_catchpoint (int) override;
684 int remove_exec_catchpoint (int) override;
685 enum exec_direction_kind execution_direction () override;
687 public: /* Remote specific methods. */
689 void remote_download_command_source (int num, ULONGEST addr,
690 struct command_line *cmds);
692 void remote_file_put (const char *local_file, const char *remote_file,
694 void remote_file_get (const char *remote_file, const char *local_file,
696 void remote_file_delete (const char *remote_file, int from_tty);
698 int remote_hostio_pread (int fd, gdb_byte *read_buf, int len,
699 ULONGEST offset, int *remote_errno);
700 int remote_hostio_pwrite (int fd, const gdb_byte *write_buf, int len,
701 ULONGEST offset, int *remote_errno);
702 int remote_hostio_pread_vFile (int fd, gdb_byte *read_buf, int len,
703 ULONGEST offset, int *remote_errno);
705 int remote_hostio_send_command (int command_bytes, int which_packet,
706 int *remote_errno, char **attachment,
707 int *attachment_len);
708 int remote_hostio_set_filesystem (struct inferior *inf,
710 /* We should get rid of this and use fileio_open directly. */
711 int remote_hostio_open (struct inferior *inf, const char *filename,
712 int flags, int mode, int warn_if_slow,
714 int remote_hostio_close (int fd, int *remote_errno);
716 int remote_hostio_unlink (inferior *inf, const char *filename,
719 struct remote_state *get_remote_state ();
721 long get_remote_packet_size (void);
722 long get_memory_packet_size (struct memory_packet_config *config);
724 long get_memory_write_packet_size ();
725 long get_memory_read_packet_size ();
727 char *append_pending_thread_resumptions (char *p, char *endp,
729 static void open_1 (const char *name, int from_tty, int extended_p);
730 void start_remote (int from_tty, int extended_p);
731 void remote_detach_1 (struct inferior *inf, int from_tty);
733 char *append_resumption (char *p, char *endp,
734 ptid_t ptid, int step, gdb_signal siggnal);
735 int remote_resume_with_vcont (ptid_t ptid, int step,
738 void add_current_inferior_and_thread (char *wait_status);
740 ptid_t wait_ns (ptid_t ptid, struct target_waitstatus *status,
742 ptid_t wait_as (ptid_t ptid, target_waitstatus *status,
745 ptid_t process_stop_reply (struct stop_reply *stop_reply,
746 target_waitstatus *status);
748 void remote_notice_new_inferior (ptid_t currthread, int executing);
750 void process_initial_stop_replies (int from_tty);
752 thread_info *remote_add_thread (ptid_t ptid, bool running, bool executing);
754 void btrace_sync_conf (const btrace_config *conf);
756 void remote_btrace_maybe_reopen ();
758 void remove_new_fork_children (threads_listing_context *context);
759 void kill_new_fork_children (int pid);
760 void discard_pending_stop_replies (struct inferior *inf);
761 int stop_reply_queue_length ();
763 void check_pending_events_prevent_wildcard_vcont
764 (int *may_global_wildcard_vcont);
766 void discard_pending_stop_replies_in_queue ();
767 struct stop_reply *remote_notif_remove_queued_reply (ptid_t ptid);
768 struct stop_reply *queued_stop_reply (ptid_t ptid);
769 int peek_stop_reply (ptid_t ptid);
770 void remote_parse_stop_reply (const char *buf, stop_reply *event);
772 void remote_stop_ns (ptid_t ptid);
773 void remote_interrupt_as ();
774 void remote_interrupt_ns ();
776 char *remote_get_noisy_reply ();
777 int remote_query_attached (int pid);
778 inferior *remote_add_inferior (int fake_pid_p, int pid, int attached,
781 ptid_t remote_current_thread (ptid_t oldpid);
782 ptid_t get_current_thread (char *wait_status);
784 void set_thread (ptid_t ptid, int gen);
785 void set_general_thread (ptid_t ptid);
786 void set_continue_thread (ptid_t ptid);
787 void set_general_process ();
789 char *write_ptid (char *buf, const char *endbuf, ptid_t ptid);
791 int remote_unpack_thread_info_response (char *pkt, threadref *expectedref,
792 gdb_ext_thread_info *info);
793 int remote_get_threadinfo (threadref *threadid, int fieldset,
794 gdb_ext_thread_info *info);
796 int parse_threadlist_response (char *pkt, int result_limit,
797 threadref *original_echo,
798 threadref *resultlist,
800 int remote_get_threadlist (int startflag, threadref *nextthread,
801 int result_limit, int *done, int *result_count,
802 threadref *threadlist);
804 int remote_threadlist_iterator (rmt_thread_action stepfunction,
805 void *context, int looplimit);
807 int remote_get_threads_with_ql (threads_listing_context *context);
808 int remote_get_threads_with_qxfer (threads_listing_context *context);
809 int remote_get_threads_with_qthreadinfo (threads_listing_context *context);
811 void extended_remote_restart ();
815 void remote_check_symbols ();
817 void remote_supported_packet (const struct protocol_feature *feature,
818 enum packet_support support,
819 const char *argument);
821 void remote_query_supported ();
823 void remote_packet_size (const protocol_feature *feature,
824 packet_support support, const char *value);
826 void remote_serial_quit_handler ();
828 void remote_detach_pid (int pid);
830 void remote_vcont_probe ();
832 void remote_resume_with_hc (ptid_t ptid, int step,
835 void send_interrupt_sequence ();
836 void interrupt_query ();
838 void remote_notif_get_pending_events (notif_client *nc);
840 int fetch_register_using_p (struct regcache *regcache,
842 int send_g_packet ();
843 void process_g_packet (struct regcache *regcache);
844 void fetch_registers_using_g (struct regcache *regcache);
845 int store_register_using_P (const struct regcache *regcache,
847 void store_registers_using_G (const struct regcache *regcache);
849 void set_remote_traceframe ();
851 void check_binary_download (CORE_ADDR addr);
853 target_xfer_status remote_write_bytes_aux (const char *header,
855 const gdb_byte *myaddr,
858 ULONGEST *xfered_len_units,
862 target_xfer_status remote_write_bytes (CORE_ADDR memaddr,
863 const gdb_byte *myaddr, ULONGEST len,
864 int unit_size, ULONGEST *xfered_len);
866 target_xfer_status remote_read_bytes_1 (CORE_ADDR memaddr, gdb_byte *myaddr,
868 int unit_size, ULONGEST *xfered_len_units);
870 target_xfer_status remote_xfer_live_readonly_partial (gdb_byte *readbuf,
874 ULONGEST *xfered_len);
876 target_xfer_status remote_read_bytes (CORE_ADDR memaddr,
877 gdb_byte *myaddr, ULONGEST len,
879 ULONGEST *xfered_len);
881 packet_result remote_send_printf (const char *format, ...)
882 ATTRIBUTE_PRINTF (2, 3);
884 target_xfer_status remote_flash_write (ULONGEST address,
885 ULONGEST length, ULONGEST *xfered_len,
886 const gdb_byte *data);
888 int readchar (int timeout);
890 void remote_serial_write (const char *str, int len);
892 int putpkt (const char *buf);
893 int putpkt_binary (const char *buf, int cnt);
895 int putpkt (const gdb::char_vector &buf)
897 return putpkt (buf.data ());
901 long read_frame (gdb::char_vector *buf_p);
902 void getpkt (gdb::char_vector *buf, int forever);
903 int getpkt_or_notif_sane_1 (gdb::char_vector *buf, int forever,
904 int expecting_notif, int *is_notif);
905 int getpkt_sane (gdb::char_vector *buf, int forever);
906 int getpkt_or_notif_sane (gdb::char_vector *buf, int forever,
908 int remote_vkill (int pid);
909 void remote_kill_k ();
911 void extended_remote_disable_randomization (int val);
912 int extended_remote_run (const std::string &args);
914 void send_environment_packet (const char *action,
918 void extended_remote_environment_support ();
919 void extended_remote_set_inferior_cwd ();
921 target_xfer_status remote_write_qxfer (const char *object_name,
923 const gdb_byte *writebuf,
924 ULONGEST offset, LONGEST len,
925 ULONGEST *xfered_len,
926 struct packet_config *packet);
928 target_xfer_status remote_read_qxfer (const char *object_name,
930 gdb_byte *readbuf, ULONGEST offset,
932 ULONGEST *xfered_len,
933 struct packet_config *packet);
935 void push_stop_reply (struct stop_reply *new_event);
937 bool vcont_r_supported ();
939 void packet_command (const char *args, int from_tty);
941 private: /* data fields */
943 /* The remote state. Don't reference this directly. Use the
944 get_remote_state method instead. */
945 remote_state m_remote_state;
948 static const target_info extended_remote_target_info = {
950 N_("Extended remote serial target in gdb-specific protocol"),
954 /* Set up the extended remote target by extending the standard remote
955 target and adding to it. */
957 class extended_remote_target final : public remote_target
960 const target_info &info () const override
961 { return extended_remote_target_info; }
963 /* Open an extended-remote connection. */
964 static void open (const char *, int);
966 bool can_create_inferior () override { return true; }
967 void create_inferior (const char *, const std::string &,
968 char **, int) override;
970 void detach (inferior *, int) override;
972 bool can_attach () override { return true; }
973 void attach (const char *, int) override;
975 void post_attach (int) override;
976 bool supports_disable_randomization () override;
979 /* Per-program-space data key. */
980 static const struct program_space_data *remote_pspace_data;
982 /* The variable registered as the control variable used by the
983 remote exec-file commands. While the remote exec-file setting is
984 per-program-space, the set/show machinery uses this as the
985 location of the remote exec-file value. */
986 static char *remote_exec_file_var;
988 /* The size to align memory write packets, when practical. The protocol
989 does not guarantee any alignment, and gdb will generate short
990 writes and unaligned writes, but even as a best-effort attempt this
991 can improve bulk transfers. For instance, if a write is misaligned
992 relative to the target's data bus, the stub may need to make an extra
993 round trip fetching data from the target. This doesn't make a
994 huge difference, but it's easy to do, so we try to be helpful.
996 The alignment chosen is arbitrary; usually data bus width is
997 important here, not the possibly larger cache line size. */
998 enum { REMOTE_ALIGN_WRITES = 16 };
1000 /* Prototypes for local functions. */
1002 static int hexnumlen (ULONGEST num);
1004 static int stubhex (int ch);
1006 static int hexnumstr (char *, ULONGEST);
1008 static int hexnumnstr (char *, ULONGEST, int);
1010 static CORE_ADDR remote_address_masked (CORE_ADDR);
1012 static void print_packet (const char *);
1014 static int stub_unpack_int (char *buff, int fieldlength);
1016 struct packet_config;
1018 static void show_packet_config_cmd (struct packet_config *config);
1020 static void show_remote_protocol_packet_cmd (struct ui_file *file,
1022 struct cmd_list_element *c,
1025 static ptid_t read_ptid (const char *buf, const char **obuf);
1027 static void remote_async_inferior_event_handler (gdb_client_data);
1029 static bool remote_read_description_p (struct target_ops *target);
1031 static void remote_console_output (const char *msg);
1033 static void remote_btrace_reset (remote_state *rs);
1035 static void remote_unpush_and_throw (void);
1039 static struct cmd_list_element *remote_cmdlist;
1041 /* For "set remote" and "show remote". */
1043 static struct cmd_list_element *remote_set_cmdlist;
1044 static struct cmd_list_element *remote_show_cmdlist;
1046 /* Controls whether GDB is willing to use range stepping. */
1048 static int use_range_stepping = 1;
1050 /* The max number of chars in debug output. The rest of chars are
1053 #define REMOTE_DEBUG_MAX_CHAR 512
1055 /* Private data that we'll store in (struct thread_info)->priv. */
1056 struct remote_thread_info : public private_thread_info
1062 /* Thread handle, perhaps a pthread_t or thread_t value, stored as a
1063 sequence of bytes. */
1064 gdb::byte_vector thread_handle;
1066 /* Whether the target stopped for a breakpoint/watchpoint. */
1067 enum target_stop_reason stop_reason = TARGET_STOPPED_BY_NO_REASON;
1069 /* This is set to the data address of the access causing the target
1070 to stop for a watchpoint. */
1071 CORE_ADDR watch_data_address = 0;
1073 /* Fields used by the vCont action coalescing implemented in
1074 remote_resume / remote_commit_resume. remote_resume stores each
1075 thread's last resume request in these fields, so that a later
1076 remote_commit_resume knows which is the proper action for this
1077 thread to include in the vCont packet. */
1079 /* True if the last target_resume call for this thread was a step
1080 request, false if a continue request. */
1081 int last_resume_step = 0;
1083 /* The signal specified in the last target_resume call for this
1085 gdb_signal last_resume_sig = GDB_SIGNAL_0;
1087 /* Whether this thread was already vCont-resumed on the remote
1089 int vcont_resumed = 0;
1092 remote_state::remote_state ()
1097 remote_state::~remote_state ()
1099 xfree (this->last_pass_packet);
1100 xfree (this->last_program_signals_packet);
1101 xfree (this->finished_object);
1102 xfree (this->finished_annex);
1105 /* Utility: generate error from an incoming stub packet. */
1107 trace_error (char *buf)
1110 return; /* not an error msg */
1113 case '1': /* malformed packet error */
1114 if (*++buf == '0') /* general case: */
1115 error (_("remote.c: error in outgoing packet."));
1117 error (_("remote.c: error in outgoing packet at field #%ld."),
1118 strtol (buf, NULL, 16));
1120 error (_("Target returns error code '%s'."), buf);
1124 /* Utility: wait for reply from stub, while accepting "O" packets. */
1127 remote_target::remote_get_noisy_reply ()
1129 struct remote_state *rs = get_remote_state ();
1131 do /* Loop on reply from remote stub. */
1135 QUIT; /* Allow user to bail out with ^C. */
1136 getpkt (&rs->buf, 0);
1137 buf = rs->buf.data ();
1140 else if (startswith (buf, "qRelocInsn:"))
1143 CORE_ADDR from, to, org_to;
1145 int adjusted_size = 0;
1148 p = buf + strlen ("qRelocInsn:");
1149 pp = unpack_varlen_hex (p, &ul);
1151 error (_("invalid qRelocInsn packet: %s"), buf);
1155 unpack_varlen_hex (p, &ul);
1162 gdbarch_relocate_instruction (target_gdbarch (), &to, from);
1165 CATCH (ex, RETURN_MASK_ALL)
1167 if (ex.error == MEMORY_ERROR)
1169 /* Propagate memory errors silently back to the
1170 target. The stub may have limited the range of
1171 addresses we can write to, for example. */
1175 /* Something unexpectedly bad happened. Be verbose
1176 so we can tell what, and propagate the error back
1177 to the stub, so it doesn't get stuck waiting for
1179 exception_fprintf (gdb_stderr, ex,
1180 _("warning: relocating instruction: "));
1188 adjusted_size = to - org_to;
1190 xsnprintf (buf, rs->buf.size (), "qRelocInsn:%x", adjusted_size);
1194 else if (buf[0] == 'O' && buf[1] != 'K')
1195 remote_console_output (buf + 1); /* 'O' message from stub */
1197 return buf; /* Here's the actual reply. */
1202 struct remote_arch_state *
1203 remote_state::get_remote_arch_state (struct gdbarch *gdbarch)
1205 remote_arch_state *rsa;
1207 auto it = this->m_arch_states.find (gdbarch);
1208 if (it == this->m_arch_states.end ())
1210 auto p = this->m_arch_states.emplace (std::piecewise_construct,
1211 std::forward_as_tuple (gdbarch),
1212 std::forward_as_tuple (gdbarch));
1213 rsa = &p.first->second;
1215 /* Make sure that the packet buffer is plenty big enough for
1216 this architecture. */
1217 if (this->buf.size () < rsa->remote_packet_size)
1218 this->buf.resize (2 * rsa->remote_packet_size);
1226 /* Fetch the global remote target state. */
1229 remote_target::get_remote_state ()
1231 /* Make sure that the remote architecture state has been
1232 initialized, because doing so might reallocate rs->buf. Any
1233 function which calls getpkt also needs to be mindful of changes
1234 to rs->buf, but this call limits the number of places which run
1236 m_remote_state.get_remote_arch_state (target_gdbarch ());
1238 return &m_remote_state;
1241 /* Cleanup routine for the remote module's pspace data. */
1244 remote_pspace_data_cleanup (struct program_space *pspace, void *arg)
1246 char *remote_exec_file = (char *) arg;
1248 xfree (remote_exec_file);
1251 /* Fetch the remote exec-file from the current program space. */
1254 get_remote_exec_file (void)
1256 char *remote_exec_file;
1259 = (char *) program_space_data (current_program_space,
1260 remote_pspace_data);
1261 if (remote_exec_file == NULL)
1264 return remote_exec_file;
1267 /* Set the remote exec file for PSPACE. */
1270 set_pspace_remote_exec_file (struct program_space *pspace,
1271 char *remote_exec_file)
1273 char *old_file = (char *) program_space_data (pspace, remote_pspace_data);
1276 set_program_space_data (pspace, remote_pspace_data,
1277 xstrdup (remote_exec_file));
1280 /* The "set/show remote exec-file" set command hook. */
1283 set_remote_exec_file (const char *ignored, int from_tty,
1284 struct cmd_list_element *c)
1286 gdb_assert (remote_exec_file_var != NULL);
1287 set_pspace_remote_exec_file (current_program_space, remote_exec_file_var);
1290 /* The "set/show remote exec-file" show command hook. */
1293 show_remote_exec_file (struct ui_file *file, int from_tty,
1294 struct cmd_list_element *cmd, const char *value)
1296 fprintf_filtered (file, "%s\n", remote_exec_file_var);
1300 compare_pnums (const void *lhs_, const void *rhs_)
1302 const struct packet_reg * const *lhs
1303 = (const struct packet_reg * const *) lhs_;
1304 const struct packet_reg * const *rhs
1305 = (const struct packet_reg * const *) rhs_;
1307 if ((*lhs)->pnum < (*rhs)->pnum)
1309 else if ((*lhs)->pnum == (*rhs)->pnum)
1316 map_regcache_remote_table (struct gdbarch *gdbarch, struct packet_reg *regs)
1318 int regnum, num_remote_regs, offset;
1319 struct packet_reg **remote_regs;
1321 for (regnum = 0; regnum < gdbarch_num_regs (gdbarch); regnum++)
1323 struct packet_reg *r = ®s[regnum];
1325 if (register_size (gdbarch, regnum) == 0)
1326 /* Do not try to fetch zero-sized (placeholder) registers. */
1329 r->pnum = gdbarch_remote_register_number (gdbarch, regnum);
1334 /* Define the g/G packet format as the contents of each register
1335 with a remote protocol number, in order of ascending protocol
1338 remote_regs = XALLOCAVEC (struct packet_reg *, gdbarch_num_regs (gdbarch));
1339 for (num_remote_regs = 0, regnum = 0;
1340 regnum < gdbarch_num_regs (gdbarch);
1342 if (regs[regnum].pnum != -1)
1343 remote_regs[num_remote_regs++] = ®s[regnum];
1345 qsort (remote_regs, num_remote_regs, sizeof (struct packet_reg *),
1348 for (regnum = 0, offset = 0; regnum < num_remote_regs; regnum++)
1350 remote_regs[regnum]->in_g_packet = 1;
1351 remote_regs[regnum]->offset = offset;
1352 offset += register_size (gdbarch, remote_regs[regnum]->regnum);
1358 /* Given the architecture described by GDBARCH, return the remote
1359 protocol register's number and the register's offset in the g/G
1360 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
1361 If the target does not have a mapping for REGNUM, return false,
1362 otherwise, return true. */
1365 remote_register_number_and_offset (struct gdbarch *gdbarch, int regnum,
1366 int *pnum, int *poffset)
1368 gdb_assert (regnum < gdbarch_num_regs (gdbarch));
1370 std::vector<packet_reg> regs (gdbarch_num_regs (gdbarch));
1372 map_regcache_remote_table (gdbarch, regs.data ());
1374 *pnum = regs[regnum].pnum;
1375 *poffset = regs[regnum].offset;
1380 remote_arch_state::remote_arch_state (struct gdbarch *gdbarch)
1382 /* Use the architecture to build a regnum<->pnum table, which will be
1383 1:1 unless a feature set specifies otherwise. */
1384 this->regs.reset (new packet_reg [gdbarch_num_regs (gdbarch)] ());
1386 /* Record the maximum possible size of the g packet - it may turn out
1388 this->sizeof_g_packet
1389 = map_regcache_remote_table (gdbarch, this->regs.get ());
1391 /* Default maximum number of characters in a packet body. Many
1392 remote stubs have a hardwired buffer size of 400 bytes
1393 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
1394 as the maximum packet-size to ensure that the packet and an extra
1395 NUL character can always fit in the buffer. This stops GDB
1396 trashing stubs that try to squeeze an extra NUL into what is
1397 already a full buffer (As of 1999-12-04 that was most stubs). */
1398 this->remote_packet_size = 400 - 1;
1400 /* This one is filled in when a ``g'' packet is received. */
1401 this->actual_register_packet_size = 0;
1403 /* Should rsa->sizeof_g_packet needs more space than the
1404 default, adjust the size accordingly. Remember that each byte is
1405 encoded as two characters. 32 is the overhead for the packet
1406 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
1407 (``$NN:G...#NN'') is a better guess, the below has been padded a
1409 if (this->sizeof_g_packet > ((this->remote_packet_size - 32) / 2))
1410 this->remote_packet_size = (this->sizeof_g_packet * 2 + 32);
1413 /* Get a pointer to the current remote target. If not connected to a
1414 remote target, return NULL. */
1416 static remote_target *
1417 get_current_remote_target ()
1419 target_ops *proc_target = find_target_at (process_stratum);
1420 return dynamic_cast<remote_target *> (proc_target);
1423 /* Return the current allowed size of a remote packet. This is
1424 inferred from the current architecture, and should be used to
1425 limit the length of outgoing packets. */
1427 remote_target::get_remote_packet_size ()
1429 struct remote_state *rs = get_remote_state ();
1430 remote_arch_state *rsa = rs->get_remote_arch_state (target_gdbarch ());
1432 if (rs->explicit_packet_size)
1433 return rs->explicit_packet_size;
1435 return rsa->remote_packet_size;
1438 static struct packet_reg *
1439 packet_reg_from_regnum (struct gdbarch *gdbarch, struct remote_arch_state *rsa,
1442 if (regnum < 0 && regnum >= gdbarch_num_regs (gdbarch))
1446 struct packet_reg *r = &rsa->regs[regnum];
1448 gdb_assert (r->regnum == regnum);
1453 static struct packet_reg *
1454 packet_reg_from_pnum (struct gdbarch *gdbarch, struct remote_arch_state *rsa,
1459 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
1461 struct packet_reg *r = &rsa->regs[i];
1463 if (r->pnum == pnum)
1469 /* Allow the user to specify what sequence to send to the remote
1470 when he requests a program interruption: Although ^C is usually
1471 what remote systems expect (this is the default, here), it is
1472 sometimes preferable to send a break. On other systems such
1473 as the Linux kernel, a break followed by g, which is Magic SysRq g
1474 is required in order to interrupt the execution. */
1475 const char interrupt_sequence_control_c[] = "Ctrl-C";
1476 const char interrupt_sequence_break[] = "BREAK";
1477 const char interrupt_sequence_break_g[] = "BREAK-g";
1478 static const char *const interrupt_sequence_modes[] =
1480 interrupt_sequence_control_c,
1481 interrupt_sequence_break,
1482 interrupt_sequence_break_g,
1485 static const char *interrupt_sequence_mode = interrupt_sequence_control_c;
1488 show_interrupt_sequence (struct ui_file *file, int from_tty,
1489 struct cmd_list_element *c,
1492 if (interrupt_sequence_mode == interrupt_sequence_control_c)
1493 fprintf_filtered (file,
1494 _("Send the ASCII ETX character (Ctrl-c) "
1495 "to the remote target to interrupt the "
1496 "execution of the program.\n"));
1497 else if (interrupt_sequence_mode == interrupt_sequence_break)
1498 fprintf_filtered (file,
1499 _("send a break signal to the remote target "
1500 "to interrupt the execution of the program.\n"));
1501 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
1502 fprintf_filtered (file,
1503 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
1504 "the remote target to interrupt the execution "
1505 "of Linux kernel.\n"));
1507 internal_error (__FILE__, __LINE__,
1508 _("Invalid value for interrupt_sequence_mode: %s."),
1509 interrupt_sequence_mode);
1512 /* This boolean variable specifies whether interrupt_sequence is sent
1513 to the remote target when gdb connects to it.
1514 This is mostly needed when you debug the Linux kernel: The Linux kernel
1515 expects BREAK g which is Magic SysRq g for connecting gdb. */
1516 static int interrupt_on_connect = 0;
1518 /* This variable is used to implement the "set/show remotebreak" commands.
1519 Since these commands are now deprecated in favor of "set/show remote
1520 interrupt-sequence", it no longer has any effect on the code. */
1521 static int remote_break;
1524 set_remotebreak (const char *args, int from_tty, struct cmd_list_element *c)
1527 interrupt_sequence_mode = interrupt_sequence_break;
1529 interrupt_sequence_mode = interrupt_sequence_control_c;
1533 show_remotebreak (struct ui_file *file, int from_tty,
1534 struct cmd_list_element *c,
1539 /* This variable sets the number of bits in an address that are to be
1540 sent in a memory ("M" or "m") packet. Normally, after stripping
1541 leading zeros, the entire address would be sent. This variable
1542 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
1543 initial implementation of remote.c restricted the address sent in
1544 memory packets to ``host::sizeof long'' bytes - (typically 32
1545 bits). Consequently, for 64 bit targets, the upper 32 bits of an
1546 address was never sent. Since fixing this bug may cause a break in
1547 some remote targets this variable is principly provided to
1548 facilitate backward compatibility. */
1550 static unsigned int remote_address_size;
1553 /* User configurable variables for the number of characters in a
1554 memory read/write packet. MIN (rsa->remote_packet_size,
1555 rsa->sizeof_g_packet) is the default. Some targets need smaller
1556 values (fifo overruns, et.al.) and some users need larger values
1557 (speed up transfers). The variables ``preferred_*'' (the user
1558 request), ``current_*'' (what was actually set) and ``forced_*''
1559 (Positive - a soft limit, negative - a hard limit). */
1561 struct memory_packet_config
1568 /* The default max memory-write-packet-size, when the setting is
1569 "fixed". The 16k is historical. (It came from older GDB's using
1570 alloca for buffers and the knowledge (folklore?) that some hosts
1571 don't cope very well with large alloca calls.) */
1572 #define DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED 16384
1574 /* The minimum remote packet size for memory transfers. Ensures we
1575 can write at least one byte. */
1576 #define MIN_MEMORY_PACKET_SIZE 20
1578 /* Get the memory packet size, assuming it is fixed. */
1581 get_fixed_memory_packet_size (struct memory_packet_config *config)
1583 gdb_assert (config->fixed_p);
1585 if (config->size <= 0)
1586 return DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED;
1588 return config->size;
1591 /* Compute the current size of a read/write packet. Since this makes
1592 use of ``actual_register_packet_size'' the computation is dynamic. */
1595 remote_target::get_memory_packet_size (struct memory_packet_config *config)
1597 struct remote_state *rs = get_remote_state ();
1598 remote_arch_state *rsa = rs->get_remote_arch_state (target_gdbarch ());
1601 if (config->fixed_p)
1602 what_they_get = get_fixed_memory_packet_size (config);
1605 what_they_get = get_remote_packet_size ();
1606 /* Limit the packet to the size specified by the user. */
1607 if (config->size > 0
1608 && what_they_get > config->size)
1609 what_they_get = config->size;
1611 /* Limit it to the size of the targets ``g'' response unless we have
1612 permission from the stub to use a larger packet size. */
1613 if (rs->explicit_packet_size == 0
1614 && rsa->actual_register_packet_size > 0
1615 && what_they_get > rsa->actual_register_packet_size)
1616 what_they_get = rsa->actual_register_packet_size;
1618 if (what_they_get < MIN_MEMORY_PACKET_SIZE)
1619 what_they_get = MIN_MEMORY_PACKET_SIZE;
1621 /* Make sure there is room in the global buffer for this packet
1622 (including its trailing NUL byte). */
1623 if (rs->buf.size () < what_they_get + 1)
1624 rs->buf.resize (2 * what_they_get);
1626 return what_they_get;
1629 /* Update the size of a read/write packet. If they user wants
1630 something really big then do a sanity check. */
1633 set_memory_packet_size (const char *args, struct memory_packet_config *config)
1635 int fixed_p = config->fixed_p;
1636 long size = config->size;
1639 error (_("Argument required (integer, `fixed' or `limited')."));
1640 else if (strcmp (args, "hard") == 0
1641 || strcmp (args, "fixed") == 0)
1643 else if (strcmp (args, "soft") == 0
1644 || strcmp (args, "limit") == 0)
1650 size = strtoul (args, &end, 0);
1652 error (_("Invalid %s (bad syntax)."), config->name);
1654 /* Instead of explicitly capping the size of a packet to or
1655 disallowing it, the user is allowed to set the size to
1656 something arbitrarily large. */
1660 if (fixed_p && !config->fixed_p)
1662 /* So that the query shows the correct value. */
1663 long query_size = (size <= 0
1664 ? DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
1667 if (! query (_("The target may not be able to correctly handle a %s\n"
1668 "of %ld bytes. Change the packet size? "),
1669 config->name, query_size))
1670 error (_("Packet size not changed."));
1672 /* Update the config. */
1673 config->fixed_p = fixed_p;
1674 config->size = size;
1678 show_memory_packet_size (struct memory_packet_config *config)
1680 if (config->size == 0)
1681 printf_filtered (_("The %s is 0 (default). "), config->name);
1683 printf_filtered (_("The %s is %ld. "), config->name, config->size);
1684 if (config->fixed_p)
1685 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
1686 get_fixed_memory_packet_size (config));
1689 remote_target *remote = get_current_remote_target ();
1692 printf_filtered (_("Packets are limited to %ld bytes.\n"),
1693 remote->get_memory_packet_size (config));
1695 puts_filtered ("The actual limit will be further reduced "
1696 "dependent on the target.\n");
1700 static struct memory_packet_config memory_write_packet_config =
1702 "memory-write-packet-size",
1706 set_memory_write_packet_size (const char *args, int from_tty)
1708 set_memory_packet_size (args, &memory_write_packet_config);
1712 show_memory_write_packet_size (const char *args, int from_tty)
1714 show_memory_packet_size (&memory_write_packet_config);
1717 /* Show the number of hardware watchpoints that can be used. */
1720 show_hardware_watchpoint_limit (struct ui_file *file, int from_tty,
1721 struct cmd_list_element *c,
1724 fprintf_filtered (file, _("The maximum number of target hardware "
1725 "watchpoints is %s.\n"), value);
1728 /* Show the length limit (in bytes) for hardware watchpoints. */
1731 show_hardware_watchpoint_length_limit (struct ui_file *file, int from_tty,
1732 struct cmd_list_element *c,
1735 fprintf_filtered (file, _("The maximum length (in bytes) of a target "
1736 "hardware watchpoint is %s.\n"), value);
1739 /* Show the number of hardware breakpoints that can be used. */
1742 show_hardware_breakpoint_limit (struct ui_file *file, int from_tty,
1743 struct cmd_list_element *c,
1746 fprintf_filtered (file, _("The maximum number of target hardware "
1747 "breakpoints is %s.\n"), value);
1751 remote_target::get_memory_write_packet_size ()
1753 return get_memory_packet_size (&memory_write_packet_config);
1756 static struct memory_packet_config memory_read_packet_config =
1758 "memory-read-packet-size",
1762 set_memory_read_packet_size (const char *args, int from_tty)
1764 set_memory_packet_size (args, &memory_read_packet_config);
1768 show_memory_read_packet_size (const char *args, int from_tty)
1770 show_memory_packet_size (&memory_read_packet_config);
1774 remote_target::get_memory_read_packet_size ()
1776 long size = get_memory_packet_size (&memory_read_packet_config);
1778 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1779 extra buffer size argument before the memory read size can be
1780 increased beyond this. */
1781 if (size > get_remote_packet_size ())
1782 size = get_remote_packet_size ();
1788 struct packet_config
1793 /* If auto, GDB auto-detects support for this packet or feature,
1794 either through qSupported, or by trying the packet and looking
1795 at the response. If true, GDB assumes the target supports this
1796 packet. If false, the packet is disabled. Configs that don't
1797 have an associated command always have this set to auto. */
1798 enum auto_boolean detect;
1800 /* Does the target support this packet? */
1801 enum packet_support support;
1804 static enum packet_support packet_config_support (struct packet_config *config);
1805 static enum packet_support packet_support (int packet);
1808 show_packet_config_cmd (struct packet_config *config)
1810 const char *support = "internal-error";
1812 switch (packet_config_support (config))
1815 support = "enabled";
1817 case PACKET_DISABLE:
1818 support = "disabled";
1820 case PACKET_SUPPORT_UNKNOWN:
1821 support = "unknown";
1824 switch (config->detect)
1826 case AUTO_BOOLEAN_AUTO:
1827 printf_filtered (_("Support for the `%s' packet "
1828 "is auto-detected, currently %s.\n"),
1829 config->name, support);
1831 case AUTO_BOOLEAN_TRUE:
1832 case AUTO_BOOLEAN_FALSE:
1833 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1834 config->name, support);
1840 add_packet_config_cmd (struct packet_config *config, const char *name,
1841 const char *title, int legacy)
1847 config->name = name;
1848 config->title = title;
1849 set_doc = xstrprintf ("Set use of remote protocol `%s' (%s) packet",
1851 show_doc = xstrprintf ("Show current use of remote "
1852 "protocol `%s' (%s) packet",
1854 /* set/show TITLE-packet {auto,on,off} */
1855 cmd_name = xstrprintf ("%s-packet", title);
1856 add_setshow_auto_boolean_cmd (cmd_name, class_obscure,
1857 &config->detect, set_doc,
1858 show_doc, NULL, /* help_doc */
1860 show_remote_protocol_packet_cmd,
1861 &remote_set_cmdlist, &remote_show_cmdlist);
1862 /* The command code copies the documentation strings. */
1865 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1870 legacy_name = xstrprintf ("%s-packet", name);
1871 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1872 &remote_set_cmdlist);
1873 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1874 &remote_show_cmdlist);
1878 static enum packet_result
1879 packet_check_result (const char *buf)
1883 /* The stub recognized the packet request. Check that the
1884 operation succeeded. */
1886 && isxdigit (buf[1]) && isxdigit (buf[2])
1888 /* "Enn" - definitly an error. */
1889 return PACKET_ERROR;
1891 /* Always treat "E." as an error. This will be used for
1892 more verbose error messages, such as E.memtypes. */
1893 if (buf[0] == 'E' && buf[1] == '.')
1894 return PACKET_ERROR;
1896 /* The packet may or may not be OK. Just assume it is. */
1900 /* The stub does not support the packet. */
1901 return PACKET_UNKNOWN;
1904 static enum packet_result
1905 packet_check_result (const gdb::char_vector &buf)
1907 return packet_check_result (buf.data ());
1910 static enum packet_result
1911 packet_ok (const char *buf, struct packet_config *config)
1913 enum packet_result result;
1915 if (config->detect != AUTO_BOOLEAN_TRUE
1916 && config->support == PACKET_DISABLE)
1917 internal_error (__FILE__, __LINE__,
1918 _("packet_ok: attempt to use a disabled packet"));
1920 result = packet_check_result (buf);
1925 /* The stub recognized the packet request. */
1926 if (config->support == PACKET_SUPPORT_UNKNOWN)
1929 fprintf_unfiltered (gdb_stdlog,
1930 "Packet %s (%s) is supported\n",
1931 config->name, config->title);
1932 config->support = PACKET_ENABLE;
1935 case PACKET_UNKNOWN:
1936 /* The stub does not support the packet. */
1937 if (config->detect == AUTO_BOOLEAN_AUTO
1938 && config->support == PACKET_ENABLE)
1940 /* If the stub previously indicated that the packet was
1941 supported then there is a protocol error. */
1942 error (_("Protocol error: %s (%s) conflicting enabled responses."),
1943 config->name, config->title);
1945 else if (config->detect == AUTO_BOOLEAN_TRUE)
1947 /* The user set it wrong. */
1948 error (_("Enabled packet %s (%s) not recognized by stub"),
1949 config->name, config->title);
1953 fprintf_unfiltered (gdb_stdlog,
1954 "Packet %s (%s) is NOT supported\n",
1955 config->name, config->title);
1956 config->support = PACKET_DISABLE;
1963 static enum packet_result
1964 packet_ok (const gdb::char_vector &buf, struct packet_config *config)
1966 return packet_ok (buf.data (), config);
1983 PACKET_vFile_pwrite,
1985 PACKET_vFile_unlink,
1986 PACKET_vFile_readlink,
1989 PACKET_qXfer_features,
1990 PACKET_qXfer_exec_file,
1991 PACKET_qXfer_libraries,
1992 PACKET_qXfer_libraries_svr4,
1993 PACKET_qXfer_memory_map,
1994 PACKET_qXfer_spu_read,
1995 PACKET_qXfer_spu_write,
1996 PACKET_qXfer_osdata,
1997 PACKET_qXfer_threads,
1998 PACKET_qXfer_statictrace_read,
1999 PACKET_qXfer_traceframe_info,
2005 PACKET_QPassSignals,
2006 PACKET_QCatchSyscalls,
2007 PACKET_QProgramSignals,
2008 PACKET_QSetWorkingDir,
2009 PACKET_QStartupWithShell,
2010 PACKET_QEnvironmentHexEncoded,
2011 PACKET_QEnvironmentReset,
2012 PACKET_QEnvironmentUnset,
2014 PACKET_qSearch_memory,
2017 PACKET_QStartNoAckMode,
2019 PACKET_qXfer_siginfo_read,
2020 PACKET_qXfer_siginfo_write,
2023 /* Support for conditional tracepoints. */
2024 PACKET_ConditionalTracepoints,
2026 /* Support for target-side breakpoint conditions. */
2027 PACKET_ConditionalBreakpoints,
2029 /* Support for target-side breakpoint commands. */
2030 PACKET_BreakpointCommands,
2032 /* Support for fast tracepoints. */
2033 PACKET_FastTracepoints,
2035 /* Support for static tracepoints. */
2036 PACKET_StaticTracepoints,
2038 /* Support for installing tracepoints while a trace experiment is
2040 PACKET_InstallInTrace,
2044 PACKET_TracepointSource,
2047 PACKET_QDisableRandomization,
2049 PACKET_QTBuffer_size,
2053 PACKET_qXfer_btrace,
2055 /* Support for the QNonStop packet. */
2058 /* Support for the QThreadEvents packet. */
2059 PACKET_QThreadEvents,
2061 /* Support for multi-process extensions. */
2062 PACKET_multiprocess_feature,
2064 /* Support for enabling and disabling tracepoints while a trace
2065 experiment is running. */
2066 PACKET_EnableDisableTracepoints_feature,
2068 /* Support for collecting strings using the tracenz bytecode. */
2069 PACKET_tracenz_feature,
2071 /* Support for continuing to run a trace experiment while GDB is
2073 PACKET_DisconnectedTracing_feature,
2075 /* Support for qXfer:libraries-svr4:read with a non-empty annex. */
2076 PACKET_augmented_libraries_svr4_read_feature,
2078 /* Support for the qXfer:btrace-conf:read packet. */
2079 PACKET_qXfer_btrace_conf,
2081 /* Support for the Qbtrace-conf:bts:size packet. */
2082 PACKET_Qbtrace_conf_bts_size,
2084 /* Support for swbreak+ feature. */
2085 PACKET_swbreak_feature,
2087 /* Support for hwbreak+ feature. */
2088 PACKET_hwbreak_feature,
2090 /* Support for fork events. */
2091 PACKET_fork_event_feature,
2093 /* Support for vfork events. */
2094 PACKET_vfork_event_feature,
2096 /* Support for the Qbtrace-conf:pt:size packet. */
2097 PACKET_Qbtrace_conf_pt_size,
2099 /* Support for exec events. */
2100 PACKET_exec_event_feature,
2102 /* Support for query supported vCont actions. */
2103 PACKET_vContSupported,
2105 /* Support remote CTRL-C. */
2108 /* Support TARGET_WAITKIND_NO_RESUMED. */
2114 static struct packet_config remote_protocol_packets[PACKET_MAX];
2116 /* Returns the packet's corresponding "set remote foo-packet" command
2117 state. See struct packet_config for more details. */
2119 static enum auto_boolean
2120 packet_set_cmd_state (int packet)
2122 return remote_protocol_packets[packet].detect;
2125 /* Returns whether a given packet or feature is supported. This takes
2126 into account the state of the corresponding "set remote foo-packet"
2127 command, which may be used to bypass auto-detection. */
2129 static enum packet_support
2130 packet_config_support (struct packet_config *config)
2132 switch (config->detect)
2134 case AUTO_BOOLEAN_TRUE:
2135 return PACKET_ENABLE;
2136 case AUTO_BOOLEAN_FALSE:
2137 return PACKET_DISABLE;
2138 case AUTO_BOOLEAN_AUTO:
2139 return config->support;
2141 gdb_assert_not_reached (_("bad switch"));
2145 /* Same as packet_config_support, but takes the packet's enum value as
2148 static enum packet_support
2149 packet_support (int packet)
2151 struct packet_config *config = &remote_protocol_packets[packet];
2153 return packet_config_support (config);
2157 show_remote_protocol_packet_cmd (struct ui_file *file, int from_tty,
2158 struct cmd_list_element *c,
2161 struct packet_config *packet;
2163 for (packet = remote_protocol_packets;
2164 packet < &remote_protocol_packets[PACKET_MAX];
2167 if (&packet->detect == c->var)
2169 show_packet_config_cmd (packet);
2173 internal_error (__FILE__, __LINE__, _("Could not find config for %s"),
2177 /* Should we try one of the 'Z' requests? */
2181 Z_PACKET_SOFTWARE_BP,
2182 Z_PACKET_HARDWARE_BP,
2189 /* For compatibility with older distributions. Provide a ``set remote
2190 Z-packet ...'' command that updates all the Z packet types. */
2192 static enum auto_boolean remote_Z_packet_detect;
2195 set_remote_protocol_Z_packet_cmd (const char *args, int from_tty,
2196 struct cmd_list_element *c)
2200 for (i = 0; i < NR_Z_PACKET_TYPES; i++)
2201 remote_protocol_packets[PACKET_Z0 + i].detect = remote_Z_packet_detect;
2205 show_remote_protocol_Z_packet_cmd (struct ui_file *file, int from_tty,
2206 struct cmd_list_element *c,
2211 for (i = 0; i < NR_Z_PACKET_TYPES; i++)
2213 show_packet_config_cmd (&remote_protocol_packets[PACKET_Z0 + i]);
2217 /* Returns true if the multi-process extensions are in effect. */
2220 remote_multi_process_p (struct remote_state *rs)
2222 return packet_support (PACKET_multiprocess_feature) == PACKET_ENABLE;
2225 /* Returns true if fork events are supported. */
2228 remote_fork_event_p (struct remote_state *rs)
2230 return packet_support (PACKET_fork_event_feature) == PACKET_ENABLE;
2233 /* Returns true if vfork events are supported. */
2236 remote_vfork_event_p (struct remote_state *rs)
2238 return packet_support (PACKET_vfork_event_feature) == PACKET_ENABLE;
2241 /* Returns true if exec events are supported. */
2244 remote_exec_event_p (struct remote_state *rs)
2246 return packet_support (PACKET_exec_event_feature) == PACKET_ENABLE;
2249 /* Insert fork catchpoint target routine. If fork events are enabled
2250 then return success, nothing more to do. */
2253 remote_target::insert_fork_catchpoint (int pid)
2255 struct remote_state *rs = get_remote_state ();
2257 return !remote_fork_event_p (rs);
2260 /* Remove fork catchpoint target routine. Nothing to do, just
2264 remote_target::remove_fork_catchpoint (int pid)
2269 /* Insert vfork catchpoint target routine. If vfork events are enabled
2270 then return success, nothing more to do. */
2273 remote_target::insert_vfork_catchpoint (int pid)
2275 struct remote_state *rs = get_remote_state ();
2277 return !remote_vfork_event_p (rs);
2280 /* Remove vfork catchpoint target routine. Nothing to do, just
2284 remote_target::remove_vfork_catchpoint (int pid)
2289 /* Insert exec catchpoint target routine. If exec events are
2290 enabled, just return success. */
2293 remote_target::insert_exec_catchpoint (int pid)
2295 struct remote_state *rs = get_remote_state ();
2297 return !remote_exec_event_p (rs);
2300 /* Remove exec catchpoint target routine. Nothing to do, just
2304 remote_target::remove_exec_catchpoint (int pid)
2311 static ptid_t magic_null_ptid;
2312 static ptid_t not_sent_ptid;
2313 static ptid_t any_thread_ptid;
2315 /* Find out if the stub attached to PID (and hence GDB should offer to
2316 detach instead of killing it when bailing out). */
2319 remote_target::remote_query_attached (int pid)
2321 struct remote_state *rs = get_remote_state ();
2322 size_t size = get_remote_packet_size ();
2324 if (packet_support (PACKET_qAttached) == PACKET_DISABLE)
2327 if (remote_multi_process_p (rs))
2328 xsnprintf (rs->buf.data (), size, "qAttached:%x", pid);
2330 xsnprintf (rs->buf.data (), size, "qAttached");
2333 getpkt (&rs->buf, 0);
2335 switch (packet_ok (rs->buf,
2336 &remote_protocol_packets[PACKET_qAttached]))
2339 if (strcmp (rs->buf.data (), "1") == 0)
2343 warning (_("Remote failure reply: %s"), rs->buf.data ());
2345 case PACKET_UNKNOWN:
2352 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
2353 has been invented by GDB, instead of reported by the target. Since
2354 we can be connected to a remote system before before knowing about
2355 any inferior, mark the target with execution when we find the first
2356 inferior. If ATTACHED is 1, then we had just attached to this
2357 inferior. If it is 0, then we just created this inferior. If it
2358 is -1, then try querying the remote stub to find out if it had
2359 attached to the inferior or not. If TRY_OPEN_EXEC is true then
2360 attempt to open this inferior's executable as the main executable
2361 if no main executable is open already. */
2364 remote_target::remote_add_inferior (int fake_pid_p, int pid, int attached,
2367 struct inferior *inf;
2369 /* Check whether this process we're learning about is to be
2370 considered attached, or if is to be considered to have been
2371 spawned by the stub. */
2373 attached = remote_query_attached (pid);
2375 if (gdbarch_has_global_solist (target_gdbarch ()))
2377 /* If the target shares code across all inferiors, then every
2378 attach adds a new inferior. */
2379 inf = add_inferior (pid);
2381 /* ... and every inferior is bound to the same program space.
2382 However, each inferior may still have its own address
2384 inf->aspace = maybe_new_address_space ();
2385 inf->pspace = current_program_space;
2389 /* In the traditional debugging scenario, there's a 1-1 match
2390 between program/address spaces. We simply bind the inferior
2391 to the program space's address space. */
2392 inf = current_inferior ();
2393 inferior_appeared (inf, pid);
2396 inf->attach_flag = attached;
2397 inf->fake_pid_p = fake_pid_p;
2399 /* If no main executable is currently open then attempt to
2400 open the file that was executed to create this inferior. */
2401 if (try_open_exec && get_exec_file (0) == NULL)
2402 exec_file_locate_attach (pid, 0, 1);
2407 static remote_thread_info *get_remote_thread_info (thread_info *thread);
2408 static remote_thread_info *get_remote_thread_info (ptid_t ptid);
2410 /* Add thread PTID to GDB's thread list. Tag it as executing/running
2411 according to RUNNING. */
2414 remote_target::remote_add_thread (ptid_t ptid, bool running, bool executing)
2416 struct remote_state *rs = get_remote_state ();
2417 struct thread_info *thread;
2419 /* GDB historically didn't pull threads in the initial connection
2420 setup. If the remote target doesn't even have a concept of
2421 threads (e.g., a bare-metal target), even if internally we
2422 consider that a single-threaded target, mentioning a new thread
2423 might be confusing to the user. Be silent then, preserving the
2424 age old behavior. */
2425 if (rs->starting_up)
2426 thread = add_thread_silent (ptid);
2428 thread = add_thread (ptid);
2430 get_remote_thread_info (thread)->vcont_resumed = executing;
2431 set_executing (ptid, executing);
2432 set_running (ptid, running);
2437 /* Come here when we learn about a thread id from the remote target.
2438 It may be the first time we hear about such thread, so take the
2439 opportunity to add it to GDB's thread list. In case this is the
2440 first time we're noticing its corresponding inferior, add it to
2441 GDB's inferior list as well. EXECUTING indicates whether the
2442 thread is (internally) executing or stopped. */
2445 remote_target::remote_notice_new_inferior (ptid_t currthread, int executing)
2447 /* In non-stop mode, we assume new found threads are (externally)
2448 running until proven otherwise with a stop reply. In all-stop,
2449 we can only get here if all threads are stopped. */
2450 int running = target_is_non_stop_p () ? 1 : 0;
2452 /* If this is a new thread, add it to GDB's thread list.
2453 If we leave it up to WFI to do this, bad things will happen. */
2455 thread_info *tp = find_thread_ptid (currthread);
2456 if (tp != NULL && tp->state == THREAD_EXITED)
2458 /* We're seeing an event on a thread id we knew had exited.
2459 This has to be a new thread reusing the old id. Add it. */
2460 remote_add_thread (currthread, running, executing);
2464 if (!in_thread_list (currthread))
2466 struct inferior *inf = NULL;
2467 int pid = currthread.pid ();
2469 if (inferior_ptid.is_pid ()
2470 && pid == inferior_ptid.pid ())
2472 /* inferior_ptid has no thread member yet. This can happen
2473 with the vAttach -> remote_wait,"TAAthread:" path if the
2474 stub doesn't support qC. This is the first stop reported
2475 after an attach, so this is the main thread. Update the
2476 ptid in the thread list. */
2477 if (in_thread_list (ptid_t (pid)))
2478 thread_change_ptid (inferior_ptid, currthread);
2481 remote_add_thread (currthread, running, executing);
2482 inferior_ptid = currthread;
2487 if (magic_null_ptid == inferior_ptid)
2489 /* inferior_ptid is not set yet. This can happen with the
2490 vRun -> remote_wait,"TAAthread:" path if the stub
2491 doesn't support qC. This is the first stop reported
2492 after an attach, so this is the main thread. Update the
2493 ptid in the thread list. */
2494 thread_change_ptid (inferior_ptid, currthread);
2498 /* When connecting to a target remote, or to a target
2499 extended-remote which already was debugging an inferior, we
2500 may not know about it yet. Add it before adding its child
2501 thread, so notifications are emitted in a sensible order. */
2502 if (find_inferior_pid (currthread.pid ()) == NULL)
2504 struct remote_state *rs = get_remote_state ();
2505 int fake_pid_p = !remote_multi_process_p (rs);
2507 inf = remote_add_inferior (fake_pid_p,
2508 currthread.pid (), -1, 1);
2511 /* This is really a new thread. Add it. */
2512 thread_info *new_thr
2513 = remote_add_thread (currthread, running, executing);
2515 /* If we found a new inferior, let the common code do whatever
2516 it needs to with it (e.g., read shared libraries, insert
2517 breakpoints), unless we're just setting up an all-stop
2521 struct remote_state *rs = get_remote_state ();
2523 if (!rs->starting_up)
2524 notice_new_inferior (new_thr, executing, 0);
2529 /* Return THREAD's private thread data, creating it if necessary. */
2531 static remote_thread_info *
2532 get_remote_thread_info (thread_info *thread)
2534 gdb_assert (thread != NULL);
2536 if (thread->priv == NULL)
2537 thread->priv.reset (new remote_thread_info);
2539 return static_cast<remote_thread_info *> (thread->priv.get ());
2542 static remote_thread_info *
2543 get_remote_thread_info (ptid_t ptid)
2545 thread_info *thr = find_thread_ptid (ptid);
2546 return get_remote_thread_info (thr);
2549 /* Call this function as a result of
2550 1) A halt indication (T packet) containing a thread id
2551 2) A direct query of currthread
2552 3) Successful execution of set thread */
2555 record_currthread (struct remote_state *rs, ptid_t currthread)
2557 rs->general_thread = currthread;
2560 /* If 'QPassSignals' is supported, tell the remote stub what signals
2561 it can simply pass through to the inferior without reporting. */
2564 remote_target::pass_signals (int numsigs, const unsigned char *pass_signals)
2566 if (packet_support (PACKET_QPassSignals) != PACKET_DISABLE)
2568 char *pass_packet, *p;
2570 struct remote_state *rs = get_remote_state ();
2572 gdb_assert (numsigs < 256);
2573 for (i = 0; i < numsigs; i++)
2575 if (pass_signals[i])
2578 pass_packet = (char *) xmalloc (count * 3 + strlen ("QPassSignals:") + 1);
2579 strcpy (pass_packet, "QPassSignals:");
2580 p = pass_packet + strlen (pass_packet);
2581 for (i = 0; i < numsigs; i++)
2583 if (pass_signals[i])
2586 *p++ = tohex (i >> 4);
2587 *p++ = tohex (i & 15);
2596 if (!rs->last_pass_packet || strcmp (rs->last_pass_packet, pass_packet))
2598 putpkt (pass_packet);
2599 getpkt (&rs->buf, 0);
2600 packet_ok (rs->buf, &remote_protocol_packets[PACKET_QPassSignals]);
2601 if (rs->last_pass_packet)
2602 xfree (rs->last_pass_packet);
2603 rs->last_pass_packet = pass_packet;
2606 xfree (pass_packet);
2610 /* If 'QCatchSyscalls' is supported, tell the remote stub
2611 to report syscalls to GDB. */
2614 remote_target::set_syscall_catchpoint (int pid, bool needed, int any_count,
2615 gdb::array_view<const int> syscall_counts)
2617 const char *catch_packet;
2618 enum packet_result result;
2621 if (packet_support (PACKET_QCatchSyscalls) == PACKET_DISABLE)
2623 /* Not supported. */
2627 if (needed && any_count == 0)
2629 /* Count how many syscalls are to be caught. */
2630 for (size_t i = 0; i < syscall_counts.size (); i++)
2632 if (syscall_counts[i] != 0)
2639 fprintf_unfiltered (gdb_stdlog,
2640 "remote_set_syscall_catchpoint "
2641 "pid %d needed %d any_count %d n_sysno %d\n",
2642 pid, needed, any_count, n_sysno);
2645 std::string built_packet;
2648 /* Prepare a packet with the sysno list, assuming max 8+1
2649 characters for a sysno. If the resulting packet size is too
2650 big, fallback on the non-selective packet. */
2651 const int maxpktsz = strlen ("QCatchSyscalls:1") + n_sysno * 9 + 1;
2652 built_packet.reserve (maxpktsz);
2653 built_packet = "QCatchSyscalls:1";
2656 /* Add in each syscall to be caught. */
2657 for (size_t i = 0; i < syscall_counts.size (); i++)
2659 if (syscall_counts[i] != 0)
2660 string_appendf (built_packet, ";%zx", i);
2663 if (built_packet.size () > get_remote_packet_size ())
2665 /* catch_packet too big. Fallback to less efficient
2666 non selective mode, with GDB doing the filtering. */
2667 catch_packet = "QCatchSyscalls:1";
2670 catch_packet = built_packet.c_str ();
2673 catch_packet = "QCatchSyscalls:0";
2675 struct remote_state *rs = get_remote_state ();
2677 putpkt (catch_packet);
2678 getpkt (&rs->buf, 0);
2679 result = packet_ok (rs->buf, &remote_protocol_packets[PACKET_QCatchSyscalls]);
2680 if (result == PACKET_OK)
2686 /* If 'QProgramSignals' is supported, tell the remote stub what
2687 signals it should pass through to the inferior when detaching. */
2690 remote_target::program_signals (int numsigs, const unsigned char *signals)
2692 if (packet_support (PACKET_QProgramSignals) != PACKET_DISABLE)
2696 struct remote_state *rs = get_remote_state ();
2698 gdb_assert (numsigs < 256);
2699 for (i = 0; i < numsigs; i++)
2704 packet = (char *) xmalloc (count * 3 + strlen ("QProgramSignals:") + 1);
2705 strcpy (packet, "QProgramSignals:");
2706 p = packet + strlen (packet);
2707 for (i = 0; i < numsigs; i++)
2709 if (signal_pass_state (i))
2712 *p++ = tohex (i >> 4);
2713 *p++ = tohex (i & 15);
2722 if (!rs->last_program_signals_packet
2723 || strcmp (rs->last_program_signals_packet, packet) != 0)
2726 getpkt (&rs->buf, 0);
2727 packet_ok (rs->buf, &remote_protocol_packets[PACKET_QProgramSignals]);
2728 xfree (rs->last_program_signals_packet);
2729 rs->last_program_signals_packet = packet;
2736 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
2737 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
2738 thread. If GEN is set, set the general thread, if not, then set
2739 the step/continue thread. */
2741 remote_target::set_thread (ptid_t ptid, int gen)
2743 struct remote_state *rs = get_remote_state ();
2744 ptid_t state = gen ? rs->general_thread : rs->continue_thread;
2745 char *buf = rs->buf.data ();
2746 char *endbuf = buf + get_remote_packet_size ();
2752 *buf++ = gen ? 'g' : 'c';
2753 if (ptid == magic_null_ptid)
2754 xsnprintf (buf, endbuf - buf, "0");
2755 else if (ptid == any_thread_ptid)
2756 xsnprintf (buf, endbuf - buf, "0");
2757 else if (ptid == minus_one_ptid)
2758 xsnprintf (buf, endbuf - buf, "-1");
2760 write_ptid (buf, endbuf, ptid);
2762 getpkt (&rs->buf, 0);
2764 rs->general_thread = ptid;
2766 rs->continue_thread = ptid;
2770 remote_target::set_general_thread (ptid_t ptid)
2772 set_thread (ptid, 1);
2776 remote_target::set_continue_thread (ptid_t ptid)
2778 set_thread (ptid, 0);
2781 /* Change the remote current process. Which thread within the process
2782 ends up selected isn't important, as long as it is the same process
2783 as what INFERIOR_PTID points to.
2785 This comes from that fact that there is no explicit notion of
2786 "selected process" in the protocol. The selected process for
2787 general operations is the process the selected general thread
2791 remote_target::set_general_process ()
2793 struct remote_state *rs = get_remote_state ();
2795 /* If the remote can't handle multiple processes, don't bother. */
2796 if (!remote_multi_process_p (rs))
2799 /* We only need to change the remote current thread if it's pointing
2800 at some other process. */
2801 if (rs->general_thread.pid () != inferior_ptid.pid ())
2802 set_general_thread (inferior_ptid);
2806 /* Return nonzero if this is the main thread that we made up ourselves
2807 to model non-threaded targets as single-threaded. */
2810 remote_thread_always_alive (ptid_t ptid)
2812 if (ptid == magic_null_ptid)
2813 /* The main thread is always alive. */
2816 if (ptid.pid () != 0 && ptid.lwp () == 0)
2817 /* The main thread is always alive. This can happen after a
2818 vAttach, if the remote side doesn't support
2825 /* Return nonzero if the thread PTID is still alive on the remote
2829 remote_target::thread_alive (ptid_t ptid)
2831 struct remote_state *rs = get_remote_state ();
2834 /* Check if this is a thread that we made up ourselves to model
2835 non-threaded targets as single-threaded. */
2836 if (remote_thread_always_alive (ptid))
2839 p = rs->buf.data ();
2840 endp = p + get_remote_packet_size ();
2843 write_ptid (p, endp, ptid);
2846 getpkt (&rs->buf, 0);
2847 return (rs->buf[0] == 'O' && rs->buf[1] == 'K');
2850 /* Return a pointer to a thread name if we know it and NULL otherwise.
2851 The thread_info object owns the memory for the name. */
2854 remote_target::thread_name (struct thread_info *info)
2856 if (info->priv != NULL)
2858 const std::string &name = get_remote_thread_info (info)->name;
2859 return !name.empty () ? name.c_str () : NULL;
2865 /* About these extended threadlist and threadinfo packets. They are
2866 variable length packets but, the fields within them are often fixed
2867 length. They are redundent enough to send over UDP as is the
2868 remote protocol in general. There is a matching unit test module
2871 /* WARNING: This threadref data structure comes from the remote O.S.,
2872 libstub protocol encoding, and remote.c. It is not particularly
2875 /* Right now, the internal structure is int. We want it to be bigger.
2876 Plan to fix this. */
2878 typedef int gdb_threadref; /* Internal GDB thread reference. */
2880 /* gdb_ext_thread_info is an internal GDB data structure which is
2881 equivalent to the reply of the remote threadinfo packet. */
2883 struct gdb_ext_thread_info
2885 threadref threadid; /* External form of thread reference. */
2886 int active; /* Has state interesting to GDB?
2888 char display[256]; /* Brief state display, name,
2889 blocked/suspended. */
2890 char shortname[32]; /* To be used to name threads. */
2891 char more_display[256]; /* Long info, statistics, queue depth,
2895 /* The volume of remote transfers can be limited by submitting
2896 a mask containing bits specifying the desired information.
2897 Use a union of these values as the 'selection' parameter to
2898 get_thread_info. FIXME: Make these TAG names more thread specific. */
2900 #define TAG_THREADID 1
2901 #define TAG_EXISTS 2
2902 #define TAG_DISPLAY 4
2903 #define TAG_THREADNAME 8
2904 #define TAG_MOREDISPLAY 16
2906 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
2908 static char *unpack_nibble (char *buf, int *val);
2910 static char *unpack_byte (char *buf, int *value);
2912 static char *pack_int (char *buf, int value);
2914 static char *unpack_int (char *buf, int *value);
2916 static char *unpack_string (char *src, char *dest, int length);
2918 static char *pack_threadid (char *pkt, threadref *id);
2920 static char *unpack_threadid (char *inbuf, threadref *id);
2922 void int_to_threadref (threadref *id, int value);
2924 static int threadref_to_int (threadref *ref);
2926 static void copy_threadref (threadref *dest, threadref *src);
2928 static int threadmatch (threadref *dest, threadref *src);
2930 static char *pack_threadinfo_request (char *pkt, int mode,
2933 static char *pack_threadlist_request (char *pkt, int startflag,
2935 threadref *nextthread);
2937 static int remote_newthread_step (threadref *ref, void *context);
2940 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
2941 buffer we're allowed to write to. Returns
2942 BUF+CHARACTERS_WRITTEN. */
2945 remote_target::write_ptid (char *buf, const char *endbuf, ptid_t ptid)
2948 struct remote_state *rs = get_remote_state ();
2950 if (remote_multi_process_p (rs))
2954 buf += xsnprintf (buf, endbuf - buf, "p-%x.", -pid);
2956 buf += xsnprintf (buf, endbuf - buf, "p%x.", pid);
2960 buf += xsnprintf (buf, endbuf - buf, "-%x", -tid);
2962 buf += xsnprintf (buf, endbuf - buf, "%x", tid);
2967 /* Extract a PTID from BUF. If non-null, OBUF is set to one past the
2968 last parsed char. Returns null_ptid if no thread id is found, and
2969 throws an error if the thread id has an invalid format. */
2972 read_ptid (const char *buf, const char **obuf)
2974 const char *p = buf;
2976 ULONGEST pid = 0, tid = 0;
2980 /* Multi-process ptid. */
2981 pp = unpack_varlen_hex (p + 1, &pid);
2983 error (_("invalid remote ptid: %s"), p);
2986 pp = unpack_varlen_hex (p + 1, &tid);
2989 return ptid_t (pid, tid, 0);
2992 /* No multi-process. Just a tid. */
2993 pp = unpack_varlen_hex (p, &tid);
2995 /* Return null_ptid when no thread id is found. */
3003 /* Since the stub is not sending a process id, then default to
3004 what's in inferior_ptid, unless it's null at this point. If so,
3005 then since there's no way to know the pid of the reported
3006 threads, use the magic number. */
3007 if (inferior_ptid == null_ptid)
3008 pid = magic_null_ptid.pid ();
3010 pid = inferior_ptid.pid ();
3014 return ptid_t (pid, tid, 0);
3020 if (ch >= 'a' && ch <= 'f')
3021 return ch - 'a' + 10;
3022 if (ch >= '0' && ch <= '9')
3024 if (ch >= 'A' && ch <= 'F')
3025 return ch - 'A' + 10;
3030 stub_unpack_int (char *buff, int fieldlength)
3037 nibble = stubhex (*buff++);
3041 retval = retval << 4;
3047 unpack_nibble (char *buf, int *val)
3049 *val = fromhex (*buf++);
3054 unpack_byte (char *buf, int *value)
3056 *value = stub_unpack_int (buf, 2);
3061 pack_int (char *buf, int value)
3063 buf = pack_hex_byte (buf, (value >> 24) & 0xff);
3064 buf = pack_hex_byte (buf, (value >> 16) & 0xff);
3065 buf = pack_hex_byte (buf, (value >> 8) & 0x0ff);
3066 buf = pack_hex_byte (buf, (value & 0xff));
3071 unpack_int (char *buf, int *value)
3073 *value = stub_unpack_int (buf, 8);
3077 #if 0 /* Currently unused, uncomment when needed. */
3078 static char *pack_string (char *pkt, char *string);
3081 pack_string (char *pkt, char *string)
3086 len = strlen (string);
3088 len = 200; /* Bigger than most GDB packets, junk??? */
3089 pkt = pack_hex_byte (pkt, len);
3093 if ((ch == '\0') || (ch == '#'))
3094 ch = '*'; /* Protect encapsulation. */
3099 #endif /* 0 (unused) */
3102 unpack_string (char *src, char *dest, int length)
3111 pack_threadid (char *pkt, threadref *id)
3114 unsigned char *altid;
3116 altid = (unsigned char *) id;
3117 limit = pkt + BUF_THREAD_ID_SIZE;
3119 pkt = pack_hex_byte (pkt, *altid++);
3125 unpack_threadid (char *inbuf, threadref *id)
3128 char *limit = inbuf + BUF_THREAD_ID_SIZE;
3131 altref = (char *) id;
3133 while (inbuf < limit)
3135 x = stubhex (*inbuf++);
3136 y = stubhex (*inbuf++);
3137 *altref++ = (x << 4) | y;
3142 /* Externally, threadrefs are 64 bits but internally, they are still
3143 ints. This is due to a mismatch of specifications. We would like
3144 to use 64bit thread references internally. This is an adapter
3148 int_to_threadref (threadref *id, int value)
3150 unsigned char *scan;
3152 scan = (unsigned char *) id;
3158 *scan++ = (value >> 24) & 0xff;
3159 *scan++ = (value >> 16) & 0xff;
3160 *scan++ = (value >> 8) & 0xff;
3161 *scan++ = (value & 0xff);
3165 threadref_to_int (threadref *ref)
3168 unsigned char *scan;
3174 value = (value << 8) | ((*scan++) & 0xff);
3179 copy_threadref (threadref *dest, threadref *src)
3182 unsigned char *csrc, *cdest;
3184 csrc = (unsigned char *) src;
3185 cdest = (unsigned char *) dest;
3192 threadmatch (threadref *dest, threadref *src)
3194 /* Things are broken right now, so just assume we got a match. */
3196 unsigned char *srcp, *destp;
3198 srcp = (char *) src;
3199 destp = (char *) dest;
3203 result &= (*srcp++ == *destp++) ? 1 : 0;
3210 threadid:1, # always request threadid
3217 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
3220 pack_threadinfo_request (char *pkt, int mode, threadref *id)
3222 *pkt++ = 'q'; /* Info Query */
3223 *pkt++ = 'P'; /* process or thread info */
3224 pkt = pack_int (pkt, mode); /* mode */
3225 pkt = pack_threadid (pkt, id); /* threadid */
3226 *pkt = '\0'; /* terminate */
3230 /* These values tag the fields in a thread info response packet. */
3231 /* Tagging the fields allows us to request specific fields and to
3232 add more fields as time goes by. */
3234 #define TAG_THREADID 1 /* Echo the thread identifier. */
3235 #define TAG_EXISTS 2 /* Is this process defined enough to
3236 fetch registers and its stack? */
3237 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
3238 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
3239 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
3243 remote_target::remote_unpack_thread_info_response (char *pkt,
3244 threadref *expectedref,
3245 gdb_ext_thread_info *info)
3247 struct remote_state *rs = get_remote_state ();
3251 char *limit = pkt + rs->buf.size (); /* Plausible parsing limit. */
3254 /* info->threadid = 0; FIXME: implement zero_threadref. */
3256 info->display[0] = '\0';
3257 info->shortname[0] = '\0';
3258 info->more_display[0] = '\0';
3260 /* Assume the characters indicating the packet type have been
3262 pkt = unpack_int (pkt, &mask); /* arg mask */
3263 pkt = unpack_threadid (pkt, &ref);
3266 warning (_("Incomplete response to threadinfo request."));
3267 if (!threadmatch (&ref, expectedref))
3268 { /* This is an answer to a different request. */
3269 warning (_("ERROR RMT Thread info mismatch."));
3272 copy_threadref (&info->threadid, &ref);
3274 /* Loop on tagged fields , try to bail if somthing goes wrong. */
3276 /* Packets are terminated with nulls. */
3277 while ((pkt < limit) && mask && *pkt)
3279 pkt = unpack_int (pkt, &tag); /* tag */
3280 pkt = unpack_byte (pkt, &length); /* length */
3281 if (!(tag & mask)) /* Tags out of synch with mask. */
3283 warning (_("ERROR RMT: threadinfo tag mismatch."));
3287 if (tag == TAG_THREADID)
3291 warning (_("ERROR RMT: length of threadid is not 16."));
3295 pkt = unpack_threadid (pkt, &ref);
3296 mask = mask & ~TAG_THREADID;
3299 if (tag == TAG_EXISTS)
3301 info->active = stub_unpack_int (pkt, length);
3303 mask = mask & ~(TAG_EXISTS);
3306 warning (_("ERROR RMT: 'exists' length too long."));
3312 if (tag == TAG_THREADNAME)
3314 pkt = unpack_string (pkt, &info->shortname[0], length);
3315 mask = mask & ~TAG_THREADNAME;
3318 if (tag == TAG_DISPLAY)
3320 pkt = unpack_string (pkt, &info->display[0], length);
3321 mask = mask & ~TAG_DISPLAY;
3324 if (tag == TAG_MOREDISPLAY)
3326 pkt = unpack_string (pkt, &info->more_display[0], length);
3327 mask = mask & ~TAG_MOREDISPLAY;
3330 warning (_("ERROR RMT: unknown thread info tag."));
3331 break; /* Not a tag we know about. */
3337 remote_target::remote_get_threadinfo (threadref *threadid,
3339 gdb_ext_thread_info *info)
3341 struct remote_state *rs = get_remote_state ();
3344 pack_threadinfo_request (rs->buf.data (), fieldset, threadid);
3346 getpkt (&rs->buf, 0);
3348 if (rs->buf[0] == '\0')
3351 result = remote_unpack_thread_info_response (&rs->buf[2],
3356 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
3359 pack_threadlist_request (char *pkt, int startflag, int threadcount,
3360 threadref *nextthread)
3362 *pkt++ = 'q'; /* info query packet */
3363 *pkt++ = 'L'; /* Process LIST or threadLIST request */
3364 pkt = pack_nibble (pkt, startflag); /* initflag 1 bytes */
3365 pkt = pack_hex_byte (pkt, threadcount); /* threadcount 2 bytes */
3366 pkt = pack_threadid (pkt, nextthread); /* 64 bit thread identifier */
3371 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
3374 remote_target::parse_threadlist_response (char *pkt, int result_limit,
3375 threadref *original_echo,
3376 threadref *resultlist,
3379 struct remote_state *rs = get_remote_state ();
3381 int count, resultcount, done;
3384 /* Assume the 'q' and 'M chars have been stripped. */
3385 limit = pkt + (rs->buf.size () - BUF_THREAD_ID_SIZE);
3386 /* done parse past here */
3387 pkt = unpack_byte (pkt, &count); /* count field */
3388 pkt = unpack_nibble (pkt, &done);
3389 /* The first threadid is the argument threadid. */
3390 pkt = unpack_threadid (pkt, original_echo); /* should match query packet */
3391 while ((count-- > 0) && (pkt < limit))
3393 pkt = unpack_threadid (pkt, resultlist++);
3394 if (resultcount++ >= result_limit)
3402 /* Fetch the next batch of threads from the remote. Returns -1 if the
3403 qL packet is not supported, 0 on error and 1 on success. */
3406 remote_target::remote_get_threadlist (int startflag, threadref *nextthread,
3407 int result_limit, int *done, int *result_count,
3408 threadref *threadlist)
3410 struct remote_state *rs = get_remote_state ();
3413 /* Trancate result limit to be smaller than the packet size. */
3414 if ((((result_limit + 1) * BUF_THREAD_ID_SIZE) + 10)
3415 >= get_remote_packet_size ())
3416 result_limit = (get_remote_packet_size () / BUF_THREAD_ID_SIZE) - 2;
3418 pack_threadlist_request (rs->buf.data (), startflag, result_limit,
3421 getpkt (&rs->buf, 0);
3422 if (rs->buf[0] == '\0')
3424 /* Packet not supported. */
3429 parse_threadlist_response (&rs->buf[2], result_limit,
3430 &rs->echo_nextthread, threadlist, done);
3432 if (!threadmatch (&rs->echo_nextthread, nextthread))
3434 /* FIXME: This is a good reason to drop the packet. */
3435 /* Possably, there is a duplicate response. */
3437 retransmit immediatly - race conditions
3438 retransmit after timeout - yes
3440 wait for packet, then exit
3442 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
3443 return 0; /* I choose simply exiting. */
3445 if (*result_count <= 0)
3449 warning (_("RMT ERROR : failed to get remote thread list."));
3452 return result; /* break; */
3454 if (*result_count > result_limit)
3457 warning (_("RMT ERROR: threadlist response longer than requested."));
3463 /* Fetch the list of remote threads, with the qL packet, and call
3464 STEPFUNCTION for each thread found. Stops iterating and returns 1
3465 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
3466 STEPFUNCTION returns false. If the packet is not supported,
3470 remote_target::remote_threadlist_iterator (rmt_thread_action stepfunction,
3471 void *context, int looplimit)
3473 struct remote_state *rs = get_remote_state ();
3474 int done, i, result_count;
3482 if (loopcount++ > looplimit)
3485 warning (_("Remote fetch threadlist -infinite loop-."));
3488 result = remote_get_threadlist (startflag, &rs->nextthread,
3489 MAXTHREADLISTRESULTS,
3490 &done, &result_count,
3491 rs->resultthreadlist);
3494 /* Clear for later iterations. */
3496 /* Setup to resume next batch of thread references, set nextthread. */
3497 if (result_count >= 1)
3498 copy_threadref (&rs->nextthread,
3499 &rs->resultthreadlist[result_count - 1]);
3501 while (result_count--)
3503 if (!(*stepfunction) (&rs->resultthreadlist[i++], context))
3513 /* A thread found on the remote target. */
3517 explicit thread_item (ptid_t ptid_)
3521 thread_item (thread_item &&other) = default;
3522 thread_item &operator= (thread_item &&other) = default;
3524 DISABLE_COPY_AND_ASSIGN (thread_item);
3526 /* The thread's PTID. */
3529 /* The thread's extra info. */
3532 /* The thread's name. */
3535 /* The core the thread was running on. -1 if not known. */
3538 /* The thread handle associated with the thread. */
3539 gdb::byte_vector thread_handle;
3542 /* Context passed around to the various methods listing remote
3543 threads. As new threads are found, they're added to the ITEMS
3546 struct threads_listing_context
3548 /* Return true if this object contains an entry for a thread with ptid
3551 bool contains_thread (ptid_t ptid) const
3553 auto match_ptid = [&] (const thread_item &item)
3555 return item.ptid == ptid;
3558 auto it = std::find_if (this->items.begin (),
3562 return it != this->items.end ();
3565 /* Remove the thread with ptid PTID. */
3567 void remove_thread (ptid_t ptid)
3569 auto match_ptid = [&] (const thread_item &item)
3571 return item.ptid == ptid;
3574 auto it = std::remove_if (this->items.begin (),
3578 if (it != this->items.end ())
3579 this->items.erase (it);
3582 /* The threads found on the remote target. */
3583 std::vector<thread_item> items;
3587 remote_newthread_step (threadref *ref, void *data)
3589 struct threads_listing_context *context
3590 = (struct threads_listing_context *) data;
3591 int pid = inferior_ptid.pid ();
3592 int lwp = threadref_to_int (ref);
3593 ptid_t ptid (pid, lwp);
3595 context->items.emplace_back (ptid);
3597 return 1; /* continue iterator */
3600 #define CRAZY_MAX_THREADS 1000
3603 remote_target::remote_current_thread (ptid_t oldpid)
3605 struct remote_state *rs = get_remote_state ();
3608 getpkt (&rs->buf, 0);
3609 if (rs->buf[0] == 'Q' && rs->buf[1] == 'C')
3614 result = read_ptid (&rs->buf[2], &obuf);
3615 if (*obuf != '\0' && remote_debug)
3616 fprintf_unfiltered (gdb_stdlog,
3617 "warning: garbage in qC reply\n");
3625 /* List remote threads using the deprecated qL packet. */
3628 remote_target::remote_get_threads_with_ql (threads_listing_context *context)
3630 if (remote_threadlist_iterator (remote_newthread_step, context,
3631 CRAZY_MAX_THREADS) >= 0)
3637 #if defined(HAVE_LIBEXPAT)
3640 start_thread (struct gdb_xml_parser *parser,
3641 const struct gdb_xml_element *element,
3643 std::vector<gdb_xml_value> &attributes)
3645 struct threads_listing_context *data
3646 = (struct threads_listing_context *) user_data;
3647 struct gdb_xml_value *attr;
3649 char *id = (char *) xml_find_attribute (attributes, "id")->value.get ();
3650 ptid_t ptid = read_ptid (id, NULL);
3652 data->items.emplace_back (ptid);
3653 thread_item &item = data->items.back ();
3655 attr = xml_find_attribute (attributes, "core");
3657 item.core = *(ULONGEST *) attr->value.get ();
3659 attr = xml_find_attribute (attributes, "name");
3661 item.name = (const char *) attr->value.get ();
3663 attr = xml_find_attribute (attributes, "handle");
3665 item.thread_handle = hex2bin ((const char *) attr->value.get ());
3669 end_thread (struct gdb_xml_parser *parser,
3670 const struct gdb_xml_element *element,
3671 void *user_data, const char *body_text)
3673 struct threads_listing_context *data
3674 = (struct threads_listing_context *) user_data;
3676 if (body_text != NULL && *body_text != '\0')
3677 data->items.back ().extra = body_text;
3680 const struct gdb_xml_attribute thread_attributes[] = {
3681 { "id", GDB_XML_AF_NONE, NULL, NULL },
3682 { "core", GDB_XML_AF_OPTIONAL, gdb_xml_parse_attr_ulongest, NULL },
3683 { "name", GDB_XML_AF_OPTIONAL, NULL, NULL },
3684 { "handle", GDB_XML_AF_OPTIONAL, NULL, NULL },
3685 { NULL, GDB_XML_AF_NONE, NULL, NULL }
3688 const struct gdb_xml_element thread_children[] = {
3689 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3692 const struct gdb_xml_element threads_children[] = {
3693 { "thread", thread_attributes, thread_children,
3694 GDB_XML_EF_REPEATABLE | GDB_XML_EF_OPTIONAL,
3695 start_thread, end_thread },
3696 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3699 const struct gdb_xml_element threads_elements[] = {
3700 { "threads", NULL, threads_children,
3701 GDB_XML_EF_NONE, NULL, NULL },
3702 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3707 /* List remote threads using qXfer:threads:read. */
3710 remote_target::remote_get_threads_with_qxfer (threads_listing_context *context)
3712 #if defined(HAVE_LIBEXPAT)
3713 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
3715 gdb::optional<gdb::char_vector> xml
3716 = target_read_stralloc (this, TARGET_OBJECT_THREADS, NULL);
3718 if (xml && (*xml)[0] != '\0')
3720 gdb_xml_parse_quick (_("threads"), "threads.dtd",
3721 threads_elements, xml->data (), context);
3731 /* List remote threads using qfThreadInfo/qsThreadInfo. */
3734 remote_target::remote_get_threads_with_qthreadinfo (threads_listing_context *context)
3736 struct remote_state *rs = get_remote_state ();
3738 if (rs->use_threadinfo_query)
3742 putpkt ("qfThreadInfo");
3743 getpkt (&rs->buf, 0);
3744 bufp = rs->buf.data ();
3745 if (bufp[0] != '\0') /* q packet recognized */
3747 while (*bufp++ == 'm') /* reply contains one or more TID */
3751 ptid_t ptid = read_ptid (bufp, &bufp);
3752 context->items.emplace_back (ptid);
3754 while (*bufp++ == ','); /* comma-separated list */
3755 putpkt ("qsThreadInfo");
3756 getpkt (&rs->buf, 0);
3757 bufp = rs->buf.data ();
3763 /* Packet not recognized. */
3764 rs->use_threadinfo_query = 0;
3771 /* Implement the to_update_thread_list function for the remote
3775 remote_target::update_thread_list ()
3777 struct threads_listing_context context;
3780 /* We have a few different mechanisms to fetch the thread list. Try
3781 them all, starting with the most preferred one first, falling
3782 back to older methods. */
3783 if (remote_get_threads_with_qxfer (&context)
3784 || remote_get_threads_with_qthreadinfo (&context)
3785 || remote_get_threads_with_ql (&context))
3789 if (context.items.empty ()
3790 && remote_thread_always_alive (inferior_ptid))
3792 /* Some targets don't really support threads, but still
3793 reply an (empty) thread list in response to the thread
3794 listing packets, instead of replying "packet not
3795 supported". Exit early so we don't delete the main
3800 /* CONTEXT now holds the current thread list on the remote
3801 target end. Delete GDB-side threads no longer found on the
3803 for (thread_info *tp : all_threads_safe ())
3805 if (!context.contains_thread (tp->ptid))
3812 /* Remove any unreported fork child threads from CONTEXT so
3813 that we don't interfere with follow fork, which is where
3814 creation of such threads is handled. */
3815 remove_new_fork_children (&context);
3817 /* And now add threads we don't know about yet to our list. */
3818 for (thread_item &item : context.items)
3820 if (item.ptid != null_ptid)
3822 /* In non-stop mode, we assume new found threads are
3823 executing until proven otherwise with a stop reply.
3824 In all-stop, we can only get here if all threads are
3826 int executing = target_is_non_stop_p () ? 1 : 0;
3828 remote_notice_new_inferior (item.ptid, executing);
3830 thread_info *tp = find_thread_ptid (item.ptid);
3831 remote_thread_info *info = get_remote_thread_info (tp);
3832 info->core = item.core;
3833 info->extra = std::move (item.extra);
3834 info->name = std::move (item.name);
3835 info->thread_handle = std::move (item.thread_handle);
3842 /* If no thread listing method is supported, then query whether
3843 each known thread is alive, one by one, with the T packet.
3844 If the target doesn't support threads at all, then this is a
3845 no-op. See remote_thread_alive. */
3851 * Collect a descriptive string about the given thread.
3852 * The target may say anything it wants to about the thread
3853 * (typically info about its blocked / runnable state, name, etc.).
3854 * This string will appear in the info threads display.
3856 * Optional: targets are not required to implement this function.
3860 remote_target::extra_thread_info (thread_info *tp)
3862 struct remote_state *rs = get_remote_state ();
3865 struct gdb_ext_thread_info threadinfo;
3867 if (rs->remote_desc == 0) /* paranoia */
3868 internal_error (__FILE__, __LINE__,
3869 _("remote_threads_extra_info"));
3871 if (tp->ptid == magic_null_ptid
3872 || (tp->ptid.pid () != 0 && tp->ptid.lwp () == 0))
3873 /* This is the main thread which was added by GDB. The remote
3874 server doesn't know about it. */
3877 std::string &extra = get_remote_thread_info (tp)->extra;
3879 /* If already have cached info, use it. */
3880 if (!extra.empty ())
3881 return extra.c_str ();
3883 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
3885 /* If we're using qXfer:threads:read, then the extra info is
3886 included in the XML. So if we didn't have anything cached,
3887 it's because there's really no extra info. */
3891 if (rs->use_threadextra_query)
3893 char *b = rs->buf.data ();
3894 char *endb = b + get_remote_packet_size ();
3896 xsnprintf (b, endb - b, "qThreadExtraInfo,");
3898 write_ptid (b, endb, tp->ptid);
3901 getpkt (&rs->buf, 0);
3902 if (rs->buf[0] != 0)
3904 extra.resize (strlen (rs->buf.data ()) / 2);
3905 hex2bin (rs->buf.data (), (gdb_byte *) &extra[0], extra.size ());
3906 return extra.c_str ();
3910 /* If the above query fails, fall back to the old method. */
3911 rs->use_threadextra_query = 0;
3912 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
3913 | TAG_MOREDISPLAY | TAG_DISPLAY;
3914 int_to_threadref (&id, tp->ptid.lwp ());
3915 if (remote_get_threadinfo (&id, set, &threadinfo))
3916 if (threadinfo.active)
3918 if (*threadinfo.shortname)
3919 string_appendf (extra, " Name: %s", threadinfo.shortname);
3920 if (*threadinfo.display)
3922 if (!extra.empty ())
3924 string_appendf (extra, " State: %s", threadinfo.display);
3926 if (*threadinfo.more_display)
3928 if (!extra.empty ())
3930 string_appendf (extra, " Priority: %s", threadinfo.more_display);
3932 return extra.c_str ();
3939 remote_target::static_tracepoint_marker_at (CORE_ADDR addr,
3940 struct static_tracepoint_marker *marker)
3942 struct remote_state *rs = get_remote_state ();
3943 char *p = rs->buf.data ();
3945 xsnprintf (p, get_remote_packet_size (), "qTSTMat:");
3947 p += hexnumstr (p, addr);
3949 getpkt (&rs->buf, 0);
3950 p = rs->buf.data ();
3953 error (_("Remote failure reply: %s"), p);
3957 parse_static_tracepoint_marker_definition (p, NULL, marker);
3964 std::vector<static_tracepoint_marker>
3965 remote_target::static_tracepoint_markers_by_strid (const char *strid)
3967 struct remote_state *rs = get_remote_state ();
3968 std::vector<static_tracepoint_marker> markers;
3970 static_tracepoint_marker marker;
3972 /* Ask for a first packet of static tracepoint marker
3975 getpkt (&rs->buf, 0);
3976 p = rs->buf.data ();
3978 error (_("Remote failure reply: %s"), p);
3984 parse_static_tracepoint_marker_definition (p, &p, &marker);
3986 if (strid == NULL || marker.str_id == strid)
3987 markers.push_back (std::move (marker));
3989 while (*p++ == ','); /* comma-separated list */
3990 /* Ask for another packet of static tracepoint definition. */
3992 getpkt (&rs->buf, 0);
3993 p = rs->buf.data ();
4000 /* Implement the to_get_ada_task_ptid function for the remote targets. */
4003 remote_target::get_ada_task_ptid (long lwp, long thread)
4005 return ptid_t (inferior_ptid.pid (), lwp, 0);
4009 /* Restart the remote side; this is an extended protocol operation. */
4012 remote_target::extended_remote_restart ()
4014 struct remote_state *rs = get_remote_state ();
4016 /* Send the restart command; for reasons I don't understand the
4017 remote side really expects a number after the "R". */
4018 xsnprintf (rs->buf.data (), get_remote_packet_size (), "R%x", 0);
4021 remote_fileio_reset ();
4024 /* Clean up connection to a remote debugger. */
4027 remote_target::close ()
4029 /* Make sure we leave stdin registered in the event loop. */
4032 /* We don't have a connection to the remote stub anymore. Get rid
4033 of all the inferiors and their threads we were controlling.
4034 Reset inferior_ptid to null_ptid first, as otherwise has_stack_frame
4035 will be unable to find the thread corresponding to (pid, 0, 0). */
4036 inferior_ptid = null_ptid;
4037 discard_all_inferiors ();
4039 trace_reset_local_state ();
4044 remote_target::~remote_target ()
4046 struct remote_state *rs = get_remote_state ();
4048 /* Check for NULL because we may get here with a partially
4049 constructed target/connection. */
4050 if (rs->remote_desc == nullptr)
4053 serial_close (rs->remote_desc);
4055 /* We are destroying the remote target, so we should discard
4056 everything of this target. */
4057 discard_pending_stop_replies_in_queue ();
4059 if (rs->remote_async_inferior_event_token)
4060 delete_async_event_handler (&rs->remote_async_inferior_event_token);
4062 remote_notif_state_xfree (rs->notif_state);
4065 /* Query the remote side for the text, data and bss offsets. */
4068 remote_target::get_offsets ()
4070 struct remote_state *rs = get_remote_state ();
4073 int lose, num_segments = 0, do_sections, do_segments;
4074 CORE_ADDR text_addr, data_addr, bss_addr, segments[2];
4075 struct section_offsets *offs;
4076 struct symfile_segment_data *data;
4078 if (symfile_objfile == NULL)
4081 putpkt ("qOffsets");
4082 getpkt (&rs->buf, 0);
4083 buf = rs->buf.data ();
4085 if (buf[0] == '\000')
4086 return; /* Return silently. Stub doesn't support
4090 warning (_("Remote failure reply: %s"), buf);
4094 /* Pick up each field in turn. This used to be done with scanf, but
4095 scanf will make trouble if CORE_ADDR size doesn't match
4096 conversion directives correctly. The following code will work
4097 with any size of CORE_ADDR. */
4098 text_addr = data_addr = bss_addr = 0;
4102 if (startswith (ptr, "Text="))
4105 /* Don't use strtol, could lose on big values. */
4106 while (*ptr && *ptr != ';')
4107 text_addr = (text_addr << 4) + fromhex (*ptr++);
4109 if (startswith (ptr, ";Data="))
4112 while (*ptr && *ptr != ';')
4113 data_addr = (data_addr << 4) + fromhex (*ptr++);
4118 if (!lose && startswith (ptr, ";Bss="))
4121 while (*ptr && *ptr != ';')
4122 bss_addr = (bss_addr << 4) + fromhex (*ptr++);
4124 if (bss_addr != data_addr)
4125 warning (_("Target reported unsupported offsets: %s"), buf);
4130 else if (startswith (ptr, "TextSeg="))
4133 /* Don't use strtol, could lose on big values. */
4134 while (*ptr && *ptr != ';')
4135 text_addr = (text_addr << 4) + fromhex (*ptr++);
4138 if (startswith (ptr, ";DataSeg="))
4141 while (*ptr && *ptr != ';')
4142 data_addr = (data_addr << 4) + fromhex (*ptr++);
4150 error (_("Malformed response to offset query, %s"), buf);
4151 else if (*ptr != '\0')
4152 warning (_("Target reported unsupported offsets: %s"), buf);
4154 offs = ((struct section_offsets *)
4155 alloca (SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections)));
4156 memcpy (offs, symfile_objfile->section_offsets,
4157 SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections));
4159 data = get_symfile_segment_data (symfile_objfile->obfd);
4160 do_segments = (data != NULL);
4161 do_sections = num_segments == 0;
4163 if (num_segments > 0)
4165 segments[0] = text_addr;
4166 segments[1] = data_addr;
4168 /* If we have two segments, we can still try to relocate everything
4169 by assuming that the .text and .data offsets apply to the whole
4170 text and data segments. Convert the offsets given in the packet
4171 to base addresses for symfile_map_offsets_to_segments. */
4172 else if (data && data->num_segments == 2)
4174 segments[0] = data->segment_bases[0] + text_addr;
4175 segments[1] = data->segment_bases[1] + data_addr;
4178 /* If the object file has only one segment, assume that it is text
4179 rather than data; main programs with no writable data are rare,
4180 but programs with no code are useless. Of course the code might
4181 have ended up in the data segment... to detect that we would need
4182 the permissions here. */
4183 else if (data && data->num_segments == 1)
4185 segments[0] = data->segment_bases[0] + text_addr;
4188 /* There's no way to relocate by segment. */
4194 int ret = symfile_map_offsets_to_segments (symfile_objfile->obfd, data,
4195 offs, num_segments, segments);
4197 if (ret == 0 && !do_sections)
4198 error (_("Can not handle qOffsets TextSeg "
4199 "response with this symbol file"));
4206 free_symfile_segment_data (data);
4210 offs->offsets[SECT_OFF_TEXT (symfile_objfile)] = text_addr;
4212 /* This is a temporary kludge to force data and bss to use the
4213 same offsets because that's what nlmconv does now. The real
4214 solution requires changes to the stub and remote.c that I
4215 don't have time to do right now. */
4217 offs->offsets[SECT_OFF_DATA (symfile_objfile)] = data_addr;
4218 offs->offsets[SECT_OFF_BSS (symfile_objfile)] = data_addr;
4221 objfile_relocate (symfile_objfile, offs);
4224 /* Send interrupt_sequence to remote target. */
4227 remote_target::send_interrupt_sequence ()
4229 struct remote_state *rs = get_remote_state ();
4231 if (interrupt_sequence_mode == interrupt_sequence_control_c)
4232 remote_serial_write ("\x03", 1);
4233 else if (interrupt_sequence_mode == interrupt_sequence_break)
4234 serial_send_break (rs->remote_desc);
4235 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
4237 serial_send_break (rs->remote_desc);
4238 remote_serial_write ("g", 1);
4241 internal_error (__FILE__, __LINE__,
4242 _("Invalid value for interrupt_sequence_mode: %s."),
4243 interrupt_sequence_mode);
4247 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
4248 and extract the PTID. Returns NULL_PTID if not found. */
4251 stop_reply_extract_thread (char *stop_reply)
4253 if (stop_reply[0] == 'T' && strlen (stop_reply) > 3)
4257 /* Txx r:val ; r:val (...) */
4260 /* Look for "register" named "thread". */
4265 p1 = strchr (p, ':');
4269 if (strncmp (p, "thread", p1 - p) == 0)
4270 return read_ptid (++p1, &p);
4272 p1 = strchr (p, ';');
4284 /* Determine the remote side's current thread. If we have a stop
4285 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
4286 "thread" register we can extract the current thread from. If not,
4287 ask the remote which is the current thread with qC. The former
4288 method avoids a roundtrip. */
4291 remote_target::get_current_thread (char *wait_status)
4293 ptid_t ptid = null_ptid;
4295 /* Note we don't use remote_parse_stop_reply as that makes use of
4296 the target architecture, which we haven't yet fully determined at
4298 if (wait_status != NULL)
4299 ptid = stop_reply_extract_thread (wait_status);
4300 if (ptid == null_ptid)
4301 ptid = remote_current_thread (inferior_ptid);
4306 /* Query the remote target for which is the current thread/process,
4307 add it to our tables, and update INFERIOR_PTID. The caller is
4308 responsible for setting the state such that the remote end is ready
4309 to return the current thread.
4311 This function is called after handling the '?' or 'vRun' packets,
4312 whose response is a stop reply from which we can also try
4313 extracting the thread. If the target doesn't support the explicit
4314 qC query, we infer the current thread from that stop reply, passed
4315 in in WAIT_STATUS, which may be NULL. */
4318 remote_target::add_current_inferior_and_thread (char *wait_status)
4320 struct remote_state *rs = get_remote_state ();
4323 inferior_ptid = null_ptid;
4325 /* Now, if we have thread information, update inferior_ptid. */
4326 ptid_t curr_ptid = get_current_thread (wait_status);
4328 if (curr_ptid != null_ptid)
4330 if (!remote_multi_process_p (rs))
4335 /* Without this, some commands which require an active target
4336 (such as kill) won't work. This variable serves (at least)
4337 double duty as both the pid of the target process (if it has
4338 such), and as a flag indicating that a target is active. */
4339 curr_ptid = magic_null_ptid;
4343 remote_add_inferior (fake_pid_p, curr_ptid.pid (), -1, 1);
4345 /* Add the main thread and switch to it. Don't try reading
4346 registers yet, since we haven't fetched the target description
4348 thread_info *tp = add_thread_silent (curr_ptid);
4349 switch_to_thread_no_regs (tp);
4352 /* Print info about a thread that was found already stopped on
4356 print_one_stopped_thread (struct thread_info *thread)
4358 struct target_waitstatus *ws = &thread->suspend.waitstatus;
4360 switch_to_thread (thread);
4361 thread->suspend.stop_pc = get_frame_pc (get_current_frame ());
4362 set_current_sal_from_frame (get_current_frame ());
4364 thread->suspend.waitstatus_pending_p = 0;
4366 if (ws->kind == TARGET_WAITKIND_STOPPED)
4368 enum gdb_signal sig = ws->value.sig;
4370 if (signal_print_state (sig))
4371 gdb::observers::signal_received.notify (sig);
4373 gdb::observers::normal_stop.notify (NULL, 1);
4376 /* Process all initial stop replies the remote side sent in response
4377 to the ? packet. These indicate threads that were already stopped
4378 on initial connection. We mark these threads as stopped and print
4379 their current frame before giving the user the prompt. */
4382 remote_target::process_initial_stop_replies (int from_tty)
4384 int pending_stop_replies = stop_reply_queue_length ();
4385 struct thread_info *selected = NULL;
4386 struct thread_info *lowest_stopped = NULL;
4387 struct thread_info *first = NULL;
4389 /* Consume the initial pending events. */
4390 while (pending_stop_replies-- > 0)
4392 ptid_t waiton_ptid = minus_one_ptid;
4394 struct target_waitstatus ws;
4395 int ignore_event = 0;
4397 memset (&ws, 0, sizeof (ws));
4398 event_ptid = target_wait (waiton_ptid, &ws, TARGET_WNOHANG);
4400 print_target_wait_results (waiton_ptid, event_ptid, &ws);
4404 case TARGET_WAITKIND_IGNORE:
4405 case TARGET_WAITKIND_NO_RESUMED:
4406 case TARGET_WAITKIND_SIGNALLED:
4407 case TARGET_WAITKIND_EXITED:
4408 /* We shouldn't see these, but if we do, just ignore. */
4410 fprintf_unfiltered (gdb_stdlog, "remote: event ignored\n");
4414 case TARGET_WAITKIND_EXECD:
4415 xfree (ws.value.execd_pathname);
4424 struct thread_info *evthread = find_thread_ptid (event_ptid);
4426 if (ws.kind == TARGET_WAITKIND_STOPPED)
4428 enum gdb_signal sig = ws.value.sig;
4430 /* Stubs traditionally report SIGTRAP as initial signal,
4431 instead of signal 0. Suppress it. */
4432 if (sig == GDB_SIGNAL_TRAP)
4434 evthread->suspend.stop_signal = sig;
4438 evthread->suspend.waitstatus = ws;
4440 if (ws.kind != TARGET_WAITKIND_STOPPED
4441 || ws.value.sig != GDB_SIGNAL_0)
4442 evthread->suspend.waitstatus_pending_p = 1;
4444 set_executing (event_ptid, 0);
4445 set_running (event_ptid, 0);
4446 get_remote_thread_info (evthread)->vcont_resumed = 0;
4449 /* "Notice" the new inferiors before anything related to
4450 registers/memory. */
4451 for (inferior *inf : all_non_exited_inferiors ())
4453 inf->needs_setup = 1;
4457 thread_info *thread = any_live_thread_of_inferior (inf);
4458 notice_new_inferior (thread, thread->state == THREAD_RUNNING,
4463 /* If all-stop on top of non-stop, pause all threads. Note this
4464 records the threads' stop pc, so must be done after "noticing"
4468 stop_all_threads ();
4470 /* If all threads of an inferior were already stopped, we
4471 haven't setup the inferior yet. */
4472 for (inferior *inf : all_non_exited_inferiors ())
4474 if (inf->needs_setup)
4476 thread_info *thread = any_live_thread_of_inferior (inf);
4477 switch_to_thread_no_regs (thread);
4483 /* Now go over all threads that are stopped, and print their current
4484 frame. If all-stop, then if there's a signalled thread, pick
4486 for (thread_info *thread : all_non_exited_threads ())
4492 thread->set_running (false);
4493 else if (thread->state != THREAD_STOPPED)
4496 if (selected == NULL
4497 && thread->suspend.waitstatus_pending_p)
4500 if (lowest_stopped == NULL
4501 || thread->inf->num < lowest_stopped->inf->num
4502 || thread->per_inf_num < lowest_stopped->per_inf_num)
4503 lowest_stopped = thread;
4506 print_one_stopped_thread (thread);
4509 /* In all-stop, we only print the status of one thread, and leave
4510 others with their status pending. */
4513 thread_info *thread = selected;
4515 thread = lowest_stopped;
4519 print_one_stopped_thread (thread);
4522 /* For "info program". */
4523 thread_info *thread = inferior_thread ();
4524 if (thread->state == THREAD_STOPPED)
4525 set_last_target_status (inferior_ptid, thread->suspend.waitstatus);
4528 /* Start the remote connection and sync state. */
4531 remote_target::start_remote (int from_tty, int extended_p)
4533 struct remote_state *rs = get_remote_state ();
4534 struct packet_config *noack_config;
4535 char *wait_status = NULL;
4537 /* Signal other parts that we're going through the initial setup,
4538 and so things may not be stable yet. E.g., we don't try to
4539 install tracepoints until we've relocated symbols. Also, a
4540 Ctrl-C before we're connected and synced up can't interrupt the
4541 target. Instead, it offers to drop the (potentially wedged)
4543 rs->starting_up = 1;
4547 if (interrupt_on_connect)
4548 send_interrupt_sequence ();
4550 /* Ack any packet which the remote side has already sent. */
4551 remote_serial_write ("+", 1);
4553 /* The first packet we send to the target is the optional "supported
4554 packets" request. If the target can answer this, it will tell us
4555 which later probes to skip. */
4556 remote_query_supported ();
4558 /* If the stub wants to get a QAllow, compose one and send it. */
4559 if (packet_support (PACKET_QAllow) != PACKET_DISABLE)
4562 /* gdbserver < 7.7 (before its fix from 2013-12-11) did reply to any
4563 unknown 'v' packet with string "OK". "OK" gets interpreted by GDB
4564 as a reply to known packet. For packet "vFile:setfs:" it is an
4565 invalid reply and GDB would return error in
4566 remote_hostio_set_filesystem, making remote files access impossible.
4567 Disable "vFile:setfs:" in such case. Do not disable other 'v' packets as
4568 other "vFile" packets get correctly detected even on gdbserver < 7.7. */
4570 const char v_mustreplyempty[] = "vMustReplyEmpty";
4572 putpkt (v_mustreplyempty);
4573 getpkt (&rs->buf, 0);
4574 if (strcmp (rs->buf.data (), "OK") == 0)
4575 remote_protocol_packets[PACKET_vFile_setfs].support = PACKET_DISABLE;
4576 else if (strcmp (rs->buf.data (), "") != 0)
4577 error (_("Remote replied unexpectedly to '%s': %s"), v_mustreplyempty,
4581 /* Next, we possibly activate noack mode.
4583 If the QStartNoAckMode packet configuration is set to AUTO,
4584 enable noack mode if the stub reported a wish for it with
4587 If set to TRUE, then enable noack mode even if the stub didn't
4588 report it in qSupported. If the stub doesn't reply OK, the
4589 session ends with an error.
4591 If FALSE, then don't activate noack mode, regardless of what the
4592 stub claimed should be the default with qSupported. */
4594 noack_config = &remote_protocol_packets[PACKET_QStartNoAckMode];
4595 if (packet_config_support (noack_config) != PACKET_DISABLE)
4597 putpkt ("QStartNoAckMode");
4598 getpkt (&rs->buf, 0);
4599 if (packet_ok (rs->buf, noack_config) == PACKET_OK)
4605 /* Tell the remote that we are using the extended protocol. */
4607 getpkt (&rs->buf, 0);
4610 /* Let the target know which signals it is allowed to pass down to
4612 update_signals_program_target ();
4614 /* Next, if the target can specify a description, read it. We do
4615 this before anything involving memory or registers. */
4616 target_find_description ();
4618 /* Next, now that we know something about the target, update the
4619 address spaces in the program spaces. */
4620 update_address_spaces ();
4622 /* On OSs where the list of libraries is global to all
4623 processes, we fetch them early. */
4624 if (gdbarch_has_global_solist (target_gdbarch ()))
4625 solib_add (NULL, from_tty, auto_solib_add);
4627 if (target_is_non_stop_p ())
4629 if (packet_support (PACKET_QNonStop) != PACKET_ENABLE)
4630 error (_("Non-stop mode requested, but remote "
4631 "does not support non-stop"));
4633 putpkt ("QNonStop:1");
4634 getpkt (&rs->buf, 0);
4636 if (strcmp (rs->buf.data (), "OK") != 0)
4637 error (_("Remote refused setting non-stop mode with: %s"),
4640 /* Find about threads and processes the stub is already
4641 controlling. We default to adding them in the running state.
4642 The '?' query below will then tell us about which threads are
4644 this->update_thread_list ();
4646 else if (packet_support (PACKET_QNonStop) == PACKET_ENABLE)
4648 /* Don't assume that the stub can operate in all-stop mode.
4649 Request it explicitly. */
4650 putpkt ("QNonStop:0");
4651 getpkt (&rs->buf, 0);
4653 if (strcmp (rs->buf.data (), "OK") != 0)
4654 error (_("Remote refused setting all-stop mode with: %s"),
4658 /* Upload TSVs regardless of whether the target is running or not. The
4659 remote stub, such as GDBserver, may have some predefined or builtin
4660 TSVs, even if the target is not running. */
4661 if (get_trace_status (current_trace_status ()) != -1)
4663 struct uploaded_tsv *uploaded_tsvs = NULL;
4665 upload_trace_state_variables (&uploaded_tsvs);
4666 merge_uploaded_trace_state_variables (&uploaded_tsvs);
4669 /* Check whether the target is running now. */
4671 getpkt (&rs->buf, 0);
4673 if (!target_is_non_stop_p ())
4675 if (rs->buf[0] == 'W' || rs->buf[0] == 'X')
4678 error (_("The target is not running (try extended-remote?)"));
4680 /* We're connected, but not running. Drop out before we
4681 call start_remote. */
4682 rs->starting_up = 0;
4687 /* Save the reply for later. */
4688 wait_status = (char *) alloca (strlen (rs->buf.data ()) + 1);
4689 strcpy (wait_status, rs->buf.data ());
4692 /* Fetch thread list. */
4693 target_update_thread_list ();
4695 /* Let the stub know that we want it to return the thread. */
4696 set_continue_thread (minus_one_ptid);
4698 if (thread_count () == 0)
4700 /* Target has no concept of threads at all. GDB treats
4701 non-threaded target as single-threaded; add a main
4703 add_current_inferior_and_thread (wait_status);
4707 /* We have thread information; select the thread the target
4708 says should be current. If we're reconnecting to a
4709 multi-threaded program, this will ideally be the thread
4710 that last reported an event before GDB disconnected. */
4711 inferior_ptid = get_current_thread (wait_status);
4712 if (inferior_ptid == null_ptid)
4714 /* Odd... The target was able to list threads, but not
4715 tell us which thread was current (no "thread"
4716 register in T stop reply?). Just pick the first
4717 thread in the thread list then. */
4720 fprintf_unfiltered (gdb_stdlog,
4721 "warning: couldn't determine remote "
4722 "current thread; picking first in list.\n");
4724 inferior_ptid = inferior_list->thread_list->ptid;
4728 /* init_wait_for_inferior should be called before get_offsets in order
4729 to manage `inserted' flag in bp loc in a correct state.
4730 breakpoint_init_inferior, called from init_wait_for_inferior, set
4731 `inserted' flag to 0, while before breakpoint_re_set, called from
4732 start_remote, set `inserted' flag to 1. In the initialization of
4733 inferior, breakpoint_init_inferior should be called first, and then
4734 breakpoint_re_set can be called. If this order is broken, state of
4735 `inserted' flag is wrong, and cause some problems on breakpoint
4737 init_wait_for_inferior ();
4739 get_offsets (); /* Get text, data & bss offsets. */
4741 /* If we could not find a description using qXfer, and we know
4742 how to do it some other way, try again. This is not
4743 supported for non-stop; it could be, but it is tricky if
4744 there are no stopped threads when we connect. */
4745 if (remote_read_description_p (this)
4746 && gdbarch_target_desc (target_gdbarch ()) == NULL)
4748 target_clear_description ();
4749 target_find_description ();
4752 /* Use the previously fetched status. */
4753 gdb_assert (wait_status != NULL);
4754 strcpy (rs->buf.data (), wait_status);
4755 rs->cached_wait_status = 1;
4757 ::start_remote (from_tty); /* Initialize gdb process mechanisms. */
4761 /* Clear WFI global state. Do this before finding about new
4762 threads and inferiors, and setting the current inferior.
4763 Otherwise we would clear the proceed status of the current
4764 inferior when we want its stop_soon state to be preserved
4765 (see notice_new_inferior). */
4766 init_wait_for_inferior ();
4768 /* In non-stop, we will either get an "OK", meaning that there
4769 are no stopped threads at this time; or, a regular stop
4770 reply. In the latter case, there may be more than one thread
4771 stopped --- we pull them all out using the vStopped
4773 if (strcmp (rs->buf.data (), "OK") != 0)
4775 struct notif_client *notif = ¬if_client_stop;
4777 /* remote_notif_get_pending_replies acks this one, and gets
4779 rs->notif_state->pending_event[notif_client_stop.id]
4780 = remote_notif_parse (this, notif, rs->buf.data ());
4781 remote_notif_get_pending_events (notif);
4784 if (thread_count () == 0)
4787 error (_("The target is not running (try extended-remote?)"));
4789 /* We're connected, but not running. Drop out before we
4790 call start_remote. */
4791 rs->starting_up = 0;
4795 /* In non-stop mode, any cached wait status will be stored in
4796 the stop reply queue. */
4797 gdb_assert (wait_status == NULL);
4799 /* Report all signals during attach/startup. */
4800 pass_signals (0, NULL);
4802 /* If there are already stopped threads, mark them stopped and
4803 report their stops before giving the prompt to the user. */
4804 process_initial_stop_replies (from_tty);
4806 if (target_can_async_p ())
4810 /* If we connected to a live target, do some additional setup. */
4811 if (target_has_execution)
4813 if (symfile_objfile) /* No use without a symbol-file. */
4814 remote_check_symbols ();
4817 /* Possibly the target has been engaged in a trace run started
4818 previously; find out where things are at. */
4819 if (get_trace_status (current_trace_status ()) != -1)
4821 struct uploaded_tp *uploaded_tps = NULL;
4823 if (current_trace_status ()->running)
4824 printf_filtered (_("Trace is already running on the target.\n"));
4826 upload_tracepoints (&uploaded_tps);
4828 merge_uploaded_tracepoints (&uploaded_tps);
4831 /* Possibly the target has been engaged in a btrace record started
4832 previously; find out where things are at. */
4833 remote_btrace_maybe_reopen ();
4835 /* The thread and inferior lists are now synchronized with the
4836 target, our symbols have been relocated, and we're merged the
4837 target's tracepoints with ours. We're done with basic start
4839 rs->starting_up = 0;
4841 /* Maybe breakpoints are global and need to be inserted now. */
4842 if (breakpoints_should_be_inserted_now ())
4843 insert_breakpoints ();
4846 /* Open a connection to a remote debugger.
4847 NAME is the filename used for communication. */
4850 remote_target::open (const char *name, int from_tty)
4852 open_1 (name, from_tty, 0);
4855 /* Open a connection to a remote debugger using the extended
4856 remote gdb protocol. NAME is the filename used for communication. */
4859 extended_remote_target::open (const char *name, int from_tty)
4861 open_1 (name, from_tty, 1 /*extended_p */);
4864 /* Reset all packets back to "unknown support". Called when opening a
4865 new connection to a remote target. */
4868 reset_all_packet_configs_support (void)
4872 for (i = 0; i < PACKET_MAX; i++)
4873 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
4876 /* Initialize all packet configs. */
4879 init_all_packet_configs (void)
4883 for (i = 0; i < PACKET_MAX; i++)
4885 remote_protocol_packets[i].detect = AUTO_BOOLEAN_AUTO;
4886 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
4890 /* Symbol look-up. */
4893 remote_target::remote_check_symbols ()
4898 /* The remote side has no concept of inferiors that aren't running
4899 yet, it only knows about running processes. If we're connected
4900 but our current inferior is not running, we should not invite the
4901 remote target to request symbol lookups related to its
4902 (unrelated) current process. */
4903 if (!target_has_execution)
4906 if (packet_support (PACKET_qSymbol) == PACKET_DISABLE)
4909 /* Make sure the remote is pointing at the right process. Note
4910 there's no way to select "no process". */
4911 set_general_process ();
4913 /* Allocate a message buffer. We can't reuse the input buffer in RS,
4914 because we need both at the same time. */
4915 gdb::char_vector msg (get_remote_packet_size ());
4916 gdb::char_vector reply (get_remote_packet_size ());
4918 /* Invite target to request symbol lookups. */
4920 putpkt ("qSymbol::");
4922 packet_ok (reply, &remote_protocol_packets[PACKET_qSymbol]);
4924 while (startswith (reply.data (), "qSymbol:"))
4926 struct bound_minimal_symbol sym;
4929 end = hex2bin (tmp, reinterpret_cast <gdb_byte *> (msg.data ()),
4932 sym = lookup_minimal_symbol (msg.data (), NULL, NULL);
4933 if (sym.minsym == NULL)
4934 xsnprintf (msg.data (), get_remote_packet_size (), "qSymbol::%s",
4938 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
4939 CORE_ADDR sym_addr = BMSYMBOL_VALUE_ADDRESS (sym);
4941 /* If this is a function address, return the start of code
4942 instead of any data function descriptor. */
4943 sym_addr = gdbarch_convert_from_func_ptr_addr (target_gdbarch (),
4945 current_top_target ());
4947 xsnprintf (msg.data (), get_remote_packet_size (), "qSymbol:%s:%s",
4948 phex_nz (sym_addr, addr_size), &reply[8]);
4951 putpkt (msg.data ());
4956 static struct serial *
4957 remote_serial_open (const char *name)
4959 static int udp_warning = 0;
4961 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
4962 of in ser-tcp.c, because it is the remote protocol assuming that the
4963 serial connection is reliable and not the serial connection promising
4965 if (!udp_warning && startswith (name, "udp:"))
4967 warning (_("The remote protocol may be unreliable over UDP.\n"
4968 "Some events may be lost, rendering further debugging "
4973 return serial_open (name);
4976 /* Inform the target of our permission settings. The permission flags
4977 work without this, but if the target knows the settings, it can do
4978 a couple things. First, it can add its own check, to catch cases
4979 that somehow manage to get by the permissions checks in target
4980 methods. Second, if the target is wired to disallow particular
4981 settings (for instance, a system in the field that is not set up to
4982 be able to stop at a breakpoint), it can object to any unavailable
4986 remote_target::set_permissions ()
4988 struct remote_state *rs = get_remote_state ();
4990 xsnprintf (rs->buf.data (), get_remote_packet_size (), "QAllow:"
4991 "WriteReg:%x;WriteMem:%x;"
4992 "InsertBreak:%x;InsertTrace:%x;"
4993 "InsertFastTrace:%x;Stop:%x",
4994 may_write_registers, may_write_memory,
4995 may_insert_breakpoints, may_insert_tracepoints,
4996 may_insert_fast_tracepoints, may_stop);
4998 getpkt (&rs->buf, 0);
5000 /* If the target didn't like the packet, warn the user. Do not try
5001 to undo the user's settings, that would just be maddening. */
5002 if (strcmp (rs->buf.data (), "OK") != 0)
5003 warning (_("Remote refused setting permissions with: %s"),
5007 /* This type describes each known response to the qSupported
5009 struct protocol_feature
5011 /* The name of this protocol feature. */
5014 /* The default for this protocol feature. */
5015 enum packet_support default_support;
5017 /* The function to call when this feature is reported, or after
5018 qSupported processing if the feature is not supported.
5019 The first argument points to this structure. The second
5020 argument indicates whether the packet requested support be
5021 enabled, disabled, or probed (or the default, if this function
5022 is being called at the end of processing and this feature was
5023 not reported). The third argument may be NULL; if not NULL, it
5024 is a NUL-terminated string taken from the packet following
5025 this feature's name and an equals sign. */
5026 void (*func) (remote_target *remote, const struct protocol_feature *,
5027 enum packet_support, const char *);
5029 /* The corresponding packet for this feature. Only used if
5030 FUNC is remote_supported_packet. */
5035 remote_supported_packet (remote_target *remote,
5036 const struct protocol_feature *feature,
5037 enum packet_support support,
5038 const char *argument)
5042 warning (_("Remote qSupported response supplied an unexpected value for"
5043 " \"%s\"."), feature->name);
5047 remote_protocol_packets[feature->packet].support = support;
5051 remote_target::remote_packet_size (const protocol_feature *feature,
5052 enum packet_support support, const char *value)
5054 struct remote_state *rs = get_remote_state ();
5059 if (support != PACKET_ENABLE)
5062 if (value == NULL || *value == '\0')
5064 warning (_("Remote target reported \"%s\" without a size."),
5070 packet_size = strtol (value, &value_end, 16);
5071 if (errno != 0 || *value_end != '\0' || packet_size < 0)
5073 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
5074 feature->name, value);
5078 /* Record the new maximum packet size. */
5079 rs->explicit_packet_size = packet_size;
5083 remote_packet_size (remote_target *remote, const protocol_feature *feature,
5084 enum packet_support support, const char *value)
5086 remote->remote_packet_size (feature, support, value);
5089 static const struct protocol_feature remote_protocol_features[] = {
5090 { "PacketSize", PACKET_DISABLE, remote_packet_size, -1 },
5091 { "qXfer:auxv:read", PACKET_DISABLE, remote_supported_packet,
5092 PACKET_qXfer_auxv },
5093 { "qXfer:exec-file:read", PACKET_DISABLE, remote_supported_packet,
5094 PACKET_qXfer_exec_file },
5095 { "qXfer:features:read", PACKET_DISABLE, remote_supported_packet,
5096 PACKET_qXfer_features },
5097 { "qXfer:libraries:read", PACKET_DISABLE, remote_supported_packet,
5098 PACKET_qXfer_libraries },
5099 { "qXfer:libraries-svr4:read", PACKET_DISABLE, remote_supported_packet,
5100 PACKET_qXfer_libraries_svr4 },
5101 { "augmented-libraries-svr4-read", PACKET_DISABLE,
5102 remote_supported_packet, PACKET_augmented_libraries_svr4_read_feature },
5103 { "qXfer:memory-map:read", PACKET_DISABLE, remote_supported_packet,
5104 PACKET_qXfer_memory_map },
5105 { "qXfer:spu:read", PACKET_DISABLE, remote_supported_packet,
5106 PACKET_qXfer_spu_read },
5107 { "qXfer:spu:write", PACKET_DISABLE, remote_supported_packet,
5108 PACKET_qXfer_spu_write },
5109 { "qXfer:osdata:read", PACKET_DISABLE, remote_supported_packet,
5110 PACKET_qXfer_osdata },
5111 { "qXfer:threads:read", PACKET_DISABLE, remote_supported_packet,
5112 PACKET_qXfer_threads },
5113 { "qXfer:traceframe-info:read", PACKET_DISABLE, remote_supported_packet,
5114 PACKET_qXfer_traceframe_info },
5115 { "QPassSignals", PACKET_DISABLE, remote_supported_packet,
5116 PACKET_QPassSignals },
5117 { "QCatchSyscalls", PACKET_DISABLE, remote_supported_packet,
5118 PACKET_QCatchSyscalls },
5119 { "QProgramSignals", PACKET_DISABLE, remote_supported_packet,
5120 PACKET_QProgramSignals },
5121 { "QSetWorkingDir", PACKET_DISABLE, remote_supported_packet,
5122 PACKET_QSetWorkingDir },
5123 { "QStartupWithShell", PACKET_DISABLE, remote_supported_packet,
5124 PACKET_QStartupWithShell },
5125 { "QEnvironmentHexEncoded", PACKET_DISABLE, remote_supported_packet,
5126 PACKET_QEnvironmentHexEncoded },
5127 { "QEnvironmentReset", PACKET_DISABLE, remote_supported_packet,
5128 PACKET_QEnvironmentReset },
5129 { "QEnvironmentUnset", PACKET_DISABLE, remote_supported_packet,
5130 PACKET_QEnvironmentUnset },
5131 { "QStartNoAckMode", PACKET_DISABLE, remote_supported_packet,
5132 PACKET_QStartNoAckMode },
5133 { "multiprocess", PACKET_DISABLE, remote_supported_packet,
5134 PACKET_multiprocess_feature },
5135 { "QNonStop", PACKET_DISABLE, remote_supported_packet, PACKET_QNonStop },
5136 { "qXfer:siginfo:read", PACKET_DISABLE, remote_supported_packet,
5137 PACKET_qXfer_siginfo_read },
5138 { "qXfer:siginfo:write", PACKET_DISABLE, remote_supported_packet,
5139 PACKET_qXfer_siginfo_write },
5140 { "ConditionalTracepoints", PACKET_DISABLE, remote_supported_packet,
5141 PACKET_ConditionalTracepoints },
5142 { "ConditionalBreakpoints", PACKET_DISABLE, remote_supported_packet,
5143 PACKET_ConditionalBreakpoints },
5144 { "BreakpointCommands", PACKET_DISABLE, remote_supported_packet,
5145 PACKET_BreakpointCommands },
5146 { "FastTracepoints", PACKET_DISABLE, remote_supported_packet,
5147 PACKET_FastTracepoints },
5148 { "StaticTracepoints", PACKET_DISABLE, remote_supported_packet,
5149 PACKET_StaticTracepoints },
5150 {"InstallInTrace", PACKET_DISABLE, remote_supported_packet,
5151 PACKET_InstallInTrace},
5152 { "DisconnectedTracing", PACKET_DISABLE, remote_supported_packet,
5153 PACKET_DisconnectedTracing_feature },
5154 { "ReverseContinue", PACKET_DISABLE, remote_supported_packet,
5156 { "ReverseStep", PACKET_DISABLE, remote_supported_packet,
5158 { "TracepointSource", PACKET_DISABLE, remote_supported_packet,
5159 PACKET_TracepointSource },
5160 { "QAllow", PACKET_DISABLE, remote_supported_packet,
5162 { "EnableDisableTracepoints", PACKET_DISABLE, remote_supported_packet,
5163 PACKET_EnableDisableTracepoints_feature },
5164 { "qXfer:fdpic:read", PACKET_DISABLE, remote_supported_packet,
5165 PACKET_qXfer_fdpic },
5166 { "qXfer:uib:read", PACKET_DISABLE, remote_supported_packet,
5168 { "QDisableRandomization", PACKET_DISABLE, remote_supported_packet,
5169 PACKET_QDisableRandomization },
5170 { "QAgent", PACKET_DISABLE, remote_supported_packet, PACKET_QAgent},
5171 { "QTBuffer:size", PACKET_DISABLE,
5172 remote_supported_packet, PACKET_QTBuffer_size},
5173 { "tracenz", PACKET_DISABLE, remote_supported_packet, PACKET_tracenz_feature },
5174 { "Qbtrace:off", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_off },
5175 { "Qbtrace:bts", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_bts },
5176 { "Qbtrace:pt", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_pt },
5177 { "qXfer:btrace:read", PACKET_DISABLE, remote_supported_packet,
5178 PACKET_qXfer_btrace },
5179 { "qXfer:btrace-conf:read", PACKET_DISABLE, remote_supported_packet,
5180 PACKET_qXfer_btrace_conf },
5181 { "Qbtrace-conf:bts:size", PACKET_DISABLE, remote_supported_packet,
5182 PACKET_Qbtrace_conf_bts_size },
5183 { "swbreak", PACKET_DISABLE, remote_supported_packet, PACKET_swbreak_feature },
5184 { "hwbreak", PACKET_DISABLE, remote_supported_packet, PACKET_hwbreak_feature },
5185 { "fork-events", PACKET_DISABLE, remote_supported_packet,
5186 PACKET_fork_event_feature },
5187 { "vfork-events", PACKET_DISABLE, remote_supported_packet,
5188 PACKET_vfork_event_feature },
5189 { "exec-events", PACKET_DISABLE, remote_supported_packet,
5190 PACKET_exec_event_feature },
5191 { "Qbtrace-conf:pt:size", PACKET_DISABLE, remote_supported_packet,
5192 PACKET_Qbtrace_conf_pt_size },
5193 { "vContSupported", PACKET_DISABLE, remote_supported_packet, PACKET_vContSupported },
5194 { "QThreadEvents", PACKET_DISABLE, remote_supported_packet, PACKET_QThreadEvents },
5195 { "no-resumed", PACKET_DISABLE, remote_supported_packet, PACKET_no_resumed },
5198 static char *remote_support_xml;
5200 /* Register string appended to "xmlRegisters=" in qSupported query. */
5203 register_remote_support_xml (const char *xml)
5205 #if defined(HAVE_LIBEXPAT)
5206 if (remote_support_xml == NULL)
5207 remote_support_xml = concat ("xmlRegisters=", xml, (char *) NULL);
5210 char *copy = xstrdup (remote_support_xml + 13);
5211 char *p = strtok (copy, ",");
5215 if (strcmp (p, xml) == 0)
5222 while ((p = strtok (NULL, ",")) != NULL);
5225 remote_support_xml = reconcat (remote_support_xml,
5226 remote_support_xml, ",", xml,
5233 remote_query_supported_append (std::string *msg, const char *append)
5237 msg->append (append);
5241 remote_target::remote_query_supported ()
5243 struct remote_state *rs = get_remote_state ();
5246 unsigned char seen [ARRAY_SIZE (remote_protocol_features)];
5248 /* The packet support flags are handled differently for this packet
5249 than for most others. We treat an error, a disabled packet, and
5250 an empty response identically: any features which must be reported
5251 to be used will be automatically disabled. An empty buffer
5252 accomplishes this, since that is also the representation for a list
5253 containing no features. */
5256 if (packet_support (PACKET_qSupported) != PACKET_DISABLE)
5260 if (packet_set_cmd_state (PACKET_multiprocess_feature) != AUTO_BOOLEAN_FALSE)
5261 remote_query_supported_append (&q, "multiprocess+");
5263 if (packet_set_cmd_state (PACKET_swbreak_feature) != AUTO_BOOLEAN_FALSE)
5264 remote_query_supported_append (&q, "swbreak+");
5265 if (packet_set_cmd_state (PACKET_hwbreak_feature) != AUTO_BOOLEAN_FALSE)
5266 remote_query_supported_append (&q, "hwbreak+");
5268 remote_query_supported_append (&q, "qRelocInsn+");
5270 if (packet_set_cmd_state (PACKET_fork_event_feature)
5271 != AUTO_BOOLEAN_FALSE)
5272 remote_query_supported_append (&q, "fork-events+");
5273 if (packet_set_cmd_state (PACKET_vfork_event_feature)
5274 != AUTO_BOOLEAN_FALSE)
5275 remote_query_supported_append (&q, "vfork-events+");
5276 if (packet_set_cmd_state (PACKET_exec_event_feature)
5277 != AUTO_BOOLEAN_FALSE)
5278 remote_query_supported_append (&q, "exec-events+");
5280 if (packet_set_cmd_state (PACKET_vContSupported) != AUTO_BOOLEAN_FALSE)
5281 remote_query_supported_append (&q, "vContSupported+");
5283 if (packet_set_cmd_state (PACKET_QThreadEvents) != AUTO_BOOLEAN_FALSE)
5284 remote_query_supported_append (&q, "QThreadEvents+");
5286 if (packet_set_cmd_state (PACKET_no_resumed) != AUTO_BOOLEAN_FALSE)
5287 remote_query_supported_append (&q, "no-resumed+");
5289 /* Keep this one last to work around a gdbserver <= 7.10 bug in
5290 the qSupported:xmlRegisters=i386 handling. */
5291 if (remote_support_xml != NULL
5292 && packet_support (PACKET_qXfer_features) != PACKET_DISABLE)
5293 remote_query_supported_append (&q, remote_support_xml);
5295 q = "qSupported:" + q;
5296 putpkt (q.c_str ());
5298 getpkt (&rs->buf, 0);
5300 /* If an error occured, warn, but do not return - just reset the
5301 buffer to empty and go on to disable features. */
5302 if (packet_ok (rs->buf, &remote_protocol_packets[PACKET_qSupported])
5305 warning (_("Remote failure reply: %s"), rs->buf.data ());
5310 memset (seen, 0, sizeof (seen));
5312 next = rs->buf.data ();
5315 enum packet_support is_supported;
5316 char *p, *end, *name_end, *value;
5318 /* First separate out this item from the rest of the packet. If
5319 there's another item after this, we overwrite the separator
5320 (terminated strings are much easier to work with). */
5322 end = strchr (p, ';');
5325 end = p + strlen (p);
5335 warning (_("empty item in \"qSupported\" response"));
5340 name_end = strchr (p, '=');
5343 /* This is a name=value entry. */
5344 is_supported = PACKET_ENABLE;
5345 value = name_end + 1;
5354 is_supported = PACKET_ENABLE;
5358 is_supported = PACKET_DISABLE;
5362 is_supported = PACKET_SUPPORT_UNKNOWN;
5366 warning (_("unrecognized item \"%s\" "
5367 "in \"qSupported\" response"), p);
5373 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
5374 if (strcmp (remote_protocol_features[i].name, p) == 0)
5376 const struct protocol_feature *feature;
5379 feature = &remote_protocol_features[i];
5380 feature->func (this, feature, is_supported, value);
5385 /* If we increased the packet size, make sure to increase the global
5386 buffer size also. We delay this until after parsing the entire
5387 qSupported packet, because this is the same buffer we were
5389 if (rs->buf.size () < rs->explicit_packet_size)
5390 rs->buf.resize (rs->explicit_packet_size);
5392 /* Handle the defaults for unmentioned features. */
5393 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
5396 const struct protocol_feature *feature;
5398 feature = &remote_protocol_features[i];
5399 feature->func (this, feature, feature->default_support, NULL);
5403 /* Serial QUIT handler for the remote serial descriptor.
5405 Defers handling a Ctrl-C until we're done with the current
5406 command/response packet sequence, unless:
5408 - We're setting up the connection. Don't send a remote interrupt
5409 request, as we're not fully synced yet. Quit immediately
5412 - The target has been resumed in the foreground
5413 (target_terminal::is_ours is false) with a synchronous resume
5414 packet, and we're blocked waiting for the stop reply, thus a
5415 Ctrl-C should be immediately sent to the target.
5417 - We get a second Ctrl-C while still within the same serial read or
5418 write. In that case the serial is seemingly wedged --- offer to
5421 - We see a second Ctrl-C without target response, after having
5422 previously interrupted the target. In that case the target/stub
5423 is probably wedged --- offer to quit/disconnect.
5427 remote_target::remote_serial_quit_handler ()
5429 struct remote_state *rs = get_remote_state ();
5431 if (check_quit_flag ())
5433 /* If we're starting up, we're not fully synced yet. Quit
5435 if (rs->starting_up)
5437 else if (rs->got_ctrlc_during_io)
5439 if (query (_("The target is not responding to GDB commands.\n"
5440 "Stop debugging it? ")))
5441 remote_unpush_and_throw ();
5443 /* If ^C has already been sent once, offer to disconnect. */
5444 else if (!target_terminal::is_ours () && rs->ctrlc_pending_p)
5446 /* All-stop protocol, and blocked waiting for stop reply. Send
5447 an interrupt request. */
5448 else if (!target_terminal::is_ours () && rs->waiting_for_stop_reply)
5449 target_interrupt ();
5451 rs->got_ctrlc_during_io = 1;
5455 /* The remote_target that is current while the quit handler is
5456 overridden with remote_serial_quit_handler. */
5457 static remote_target *curr_quit_handler_target;
5460 remote_serial_quit_handler ()
5462 curr_quit_handler_target->remote_serial_quit_handler ();
5465 /* Remove any of the remote.c targets from target stack. Upper targets depend
5466 on it so remove them first. */
5469 remote_unpush_target (void)
5471 pop_all_targets_at_and_above (process_stratum);
5475 remote_unpush_and_throw (void)
5477 remote_unpush_target ();
5478 throw_error (TARGET_CLOSE_ERROR, _("Disconnected from target."));
5482 remote_target::open_1 (const char *name, int from_tty, int extended_p)
5484 remote_target *curr_remote = get_current_remote_target ();
5487 error (_("To open a remote debug connection, you need to specify what\n"
5488 "serial device is attached to the remote system\n"
5489 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
5491 /* If we're connected to a running target, target_preopen will kill it.
5492 Ask this question first, before target_preopen has a chance to kill
5494 if (curr_remote != NULL && !have_inferiors ())
5497 && !query (_("Already connected to a remote target. Disconnect? ")))
5498 error (_("Still connected."));
5501 /* Here the possibly existing remote target gets unpushed. */
5502 target_preopen (from_tty);
5504 remote_fileio_reset ();
5505 reopen_exec_file ();
5508 remote_target *remote
5509 = (extended_p ? new extended_remote_target () : new remote_target ());
5510 target_ops_up target_holder (remote);
5512 remote_state *rs = remote->get_remote_state ();
5514 /* See FIXME above. */
5515 if (!target_async_permitted)
5516 rs->wait_forever_enabled_p = 1;
5518 rs->remote_desc = remote_serial_open (name);
5519 if (!rs->remote_desc)
5520 perror_with_name (name);
5522 if (baud_rate != -1)
5524 if (serial_setbaudrate (rs->remote_desc, baud_rate))
5526 /* The requested speed could not be set. Error out to
5527 top level after closing remote_desc. Take care to
5528 set remote_desc to NULL to avoid closing remote_desc
5530 serial_close (rs->remote_desc);
5531 rs->remote_desc = NULL;
5532 perror_with_name (name);
5536 serial_setparity (rs->remote_desc, serial_parity);
5537 serial_raw (rs->remote_desc);
5539 /* If there is something sitting in the buffer we might take it as a
5540 response to a command, which would be bad. */
5541 serial_flush_input (rs->remote_desc);
5545 puts_filtered ("Remote debugging using ");
5546 puts_filtered (name);
5547 puts_filtered ("\n");
5550 /* Switch to using the remote target now. */
5551 push_target (remote);
5552 /* The target stack owns the target now. */
5553 target_holder.release ();
5555 /* Register extra event sources in the event loop. */
5556 rs->remote_async_inferior_event_token
5557 = create_async_event_handler (remote_async_inferior_event_handler,
5559 rs->notif_state = remote_notif_state_allocate (remote);
5561 /* Reset the target state; these things will be queried either by
5562 remote_query_supported or as they are needed. */
5563 reset_all_packet_configs_support ();
5564 rs->cached_wait_status = 0;
5565 rs->explicit_packet_size = 0;
5567 rs->extended = extended_p;
5568 rs->waiting_for_stop_reply = 0;
5569 rs->ctrlc_pending_p = 0;
5570 rs->got_ctrlc_during_io = 0;
5572 rs->general_thread = not_sent_ptid;
5573 rs->continue_thread = not_sent_ptid;
5574 rs->remote_traceframe_number = -1;
5576 rs->last_resume_exec_dir = EXEC_FORWARD;
5578 /* Probe for ability to use "ThreadInfo" query, as required. */
5579 rs->use_threadinfo_query = 1;
5580 rs->use_threadextra_query = 1;
5582 rs->readahead_cache.invalidate ();
5584 if (target_async_permitted)
5586 /* FIXME: cagney/1999-09-23: During the initial connection it is
5587 assumed that the target is already ready and able to respond to
5588 requests. Unfortunately remote_start_remote() eventually calls
5589 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
5590 around this. Eventually a mechanism that allows
5591 wait_for_inferior() to expect/get timeouts will be
5593 rs->wait_forever_enabled_p = 0;
5596 /* First delete any symbols previously loaded from shared libraries. */
5597 no_shared_libraries (NULL, 0);
5599 /* Start the remote connection. If error() or QUIT, discard this
5600 target (we'd otherwise be in an inconsistent state) and then
5601 propogate the error on up the exception chain. This ensures that
5602 the caller doesn't stumble along blindly assuming that the
5603 function succeeded. The CLI doesn't have this problem but other
5604 UI's, such as MI do.
5606 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
5607 this function should return an error indication letting the
5608 caller restore the previous state. Unfortunately the command
5609 ``target remote'' is directly wired to this function making that
5610 impossible. On a positive note, the CLI side of this problem has
5611 been fixed - the function set_cmd_context() makes it possible for
5612 all the ``target ....'' commands to share a common callback
5613 function. See cli-dump.c. */
5618 remote->start_remote (from_tty, extended_p);
5620 CATCH (ex, RETURN_MASK_ALL)
5622 /* Pop the partially set up target - unless something else did
5623 already before throwing the exception. */
5624 if (ex.error != TARGET_CLOSE_ERROR)
5625 remote_unpush_target ();
5626 throw_exception (ex);
5631 remote_btrace_reset (rs);
5633 if (target_async_permitted)
5634 rs->wait_forever_enabled_p = 1;
5637 /* Detach the specified process. */
5640 remote_target::remote_detach_pid (int pid)
5642 struct remote_state *rs = get_remote_state ();
5644 /* This should not be necessary, but the handling for D;PID in
5645 GDBserver versions prior to 8.2 incorrectly assumes that the
5646 selected process points to the same process we're detaching,
5647 leading to misbehavior (and possibly GDBserver crashing) when it
5648 does not. Since it's easy and cheap, work around it by forcing
5649 GDBserver to select GDB's current process. */
5650 set_general_process ();
5652 if (remote_multi_process_p (rs))
5653 xsnprintf (rs->buf.data (), get_remote_packet_size (), "D;%x", pid);
5655 strcpy (rs->buf.data (), "D");
5658 getpkt (&rs->buf, 0);
5660 if (rs->buf[0] == 'O' && rs->buf[1] == 'K')
5662 else if (rs->buf[0] == '\0')
5663 error (_("Remote doesn't know how to detach"));
5665 error (_("Can't detach process."));
5668 /* This detaches a program to which we previously attached, using
5669 inferior_ptid to identify the process. After this is done, GDB
5670 can be used to debug some other program. We better not have left
5671 any breakpoints in the target program or it'll die when it hits
5675 remote_target::remote_detach_1 (inferior *inf, int from_tty)
5677 int pid = inferior_ptid.pid ();
5678 struct remote_state *rs = get_remote_state ();
5681 if (!target_has_execution)
5682 error (_("No process to detach from."));
5684 target_announce_detach (from_tty);
5686 /* Tell the remote target to detach. */
5687 remote_detach_pid (pid);
5689 /* Exit only if this is the only active inferior. */
5690 if (from_tty && !rs->extended && number_of_live_inferiors () == 1)
5691 puts_filtered (_("Ending remote debugging.\n"));
5693 struct thread_info *tp = find_thread_ptid (inferior_ptid);
5695 /* Check to see if we are detaching a fork parent. Note that if we
5696 are detaching a fork child, tp == NULL. */
5697 is_fork_parent = (tp != NULL
5698 && tp->pending_follow.kind == TARGET_WAITKIND_FORKED);
5700 /* If doing detach-on-fork, we don't mourn, because that will delete
5701 breakpoints that should be available for the followed inferior. */
5702 if (!is_fork_parent)
5704 /* Save the pid as a string before mourning, since that will
5705 unpush the remote target, and we need the string after. */
5706 std::string infpid = target_pid_to_str (ptid_t (pid));
5708 target_mourn_inferior (inferior_ptid);
5709 if (print_inferior_events)
5710 printf_unfiltered (_("[Inferior %d (%s) detached]\n"),
5711 inf->num, infpid.c_str ());
5715 inferior_ptid = null_ptid;
5716 detach_inferior (current_inferior ());
5721 remote_target::detach (inferior *inf, int from_tty)
5723 remote_detach_1 (inf, from_tty);
5727 extended_remote_target::detach (inferior *inf, int from_tty)
5729 remote_detach_1 (inf, from_tty);
5732 /* Target follow-fork function for remote targets. On entry, and
5733 at return, the current inferior is the fork parent.
5735 Note that although this is currently only used for extended-remote,
5736 it is named remote_follow_fork in anticipation of using it for the
5737 remote target as well. */
5740 remote_target::follow_fork (int follow_child, int detach_fork)
5742 struct remote_state *rs = get_remote_state ();
5743 enum target_waitkind kind = inferior_thread ()->pending_follow.kind;
5745 if ((kind == TARGET_WAITKIND_FORKED && remote_fork_event_p (rs))
5746 || (kind == TARGET_WAITKIND_VFORKED && remote_vfork_event_p (rs)))
5748 /* When following the parent and detaching the child, we detach
5749 the child here. For the case of following the child and
5750 detaching the parent, the detach is done in the target-
5751 independent follow fork code in infrun.c. We can't use
5752 target_detach when detaching an unfollowed child because
5753 the client side doesn't know anything about the child. */
5754 if (detach_fork && !follow_child)
5756 /* Detach the fork child. */
5760 child_ptid = inferior_thread ()->pending_follow.value.related_pid;
5761 child_pid = child_ptid.pid ();
5763 remote_detach_pid (child_pid);
5769 /* Target follow-exec function for remote targets. Save EXECD_PATHNAME
5770 in the program space of the new inferior. On entry and at return the
5771 current inferior is the exec'ing inferior. INF is the new exec'd
5772 inferior, which may be the same as the exec'ing inferior unless
5773 follow-exec-mode is "new". */
5776 remote_target::follow_exec (struct inferior *inf, char *execd_pathname)
5778 /* We know that this is a target file name, so if it has the "target:"
5779 prefix we strip it off before saving it in the program space. */
5780 if (is_target_filename (execd_pathname))
5781 execd_pathname += strlen (TARGET_SYSROOT_PREFIX);
5783 set_pspace_remote_exec_file (inf->pspace, execd_pathname);
5786 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
5789 remote_target::disconnect (const char *args, int from_tty)
5792 error (_("Argument given to \"disconnect\" when remotely debugging."));
5794 /* Make sure we unpush even the extended remote targets. Calling
5795 target_mourn_inferior won't unpush, and remote_mourn won't
5796 unpush if there is more than one inferior left. */
5797 unpush_target (this);
5798 generic_mourn_inferior ();
5801 puts_filtered ("Ending remote debugging.\n");
5804 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
5805 be chatty about it. */
5808 extended_remote_target::attach (const char *args, int from_tty)
5810 struct remote_state *rs = get_remote_state ();
5812 char *wait_status = NULL;
5814 pid = parse_pid_to_attach (args);
5816 /* Remote PID can be freely equal to getpid, do not check it here the same
5817 way as in other targets. */
5819 if (packet_support (PACKET_vAttach) == PACKET_DISABLE)
5820 error (_("This target does not support attaching to a process"));
5824 char *exec_file = get_exec_file (0);
5827 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file,
5828 target_pid_to_str (ptid_t (pid)));
5830 printf_unfiltered (_("Attaching to %s\n"),
5831 target_pid_to_str (ptid_t (pid)));
5833 gdb_flush (gdb_stdout);
5836 xsnprintf (rs->buf.data (), get_remote_packet_size (), "vAttach;%x", pid);
5838 getpkt (&rs->buf, 0);
5840 switch (packet_ok (rs->buf,
5841 &remote_protocol_packets[PACKET_vAttach]))
5844 if (!target_is_non_stop_p ())
5846 /* Save the reply for later. */
5847 wait_status = (char *) alloca (strlen (rs->buf.data ()) + 1);
5848 strcpy (wait_status, rs->buf.data ());
5850 else if (strcmp (rs->buf.data (), "OK") != 0)
5851 error (_("Attaching to %s failed with: %s"),
5852 target_pid_to_str (ptid_t (pid)),
5855 case PACKET_UNKNOWN:
5856 error (_("This target does not support attaching to a process"));
5858 error (_("Attaching to %s failed"),
5859 target_pid_to_str (ptid_t (pid)));
5862 set_current_inferior (remote_add_inferior (0, pid, 1, 0));
5864 inferior_ptid = ptid_t (pid);
5866 if (target_is_non_stop_p ())
5868 struct thread_info *thread;
5870 /* Get list of threads. */
5871 update_thread_list ();
5873 thread = first_thread_of_inferior (current_inferior ());
5875 inferior_ptid = thread->ptid;
5877 inferior_ptid = ptid_t (pid);
5879 /* Invalidate our notion of the remote current thread. */
5880 record_currthread (rs, minus_one_ptid);
5884 /* Now, if we have thread information, update inferior_ptid. */
5885 inferior_ptid = remote_current_thread (inferior_ptid);
5887 /* Add the main thread to the thread list. */
5888 thread_info *thr = add_thread_silent (inferior_ptid);
5889 /* Don't consider the thread stopped until we've processed the
5890 saved stop reply. */
5891 set_executing (thr->ptid, true);
5894 /* Next, if the target can specify a description, read it. We do
5895 this before anything involving memory or registers. */
5896 target_find_description ();
5898 if (!target_is_non_stop_p ())
5900 /* Use the previously fetched status. */
5901 gdb_assert (wait_status != NULL);
5903 if (target_can_async_p ())
5905 struct notif_event *reply
5906 = remote_notif_parse (this, ¬if_client_stop, wait_status);
5908 push_stop_reply ((struct stop_reply *) reply);
5914 gdb_assert (wait_status != NULL);
5915 strcpy (rs->buf.data (), wait_status);
5916 rs->cached_wait_status = 1;
5920 gdb_assert (wait_status == NULL);
5923 /* Implementation of the to_post_attach method. */
5926 extended_remote_target::post_attach (int pid)
5928 /* Get text, data & bss offsets. */
5931 /* In certain cases GDB might not have had the chance to start
5932 symbol lookup up until now. This could happen if the debugged
5933 binary is not using shared libraries, the vsyscall page is not
5934 present (on Linux) and the binary itself hadn't changed since the
5935 debugging process was started. */
5936 if (symfile_objfile != NULL)
5937 remote_check_symbols();
5941 /* Check for the availability of vCont. This function should also check
5945 remote_target::remote_vcont_probe ()
5947 remote_state *rs = get_remote_state ();
5950 strcpy (rs->buf.data (), "vCont?");
5952 getpkt (&rs->buf, 0);
5953 buf = rs->buf.data ();
5955 /* Make sure that the features we assume are supported. */
5956 if (startswith (buf, "vCont"))
5959 int support_c, support_C;
5961 rs->supports_vCont.s = 0;
5962 rs->supports_vCont.S = 0;
5965 rs->supports_vCont.t = 0;
5966 rs->supports_vCont.r = 0;
5967 while (p && *p == ';')
5970 if (*p == 's' && (*(p + 1) == ';' || *(p + 1) == 0))
5971 rs->supports_vCont.s = 1;
5972 else if (*p == 'S' && (*(p + 1) == ';' || *(p + 1) == 0))
5973 rs->supports_vCont.S = 1;
5974 else if (*p == 'c' && (*(p + 1) == ';' || *(p + 1) == 0))
5976 else if (*p == 'C' && (*(p + 1) == ';' || *(p + 1) == 0))
5978 else if (*p == 't' && (*(p + 1) == ';' || *(p + 1) == 0))
5979 rs->supports_vCont.t = 1;
5980 else if (*p == 'r' && (*(p + 1) == ';' || *(p + 1) == 0))
5981 rs->supports_vCont.r = 1;
5983 p = strchr (p, ';');
5986 /* If c, and C are not all supported, we can't use vCont. Clearing
5987 BUF will make packet_ok disable the packet. */
5988 if (!support_c || !support_C)
5992 packet_ok (rs->buf, &remote_protocol_packets[PACKET_vCont]);
5995 /* Helper function for building "vCont" resumptions. Write a
5996 resumption to P. ENDP points to one-passed-the-end of the buffer
5997 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
5998 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
5999 resumed thread should be single-stepped and/or signalled. If PTID
6000 equals minus_one_ptid, then all threads are resumed; if PTID
6001 represents a process, then all threads of the process are resumed;
6002 the thread to be stepped and/or signalled is given in the global
6006 remote_target::append_resumption (char *p, char *endp,
6007 ptid_t ptid, int step, gdb_signal siggnal)
6009 struct remote_state *rs = get_remote_state ();
6011 if (step && siggnal != GDB_SIGNAL_0)
6012 p += xsnprintf (p, endp - p, ";S%02x", siggnal);
6014 /* GDB is willing to range step. */
6015 && use_range_stepping
6016 /* Target supports range stepping. */
6017 && rs->supports_vCont.r
6018 /* We don't currently support range stepping multiple
6019 threads with a wildcard (though the protocol allows it,
6020 so stubs shouldn't make an active effort to forbid
6022 && !(remote_multi_process_p (rs) && ptid.is_pid ()))
6024 struct thread_info *tp;
6026 if (ptid == minus_one_ptid)
6028 /* If we don't know about the target thread's tid, then
6029 we're resuming magic_null_ptid (see caller). */
6030 tp = find_thread_ptid (magic_null_ptid);
6033 tp = find_thread_ptid (ptid);
6034 gdb_assert (tp != NULL);
6036 if (tp->control.may_range_step)
6038 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
6040 p += xsnprintf (p, endp - p, ";r%s,%s",
6041 phex_nz (tp->control.step_range_start,
6043 phex_nz (tp->control.step_range_end,
6047 p += xsnprintf (p, endp - p, ";s");
6050 p += xsnprintf (p, endp - p, ";s");
6051 else if (siggnal != GDB_SIGNAL_0)
6052 p += xsnprintf (p, endp - p, ";C%02x", siggnal);
6054 p += xsnprintf (p, endp - p, ";c");
6056 if (remote_multi_process_p (rs) && ptid.is_pid ())
6060 /* All (-1) threads of process. */
6061 nptid = ptid_t (ptid.pid (), -1, 0);
6063 p += xsnprintf (p, endp - p, ":");
6064 p = write_ptid (p, endp, nptid);
6066 else if (ptid != minus_one_ptid)
6068 p += xsnprintf (p, endp - p, ":");
6069 p = write_ptid (p, endp, ptid);
6075 /* Clear the thread's private info on resume. */
6078 resume_clear_thread_private_info (struct thread_info *thread)
6080 if (thread->priv != NULL)
6082 remote_thread_info *priv = get_remote_thread_info (thread);
6084 priv->stop_reason = TARGET_STOPPED_BY_NO_REASON;
6085 priv->watch_data_address = 0;
6089 /* Append a vCont continue-with-signal action for threads that have a
6090 non-zero stop signal. */
6093 remote_target::append_pending_thread_resumptions (char *p, char *endp,
6096 for (thread_info *thread : all_non_exited_threads (ptid))
6097 if (inferior_ptid != thread->ptid
6098 && thread->suspend.stop_signal != GDB_SIGNAL_0)
6100 p = append_resumption (p, endp, thread->ptid,
6101 0, thread->suspend.stop_signal);
6102 thread->suspend.stop_signal = GDB_SIGNAL_0;
6103 resume_clear_thread_private_info (thread);
6109 /* Set the target running, using the packets that use Hc
6113 remote_target::remote_resume_with_hc (ptid_t ptid, int step,
6116 struct remote_state *rs = get_remote_state ();
6119 rs->last_sent_signal = siggnal;
6120 rs->last_sent_step = step;
6122 /* The c/s/C/S resume packets use Hc, so set the continue
6124 if (ptid == minus_one_ptid)
6125 set_continue_thread (any_thread_ptid);
6127 set_continue_thread (ptid);
6129 for (thread_info *thread : all_non_exited_threads ())
6130 resume_clear_thread_private_info (thread);
6132 buf = rs->buf.data ();
6133 if (::execution_direction == EXEC_REVERSE)
6135 /* We don't pass signals to the target in reverse exec mode. */
6136 if (info_verbose && siggnal != GDB_SIGNAL_0)
6137 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
6140 if (step && packet_support (PACKET_bs) == PACKET_DISABLE)
6141 error (_("Remote reverse-step not supported."));
6142 if (!step && packet_support (PACKET_bc) == PACKET_DISABLE)
6143 error (_("Remote reverse-continue not supported."));
6145 strcpy (buf, step ? "bs" : "bc");
6147 else if (siggnal != GDB_SIGNAL_0)
6149 buf[0] = step ? 'S' : 'C';
6150 buf[1] = tohex (((int) siggnal >> 4) & 0xf);
6151 buf[2] = tohex (((int) siggnal) & 0xf);
6155 strcpy (buf, step ? "s" : "c");
6160 /* Resume the remote inferior by using a "vCont" packet. The thread
6161 to be resumed is PTID; STEP and SIGGNAL indicate whether the
6162 resumed thread should be single-stepped and/or signalled. If PTID
6163 equals minus_one_ptid, then all threads are resumed; the thread to
6164 be stepped and/or signalled is given in the global INFERIOR_PTID.
6165 This function returns non-zero iff it resumes the inferior.
6167 This function issues a strict subset of all possible vCont commands
6171 remote_target::remote_resume_with_vcont (ptid_t ptid, int step,
6172 enum gdb_signal siggnal)
6174 struct remote_state *rs = get_remote_state ();
6178 /* No reverse execution actions defined for vCont. */
6179 if (::execution_direction == EXEC_REVERSE)
6182 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
6183 remote_vcont_probe ();
6185 if (packet_support (PACKET_vCont) == PACKET_DISABLE)
6188 p = rs->buf.data ();
6189 endp = p + get_remote_packet_size ();
6191 /* If we could generate a wider range of packets, we'd have to worry
6192 about overflowing BUF. Should there be a generic
6193 "multi-part-packet" packet? */
6195 p += xsnprintf (p, endp - p, "vCont");
6197 if (ptid == magic_null_ptid)
6199 /* MAGIC_NULL_PTID means that we don't have any active threads,
6200 so we don't have any TID numbers the inferior will
6201 understand. Make sure to only send forms that do not specify
6203 append_resumption (p, endp, minus_one_ptid, step, siggnal);
6205 else if (ptid == minus_one_ptid || ptid.is_pid ())
6207 /* Resume all threads (of all processes, or of a single
6208 process), with preference for INFERIOR_PTID. This assumes
6209 inferior_ptid belongs to the set of all threads we are about
6211 if (step || siggnal != GDB_SIGNAL_0)
6213 /* Step inferior_ptid, with or without signal. */
6214 p = append_resumption (p, endp, inferior_ptid, step, siggnal);
6217 /* Also pass down any pending signaled resumption for other
6218 threads not the current. */
6219 p = append_pending_thread_resumptions (p, endp, ptid);
6221 /* And continue others without a signal. */
6222 append_resumption (p, endp, ptid, /*step=*/ 0, GDB_SIGNAL_0);
6226 /* Scheduler locking; resume only PTID. */
6227 append_resumption (p, endp, ptid, step, siggnal);
6230 gdb_assert (strlen (rs->buf.data ()) < get_remote_packet_size ());
6233 if (target_is_non_stop_p ())
6235 /* In non-stop, the stub replies to vCont with "OK". The stop
6236 reply will be reported asynchronously by means of a `%Stop'
6238 getpkt (&rs->buf, 0);
6239 if (strcmp (rs->buf.data (), "OK") != 0)
6240 error (_("Unexpected vCont reply in non-stop mode: %s"),
6247 /* Tell the remote machine to resume. */
6250 remote_target::resume (ptid_t ptid, int step, enum gdb_signal siggnal)
6252 struct remote_state *rs = get_remote_state ();
6254 /* When connected in non-stop mode, the core resumes threads
6255 individually. Resuming remote threads directly in target_resume
6256 would thus result in sending one packet per thread. Instead, to
6257 minimize roundtrip latency, here we just store the resume
6258 request; the actual remote resumption will be done in
6259 target_commit_resume / remote_commit_resume, where we'll be able
6260 to do vCont action coalescing. */
6261 if (target_is_non_stop_p () && ::execution_direction != EXEC_REVERSE)
6263 remote_thread_info *remote_thr;
6265 if (minus_one_ptid == ptid || ptid.is_pid ())
6266 remote_thr = get_remote_thread_info (inferior_ptid);
6268 remote_thr = get_remote_thread_info (ptid);
6270 remote_thr->last_resume_step = step;
6271 remote_thr->last_resume_sig = siggnal;
6275 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
6276 (explained in remote-notif.c:handle_notification) so
6277 remote_notif_process is not called. We need find a place where
6278 it is safe to start a 'vNotif' sequence. It is good to do it
6279 before resuming inferior, because inferior was stopped and no RSP
6280 traffic at that moment. */
6281 if (!target_is_non_stop_p ())
6282 remote_notif_process (rs->notif_state, ¬if_client_stop);
6284 rs->last_resume_exec_dir = ::execution_direction;
6286 /* Prefer vCont, and fallback to s/c/S/C, which use Hc. */
6287 if (!remote_resume_with_vcont (ptid, step, siggnal))
6288 remote_resume_with_hc (ptid, step, siggnal);
6290 /* We are about to start executing the inferior, let's register it
6291 with the event loop. NOTE: this is the one place where all the
6292 execution commands end up. We could alternatively do this in each
6293 of the execution commands in infcmd.c. */
6294 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
6295 into infcmd.c in order to allow inferior function calls to work
6296 NOT asynchronously. */
6297 if (target_can_async_p ())
6300 /* We've just told the target to resume. The remote server will
6301 wait for the inferior to stop, and then send a stop reply. In
6302 the mean time, we can't start another command/query ourselves
6303 because the stub wouldn't be ready to process it. This applies
6304 only to the base all-stop protocol, however. In non-stop (which
6305 only supports vCont), the stub replies with an "OK", and is
6306 immediate able to process further serial input. */
6307 if (!target_is_non_stop_p ())
6308 rs->waiting_for_stop_reply = 1;
6311 static int is_pending_fork_parent_thread (struct thread_info *thread);
6313 /* Private per-inferior info for target remote processes. */
6315 struct remote_inferior : public private_inferior
6317 /* Whether we can send a wildcard vCont for this process. */
6318 bool may_wildcard_vcont = true;
6321 /* Get the remote private inferior data associated to INF. */
6323 static remote_inferior *
6324 get_remote_inferior (inferior *inf)
6326 if (inf->priv == NULL)
6327 inf->priv.reset (new remote_inferior);
6329 return static_cast<remote_inferior *> (inf->priv.get ());
6332 /* Class used to track the construction of a vCont packet in the
6333 outgoing packet buffer. This is used to send multiple vCont
6334 packets if we have more actions than would fit a single packet. */
6339 explicit vcont_builder (remote_target *remote)
6346 void push_action (ptid_t ptid, bool step, gdb_signal siggnal);
6351 /* The remote target. */
6352 remote_target *m_remote;
6354 /* Pointer to the first action. P points here if no action has been
6356 char *m_first_action;
6358 /* Where the next action will be appended. */
6361 /* The end of the buffer. Must never write past this. */
6365 /* Prepare the outgoing buffer for a new vCont packet. */
6368 vcont_builder::restart ()
6370 struct remote_state *rs = m_remote->get_remote_state ();
6372 m_p = rs->buf.data ();
6373 m_endp = m_p + m_remote->get_remote_packet_size ();
6374 m_p += xsnprintf (m_p, m_endp - m_p, "vCont");
6375 m_first_action = m_p;
6378 /* If the vCont packet being built has any action, send it to the
6382 vcont_builder::flush ()
6384 struct remote_state *rs;
6386 if (m_p == m_first_action)
6389 rs = m_remote->get_remote_state ();
6390 m_remote->putpkt (rs->buf);
6391 m_remote->getpkt (&rs->buf, 0);
6392 if (strcmp (rs->buf.data (), "OK") != 0)
6393 error (_("Unexpected vCont reply in non-stop mode: %s"), rs->buf.data ());
6396 /* The largest action is range-stepping, with its two addresses. This
6397 is more than sufficient. If a new, bigger action is created, it'll
6398 quickly trigger a failed assertion in append_resumption (and we'll
6400 #define MAX_ACTION_SIZE 200
6402 /* Append a new vCont action in the outgoing packet being built. If
6403 the action doesn't fit the packet along with previous actions, push
6404 what we've got so far to the remote end and start over a new vCont
6405 packet (with the new action). */
6408 vcont_builder::push_action (ptid_t ptid, bool step, gdb_signal siggnal)
6410 char buf[MAX_ACTION_SIZE + 1];
6412 char *endp = m_remote->append_resumption (buf, buf + sizeof (buf),
6413 ptid, step, siggnal);
6415 /* Check whether this new action would fit in the vCont packet along
6416 with previous actions. If not, send what we've got so far and
6417 start a new vCont packet. */
6418 size_t rsize = endp - buf;
6419 if (rsize > m_endp - m_p)
6424 /* Should now fit. */
6425 gdb_assert (rsize <= m_endp - m_p);
6428 memcpy (m_p, buf, rsize);
6433 /* to_commit_resume implementation. */
6436 remote_target::commit_resume ()
6438 int any_process_wildcard;
6439 int may_global_wildcard_vcont;
6441 /* If connected in all-stop mode, we'd send the remote resume
6442 request directly from remote_resume. Likewise if
6443 reverse-debugging, as there are no defined vCont actions for
6444 reverse execution. */
6445 if (!target_is_non_stop_p () || ::execution_direction == EXEC_REVERSE)
6448 /* Try to send wildcard actions ("vCont;c" or "vCont;c:pPID.-1")
6449 instead of resuming all threads of each process individually.
6450 However, if any thread of a process must remain halted, we can't
6451 send wildcard resumes and must send one action per thread.
6453 Care must be taken to not resume threads/processes the server
6454 side already told us are stopped, but the core doesn't know about
6455 yet, because the events are still in the vStopped notification
6458 #1 => vCont s:p1.1;c
6460 #3 <= %Stopped T05 p1.1
6465 #8 (infrun handles the stop for p1.1 and continues stepping)
6466 #9 => vCont s:p1.1;c
6468 The last vCont above would resume thread p1.2 by mistake, because
6469 the server has no idea that the event for p1.2 had not been
6472 The server side must similarly ignore resume actions for the
6473 thread that has a pending %Stopped notification (and any other
6474 threads with events pending), until GDB acks the notification
6475 with vStopped. Otherwise, e.g., the following case is
6478 #1 => g (or any other packet)
6480 #3 <= %Stopped T05 p1.2
6481 #4 => vCont s:p1.1;c
6484 Above, the server must not resume thread p1.2. GDB can't know
6485 that p1.2 stopped until it acks the %Stopped notification, and
6486 since from GDB's perspective all threads should be running, it
6489 Finally, special care must also be given to handling fork/vfork
6490 events. A (v)fork event actually tells us that two processes
6491 stopped -- the parent and the child. Until we follow the fork,
6492 we must not resume the child. Therefore, if we have a pending
6493 fork follow, we must not send a global wildcard resume action
6494 (vCont;c). We can still send process-wide wildcards though. */
6496 /* Start by assuming a global wildcard (vCont;c) is possible. */
6497 may_global_wildcard_vcont = 1;
6499 /* And assume every process is individually wildcard-able too. */
6500 for (inferior *inf : all_non_exited_inferiors ())
6502 remote_inferior *priv = get_remote_inferior (inf);
6504 priv->may_wildcard_vcont = true;
6507 /* Check for any pending events (not reported or processed yet) and
6508 disable process and global wildcard resumes appropriately. */
6509 check_pending_events_prevent_wildcard_vcont (&may_global_wildcard_vcont);
6511 for (thread_info *tp : all_non_exited_threads ())
6513 /* If a thread of a process is not meant to be resumed, then we
6514 can't wildcard that process. */
6517 get_remote_inferior (tp->inf)->may_wildcard_vcont = false;
6519 /* And if we can't wildcard a process, we can't wildcard
6520 everything either. */
6521 may_global_wildcard_vcont = 0;
6525 /* If a thread is the parent of an unfollowed fork, then we
6526 can't do a global wildcard, as that would resume the fork
6528 if (is_pending_fork_parent_thread (tp))
6529 may_global_wildcard_vcont = 0;
6532 /* Now let's build the vCont packet(s). Actions must be appended
6533 from narrower to wider scopes (thread -> process -> global). If
6534 we end up with too many actions for a single packet vcont_builder
6535 flushes the current vCont packet to the remote side and starts a
6537 struct vcont_builder vcont_builder (this);
6539 /* Threads first. */
6540 for (thread_info *tp : all_non_exited_threads ())
6542 remote_thread_info *remote_thr = get_remote_thread_info (tp);
6544 if (!tp->executing || remote_thr->vcont_resumed)
6547 gdb_assert (!thread_is_in_step_over_chain (tp));
6549 if (!remote_thr->last_resume_step
6550 && remote_thr->last_resume_sig == GDB_SIGNAL_0
6551 && get_remote_inferior (tp->inf)->may_wildcard_vcont)
6553 /* We'll send a wildcard resume instead. */
6554 remote_thr->vcont_resumed = 1;
6558 vcont_builder.push_action (tp->ptid,
6559 remote_thr->last_resume_step,
6560 remote_thr->last_resume_sig);
6561 remote_thr->vcont_resumed = 1;
6564 /* Now check whether we can send any process-wide wildcard. This is
6565 to avoid sending a global wildcard in the case nothing is
6566 supposed to be resumed. */
6567 any_process_wildcard = 0;
6569 for (inferior *inf : all_non_exited_inferiors ())
6571 if (get_remote_inferior (inf)->may_wildcard_vcont)
6573 any_process_wildcard = 1;
6578 if (any_process_wildcard)
6580 /* If all processes are wildcard-able, then send a single "c"
6581 action, otherwise, send an "all (-1) threads of process"
6582 continue action for each running process, if any. */
6583 if (may_global_wildcard_vcont)
6585 vcont_builder.push_action (minus_one_ptid,
6586 false, GDB_SIGNAL_0);
6590 for (inferior *inf : all_non_exited_inferiors ())
6592 if (get_remote_inferior (inf)->may_wildcard_vcont)
6594 vcont_builder.push_action (ptid_t (inf->pid),
6595 false, GDB_SIGNAL_0);
6601 vcont_builder.flush ();
6606 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
6607 thread, all threads of a remote process, or all threads of all
6611 remote_target::remote_stop_ns (ptid_t ptid)
6613 struct remote_state *rs = get_remote_state ();
6614 char *p = rs->buf.data ();
6615 char *endp = p + get_remote_packet_size ();
6617 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
6618 remote_vcont_probe ();
6620 if (!rs->supports_vCont.t)
6621 error (_("Remote server does not support stopping threads"));
6623 if (ptid == minus_one_ptid
6624 || (!remote_multi_process_p (rs) && ptid.is_pid ()))
6625 p += xsnprintf (p, endp - p, "vCont;t");
6630 p += xsnprintf (p, endp - p, "vCont;t:");
6633 /* All (-1) threads of process. */
6634 nptid = ptid_t (ptid.pid (), -1, 0);
6637 /* Small optimization: if we already have a stop reply for
6638 this thread, no use in telling the stub we want this
6640 if (peek_stop_reply (ptid))
6646 write_ptid (p, endp, nptid);
6649 /* In non-stop, we get an immediate OK reply. The stop reply will
6650 come in asynchronously by notification. */
6652 getpkt (&rs->buf, 0);
6653 if (strcmp (rs->buf.data (), "OK") != 0)
6654 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid),
6658 /* All-stop version of target_interrupt. Sends a break or a ^C to
6659 interrupt the remote target. It is undefined which thread of which
6660 process reports the interrupt. */
6663 remote_target::remote_interrupt_as ()
6665 struct remote_state *rs = get_remote_state ();
6667 rs->ctrlc_pending_p = 1;
6669 /* If the inferior is stopped already, but the core didn't know
6670 about it yet, just ignore the request. The cached wait status
6671 will be collected in remote_wait. */
6672 if (rs->cached_wait_status)
6675 /* Send interrupt_sequence to remote target. */
6676 send_interrupt_sequence ();
6679 /* Non-stop version of target_interrupt. Uses `vCtrlC' to interrupt
6680 the remote target. It is undefined which thread of which process
6681 reports the interrupt. Throws an error if the packet is not
6682 supported by the server. */
6685 remote_target::remote_interrupt_ns ()
6687 struct remote_state *rs = get_remote_state ();
6688 char *p = rs->buf.data ();
6689 char *endp = p + get_remote_packet_size ();
6691 xsnprintf (p, endp - p, "vCtrlC");
6693 /* In non-stop, we get an immediate OK reply. The stop reply will
6694 come in asynchronously by notification. */
6696 getpkt (&rs->buf, 0);
6698 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_vCtrlC]))
6702 case PACKET_UNKNOWN:
6703 error (_("No support for interrupting the remote target."));
6705 error (_("Interrupting target failed: %s"), rs->buf.data ());
6709 /* Implement the to_stop function for the remote targets. */
6712 remote_target::stop (ptid_t ptid)
6715 fprintf_unfiltered (gdb_stdlog, "remote_stop called\n");
6717 if (target_is_non_stop_p ())
6718 remote_stop_ns (ptid);
6721 /* We don't currently have a way to transparently pause the
6722 remote target in all-stop mode. Interrupt it instead. */
6723 remote_interrupt_as ();
6727 /* Implement the to_interrupt function for the remote targets. */
6730 remote_target::interrupt ()
6733 fprintf_unfiltered (gdb_stdlog, "remote_interrupt called\n");
6735 if (target_is_non_stop_p ())
6736 remote_interrupt_ns ();
6738 remote_interrupt_as ();
6741 /* Implement the to_pass_ctrlc function for the remote targets. */
6744 remote_target::pass_ctrlc ()
6746 struct remote_state *rs = get_remote_state ();
6749 fprintf_unfiltered (gdb_stdlog, "remote_pass_ctrlc called\n");
6751 /* If we're starting up, we're not fully synced yet. Quit
6753 if (rs->starting_up)
6755 /* If ^C has already been sent once, offer to disconnect. */
6756 else if (rs->ctrlc_pending_p)
6759 target_interrupt ();
6762 /* Ask the user what to do when an interrupt is received. */
6765 remote_target::interrupt_query ()
6767 struct remote_state *rs = get_remote_state ();
6769 if (rs->waiting_for_stop_reply && rs->ctrlc_pending_p)
6771 if (query (_("The target is not responding to interrupt requests.\n"
6772 "Stop debugging it? ")))
6774 remote_unpush_target ();
6775 throw_error (TARGET_CLOSE_ERROR, _("Disconnected from target."));
6780 if (query (_("Interrupted while waiting for the program.\n"
6781 "Give up waiting? ")))
6786 /* Enable/disable target terminal ownership. Most targets can use
6787 terminal groups to control terminal ownership. Remote targets are
6788 different in that explicit transfer of ownership to/from GDB/target
6792 remote_target::terminal_inferior ()
6794 /* NOTE: At this point we could also register our selves as the
6795 recipient of all input. Any characters typed could then be
6796 passed on down to the target. */
6800 remote_target::terminal_ours ()
6805 remote_console_output (const char *msg)
6809 for (p = msg; p[0] && p[1]; p += 2)
6812 char c = fromhex (p[0]) * 16 + fromhex (p[1]);
6816 fputs_unfiltered (tb, gdb_stdtarg);
6818 gdb_flush (gdb_stdtarg);
6821 DEF_VEC_O(cached_reg_t);
6823 typedef struct stop_reply
6825 struct notif_event base;
6827 /* The identifier of the thread about this event */
6830 /* The remote state this event is associated with. When the remote
6831 connection, represented by a remote_state object, is closed,
6832 all the associated stop_reply events should be released. */
6833 struct remote_state *rs;
6835 struct target_waitstatus ws;
6837 /* The architecture associated with the expedited registers. */
6840 /* Expedited registers. This makes remote debugging a bit more
6841 efficient for those targets that provide critical registers as
6842 part of their normal status mechanism (as another roundtrip to
6843 fetch them is avoided). */
6844 VEC(cached_reg_t) *regcache;
6846 enum target_stop_reason stop_reason;
6848 CORE_ADDR watch_data_address;
6854 stop_reply_xfree (struct stop_reply *r)
6856 notif_event_xfree ((struct notif_event *) r);
6859 /* Return the length of the stop reply queue. */
6862 remote_target::stop_reply_queue_length ()
6864 remote_state *rs = get_remote_state ();
6865 return rs->stop_reply_queue.size ();
6869 remote_notif_stop_parse (remote_target *remote,
6870 struct notif_client *self, const char *buf,
6871 struct notif_event *event)
6873 remote->remote_parse_stop_reply (buf, (struct stop_reply *) event);
6877 remote_notif_stop_ack (remote_target *remote,
6878 struct notif_client *self, const char *buf,
6879 struct notif_event *event)
6881 struct stop_reply *stop_reply = (struct stop_reply *) event;
6884 putpkt (remote, self->ack_command);
6886 if (stop_reply->ws.kind == TARGET_WAITKIND_IGNORE)
6888 /* We got an unknown stop reply. */
6889 error (_("Unknown stop reply"));
6892 remote->push_stop_reply (stop_reply);
6896 remote_notif_stop_can_get_pending_events (remote_target *remote,
6897 struct notif_client *self)
6899 /* We can't get pending events in remote_notif_process for
6900 notification stop, and we have to do this in remote_wait_ns
6901 instead. If we fetch all queued events from stub, remote stub
6902 may exit and we have no chance to process them back in
6904 remote_state *rs = remote->get_remote_state ();
6905 mark_async_event_handler (rs->remote_async_inferior_event_token);
6910 stop_reply_dtr (struct notif_event *event)
6912 struct stop_reply *r = (struct stop_reply *) event;
6917 VEC_iterate (cached_reg_t, r->regcache, ix, reg);
6921 VEC_free (cached_reg_t, r->regcache);
6924 static struct notif_event *
6925 remote_notif_stop_alloc_reply (void)
6927 /* We cast to a pointer to the "base class". */
6928 struct notif_event *r = (struct notif_event *) XNEW (struct stop_reply);
6930 r->dtr = stop_reply_dtr;
6935 /* A client of notification Stop. */
6937 struct notif_client notif_client_stop =
6941 remote_notif_stop_parse,
6942 remote_notif_stop_ack,
6943 remote_notif_stop_can_get_pending_events,
6944 remote_notif_stop_alloc_reply,
6948 /* Determine if THREAD_PTID is a pending fork parent thread. ARG contains
6949 the pid of the process that owns the threads we want to check, or
6950 -1 if we want to check all threads. */
6953 is_pending_fork_parent (struct target_waitstatus *ws, int event_pid,
6956 if (ws->kind == TARGET_WAITKIND_FORKED
6957 || ws->kind == TARGET_WAITKIND_VFORKED)
6959 if (event_pid == -1 || event_pid == thread_ptid.pid ())
6966 /* Return the thread's pending status used to determine whether the
6967 thread is a fork parent stopped at a fork event. */
6969 static struct target_waitstatus *
6970 thread_pending_fork_status (struct thread_info *thread)
6972 if (thread->suspend.waitstatus_pending_p)
6973 return &thread->suspend.waitstatus;
6975 return &thread->pending_follow;
6978 /* Determine if THREAD is a pending fork parent thread. */
6981 is_pending_fork_parent_thread (struct thread_info *thread)
6983 struct target_waitstatus *ws = thread_pending_fork_status (thread);
6986 return is_pending_fork_parent (ws, pid, thread->ptid);
6989 /* If CONTEXT contains any fork child threads that have not been
6990 reported yet, remove them from the CONTEXT list. If such a
6991 thread exists it is because we are stopped at a fork catchpoint
6992 and have not yet called follow_fork, which will set up the
6993 host-side data structures for the new process. */
6996 remote_target::remove_new_fork_children (threads_listing_context *context)
6999 struct notif_client *notif = ¬if_client_stop;
7001 /* For any threads stopped at a fork event, remove the corresponding
7002 fork child threads from the CONTEXT list. */
7003 for (thread_info *thread : all_non_exited_threads ())
7005 struct target_waitstatus *ws = thread_pending_fork_status (thread);
7007 if (is_pending_fork_parent (ws, pid, thread->ptid))
7008 context->remove_thread (ws->value.related_pid);
7011 /* Check for any pending fork events (not reported or processed yet)
7012 in process PID and remove those fork child threads from the
7013 CONTEXT list as well. */
7014 remote_notif_get_pending_events (notif);
7015 for (auto &event : get_remote_state ()->stop_reply_queue)
7016 if (event->ws.kind == TARGET_WAITKIND_FORKED
7017 || event->ws.kind == TARGET_WAITKIND_VFORKED
7018 || event->ws.kind == TARGET_WAITKIND_THREAD_EXITED)
7019 context->remove_thread (event->ws.value.related_pid);
7022 /* Check whether any event pending in the vStopped queue would prevent
7023 a global or process wildcard vCont action. Clear
7024 *may_global_wildcard if we can't do a global wildcard (vCont;c),
7025 and clear the event inferior's may_wildcard_vcont flag if we can't
7026 do a process-wide wildcard resume (vCont;c:pPID.-1). */
7029 remote_target::check_pending_events_prevent_wildcard_vcont
7030 (int *may_global_wildcard)
7032 struct notif_client *notif = ¬if_client_stop;
7034 remote_notif_get_pending_events (notif);
7035 for (auto &event : get_remote_state ()->stop_reply_queue)
7037 if (event->ws.kind == TARGET_WAITKIND_NO_RESUMED
7038 || event->ws.kind == TARGET_WAITKIND_NO_HISTORY)
7041 if (event->ws.kind == TARGET_WAITKIND_FORKED
7042 || event->ws.kind == TARGET_WAITKIND_VFORKED)
7043 *may_global_wildcard = 0;
7045 struct inferior *inf = find_inferior_ptid (event->ptid);
7047 /* This may be the first time we heard about this process.
7048 Regardless, we must not do a global wildcard resume, otherwise
7049 we'd resume this process too. */
7050 *may_global_wildcard = 0;
7052 get_remote_inferior (inf)->may_wildcard_vcont = false;
7056 /* Discard all pending stop replies of inferior INF. */
7059 remote_target::discard_pending_stop_replies (struct inferior *inf)
7061 struct stop_reply *reply;
7062 struct remote_state *rs = get_remote_state ();
7063 struct remote_notif_state *rns = rs->notif_state;
7065 /* This function can be notified when an inferior exists. When the
7066 target is not remote, the notification state is NULL. */
7067 if (rs->remote_desc == NULL)
7070 reply = (struct stop_reply *) rns->pending_event[notif_client_stop.id];
7072 /* Discard the in-flight notification. */
7073 if (reply != NULL && reply->ptid.pid () == inf->pid)
7075 stop_reply_xfree (reply);
7076 rns->pending_event[notif_client_stop.id] = NULL;
7079 /* Discard the stop replies we have already pulled with
7081 auto iter = std::remove_if (rs->stop_reply_queue.begin (),
7082 rs->stop_reply_queue.end (),
7083 [=] (const stop_reply_up &event)
7085 return event->ptid.pid () == inf->pid;
7087 rs->stop_reply_queue.erase (iter, rs->stop_reply_queue.end ());
7090 /* Discard the stop replies for RS in stop_reply_queue. */
7093 remote_target::discard_pending_stop_replies_in_queue ()
7095 remote_state *rs = get_remote_state ();
7097 /* Discard the stop replies we have already pulled with
7099 auto iter = std::remove_if (rs->stop_reply_queue.begin (),
7100 rs->stop_reply_queue.end (),
7101 [=] (const stop_reply_up &event)
7103 return event->rs == rs;
7105 rs->stop_reply_queue.erase (iter, rs->stop_reply_queue.end ());
7108 /* Remove the first reply in 'stop_reply_queue' which matches
7112 remote_target::remote_notif_remove_queued_reply (ptid_t ptid)
7114 remote_state *rs = get_remote_state ();
7116 auto iter = std::find_if (rs->stop_reply_queue.begin (),
7117 rs->stop_reply_queue.end (),
7118 [=] (const stop_reply_up &event)
7120 return event->ptid.matches (ptid);
7122 struct stop_reply *result;
7123 if (iter == rs->stop_reply_queue.end ())
7127 result = iter->release ();
7128 rs->stop_reply_queue.erase (iter);
7132 fprintf_unfiltered (gdb_stdlog,
7133 "notif: discard queued event: 'Stop' in %s\n",
7134 target_pid_to_str (ptid));
7139 /* Look for a queued stop reply belonging to PTID. If one is found,
7140 remove it from the queue, and return it. Returns NULL if none is
7141 found. If there are still queued events left to process, tell the
7142 event loop to get back to target_wait soon. */
7145 remote_target::queued_stop_reply (ptid_t ptid)
7147 remote_state *rs = get_remote_state ();
7148 struct stop_reply *r = remote_notif_remove_queued_reply (ptid);
7150 if (!rs->stop_reply_queue.empty ())
7152 /* There's still at least an event left. */
7153 mark_async_event_handler (rs->remote_async_inferior_event_token);
7159 /* Push a fully parsed stop reply in the stop reply queue. Since we
7160 know that we now have at least one queued event left to pass to the
7161 core side, tell the event loop to get back to target_wait soon. */
7164 remote_target::push_stop_reply (struct stop_reply *new_event)
7166 remote_state *rs = get_remote_state ();
7167 rs->stop_reply_queue.push_back (stop_reply_up (new_event));
7170 fprintf_unfiltered (gdb_stdlog,
7171 "notif: push 'Stop' %s to queue %d\n",
7172 target_pid_to_str (new_event->ptid),
7173 int (rs->stop_reply_queue.size ()));
7175 mark_async_event_handler (rs->remote_async_inferior_event_token);
7178 /* Returns true if we have a stop reply for PTID. */
7181 remote_target::peek_stop_reply (ptid_t ptid)
7183 remote_state *rs = get_remote_state ();
7184 for (auto &event : rs->stop_reply_queue)
7185 if (ptid == event->ptid
7186 && event->ws.kind == TARGET_WAITKIND_STOPPED)
7191 /* Helper for remote_parse_stop_reply. Return nonzero if the substring
7192 starting with P and ending with PEND matches PREFIX. */
7195 strprefix (const char *p, const char *pend, const char *prefix)
7197 for ( ; p < pend; p++, prefix++)
7200 return *prefix == '\0';
7203 /* Parse the stop reply in BUF. Either the function succeeds, and the
7204 result is stored in EVENT, or throws an error. */
7207 remote_target::remote_parse_stop_reply (const char *buf, stop_reply *event)
7209 remote_arch_state *rsa = NULL;
7214 event->ptid = null_ptid;
7215 event->rs = get_remote_state ();
7216 event->ws.kind = TARGET_WAITKIND_IGNORE;
7217 event->ws.value.integer = 0;
7218 event->stop_reason = TARGET_STOPPED_BY_NO_REASON;
7219 event->regcache = NULL;
7224 case 'T': /* Status with PC, SP, FP, ... */
7225 /* Expedited reply, containing Signal, {regno, reg} repeat. */
7226 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
7228 n... = register number
7229 r... = register contents
7232 p = &buf[3]; /* after Txx */
7238 p1 = strchr (p, ':');
7240 error (_("Malformed packet(a) (missing colon): %s\n\
7244 error (_("Malformed packet(a) (missing register number): %s\n\
7248 /* Some "registers" are actually extended stop information.
7249 Note if you're adding a new entry here: GDB 7.9 and
7250 earlier assume that all register "numbers" that start
7251 with an hex digit are real register numbers. Make sure
7252 the server only sends such a packet if it knows the
7253 client understands it. */
7255 if (strprefix (p, p1, "thread"))
7256 event->ptid = read_ptid (++p1, &p);
7257 else if (strprefix (p, p1, "syscall_entry"))
7261 event->ws.kind = TARGET_WAITKIND_SYSCALL_ENTRY;
7262 p = unpack_varlen_hex (++p1, &sysno);
7263 event->ws.value.syscall_number = (int) sysno;
7265 else if (strprefix (p, p1, "syscall_return"))
7269 event->ws.kind = TARGET_WAITKIND_SYSCALL_RETURN;
7270 p = unpack_varlen_hex (++p1, &sysno);
7271 event->ws.value.syscall_number = (int) sysno;
7273 else if (strprefix (p, p1, "watch")
7274 || strprefix (p, p1, "rwatch")
7275 || strprefix (p, p1, "awatch"))
7277 event->stop_reason = TARGET_STOPPED_BY_WATCHPOINT;
7278 p = unpack_varlen_hex (++p1, &addr);
7279 event->watch_data_address = (CORE_ADDR) addr;
7281 else if (strprefix (p, p1, "swbreak"))
7283 event->stop_reason = TARGET_STOPPED_BY_SW_BREAKPOINT;
7285 /* Make sure the stub doesn't forget to indicate support
7287 if (packet_support (PACKET_swbreak_feature) != PACKET_ENABLE)
7288 error (_("Unexpected swbreak stop reason"));
7290 /* The value part is documented as "must be empty",
7291 though we ignore it, in case we ever decide to make
7292 use of it in a backward compatible way. */
7293 p = strchrnul (p1 + 1, ';');
7295 else if (strprefix (p, p1, "hwbreak"))
7297 event->stop_reason = TARGET_STOPPED_BY_HW_BREAKPOINT;
7299 /* Make sure the stub doesn't forget to indicate support
7301 if (packet_support (PACKET_hwbreak_feature) != PACKET_ENABLE)
7302 error (_("Unexpected hwbreak stop reason"));
7305 p = strchrnul (p1 + 1, ';');
7307 else if (strprefix (p, p1, "library"))
7309 event->ws.kind = TARGET_WAITKIND_LOADED;
7310 p = strchrnul (p1 + 1, ';');
7312 else if (strprefix (p, p1, "replaylog"))
7314 event->ws.kind = TARGET_WAITKIND_NO_HISTORY;
7315 /* p1 will indicate "begin" or "end", but it makes
7316 no difference for now, so ignore it. */
7317 p = strchrnul (p1 + 1, ';');
7319 else if (strprefix (p, p1, "core"))
7323 p = unpack_varlen_hex (++p1, &c);
7326 else if (strprefix (p, p1, "fork"))
7328 event->ws.value.related_pid = read_ptid (++p1, &p);
7329 event->ws.kind = TARGET_WAITKIND_FORKED;
7331 else if (strprefix (p, p1, "vfork"))
7333 event->ws.value.related_pid = read_ptid (++p1, &p);
7334 event->ws.kind = TARGET_WAITKIND_VFORKED;
7336 else if (strprefix (p, p1, "vforkdone"))
7338 event->ws.kind = TARGET_WAITKIND_VFORK_DONE;
7339 p = strchrnul (p1 + 1, ';');
7341 else if (strprefix (p, p1, "exec"))
7344 char pathname[PATH_MAX];
7347 /* Determine the length of the execd pathname. */
7348 p = unpack_varlen_hex (++p1, &ignored);
7349 pathlen = (p - p1) / 2;
7351 /* Save the pathname for event reporting and for
7352 the next run command. */
7353 hex2bin (p1, (gdb_byte *) pathname, pathlen);
7354 pathname[pathlen] = '\0';
7356 /* This is freed during event handling. */
7357 event->ws.value.execd_pathname = xstrdup (pathname);
7358 event->ws.kind = TARGET_WAITKIND_EXECD;
7360 /* Skip the registers included in this packet, since
7361 they may be for an architecture different from the
7362 one used by the original program. */
7365 else if (strprefix (p, p1, "create"))
7367 event->ws.kind = TARGET_WAITKIND_THREAD_CREATED;
7368 p = strchrnul (p1 + 1, ';');
7377 p = strchrnul (p1 + 1, ';');
7382 /* Maybe a real ``P'' register number. */
7383 p_temp = unpack_varlen_hex (p, &pnum);
7384 /* If the first invalid character is the colon, we got a
7385 register number. Otherwise, it's an unknown stop
7389 /* If we haven't parsed the event's thread yet, find
7390 it now, in order to find the architecture of the
7391 reported expedited registers. */
7392 if (event->ptid == null_ptid)
7394 const char *thr = strstr (p1 + 1, ";thread:");
7396 event->ptid = read_ptid (thr + strlen (";thread:"),
7400 /* Either the current thread hasn't changed,
7401 or the inferior is not multi-threaded.
7402 The event must be for the thread we last
7403 set as (or learned as being) current. */
7404 event->ptid = event->rs->general_thread;
7410 inferior *inf = (event->ptid == null_ptid
7412 : find_inferior_ptid (event->ptid));
7413 /* If this is the first time we learn anything
7414 about this process, skip the registers
7415 included in this packet, since we don't yet
7416 know which architecture to use to parse them.
7417 We'll determine the architecture later when
7418 we process the stop reply and retrieve the
7419 target description, via
7420 remote_notice_new_inferior ->
7421 post_create_inferior. */
7424 p = strchrnul (p1 + 1, ';');
7429 event->arch = inf->gdbarch;
7430 rsa = event->rs->get_remote_arch_state (event->arch);
7434 = packet_reg_from_pnum (event->arch, rsa, pnum);
7435 cached_reg_t cached_reg;
7438 error (_("Remote sent bad register number %s: %s\n\
7440 hex_string (pnum), p, buf);
7442 cached_reg.num = reg->regnum;
7443 cached_reg.data = (gdb_byte *)
7444 xmalloc (register_size (event->arch, reg->regnum));
7447 fieldsize = hex2bin (p, cached_reg.data,
7448 register_size (event->arch, reg->regnum));
7450 if (fieldsize < register_size (event->arch, reg->regnum))
7451 warning (_("Remote reply is too short: %s"), buf);
7453 VEC_safe_push (cached_reg_t, event->regcache, &cached_reg);
7457 /* Not a number. Silently skip unknown optional
7459 p = strchrnul (p1 + 1, ';');
7464 error (_("Remote register badly formatted: %s\nhere: %s"),
7469 if (event->ws.kind != TARGET_WAITKIND_IGNORE)
7473 case 'S': /* Old style status, just signal only. */
7477 event->ws.kind = TARGET_WAITKIND_STOPPED;
7478 sig = (fromhex (buf[1]) << 4) + fromhex (buf[2]);
7479 if (GDB_SIGNAL_FIRST <= sig && sig < GDB_SIGNAL_LAST)
7480 event->ws.value.sig = (enum gdb_signal) sig;
7482 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
7485 case 'w': /* Thread exited. */
7489 event->ws.kind = TARGET_WAITKIND_THREAD_EXITED;
7490 p = unpack_varlen_hex (&buf[1], &value);
7491 event->ws.value.integer = value;
7493 error (_("stop reply packet badly formatted: %s"), buf);
7494 event->ptid = read_ptid (++p, NULL);
7497 case 'W': /* Target exited. */
7503 /* GDB used to accept only 2 hex chars here. Stubs should
7504 only send more if they detect GDB supports multi-process
7506 p = unpack_varlen_hex (&buf[1], &value);
7510 /* The remote process exited. */
7511 event->ws.kind = TARGET_WAITKIND_EXITED;
7512 event->ws.value.integer = value;
7516 /* The remote process exited with a signal. */
7517 event->ws.kind = TARGET_WAITKIND_SIGNALLED;
7518 if (GDB_SIGNAL_FIRST <= value && value < GDB_SIGNAL_LAST)
7519 event->ws.value.sig = (enum gdb_signal) value;
7521 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
7524 /* If no process is specified, assume inferior_ptid. */
7525 pid = inferior_ptid.pid ();
7534 else if (startswith (p, "process:"))
7538 p += sizeof ("process:") - 1;
7539 unpack_varlen_hex (p, &upid);
7543 error (_("unknown stop reply packet: %s"), buf);
7546 error (_("unknown stop reply packet: %s"), buf);
7547 event->ptid = ptid_t (pid);
7551 event->ws.kind = TARGET_WAITKIND_NO_RESUMED;
7552 event->ptid = minus_one_ptid;
7556 if (target_is_non_stop_p () && event->ptid == null_ptid)
7557 error (_("No process or thread specified in stop reply: %s"), buf);
7560 /* When the stub wants to tell GDB about a new notification reply, it
7561 sends a notification (%Stop, for example). Those can come it at
7562 any time, hence, we have to make sure that any pending
7563 putpkt/getpkt sequence we're making is finished, before querying
7564 the stub for more events with the corresponding ack command
7565 (vStopped, for example). E.g., if we started a vStopped sequence
7566 immediately upon receiving the notification, something like this
7574 1.6) <-- (registers reply to step #1.3)
7576 Obviously, the reply in step #1.6 would be unexpected to a vStopped
7579 To solve this, whenever we parse a %Stop notification successfully,
7580 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
7581 doing whatever we were doing:
7587 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
7588 2.5) <-- (registers reply to step #2.3)
7590 Eventualy after step #2.5, we return to the event loop, which
7591 notices there's an event on the
7592 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
7593 associated callback --- the function below. At this point, we're
7594 always safe to start a vStopped sequence. :
7597 2.7) <-- T05 thread:2
7603 remote_target::remote_notif_get_pending_events (notif_client *nc)
7605 struct remote_state *rs = get_remote_state ();
7607 if (rs->notif_state->pending_event[nc->id] != NULL)
7610 fprintf_unfiltered (gdb_stdlog,
7611 "notif: process: '%s' ack pending event\n",
7615 nc->ack (this, nc, rs->buf.data (),
7616 rs->notif_state->pending_event[nc->id]);
7617 rs->notif_state->pending_event[nc->id] = NULL;
7621 getpkt (&rs->buf, 0);
7622 if (strcmp (rs->buf.data (), "OK") == 0)
7625 remote_notif_ack (this, nc, rs->buf.data ());
7631 fprintf_unfiltered (gdb_stdlog,
7632 "notif: process: '%s' no pending reply\n",
7637 /* Wrapper around remote_target::remote_notif_get_pending_events to
7638 avoid having to export the whole remote_target class. */
7641 remote_notif_get_pending_events (remote_target *remote, notif_client *nc)
7643 remote->remote_notif_get_pending_events (nc);
7646 /* Called when it is decided that STOP_REPLY holds the info of the
7647 event that is to be returned to the core. This function always
7648 destroys STOP_REPLY. */
7651 remote_target::process_stop_reply (struct stop_reply *stop_reply,
7652 struct target_waitstatus *status)
7656 *status = stop_reply->ws;
7657 ptid = stop_reply->ptid;
7659 /* If no thread/process was reported by the stub, assume the current
7661 if (ptid == null_ptid)
7662 ptid = inferior_ptid;
7664 if (status->kind != TARGET_WAITKIND_EXITED
7665 && status->kind != TARGET_WAITKIND_SIGNALLED
7666 && status->kind != TARGET_WAITKIND_NO_RESUMED)
7668 /* Expedited registers. */
7669 if (stop_reply->regcache)
7671 struct regcache *regcache
7672 = get_thread_arch_regcache (ptid, stop_reply->arch);
7677 VEC_iterate (cached_reg_t, stop_reply->regcache, ix, reg);
7680 regcache->raw_supply (reg->num, reg->data);
7684 VEC_free (cached_reg_t, stop_reply->regcache);
7687 remote_notice_new_inferior (ptid, 0);
7688 remote_thread_info *remote_thr = get_remote_thread_info (ptid);
7689 remote_thr->core = stop_reply->core;
7690 remote_thr->stop_reason = stop_reply->stop_reason;
7691 remote_thr->watch_data_address = stop_reply->watch_data_address;
7692 remote_thr->vcont_resumed = 0;
7695 stop_reply_xfree (stop_reply);
7699 /* The non-stop mode version of target_wait. */
7702 remote_target::wait_ns (ptid_t ptid, struct target_waitstatus *status, int options)
7704 struct remote_state *rs = get_remote_state ();
7705 struct stop_reply *stop_reply;
7709 /* If in non-stop mode, get out of getpkt even if a
7710 notification is received. */
7712 ret = getpkt_or_notif_sane (&rs->buf, 0 /* forever */, &is_notif);
7715 if (ret != -1 && !is_notif)
7718 case 'E': /* Error of some sort. */
7719 /* We're out of sync with the target now. Did it continue
7720 or not? We can't tell which thread it was in non-stop,
7721 so just ignore this. */
7722 warning (_("Remote failure reply: %s"), rs->buf.data ());
7724 case 'O': /* Console output. */
7725 remote_console_output (&rs->buf[1]);
7728 warning (_("Invalid remote reply: %s"), rs->buf.data ());
7732 /* Acknowledge a pending stop reply that may have arrived in the
7734 if (rs->notif_state->pending_event[notif_client_stop.id] != NULL)
7735 remote_notif_get_pending_events (¬if_client_stop);
7737 /* If indeed we noticed a stop reply, we're done. */
7738 stop_reply = queued_stop_reply (ptid);
7739 if (stop_reply != NULL)
7740 return process_stop_reply (stop_reply, status);
7742 /* Still no event. If we're just polling for an event, then
7743 return to the event loop. */
7744 if (options & TARGET_WNOHANG)
7746 status->kind = TARGET_WAITKIND_IGNORE;
7747 return minus_one_ptid;
7750 /* Otherwise do a blocking wait. */
7751 ret = getpkt_or_notif_sane (&rs->buf, 1 /* forever */, &is_notif);
7755 /* Wait until the remote machine stops, then return, storing status in
7756 STATUS just as `wait' would. */
7759 remote_target::wait_as (ptid_t ptid, target_waitstatus *status, int options)
7761 struct remote_state *rs = get_remote_state ();
7762 ptid_t event_ptid = null_ptid;
7764 struct stop_reply *stop_reply;
7768 status->kind = TARGET_WAITKIND_IGNORE;
7769 status->value.integer = 0;
7771 stop_reply = queued_stop_reply (ptid);
7772 if (stop_reply != NULL)
7773 return process_stop_reply (stop_reply, status);
7775 if (rs->cached_wait_status)
7776 /* Use the cached wait status, but only once. */
7777 rs->cached_wait_status = 0;
7782 int forever = ((options & TARGET_WNOHANG) == 0
7783 && rs->wait_forever_enabled_p);
7785 if (!rs->waiting_for_stop_reply)
7787 status->kind = TARGET_WAITKIND_NO_RESUMED;
7788 return minus_one_ptid;
7791 /* FIXME: cagney/1999-09-27: If we're in async mode we should
7792 _never_ wait for ever -> test on target_is_async_p().
7793 However, before we do that we need to ensure that the caller
7794 knows how to take the target into/out of async mode. */
7795 ret = getpkt_or_notif_sane (&rs->buf, forever, &is_notif);
7797 /* GDB gets a notification. Return to core as this event is
7799 if (ret != -1 && is_notif)
7800 return minus_one_ptid;
7802 if (ret == -1 && (options & TARGET_WNOHANG) != 0)
7803 return minus_one_ptid;
7806 buf = rs->buf.data ();
7808 /* Assume that the target has acknowledged Ctrl-C unless we receive
7809 an 'F' or 'O' packet. */
7810 if (buf[0] != 'F' && buf[0] != 'O')
7811 rs->ctrlc_pending_p = 0;
7815 case 'E': /* Error of some sort. */
7816 /* We're out of sync with the target now. Did it continue or
7817 not? Not is more likely, so report a stop. */
7818 rs->waiting_for_stop_reply = 0;
7820 warning (_("Remote failure reply: %s"), buf);
7821 status->kind = TARGET_WAITKIND_STOPPED;
7822 status->value.sig = GDB_SIGNAL_0;
7824 case 'F': /* File-I/O request. */
7825 /* GDB may access the inferior memory while handling the File-I/O
7826 request, but we don't want GDB accessing memory while waiting
7827 for a stop reply. See the comments in putpkt_binary. Set
7828 waiting_for_stop_reply to 0 temporarily. */
7829 rs->waiting_for_stop_reply = 0;
7830 remote_fileio_request (this, buf, rs->ctrlc_pending_p);
7831 rs->ctrlc_pending_p = 0;
7832 /* GDB handled the File-I/O request, and the target is running
7833 again. Keep waiting for events. */
7834 rs->waiting_for_stop_reply = 1;
7836 case 'N': case 'T': case 'S': case 'X': case 'W':
7838 /* There is a stop reply to handle. */
7839 rs->waiting_for_stop_reply = 0;
7842 = (struct stop_reply *) remote_notif_parse (this,
7846 event_ptid = process_stop_reply (stop_reply, status);
7849 case 'O': /* Console output. */
7850 remote_console_output (buf + 1);
7853 if (rs->last_sent_signal != GDB_SIGNAL_0)
7855 /* Zero length reply means that we tried 'S' or 'C' and the
7856 remote system doesn't support it. */
7857 target_terminal::ours_for_output ();
7859 ("Can't send signals to this remote system. %s not sent.\n",
7860 gdb_signal_to_name (rs->last_sent_signal));
7861 rs->last_sent_signal = GDB_SIGNAL_0;
7862 target_terminal::inferior ();
7864 strcpy (buf, rs->last_sent_step ? "s" : "c");
7870 warning (_("Invalid remote reply: %s"), buf);
7874 if (status->kind == TARGET_WAITKIND_NO_RESUMED)
7875 return minus_one_ptid;
7876 else if (status->kind == TARGET_WAITKIND_IGNORE)
7878 /* Nothing interesting happened. If we're doing a non-blocking
7879 poll, we're done. Otherwise, go back to waiting. */
7880 if (options & TARGET_WNOHANG)
7881 return minus_one_ptid;
7885 else if (status->kind != TARGET_WAITKIND_EXITED
7886 && status->kind != TARGET_WAITKIND_SIGNALLED)
7888 if (event_ptid != null_ptid)
7889 record_currthread (rs, event_ptid);
7891 event_ptid = inferior_ptid;
7894 /* A process exit. Invalidate our notion of current thread. */
7895 record_currthread (rs, minus_one_ptid);
7900 /* Wait until the remote machine stops, then return, storing status in
7901 STATUS just as `wait' would. */
7904 remote_target::wait (ptid_t ptid, struct target_waitstatus *status, int options)
7908 if (target_is_non_stop_p ())
7909 event_ptid = wait_ns (ptid, status, options);
7911 event_ptid = wait_as (ptid, status, options);
7913 if (target_is_async_p ())
7915 remote_state *rs = get_remote_state ();
7917 /* If there are are events left in the queue tell the event loop
7919 if (!rs->stop_reply_queue.empty ())
7920 mark_async_event_handler (rs->remote_async_inferior_event_token);
7926 /* Fetch a single register using a 'p' packet. */
7929 remote_target::fetch_register_using_p (struct regcache *regcache,
7932 struct gdbarch *gdbarch = regcache->arch ();
7933 struct remote_state *rs = get_remote_state ();
7935 gdb_byte *regp = (gdb_byte *) alloca (register_size (gdbarch, reg->regnum));
7938 if (packet_support (PACKET_p) == PACKET_DISABLE)
7941 if (reg->pnum == -1)
7944 p = rs->buf.data ();
7946 p += hexnumstr (p, reg->pnum);
7949 getpkt (&rs->buf, 0);
7951 buf = rs->buf.data ();
7953 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_p]))
7957 case PACKET_UNKNOWN:
7960 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
7961 gdbarch_register_name (regcache->arch (),
7966 /* If this register is unfetchable, tell the regcache. */
7969 regcache->raw_supply (reg->regnum, NULL);
7973 /* Otherwise, parse and supply the value. */
7979 error (_("fetch_register_using_p: early buf termination"));
7981 regp[i++] = fromhex (p[0]) * 16 + fromhex (p[1]);
7984 regcache->raw_supply (reg->regnum, regp);
7988 /* Fetch the registers included in the target's 'g' packet. */
7991 remote_target::send_g_packet ()
7993 struct remote_state *rs = get_remote_state ();
7996 xsnprintf (rs->buf.data (), get_remote_packet_size (), "g");
7998 getpkt (&rs->buf, 0);
7999 if (packet_check_result (rs->buf) == PACKET_ERROR)
8000 error (_("Could not read registers; remote failure reply '%s'"),
8003 /* We can get out of synch in various cases. If the first character
8004 in the buffer is not a hex character, assume that has happened
8005 and try to fetch another packet to read. */
8006 while ((rs->buf[0] < '0' || rs->buf[0] > '9')
8007 && (rs->buf[0] < 'A' || rs->buf[0] > 'F')
8008 && (rs->buf[0] < 'a' || rs->buf[0] > 'f')
8009 && rs->buf[0] != 'x') /* New: unavailable register value. */
8012 fprintf_unfiltered (gdb_stdlog,
8013 "Bad register packet; fetching a new packet\n");
8014 getpkt (&rs->buf, 0);
8017 buf_len = strlen (rs->buf.data ());
8019 /* Sanity check the received packet. */
8020 if (buf_len % 2 != 0)
8021 error (_("Remote 'g' packet reply is of odd length: %s"), rs->buf.data ());
8027 remote_target::process_g_packet (struct regcache *regcache)
8029 struct gdbarch *gdbarch = regcache->arch ();
8030 struct remote_state *rs = get_remote_state ();
8031 remote_arch_state *rsa = rs->get_remote_arch_state (gdbarch);
8036 buf_len = strlen (rs->buf.data ());
8038 /* Further sanity checks, with knowledge of the architecture. */
8039 if (buf_len > 2 * rsa->sizeof_g_packet)
8040 error (_("Remote 'g' packet reply is too long (expected %ld bytes, got %d "
8042 rsa->sizeof_g_packet, buf_len / 2,
8045 /* Save the size of the packet sent to us by the target. It is used
8046 as a heuristic when determining the max size of packets that the
8047 target can safely receive. */
8048 if (rsa->actual_register_packet_size == 0)
8049 rsa->actual_register_packet_size = buf_len;
8051 /* If this is smaller than we guessed the 'g' packet would be,
8052 update our records. A 'g' reply that doesn't include a register's
8053 value implies either that the register is not available, or that
8054 the 'p' packet must be used. */
8055 if (buf_len < 2 * rsa->sizeof_g_packet)
8057 long sizeof_g_packet = buf_len / 2;
8059 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
8061 long offset = rsa->regs[i].offset;
8062 long reg_size = register_size (gdbarch, i);
8064 if (rsa->regs[i].pnum == -1)
8067 if (offset >= sizeof_g_packet)
8068 rsa->regs[i].in_g_packet = 0;
8069 else if (offset + reg_size > sizeof_g_packet)
8070 error (_("Truncated register %d in remote 'g' packet"), i);
8072 rsa->regs[i].in_g_packet = 1;
8075 /* Looks valid enough, we can assume this is the correct length
8076 for a 'g' packet. It's important not to adjust
8077 rsa->sizeof_g_packet if we have truncated registers otherwise
8078 this "if" won't be run the next time the method is called
8079 with a packet of the same size and one of the internal errors
8080 below will trigger instead. */
8081 rsa->sizeof_g_packet = sizeof_g_packet;
8084 regs = (char *) alloca (rsa->sizeof_g_packet);
8086 /* Unimplemented registers read as all bits zero. */
8087 memset (regs, 0, rsa->sizeof_g_packet);
8089 /* Reply describes registers byte by byte, each byte encoded as two
8090 hex characters. Suck them all up, then supply them to the
8091 register cacheing/storage mechanism. */
8093 p = rs->buf.data ();
8094 for (i = 0; i < rsa->sizeof_g_packet; i++)
8096 if (p[0] == 0 || p[1] == 0)
8097 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
8098 internal_error (__FILE__, __LINE__,
8099 _("unexpected end of 'g' packet reply"));
8101 if (p[0] == 'x' && p[1] == 'x')
8102 regs[i] = 0; /* 'x' */
8104 regs[i] = fromhex (p[0]) * 16 + fromhex (p[1]);
8108 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
8110 struct packet_reg *r = &rsa->regs[i];
8111 long reg_size = register_size (gdbarch, i);
8115 if ((r->offset + reg_size) * 2 > strlen (rs->buf.data ()))
8116 /* This shouldn't happen - we adjusted in_g_packet above. */
8117 internal_error (__FILE__, __LINE__,
8118 _("unexpected end of 'g' packet reply"));
8119 else if (rs->buf[r->offset * 2] == 'x')
8121 gdb_assert (r->offset * 2 < strlen (rs->buf.data ()));
8122 /* The register isn't available, mark it as such (at
8123 the same time setting the value to zero). */
8124 regcache->raw_supply (r->regnum, NULL);
8127 regcache->raw_supply (r->regnum, regs + r->offset);
8133 remote_target::fetch_registers_using_g (struct regcache *regcache)
8136 process_g_packet (regcache);
8139 /* Make the remote selected traceframe match GDB's selected
8143 remote_target::set_remote_traceframe ()
8146 struct remote_state *rs = get_remote_state ();
8148 if (rs->remote_traceframe_number == get_traceframe_number ())
8151 /* Avoid recursion, remote_trace_find calls us again. */
8152 rs->remote_traceframe_number = get_traceframe_number ();
8154 newnum = target_trace_find (tfind_number,
8155 get_traceframe_number (), 0, 0, NULL);
8157 /* Should not happen. If it does, all bets are off. */
8158 if (newnum != get_traceframe_number ())
8159 warning (_("could not set remote traceframe"));
8163 remote_target::fetch_registers (struct regcache *regcache, int regnum)
8165 struct gdbarch *gdbarch = regcache->arch ();
8166 struct remote_state *rs = get_remote_state ();
8167 remote_arch_state *rsa = rs->get_remote_arch_state (gdbarch);
8170 set_remote_traceframe ();
8171 set_general_thread (regcache->ptid ());
8175 packet_reg *reg = packet_reg_from_regnum (gdbarch, rsa, regnum);
8177 gdb_assert (reg != NULL);
8179 /* If this register might be in the 'g' packet, try that first -
8180 we are likely to read more than one register. If this is the
8181 first 'g' packet, we might be overly optimistic about its
8182 contents, so fall back to 'p'. */
8183 if (reg->in_g_packet)
8185 fetch_registers_using_g (regcache);
8186 if (reg->in_g_packet)
8190 if (fetch_register_using_p (regcache, reg))
8193 /* This register is not available. */
8194 regcache->raw_supply (reg->regnum, NULL);
8199 fetch_registers_using_g (regcache);
8201 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
8202 if (!rsa->regs[i].in_g_packet)
8203 if (!fetch_register_using_p (regcache, &rsa->regs[i]))
8205 /* This register is not available. */
8206 regcache->raw_supply (i, NULL);
8210 /* Prepare to store registers. Since we may send them all (using a
8211 'G' request), we have to read out the ones we don't want to change
8215 remote_target::prepare_to_store (struct regcache *regcache)
8217 struct remote_state *rs = get_remote_state ();
8218 remote_arch_state *rsa = rs->get_remote_arch_state (regcache->arch ());
8221 /* Make sure the entire registers array is valid. */
8222 switch (packet_support (PACKET_P))
8224 case PACKET_DISABLE:
8225 case PACKET_SUPPORT_UNKNOWN:
8226 /* Make sure all the necessary registers are cached. */
8227 for (i = 0; i < gdbarch_num_regs (regcache->arch ()); i++)
8228 if (rsa->regs[i].in_g_packet)
8229 regcache->raw_update (rsa->regs[i].regnum);
8236 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
8237 packet was not recognized. */
8240 remote_target::store_register_using_P (const struct regcache *regcache,
8243 struct gdbarch *gdbarch = regcache->arch ();
8244 struct remote_state *rs = get_remote_state ();
8245 /* Try storing a single register. */
8246 char *buf = rs->buf.data ();
8247 gdb_byte *regp = (gdb_byte *) alloca (register_size (gdbarch, reg->regnum));
8250 if (packet_support (PACKET_P) == PACKET_DISABLE)
8253 if (reg->pnum == -1)
8256 xsnprintf (buf, get_remote_packet_size (), "P%s=", phex_nz (reg->pnum, 0));
8257 p = buf + strlen (buf);
8258 regcache->raw_collect (reg->regnum, regp);
8259 bin2hex (regp, p, register_size (gdbarch, reg->regnum));
8261 getpkt (&rs->buf, 0);
8263 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_P]))
8268 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
8269 gdbarch_register_name (gdbarch, reg->regnum), rs->buf.data ());
8270 case PACKET_UNKNOWN:
8273 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
8277 /* Store register REGNUM, or all registers if REGNUM == -1, from the
8278 contents of the register cache buffer. FIXME: ignores errors. */
8281 remote_target::store_registers_using_G (const struct regcache *regcache)
8283 struct remote_state *rs = get_remote_state ();
8284 remote_arch_state *rsa = rs->get_remote_arch_state (regcache->arch ());
8288 /* Extract all the registers in the regcache copying them into a
8293 regs = (gdb_byte *) alloca (rsa->sizeof_g_packet);
8294 memset (regs, 0, rsa->sizeof_g_packet);
8295 for (i = 0; i < gdbarch_num_regs (regcache->arch ()); i++)
8297 struct packet_reg *r = &rsa->regs[i];
8300 regcache->raw_collect (r->regnum, regs + r->offset);
8304 /* Command describes registers byte by byte,
8305 each byte encoded as two hex characters. */
8306 p = rs->buf.data ();
8308 bin2hex (regs, p, rsa->sizeof_g_packet);
8310 getpkt (&rs->buf, 0);
8311 if (packet_check_result (rs->buf) == PACKET_ERROR)
8312 error (_("Could not write registers; remote failure reply '%s'"),
8316 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
8317 of the register cache buffer. FIXME: ignores errors. */
8320 remote_target::store_registers (struct regcache *regcache, int regnum)
8322 struct gdbarch *gdbarch = regcache->arch ();
8323 struct remote_state *rs = get_remote_state ();
8324 remote_arch_state *rsa = rs->get_remote_arch_state (gdbarch);
8327 set_remote_traceframe ();
8328 set_general_thread (regcache->ptid ());
8332 packet_reg *reg = packet_reg_from_regnum (gdbarch, rsa, regnum);
8334 gdb_assert (reg != NULL);
8336 /* Always prefer to store registers using the 'P' packet if
8337 possible; we often change only a small number of registers.
8338 Sometimes we change a larger number; we'd need help from a
8339 higher layer to know to use 'G'. */
8340 if (store_register_using_P (regcache, reg))
8343 /* For now, don't complain if we have no way to write the
8344 register. GDB loses track of unavailable registers too
8345 easily. Some day, this may be an error. We don't have
8346 any way to read the register, either... */
8347 if (!reg->in_g_packet)
8350 store_registers_using_G (regcache);
8354 store_registers_using_G (regcache);
8356 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
8357 if (!rsa->regs[i].in_g_packet)
8358 if (!store_register_using_P (regcache, &rsa->regs[i]))
8359 /* See above for why we do not issue an error here. */
8364 /* Return the number of hex digits in num. */
8367 hexnumlen (ULONGEST num)
8371 for (i = 0; num != 0; i++)
8374 return std::max (i, 1);
8377 /* Set BUF to the minimum number of hex digits representing NUM. */
8380 hexnumstr (char *buf, ULONGEST num)
8382 int len = hexnumlen (num);
8384 return hexnumnstr (buf, num, len);
8388 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
8391 hexnumnstr (char *buf, ULONGEST num, int width)
8397 for (i = width - 1; i >= 0; i--)
8399 buf[i] = "0123456789abcdef"[(num & 0xf)];
8406 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
8409 remote_address_masked (CORE_ADDR addr)
8411 unsigned int address_size = remote_address_size;
8413 /* If "remoteaddresssize" was not set, default to target address size. */
8415 address_size = gdbarch_addr_bit (target_gdbarch ());
8417 if (address_size > 0
8418 && address_size < (sizeof (ULONGEST) * 8))
8420 /* Only create a mask when that mask can safely be constructed
8421 in a ULONGEST variable. */
8424 mask = (mask << address_size) - 1;
8430 /* Determine whether the remote target supports binary downloading.
8431 This is accomplished by sending a no-op memory write of zero length
8432 to the target at the specified address. It does not suffice to send
8433 the whole packet, since many stubs strip the eighth bit and
8434 subsequently compute a wrong checksum, which causes real havoc with
8437 NOTE: This can still lose if the serial line is not eight-bit
8438 clean. In cases like this, the user should clear "remote
8442 remote_target::check_binary_download (CORE_ADDR addr)
8444 struct remote_state *rs = get_remote_state ();
8446 switch (packet_support (PACKET_X))
8448 case PACKET_DISABLE:
8452 case PACKET_SUPPORT_UNKNOWN:
8456 p = rs->buf.data ();
8458 p += hexnumstr (p, (ULONGEST) addr);
8460 p += hexnumstr (p, (ULONGEST) 0);
8464 putpkt_binary (rs->buf.data (), (int) (p - rs->buf.data ()));
8465 getpkt (&rs->buf, 0);
8467 if (rs->buf[0] == '\0')
8470 fprintf_unfiltered (gdb_stdlog,
8471 "binary downloading NOT "
8472 "supported by target\n");
8473 remote_protocol_packets[PACKET_X].support = PACKET_DISABLE;
8478 fprintf_unfiltered (gdb_stdlog,
8479 "binary downloading supported by target\n");
8480 remote_protocol_packets[PACKET_X].support = PACKET_ENABLE;
8487 /* Helper function to resize the payload in order to try to get a good
8488 alignment. We try to write an amount of data such that the next write will
8489 start on an address aligned on REMOTE_ALIGN_WRITES. */
8492 align_for_efficient_write (int todo, CORE_ADDR memaddr)
8494 return ((memaddr + todo) & ~(REMOTE_ALIGN_WRITES - 1)) - memaddr;
8497 /* Write memory data directly to the remote machine.
8498 This does not inform the data cache; the data cache uses this.
8499 HEADER is the starting part of the packet.
8500 MEMADDR is the address in the remote memory space.
8501 MYADDR is the address of the buffer in our space.
8502 LEN_UNITS is the number of addressable units to write.
8503 UNIT_SIZE is the length in bytes of an addressable unit.
8504 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
8505 should send data as binary ('X'), or hex-encoded ('M').
8507 The function creates packet of the form
8508 <HEADER><ADDRESS>,<LENGTH>:<DATA>
8510 where encoding of <DATA> is terminated by PACKET_FORMAT.
8512 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
8515 Return the transferred status, error or OK (an
8516 'enum target_xfer_status' value). Save the number of addressable units
8517 transferred in *XFERED_LEN_UNITS. Only transfer a single packet.
8519 On a platform with an addressable memory size of 2 bytes (UNIT_SIZE == 2), an
8520 exchange between gdb and the stub could look like (?? in place of the
8526 -> $M1000,3:eeeeffffeeee#??
8530 <- eeeeffffeeeedddd */
8533 remote_target::remote_write_bytes_aux (const char *header, CORE_ADDR memaddr,
8534 const gdb_byte *myaddr,
8537 ULONGEST *xfered_len_units,
8538 char packet_format, int use_length)
8540 struct remote_state *rs = get_remote_state ();
8546 int payload_capacity_bytes;
8547 int payload_length_bytes;
8549 if (packet_format != 'X' && packet_format != 'M')
8550 internal_error (__FILE__, __LINE__,
8551 _("remote_write_bytes_aux: bad packet format"));
8554 return TARGET_XFER_EOF;
8556 payload_capacity_bytes = get_memory_write_packet_size ();
8558 /* The packet buffer will be large enough for the payload;
8559 get_memory_packet_size ensures this. */
8562 /* Compute the size of the actual payload by subtracting out the
8563 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
8565 payload_capacity_bytes -= strlen ("$,:#NN");
8567 /* The comma won't be used. */
8568 payload_capacity_bytes += 1;
8569 payload_capacity_bytes -= strlen (header);
8570 payload_capacity_bytes -= hexnumlen (memaddr);
8572 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
8574 strcat (rs->buf.data (), header);
8575 p = rs->buf.data () + strlen (header);
8577 /* Compute a best guess of the number of bytes actually transfered. */
8578 if (packet_format == 'X')
8580 /* Best guess at number of bytes that will fit. */
8581 todo_units = std::min (len_units,
8582 (ULONGEST) payload_capacity_bytes / unit_size);
8584 payload_capacity_bytes -= hexnumlen (todo_units);
8585 todo_units = std::min (todo_units, payload_capacity_bytes / unit_size);
8589 /* Number of bytes that will fit. */
8591 = std::min (len_units,
8592 (ULONGEST) (payload_capacity_bytes / unit_size) / 2);
8594 payload_capacity_bytes -= hexnumlen (todo_units);
8595 todo_units = std::min (todo_units,
8596 (payload_capacity_bytes / unit_size) / 2);
8599 if (todo_units <= 0)
8600 internal_error (__FILE__, __LINE__,
8601 _("minimum packet size too small to write data"));
8603 /* If we already need another packet, then try to align the end
8604 of this packet to a useful boundary. */
8605 if (todo_units > 2 * REMOTE_ALIGN_WRITES && todo_units < len_units)
8606 todo_units = align_for_efficient_write (todo_units, memaddr);
8608 /* Append "<memaddr>". */
8609 memaddr = remote_address_masked (memaddr);
8610 p += hexnumstr (p, (ULONGEST) memaddr);
8617 /* Append the length and retain its location and size. It may need to be
8618 adjusted once the packet body has been created. */
8620 plenlen = hexnumstr (p, (ULONGEST) todo_units);
8628 /* Append the packet body. */
8629 if (packet_format == 'X')
8631 /* Binary mode. Send target system values byte by byte, in
8632 increasing byte addresses. Only escape certain critical
8634 payload_length_bytes =
8635 remote_escape_output (myaddr, todo_units, unit_size, (gdb_byte *) p,
8636 &units_written, payload_capacity_bytes);
8638 /* If not all TODO units fit, then we'll need another packet. Make
8639 a second try to keep the end of the packet aligned. Don't do
8640 this if the packet is tiny. */
8641 if (units_written < todo_units && units_written > 2 * REMOTE_ALIGN_WRITES)
8645 new_todo_units = align_for_efficient_write (units_written, memaddr);
8647 if (new_todo_units != units_written)
8648 payload_length_bytes =
8649 remote_escape_output (myaddr, new_todo_units, unit_size,
8650 (gdb_byte *) p, &units_written,
8651 payload_capacity_bytes);
8654 p += payload_length_bytes;
8655 if (use_length && units_written < todo_units)
8657 /* Escape chars have filled up the buffer prematurely,
8658 and we have actually sent fewer units than planned.
8659 Fix-up the length field of the packet. Use the same
8660 number of characters as before. */
8661 plen += hexnumnstr (plen, (ULONGEST) units_written,
8663 *plen = ':'; /* overwrite \0 from hexnumnstr() */
8668 /* Normal mode: Send target system values byte by byte, in
8669 increasing byte addresses. Each byte is encoded as a two hex
8671 p += 2 * bin2hex (myaddr, p, todo_units * unit_size);
8672 units_written = todo_units;
8675 putpkt_binary (rs->buf.data (), (int) (p - rs->buf.data ()));
8676 getpkt (&rs->buf, 0);
8678 if (rs->buf[0] == 'E')
8679 return TARGET_XFER_E_IO;
8681 /* Return UNITS_WRITTEN, not TODO_UNITS, in case escape chars caused us to
8682 send fewer units than we'd planned. */
8683 *xfered_len_units = (ULONGEST) units_written;
8684 return (*xfered_len_units != 0) ? TARGET_XFER_OK : TARGET_XFER_EOF;
8687 /* Write memory data directly to the remote machine.
8688 This does not inform the data cache; the data cache uses this.
8689 MEMADDR is the address in the remote memory space.
8690 MYADDR is the address of the buffer in our space.
8691 LEN is the number of bytes.
8693 Return the transferred status, error or OK (an
8694 'enum target_xfer_status' value). Save the number of bytes
8695 transferred in *XFERED_LEN. Only transfer a single packet. */
8698 remote_target::remote_write_bytes (CORE_ADDR memaddr, const gdb_byte *myaddr,
8699 ULONGEST len, int unit_size,
8700 ULONGEST *xfered_len)
8702 const char *packet_format = NULL;
8704 /* Check whether the target supports binary download. */
8705 check_binary_download (memaddr);
8707 switch (packet_support (PACKET_X))
8710 packet_format = "X";
8712 case PACKET_DISABLE:
8713 packet_format = "M";
8715 case PACKET_SUPPORT_UNKNOWN:
8716 internal_error (__FILE__, __LINE__,
8717 _("remote_write_bytes: bad internal state"));
8719 internal_error (__FILE__, __LINE__, _("bad switch"));
8722 return remote_write_bytes_aux (packet_format,
8723 memaddr, myaddr, len, unit_size, xfered_len,
8724 packet_format[0], 1);
8727 /* Read memory data directly from the remote machine.
8728 This does not use the data cache; the data cache uses this.
8729 MEMADDR is the address in the remote memory space.
8730 MYADDR is the address of the buffer in our space.
8731 LEN_UNITS is the number of addressable memory units to read..
8732 UNIT_SIZE is the length in bytes of an addressable unit.
8734 Return the transferred status, error or OK (an
8735 'enum target_xfer_status' value). Save the number of bytes
8736 transferred in *XFERED_LEN_UNITS.
8738 See the comment of remote_write_bytes_aux for an example of
8739 memory read/write exchange between gdb and the stub. */
8742 remote_target::remote_read_bytes_1 (CORE_ADDR memaddr, gdb_byte *myaddr,
8744 int unit_size, ULONGEST *xfered_len_units)
8746 struct remote_state *rs = get_remote_state ();
8747 int buf_size_bytes; /* Max size of packet output buffer. */
8752 buf_size_bytes = get_memory_read_packet_size ();
8753 /* The packet buffer will be large enough for the payload;
8754 get_memory_packet_size ensures this. */
8756 /* Number of units that will fit. */
8757 todo_units = std::min (len_units,
8758 (ULONGEST) (buf_size_bytes / unit_size) / 2);
8760 /* Construct "m"<memaddr>","<len>". */
8761 memaddr = remote_address_masked (memaddr);
8762 p = rs->buf.data ();
8764 p += hexnumstr (p, (ULONGEST) memaddr);
8766 p += hexnumstr (p, (ULONGEST) todo_units);
8769 getpkt (&rs->buf, 0);
8770 if (rs->buf[0] == 'E'
8771 && isxdigit (rs->buf[1]) && isxdigit (rs->buf[2])
8772 && rs->buf[3] == '\0')
8773 return TARGET_XFER_E_IO;
8774 /* Reply describes memory byte by byte, each byte encoded as two hex
8776 p = rs->buf.data ();
8777 decoded_bytes = hex2bin (p, myaddr, todo_units * unit_size);
8778 /* Return what we have. Let higher layers handle partial reads. */
8779 *xfered_len_units = (ULONGEST) (decoded_bytes / unit_size);
8780 return (*xfered_len_units != 0) ? TARGET_XFER_OK : TARGET_XFER_EOF;
8783 /* Using the set of read-only target sections of remote, read live
8786 For interface/parameters/return description see target.h,
8790 remote_target::remote_xfer_live_readonly_partial (gdb_byte *readbuf,
8794 ULONGEST *xfered_len)
8796 struct target_section *secp;
8797 struct target_section_table *table;
8799 secp = target_section_by_addr (this, memaddr);
8801 && (bfd_get_section_flags (secp->the_bfd_section->owner,
8802 secp->the_bfd_section)
8805 struct target_section *p;
8806 ULONGEST memend = memaddr + len;
8808 table = target_get_section_table (this);
8810 for (p = table->sections; p < table->sections_end; p++)
8812 if (memaddr >= p->addr)
8814 if (memend <= p->endaddr)
8816 /* Entire transfer is within this section. */
8817 return remote_read_bytes_1 (memaddr, readbuf, len, unit_size,
8820 else if (memaddr >= p->endaddr)
8822 /* This section ends before the transfer starts. */
8827 /* This section overlaps the transfer. Just do half. */
8828 len = p->endaddr - memaddr;
8829 return remote_read_bytes_1 (memaddr, readbuf, len, unit_size,
8836 return TARGET_XFER_EOF;
8839 /* Similar to remote_read_bytes_1, but it reads from the remote stub
8840 first if the requested memory is unavailable in traceframe.
8841 Otherwise, fall back to remote_read_bytes_1. */
8844 remote_target::remote_read_bytes (CORE_ADDR memaddr,
8845 gdb_byte *myaddr, ULONGEST len, int unit_size,
8846 ULONGEST *xfered_len)
8849 return TARGET_XFER_EOF;
8851 if (get_traceframe_number () != -1)
8853 std::vector<mem_range> available;
8855 /* If we fail to get the set of available memory, then the
8856 target does not support querying traceframe info, and so we
8857 attempt reading from the traceframe anyway (assuming the
8858 target implements the old QTro packet then). */
8859 if (traceframe_available_memory (&available, memaddr, len))
8861 if (available.empty () || available[0].start != memaddr)
8863 enum target_xfer_status res;
8865 /* Don't read into the traceframe's available
8867 if (!available.empty ())
8869 LONGEST oldlen = len;
8871 len = available[0].start - memaddr;
8872 gdb_assert (len <= oldlen);
8875 /* This goes through the topmost target again. */
8876 res = remote_xfer_live_readonly_partial (myaddr, memaddr,
8877 len, unit_size, xfered_len);
8878 if (res == TARGET_XFER_OK)
8879 return TARGET_XFER_OK;
8882 /* No use trying further, we know some memory starting
8883 at MEMADDR isn't available. */
8885 return (*xfered_len != 0) ?
8886 TARGET_XFER_UNAVAILABLE : TARGET_XFER_EOF;
8890 /* Don't try to read more than how much is available, in
8891 case the target implements the deprecated QTro packet to
8892 cater for older GDBs (the target's knowledge of read-only
8893 sections may be outdated by now). */
8894 len = available[0].length;
8898 return remote_read_bytes_1 (memaddr, myaddr, len, unit_size, xfered_len);
8903 /* Sends a packet with content determined by the printf format string
8904 FORMAT and the remaining arguments, then gets the reply. Returns
8905 whether the packet was a success, a failure, or unknown. */
8908 remote_target::remote_send_printf (const char *format, ...)
8910 struct remote_state *rs = get_remote_state ();
8911 int max_size = get_remote_packet_size ();
8914 va_start (ap, format);
8917 int size = vsnprintf (rs->buf.data (), max_size, format, ap);
8921 if (size >= max_size)
8922 internal_error (__FILE__, __LINE__, _("Too long remote packet."));
8924 if (putpkt (rs->buf) < 0)
8925 error (_("Communication problem with target."));
8928 getpkt (&rs->buf, 0);
8930 return packet_check_result (rs->buf);
8933 /* Flash writing can take quite some time. We'll set
8934 effectively infinite timeout for flash operations.
8935 In future, we'll need to decide on a better approach. */
8936 static const int remote_flash_timeout = 1000;
8939 remote_target::flash_erase (ULONGEST address, LONGEST length)
8941 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
8942 enum packet_result ret;
8943 scoped_restore restore_timeout
8944 = make_scoped_restore (&remote_timeout, remote_flash_timeout);
8946 ret = remote_send_printf ("vFlashErase:%s,%s",
8947 phex (address, addr_size),
8951 case PACKET_UNKNOWN:
8952 error (_("Remote target does not support flash erase"));
8954 error (_("Error erasing flash with vFlashErase packet"));
8961 remote_target::remote_flash_write (ULONGEST address,
8962 ULONGEST length, ULONGEST *xfered_len,
8963 const gdb_byte *data)
8965 scoped_restore restore_timeout
8966 = make_scoped_restore (&remote_timeout, remote_flash_timeout);
8967 return remote_write_bytes_aux ("vFlashWrite:", address, data, length, 1,
8972 remote_target::flash_done ()
8976 scoped_restore restore_timeout
8977 = make_scoped_restore (&remote_timeout, remote_flash_timeout);
8979 ret = remote_send_printf ("vFlashDone");
8983 case PACKET_UNKNOWN:
8984 error (_("Remote target does not support vFlashDone"));
8986 error (_("Error finishing flash operation"));
8993 remote_target::files_info ()
8995 puts_filtered ("Debugging a target over a serial line.\n");
8998 /* Stuff for dealing with the packets which are part of this protocol.
8999 See comment at top of file for details. */
9001 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
9002 error to higher layers. Called when a serial error is detected.
9003 The exception message is STRING, followed by a colon and a blank,
9004 the system error message for errno at function entry and final dot
9005 for output compatibility with throw_perror_with_name. */
9008 unpush_and_perror (const char *string)
9010 int saved_errno = errno;
9012 remote_unpush_target ();
9013 throw_error (TARGET_CLOSE_ERROR, "%s: %s.", string,
9014 safe_strerror (saved_errno));
9017 /* Read a single character from the remote end. The current quit
9018 handler is overridden to avoid quitting in the middle of packet
9019 sequence, as that would break communication with the remote server.
9020 See remote_serial_quit_handler for more detail. */
9023 remote_target::readchar (int timeout)
9026 struct remote_state *rs = get_remote_state ();
9029 scoped_restore restore_quit_target
9030 = make_scoped_restore (&curr_quit_handler_target, this);
9031 scoped_restore restore_quit
9032 = make_scoped_restore (&quit_handler, ::remote_serial_quit_handler);
9034 rs->got_ctrlc_during_io = 0;
9036 ch = serial_readchar (rs->remote_desc, timeout);
9038 if (rs->got_ctrlc_during_io)
9045 switch ((enum serial_rc) ch)
9048 remote_unpush_target ();
9049 throw_error (TARGET_CLOSE_ERROR, _("Remote connection closed"));
9052 unpush_and_perror (_("Remote communication error. "
9053 "Target disconnected."));
9055 case SERIAL_TIMEOUT:
9061 /* Wrapper for serial_write that closes the target and throws if
9062 writing fails. The current quit handler is overridden to avoid
9063 quitting in the middle of packet sequence, as that would break
9064 communication with the remote server. See
9065 remote_serial_quit_handler for more detail. */
9068 remote_target::remote_serial_write (const char *str, int len)
9070 struct remote_state *rs = get_remote_state ();
9072 scoped_restore restore_quit_target
9073 = make_scoped_restore (&curr_quit_handler_target, this);
9074 scoped_restore restore_quit
9075 = make_scoped_restore (&quit_handler, ::remote_serial_quit_handler);
9077 rs->got_ctrlc_during_io = 0;
9079 if (serial_write (rs->remote_desc, str, len))
9081 unpush_and_perror (_("Remote communication error. "
9082 "Target disconnected."));
9085 if (rs->got_ctrlc_during_io)
9089 /* Return a string representing an escaped version of BUF, of len N.
9090 E.g. \n is converted to \\n, \t to \\t, etc. */
9093 escape_buffer (const char *buf, int n)
9097 stb.putstrn (buf, n, '\\');
9098 return std::move (stb.string ());
9101 /* Display a null-terminated packet on stdout, for debugging, using C
9105 print_packet (const char *buf)
9107 puts_filtered ("\"");
9108 fputstr_filtered (buf, '"', gdb_stdout);
9109 puts_filtered ("\"");
9113 remote_target::putpkt (const char *buf)
9115 return putpkt_binary (buf, strlen (buf));
9118 /* Wrapper around remote_target::putpkt to avoid exporting
9122 putpkt (remote_target *remote, const char *buf)
9124 return remote->putpkt (buf);
9127 /* Send a packet to the remote machine, with error checking. The data
9128 of the packet is in BUF. The string in BUF can be at most
9129 get_remote_packet_size () - 5 to account for the $, # and checksum,
9130 and for a possible /0 if we are debugging (remote_debug) and want
9131 to print the sent packet as a string. */
9134 remote_target::putpkt_binary (const char *buf, int cnt)
9136 struct remote_state *rs = get_remote_state ();
9138 unsigned char csum = 0;
9139 gdb::def_vector<char> data (cnt + 6);
9140 char *buf2 = data.data ();
9146 /* Catch cases like trying to read memory or listing threads while
9147 we're waiting for a stop reply. The remote server wouldn't be
9148 ready to handle this request, so we'd hang and timeout. We don't
9149 have to worry about this in synchronous mode, because in that
9150 case it's not possible to issue a command while the target is
9151 running. This is not a problem in non-stop mode, because in that
9152 case, the stub is always ready to process serial input. */
9153 if (!target_is_non_stop_p ()
9154 && target_is_async_p ()
9155 && rs->waiting_for_stop_reply)
9157 error (_("Cannot execute this command while the target is running.\n"
9158 "Use the \"interrupt\" command to stop the target\n"
9159 "and then try again."));
9162 /* We're sending out a new packet. Make sure we don't look at a
9163 stale cached response. */
9164 rs->cached_wait_status = 0;
9166 /* Copy the packet into buffer BUF2, encapsulating it
9167 and giving it a checksum. */
9172 for (i = 0; i < cnt; i++)
9178 *p++ = tohex ((csum >> 4) & 0xf);
9179 *p++ = tohex (csum & 0xf);
9181 /* Send it over and over until we get a positive ack. */
9185 int started_error_output = 0;
9191 int len = (int) (p - buf2);
9194 = escape_buffer (buf2, std::min (len, REMOTE_DEBUG_MAX_CHAR));
9196 fprintf_unfiltered (gdb_stdlog, "Sending packet: %s", str.c_str ());
9198 if (len > REMOTE_DEBUG_MAX_CHAR)
9199 fprintf_unfiltered (gdb_stdlog, "[%d bytes omitted]",
9200 len - REMOTE_DEBUG_MAX_CHAR);
9202 fprintf_unfiltered (gdb_stdlog, "...");
9204 gdb_flush (gdb_stdlog);
9206 remote_serial_write (buf2, p - buf2);
9208 /* If this is a no acks version of the remote protocol, send the
9209 packet and move on. */
9213 /* Read until either a timeout occurs (-2) or '+' is read.
9214 Handle any notification that arrives in the mean time. */
9217 ch = readchar (remote_timeout);
9225 case SERIAL_TIMEOUT:
9228 if (started_error_output)
9230 putchar_unfiltered ('\n');
9231 started_error_output = 0;
9240 fprintf_unfiltered (gdb_stdlog, "Ack\n");
9244 fprintf_unfiltered (gdb_stdlog, "Nak\n");
9246 case SERIAL_TIMEOUT:
9250 break; /* Retransmit buffer. */
9254 fprintf_unfiltered (gdb_stdlog,
9255 "Packet instead of Ack, ignoring it\n");
9256 /* It's probably an old response sent because an ACK
9257 was lost. Gobble up the packet and ack it so it
9258 doesn't get retransmitted when we resend this
9261 remote_serial_write ("+", 1);
9262 continue; /* Now, go look for +. */
9269 /* If we got a notification, handle it, and go back to looking
9271 /* We've found the start of a notification. Now
9272 collect the data. */
9273 val = read_frame (&rs->buf);
9278 std::string str = escape_buffer (rs->buf.data (), val);
9280 fprintf_unfiltered (gdb_stdlog,
9281 " Notification received: %s\n",
9284 handle_notification (rs->notif_state, rs->buf.data ());
9285 /* We're in sync now, rewait for the ack. */
9292 if (!started_error_output)
9294 started_error_output = 1;
9295 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
9297 fputc_unfiltered (ch & 0177, gdb_stdlog);
9298 fprintf_unfiltered (gdb_stdlog, "%s", rs->buf.data ());
9307 if (!started_error_output)
9309 started_error_output = 1;
9310 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
9312 fputc_unfiltered (ch & 0177, gdb_stdlog);
9316 break; /* Here to retransmit. */
9320 /* This is wrong. If doing a long backtrace, the user should be
9321 able to get out next time we call QUIT, without anything as
9322 violent as interrupt_query. If we want to provide a way out of
9323 here without getting to the next QUIT, it should be based on
9324 hitting ^C twice as in remote_wait. */
9336 /* Come here after finding the start of a frame when we expected an
9337 ack. Do our best to discard the rest of this packet. */
9340 remote_target::skip_frame ()
9346 c = readchar (remote_timeout);
9349 case SERIAL_TIMEOUT:
9350 /* Nothing we can do. */
9353 /* Discard the two bytes of checksum and stop. */
9354 c = readchar (remote_timeout);
9356 c = readchar (remote_timeout);
9359 case '*': /* Run length encoding. */
9360 /* Discard the repeat count. */
9361 c = readchar (remote_timeout);
9366 /* A regular character. */
9372 /* Come here after finding the start of the frame. Collect the rest
9373 into *BUF, verifying the checksum, length, and handling run-length
9374 compression. NUL terminate the buffer. If there is not enough room,
9377 Returns -1 on error, number of characters in buffer (ignoring the
9378 trailing NULL) on success. (could be extended to return one of the
9379 SERIAL status indications). */
9382 remote_target::read_frame (gdb::char_vector *buf_p)
9387 char *buf = buf_p->data ();
9388 struct remote_state *rs = get_remote_state ();
9395 c = readchar (remote_timeout);
9398 case SERIAL_TIMEOUT:
9400 fputs_filtered ("Timeout in mid-packet, retrying\n", gdb_stdlog);
9404 fputs_filtered ("Saw new packet start in middle of old one\n",
9406 return -1; /* Start a new packet, count retries. */
9409 unsigned char pktcsum;
9415 check_0 = readchar (remote_timeout);
9417 check_1 = readchar (remote_timeout);
9419 if (check_0 == SERIAL_TIMEOUT || check_1 == SERIAL_TIMEOUT)
9422 fputs_filtered ("Timeout in checksum, retrying\n",
9426 else if (check_0 < 0 || check_1 < 0)
9429 fputs_filtered ("Communication error in checksum\n",
9434 /* Don't recompute the checksum; with no ack packets we
9435 don't have any way to indicate a packet retransmission
9440 pktcsum = (fromhex (check_0) << 4) | fromhex (check_1);
9441 if (csum == pktcsum)
9446 std::string str = escape_buffer (buf, bc);
9448 fprintf_unfiltered (gdb_stdlog,
9449 "Bad checksum, sentsum=0x%x, "
9450 "csum=0x%x, buf=%s\n",
9451 pktcsum, csum, str.c_str ());
9453 /* Number of characters in buffer ignoring trailing
9457 case '*': /* Run length encoding. */
9462 c = readchar (remote_timeout);
9464 repeat = c - ' ' + 3; /* Compute repeat count. */
9466 /* The character before ``*'' is repeated. */
9468 if (repeat > 0 && repeat <= 255 && bc > 0)
9470 if (bc + repeat - 1 >= buf_p->size () - 1)
9472 /* Make some more room in the buffer. */
9473 buf_p->resize (buf_p->size () + repeat);
9474 buf = buf_p->data ();
9477 memset (&buf[bc], buf[bc - 1], repeat);
9483 printf_filtered (_("Invalid run length encoding: %s\n"), buf);
9487 if (bc >= buf_p->size () - 1)
9489 /* Make some more room in the buffer. */
9490 buf_p->resize (buf_p->size () * 2);
9491 buf = buf_p->data ();
9501 /* Read a packet from the remote machine, with error checking, and
9502 store it in *BUF. Resize *BUF if necessary to hold the result. If
9503 FOREVER, wait forever rather than timing out; this is used (in
9504 synchronous mode) to wait for a target that is is executing user
9506 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
9507 don't have to change all the calls to getpkt to deal with the
9508 return value, because at the moment I don't know what the right
9509 thing to do it for those. */
9512 remote_target::getpkt (gdb::char_vector *buf, int forever)
9514 getpkt_sane (buf, forever);
9518 /* Read a packet from the remote machine, with error checking, and
9519 store it in *BUF. Resize *BUF if necessary to hold the result. If
9520 FOREVER, wait forever rather than timing out; this is used (in
9521 synchronous mode) to wait for a target that is is executing user
9522 code to stop. If FOREVER == 0, this function is allowed to time
9523 out gracefully and return an indication of this to the caller.
9524 Otherwise return the number of bytes read. If EXPECTING_NOTIF,
9525 consider receiving a notification enough reason to return to the
9526 caller. *IS_NOTIF is an output boolean that indicates whether *BUF
9527 holds a notification or not (a regular packet). */
9530 remote_target::getpkt_or_notif_sane_1 (gdb::char_vector *buf,
9531 int forever, int expecting_notif,
9534 struct remote_state *rs = get_remote_state ();
9540 /* We're reading a new response. Make sure we don't look at a
9541 previously cached response. */
9542 rs->cached_wait_status = 0;
9544 strcpy (buf->data (), "timeout");
9547 timeout = watchdog > 0 ? watchdog : -1;
9548 else if (expecting_notif)
9549 timeout = 0; /* There should already be a char in the buffer. If
9552 timeout = remote_timeout;
9556 /* Process any number of notifications, and then return when
9560 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
9562 for (tries = 1; tries <= MAX_TRIES; tries++)
9564 /* This can loop forever if the remote side sends us
9565 characters continuously, but if it pauses, we'll get
9566 SERIAL_TIMEOUT from readchar because of timeout. Then
9567 we'll count that as a retry.
9569 Note that even when forever is set, we will only wait
9570 forever prior to the start of a packet. After that, we
9571 expect characters to arrive at a brisk pace. They should
9572 show up within remote_timeout intervals. */
9574 c = readchar (timeout);
9575 while (c != SERIAL_TIMEOUT && c != '$' && c != '%');
9577 if (c == SERIAL_TIMEOUT)
9579 if (expecting_notif)
9580 return -1; /* Don't complain, it's normal to not get
9581 anything in this case. */
9583 if (forever) /* Watchdog went off? Kill the target. */
9585 remote_unpush_target ();
9586 throw_error (TARGET_CLOSE_ERROR,
9587 _("Watchdog timeout has expired. "
9588 "Target detached."));
9591 fputs_filtered ("Timed out.\n", gdb_stdlog);
9595 /* We've found the start of a packet or notification.
9596 Now collect the data. */
9597 val = read_frame (buf);
9602 remote_serial_write ("-", 1);
9605 if (tries > MAX_TRIES)
9607 /* We have tried hard enough, and just can't receive the
9608 packet/notification. Give up. */
9609 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
9611 /* Skip the ack char if we're in no-ack mode. */
9612 if (!rs->noack_mode)
9613 remote_serial_write ("+", 1);
9617 /* If we got an ordinary packet, return that to our caller. */
9623 = escape_buffer (buf->data (),
9624 std::min (val, REMOTE_DEBUG_MAX_CHAR));
9626 fprintf_unfiltered (gdb_stdlog, "Packet received: %s",
9629 if (val > REMOTE_DEBUG_MAX_CHAR)
9630 fprintf_unfiltered (gdb_stdlog, "[%d bytes omitted]",
9631 val - REMOTE_DEBUG_MAX_CHAR);
9633 fprintf_unfiltered (gdb_stdlog, "\n");
9636 /* Skip the ack char if we're in no-ack mode. */
9637 if (!rs->noack_mode)
9638 remote_serial_write ("+", 1);
9639 if (is_notif != NULL)
9644 /* If we got a notification, handle it, and go back to looking
9648 gdb_assert (c == '%');
9652 std::string str = escape_buffer (buf->data (), val);
9654 fprintf_unfiltered (gdb_stdlog,
9655 " Notification received: %s\n",
9658 if (is_notif != NULL)
9661 handle_notification (rs->notif_state, buf->data ());
9663 /* Notifications require no acknowledgement. */
9665 if (expecting_notif)
9672 remote_target::getpkt_sane (gdb::char_vector *buf, int forever)
9674 return getpkt_or_notif_sane_1 (buf, forever, 0, NULL);
9678 remote_target::getpkt_or_notif_sane (gdb::char_vector *buf, int forever,
9681 return getpkt_or_notif_sane_1 (buf, forever, 1, is_notif);
9684 /* Kill any new fork children of process PID that haven't been
9685 processed by follow_fork. */
9688 remote_target::kill_new_fork_children (int pid)
9690 remote_state *rs = get_remote_state ();
9691 struct notif_client *notif = ¬if_client_stop;
9693 /* Kill the fork child threads of any threads in process PID
9694 that are stopped at a fork event. */
9695 for (thread_info *thread : all_non_exited_threads ())
9697 struct target_waitstatus *ws = &thread->pending_follow;
9699 if (is_pending_fork_parent (ws, pid, thread->ptid))
9701 int child_pid = ws->value.related_pid.pid ();
9704 res = remote_vkill (child_pid);
9706 error (_("Can't kill fork child process %d"), child_pid);
9710 /* Check for any pending fork events (not reported or processed yet)
9711 in process PID and kill those fork child threads as well. */
9712 remote_notif_get_pending_events (notif);
9713 for (auto &event : rs->stop_reply_queue)
9714 if (is_pending_fork_parent (&event->ws, pid, event->ptid))
9716 int child_pid = event->ws.value.related_pid.pid ();
9719 res = remote_vkill (child_pid);
9721 error (_("Can't kill fork child process %d"), child_pid);
9726 /* Target hook to kill the current inferior. */
9729 remote_target::kill ()
9732 int pid = inferior_ptid.pid ();
9733 struct remote_state *rs = get_remote_state ();
9735 if (packet_support (PACKET_vKill) != PACKET_DISABLE)
9737 /* If we're stopped while forking and we haven't followed yet,
9738 kill the child task. We need to do this before killing the
9739 parent task because if this is a vfork then the parent will
9741 kill_new_fork_children (pid);
9743 res = remote_vkill (pid);
9746 target_mourn_inferior (inferior_ptid);
9751 /* If we are in 'target remote' mode and we are killing the only
9752 inferior, then we will tell gdbserver to exit and unpush the
9754 if (res == -1 && !remote_multi_process_p (rs)
9755 && number_of_live_inferiors () == 1)
9759 /* We've killed the remote end, we get to mourn it. If we are
9760 not in extended mode, mourning the inferior also unpushes
9761 remote_ops from the target stack, which closes the remote
9763 target_mourn_inferior (inferior_ptid);
9768 error (_("Can't kill process"));
9771 /* Send a kill request to the target using the 'vKill' packet. */
9774 remote_target::remote_vkill (int pid)
9776 if (packet_support (PACKET_vKill) == PACKET_DISABLE)
9779 remote_state *rs = get_remote_state ();
9781 /* Tell the remote target to detach. */
9782 xsnprintf (rs->buf.data (), get_remote_packet_size (), "vKill;%x", pid);
9784 getpkt (&rs->buf, 0);
9786 switch (packet_ok (rs->buf,
9787 &remote_protocol_packets[PACKET_vKill]))
9793 case PACKET_UNKNOWN:
9796 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
9800 /* Send a kill request to the target using the 'k' packet. */
9803 remote_target::remote_kill_k ()
9805 /* Catch errors so the user can quit from gdb even when we
9806 aren't on speaking terms with the remote system. */
9811 CATCH (ex, RETURN_MASK_ERROR)
9813 if (ex.error == TARGET_CLOSE_ERROR)
9815 /* If we got an (EOF) error that caused the target
9816 to go away, then we're done, that's what we wanted.
9817 "k" is susceptible to cause a premature EOF, given
9818 that the remote server isn't actually required to
9819 reply to "k", and it can happen that it doesn't
9820 even get to reply ACK to the "k". */
9824 /* Otherwise, something went wrong. We didn't actually kill
9825 the target. Just propagate the exception, and let the
9826 user or higher layers decide what to do. */
9827 throw_exception (ex);
9833 remote_target::mourn_inferior ()
9835 struct remote_state *rs = get_remote_state ();
9837 /* We're no longer interested in notification events of an inferior
9838 that exited or was killed/detached. */
9839 discard_pending_stop_replies (current_inferior ());
9841 /* In 'target remote' mode with one inferior, we close the connection. */
9842 if (!rs->extended && number_of_live_inferiors () <= 1)
9844 unpush_target (this);
9846 /* remote_close takes care of doing most of the clean up. */
9847 generic_mourn_inferior ();
9851 /* In case we got here due to an error, but we're going to stay
9853 rs->waiting_for_stop_reply = 0;
9855 /* If the current general thread belonged to the process we just
9856 detached from or has exited, the remote side current general
9857 thread becomes undefined. Considering a case like this:
9859 - We just got here due to a detach.
9860 - The process that we're detaching from happens to immediately
9861 report a global breakpoint being hit in non-stop mode, in the
9862 same thread we had selected before.
9863 - GDB attaches to this process again.
9864 - This event happens to be the next event we handle.
9866 GDB would consider that the current general thread didn't need to
9867 be set on the stub side (with Hg), since for all it knew,
9868 GENERAL_THREAD hadn't changed.
9870 Notice that although in all-stop mode, the remote server always
9871 sets the current thread to the thread reporting the stop event,
9872 that doesn't happen in non-stop mode; in non-stop, the stub *must
9873 not* change the current thread when reporting a breakpoint hit,
9874 due to the decoupling of event reporting and event handling.
9876 To keep things simple, we always invalidate our notion of the
9878 record_currthread (rs, minus_one_ptid);
9880 /* Call common code to mark the inferior as not running. */
9881 generic_mourn_inferior ();
9883 if (!have_inferiors ())
9885 if (!remote_multi_process_p (rs))
9887 /* Check whether the target is running now - some remote stubs
9888 automatically restart after kill. */
9890 getpkt (&rs->buf, 0);
9892 if (rs->buf[0] == 'S' || rs->buf[0] == 'T')
9894 /* Assume that the target has been restarted. Set
9895 inferior_ptid so that bits of core GDB realizes
9896 there's something here, e.g., so that the user can
9897 say "kill" again. */
9898 inferior_ptid = magic_null_ptid;
9905 extended_remote_target::supports_disable_randomization ()
9907 return packet_support (PACKET_QDisableRandomization) == PACKET_ENABLE;
9911 remote_target::extended_remote_disable_randomization (int val)
9913 struct remote_state *rs = get_remote_state ();
9916 xsnprintf (rs->buf.data (), get_remote_packet_size (),
9917 "QDisableRandomization:%x", val);
9919 reply = remote_get_noisy_reply ();
9921 error (_("Target does not support QDisableRandomization."));
9922 if (strcmp (reply, "OK") != 0)
9923 error (_("Bogus QDisableRandomization reply from target: %s"), reply);
9927 remote_target::extended_remote_run (const std::string &args)
9929 struct remote_state *rs = get_remote_state ();
9931 const char *remote_exec_file = get_remote_exec_file ();
9933 /* If the user has disabled vRun support, or we have detected that
9934 support is not available, do not try it. */
9935 if (packet_support (PACKET_vRun) == PACKET_DISABLE)
9938 strcpy (rs->buf.data (), "vRun;");
9939 len = strlen (rs->buf.data ());
9941 if (strlen (remote_exec_file) * 2 + len >= get_remote_packet_size ())
9942 error (_("Remote file name too long for run packet"));
9943 len += 2 * bin2hex ((gdb_byte *) remote_exec_file, rs->buf.data () + len,
9944 strlen (remote_exec_file));
9950 gdb_argv argv (args.c_str ());
9951 for (i = 0; argv[i] != NULL; i++)
9953 if (strlen (argv[i]) * 2 + 1 + len >= get_remote_packet_size ())
9954 error (_("Argument list too long for run packet"));
9955 rs->buf[len++] = ';';
9956 len += 2 * bin2hex ((gdb_byte *) argv[i], rs->buf.data () + len,
9961 rs->buf[len++] = '\0';
9964 getpkt (&rs->buf, 0);
9966 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_vRun]))
9969 /* We have a wait response. All is well. */
9971 case PACKET_UNKNOWN:
9974 if (remote_exec_file[0] == '\0')
9975 error (_("Running the default executable on the remote target failed; "
9976 "try \"set remote exec-file\"?"));
9978 error (_("Running \"%s\" on the remote target failed"),
9981 gdb_assert_not_reached (_("bad switch"));
9985 /* Helper function to send set/unset environment packets. ACTION is
9986 either "set" or "unset". PACKET is either "QEnvironmentHexEncoded"
9987 or "QEnvironmentUnsetVariable". VALUE is the variable to be
9991 remote_target::send_environment_packet (const char *action,
9995 remote_state *rs = get_remote_state ();
9997 /* Convert the environment variable to an hex string, which
9998 is the best format to be transmitted over the wire. */
9999 std::string encoded_value = bin2hex ((const gdb_byte *) value,
10002 xsnprintf (rs->buf.data (), get_remote_packet_size (),
10003 "%s:%s", packet, encoded_value.c_str ());
10006 getpkt (&rs->buf, 0);
10007 if (strcmp (rs->buf.data (), "OK") != 0)
10008 warning (_("Unable to %s environment variable '%s' on remote."),
10012 /* Helper function to handle the QEnvironment* packets. */
10015 remote_target::extended_remote_environment_support ()
10017 remote_state *rs = get_remote_state ();
10019 if (packet_support (PACKET_QEnvironmentReset) != PACKET_DISABLE)
10021 putpkt ("QEnvironmentReset");
10022 getpkt (&rs->buf, 0);
10023 if (strcmp (rs->buf.data (), "OK") != 0)
10024 warning (_("Unable to reset environment on remote."));
10027 gdb_environ *e = ¤t_inferior ()->environment;
10029 if (packet_support (PACKET_QEnvironmentHexEncoded) != PACKET_DISABLE)
10030 for (const std::string &el : e->user_set_env ())
10031 send_environment_packet ("set", "QEnvironmentHexEncoded",
10034 if (packet_support (PACKET_QEnvironmentUnset) != PACKET_DISABLE)
10035 for (const std::string &el : e->user_unset_env ())
10036 send_environment_packet ("unset", "QEnvironmentUnset", el.c_str ());
10039 /* Helper function to set the current working directory for the
10040 inferior in the remote target. */
10043 remote_target::extended_remote_set_inferior_cwd ()
10045 if (packet_support (PACKET_QSetWorkingDir) != PACKET_DISABLE)
10047 const char *inferior_cwd = get_inferior_cwd ();
10048 remote_state *rs = get_remote_state ();
10050 if (inferior_cwd != NULL)
10052 std::string hexpath = bin2hex ((const gdb_byte *) inferior_cwd,
10053 strlen (inferior_cwd));
10055 xsnprintf (rs->buf.data (), get_remote_packet_size (),
10056 "QSetWorkingDir:%s", hexpath.c_str ());
10060 /* An empty inferior_cwd means that the user wants us to
10061 reset the remote server's inferior's cwd. */
10062 xsnprintf (rs->buf.data (), get_remote_packet_size (),
10063 "QSetWorkingDir:");
10067 getpkt (&rs->buf, 0);
10068 if (packet_ok (rs->buf,
10069 &remote_protocol_packets[PACKET_QSetWorkingDir])
10072 Remote replied unexpectedly while setting the inferior's working\n\
10079 /* In the extended protocol we want to be able to do things like
10080 "run" and have them basically work as expected. So we need
10081 a special create_inferior function. We support changing the
10082 executable file and the command line arguments, but not the
10086 extended_remote_target::create_inferior (const char *exec_file,
10087 const std::string &args,
10088 char **env, int from_tty)
10092 struct remote_state *rs = get_remote_state ();
10093 const char *remote_exec_file = get_remote_exec_file ();
10095 /* If running asynchronously, register the target file descriptor
10096 with the event loop. */
10097 if (target_can_async_p ())
10100 /* Disable address space randomization if requested (and supported). */
10101 if (supports_disable_randomization ())
10102 extended_remote_disable_randomization (disable_randomization);
10104 /* If startup-with-shell is on, we inform gdbserver to start the
10105 remote inferior using a shell. */
10106 if (packet_support (PACKET_QStartupWithShell) != PACKET_DISABLE)
10108 xsnprintf (rs->buf.data (), get_remote_packet_size (),
10109 "QStartupWithShell:%d", startup_with_shell ? 1 : 0);
10111 getpkt (&rs->buf, 0);
10112 if (strcmp (rs->buf.data (), "OK") != 0)
10114 Remote replied unexpectedly while setting startup-with-shell: %s"),
10118 extended_remote_environment_support ();
10120 extended_remote_set_inferior_cwd ();
10122 /* Now restart the remote server. */
10123 run_worked = extended_remote_run (args) != -1;
10126 /* vRun was not supported. Fail if we need it to do what the
10128 if (remote_exec_file[0])
10129 error (_("Remote target does not support \"set remote exec-file\""));
10130 if (!args.empty ())
10131 error (_("Remote target does not support \"set args\" or run ARGS"));
10133 /* Fall back to "R". */
10134 extended_remote_restart ();
10137 /* vRun's success return is a stop reply. */
10138 stop_reply = run_worked ? rs->buf.data () : NULL;
10139 add_current_inferior_and_thread (stop_reply);
10141 /* Get updated offsets, if the stub uses qOffsets. */
10146 /* Given a location's target info BP_TGT and the packet buffer BUF, output
10147 the list of conditions (in agent expression bytecode format), if any, the
10148 target needs to evaluate. The output is placed into the packet buffer
10149 started from BUF and ended at BUF_END. */
10152 remote_add_target_side_condition (struct gdbarch *gdbarch,
10153 struct bp_target_info *bp_tgt, char *buf,
10156 if (bp_tgt->conditions.empty ())
10159 buf += strlen (buf);
10160 xsnprintf (buf, buf_end - buf, "%s", ";");
10163 /* Send conditions to the target. */
10164 for (agent_expr *aexpr : bp_tgt->conditions)
10166 xsnprintf (buf, buf_end - buf, "X%x,", aexpr->len);
10167 buf += strlen (buf);
10168 for (int i = 0; i < aexpr->len; ++i)
10169 buf = pack_hex_byte (buf, aexpr->buf[i]);
10176 remote_add_target_side_commands (struct gdbarch *gdbarch,
10177 struct bp_target_info *bp_tgt, char *buf)
10179 if (bp_tgt->tcommands.empty ())
10182 buf += strlen (buf);
10184 sprintf (buf, ";cmds:%x,", bp_tgt->persist);
10185 buf += strlen (buf);
10187 /* Concatenate all the agent expressions that are commands into the
10189 for (agent_expr *aexpr : bp_tgt->tcommands)
10191 sprintf (buf, "X%x,", aexpr->len);
10192 buf += strlen (buf);
10193 for (int i = 0; i < aexpr->len; ++i)
10194 buf = pack_hex_byte (buf, aexpr->buf[i]);
10199 /* Insert a breakpoint. On targets that have software breakpoint
10200 support, we ask the remote target to do the work; on targets
10201 which don't, we insert a traditional memory breakpoint. */
10204 remote_target::insert_breakpoint (struct gdbarch *gdbarch,
10205 struct bp_target_info *bp_tgt)
10207 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
10208 If it succeeds, then set the support to PACKET_ENABLE. If it
10209 fails, and the user has explicitly requested the Z support then
10210 report an error, otherwise, mark it disabled and go on. */
10212 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
10214 CORE_ADDR addr = bp_tgt->reqstd_address;
10215 struct remote_state *rs;
10218 /* Make sure the remote is pointing at the right process, if
10220 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10221 set_general_process ();
10223 rs = get_remote_state ();
10224 p = rs->buf.data ();
10225 endbuf = p + get_remote_packet_size ();
10230 addr = (ULONGEST) remote_address_masked (addr);
10231 p += hexnumstr (p, addr);
10232 xsnprintf (p, endbuf - p, ",%d", bp_tgt->kind);
10234 if (supports_evaluation_of_breakpoint_conditions ())
10235 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
10237 if (can_run_breakpoint_commands ())
10238 remote_add_target_side_commands (gdbarch, bp_tgt, p);
10241 getpkt (&rs->buf, 0);
10243 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0]))
10249 case PACKET_UNKNOWN:
10254 /* If this breakpoint has target-side commands but this stub doesn't
10255 support Z0 packets, throw error. */
10256 if (!bp_tgt->tcommands.empty ())
10257 throw_error (NOT_SUPPORTED_ERROR, _("\
10258 Target doesn't support breakpoints that have target side commands."));
10260 return memory_insert_breakpoint (this, gdbarch, bp_tgt);
10264 remote_target::remove_breakpoint (struct gdbarch *gdbarch,
10265 struct bp_target_info *bp_tgt,
10266 enum remove_bp_reason reason)
10268 CORE_ADDR addr = bp_tgt->placed_address;
10269 struct remote_state *rs = get_remote_state ();
10271 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
10273 char *p = rs->buf.data ();
10274 char *endbuf = p + get_remote_packet_size ();
10276 /* Make sure the remote is pointing at the right process, if
10278 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10279 set_general_process ();
10285 addr = (ULONGEST) remote_address_masked (bp_tgt->placed_address);
10286 p += hexnumstr (p, addr);
10287 xsnprintf (p, endbuf - p, ",%d", bp_tgt->kind);
10290 getpkt (&rs->buf, 0);
10292 return (rs->buf[0] == 'E');
10295 return memory_remove_breakpoint (this, gdbarch, bp_tgt, reason);
10298 static enum Z_packet_type
10299 watchpoint_to_Z_packet (int type)
10304 return Z_PACKET_WRITE_WP;
10307 return Z_PACKET_READ_WP;
10310 return Z_PACKET_ACCESS_WP;
10313 internal_error (__FILE__, __LINE__,
10314 _("hw_bp_to_z: bad watchpoint type %d"), type);
10319 remote_target::insert_watchpoint (CORE_ADDR addr, int len,
10320 enum target_hw_bp_type type, struct expression *cond)
10322 struct remote_state *rs = get_remote_state ();
10323 char *endbuf = rs->buf.data () + get_remote_packet_size ();
10325 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
10327 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
10330 /* Make sure the remote is pointing at the right process, if
10332 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10333 set_general_process ();
10335 xsnprintf (rs->buf.data (), endbuf - rs->buf.data (), "Z%x,", packet);
10336 p = strchr (rs->buf.data (), '\0');
10337 addr = remote_address_masked (addr);
10338 p += hexnumstr (p, (ULONGEST) addr);
10339 xsnprintf (p, endbuf - p, ",%x", len);
10342 getpkt (&rs->buf, 0);
10344 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
10348 case PACKET_UNKNOWN:
10353 internal_error (__FILE__, __LINE__,
10354 _("remote_insert_watchpoint: reached end of function"));
10358 remote_target::watchpoint_addr_within_range (CORE_ADDR addr,
10359 CORE_ADDR start, int length)
10361 CORE_ADDR diff = remote_address_masked (addr - start);
10363 return diff < length;
10368 remote_target::remove_watchpoint (CORE_ADDR addr, int len,
10369 enum target_hw_bp_type type, struct expression *cond)
10371 struct remote_state *rs = get_remote_state ();
10372 char *endbuf = rs->buf.data () + get_remote_packet_size ();
10374 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
10376 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
10379 /* Make sure the remote is pointing at the right process, if
10381 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10382 set_general_process ();
10384 xsnprintf (rs->buf.data (), endbuf - rs->buf.data (), "z%x,", packet);
10385 p = strchr (rs->buf.data (), '\0');
10386 addr = remote_address_masked (addr);
10387 p += hexnumstr (p, (ULONGEST) addr);
10388 xsnprintf (p, endbuf - p, ",%x", len);
10390 getpkt (&rs->buf, 0);
10392 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
10395 case PACKET_UNKNOWN:
10400 internal_error (__FILE__, __LINE__,
10401 _("remote_remove_watchpoint: reached end of function"));
10405 int remote_hw_watchpoint_limit = -1;
10406 int remote_hw_watchpoint_length_limit = -1;
10407 int remote_hw_breakpoint_limit = -1;
10410 remote_target::region_ok_for_hw_watchpoint (CORE_ADDR addr, int len)
10412 if (remote_hw_watchpoint_length_limit == 0)
10414 else if (remote_hw_watchpoint_length_limit < 0)
10416 else if (len <= remote_hw_watchpoint_length_limit)
10423 remote_target::can_use_hw_breakpoint (enum bptype type, int cnt, int ot)
10425 if (type == bp_hardware_breakpoint)
10427 if (remote_hw_breakpoint_limit == 0)
10429 else if (remote_hw_breakpoint_limit < 0)
10431 else if (cnt <= remote_hw_breakpoint_limit)
10436 if (remote_hw_watchpoint_limit == 0)
10438 else if (remote_hw_watchpoint_limit < 0)
10442 else if (cnt <= remote_hw_watchpoint_limit)
10448 /* The to_stopped_by_sw_breakpoint method of target remote. */
10451 remote_target::stopped_by_sw_breakpoint ()
10453 struct thread_info *thread = inferior_thread ();
10455 return (thread->priv != NULL
10456 && (get_remote_thread_info (thread)->stop_reason
10457 == TARGET_STOPPED_BY_SW_BREAKPOINT));
10460 /* The to_supports_stopped_by_sw_breakpoint method of target
10464 remote_target::supports_stopped_by_sw_breakpoint ()
10466 return (packet_support (PACKET_swbreak_feature) == PACKET_ENABLE);
10469 /* The to_stopped_by_hw_breakpoint method of target remote. */
10472 remote_target::stopped_by_hw_breakpoint ()
10474 struct thread_info *thread = inferior_thread ();
10476 return (thread->priv != NULL
10477 && (get_remote_thread_info (thread)->stop_reason
10478 == TARGET_STOPPED_BY_HW_BREAKPOINT));
10481 /* The to_supports_stopped_by_hw_breakpoint method of target
10485 remote_target::supports_stopped_by_hw_breakpoint ()
10487 return (packet_support (PACKET_hwbreak_feature) == PACKET_ENABLE);
10491 remote_target::stopped_by_watchpoint ()
10493 struct thread_info *thread = inferior_thread ();
10495 return (thread->priv != NULL
10496 && (get_remote_thread_info (thread)->stop_reason
10497 == TARGET_STOPPED_BY_WATCHPOINT));
10501 remote_target::stopped_data_address (CORE_ADDR *addr_p)
10503 struct thread_info *thread = inferior_thread ();
10505 if (thread->priv != NULL
10506 && (get_remote_thread_info (thread)->stop_reason
10507 == TARGET_STOPPED_BY_WATCHPOINT))
10509 *addr_p = get_remote_thread_info (thread)->watch_data_address;
10518 remote_target::insert_hw_breakpoint (struct gdbarch *gdbarch,
10519 struct bp_target_info *bp_tgt)
10521 CORE_ADDR addr = bp_tgt->reqstd_address;
10522 struct remote_state *rs;
10526 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
10529 /* Make sure the remote is pointing at the right process, if
10531 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10532 set_general_process ();
10534 rs = get_remote_state ();
10535 p = rs->buf.data ();
10536 endbuf = p + get_remote_packet_size ();
10542 addr = remote_address_masked (addr);
10543 p += hexnumstr (p, (ULONGEST) addr);
10544 xsnprintf (p, endbuf - p, ",%x", bp_tgt->kind);
10546 if (supports_evaluation_of_breakpoint_conditions ())
10547 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
10549 if (can_run_breakpoint_commands ())
10550 remote_add_target_side_commands (gdbarch, bp_tgt, p);
10553 getpkt (&rs->buf, 0);
10555 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
10558 if (rs->buf[1] == '.')
10560 message = strchr (&rs->buf[2], '.');
10562 error (_("Remote failure reply: %s"), message + 1);
10565 case PACKET_UNKNOWN:
10570 internal_error (__FILE__, __LINE__,
10571 _("remote_insert_hw_breakpoint: reached end of function"));
10576 remote_target::remove_hw_breakpoint (struct gdbarch *gdbarch,
10577 struct bp_target_info *bp_tgt)
10580 struct remote_state *rs = get_remote_state ();
10581 char *p = rs->buf.data ();
10582 char *endbuf = p + get_remote_packet_size ();
10584 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
10587 /* Make sure the remote is pointing at the right process, if
10589 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10590 set_general_process ();
10596 addr = remote_address_masked (bp_tgt->placed_address);
10597 p += hexnumstr (p, (ULONGEST) addr);
10598 xsnprintf (p, endbuf - p, ",%x", bp_tgt->kind);
10601 getpkt (&rs->buf, 0);
10603 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
10606 case PACKET_UNKNOWN:
10611 internal_error (__FILE__, __LINE__,
10612 _("remote_remove_hw_breakpoint: reached end of function"));
10615 /* Verify memory using the "qCRC:" request. */
10618 remote_target::verify_memory (const gdb_byte *data, CORE_ADDR lma, ULONGEST size)
10620 struct remote_state *rs = get_remote_state ();
10621 unsigned long host_crc, target_crc;
10624 /* It doesn't make sense to use qCRC if the remote target is
10625 connected but not running. */
10626 if (target_has_execution && packet_support (PACKET_qCRC) != PACKET_DISABLE)
10628 enum packet_result result;
10630 /* Make sure the remote is pointing at the right process. */
10631 set_general_process ();
10633 /* FIXME: assumes lma can fit into long. */
10634 xsnprintf (rs->buf.data (), get_remote_packet_size (), "qCRC:%lx,%lx",
10635 (long) lma, (long) size);
10638 /* Be clever; compute the host_crc before waiting for target
10640 host_crc = xcrc32 (data, size, 0xffffffff);
10642 getpkt (&rs->buf, 0);
10644 result = packet_ok (rs->buf,
10645 &remote_protocol_packets[PACKET_qCRC]);
10646 if (result == PACKET_ERROR)
10648 else if (result == PACKET_OK)
10650 for (target_crc = 0, tmp = &rs->buf[1]; *tmp; tmp++)
10651 target_crc = target_crc * 16 + fromhex (*tmp);
10653 return (host_crc == target_crc);
10657 return simple_verify_memory (this, data, lma, size);
10660 /* compare-sections command
10662 With no arguments, compares each loadable section in the exec bfd
10663 with the same memory range on the target, and reports mismatches.
10664 Useful for verifying the image on the target against the exec file. */
10667 compare_sections_command (const char *args, int from_tty)
10670 const char *sectname;
10671 bfd_size_type size;
10674 int mismatched = 0;
10679 error (_("command cannot be used without an exec file"));
10681 if (args != NULL && strcmp (args, "-r") == 0)
10687 for (s = exec_bfd->sections; s; s = s->next)
10689 if (!(s->flags & SEC_LOAD))
10690 continue; /* Skip non-loadable section. */
10692 if (read_only && (s->flags & SEC_READONLY) == 0)
10693 continue; /* Skip writeable sections */
10695 size = bfd_get_section_size (s);
10697 continue; /* Skip zero-length section. */
10699 sectname = bfd_get_section_name (exec_bfd, s);
10700 if (args && strcmp (args, sectname) != 0)
10701 continue; /* Not the section selected by user. */
10703 matched = 1; /* Do this section. */
10706 gdb::byte_vector sectdata (size);
10707 bfd_get_section_contents (exec_bfd, s, sectdata.data (), 0, size);
10709 res = target_verify_memory (sectdata.data (), lma, size);
10712 error (_("target memory fault, section %s, range %s -- %s"), sectname,
10713 paddress (target_gdbarch (), lma),
10714 paddress (target_gdbarch (), lma + size));
10716 printf_filtered ("Section %s, range %s -- %s: ", sectname,
10717 paddress (target_gdbarch (), lma),
10718 paddress (target_gdbarch (), lma + size));
10720 printf_filtered ("matched.\n");
10723 printf_filtered ("MIS-MATCHED!\n");
10727 if (mismatched > 0)
10728 warning (_("One or more sections of the target image does not match\n\
10729 the loaded file\n"));
10730 if (args && !matched)
10731 printf_filtered (_("No loaded section named '%s'.\n"), args);
10734 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
10735 into remote target. The number of bytes written to the remote
10736 target is returned, or -1 for error. */
10739 remote_target::remote_write_qxfer (const char *object_name,
10740 const char *annex, const gdb_byte *writebuf,
10741 ULONGEST offset, LONGEST len,
10742 ULONGEST *xfered_len,
10743 struct packet_config *packet)
10747 struct remote_state *rs = get_remote_state ();
10748 int max_size = get_memory_write_packet_size ();
10750 if (packet_config_support (packet) == PACKET_DISABLE)
10751 return TARGET_XFER_E_IO;
10753 /* Insert header. */
10754 i = snprintf (rs->buf.data (), max_size,
10755 "qXfer:%s:write:%s:%s:",
10756 object_name, annex ? annex : "",
10757 phex_nz (offset, sizeof offset));
10758 max_size -= (i + 1);
10760 /* Escape as much data as fits into rs->buf. */
10761 buf_len = remote_escape_output
10762 (writebuf, len, 1, (gdb_byte *) rs->buf.data () + i, &max_size, max_size);
10764 if (putpkt_binary (rs->buf.data (), i + buf_len) < 0
10765 || getpkt_sane (&rs->buf, 0) < 0
10766 || packet_ok (rs->buf, packet) != PACKET_OK)
10767 return TARGET_XFER_E_IO;
10769 unpack_varlen_hex (rs->buf.data (), &n);
10772 return (*xfered_len != 0) ? TARGET_XFER_OK : TARGET_XFER_EOF;
10775 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
10776 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
10777 number of bytes read is returned, or 0 for EOF, or -1 for error.
10778 The number of bytes read may be less than LEN without indicating an
10779 EOF. PACKET is checked and updated to indicate whether the remote
10780 target supports this object. */
10783 remote_target::remote_read_qxfer (const char *object_name,
10785 gdb_byte *readbuf, ULONGEST offset,
10787 ULONGEST *xfered_len,
10788 struct packet_config *packet)
10790 struct remote_state *rs = get_remote_state ();
10791 LONGEST i, n, packet_len;
10793 if (packet_config_support (packet) == PACKET_DISABLE)
10794 return TARGET_XFER_E_IO;
10796 /* Check whether we've cached an end-of-object packet that matches
10798 if (rs->finished_object)
10800 if (strcmp (object_name, rs->finished_object) == 0
10801 && strcmp (annex ? annex : "", rs->finished_annex) == 0
10802 && offset == rs->finished_offset)
10803 return TARGET_XFER_EOF;
10806 /* Otherwise, we're now reading something different. Discard
10808 xfree (rs->finished_object);
10809 xfree (rs->finished_annex);
10810 rs->finished_object = NULL;
10811 rs->finished_annex = NULL;
10814 /* Request only enough to fit in a single packet. The actual data
10815 may not, since we don't know how much of it will need to be escaped;
10816 the target is free to respond with slightly less data. We subtract
10817 five to account for the response type and the protocol frame. */
10818 n = std::min<LONGEST> (get_remote_packet_size () - 5, len);
10819 snprintf (rs->buf.data (), get_remote_packet_size () - 4,
10820 "qXfer:%s:read:%s:%s,%s",
10821 object_name, annex ? annex : "",
10822 phex_nz (offset, sizeof offset),
10823 phex_nz (n, sizeof n));
10824 i = putpkt (rs->buf);
10826 return TARGET_XFER_E_IO;
10829 packet_len = getpkt_sane (&rs->buf, 0);
10830 if (packet_len < 0 || packet_ok (rs->buf, packet) != PACKET_OK)
10831 return TARGET_XFER_E_IO;
10833 if (rs->buf[0] != 'l' && rs->buf[0] != 'm')
10834 error (_("Unknown remote qXfer reply: %s"), rs->buf.data ());
10836 /* 'm' means there is (or at least might be) more data after this
10837 batch. That does not make sense unless there's at least one byte
10838 of data in this reply. */
10839 if (rs->buf[0] == 'm' && packet_len == 1)
10840 error (_("Remote qXfer reply contained no data."));
10842 /* Got some data. */
10843 i = remote_unescape_input ((gdb_byte *) rs->buf.data () + 1,
10844 packet_len - 1, readbuf, n);
10846 /* 'l' is an EOF marker, possibly including a final block of data,
10847 or possibly empty. If we have the final block of a non-empty
10848 object, record this fact to bypass a subsequent partial read. */
10849 if (rs->buf[0] == 'l' && offset + i > 0)
10851 rs->finished_object = xstrdup (object_name);
10852 rs->finished_annex = xstrdup (annex ? annex : "");
10853 rs->finished_offset = offset + i;
10857 return TARGET_XFER_EOF;
10861 return TARGET_XFER_OK;
10865 enum target_xfer_status
10866 remote_target::xfer_partial (enum target_object object,
10867 const char *annex, gdb_byte *readbuf,
10868 const gdb_byte *writebuf, ULONGEST offset, ULONGEST len,
10869 ULONGEST *xfered_len)
10871 struct remote_state *rs;
10875 int unit_size = gdbarch_addressable_memory_unit_size (target_gdbarch ());
10877 set_remote_traceframe ();
10878 set_general_thread (inferior_ptid);
10880 rs = get_remote_state ();
10882 /* Handle memory using the standard memory routines. */
10883 if (object == TARGET_OBJECT_MEMORY)
10885 /* If the remote target is connected but not running, we should
10886 pass this request down to a lower stratum (e.g. the executable
10888 if (!target_has_execution)
10889 return TARGET_XFER_EOF;
10891 if (writebuf != NULL)
10892 return remote_write_bytes (offset, writebuf, len, unit_size,
10895 return remote_read_bytes (offset, readbuf, len, unit_size,
10899 /* Handle SPU memory using qxfer packets. */
10900 if (object == TARGET_OBJECT_SPU)
10903 return remote_read_qxfer ("spu", annex, readbuf, offset, len,
10904 xfered_len, &remote_protocol_packets
10905 [PACKET_qXfer_spu_read]);
10907 return remote_write_qxfer ("spu", annex, writebuf, offset, len,
10908 xfered_len, &remote_protocol_packets
10909 [PACKET_qXfer_spu_write]);
10912 /* Handle extra signal info using qxfer packets. */
10913 if (object == TARGET_OBJECT_SIGNAL_INFO)
10916 return remote_read_qxfer ("siginfo", annex, readbuf, offset, len,
10917 xfered_len, &remote_protocol_packets
10918 [PACKET_qXfer_siginfo_read]);
10920 return remote_write_qxfer ("siginfo", annex,
10921 writebuf, offset, len, xfered_len,
10922 &remote_protocol_packets
10923 [PACKET_qXfer_siginfo_write]);
10926 if (object == TARGET_OBJECT_STATIC_TRACE_DATA)
10929 return remote_read_qxfer ("statictrace", annex,
10930 readbuf, offset, len, xfered_len,
10931 &remote_protocol_packets
10932 [PACKET_qXfer_statictrace_read]);
10934 return TARGET_XFER_E_IO;
10937 /* Only handle flash writes. */
10938 if (writebuf != NULL)
10942 case TARGET_OBJECT_FLASH:
10943 return remote_flash_write (offset, len, xfered_len,
10947 return TARGET_XFER_E_IO;
10951 /* Map pre-existing objects onto letters. DO NOT do this for new
10952 objects!!! Instead specify new query packets. */
10955 case TARGET_OBJECT_AVR:
10959 case TARGET_OBJECT_AUXV:
10960 gdb_assert (annex == NULL);
10961 return remote_read_qxfer ("auxv", annex, readbuf, offset, len,
10963 &remote_protocol_packets[PACKET_qXfer_auxv]);
10965 case TARGET_OBJECT_AVAILABLE_FEATURES:
10966 return remote_read_qxfer
10967 ("features", annex, readbuf, offset, len, xfered_len,
10968 &remote_protocol_packets[PACKET_qXfer_features]);
10970 case TARGET_OBJECT_LIBRARIES:
10971 return remote_read_qxfer
10972 ("libraries", annex, readbuf, offset, len, xfered_len,
10973 &remote_protocol_packets[PACKET_qXfer_libraries]);
10975 case TARGET_OBJECT_LIBRARIES_SVR4:
10976 return remote_read_qxfer
10977 ("libraries-svr4", annex, readbuf, offset, len, xfered_len,
10978 &remote_protocol_packets[PACKET_qXfer_libraries_svr4]);
10980 case TARGET_OBJECT_MEMORY_MAP:
10981 gdb_assert (annex == NULL);
10982 return remote_read_qxfer ("memory-map", annex, readbuf, offset, len,
10984 &remote_protocol_packets[PACKET_qXfer_memory_map]);
10986 case TARGET_OBJECT_OSDATA:
10987 /* Should only get here if we're connected. */
10988 gdb_assert (rs->remote_desc);
10989 return remote_read_qxfer
10990 ("osdata", annex, readbuf, offset, len, xfered_len,
10991 &remote_protocol_packets[PACKET_qXfer_osdata]);
10993 case TARGET_OBJECT_THREADS:
10994 gdb_assert (annex == NULL);
10995 return remote_read_qxfer ("threads", annex, readbuf, offset, len,
10997 &remote_protocol_packets[PACKET_qXfer_threads]);
10999 case TARGET_OBJECT_TRACEFRAME_INFO:
11000 gdb_assert (annex == NULL);
11001 return remote_read_qxfer
11002 ("traceframe-info", annex, readbuf, offset, len, xfered_len,
11003 &remote_protocol_packets[PACKET_qXfer_traceframe_info]);
11005 case TARGET_OBJECT_FDPIC:
11006 return remote_read_qxfer ("fdpic", annex, readbuf, offset, len,
11008 &remote_protocol_packets[PACKET_qXfer_fdpic]);
11010 case TARGET_OBJECT_OPENVMS_UIB:
11011 return remote_read_qxfer ("uib", annex, readbuf, offset, len,
11013 &remote_protocol_packets[PACKET_qXfer_uib]);
11015 case TARGET_OBJECT_BTRACE:
11016 return remote_read_qxfer ("btrace", annex, readbuf, offset, len,
11018 &remote_protocol_packets[PACKET_qXfer_btrace]);
11020 case TARGET_OBJECT_BTRACE_CONF:
11021 return remote_read_qxfer ("btrace-conf", annex, readbuf, offset,
11023 &remote_protocol_packets[PACKET_qXfer_btrace_conf]);
11025 case TARGET_OBJECT_EXEC_FILE:
11026 return remote_read_qxfer ("exec-file", annex, readbuf, offset,
11028 &remote_protocol_packets[PACKET_qXfer_exec_file]);
11031 return TARGET_XFER_E_IO;
11034 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
11035 large enough let the caller deal with it. */
11036 if (len < get_remote_packet_size ())
11037 return TARGET_XFER_E_IO;
11038 len = get_remote_packet_size ();
11040 /* Except for querying the minimum buffer size, target must be open. */
11041 if (!rs->remote_desc)
11042 error (_("remote query is only available after target open"));
11044 gdb_assert (annex != NULL);
11045 gdb_assert (readbuf != NULL);
11047 p2 = rs->buf.data ();
11049 *p2++ = query_type;
11051 /* We used one buffer char for the remote protocol q command and
11052 another for the query type. As the remote protocol encapsulation
11053 uses 4 chars plus one extra in case we are debugging
11054 (remote_debug), we have PBUFZIZ - 7 left to pack the query
11057 while (annex[i] && (i < (get_remote_packet_size () - 8)))
11059 /* Bad caller may have sent forbidden characters. */
11060 gdb_assert (isprint (annex[i]) && annex[i] != '$' && annex[i] != '#');
11065 gdb_assert (annex[i] == '\0');
11067 i = putpkt (rs->buf);
11069 return TARGET_XFER_E_IO;
11071 getpkt (&rs->buf, 0);
11072 strcpy ((char *) readbuf, rs->buf.data ());
11074 *xfered_len = strlen ((char *) readbuf);
11075 return (*xfered_len != 0) ? TARGET_XFER_OK : TARGET_XFER_EOF;
11078 /* Implementation of to_get_memory_xfer_limit. */
11081 remote_target::get_memory_xfer_limit ()
11083 return get_memory_write_packet_size ();
11087 remote_target::search_memory (CORE_ADDR start_addr, ULONGEST search_space_len,
11088 const gdb_byte *pattern, ULONGEST pattern_len,
11089 CORE_ADDR *found_addrp)
11091 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
11092 struct remote_state *rs = get_remote_state ();
11093 int max_size = get_memory_write_packet_size ();
11094 struct packet_config *packet =
11095 &remote_protocol_packets[PACKET_qSearch_memory];
11096 /* Number of packet bytes used to encode the pattern;
11097 this could be more than PATTERN_LEN due to escape characters. */
11098 int escaped_pattern_len;
11099 /* Amount of pattern that was encodable in the packet. */
11100 int used_pattern_len;
11103 ULONGEST found_addr;
11105 /* Don't go to the target if we don't have to. This is done before
11106 checking packet_config_support to avoid the possibility that a
11107 success for this edge case means the facility works in
11109 if (pattern_len > search_space_len)
11111 if (pattern_len == 0)
11113 *found_addrp = start_addr;
11117 /* If we already know the packet isn't supported, fall back to the simple
11118 way of searching memory. */
11120 if (packet_config_support (packet) == PACKET_DISABLE)
11122 /* Target doesn't provided special support, fall back and use the
11123 standard support (copy memory and do the search here). */
11124 return simple_search_memory (this, start_addr, search_space_len,
11125 pattern, pattern_len, found_addrp);
11128 /* Make sure the remote is pointing at the right process. */
11129 set_general_process ();
11131 /* Insert header. */
11132 i = snprintf (rs->buf.data (), max_size,
11133 "qSearch:memory:%s;%s;",
11134 phex_nz (start_addr, addr_size),
11135 phex_nz (search_space_len, sizeof (search_space_len)));
11136 max_size -= (i + 1);
11138 /* Escape as much data as fits into rs->buf. */
11139 escaped_pattern_len =
11140 remote_escape_output (pattern, pattern_len, 1,
11141 (gdb_byte *) rs->buf.data () + i,
11142 &used_pattern_len, max_size);
11144 /* Bail if the pattern is too large. */
11145 if (used_pattern_len != pattern_len)
11146 error (_("Pattern is too large to transmit to remote target."));
11148 if (putpkt_binary (rs->buf.data (), i + escaped_pattern_len) < 0
11149 || getpkt_sane (&rs->buf, 0) < 0
11150 || packet_ok (rs->buf, packet) != PACKET_OK)
11152 /* The request may not have worked because the command is not
11153 supported. If so, fall back to the simple way. */
11154 if (packet_config_support (packet) == PACKET_DISABLE)
11156 return simple_search_memory (this, start_addr, search_space_len,
11157 pattern, pattern_len, found_addrp);
11162 if (rs->buf[0] == '0')
11164 else if (rs->buf[0] == '1')
11167 if (rs->buf[1] != ',')
11168 error (_("Unknown qSearch:memory reply: %s"), rs->buf.data ());
11169 unpack_varlen_hex (&rs->buf[2], &found_addr);
11170 *found_addrp = found_addr;
11173 error (_("Unknown qSearch:memory reply: %s"), rs->buf.data ());
11179 remote_target::rcmd (const char *command, struct ui_file *outbuf)
11181 struct remote_state *rs = get_remote_state ();
11182 char *p = rs->buf.data ();
11184 if (!rs->remote_desc)
11185 error (_("remote rcmd is only available after target open"));
11187 /* Send a NULL command across as an empty command. */
11188 if (command == NULL)
11191 /* The query prefix. */
11192 strcpy (rs->buf.data (), "qRcmd,");
11193 p = strchr (rs->buf.data (), '\0');
11195 if ((strlen (rs->buf.data ()) + strlen (command) * 2 + 8/*misc*/)
11196 > get_remote_packet_size ())
11197 error (_("\"monitor\" command ``%s'' is too long."), command);
11199 /* Encode the actual command. */
11200 bin2hex ((const gdb_byte *) command, p, strlen (command));
11202 if (putpkt (rs->buf) < 0)
11203 error (_("Communication problem with target."));
11205 /* get/display the response */
11210 /* XXX - see also remote_get_noisy_reply(). */
11211 QUIT; /* Allow user to bail out with ^C. */
11213 if (getpkt_sane (&rs->buf, 0) == -1)
11215 /* Timeout. Continue to (try to) read responses.
11216 This is better than stopping with an error, assuming the stub
11217 is still executing the (long) monitor command.
11218 If needed, the user can interrupt gdb using C-c, obtaining
11219 an effect similar to stop on timeout. */
11222 buf = rs->buf.data ();
11223 if (buf[0] == '\0')
11224 error (_("Target does not support this command."));
11225 if (buf[0] == 'O' && buf[1] != 'K')
11227 remote_console_output (buf + 1); /* 'O' message from stub. */
11230 if (strcmp (buf, "OK") == 0)
11232 if (strlen (buf) == 3 && buf[0] == 'E'
11233 && isdigit (buf[1]) && isdigit (buf[2]))
11235 error (_("Protocol error with Rcmd"));
11237 for (p = buf; p[0] != '\0' && p[1] != '\0'; p += 2)
11239 char c = (fromhex (p[0]) << 4) + fromhex (p[1]);
11241 fputc_unfiltered (c, outbuf);
11247 std::vector<mem_region>
11248 remote_target::memory_map ()
11250 std::vector<mem_region> result;
11251 gdb::optional<gdb::char_vector> text
11252 = target_read_stralloc (current_top_target (), TARGET_OBJECT_MEMORY_MAP, NULL);
11255 result = parse_memory_map (text->data ());
11261 packet_command (const char *args, int from_tty)
11263 remote_target *remote = get_current_remote_target ();
11265 if (remote == nullptr)
11266 error (_("command can only be used with remote target"));
11268 remote->packet_command (args, from_tty);
11272 remote_target::packet_command (const char *args, int from_tty)
11275 error (_("remote-packet command requires packet text as argument"));
11277 puts_filtered ("sending: ");
11278 print_packet (args);
11279 puts_filtered ("\n");
11282 remote_state *rs = get_remote_state ();
11284 getpkt (&rs->buf, 0);
11285 puts_filtered ("received: ");
11286 print_packet (rs->buf.data ());
11287 puts_filtered ("\n");
11291 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
11293 static void display_thread_info (struct gdb_ext_thread_info *info);
11295 static void threadset_test_cmd (char *cmd, int tty);
11297 static void threadalive_test (char *cmd, int tty);
11299 static void threadlist_test_cmd (char *cmd, int tty);
11301 int get_and_display_threadinfo (threadref *ref);
11303 static void threadinfo_test_cmd (char *cmd, int tty);
11305 static int thread_display_step (threadref *ref, void *context);
11307 static void threadlist_update_test_cmd (char *cmd, int tty);
11309 static void init_remote_threadtests (void);
11311 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
11314 threadset_test_cmd (const char *cmd, int tty)
11316 int sample_thread = SAMPLE_THREAD;
11318 printf_filtered (_("Remote threadset test\n"));
11319 set_general_thread (sample_thread);
11324 threadalive_test (const char *cmd, int tty)
11326 int sample_thread = SAMPLE_THREAD;
11327 int pid = inferior_ptid.pid ();
11328 ptid_t ptid = ptid_t (pid, sample_thread, 0);
11330 if (remote_thread_alive (ptid))
11331 printf_filtered ("PASS: Thread alive test\n");
11333 printf_filtered ("FAIL: Thread alive test\n");
11336 void output_threadid (char *title, threadref *ref);
11339 output_threadid (char *title, threadref *ref)
11343 pack_threadid (&hexid[0], ref); /* Convert threead id into hex. */
11345 printf_filtered ("%s %s\n", title, (&hexid[0]));
11349 threadlist_test_cmd (const char *cmd, int tty)
11352 threadref nextthread;
11353 int done, result_count;
11354 threadref threadlist[3];
11356 printf_filtered ("Remote Threadlist test\n");
11357 if (!remote_get_threadlist (startflag, &nextthread, 3, &done,
11358 &result_count, &threadlist[0]))
11359 printf_filtered ("FAIL: threadlist test\n");
11362 threadref *scan = threadlist;
11363 threadref *limit = scan + result_count;
11365 while (scan < limit)
11366 output_threadid (" thread ", scan++);
11371 display_thread_info (struct gdb_ext_thread_info *info)
11373 output_threadid ("Threadid: ", &info->threadid);
11374 printf_filtered ("Name: %s\n ", info->shortname);
11375 printf_filtered ("State: %s\n", info->display);
11376 printf_filtered ("other: %s\n\n", info->more_display);
11380 get_and_display_threadinfo (threadref *ref)
11384 struct gdb_ext_thread_info threadinfo;
11386 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
11387 | TAG_MOREDISPLAY | TAG_DISPLAY;
11388 if (0 != (result = remote_get_threadinfo (ref, set, &threadinfo)))
11389 display_thread_info (&threadinfo);
11394 threadinfo_test_cmd (const char *cmd, int tty)
11396 int athread = SAMPLE_THREAD;
11400 int_to_threadref (&thread, athread);
11401 printf_filtered ("Remote Threadinfo test\n");
11402 if (!get_and_display_threadinfo (&thread))
11403 printf_filtered ("FAIL cannot get thread info\n");
11407 thread_display_step (threadref *ref, void *context)
11409 /* output_threadid(" threadstep ",ref); *//* simple test */
11410 return get_and_display_threadinfo (ref);
11414 threadlist_update_test_cmd (const char *cmd, int tty)
11416 printf_filtered ("Remote Threadlist update test\n");
11417 remote_threadlist_iterator (thread_display_step, 0, CRAZY_MAX_THREADS);
11421 init_remote_threadtests (void)
11423 add_com ("tlist", class_obscure, threadlist_test_cmd,
11424 _("Fetch and print the remote list of "
11425 "thread identifiers, one pkt only"));
11426 add_com ("tinfo", class_obscure, threadinfo_test_cmd,
11427 _("Fetch and display info about one thread"));
11428 add_com ("tset", class_obscure, threadset_test_cmd,
11429 _("Test setting to a different thread"));
11430 add_com ("tupd", class_obscure, threadlist_update_test_cmd,
11431 _("Iterate through updating all remote thread info"));
11432 add_com ("talive", class_obscure, threadalive_test,
11433 _(" Remote thread alive test "));
11438 /* Convert a thread ID to a string. Returns the string in a static
11442 remote_target::pid_to_str (ptid_t ptid)
11444 static char buf[64];
11445 struct remote_state *rs = get_remote_state ();
11447 if (ptid == null_ptid)
11448 return normal_pid_to_str (ptid);
11449 else if (ptid.is_pid ())
11451 /* Printing an inferior target id. */
11453 /* When multi-process extensions are off, there's no way in the
11454 remote protocol to know the remote process id, if there's any
11455 at all. There's one exception --- when we're connected with
11456 target extended-remote, and we manually attached to a process
11457 with "attach PID". We don't record anywhere a flag that
11458 allows us to distinguish that case from the case of
11459 connecting with extended-remote and the stub already being
11460 attached to a process, and reporting yes to qAttached, hence
11461 no smart special casing here. */
11462 if (!remote_multi_process_p (rs))
11464 xsnprintf (buf, sizeof buf, "Remote target");
11468 return normal_pid_to_str (ptid);
11472 if (magic_null_ptid == ptid)
11473 xsnprintf (buf, sizeof buf, "Thread <main>");
11474 else if (remote_multi_process_p (rs))
11475 if (ptid.lwp () == 0)
11476 return normal_pid_to_str (ptid);
11478 xsnprintf (buf, sizeof buf, "Thread %d.%ld",
11479 ptid.pid (), ptid.lwp ());
11481 xsnprintf (buf, sizeof buf, "Thread %ld",
11487 /* Get the address of the thread local variable in OBJFILE which is
11488 stored at OFFSET within the thread local storage for thread PTID. */
11491 remote_target::get_thread_local_address (ptid_t ptid, CORE_ADDR lm,
11494 if (packet_support (PACKET_qGetTLSAddr) != PACKET_DISABLE)
11496 struct remote_state *rs = get_remote_state ();
11497 char *p = rs->buf.data ();
11498 char *endp = p + get_remote_packet_size ();
11499 enum packet_result result;
11501 strcpy (p, "qGetTLSAddr:");
11503 p = write_ptid (p, endp, ptid);
11505 p += hexnumstr (p, offset);
11507 p += hexnumstr (p, lm);
11511 getpkt (&rs->buf, 0);
11512 result = packet_ok (rs->buf,
11513 &remote_protocol_packets[PACKET_qGetTLSAddr]);
11514 if (result == PACKET_OK)
11518 unpack_varlen_hex (rs->buf.data (), &addr);
11521 else if (result == PACKET_UNKNOWN)
11522 throw_error (TLS_GENERIC_ERROR,
11523 _("Remote target doesn't support qGetTLSAddr packet"));
11525 throw_error (TLS_GENERIC_ERROR,
11526 _("Remote target failed to process qGetTLSAddr request"));
11529 throw_error (TLS_GENERIC_ERROR,
11530 _("TLS not supported or disabled on this target"));
11535 /* Provide thread local base, i.e. Thread Information Block address.
11536 Returns 1 if ptid is found and thread_local_base is non zero. */
11539 remote_target::get_tib_address (ptid_t ptid, CORE_ADDR *addr)
11541 if (packet_support (PACKET_qGetTIBAddr) != PACKET_DISABLE)
11543 struct remote_state *rs = get_remote_state ();
11544 char *p = rs->buf.data ();
11545 char *endp = p + get_remote_packet_size ();
11546 enum packet_result result;
11548 strcpy (p, "qGetTIBAddr:");
11550 p = write_ptid (p, endp, ptid);
11554 getpkt (&rs->buf, 0);
11555 result = packet_ok (rs->buf,
11556 &remote_protocol_packets[PACKET_qGetTIBAddr]);
11557 if (result == PACKET_OK)
11560 unpack_varlen_hex (rs->buf.data (), &val);
11562 *addr = (CORE_ADDR) val;
11565 else if (result == PACKET_UNKNOWN)
11566 error (_("Remote target doesn't support qGetTIBAddr packet"));
11568 error (_("Remote target failed to process qGetTIBAddr request"));
11571 error (_("qGetTIBAddr not supported or disabled on this target"));
11576 /* Support for inferring a target description based on the current
11577 architecture and the size of a 'g' packet. While the 'g' packet
11578 can have any size (since optional registers can be left off the
11579 end), some sizes are easily recognizable given knowledge of the
11580 approximate architecture. */
11582 struct remote_g_packet_guess
11584 remote_g_packet_guess (int bytes_, const struct target_desc *tdesc_)
11591 const struct target_desc *tdesc;
11594 struct remote_g_packet_data : public allocate_on_obstack
11596 std::vector<remote_g_packet_guess> guesses;
11599 static struct gdbarch_data *remote_g_packet_data_handle;
11602 remote_g_packet_data_init (struct obstack *obstack)
11604 return new (obstack) remote_g_packet_data;
11608 register_remote_g_packet_guess (struct gdbarch *gdbarch, int bytes,
11609 const struct target_desc *tdesc)
11611 struct remote_g_packet_data *data
11612 = ((struct remote_g_packet_data *)
11613 gdbarch_data (gdbarch, remote_g_packet_data_handle));
11615 gdb_assert (tdesc != NULL);
11617 for (const remote_g_packet_guess &guess : data->guesses)
11618 if (guess.bytes == bytes)
11619 internal_error (__FILE__, __LINE__,
11620 _("Duplicate g packet description added for size %d"),
11623 data->guesses.emplace_back (bytes, tdesc);
11626 /* Return true if remote_read_description would do anything on this target
11627 and architecture, false otherwise. */
11630 remote_read_description_p (struct target_ops *target)
11632 struct remote_g_packet_data *data
11633 = ((struct remote_g_packet_data *)
11634 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle));
11636 return !data->guesses.empty ();
11639 const struct target_desc *
11640 remote_target::read_description ()
11642 struct remote_g_packet_data *data
11643 = ((struct remote_g_packet_data *)
11644 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle));
11646 /* Do not try this during initial connection, when we do not know
11647 whether there is a running but stopped thread. */
11648 if (!target_has_execution || inferior_ptid == null_ptid)
11649 return beneath ()->read_description ();
11651 if (!data->guesses.empty ())
11653 int bytes = send_g_packet ();
11655 for (const remote_g_packet_guess &guess : data->guesses)
11656 if (guess.bytes == bytes)
11657 return guess.tdesc;
11659 /* We discard the g packet. A minor optimization would be to
11660 hold on to it, and fill the register cache once we have selected
11661 an architecture, but it's too tricky to do safely. */
11664 return beneath ()->read_description ();
11667 /* Remote file transfer support. This is host-initiated I/O, not
11668 target-initiated; for target-initiated, see remote-fileio.c. */
11670 /* If *LEFT is at least the length of STRING, copy STRING to
11671 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11672 decrease *LEFT. Otherwise raise an error. */
11675 remote_buffer_add_string (char **buffer, int *left, const char *string)
11677 int len = strlen (string);
11680 error (_("Packet too long for target."));
11682 memcpy (*buffer, string, len);
11686 /* NUL-terminate the buffer as a convenience, if there is
11692 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
11693 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11694 decrease *LEFT. Otherwise raise an error. */
11697 remote_buffer_add_bytes (char **buffer, int *left, const gdb_byte *bytes,
11700 if (2 * len > *left)
11701 error (_("Packet too long for target."));
11703 bin2hex (bytes, *buffer, len);
11704 *buffer += 2 * len;
11707 /* NUL-terminate the buffer as a convenience, if there is
11713 /* If *LEFT is large enough, convert VALUE to hex and add it to
11714 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11715 decrease *LEFT. Otherwise raise an error. */
11718 remote_buffer_add_int (char **buffer, int *left, ULONGEST value)
11720 int len = hexnumlen (value);
11723 error (_("Packet too long for target."));
11725 hexnumstr (*buffer, value);
11729 /* NUL-terminate the buffer as a convenience, if there is
11735 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
11736 value, *REMOTE_ERRNO to the remote error number or zero if none
11737 was included, and *ATTACHMENT to point to the start of the annex
11738 if any. The length of the packet isn't needed here; there may
11739 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
11741 Return 0 if the packet could be parsed, -1 if it could not. If
11742 -1 is returned, the other variables may not be initialized. */
11745 remote_hostio_parse_result (char *buffer, int *retcode,
11746 int *remote_errno, char **attachment)
11751 *attachment = NULL;
11753 if (buffer[0] != 'F')
11757 *retcode = strtol (&buffer[1], &p, 16);
11758 if (errno != 0 || p == &buffer[1])
11761 /* Check for ",errno". */
11765 *remote_errno = strtol (p + 1, &p2, 16);
11766 if (errno != 0 || p + 1 == p2)
11771 /* Check for ";attachment". If there is no attachment, the
11772 packet should end here. */
11775 *attachment = p + 1;
11778 else if (*p == '\0')
11784 /* Send a prepared I/O packet to the target and read its response.
11785 The prepared packet is in the global RS->BUF before this function
11786 is called, and the answer is there when we return.
11788 COMMAND_BYTES is the length of the request to send, which may include
11789 binary data. WHICH_PACKET is the packet configuration to check
11790 before attempting a packet. If an error occurs, *REMOTE_ERRNO
11791 is set to the error number and -1 is returned. Otherwise the value
11792 returned by the function is returned.
11794 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
11795 attachment is expected; an error will be reported if there's a
11796 mismatch. If one is found, *ATTACHMENT will be set to point into
11797 the packet buffer and *ATTACHMENT_LEN will be set to the
11798 attachment's length. */
11801 remote_target::remote_hostio_send_command (int command_bytes, int which_packet,
11802 int *remote_errno, char **attachment,
11803 int *attachment_len)
11805 struct remote_state *rs = get_remote_state ();
11806 int ret, bytes_read;
11807 char *attachment_tmp;
11809 if (packet_support (which_packet) == PACKET_DISABLE)
11811 *remote_errno = FILEIO_ENOSYS;
11815 putpkt_binary (rs->buf.data (), command_bytes);
11816 bytes_read = getpkt_sane (&rs->buf, 0);
11818 /* If it timed out, something is wrong. Don't try to parse the
11820 if (bytes_read < 0)
11822 *remote_errno = FILEIO_EINVAL;
11826 switch (packet_ok (rs->buf, &remote_protocol_packets[which_packet]))
11829 *remote_errno = FILEIO_EINVAL;
11831 case PACKET_UNKNOWN:
11832 *remote_errno = FILEIO_ENOSYS;
11838 if (remote_hostio_parse_result (rs->buf.data (), &ret, remote_errno,
11841 *remote_errno = FILEIO_EINVAL;
11845 /* Make sure we saw an attachment if and only if we expected one. */
11846 if ((attachment_tmp == NULL && attachment != NULL)
11847 || (attachment_tmp != NULL && attachment == NULL))
11849 *remote_errno = FILEIO_EINVAL;
11853 /* If an attachment was found, it must point into the packet buffer;
11854 work out how many bytes there were. */
11855 if (attachment_tmp != NULL)
11857 *attachment = attachment_tmp;
11858 *attachment_len = bytes_read - (*attachment - rs->buf.data ());
11864 /* See declaration.h. */
11867 readahead_cache::invalidate ()
11872 /* See declaration.h. */
11875 readahead_cache::invalidate_fd (int fd)
11877 if (this->fd == fd)
11881 /* Set the filesystem remote_hostio functions that take FILENAME
11882 arguments will use. Return 0 on success, or -1 if an error
11883 occurs (and set *REMOTE_ERRNO). */
11886 remote_target::remote_hostio_set_filesystem (struct inferior *inf,
11889 struct remote_state *rs = get_remote_state ();
11890 int required_pid = (inf == NULL || inf->fake_pid_p) ? 0 : inf->pid;
11891 char *p = rs->buf.data ();
11892 int left = get_remote_packet_size () - 1;
11896 if (packet_support (PACKET_vFile_setfs) == PACKET_DISABLE)
11899 if (rs->fs_pid != -1 && required_pid == rs->fs_pid)
11902 remote_buffer_add_string (&p, &left, "vFile:setfs:");
11904 xsnprintf (arg, sizeof (arg), "%x", required_pid);
11905 remote_buffer_add_string (&p, &left, arg);
11907 ret = remote_hostio_send_command (p - rs->buf.data (), PACKET_vFile_setfs,
11908 remote_errno, NULL, NULL);
11910 if (packet_support (PACKET_vFile_setfs) == PACKET_DISABLE)
11914 rs->fs_pid = required_pid;
11919 /* Implementation of to_fileio_open. */
11922 remote_target::remote_hostio_open (inferior *inf, const char *filename,
11923 int flags, int mode, int warn_if_slow,
11926 struct remote_state *rs = get_remote_state ();
11927 char *p = rs->buf.data ();
11928 int left = get_remote_packet_size () - 1;
11932 static int warning_issued = 0;
11934 printf_unfiltered (_("Reading %s from remote target...\n"),
11937 if (!warning_issued)
11939 warning (_("File transfers from remote targets can be slow."
11940 " Use \"set sysroot\" to access files locally"
11942 warning_issued = 1;
11946 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
11949 remote_buffer_add_string (&p, &left, "vFile:open:");
11951 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
11952 strlen (filename));
11953 remote_buffer_add_string (&p, &left, ",");
11955 remote_buffer_add_int (&p, &left, flags);
11956 remote_buffer_add_string (&p, &left, ",");
11958 remote_buffer_add_int (&p, &left, mode);
11960 return remote_hostio_send_command (p - rs->buf.data (), PACKET_vFile_open,
11961 remote_errno, NULL, NULL);
11965 remote_target::fileio_open (struct inferior *inf, const char *filename,
11966 int flags, int mode, int warn_if_slow,
11969 return remote_hostio_open (inf, filename, flags, mode, warn_if_slow,
11973 /* Implementation of to_fileio_pwrite. */
11976 remote_target::remote_hostio_pwrite (int fd, const gdb_byte *write_buf, int len,
11977 ULONGEST offset, int *remote_errno)
11979 struct remote_state *rs = get_remote_state ();
11980 char *p = rs->buf.data ();
11981 int left = get_remote_packet_size ();
11984 rs->readahead_cache.invalidate_fd (fd);
11986 remote_buffer_add_string (&p, &left, "vFile:pwrite:");
11988 remote_buffer_add_int (&p, &left, fd);
11989 remote_buffer_add_string (&p, &left, ",");
11991 remote_buffer_add_int (&p, &left, offset);
11992 remote_buffer_add_string (&p, &left, ",");
11994 p += remote_escape_output (write_buf, len, 1, (gdb_byte *) p, &out_len,
11995 (get_remote_packet_size ()
11996 - (p - rs->buf.data ())));
11998 return remote_hostio_send_command (p - rs->buf.data (), PACKET_vFile_pwrite,
11999 remote_errno, NULL, NULL);
12003 remote_target::fileio_pwrite (int fd, const gdb_byte *write_buf, int len,
12004 ULONGEST offset, int *remote_errno)
12006 return remote_hostio_pwrite (fd, write_buf, len, offset, remote_errno);
12009 /* Helper for the implementation of to_fileio_pread. Read the file
12010 from the remote side with vFile:pread. */
12013 remote_target::remote_hostio_pread_vFile (int fd, gdb_byte *read_buf, int len,
12014 ULONGEST offset, int *remote_errno)
12016 struct remote_state *rs = get_remote_state ();
12017 char *p = rs->buf.data ();
12019 int left = get_remote_packet_size ();
12020 int ret, attachment_len;
12023 remote_buffer_add_string (&p, &left, "vFile:pread:");
12025 remote_buffer_add_int (&p, &left, fd);
12026 remote_buffer_add_string (&p, &left, ",");
12028 remote_buffer_add_int (&p, &left, len);
12029 remote_buffer_add_string (&p, &left, ",");
12031 remote_buffer_add_int (&p, &left, offset);
12033 ret = remote_hostio_send_command (p - rs->buf.data (), PACKET_vFile_pread,
12034 remote_errno, &attachment,
12040 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
12042 if (read_len != ret)
12043 error (_("Read returned %d, but %d bytes."), ret, (int) read_len);
12048 /* See declaration.h. */
12051 readahead_cache::pread (int fd, gdb_byte *read_buf, size_t len,
12055 && this->offset <= offset
12056 && offset < this->offset + this->bufsize)
12058 ULONGEST max = this->offset + this->bufsize;
12060 if (offset + len > max)
12061 len = max - offset;
12063 memcpy (read_buf, this->buf + offset - this->offset, len);
12070 /* Implementation of to_fileio_pread. */
12073 remote_target::remote_hostio_pread (int fd, gdb_byte *read_buf, int len,
12074 ULONGEST offset, int *remote_errno)
12077 struct remote_state *rs = get_remote_state ();
12078 readahead_cache *cache = &rs->readahead_cache;
12080 ret = cache->pread (fd, read_buf, len, offset);
12083 cache->hit_count++;
12086 fprintf_unfiltered (gdb_stdlog, "readahead cache hit %s\n",
12087 pulongest (cache->hit_count));
12091 cache->miss_count++;
12093 fprintf_unfiltered (gdb_stdlog, "readahead cache miss %s\n",
12094 pulongest (cache->miss_count));
12097 cache->offset = offset;
12098 cache->bufsize = get_remote_packet_size ();
12099 cache->buf = (gdb_byte *) xrealloc (cache->buf, cache->bufsize);
12101 ret = remote_hostio_pread_vFile (cache->fd, cache->buf, cache->bufsize,
12102 cache->offset, remote_errno);
12105 cache->invalidate_fd (fd);
12109 cache->bufsize = ret;
12110 return cache->pread (fd, read_buf, len, offset);
12114 remote_target::fileio_pread (int fd, gdb_byte *read_buf, int len,
12115 ULONGEST offset, int *remote_errno)
12117 return remote_hostio_pread (fd, read_buf, len, offset, remote_errno);
12120 /* Implementation of to_fileio_close. */
12123 remote_target::remote_hostio_close (int fd, int *remote_errno)
12125 struct remote_state *rs = get_remote_state ();
12126 char *p = rs->buf.data ();
12127 int left = get_remote_packet_size () - 1;
12129 rs->readahead_cache.invalidate_fd (fd);
12131 remote_buffer_add_string (&p, &left, "vFile:close:");
12133 remote_buffer_add_int (&p, &left, fd);
12135 return remote_hostio_send_command (p - rs->buf.data (), PACKET_vFile_close,
12136 remote_errno, NULL, NULL);
12140 remote_target::fileio_close (int fd, int *remote_errno)
12142 return remote_hostio_close (fd, remote_errno);
12145 /* Implementation of to_fileio_unlink. */
12148 remote_target::remote_hostio_unlink (inferior *inf, const char *filename,
12151 struct remote_state *rs = get_remote_state ();
12152 char *p = rs->buf.data ();
12153 int left = get_remote_packet_size () - 1;
12155 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
12158 remote_buffer_add_string (&p, &left, "vFile:unlink:");
12160 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
12161 strlen (filename));
12163 return remote_hostio_send_command (p - rs->buf.data (), PACKET_vFile_unlink,
12164 remote_errno, NULL, NULL);
12168 remote_target::fileio_unlink (struct inferior *inf, const char *filename,
12171 return remote_hostio_unlink (inf, filename, remote_errno);
12174 /* Implementation of to_fileio_readlink. */
12176 gdb::optional<std::string>
12177 remote_target::fileio_readlink (struct inferior *inf, const char *filename,
12180 struct remote_state *rs = get_remote_state ();
12181 char *p = rs->buf.data ();
12183 int left = get_remote_packet_size ();
12184 int len, attachment_len;
12187 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
12190 remote_buffer_add_string (&p, &left, "vFile:readlink:");
12192 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
12193 strlen (filename));
12195 len = remote_hostio_send_command (p - rs->buf.data (), PACKET_vFile_readlink,
12196 remote_errno, &attachment,
12202 std::string ret (len, '\0');
12204 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
12205 (gdb_byte *) &ret[0], len);
12206 if (read_len != len)
12207 error (_("Readlink returned %d, but %d bytes."), len, read_len);
12212 /* Implementation of to_fileio_fstat. */
12215 remote_target::fileio_fstat (int fd, struct stat *st, int *remote_errno)
12217 struct remote_state *rs = get_remote_state ();
12218 char *p = rs->buf.data ();
12219 int left = get_remote_packet_size ();
12220 int attachment_len, ret;
12222 struct fio_stat fst;
12225 remote_buffer_add_string (&p, &left, "vFile:fstat:");
12227 remote_buffer_add_int (&p, &left, fd);
12229 ret = remote_hostio_send_command (p - rs->buf.data (), PACKET_vFile_fstat,
12230 remote_errno, &attachment,
12234 if (*remote_errno != FILEIO_ENOSYS)
12237 /* Strictly we should return -1, ENOSYS here, but when
12238 "set sysroot remote:" was implemented in August 2008
12239 BFD's need for a stat function was sidestepped with
12240 this hack. This was not remedied until March 2015
12241 so we retain the previous behavior to avoid breaking
12244 Note that the memset is a March 2015 addition; older
12245 GDBs set st_size *and nothing else* so the structure
12246 would have garbage in all other fields. This might
12247 break something but retaining the previous behavior
12248 here would be just too wrong. */
12250 memset (st, 0, sizeof (struct stat));
12251 st->st_size = INT_MAX;
12255 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
12256 (gdb_byte *) &fst, sizeof (fst));
12258 if (read_len != ret)
12259 error (_("vFile:fstat returned %d, but %d bytes."), ret, read_len);
12261 if (read_len != sizeof (fst))
12262 error (_("vFile:fstat returned %d bytes, but expecting %d."),
12263 read_len, (int) sizeof (fst));
12265 remote_fileio_to_host_stat (&fst, st);
12270 /* Implementation of to_filesystem_is_local. */
12273 remote_target::filesystem_is_local ()
12275 /* Valgrind GDB presents itself as a remote target but works
12276 on the local filesystem: it does not implement remote get
12277 and users are not expected to set a sysroot. To handle
12278 this case we treat the remote filesystem as local if the
12279 sysroot is exactly TARGET_SYSROOT_PREFIX and if the stub
12280 does not support vFile:open. */
12281 if (strcmp (gdb_sysroot, TARGET_SYSROOT_PREFIX) == 0)
12283 enum packet_support ps = packet_support (PACKET_vFile_open);
12285 if (ps == PACKET_SUPPORT_UNKNOWN)
12287 int fd, remote_errno;
12289 /* Try opening a file to probe support. The supplied
12290 filename is irrelevant, we only care about whether
12291 the stub recognizes the packet or not. */
12292 fd = remote_hostio_open (NULL, "just probing",
12293 FILEIO_O_RDONLY, 0700, 0,
12297 remote_hostio_close (fd, &remote_errno);
12299 ps = packet_support (PACKET_vFile_open);
12302 if (ps == PACKET_DISABLE)
12304 static int warning_issued = 0;
12306 if (!warning_issued)
12308 warning (_("remote target does not support file"
12309 " transfer, attempting to access files"
12310 " from local filesystem."));
12311 warning_issued = 1;
12322 remote_fileio_errno_to_host (int errnum)
12328 case FILEIO_ENOENT:
12336 case FILEIO_EACCES:
12338 case FILEIO_EFAULT:
12342 case FILEIO_EEXIST:
12344 case FILEIO_ENODEV:
12346 case FILEIO_ENOTDIR:
12348 case FILEIO_EISDIR:
12350 case FILEIO_EINVAL:
12352 case FILEIO_ENFILE:
12354 case FILEIO_EMFILE:
12358 case FILEIO_ENOSPC:
12360 case FILEIO_ESPIPE:
12364 case FILEIO_ENOSYS:
12366 case FILEIO_ENAMETOOLONG:
12367 return ENAMETOOLONG;
12373 remote_hostio_error (int errnum)
12375 int host_error = remote_fileio_errno_to_host (errnum);
12377 if (host_error == -1)
12378 error (_("Unknown remote I/O error %d"), errnum);
12380 error (_("Remote I/O error: %s"), safe_strerror (host_error));
12383 /* A RAII wrapper around a remote file descriptor. */
12385 class scoped_remote_fd
12388 scoped_remote_fd (remote_target *remote, int fd)
12389 : m_remote (remote), m_fd (fd)
12393 ~scoped_remote_fd ()
12400 m_remote->remote_hostio_close (m_fd, &remote_errno);
12404 /* Swallow exception before it escapes the dtor. If
12405 something goes wrong, likely the connection is gone,
12406 and there's nothing else that can be done. */
12411 DISABLE_COPY_AND_ASSIGN (scoped_remote_fd);
12413 /* Release ownership of the file descriptor, and return it. */
12414 int release () noexcept
12421 /* Return the owned file descriptor. */
12422 int get () const noexcept
12428 /* The remote target. */
12429 remote_target *m_remote;
12431 /* The owned remote I/O file descriptor. */
12436 remote_file_put (const char *local_file, const char *remote_file, int from_tty)
12438 remote_target *remote = get_current_remote_target ();
12440 if (remote == nullptr)
12441 error (_("command can only be used with remote target"));
12443 remote->remote_file_put (local_file, remote_file, from_tty);
12447 remote_target::remote_file_put (const char *local_file, const char *remote_file,
12450 int retcode, remote_errno, bytes, io_size;
12451 int bytes_in_buffer;
12455 gdb_file_up file = gdb_fopen_cloexec (local_file, "rb");
12457 perror_with_name (local_file);
12459 scoped_remote_fd fd
12460 (this, remote_hostio_open (NULL,
12461 remote_file, (FILEIO_O_WRONLY | FILEIO_O_CREAT
12463 0700, 0, &remote_errno));
12464 if (fd.get () == -1)
12465 remote_hostio_error (remote_errno);
12467 /* Send up to this many bytes at once. They won't all fit in the
12468 remote packet limit, so we'll transfer slightly fewer. */
12469 io_size = get_remote_packet_size ();
12470 gdb::byte_vector buffer (io_size);
12472 bytes_in_buffer = 0;
12475 while (bytes_in_buffer || !saw_eof)
12479 bytes = fread (buffer.data () + bytes_in_buffer, 1,
12480 io_size - bytes_in_buffer,
12484 if (ferror (file.get ()))
12485 error (_("Error reading %s."), local_file);
12488 /* EOF. Unless there is something still in the
12489 buffer from the last iteration, we are done. */
12491 if (bytes_in_buffer == 0)
12499 bytes += bytes_in_buffer;
12500 bytes_in_buffer = 0;
12502 retcode = remote_hostio_pwrite (fd.get (), buffer.data (), bytes,
12503 offset, &remote_errno);
12506 remote_hostio_error (remote_errno);
12507 else if (retcode == 0)
12508 error (_("Remote write of %d bytes returned 0!"), bytes);
12509 else if (retcode < bytes)
12511 /* Short write. Save the rest of the read data for the next
12513 bytes_in_buffer = bytes - retcode;
12514 memmove (buffer.data (), buffer.data () + retcode, bytes_in_buffer);
12520 if (remote_hostio_close (fd.release (), &remote_errno))
12521 remote_hostio_error (remote_errno);
12524 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file);
12528 remote_file_get (const char *remote_file, const char *local_file, int from_tty)
12530 remote_target *remote = get_current_remote_target ();
12532 if (remote == nullptr)
12533 error (_("command can only be used with remote target"));
12535 remote->remote_file_get (remote_file, local_file, from_tty);
12539 remote_target::remote_file_get (const char *remote_file, const char *local_file,
12542 int remote_errno, bytes, io_size;
12545 scoped_remote_fd fd
12546 (this, remote_hostio_open (NULL,
12547 remote_file, FILEIO_O_RDONLY, 0, 0,
12549 if (fd.get () == -1)
12550 remote_hostio_error (remote_errno);
12552 gdb_file_up file = gdb_fopen_cloexec (local_file, "wb");
12554 perror_with_name (local_file);
12556 /* Send up to this many bytes at once. They won't all fit in the
12557 remote packet limit, so we'll transfer slightly fewer. */
12558 io_size = get_remote_packet_size ();
12559 gdb::byte_vector buffer (io_size);
12564 bytes = remote_hostio_pread (fd.get (), buffer.data (), io_size, offset,
12567 /* Success, but no bytes, means end-of-file. */
12570 remote_hostio_error (remote_errno);
12574 bytes = fwrite (buffer.data (), 1, bytes, file.get ());
12576 perror_with_name (local_file);
12579 if (remote_hostio_close (fd.release (), &remote_errno))
12580 remote_hostio_error (remote_errno);
12583 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file);
12587 remote_file_delete (const char *remote_file, int from_tty)
12589 remote_target *remote = get_current_remote_target ();
12591 if (remote == nullptr)
12592 error (_("command can only be used with remote target"));
12594 remote->remote_file_delete (remote_file, from_tty);
12598 remote_target::remote_file_delete (const char *remote_file, int from_tty)
12600 int retcode, remote_errno;
12602 retcode = remote_hostio_unlink (NULL, remote_file, &remote_errno);
12604 remote_hostio_error (remote_errno);
12607 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file);
12611 remote_put_command (const char *args, int from_tty)
12614 error_no_arg (_("file to put"));
12616 gdb_argv argv (args);
12617 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
12618 error (_("Invalid parameters to remote put"));
12620 remote_file_put (argv[0], argv[1], from_tty);
12624 remote_get_command (const char *args, int from_tty)
12627 error_no_arg (_("file to get"));
12629 gdb_argv argv (args);
12630 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
12631 error (_("Invalid parameters to remote get"));
12633 remote_file_get (argv[0], argv[1], from_tty);
12637 remote_delete_command (const char *args, int from_tty)
12640 error_no_arg (_("file to delete"));
12642 gdb_argv argv (args);
12643 if (argv[0] == NULL || argv[1] != NULL)
12644 error (_("Invalid parameters to remote delete"));
12646 remote_file_delete (argv[0], from_tty);
12650 remote_command (const char *args, int from_tty)
12652 help_list (remote_cmdlist, "remote ", all_commands, gdb_stdout);
12656 remote_target::can_execute_reverse ()
12658 if (packet_support (PACKET_bs) == PACKET_ENABLE
12659 || packet_support (PACKET_bc) == PACKET_ENABLE)
12666 remote_target::supports_non_stop ()
12672 remote_target::supports_disable_randomization ()
12674 /* Only supported in extended mode. */
12679 remote_target::supports_multi_process ()
12681 struct remote_state *rs = get_remote_state ();
12683 return remote_multi_process_p (rs);
12687 remote_supports_cond_tracepoints ()
12689 return packet_support (PACKET_ConditionalTracepoints) == PACKET_ENABLE;
12693 remote_target::supports_evaluation_of_breakpoint_conditions ()
12695 return packet_support (PACKET_ConditionalBreakpoints) == PACKET_ENABLE;
12699 remote_supports_fast_tracepoints ()
12701 return packet_support (PACKET_FastTracepoints) == PACKET_ENABLE;
12705 remote_supports_static_tracepoints ()
12707 return packet_support (PACKET_StaticTracepoints) == PACKET_ENABLE;
12711 remote_supports_install_in_trace ()
12713 return packet_support (PACKET_InstallInTrace) == PACKET_ENABLE;
12717 remote_target::supports_enable_disable_tracepoint ()
12719 return (packet_support (PACKET_EnableDisableTracepoints_feature)
12724 remote_target::supports_string_tracing ()
12726 return packet_support (PACKET_tracenz_feature) == PACKET_ENABLE;
12730 remote_target::can_run_breakpoint_commands ()
12732 return packet_support (PACKET_BreakpointCommands) == PACKET_ENABLE;
12736 remote_target::trace_init ()
12738 struct remote_state *rs = get_remote_state ();
12741 remote_get_noisy_reply ();
12742 if (strcmp (rs->buf.data (), "OK") != 0)
12743 error (_("Target does not support this command."));
12746 /* Recursive routine to walk through command list including loops, and
12747 download packets for each command. */
12750 remote_target::remote_download_command_source (int num, ULONGEST addr,
12751 struct command_line *cmds)
12753 struct remote_state *rs = get_remote_state ();
12754 struct command_line *cmd;
12756 for (cmd = cmds; cmd; cmd = cmd->next)
12758 QUIT; /* Allow user to bail out with ^C. */
12759 strcpy (rs->buf.data (), "QTDPsrc:");
12760 encode_source_string (num, addr, "cmd", cmd->line,
12761 rs->buf.data () + strlen (rs->buf.data ()),
12762 rs->buf.size () - strlen (rs->buf.data ()));
12764 remote_get_noisy_reply ();
12765 if (strcmp (rs->buf.data (), "OK"))
12766 warning (_("Target does not support source download."));
12768 if (cmd->control_type == while_control
12769 || cmd->control_type == while_stepping_control)
12771 remote_download_command_source (num, addr, cmd->body_list_0.get ());
12773 QUIT; /* Allow user to bail out with ^C. */
12774 strcpy (rs->buf.data (), "QTDPsrc:");
12775 encode_source_string (num, addr, "cmd", "end",
12776 rs->buf.data () + strlen (rs->buf.data ()),
12777 rs->buf.size () - strlen (rs->buf.data ()));
12779 remote_get_noisy_reply ();
12780 if (strcmp (rs->buf.data (), "OK"))
12781 warning (_("Target does not support source download."));
12787 remote_target::download_tracepoint (struct bp_location *loc)
12791 std::vector<std::string> tdp_actions;
12792 std::vector<std::string> stepping_actions;
12794 struct breakpoint *b = loc->owner;
12795 struct tracepoint *t = (struct tracepoint *) b;
12796 struct remote_state *rs = get_remote_state ();
12798 const char *err_msg = _("Tracepoint packet too large for target.");
12801 /* We use a buffer other than rs->buf because we'll build strings
12802 across multiple statements, and other statements in between could
12804 gdb::char_vector buf (get_remote_packet_size ());
12806 encode_actions_rsp (loc, &tdp_actions, &stepping_actions);
12808 tpaddr = loc->address;
12809 sprintf_vma (addrbuf, tpaddr);
12810 ret = snprintf (buf.data (), buf.size (), "QTDP:%x:%s:%c:%lx:%x",
12811 b->number, addrbuf, /* address */
12812 (b->enable_state == bp_enabled ? 'E' : 'D'),
12813 t->step_count, t->pass_count);
12815 if (ret < 0 || ret >= buf.size ())
12816 error ("%s", err_msg);
12818 /* Fast tracepoints are mostly handled by the target, but we can
12819 tell the target how big of an instruction block should be moved
12821 if (b->type == bp_fast_tracepoint)
12823 /* Only test for support at download time; we may not know
12824 target capabilities at definition time. */
12825 if (remote_supports_fast_tracepoints ())
12827 if (gdbarch_fast_tracepoint_valid_at (loc->gdbarch, tpaddr,
12830 size_left = buf.size () - strlen (buf.data ());
12831 ret = snprintf (buf.data () + strlen (buf.data ()),
12833 gdb_insn_length (loc->gdbarch, tpaddr));
12835 if (ret < 0 || ret >= size_left)
12836 error ("%s", err_msg);
12839 /* If it passed validation at definition but fails now,
12840 something is very wrong. */
12841 internal_error (__FILE__, __LINE__,
12842 _("Fast tracepoint not "
12843 "valid during download"));
12846 /* Fast tracepoints are functionally identical to regular
12847 tracepoints, so don't take lack of support as a reason to
12848 give up on the trace run. */
12849 warning (_("Target does not support fast tracepoints, "
12850 "downloading %d as regular tracepoint"), b->number);
12852 else if (b->type == bp_static_tracepoint)
12854 /* Only test for support at download time; we may not know
12855 target capabilities at definition time. */
12856 if (remote_supports_static_tracepoints ())
12858 struct static_tracepoint_marker marker;
12860 if (target_static_tracepoint_marker_at (tpaddr, &marker))
12862 size_left = buf.size () - strlen (buf.data ());
12863 ret = snprintf (buf.data () + strlen (buf.data ()),
12866 if (ret < 0 || ret >= size_left)
12867 error ("%s", err_msg);
12870 error (_("Static tracepoint not valid during download"));
12873 /* Fast tracepoints are functionally identical to regular
12874 tracepoints, so don't take lack of support as a reason
12875 to give up on the trace run. */
12876 error (_("Target does not support static tracepoints"));
12878 /* If the tracepoint has a conditional, make it into an agent
12879 expression and append to the definition. */
12882 /* Only test support at download time, we may not know target
12883 capabilities at definition time. */
12884 if (remote_supports_cond_tracepoints ())
12886 agent_expr_up aexpr = gen_eval_for_expr (tpaddr,
12889 size_left = buf.size () - strlen (buf.data ());
12891 ret = snprintf (buf.data () + strlen (buf.data ()),
12892 size_left, ":X%x,", aexpr->len);
12894 if (ret < 0 || ret >= size_left)
12895 error ("%s", err_msg);
12897 size_left = buf.size () - strlen (buf.data ());
12899 /* Two bytes to encode each aexpr byte, plus the terminating
12901 if (aexpr->len * 2 + 1 > size_left)
12902 error ("%s", err_msg);
12904 pkt = buf.data () + strlen (buf.data ());
12906 for (int ndx = 0; ndx < aexpr->len; ++ndx)
12907 pkt = pack_hex_byte (pkt, aexpr->buf[ndx]);
12911 warning (_("Target does not support conditional tracepoints, "
12912 "ignoring tp %d cond"), b->number);
12915 if (b->commands || *default_collect)
12917 size_left = buf.size () - strlen (buf.data ());
12919 ret = snprintf (buf.data () + strlen (buf.data ()),
12922 if (ret < 0 || ret >= size_left)
12923 error ("%s", err_msg);
12926 putpkt (buf.data ());
12927 remote_get_noisy_reply ();
12928 if (strcmp (rs->buf.data (), "OK"))
12929 error (_("Target does not support tracepoints."));
12931 /* do_single_steps (t); */
12932 for (auto action_it = tdp_actions.begin ();
12933 action_it != tdp_actions.end (); action_it++)
12935 QUIT; /* Allow user to bail out with ^C. */
12937 bool has_more = ((action_it + 1) != tdp_actions.end ()
12938 || !stepping_actions.empty ());
12940 ret = snprintf (buf.data (), buf.size (), "QTDP:-%x:%s:%s%c",
12941 b->number, addrbuf, /* address */
12942 action_it->c_str (),
12943 has_more ? '-' : 0);
12945 if (ret < 0 || ret >= buf.size ())
12946 error ("%s", err_msg);
12948 putpkt (buf.data ());
12949 remote_get_noisy_reply ();
12950 if (strcmp (rs->buf.data (), "OK"))
12951 error (_("Error on target while setting tracepoints."));
12954 for (auto action_it = stepping_actions.begin ();
12955 action_it != stepping_actions.end (); action_it++)
12957 QUIT; /* Allow user to bail out with ^C. */
12959 bool is_first = action_it == stepping_actions.begin ();
12960 bool has_more = (action_it + 1) != stepping_actions.end ();
12962 ret = snprintf (buf.data (), buf.size (), "QTDP:-%x:%s:%s%s%s",
12963 b->number, addrbuf, /* address */
12964 is_first ? "S" : "",
12965 action_it->c_str (),
12966 has_more ? "-" : "");
12968 if (ret < 0 || ret >= buf.size ())
12969 error ("%s", err_msg);
12971 putpkt (buf.data ());
12972 remote_get_noisy_reply ();
12973 if (strcmp (rs->buf.data (), "OK"))
12974 error (_("Error on target while setting tracepoints."));
12977 if (packet_support (PACKET_TracepointSource) == PACKET_ENABLE)
12979 if (b->location != NULL)
12981 ret = snprintf (buf.data (), buf.size (), "QTDPsrc:");
12983 if (ret < 0 || ret >= buf.size ())
12984 error ("%s", err_msg);
12986 encode_source_string (b->number, loc->address, "at",
12987 event_location_to_string (b->location.get ()),
12988 buf.data () + strlen (buf.data ()),
12989 buf.size () - strlen (buf.data ()));
12990 putpkt (buf.data ());
12991 remote_get_noisy_reply ();
12992 if (strcmp (rs->buf.data (), "OK"))
12993 warning (_("Target does not support source download."));
12995 if (b->cond_string)
12997 ret = snprintf (buf.data (), buf.size (), "QTDPsrc:");
12999 if (ret < 0 || ret >= buf.size ())
13000 error ("%s", err_msg);
13002 encode_source_string (b->number, loc->address,
13003 "cond", b->cond_string,
13004 buf.data () + strlen (buf.data ()),
13005 buf.size () - strlen (buf.data ()));
13006 putpkt (buf.data ());
13007 remote_get_noisy_reply ();
13008 if (strcmp (rs->buf.data (), "OK"))
13009 warning (_("Target does not support source download."));
13011 remote_download_command_source (b->number, loc->address,
13012 breakpoint_commands (b));
13017 remote_target::can_download_tracepoint ()
13019 struct remote_state *rs = get_remote_state ();
13020 struct trace_status *ts;
13023 /* Don't try to install tracepoints until we've relocated our
13024 symbols, and fetched and merged the target's tracepoint list with
13026 if (rs->starting_up)
13029 ts = current_trace_status ();
13030 status = get_trace_status (ts);
13032 if (status == -1 || !ts->running_known || !ts->running)
13035 /* If we are in a tracing experiment, but remote stub doesn't support
13036 installing tracepoint in trace, we have to return. */
13037 if (!remote_supports_install_in_trace ())
13045 remote_target::download_trace_state_variable (const trace_state_variable &tsv)
13047 struct remote_state *rs = get_remote_state ();
13050 xsnprintf (rs->buf.data (), get_remote_packet_size (), "QTDV:%x:%s:%x:",
13051 tsv.number, phex ((ULONGEST) tsv.initial_value, 8),
13053 p = rs->buf.data () + strlen (rs->buf.data ());
13054 if ((p - rs->buf.data ()) + tsv.name.length () * 2
13055 >= get_remote_packet_size ())
13056 error (_("Trace state variable name too long for tsv definition packet"));
13057 p += 2 * bin2hex ((gdb_byte *) (tsv.name.data ()), p, tsv.name.length ());
13060 remote_get_noisy_reply ();
13061 if (rs->buf[0] == '\0')
13062 error (_("Target does not support this command."));
13063 if (strcmp (rs->buf.data (), "OK") != 0)
13064 error (_("Error on target while downloading trace state variable."));
13068 remote_target::enable_tracepoint (struct bp_location *location)
13070 struct remote_state *rs = get_remote_state ();
13073 sprintf_vma (addr_buf, location->address);
13074 xsnprintf (rs->buf.data (), get_remote_packet_size (), "QTEnable:%x:%s",
13075 location->owner->number, addr_buf);
13077 remote_get_noisy_reply ();
13078 if (rs->buf[0] == '\0')
13079 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
13080 if (strcmp (rs->buf.data (), "OK") != 0)
13081 error (_("Error on target while enabling tracepoint."));
13085 remote_target::disable_tracepoint (struct bp_location *location)
13087 struct remote_state *rs = get_remote_state ();
13090 sprintf_vma (addr_buf, location->address);
13091 xsnprintf (rs->buf.data (), get_remote_packet_size (), "QTDisable:%x:%s",
13092 location->owner->number, addr_buf);
13094 remote_get_noisy_reply ();
13095 if (rs->buf[0] == '\0')
13096 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
13097 if (strcmp (rs->buf.data (), "OK") != 0)
13098 error (_("Error on target while disabling tracepoint."));
13102 remote_target::trace_set_readonly_regions ()
13106 bfd_size_type size;
13112 return; /* No information to give. */
13114 struct remote_state *rs = get_remote_state ();
13116 strcpy (rs->buf.data (), "QTro");
13117 offset = strlen (rs->buf.data ());
13118 for (s = exec_bfd->sections; s; s = s->next)
13120 char tmp1[40], tmp2[40];
13123 if ((s->flags & SEC_LOAD) == 0 ||
13124 /* (s->flags & SEC_CODE) == 0 || */
13125 (s->flags & SEC_READONLY) == 0)
13129 vma = bfd_get_section_vma (abfd, s);
13130 size = bfd_get_section_size (s);
13131 sprintf_vma (tmp1, vma);
13132 sprintf_vma (tmp2, vma + size);
13133 sec_length = 1 + strlen (tmp1) + 1 + strlen (tmp2);
13134 if (offset + sec_length + 1 > rs->buf.size ())
13136 if (packet_support (PACKET_qXfer_traceframe_info) != PACKET_ENABLE)
13138 Too many sections for read-only sections definition packet."));
13141 xsnprintf (rs->buf.data () + offset, rs->buf.size () - offset, ":%s,%s",
13143 offset += sec_length;
13148 getpkt (&rs->buf, 0);
13153 remote_target::trace_start ()
13155 struct remote_state *rs = get_remote_state ();
13157 putpkt ("QTStart");
13158 remote_get_noisy_reply ();
13159 if (rs->buf[0] == '\0')
13160 error (_("Target does not support this command."));
13161 if (strcmp (rs->buf.data (), "OK") != 0)
13162 error (_("Bogus reply from target: %s"), rs->buf.data ());
13166 remote_target::get_trace_status (struct trace_status *ts)
13168 /* Initialize it just to avoid a GCC false warning. */
13170 /* FIXME we need to get register block size some other way. */
13171 extern int trace_regblock_size;
13172 enum packet_result result;
13173 struct remote_state *rs = get_remote_state ();
13175 if (packet_support (PACKET_qTStatus) == PACKET_DISABLE)
13178 trace_regblock_size
13179 = rs->get_remote_arch_state (target_gdbarch ())->sizeof_g_packet;
13181 putpkt ("qTStatus");
13185 p = remote_get_noisy_reply ();
13187 CATCH (ex, RETURN_MASK_ERROR)
13189 if (ex.error != TARGET_CLOSE_ERROR)
13191 exception_fprintf (gdb_stderr, ex, "qTStatus: ");
13194 throw_exception (ex);
13198 result = packet_ok (p, &remote_protocol_packets[PACKET_qTStatus]);
13200 /* If the remote target doesn't do tracing, flag it. */
13201 if (result == PACKET_UNKNOWN)
13204 /* We're working with a live target. */
13205 ts->filename = NULL;
13208 error (_("Bogus trace status reply from target: %s"), rs->buf.data ());
13210 /* Function 'parse_trace_status' sets default value of each field of
13211 'ts' at first, so we don't have to do it here. */
13212 parse_trace_status (p, ts);
13214 return ts->running;
13218 remote_target::get_tracepoint_status (struct breakpoint *bp,
13219 struct uploaded_tp *utp)
13221 struct remote_state *rs = get_remote_state ();
13223 struct bp_location *loc;
13224 struct tracepoint *tp = (struct tracepoint *) bp;
13225 size_t size = get_remote_packet_size ();
13230 tp->traceframe_usage = 0;
13231 for (loc = tp->loc; loc; loc = loc->next)
13233 /* If the tracepoint was never downloaded, don't go asking for
13235 if (tp->number_on_target == 0)
13237 xsnprintf (rs->buf.data (), size, "qTP:%x:%s", tp->number_on_target,
13238 phex_nz (loc->address, 0));
13240 reply = remote_get_noisy_reply ();
13241 if (reply && *reply)
13244 parse_tracepoint_status (reply + 1, bp, utp);
13250 utp->hit_count = 0;
13251 utp->traceframe_usage = 0;
13252 xsnprintf (rs->buf.data (), size, "qTP:%x:%s", utp->number,
13253 phex_nz (utp->addr, 0));
13255 reply = remote_get_noisy_reply ();
13256 if (reply && *reply)
13259 parse_tracepoint_status (reply + 1, bp, utp);
13265 remote_target::trace_stop ()
13267 struct remote_state *rs = get_remote_state ();
13270 remote_get_noisy_reply ();
13271 if (rs->buf[0] == '\0')
13272 error (_("Target does not support this command."));
13273 if (strcmp (rs->buf.data (), "OK") != 0)
13274 error (_("Bogus reply from target: %s"), rs->buf.data ());
13278 remote_target::trace_find (enum trace_find_type type, int num,
13279 CORE_ADDR addr1, CORE_ADDR addr2,
13282 struct remote_state *rs = get_remote_state ();
13283 char *endbuf = rs->buf.data () + get_remote_packet_size ();
13285 int target_frameno = -1, target_tracept = -1;
13287 /* Lookups other than by absolute frame number depend on the current
13288 trace selected, so make sure it is correct on the remote end
13290 if (type != tfind_number)
13291 set_remote_traceframe ();
13293 p = rs->buf.data ();
13294 strcpy (p, "QTFrame:");
13295 p = strchr (p, '\0');
13299 xsnprintf (p, endbuf - p, "%x", num);
13302 xsnprintf (p, endbuf - p, "pc:%s", phex_nz (addr1, 0));
13305 xsnprintf (p, endbuf - p, "tdp:%x", num);
13308 xsnprintf (p, endbuf - p, "range:%s:%s", phex_nz (addr1, 0),
13309 phex_nz (addr2, 0));
13311 case tfind_outside:
13312 xsnprintf (p, endbuf - p, "outside:%s:%s", phex_nz (addr1, 0),
13313 phex_nz (addr2, 0));
13316 error (_("Unknown trace find type %d"), type);
13320 reply = remote_get_noisy_reply ();
13321 if (*reply == '\0')
13322 error (_("Target does not support this command."));
13324 while (reply && *reply)
13329 target_frameno = (int) strtol (p, &reply, 16);
13331 error (_("Unable to parse trace frame number"));
13332 /* Don't update our remote traceframe number cache on failure
13333 to select a remote traceframe. */
13334 if (target_frameno == -1)
13339 target_tracept = (int) strtol (p, &reply, 16);
13341 error (_("Unable to parse tracepoint number"));
13343 case 'O': /* "OK"? */
13344 if (reply[1] == 'K' && reply[2] == '\0')
13347 error (_("Bogus reply from target: %s"), reply);
13350 error (_("Bogus reply from target: %s"), reply);
13353 *tpp = target_tracept;
13355 rs->remote_traceframe_number = target_frameno;
13356 return target_frameno;
13360 remote_target::get_trace_state_variable_value (int tsvnum, LONGEST *val)
13362 struct remote_state *rs = get_remote_state ();
13366 set_remote_traceframe ();
13368 xsnprintf (rs->buf.data (), get_remote_packet_size (), "qTV:%x", tsvnum);
13370 reply = remote_get_noisy_reply ();
13371 if (reply && *reply)
13375 unpack_varlen_hex (reply + 1, &uval);
13376 *val = (LONGEST) uval;
13384 remote_target::save_trace_data (const char *filename)
13386 struct remote_state *rs = get_remote_state ();
13389 p = rs->buf.data ();
13390 strcpy (p, "QTSave:");
13392 if ((p - rs->buf.data ()) + strlen (filename) * 2
13393 >= get_remote_packet_size ())
13394 error (_("Remote file name too long for trace save packet"));
13395 p += 2 * bin2hex ((gdb_byte *) filename, p, strlen (filename));
13398 reply = remote_get_noisy_reply ();
13399 if (*reply == '\0')
13400 error (_("Target does not support this command."));
13401 if (strcmp (reply, "OK") != 0)
13402 error (_("Bogus reply from target: %s"), reply);
13406 /* This is basically a memory transfer, but needs to be its own packet
13407 because we don't know how the target actually organizes its trace
13408 memory, plus we want to be able to ask for as much as possible, but
13409 not be unhappy if we don't get as much as we ask for. */
13412 remote_target::get_raw_trace_data (gdb_byte *buf, ULONGEST offset, LONGEST len)
13414 struct remote_state *rs = get_remote_state ();
13419 p = rs->buf.data ();
13420 strcpy (p, "qTBuffer:");
13422 p += hexnumstr (p, offset);
13424 p += hexnumstr (p, len);
13428 reply = remote_get_noisy_reply ();
13429 if (reply && *reply)
13431 /* 'l' by itself means we're at the end of the buffer and
13432 there is nothing more to get. */
13436 /* Convert the reply into binary. Limit the number of bytes to
13437 convert according to our passed-in buffer size, rather than
13438 what was returned in the packet; if the target is
13439 unexpectedly generous and gives us a bigger reply than we
13440 asked for, we don't want to crash. */
13441 rslt = hex2bin (reply, buf, len);
13445 /* Something went wrong, flag as an error. */
13450 remote_target::set_disconnected_tracing (int val)
13452 struct remote_state *rs = get_remote_state ();
13454 if (packet_support (PACKET_DisconnectedTracing_feature) == PACKET_ENABLE)
13458 xsnprintf (rs->buf.data (), get_remote_packet_size (),
13459 "QTDisconnected:%x", val);
13461 reply = remote_get_noisy_reply ();
13462 if (*reply == '\0')
13463 error (_("Target does not support this command."));
13464 if (strcmp (reply, "OK") != 0)
13465 error (_("Bogus reply from target: %s"), reply);
13468 warning (_("Target does not support disconnected tracing."));
13472 remote_target::core_of_thread (ptid_t ptid)
13474 struct thread_info *info = find_thread_ptid (ptid);
13476 if (info != NULL && info->priv != NULL)
13477 return get_remote_thread_info (info)->core;
13483 remote_target::set_circular_trace_buffer (int val)
13485 struct remote_state *rs = get_remote_state ();
13488 xsnprintf (rs->buf.data (), get_remote_packet_size (),
13489 "QTBuffer:circular:%x", val);
13491 reply = remote_get_noisy_reply ();
13492 if (*reply == '\0')
13493 error (_("Target does not support this command."));
13494 if (strcmp (reply, "OK") != 0)
13495 error (_("Bogus reply from target: %s"), reply);
13499 remote_target::traceframe_info ()
13501 gdb::optional<gdb::char_vector> text
13502 = target_read_stralloc (current_top_target (), TARGET_OBJECT_TRACEFRAME_INFO,
13505 return parse_traceframe_info (text->data ());
13510 /* Handle the qTMinFTPILen packet. Returns the minimum length of
13511 instruction on which a fast tracepoint may be placed. Returns -1
13512 if the packet is not supported, and 0 if the minimum instruction
13513 length is unknown. */
13516 remote_target::get_min_fast_tracepoint_insn_len ()
13518 struct remote_state *rs = get_remote_state ();
13521 /* If we're not debugging a process yet, the IPA can't be
13523 if (!target_has_execution)
13526 /* Make sure the remote is pointing at the right process. */
13527 set_general_process ();
13529 xsnprintf (rs->buf.data (), get_remote_packet_size (), "qTMinFTPILen");
13531 reply = remote_get_noisy_reply ();
13532 if (*reply == '\0')
13536 ULONGEST min_insn_len;
13538 unpack_varlen_hex (reply, &min_insn_len);
13540 return (int) min_insn_len;
13545 remote_target::set_trace_buffer_size (LONGEST val)
13547 if (packet_support (PACKET_QTBuffer_size) != PACKET_DISABLE)
13549 struct remote_state *rs = get_remote_state ();
13550 char *buf = rs->buf.data ();
13551 char *endbuf = buf + get_remote_packet_size ();
13552 enum packet_result result;
13554 gdb_assert (val >= 0 || val == -1);
13555 buf += xsnprintf (buf, endbuf - buf, "QTBuffer:size:");
13556 /* Send -1 as literal "-1" to avoid host size dependency. */
13560 buf += hexnumstr (buf, (ULONGEST) -val);
13563 buf += hexnumstr (buf, (ULONGEST) val);
13566 remote_get_noisy_reply ();
13567 result = packet_ok (rs->buf,
13568 &remote_protocol_packets[PACKET_QTBuffer_size]);
13570 if (result != PACKET_OK)
13571 warning (_("Bogus reply from target: %s"), rs->buf.data ());
13576 remote_target::set_trace_notes (const char *user, const char *notes,
13577 const char *stop_notes)
13579 struct remote_state *rs = get_remote_state ();
13581 char *buf = rs->buf.data ();
13582 char *endbuf = buf + get_remote_packet_size ();
13585 buf += xsnprintf (buf, endbuf - buf, "QTNotes:");
13588 buf += xsnprintf (buf, endbuf - buf, "user:");
13589 nbytes = bin2hex ((gdb_byte *) user, buf, strlen (user));
13595 buf += xsnprintf (buf, endbuf - buf, "notes:");
13596 nbytes = bin2hex ((gdb_byte *) notes, buf, strlen (notes));
13602 buf += xsnprintf (buf, endbuf - buf, "tstop:");
13603 nbytes = bin2hex ((gdb_byte *) stop_notes, buf, strlen (stop_notes));
13607 /* Ensure the buffer is terminated. */
13611 reply = remote_get_noisy_reply ();
13612 if (*reply == '\0')
13615 if (strcmp (reply, "OK") != 0)
13616 error (_("Bogus reply from target: %s"), reply);
13622 remote_target::use_agent (bool use)
13624 if (packet_support (PACKET_QAgent) != PACKET_DISABLE)
13626 struct remote_state *rs = get_remote_state ();
13628 /* If the stub supports QAgent. */
13629 xsnprintf (rs->buf.data (), get_remote_packet_size (), "QAgent:%d", use);
13631 getpkt (&rs->buf, 0);
13633 if (strcmp (rs->buf.data (), "OK") == 0)
13644 remote_target::can_use_agent ()
13646 return (packet_support (PACKET_QAgent) != PACKET_DISABLE);
13649 struct btrace_target_info
13651 /* The ptid of the traced thread. */
13654 /* The obtained branch trace configuration. */
13655 struct btrace_config conf;
13658 /* Reset our idea of our target's btrace configuration. */
13661 remote_btrace_reset (remote_state *rs)
13663 memset (&rs->btrace_config, 0, sizeof (rs->btrace_config));
13666 /* Synchronize the configuration with the target. */
13669 remote_target::btrace_sync_conf (const btrace_config *conf)
13671 struct packet_config *packet;
13672 struct remote_state *rs;
13673 char *buf, *pos, *endbuf;
13675 rs = get_remote_state ();
13676 buf = rs->buf.data ();
13677 endbuf = buf + get_remote_packet_size ();
13679 packet = &remote_protocol_packets[PACKET_Qbtrace_conf_bts_size];
13680 if (packet_config_support (packet) == PACKET_ENABLE
13681 && conf->bts.size != rs->btrace_config.bts.size)
13684 pos += xsnprintf (pos, endbuf - pos, "%s=0x%x", packet->name,
13688 getpkt (&rs->buf, 0);
13690 if (packet_ok (buf, packet) == PACKET_ERROR)
13692 if (buf[0] == 'E' && buf[1] == '.')
13693 error (_("Failed to configure the BTS buffer size: %s"), buf + 2);
13695 error (_("Failed to configure the BTS buffer size."));
13698 rs->btrace_config.bts.size = conf->bts.size;
13701 packet = &remote_protocol_packets[PACKET_Qbtrace_conf_pt_size];
13702 if (packet_config_support (packet) == PACKET_ENABLE
13703 && conf->pt.size != rs->btrace_config.pt.size)
13706 pos += xsnprintf (pos, endbuf - pos, "%s=0x%x", packet->name,
13710 getpkt (&rs->buf, 0);
13712 if (packet_ok (buf, packet) == PACKET_ERROR)
13714 if (buf[0] == 'E' && buf[1] == '.')
13715 error (_("Failed to configure the trace buffer size: %s"), buf + 2);
13717 error (_("Failed to configure the trace buffer size."));
13720 rs->btrace_config.pt.size = conf->pt.size;
13724 /* Read the current thread's btrace configuration from the target and
13725 store it into CONF. */
13728 btrace_read_config (struct btrace_config *conf)
13730 gdb::optional<gdb::char_vector> xml
13731 = target_read_stralloc (current_top_target (), TARGET_OBJECT_BTRACE_CONF, "");
13733 parse_xml_btrace_conf (conf, xml->data ());
13736 /* Maybe reopen target btrace. */
13739 remote_target::remote_btrace_maybe_reopen ()
13741 struct remote_state *rs = get_remote_state ();
13742 int btrace_target_pushed = 0;
13743 #if !defined (HAVE_LIBIPT)
13747 scoped_restore_current_thread restore_thread;
13749 for (thread_info *tp : all_non_exited_threads ())
13751 set_general_thread (tp->ptid);
13753 memset (&rs->btrace_config, 0x00, sizeof (struct btrace_config));
13754 btrace_read_config (&rs->btrace_config);
13756 if (rs->btrace_config.format == BTRACE_FORMAT_NONE)
13759 #if !defined (HAVE_LIBIPT)
13760 if (rs->btrace_config.format == BTRACE_FORMAT_PT)
13765 warning (_("Target is recording using Intel Processor Trace "
13766 "but support was disabled at compile time."));
13771 #endif /* !defined (HAVE_LIBIPT) */
13773 /* Push target, once, but before anything else happens. This way our
13774 changes to the threads will be cleaned up by unpushing the target
13775 in case btrace_read_config () throws. */
13776 if (!btrace_target_pushed)
13778 btrace_target_pushed = 1;
13779 record_btrace_push_target ();
13780 printf_filtered (_("Target is recording using %s.\n"),
13781 btrace_format_string (rs->btrace_config.format));
13784 tp->btrace.target = XCNEW (struct btrace_target_info);
13785 tp->btrace.target->ptid = tp->ptid;
13786 tp->btrace.target->conf = rs->btrace_config;
13790 /* Enable branch tracing. */
13792 struct btrace_target_info *
13793 remote_target::enable_btrace (ptid_t ptid, const struct btrace_config *conf)
13795 struct btrace_target_info *tinfo = NULL;
13796 struct packet_config *packet = NULL;
13797 struct remote_state *rs = get_remote_state ();
13798 char *buf = rs->buf.data ();
13799 char *endbuf = buf + get_remote_packet_size ();
13801 switch (conf->format)
13803 case BTRACE_FORMAT_BTS:
13804 packet = &remote_protocol_packets[PACKET_Qbtrace_bts];
13807 case BTRACE_FORMAT_PT:
13808 packet = &remote_protocol_packets[PACKET_Qbtrace_pt];
13812 if (packet == NULL || packet_config_support (packet) != PACKET_ENABLE)
13813 error (_("Target does not support branch tracing."));
13815 btrace_sync_conf (conf);
13817 set_general_thread (ptid);
13819 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
13821 getpkt (&rs->buf, 0);
13823 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
13825 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
13826 error (_("Could not enable branch tracing for %s: %s"),
13827 target_pid_to_str (ptid), &rs->buf[2]);
13829 error (_("Could not enable branch tracing for %s."),
13830 target_pid_to_str (ptid));
13833 tinfo = XCNEW (struct btrace_target_info);
13834 tinfo->ptid = ptid;
13836 /* If we fail to read the configuration, we lose some information, but the
13837 tracing itself is not impacted. */
13840 btrace_read_config (&tinfo->conf);
13842 CATCH (err, RETURN_MASK_ERROR)
13844 if (err.message != NULL)
13845 warning ("%s", err.message);
13852 /* Disable branch tracing. */
13855 remote_target::disable_btrace (struct btrace_target_info *tinfo)
13857 struct packet_config *packet = &remote_protocol_packets[PACKET_Qbtrace_off];
13858 struct remote_state *rs = get_remote_state ();
13859 char *buf = rs->buf.data ();
13860 char *endbuf = buf + get_remote_packet_size ();
13862 if (packet_config_support (packet) != PACKET_ENABLE)
13863 error (_("Target does not support branch tracing."));
13865 set_general_thread (tinfo->ptid);
13867 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
13869 getpkt (&rs->buf, 0);
13871 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
13873 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
13874 error (_("Could not disable branch tracing for %s: %s"),
13875 target_pid_to_str (tinfo->ptid), &rs->buf[2]);
13877 error (_("Could not disable branch tracing for %s."),
13878 target_pid_to_str (tinfo->ptid));
13884 /* Teardown branch tracing. */
13887 remote_target::teardown_btrace (struct btrace_target_info *tinfo)
13889 /* We must not talk to the target during teardown. */
13893 /* Read the branch trace. */
13896 remote_target::read_btrace (struct btrace_data *btrace,
13897 struct btrace_target_info *tinfo,
13898 enum btrace_read_type type)
13900 struct packet_config *packet = &remote_protocol_packets[PACKET_qXfer_btrace];
13903 if (packet_config_support (packet) != PACKET_ENABLE)
13904 error (_("Target does not support branch tracing."));
13906 #if !defined(HAVE_LIBEXPAT)
13907 error (_("Cannot process branch tracing result. XML parsing not supported."));
13912 case BTRACE_READ_ALL:
13915 case BTRACE_READ_NEW:
13918 case BTRACE_READ_DELTA:
13922 internal_error (__FILE__, __LINE__,
13923 _("Bad branch tracing read type: %u."),
13924 (unsigned int) type);
13927 gdb::optional<gdb::char_vector> xml
13928 = target_read_stralloc (current_top_target (), TARGET_OBJECT_BTRACE, annex);
13930 return BTRACE_ERR_UNKNOWN;
13932 parse_xml_btrace (btrace, xml->data ());
13934 return BTRACE_ERR_NONE;
13937 const struct btrace_config *
13938 remote_target::btrace_conf (const struct btrace_target_info *tinfo)
13940 return &tinfo->conf;
13944 remote_target::augmented_libraries_svr4_read ()
13946 return (packet_support (PACKET_augmented_libraries_svr4_read_feature)
13950 /* Implementation of to_load. */
13953 remote_target::load (const char *name, int from_tty)
13955 generic_load (name, from_tty);
13958 /* Accepts an integer PID; returns a string representing a file that
13959 can be opened on the remote side to get the symbols for the child
13960 process. Returns NULL if the operation is not supported. */
13963 remote_target::pid_to_exec_file (int pid)
13965 static gdb::optional<gdb::char_vector> filename;
13966 struct inferior *inf;
13967 char *annex = NULL;
13969 if (packet_support (PACKET_qXfer_exec_file) != PACKET_ENABLE)
13972 inf = find_inferior_pid (pid);
13974 internal_error (__FILE__, __LINE__,
13975 _("not currently attached to process %d"), pid);
13977 if (!inf->fake_pid_p)
13979 const int annex_size = 9;
13981 annex = (char *) alloca (annex_size);
13982 xsnprintf (annex, annex_size, "%x", pid);
13985 filename = target_read_stralloc (current_top_target (),
13986 TARGET_OBJECT_EXEC_FILE, annex);
13988 return filename ? filename->data () : nullptr;
13991 /* Implement the to_can_do_single_step target_ops method. */
13994 remote_target::can_do_single_step ()
13996 /* We can only tell whether target supports single step or not by
13997 supported s and S vCont actions if the stub supports vContSupported
13998 feature. If the stub doesn't support vContSupported feature,
13999 we have conservatively to think target doesn't supports single
14001 if (packet_support (PACKET_vContSupported) == PACKET_ENABLE)
14003 struct remote_state *rs = get_remote_state ();
14005 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
14006 remote_vcont_probe ();
14008 return rs->supports_vCont.s && rs->supports_vCont.S;
14014 /* Implementation of the to_execution_direction method for the remote
14017 enum exec_direction_kind
14018 remote_target::execution_direction ()
14020 struct remote_state *rs = get_remote_state ();
14022 return rs->last_resume_exec_dir;
14025 /* Return pointer to the thread_info struct which corresponds to
14026 THREAD_HANDLE (having length HANDLE_LEN). */
14029 remote_target::thread_handle_to_thread_info (const gdb_byte *thread_handle,
14033 for (thread_info *tp : all_non_exited_threads ())
14035 remote_thread_info *priv = get_remote_thread_info (tp);
14037 if (tp->inf == inf && priv != NULL)
14039 if (handle_len != priv->thread_handle.size ())
14040 error (_("Thread handle size mismatch: %d vs %zu (from remote)"),
14041 handle_len, priv->thread_handle.size ());
14042 if (memcmp (thread_handle, priv->thread_handle.data (),
14052 remote_target::can_async_p ()
14054 struct remote_state *rs = get_remote_state ();
14056 /* We don't go async if the user has explicitly prevented it with the
14057 "maint set target-async" command. */
14058 if (!target_async_permitted)
14061 /* We're async whenever the serial device is. */
14062 return serial_can_async_p (rs->remote_desc);
14066 remote_target::is_async_p ()
14068 struct remote_state *rs = get_remote_state ();
14070 if (!target_async_permitted)
14071 /* We only enable async when the user specifically asks for it. */
14074 /* We're async whenever the serial device is. */
14075 return serial_is_async_p (rs->remote_desc);
14078 /* Pass the SERIAL event on and up to the client. One day this code
14079 will be able to delay notifying the client of an event until the
14080 point where an entire packet has been received. */
14082 static serial_event_ftype remote_async_serial_handler;
14085 remote_async_serial_handler (struct serial *scb, void *context)
14087 /* Don't propogate error information up to the client. Instead let
14088 the client find out about the error by querying the target. */
14089 inferior_event_handler (INF_REG_EVENT, NULL);
14093 remote_async_inferior_event_handler (gdb_client_data data)
14095 inferior_event_handler (INF_REG_EVENT, data);
14099 remote_target::async (int enable)
14101 struct remote_state *rs = get_remote_state ();
14105 serial_async (rs->remote_desc, remote_async_serial_handler, rs);
14107 /* If there are pending events in the stop reply queue tell the
14108 event loop to process them. */
14109 if (!rs->stop_reply_queue.empty ())
14110 mark_async_event_handler (rs->remote_async_inferior_event_token);
14111 /* For simplicity, below we clear the pending events token
14112 without remembering whether it is marked, so here we always
14113 mark it. If there's actually no pending notification to
14114 process, this ends up being a no-op (other than a spurious
14115 event-loop wakeup). */
14116 if (target_is_non_stop_p ())
14117 mark_async_event_handler (rs->notif_state->get_pending_events_token);
14121 serial_async (rs->remote_desc, NULL, NULL);
14122 /* If the core is disabling async, it doesn't want to be
14123 disturbed with target events. Clear all async event sources
14125 clear_async_event_handler (rs->remote_async_inferior_event_token);
14126 if (target_is_non_stop_p ())
14127 clear_async_event_handler (rs->notif_state->get_pending_events_token);
14131 /* Implementation of the to_thread_events method. */
14134 remote_target::thread_events (int enable)
14136 struct remote_state *rs = get_remote_state ();
14137 size_t size = get_remote_packet_size ();
14139 if (packet_support (PACKET_QThreadEvents) == PACKET_DISABLE)
14142 xsnprintf (rs->buf.data (), size, "QThreadEvents:%x", enable ? 1 : 0);
14144 getpkt (&rs->buf, 0);
14146 switch (packet_ok (rs->buf,
14147 &remote_protocol_packets[PACKET_QThreadEvents]))
14150 if (strcmp (rs->buf.data (), "OK") != 0)
14151 error (_("Remote refused setting thread events: %s"), rs->buf.data ());
14154 warning (_("Remote failure reply: %s"), rs->buf.data ());
14156 case PACKET_UNKNOWN:
14162 set_remote_cmd (const char *args, int from_tty)
14164 help_list (remote_set_cmdlist, "set remote ", all_commands, gdb_stdout);
14168 show_remote_cmd (const char *args, int from_tty)
14170 /* We can't just use cmd_show_list here, because we want to skip
14171 the redundant "show remote Z-packet" and the legacy aliases. */
14172 struct cmd_list_element *list = remote_show_cmdlist;
14173 struct ui_out *uiout = current_uiout;
14175 ui_out_emit_tuple tuple_emitter (uiout, "showlist");
14176 for (; list != NULL; list = list->next)
14177 if (strcmp (list->name, "Z-packet") == 0)
14179 else if (list->type == not_set_cmd)
14180 /* Alias commands are exactly like the original, except they
14181 don't have the normal type. */
14185 ui_out_emit_tuple option_emitter (uiout, "option");
14187 uiout->field_string ("name", list->name);
14188 uiout->text (": ");
14189 if (list->type == show_cmd)
14190 do_show_command (NULL, from_tty, list);
14192 cmd_func (list, NULL, from_tty);
14197 /* Function to be called whenever a new objfile (shlib) is detected. */
14199 remote_new_objfile (struct objfile *objfile)
14201 remote_target *remote = get_current_remote_target ();
14203 if (remote != NULL) /* Have a remote connection. */
14204 remote->remote_check_symbols ();
14207 /* Pull all the tracepoints defined on the target and create local
14208 data structures representing them. We don't want to create real
14209 tracepoints yet, we don't want to mess up the user's existing
14213 remote_target::upload_tracepoints (struct uploaded_tp **utpp)
14215 struct remote_state *rs = get_remote_state ();
14218 /* Ask for a first packet of tracepoint definition. */
14220 getpkt (&rs->buf, 0);
14221 p = rs->buf.data ();
14222 while (*p && *p != 'l')
14224 parse_tracepoint_definition (p, utpp);
14225 /* Ask for another packet of tracepoint definition. */
14227 getpkt (&rs->buf, 0);
14228 p = rs->buf.data ();
14234 remote_target::upload_trace_state_variables (struct uploaded_tsv **utsvp)
14236 struct remote_state *rs = get_remote_state ();
14239 /* Ask for a first packet of variable definition. */
14241 getpkt (&rs->buf, 0);
14242 p = rs->buf.data ();
14243 while (*p && *p != 'l')
14245 parse_tsv_definition (p, utsvp);
14246 /* Ask for another packet of variable definition. */
14248 getpkt (&rs->buf, 0);
14249 p = rs->buf.data ();
14254 /* The "set/show range-stepping" show hook. */
14257 show_range_stepping (struct ui_file *file, int from_tty,
14258 struct cmd_list_element *c,
14261 fprintf_filtered (file,
14262 _("Debugger's willingness to use range stepping "
14263 "is %s.\n"), value);
14266 /* Return true if the vCont;r action is supported by the remote
14270 remote_target::vcont_r_supported ()
14272 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
14273 remote_vcont_probe ();
14275 return (packet_support (PACKET_vCont) == PACKET_ENABLE
14276 && get_remote_state ()->supports_vCont.r);
14279 /* The "set/show range-stepping" set hook. */
14282 set_range_stepping (const char *ignore_args, int from_tty,
14283 struct cmd_list_element *c)
14285 /* When enabling, check whether range stepping is actually supported
14286 by the target, and warn if not. */
14287 if (use_range_stepping)
14289 remote_target *remote = get_current_remote_target ();
14291 || !remote->vcont_r_supported ())
14292 warning (_("Range stepping is not supported by the current target"));
14297 _initialize_remote (void)
14299 struct cmd_list_element *cmd;
14300 const char *cmd_name;
14302 /* architecture specific data */
14303 remote_g_packet_data_handle =
14304 gdbarch_data_register_pre_init (remote_g_packet_data_init);
14307 = register_program_space_data_with_cleanup (NULL,
14308 remote_pspace_data_cleanup);
14310 add_target (remote_target_info, remote_target::open);
14311 add_target (extended_remote_target_info, extended_remote_target::open);
14313 /* Hook into new objfile notification. */
14314 gdb::observers::new_objfile.attach (remote_new_objfile);
14317 init_remote_threadtests ();
14320 /* set/show remote ... */
14322 add_prefix_cmd ("remote", class_maintenance, set_remote_cmd, _("\
14323 Remote protocol specific variables\n\
14324 Configure various remote-protocol specific variables such as\n\
14325 the packets being used"),
14326 &remote_set_cmdlist, "set remote ",
14327 0 /* allow-unknown */, &setlist);
14328 add_prefix_cmd ("remote", class_maintenance, show_remote_cmd, _("\
14329 Remote protocol specific variables\n\
14330 Configure various remote-protocol specific variables such as\n\
14331 the packets being used"),
14332 &remote_show_cmdlist, "show remote ",
14333 0 /* allow-unknown */, &showlist);
14335 add_cmd ("compare-sections", class_obscure, compare_sections_command, _("\
14336 Compare section data on target to the exec file.\n\
14337 Argument is a single section name (default: all loaded sections).\n\
14338 To compare only read-only loaded sections, specify the -r option."),
14341 add_cmd ("packet", class_maintenance, packet_command, _("\
14342 Send an arbitrary packet to a remote target.\n\
14343 maintenance packet TEXT\n\
14344 If GDB is talking to an inferior via the GDB serial protocol, then\n\
14345 this command sends the string TEXT to the inferior, and displays the\n\
14346 response packet. GDB supplies the initial `$' character, and the\n\
14347 terminating `#' character and checksum."),
14350 add_setshow_boolean_cmd ("remotebreak", no_class, &remote_break, _("\
14351 Set whether to send break if interrupted."), _("\
14352 Show whether to send break if interrupted."), _("\
14353 If set, a break, instead of a cntrl-c, is sent to the remote target."),
14354 set_remotebreak, show_remotebreak,
14355 &setlist, &showlist);
14356 cmd_name = "remotebreak";
14357 cmd = lookup_cmd (&cmd_name, setlist, "", -1, 1);
14358 deprecate_cmd (cmd, "set remote interrupt-sequence");
14359 cmd_name = "remotebreak"; /* needed because lookup_cmd updates the pointer */
14360 cmd = lookup_cmd (&cmd_name, showlist, "", -1, 1);
14361 deprecate_cmd (cmd, "show remote interrupt-sequence");
14363 add_setshow_enum_cmd ("interrupt-sequence", class_support,
14364 interrupt_sequence_modes, &interrupt_sequence_mode,
14366 Set interrupt sequence to remote target."), _("\
14367 Show interrupt sequence to remote target."), _("\
14368 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
14369 NULL, show_interrupt_sequence,
14370 &remote_set_cmdlist,
14371 &remote_show_cmdlist);
14373 add_setshow_boolean_cmd ("interrupt-on-connect", class_support,
14374 &interrupt_on_connect, _("\
14375 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
14376 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
14377 If set, interrupt sequence is sent to remote target."),
14379 &remote_set_cmdlist, &remote_show_cmdlist);
14381 /* Install commands for configuring memory read/write packets. */
14383 add_cmd ("remotewritesize", no_class, set_memory_write_packet_size, _("\
14384 Set the maximum number of bytes per memory write packet (deprecated)."),
14386 add_cmd ("remotewritesize", no_class, show_memory_write_packet_size, _("\
14387 Show the maximum number of bytes per memory write packet (deprecated)."),
14389 add_cmd ("memory-write-packet-size", no_class,
14390 set_memory_write_packet_size, _("\
14391 Set the maximum number of bytes per memory-write packet.\n\
14392 Specify the number of bytes in a packet or 0 (zero) for the\n\
14393 default packet size. The actual limit is further reduced\n\
14394 dependent on the target. Specify ``fixed'' to disable the\n\
14395 further restriction and ``limit'' to enable that restriction."),
14396 &remote_set_cmdlist);
14397 add_cmd ("memory-read-packet-size", no_class,
14398 set_memory_read_packet_size, _("\
14399 Set the maximum number of bytes per memory-read packet.\n\
14400 Specify the number of bytes in a packet or 0 (zero) for the\n\
14401 default packet size. The actual limit is further reduced\n\
14402 dependent on the target. Specify ``fixed'' to disable the\n\
14403 further restriction and ``limit'' to enable that restriction."),
14404 &remote_set_cmdlist);
14405 add_cmd ("memory-write-packet-size", no_class,
14406 show_memory_write_packet_size,
14407 _("Show the maximum number of bytes per memory-write packet."),
14408 &remote_show_cmdlist);
14409 add_cmd ("memory-read-packet-size", no_class,
14410 show_memory_read_packet_size,
14411 _("Show the maximum number of bytes per memory-read packet."),
14412 &remote_show_cmdlist);
14414 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-limit", no_class,
14415 &remote_hw_watchpoint_limit, _("\
14416 Set the maximum number of target hardware watchpoints."), _("\
14417 Show the maximum number of target hardware watchpoints."), _("\
14418 Specify \"unlimited\" for unlimited hardware watchpoints."),
14419 NULL, show_hardware_watchpoint_limit,
14420 &remote_set_cmdlist,
14421 &remote_show_cmdlist);
14422 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-length-limit",
14424 &remote_hw_watchpoint_length_limit, _("\
14425 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
14426 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
14427 Specify \"unlimited\" to allow watchpoints of unlimited size."),
14428 NULL, show_hardware_watchpoint_length_limit,
14429 &remote_set_cmdlist, &remote_show_cmdlist);
14430 add_setshow_zuinteger_unlimited_cmd ("hardware-breakpoint-limit", no_class,
14431 &remote_hw_breakpoint_limit, _("\
14432 Set the maximum number of target hardware breakpoints."), _("\
14433 Show the maximum number of target hardware breakpoints."), _("\
14434 Specify \"unlimited\" for unlimited hardware breakpoints."),
14435 NULL, show_hardware_breakpoint_limit,
14436 &remote_set_cmdlist, &remote_show_cmdlist);
14438 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure,
14439 &remote_address_size, _("\
14440 Set the maximum size of the address (in bits) in a memory packet."), _("\
14441 Show the maximum size of the address (in bits) in a memory packet."), NULL,
14443 NULL, /* FIXME: i18n: */
14444 &setlist, &showlist);
14446 init_all_packet_configs ();
14448 add_packet_config_cmd (&remote_protocol_packets[PACKET_X],
14449 "X", "binary-download", 1);
14451 add_packet_config_cmd (&remote_protocol_packets[PACKET_vCont],
14452 "vCont", "verbose-resume", 0);
14454 add_packet_config_cmd (&remote_protocol_packets[PACKET_QPassSignals],
14455 "QPassSignals", "pass-signals", 0);
14457 add_packet_config_cmd (&remote_protocol_packets[PACKET_QCatchSyscalls],
14458 "QCatchSyscalls", "catch-syscalls", 0);
14460 add_packet_config_cmd (&remote_protocol_packets[PACKET_QProgramSignals],
14461 "QProgramSignals", "program-signals", 0);
14463 add_packet_config_cmd (&remote_protocol_packets[PACKET_QSetWorkingDir],
14464 "QSetWorkingDir", "set-working-dir", 0);
14466 add_packet_config_cmd (&remote_protocol_packets[PACKET_QStartupWithShell],
14467 "QStartupWithShell", "startup-with-shell", 0);
14469 add_packet_config_cmd (&remote_protocol_packets
14470 [PACKET_QEnvironmentHexEncoded],
14471 "QEnvironmentHexEncoded", "environment-hex-encoded",
14474 add_packet_config_cmd (&remote_protocol_packets[PACKET_QEnvironmentReset],
14475 "QEnvironmentReset", "environment-reset",
14478 add_packet_config_cmd (&remote_protocol_packets[PACKET_QEnvironmentUnset],
14479 "QEnvironmentUnset", "environment-unset",
14482 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSymbol],
14483 "qSymbol", "symbol-lookup", 0);
14485 add_packet_config_cmd (&remote_protocol_packets[PACKET_P],
14486 "P", "set-register", 1);
14488 add_packet_config_cmd (&remote_protocol_packets[PACKET_p],
14489 "p", "fetch-register", 1);
14491 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z0],
14492 "Z0", "software-breakpoint", 0);
14494 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z1],
14495 "Z1", "hardware-breakpoint", 0);
14497 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z2],
14498 "Z2", "write-watchpoint", 0);
14500 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z3],
14501 "Z3", "read-watchpoint", 0);
14503 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z4],
14504 "Z4", "access-watchpoint", 0);
14506 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_auxv],
14507 "qXfer:auxv:read", "read-aux-vector", 0);
14509 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_exec_file],
14510 "qXfer:exec-file:read", "pid-to-exec-file", 0);
14512 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_features],
14513 "qXfer:features:read", "target-features", 0);
14515 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries],
14516 "qXfer:libraries:read", "library-info", 0);
14518 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries_svr4],
14519 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
14521 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_memory_map],
14522 "qXfer:memory-map:read", "memory-map", 0);
14524 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_read],
14525 "qXfer:spu:read", "read-spu-object", 0);
14527 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_write],
14528 "qXfer:spu:write", "write-spu-object", 0);
14530 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_osdata],
14531 "qXfer:osdata:read", "osdata", 0);
14533 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_threads],
14534 "qXfer:threads:read", "threads", 0);
14536 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_read],
14537 "qXfer:siginfo:read", "read-siginfo-object", 0);
14539 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_write],
14540 "qXfer:siginfo:write", "write-siginfo-object", 0);
14542 add_packet_config_cmd
14543 (&remote_protocol_packets[PACKET_qXfer_traceframe_info],
14544 "qXfer:traceframe-info:read", "traceframe-info", 0);
14546 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_uib],
14547 "qXfer:uib:read", "unwind-info-block", 0);
14549 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTLSAddr],
14550 "qGetTLSAddr", "get-thread-local-storage-address",
14553 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTIBAddr],
14554 "qGetTIBAddr", "get-thread-information-block-address",
14557 add_packet_config_cmd (&remote_protocol_packets[PACKET_bc],
14558 "bc", "reverse-continue", 0);
14560 add_packet_config_cmd (&remote_protocol_packets[PACKET_bs],
14561 "bs", "reverse-step", 0);
14563 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSupported],
14564 "qSupported", "supported-packets", 0);
14566 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSearch_memory],
14567 "qSearch:memory", "search-memory", 0);
14569 add_packet_config_cmd (&remote_protocol_packets[PACKET_qTStatus],
14570 "qTStatus", "trace-status", 0);
14572 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_setfs],
14573 "vFile:setfs", "hostio-setfs", 0);
14575 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_open],
14576 "vFile:open", "hostio-open", 0);
14578 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pread],
14579 "vFile:pread", "hostio-pread", 0);
14581 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pwrite],
14582 "vFile:pwrite", "hostio-pwrite", 0);
14584 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_close],
14585 "vFile:close", "hostio-close", 0);
14587 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_unlink],
14588 "vFile:unlink", "hostio-unlink", 0);
14590 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_readlink],
14591 "vFile:readlink", "hostio-readlink", 0);
14593 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_fstat],
14594 "vFile:fstat", "hostio-fstat", 0);
14596 add_packet_config_cmd (&remote_protocol_packets[PACKET_vAttach],
14597 "vAttach", "attach", 0);
14599 add_packet_config_cmd (&remote_protocol_packets[PACKET_vRun],
14602 add_packet_config_cmd (&remote_protocol_packets[PACKET_QStartNoAckMode],
14603 "QStartNoAckMode", "noack", 0);
14605 add_packet_config_cmd (&remote_protocol_packets[PACKET_vKill],
14606 "vKill", "kill", 0);
14608 add_packet_config_cmd (&remote_protocol_packets[PACKET_qAttached],
14609 "qAttached", "query-attached", 0);
14611 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalTracepoints],
14612 "ConditionalTracepoints",
14613 "conditional-tracepoints", 0);
14615 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalBreakpoints],
14616 "ConditionalBreakpoints",
14617 "conditional-breakpoints", 0);
14619 add_packet_config_cmd (&remote_protocol_packets[PACKET_BreakpointCommands],
14620 "BreakpointCommands",
14621 "breakpoint-commands", 0);
14623 add_packet_config_cmd (&remote_protocol_packets[PACKET_FastTracepoints],
14624 "FastTracepoints", "fast-tracepoints", 0);
14626 add_packet_config_cmd (&remote_protocol_packets[PACKET_TracepointSource],
14627 "TracepointSource", "TracepointSource", 0);
14629 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAllow],
14630 "QAllow", "allow", 0);
14632 add_packet_config_cmd (&remote_protocol_packets[PACKET_StaticTracepoints],
14633 "StaticTracepoints", "static-tracepoints", 0);
14635 add_packet_config_cmd (&remote_protocol_packets[PACKET_InstallInTrace],
14636 "InstallInTrace", "install-in-trace", 0);
14638 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_statictrace_read],
14639 "qXfer:statictrace:read", "read-sdata-object", 0);
14641 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_fdpic],
14642 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
14644 add_packet_config_cmd (&remote_protocol_packets[PACKET_QDisableRandomization],
14645 "QDisableRandomization", "disable-randomization", 0);
14647 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAgent],
14648 "QAgent", "agent", 0);
14650 add_packet_config_cmd (&remote_protocol_packets[PACKET_QTBuffer_size],
14651 "QTBuffer:size", "trace-buffer-size", 0);
14653 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_off],
14654 "Qbtrace:off", "disable-btrace", 0);
14656 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_bts],
14657 "Qbtrace:bts", "enable-btrace-bts", 0);
14659 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_pt],
14660 "Qbtrace:pt", "enable-btrace-pt", 0);
14662 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace],
14663 "qXfer:btrace", "read-btrace", 0);
14665 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace_conf],
14666 "qXfer:btrace-conf", "read-btrace-conf", 0);
14668 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_conf_bts_size],
14669 "Qbtrace-conf:bts:size", "btrace-conf-bts-size", 0);
14671 add_packet_config_cmd (&remote_protocol_packets[PACKET_multiprocess_feature],
14672 "multiprocess-feature", "multiprocess-feature", 0);
14674 add_packet_config_cmd (&remote_protocol_packets[PACKET_swbreak_feature],
14675 "swbreak-feature", "swbreak-feature", 0);
14677 add_packet_config_cmd (&remote_protocol_packets[PACKET_hwbreak_feature],
14678 "hwbreak-feature", "hwbreak-feature", 0);
14680 add_packet_config_cmd (&remote_protocol_packets[PACKET_fork_event_feature],
14681 "fork-event-feature", "fork-event-feature", 0);
14683 add_packet_config_cmd (&remote_protocol_packets[PACKET_vfork_event_feature],
14684 "vfork-event-feature", "vfork-event-feature", 0);
14686 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_conf_pt_size],
14687 "Qbtrace-conf:pt:size", "btrace-conf-pt-size", 0);
14689 add_packet_config_cmd (&remote_protocol_packets[PACKET_vContSupported],
14690 "vContSupported", "verbose-resume-supported", 0);
14692 add_packet_config_cmd (&remote_protocol_packets[PACKET_exec_event_feature],
14693 "exec-event-feature", "exec-event-feature", 0);
14695 add_packet_config_cmd (&remote_protocol_packets[PACKET_vCtrlC],
14696 "vCtrlC", "ctrl-c", 0);
14698 add_packet_config_cmd (&remote_protocol_packets[PACKET_QThreadEvents],
14699 "QThreadEvents", "thread-events", 0);
14701 add_packet_config_cmd (&remote_protocol_packets[PACKET_no_resumed],
14702 "N stop reply", "no-resumed-stop-reply", 0);
14704 /* Assert that we've registered "set remote foo-packet" commands
14705 for all packet configs. */
14709 for (i = 0; i < PACKET_MAX; i++)
14711 /* Ideally all configs would have a command associated. Some
14712 still don't though. */
14717 case PACKET_QNonStop:
14718 case PACKET_EnableDisableTracepoints_feature:
14719 case PACKET_tracenz_feature:
14720 case PACKET_DisconnectedTracing_feature:
14721 case PACKET_augmented_libraries_svr4_read_feature:
14723 /* Additions to this list need to be well justified:
14724 pre-existing packets are OK; new packets are not. */
14732 /* This catches both forgetting to add a config command, and
14733 forgetting to remove a packet from the exception list. */
14734 gdb_assert (excepted == (remote_protocol_packets[i].name == NULL));
14738 /* Keep the old ``set remote Z-packet ...'' working. Each individual
14739 Z sub-packet has its own set and show commands, but users may
14740 have sets to this variable in their .gdbinit files (or in their
14742 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure,
14743 &remote_Z_packet_detect, _("\
14744 Set use of remote protocol `Z' packets"), _("\
14745 Show use of remote protocol `Z' packets "), _("\
14746 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
14748 set_remote_protocol_Z_packet_cmd,
14749 show_remote_protocol_Z_packet_cmd,
14750 /* FIXME: i18n: Use of remote protocol
14751 `Z' packets is %s. */
14752 &remote_set_cmdlist, &remote_show_cmdlist);
14754 add_prefix_cmd ("remote", class_files, remote_command, _("\
14755 Manipulate files on the remote system\n\
14756 Transfer files to and from the remote target system."),
14757 &remote_cmdlist, "remote ",
14758 0 /* allow-unknown */, &cmdlist);
14760 add_cmd ("put", class_files, remote_put_command,
14761 _("Copy a local file to the remote system."),
14764 add_cmd ("get", class_files, remote_get_command,
14765 _("Copy a remote file to the local system."),
14768 add_cmd ("delete", class_files, remote_delete_command,
14769 _("Delete a remote file."),
14772 add_setshow_string_noescape_cmd ("exec-file", class_files,
14773 &remote_exec_file_var, _("\
14774 Set the remote pathname for \"run\""), _("\
14775 Show the remote pathname for \"run\""), NULL,
14776 set_remote_exec_file,
14777 show_remote_exec_file,
14778 &remote_set_cmdlist,
14779 &remote_show_cmdlist);
14781 add_setshow_boolean_cmd ("range-stepping", class_run,
14782 &use_range_stepping, _("\
14783 Enable or disable range stepping."), _("\
14784 Show whether target-assisted range stepping is enabled."), _("\
14785 If on, and the target supports it, when stepping a source line, GDB\n\
14786 tells the target to step the corresponding range of addresses itself instead\n\
14787 of issuing multiple single-steps. This speeds up source level\n\
14788 stepping. If off, GDB always issues single-steps, even if range\n\
14789 stepping is supported by the target. The default is on."),
14790 set_range_stepping,
14791 show_range_stepping,
14795 /* Eventually initialize fileio. See fileio.c */
14796 initialize_remote_fileio (remote_set_cmdlist, remote_show_cmdlist);
14798 /* Take advantage of the fact that the TID field is not used, to tag
14799 special ptids with it set to != 0. */
14800 magic_null_ptid = ptid_t (42000, -1, 1);
14801 not_sent_ptid = ptid_t (42000, -2, 1);
14802 any_thread_ptid = ptid_t (42000, 0, 1);