1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2018 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 BUF_SIZE is always at least REMOTE_PACKET_SIZE;
250 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
255 /* True if we're going through initial connection setup (finding out
256 about the remote side's threads, relocating symbols, etc.). */
257 bool starting_up = false;
259 /* If we negotiated packet size explicitly (and thus can bypass
260 heuristics for the largest packet size that will not overflow
261 a buffer in the stub), this will be set to that packet size.
262 Otherwise zero, meaning to use the guessed size. */
263 long explicit_packet_size = 0;
265 /* remote_wait is normally called when the target is running and
266 waits for a stop reply packet. But sometimes we need to call it
267 when the target is already stopped. We can send a "?" packet
268 and have remote_wait read the response. Or, if we already have
269 the response, we can stash it in BUF and tell remote_wait to
270 skip calling getpkt. This flag is set when BUF contains a
271 stop reply packet and the target is not waiting. */
272 int cached_wait_status = 0;
274 /* True, if in no ack mode. That is, neither GDB nor the stub will
275 expect acks from each other. The connection is assumed to be
277 bool noack_mode = false;
279 /* True if we're connected in extended remote mode. */
280 bool extended = false;
282 /* True if we resumed the target and we're waiting for the target to
283 stop. In the mean time, we can't start another command/query.
284 The remote server wouldn't be ready to process it, so we'd
285 timeout waiting for a reply that would never come and eventually
286 we'd close the connection. This can happen in asynchronous mode
287 because we allow GDB commands while the target is running. */
288 bool waiting_for_stop_reply = false;
290 /* The status of the stub support for the various vCont actions. */
291 vCont_action_support supports_vCont;
293 /* True if the user has pressed Ctrl-C, but the target hasn't
294 responded to that. */
295 bool ctrlc_pending_p = false;
297 /* True if we saw a Ctrl-C while reading or writing from/to the
298 remote descriptor. At that point it is not safe to send a remote
299 interrupt packet, so we instead remember we saw the Ctrl-C and
300 process it once we're done with sending/receiving the current
301 packet, which should be shortly. If however that takes too long,
302 and the user presses Ctrl-C again, we offer to disconnect. */
303 bool got_ctrlc_during_io = false;
305 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
306 remote_open knows that we don't have a file open when the program
308 struct serial *remote_desc = nullptr;
310 /* These are the threads which we last sent to the remote system. The
311 TID member will be -1 for all or -2 for not sent yet. */
312 ptid_t general_thread = null_ptid;
313 ptid_t continue_thread = null_ptid;
315 /* This is the traceframe which we last selected on the remote system.
316 It will be -1 if no traceframe is selected. */
317 int remote_traceframe_number = -1;
319 char *last_pass_packet = nullptr;
321 /* The last QProgramSignals packet sent to the target. We bypass
322 sending a new program signals list down to the target if the new
323 packet is exactly the same as the last we sent. IOW, we only let
324 the target know about program signals list changes. */
325 char *last_program_signals_packet = nullptr;
327 gdb_signal last_sent_signal = GDB_SIGNAL_0;
329 bool last_sent_step = false;
331 /* The execution direction of the last resume we got. */
332 exec_direction_kind last_resume_exec_dir = EXEC_FORWARD;
334 char *finished_object = nullptr;
335 char *finished_annex = nullptr;
336 ULONGEST finished_offset = 0;
338 /* Should we try the 'ThreadInfo' query packet?
340 This variable (NOT available to the user: auto-detect only!)
341 determines whether GDB will use the new, simpler "ThreadInfo"
342 query or the older, more complex syntax for thread queries.
343 This is an auto-detect variable (set to true at each connect,
344 and set to false when the target fails to recognize it). */
345 bool use_threadinfo_query = false;
346 bool use_threadextra_query = false;
348 threadref echo_nextthread {};
349 threadref nextthread {};
350 threadref resultthreadlist[MAXTHREADLISTRESULTS] {};
352 /* The state of remote notification. */
353 struct remote_notif_state *notif_state = nullptr;
355 /* The branch trace configuration. */
356 struct btrace_config btrace_config {};
358 /* The argument to the last "vFile:setfs:" packet we sent, used
359 to avoid sending repeated unnecessary "vFile:setfs:" packets.
360 Initialized to -1 to indicate that no "vFile:setfs:" packet
361 has yet been sent. */
364 /* A readahead cache for vFile:pread. Often, reading a binary
365 involves a sequence of small reads. E.g., when parsing an ELF
366 file. A readahead cache helps mostly the case of remote
367 debugging on a connection with higher latency, due to the
368 request/reply nature of the RSP. We only cache data for a single
369 file descriptor at a time. */
370 struct readahead_cache readahead_cache;
372 /* The list of already fetched and acknowledged stop events. This
373 queue is used for notification Stop, and other notifications
374 don't need queue for their events, because the notification
375 events of Stop can't be consumed immediately, so that events
376 should be queued first, and be consumed by remote_wait_{ns,as}
377 one per time. Other notifications can consume their events
378 immediately, so queue is not needed for them. */
379 std::vector<stop_reply_up> stop_reply_queue;
381 /* Asynchronous signal handle registered as event loop source for
382 when we have pending events ready to be passed to the core. */
383 struct async_event_handler *remote_async_inferior_event_token = nullptr;
385 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
386 ``forever'' still use the normal timeout mechanism. This is
387 currently used by the ASYNC code to guarentee that target reads
388 during the initial connect always time-out. Once getpkt has been
389 modified to return a timeout indication and, in turn
390 remote_wait()/wait_for_inferior() have gained a timeout parameter
392 int wait_forever_enabled_p = 1;
395 /* Mapping of remote protocol data for each gdbarch. Usually there
396 is only one entry here, though we may see more with stubs that
397 support multi-process. */
398 std::unordered_map<struct gdbarch *, remote_arch_state>
402 static const target_info remote_target_info = {
404 N_("Remote serial target in gdb-specific protocol"),
408 class remote_target : public process_stratum_target
411 remote_target () = default;
412 ~remote_target () override;
414 const target_info &info () const override
415 { return remote_target_info; }
417 thread_control_capabilities get_thread_control_capabilities () override
418 { return tc_schedlock; }
420 /* Open a remote connection. */
421 static void open (const char *, int);
423 void close () override;
425 void detach (inferior *, int) override;
426 void disconnect (const char *, int) override;
428 void commit_resume () override;
429 void resume (ptid_t, int, enum gdb_signal) override;
430 ptid_t wait (ptid_t, struct target_waitstatus *, int) override;
432 void fetch_registers (struct regcache *, int) override;
433 void store_registers (struct regcache *, int) override;
434 void prepare_to_store (struct regcache *) override;
436 void files_info () override;
438 int insert_breakpoint (struct gdbarch *, struct bp_target_info *) override;
440 int remove_breakpoint (struct gdbarch *, struct bp_target_info *,
441 enum remove_bp_reason) override;
444 bool stopped_by_sw_breakpoint () override;
445 bool supports_stopped_by_sw_breakpoint () override;
447 bool stopped_by_hw_breakpoint () override;
449 bool supports_stopped_by_hw_breakpoint () override;
451 bool stopped_by_watchpoint () override;
453 bool stopped_data_address (CORE_ADDR *) override;
455 bool watchpoint_addr_within_range (CORE_ADDR, CORE_ADDR, int) override;
457 int can_use_hw_breakpoint (enum bptype, int, int) override;
459 int insert_hw_breakpoint (struct gdbarch *, struct bp_target_info *) override;
461 int remove_hw_breakpoint (struct gdbarch *, struct bp_target_info *) override;
463 int region_ok_for_hw_watchpoint (CORE_ADDR, int) override;
465 int insert_watchpoint (CORE_ADDR, int, enum target_hw_bp_type,
466 struct expression *) override;
468 int remove_watchpoint (CORE_ADDR, int, enum target_hw_bp_type,
469 struct expression *) override;
471 void kill () override;
473 void load (const char *, int) override;
475 void mourn_inferior () override;
477 void pass_signals (int, unsigned char *) override;
479 int set_syscall_catchpoint (int, bool, int,
480 gdb::array_view<const int>) override;
482 void program_signals (int, unsigned char *) override;
484 bool thread_alive (ptid_t ptid) override;
486 const char *thread_name (struct thread_info *) override;
488 void update_thread_list () override;
490 const char *pid_to_str (ptid_t) override;
492 const char *extra_thread_info (struct thread_info *) override;
494 ptid_t get_ada_task_ptid (long lwp, long thread) override;
496 thread_info *thread_handle_to_thread_info (const gdb_byte *thread_handle,
498 inferior *inf) override;
500 void stop (ptid_t) override;
502 void interrupt () override;
504 void pass_ctrlc () override;
506 enum target_xfer_status xfer_partial (enum target_object object,
509 const gdb_byte *writebuf,
510 ULONGEST offset, ULONGEST len,
511 ULONGEST *xfered_len) override;
513 ULONGEST get_memory_xfer_limit () override;
515 void rcmd (const char *command, struct ui_file *output) override;
517 char *pid_to_exec_file (int pid) override;
519 void log_command (const char *cmd) override
521 serial_log_command (this, cmd);
524 CORE_ADDR get_thread_local_address (ptid_t ptid,
525 CORE_ADDR load_module_addr,
526 CORE_ADDR offset) override;
528 bool has_all_memory () override { return default_child_has_all_memory (); }
529 bool has_memory () override { return default_child_has_memory (); }
530 bool has_stack () override { return default_child_has_stack (); }
531 bool has_registers () override { return default_child_has_registers (); }
532 bool has_execution (ptid_t ptid) override { return default_child_has_execution (ptid); }
534 bool can_execute_reverse () override;
536 std::vector<mem_region> memory_map () override;
538 void flash_erase (ULONGEST address, LONGEST length) override;
540 void flash_done () override;
542 const struct target_desc *read_description () override;
544 int search_memory (CORE_ADDR start_addr, ULONGEST search_space_len,
545 const gdb_byte *pattern, ULONGEST pattern_len,
546 CORE_ADDR *found_addrp) override;
548 bool can_async_p () override;
550 bool is_async_p () override;
552 void async (int) override;
554 void thread_events (int) override;
556 int can_do_single_step () override;
558 void terminal_inferior () override;
560 void terminal_ours () override;
562 bool supports_non_stop () override;
564 bool supports_multi_process () override;
566 bool supports_disable_randomization () override;
568 bool filesystem_is_local () override;
571 int fileio_open (struct inferior *inf, const char *filename,
572 int flags, int mode, int warn_if_slow,
573 int *target_errno) override;
575 int fileio_pwrite (int fd, const gdb_byte *write_buf, int len,
576 ULONGEST offset, int *target_errno) override;
578 int fileio_pread (int fd, gdb_byte *read_buf, int len,
579 ULONGEST offset, int *target_errno) override;
581 int fileio_fstat (int fd, struct stat *sb, int *target_errno) override;
583 int fileio_close (int fd, int *target_errno) override;
585 int fileio_unlink (struct inferior *inf,
586 const char *filename,
587 int *target_errno) override;
589 gdb::optional<std::string>
590 fileio_readlink (struct inferior *inf,
591 const char *filename,
592 int *target_errno) override;
594 bool supports_enable_disable_tracepoint () override;
596 bool supports_string_tracing () override;
598 bool supports_evaluation_of_breakpoint_conditions () override;
600 bool can_run_breakpoint_commands () override;
602 void trace_init () override;
604 void download_tracepoint (struct bp_location *location) override;
606 bool can_download_tracepoint () override;
608 void download_trace_state_variable (const trace_state_variable &tsv) override;
610 void enable_tracepoint (struct bp_location *location) override;
612 void disable_tracepoint (struct bp_location *location) override;
614 void trace_set_readonly_regions () override;
616 void trace_start () override;
618 int get_trace_status (struct trace_status *ts) override;
620 void get_tracepoint_status (struct breakpoint *tp, struct uploaded_tp *utp)
623 void trace_stop () override;
625 int trace_find (enum trace_find_type type, int num,
626 CORE_ADDR addr1, CORE_ADDR addr2, int *tpp) override;
628 bool get_trace_state_variable_value (int tsv, LONGEST *val) override;
630 int save_trace_data (const char *filename) override;
632 int upload_tracepoints (struct uploaded_tp **utpp) override;
634 int upload_trace_state_variables (struct uploaded_tsv **utsvp) override;
636 LONGEST get_raw_trace_data (gdb_byte *buf, ULONGEST offset, LONGEST len) override;
638 int get_min_fast_tracepoint_insn_len () override;
640 void set_disconnected_tracing (int val) override;
642 void set_circular_trace_buffer (int val) override;
644 void set_trace_buffer_size (LONGEST val) override;
646 bool set_trace_notes (const char *user, const char *notes,
647 const char *stopnotes) override;
649 int core_of_thread (ptid_t ptid) override;
651 int verify_memory (const gdb_byte *data,
652 CORE_ADDR memaddr, ULONGEST size) override;
655 bool get_tib_address (ptid_t ptid, CORE_ADDR *addr) override;
657 void set_permissions () override;
659 bool static_tracepoint_marker_at (CORE_ADDR,
660 struct static_tracepoint_marker *marker)
663 std::vector<static_tracepoint_marker>
664 static_tracepoint_markers_by_strid (const char *id) override;
666 traceframe_info_up traceframe_info () override;
668 bool use_agent (bool use) override;
669 bool can_use_agent () override;
671 struct btrace_target_info *enable_btrace (ptid_t ptid,
672 const struct btrace_config *conf) override;
674 void disable_btrace (struct btrace_target_info *tinfo) override;
676 void teardown_btrace (struct btrace_target_info *tinfo) override;
678 enum btrace_error read_btrace (struct btrace_data *data,
679 struct btrace_target_info *btinfo,
680 enum btrace_read_type type) override;
682 const struct btrace_config *btrace_conf (const struct btrace_target_info *) override;
683 bool augmented_libraries_svr4_read () override;
684 int follow_fork (int, int) override;
685 void follow_exec (struct inferior *, char *) override;
686 int insert_fork_catchpoint (int) override;
687 int remove_fork_catchpoint (int) override;
688 int insert_vfork_catchpoint (int) override;
689 int remove_vfork_catchpoint (int) override;
690 int insert_exec_catchpoint (int) override;
691 int remove_exec_catchpoint (int) override;
692 enum exec_direction_kind execution_direction () override;
694 public: /* Remote specific methods. */
696 void remote_download_command_source (int num, ULONGEST addr,
697 struct command_line *cmds);
699 void remote_file_put (const char *local_file, const char *remote_file,
701 void remote_file_get (const char *remote_file, const char *local_file,
703 void remote_file_delete (const char *remote_file, int from_tty);
705 int remote_hostio_pread (int fd, gdb_byte *read_buf, int len,
706 ULONGEST offset, int *remote_errno);
707 int remote_hostio_pwrite (int fd, const gdb_byte *write_buf, int len,
708 ULONGEST offset, int *remote_errno);
709 int remote_hostio_pread_vFile (int fd, gdb_byte *read_buf, int len,
710 ULONGEST offset, int *remote_errno);
712 int remote_hostio_send_command (int command_bytes, int which_packet,
713 int *remote_errno, char **attachment,
714 int *attachment_len);
715 int remote_hostio_set_filesystem (struct inferior *inf,
717 /* We should get rid of this and use fileio_open directly. */
718 int remote_hostio_open (struct inferior *inf, const char *filename,
719 int flags, int mode, int warn_if_slow,
721 int remote_hostio_close (int fd, int *remote_errno);
723 int remote_hostio_unlink (inferior *inf, const char *filename,
726 struct remote_state *get_remote_state ();
728 long get_remote_packet_size (void);
729 long get_memory_packet_size (struct memory_packet_config *config);
731 long get_memory_write_packet_size ();
732 long get_memory_read_packet_size ();
734 char *append_pending_thread_resumptions (char *p, char *endp,
736 static void open_1 (const char *name, int from_tty, int extended_p);
737 void start_remote (int from_tty, int extended_p);
738 void remote_detach_1 (struct inferior *inf, int from_tty);
740 char *append_resumption (char *p, char *endp,
741 ptid_t ptid, int step, gdb_signal siggnal);
742 int remote_resume_with_vcont (ptid_t ptid, int step,
745 void add_current_inferior_and_thread (char *wait_status);
747 ptid_t wait_ns (ptid_t ptid, struct target_waitstatus *status,
749 ptid_t wait_as (ptid_t ptid, target_waitstatus *status,
752 ptid_t process_stop_reply (struct stop_reply *stop_reply,
753 target_waitstatus *status);
755 void remote_notice_new_inferior (ptid_t currthread, int executing);
757 void process_initial_stop_replies (int from_tty);
759 thread_info *remote_add_thread (ptid_t ptid, bool running, bool executing);
761 void btrace_sync_conf (const btrace_config *conf);
763 void remote_btrace_maybe_reopen ();
765 void remove_new_fork_children (threads_listing_context *context);
766 void kill_new_fork_children (int pid);
767 void discard_pending_stop_replies (struct inferior *inf);
768 int stop_reply_queue_length ();
770 void check_pending_events_prevent_wildcard_vcont
771 (int *may_global_wildcard_vcont);
773 void discard_pending_stop_replies_in_queue ();
774 struct stop_reply *remote_notif_remove_queued_reply (ptid_t ptid);
775 struct stop_reply *queued_stop_reply (ptid_t ptid);
776 int peek_stop_reply (ptid_t ptid);
777 void remote_parse_stop_reply (char *buf, stop_reply *event);
779 void remote_stop_ns (ptid_t ptid);
780 void remote_interrupt_as ();
781 void remote_interrupt_ns ();
783 char *remote_get_noisy_reply ();
784 int remote_query_attached (int pid);
785 inferior *remote_add_inferior (int fake_pid_p, int pid, int attached,
788 ptid_t remote_current_thread (ptid_t oldpid);
789 ptid_t get_current_thread (char *wait_status);
791 void set_thread (ptid_t ptid, int gen);
792 void set_general_thread (ptid_t ptid);
793 void set_continue_thread (ptid_t ptid);
794 void set_general_process ();
796 char *write_ptid (char *buf, const char *endbuf, ptid_t ptid);
798 int remote_unpack_thread_info_response (char *pkt, threadref *expectedref,
799 gdb_ext_thread_info *info);
800 int remote_get_threadinfo (threadref *threadid, int fieldset,
801 gdb_ext_thread_info *info);
803 int parse_threadlist_response (char *pkt, int result_limit,
804 threadref *original_echo,
805 threadref *resultlist,
807 int remote_get_threadlist (int startflag, threadref *nextthread,
808 int result_limit, int *done, int *result_count,
809 threadref *threadlist);
811 int remote_threadlist_iterator (rmt_thread_action stepfunction,
812 void *context, int looplimit);
814 int remote_get_threads_with_ql (threads_listing_context *context);
815 int remote_get_threads_with_qxfer (threads_listing_context *context);
816 int remote_get_threads_with_qthreadinfo (threads_listing_context *context);
818 void extended_remote_restart ();
822 void remote_check_symbols ();
824 void remote_supported_packet (const struct protocol_feature *feature,
825 enum packet_support support,
826 const char *argument);
828 void remote_query_supported ();
830 void remote_packet_size (const protocol_feature *feature,
831 packet_support support, const char *value);
833 void remote_serial_quit_handler ();
835 void remote_detach_pid (int pid);
837 void remote_vcont_probe ();
839 void remote_resume_with_hc (ptid_t ptid, int step,
842 void send_interrupt_sequence ();
843 void interrupt_query ();
845 void remote_notif_get_pending_events (notif_client *nc);
847 int fetch_register_using_p (struct regcache *regcache,
849 int send_g_packet ();
850 void process_g_packet (struct regcache *regcache);
851 void fetch_registers_using_g (struct regcache *regcache);
852 int store_register_using_P (const struct regcache *regcache,
854 void store_registers_using_G (const struct regcache *regcache);
856 void set_remote_traceframe ();
858 void check_binary_download (CORE_ADDR addr);
860 target_xfer_status remote_write_bytes_aux (const char *header,
862 const gdb_byte *myaddr,
865 ULONGEST *xfered_len_units,
869 target_xfer_status remote_write_bytes (CORE_ADDR memaddr,
870 const gdb_byte *myaddr, ULONGEST len,
871 int unit_size, ULONGEST *xfered_len);
873 target_xfer_status remote_read_bytes_1 (CORE_ADDR memaddr, gdb_byte *myaddr,
875 int unit_size, ULONGEST *xfered_len_units);
877 target_xfer_status remote_xfer_live_readonly_partial (gdb_byte *readbuf,
881 ULONGEST *xfered_len);
883 target_xfer_status remote_read_bytes (CORE_ADDR memaddr,
884 gdb_byte *myaddr, ULONGEST len,
886 ULONGEST *xfered_len);
888 packet_result remote_send_printf (const char *format, ...)
889 ATTRIBUTE_PRINTF (2, 3);
891 target_xfer_status remote_flash_write (ULONGEST address,
892 ULONGEST length, ULONGEST *xfered_len,
893 const gdb_byte *data);
895 int readchar (int timeout);
897 void remote_serial_write (const char *str, int len);
899 int putpkt (const char *buf);
900 int putpkt_binary (const char *buf, int cnt);
903 long read_frame (char **buf_p, long *sizeof_buf);
904 void getpkt (char **buf, long *sizeof_buf, int forever);
905 int getpkt_or_notif_sane_1 (char **buf, long *sizeof_buf, int forever,
906 int expecting_notif, int *is_notif);
907 int getpkt_sane (char **buf, long *sizeof_buf, int forever);
908 int getpkt_or_notif_sane (char **buf, long *sizeof_buf, int forever,
910 int remote_vkill (int pid);
911 void remote_kill_k ();
913 void extended_remote_disable_randomization (int val);
914 int extended_remote_run (const std::string &args);
916 void send_environment_packet (const char *action,
920 void extended_remote_environment_support ();
921 void extended_remote_set_inferior_cwd ();
923 target_xfer_status remote_write_qxfer (const char *object_name,
925 const gdb_byte *writebuf,
926 ULONGEST offset, LONGEST len,
927 ULONGEST *xfered_len,
928 struct packet_config *packet);
930 target_xfer_status remote_read_qxfer (const char *object_name,
932 gdb_byte *readbuf, ULONGEST offset,
934 ULONGEST *xfered_len,
935 struct packet_config *packet);
937 void push_stop_reply (struct stop_reply *new_event);
939 bool vcont_r_supported ();
941 void packet_command (const char *args, int from_tty);
943 private: /* data fields */
945 /* The remote state. Don't reference this directly. Use the
946 get_remote_state method instead. */
947 remote_state m_remote_state;
950 static const target_info extended_remote_target_info = {
952 N_("Extended remote serial target in gdb-specific protocol"),
956 /* Set up the extended remote target by extending the standard remote
957 target and adding to it. */
959 class extended_remote_target final : public remote_target
962 const target_info &info () const override
963 { return extended_remote_target_info; }
965 /* Open an extended-remote connection. */
966 static void open (const char *, int);
968 bool can_create_inferior () override { return true; }
969 void create_inferior (const char *, const std::string &,
970 char **, int) override;
972 void detach (inferior *, int) override;
974 bool can_attach () override { return true; }
975 void attach (const char *, int) override;
977 void post_attach (int) override;
978 bool supports_disable_randomization () override;
981 /* Per-program-space data key. */
982 static const struct program_space_data *remote_pspace_data;
984 /* The variable registered as the control variable used by the
985 remote exec-file commands. While the remote exec-file setting is
986 per-program-space, the set/show machinery uses this as the
987 location of the remote exec-file value. */
988 static char *remote_exec_file_var;
990 /* The size to align memory write packets, when practical. The protocol
991 does not guarantee any alignment, and gdb will generate short
992 writes and unaligned writes, but even as a best-effort attempt this
993 can improve bulk transfers. For instance, if a write is misaligned
994 relative to the target's data bus, the stub may need to make an extra
995 round trip fetching data from the target. This doesn't make a
996 huge difference, but it's easy to do, so we try to be helpful.
998 The alignment chosen is arbitrary; usually data bus width is
999 important here, not the possibly larger cache line size. */
1000 enum { REMOTE_ALIGN_WRITES = 16 };
1002 /* Prototypes for local functions. */
1004 static int hexnumlen (ULONGEST num);
1006 static int stubhex (int ch);
1008 static int hexnumstr (char *, ULONGEST);
1010 static int hexnumnstr (char *, ULONGEST, int);
1012 static CORE_ADDR remote_address_masked (CORE_ADDR);
1014 static void print_packet (const char *);
1016 static int stub_unpack_int (char *buff, int fieldlength);
1018 struct packet_config;
1020 static void show_packet_config_cmd (struct packet_config *config);
1022 static void show_remote_protocol_packet_cmd (struct ui_file *file,
1024 struct cmd_list_element *c,
1027 static ptid_t read_ptid (const char *buf, const char **obuf);
1029 static void remote_async_inferior_event_handler (gdb_client_data);
1031 static bool remote_read_description_p (struct target_ops *target);
1033 static void remote_console_output (char *msg);
1035 static void remote_btrace_reset (remote_state *rs);
1037 static void remote_unpush_and_throw (void);
1041 static struct cmd_list_element *remote_cmdlist;
1043 /* For "set remote" and "show remote". */
1045 static struct cmd_list_element *remote_set_cmdlist;
1046 static struct cmd_list_element *remote_show_cmdlist;
1048 /* Controls whether GDB is willing to use range stepping. */
1050 static int use_range_stepping = 1;
1052 /* The max number of chars in debug output. The rest of chars are
1055 #define REMOTE_DEBUG_MAX_CHAR 512
1057 /* Private data that we'll store in (struct thread_info)->priv. */
1058 struct remote_thread_info : public private_thread_info
1064 /* Thread handle, perhaps a pthread_t or thread_t value, stored as a
1065 sequence of bytes. */
1066 gdb::byte_vector thread_handle;
1068 /* Whether the target stopped for a breakpoint/watchpoint. */
1069 enum target_stop_reason stop_reason = TARGET_STOPPED_BY_NO_REASON;
1071 /* This is set to the data address of the access causing the target
1072 to stop for a watchpoint. */
1073 CORE_ADDR watch_data_address = 0;
1075 /* Fields used by the vCont action coalescing implemented in
1076 remote_resume / remote_commit_resume. remote_resume stores each
1077 thread's last resume request in these fields, so that a later
1078 remote_commit_resume knows which is the proper action for this
1079 thread to include in the vCont packet. */
1081 /* True if the last target_resume call for this thread was a step
1082 request, false if a continue request. */
1083 int last_resume_step = 0;
1085 /* The signal specified in the last target_resume call for this
1087 gdb_signal last_resume_sig = GDB_SIGNAL_0;
1089 /* Whether this thread was already vCont-resumed on the remote
1091 int vcont_resumed = 0;
1094 remote_state::remote_state ()
1096 /* The default buffer size is unimportant; it will be expanded
1097 whenever a larger buffer is needed. */
1098 this->buf_size = 400;
1099 this->buf = (char *) xmalloc (this->buf_size);
1102 remote_state::~remote_state ()
1104 xfree (this->last_pass_packet);
1105 xfree (this->last_program_signals_packet);
1107 xfree (this->finished_object);
1108 xfree (this->finished_annex);
1111 /* Utility: generate error from an incoming stub packet. */
1113 trace_error (char *buf)
1116 return; /* not an error msg */
1119 case '1': /* malformed packet error */
1120 if (*++buf == '0') /* general case: */
1121 error (_("remote.c: error in outgoing packet."));
1123 error (_("remote.c: error in outgoing packet at field #%ld."),
1124 strtol (buf, NULL, 16));
1126 error (_("Target returns error code '%s'."), buf);
1130 /* Utility: wait for reply from stub, while accepting "O" packets. */
1133 remote_target::remote_get_noisy_reply ()
1135 struct remote_state *rs = get_remote_state ();
1137 do /* Loop on reply from remote stub. */
1141 QUIT; /* Allow user to bail out with ^C. */
1142 getpkt (&rs->buf, &rs->buf_size, 0);
1146 else if (startswith (buf, "qRelocInsn:"))
1149 CORE_ADDR from, to, org_to;
1151 int adjusted_size = 0;
1154 p = buf + strlen ("qRelocInsn:");
1155 pp = unpack_varlen_hex (p, &ul);
1157 error (_("invalid qRelocInsn packet: %s"), buf);
1161 unpack_varlen_hex (p, &ul);
1168 gdbarch_relocate_instruction (target_gdbarch (), &to, from);
1171 CATCH (ex, RETURN_MASK_ALL)
1173 if (ex.error == MEMORY_ERROR)
1175 /* Propagate memory errors silently back to the
1176 target. The stub may have limited the range of
1177 addresses we can write to, for example. */
1181 /* Something unexpectedly bad happened. Be verbose
1182 so we can tell what, and propagate the error back
1183 to the stub, so it doesn't get stuck waiting for
1185 exception_fprintf (gdb_stderr, ex,
1186 _("warning: relocating instruction: "));
1194 adjusted_size = to - org_to;
1196 xsnprintf (buf, rs->buf_size, "qRelocInsn:%x", adjusted_size);
1200 else if (buf[0] == 'O' && buf[1] != 'K')
1201 remote_console_output (buf + 1); /* 'O' message from stub */
1203 return buf; /* Here's the actual reply. */
1208 struct remote_arch_state *
1209 remote_state::get_remote_arch_state (struct gdbarch *gdbarch)
1211 remote_arch_state *rsa;
1213 auto it = this->m_arch_states.find (gdbarch);
1214 if (it == this->m_arch_states.end ())
1216 auto p = this->m_arch_states.emplace (std::piecewise_construct,
1217 std::forward_as_tuple (gdbarch),
1218 std::forward_as_tuple (gdbarch));
1219 rsa = &p.first->second;
1221 /* Make sure that the packet buffer is plenty big enough for
1222 this architecture. */
1223 if (this->buf_size < rsa->remote_packet_size)
1225 this->buf_size = 2 * rsa->remote_packet_size;
1226 this->buf = (char *) xrealloc (this->buf, this->buf_size);
1235 /* Fetch the global remote target state. */
1238 remote_target::get_remote_state ()
1240 /* Make sure that the remote architecture state has been
1241 initialized, because doing so might reallocate rs->buf. Any
1242 function which calls getpkt also needs to be mindful of changes
1243 to rs->buf, but this call limits the number of places which run
1245 m_remote_state.get_remote_arch_state (target_gdbarch ());
1247 return &m_remote_state;
1250 /* Cleanup routine for the remote module's pspace data. */
1253 remote_pspace_data_cleanup (struct program_space *pspace, void *arg)
1255 char *remote_exec_file = (char *) arg;
1257 xfree (remote_exec_file);
1260 /* Fetch the remote exec-file from the current program space. */
1263 get_remote_exec_file (void)
1265 char *remote_exec_file;
1268 = (char *) program_space_data (current_program_space,
1269 remote_pspace_data);
1270 if (remote_exec_file == NULL)
1273 return remote_exec_file;
1276 /* Set the remote exec file for PSPACE. */
1279 set_pspace_remote_exec_file (struct program_space *pspace,
1280 char *remote_exec_file)
1282 char *old_file = (char *) program_space_data (pspace, remote_pspace_data);
1285 set_program_space_data (pspace, remote_pspace_data,
1286 xstrdup (remote_exec_file));
1289 /* The "set/show remote exec-file" set command hook. */
1292 set_remote_exec_file (const char *ignored, int from_tty,
1293 struct cmd_list_element *c)
1295 gdb_assert (remote_exec_file_var != NULL);
1296 set_pspace_remote_exec_file (current_program_space, remote_exec_file_var);
1299 /* The "set/show remote exec-file" show command hook. */
1302 show_remote_exec_file (struct ui_file *file, int from_tty,
1303 struct cmd_list_element *cmd, const char *value)
1305 fprintf_filtered (file, "%s\n", remote_exec_file_var);
1309 compare_pnums (const void *lhs_, const void *rhs_)
1311 const struct packet_reg * const *lhs
1312 = (const struct packet_reg * const *) lhs_;
1313 const struct packet_reg * const *rhs
1314 = (const struct packet_reg * const *) rhs_;
1316 if ((*lhs)->pnum < (*rhs)->pnum)
1318 else if ((*lhs)->pnum == (*rhs)->pnum)
1325 map_regcache_remote_table (struct gdbarch *gdbarch, struct packet_reg *regs)
1327 int regnum, num_remote_regs, offset;
1328 struct packet_reg **remote_regs;
1330 for (regnum = 0; regnum < gdbarch_num_regs (gdbarch); regnum++)
1332 struct packet_reg *r = ®s[regnum];
1334 if (register_size (gdbarch, regnum) == 0)
1335 /* Do not try to fetch zero-sized (placeholder) registers. */
1338 r->pnum = gdbarch_remote_register_number (gdbarch, regnum);
1343 /* Define the g/G packet format as the contents of each register
1344 with a remote protocol number, in order of ascending protocol
1347 remote_regs = XALLOCAVEC (struct packet_reg *, gdbarch_num_regs (gdbarch));
1348 for (num_remote_regs = 0, regnum = 0;
1349 regnum < gdbarch_num_regs (gdbarch);
1351 if (regs[regnum].pnum != -1)
1352 remote_regs[num_remote_regs++] = ®s[regnum];
1354 qsort (remote_regs, num_remote_regs, sizeof (struct packet_reg *),
1357 for (regnum = 0, offset = 0; regnum < num_remote_regs; regnum++)
1359 remote_regs[regnum]->in_g_packet = 1;
1360 remote_regs[regnum]->offset = offset;
1361 offset += register_size (gdbarch, remote_regs[regnum]->regnum);
1367 /* Given the architecture described by GDBARCH, return the remote
1368 protocol register's number and the register's offset in the g/G
1369 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
1370 If the target does not have a mapping for REGNUM, return false,
1371 otherwise, return true. */
1374 remote_register_number_and_offset (struct gdbarch *gdbarch, int regnum,
1375 int *pnum, int *poffset)
1377 gdb_assert (regnum < gdbarch_num_regs (gdbarch));
1379 std::vector<packet_reg> regs (gdbarch_num_regs (gdbarch));
1381 map_regcache_remote_table (gdbarch, regs.data ());
1383 *pnum = regs[regnum].pnum;
1384 *poffset = regs[regnum].offset;
1389 remote_arch_state::remote_arch_state (struct gdbarch *gdbarch)
1391 /* Use the architecture to build a regnum<->pnum table, which will be
1392 1:1 unless a feature set specifies otherwise. */
1393 this->regs.reset (new packet_reg [gdbarch_num_regs (gdbarch)] ());
1395 /* Record the maximum possible size of the g packet - it may turn out
1397 this->sizeof_g_packet
1398 = map_regcache_remote_table (gdbarch, this->regs.get ());
1400 /* Default maximum number of characters in a packet body. Many
1401 remote stubs have a hardwired buffer size of 400 bytes
1402 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
1403 as the maximum packet-size to ensure that the packet and an extra
1404 NUL character can always fit in the buffer. This stops GDB
1405 trashing stubs that try to squeeze an extra NUL into what is
1406 already a full buffer (As of 1999-12-04 that was most stubs). */
1407 this->remote_packet_size = 400 - 1;
1409 /* This one is filled in when a ``g'' packet is received. */
1410 this->actual_register_packet_size = 0;
1412 /* Should rsa->sizeof_g_packet needs more space than the
1413 default, adjust the size accordingly. Remember that each byte is
1414 encoded as two characters. 32 is the overhead for the packet
1415 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
1416 (``$NN:G...#NN'') is a better guess, the below has been padded a
1418 if (this->sizeof_g_packet > ((this->remote_packet_size - 32) / 2))
1419 this->remote_packet_size = (this->sizeof_g_packet * 2 + 32);
1422 /* Get a pointer to the current remote target. If not connected to a
1423 remote target, return NULL. */
1425 static remote_target *
1426 get_current_remote_target ()
1428 target_ops *proc_target = find_target_at (process_stratum);
1429 return dynamic_cast<remote_target *> (proc_target);
1432 /* Return the current allowed size of a remote packet. This is
1433 inferred from the current architecture, and should be used to
1434 limit the length of outgoing packets. */
1436 remote_target::get_remote_packet_size ()
1438 struct remote_state *rs = get_remote_state ();
1439 remote_arch_state *rsa = rs->get_remote_arch_state (target_gdbarch ());
1441 if (rs->explicit_packet_size)
1442 return rs->explicit_packet_size;
1444 return rsa->remote_packet_size;
1447 static struct packet_reg *
1448 packet_reg_from_regnum (struct gdbarch *gdbarch, struct remote_arch_state *rsa,
1451 if (regnum < 0 && regnum >= gdbarch_num_regs (gdbarch))
1455 struct packet_reg *r = &rsa->regs[regnum];
1457 gdb_assert (r->regnum == regnum);
1462 static struct packet_reg *
1463 packet_reg_from_pnum (struct gdbarch *gdbarch, struct remote_arch_state *rsa,
1468 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
1470 struct packet_reg *r = &rsa->regs[i];
1472 if (r->pnum == pnum)
1478 /* Allow the user to specify what sequence to send to the remote
1479 when he requests a program interruption: Although ^C is usually
1480 what remote systems expect (this is the default, here), it is
1481 sometimes preferable to send a break. On other systems such
1482 as the Linux kernel, a break followed by g, which is Magic SysRq g
1483 is required in order to interrupt the execution. */
1484 const char interrupt_sequence_control_c[] = "Ctrl-C";
1485 const char interrupt_sequence_break[] = "BREAK";
1486 const char interrupt_sequence_break_g[] = "BREAK-g";
1487 static const char *const interrupt_sequence_modes[] =
1489 interrupt_sequence_control_c,
1490 interrupt_sequence_break,
1491 interrupt_sequence_break_g,
1494 static const char *interrupt_sequence_mode = interrupt_sequence_control_c;
1497 show_interrupt_sequence (struct ui_file *file, int from_tty,
1498 struct cmd_list_element *c,
1501 if (interrupt_sequence_mode == interrupt_sequence_control_c)
1502 fprintf_filtered (file,
1503 _("Send the ASCII ETX character (Ctrl-c) "
1504 "to the remote target to interrupt the "
1505 "execution of the program.\n"));
1506 else if (interrupt_sequence_mode == interrupt_sequence_break)
1507 fprintf_filtered (file,
1508 _("send a break signal to the remote target "
1509 "to interrupt the execution of the program.\n"));
1510 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
1511 fprintf_filtered (file,
1512 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
1513 "the remote target to interrupt the execution "
1514 "of Linux kernel.\n"));
1516 internal_error (__FILE__, __LINE__,
1517 _("Invalid value for interrupt_sequence_mode: %s."),
1518 interrupt_sequence_mode);
1521 /* This boolean variable specifies whether interrupt_sequence is sent
1522 to the remote target when gdb connects to it.
1523 This is mostly needed when you debug the Linux kernel: The Linux kernel
1524 expects BREAK g which is Magic SysRq g for connecting gdb. */
1525 static int interrupt_on_connect = 0;
1527 /* This variable is used to implement the "set/show remotebreak" commands.
1528 Since these commands are now deprecated in favor of "set/show remote
1529 interrupt-sequence", it no longer has any effect on the code. */
1530 static int remote_break;
1533 set_remotebreak (const char *args, int from_tty, struct cmd_list_element *c)
1536 interrupt_sequence_mode = interrupt_sequence_break;
1538 interrupt_sequence_mode = interrupt_sequence_control_c;
1542 show_remotebreak (struct ui_file *file, int from_tty,
1543 struct cmd_list_element *c,
1548 /* This variable sets the number of bits in an address that are to be
1549 sent in a memory ("M" or "m") packet. Normally, after stripping
1550 leading zeros, the entire address would be sent. This variable
1551 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
1552 initial implementation of remote.c restricted the address sent in
1553 memory packets to ``host::sizeof long'' bytes - (typically 32
1554 bits). Consequently, for 64 bit targets, the upper 32 bits of an
1555 address was never sent. Since fixing this bug may cause a break in
1556 some remote targets this variable is principly provided to
1557 facilitate backward compatibility. */
1559 static unsigned int remote_address_size;
1562 /* User configurable variables for the number of characters in a
1563 memory read/write packet. MIN (rsa->remote_packet_size,
1564 rsa->sizeof_g_packet) is the default. Some targets need smaller
1565 values (fifo overruns, et.al.) and some users need larger values
1566 (speed up transfers). The variables ``preferred_*'' (the user
1567 request), ``current_*'' (what was actually set) and ``forced_*''
1568 (Positive - a soft limit, negative - a hard limit). */
1570 struct memory_packet_config
1577 /* The default max memory-write-packet-size, when the setting is
1578 "fixed". The 16k is historical. (It came from older GDB's using
1579 alloca for buffers and the knowledge (folklore?) that some hosts
1580 don't cope very well with large alloca calls.) */
1581 #define DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED 16384
1583 /* The minimum remote packet size for memory transfers. Ensures we
1584 can write at least one byte. */
1585 #define MIN_MEMORY_PACKET_SIZE 20
1587 /* Get the memory packet size, assuming it is fixed. */
1590 get_fixed_memory_packet_size (struct memory_packet_config *config)
1592 gdb_assert (config->fixed_p);
1594 if (config->size <= 0)
1595 return DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED;
1597 return config->size;
1600 /* Compute the current size of a read/write packet. Since this makes
1601 use of ``actual_register_packet_size'' the computation is dynamic. */
1604 remote_target::get_memory_packet_size (struct memory_packet_config *config)
1606 struct remote_state *rs = get_remote_state ();
1607 remote_arch_state *rsa = rs->get_remote_arch_state (target_gdbarch ());
1610 if (config->fixed_p)
1611 what_they_get = get_fixed_memory_packet_size (config);
1614 what_they_get = get_remote_packet_size ();
1615 /* Limit the packet to the size specified by the user. */
1616 if (config->size > 0
1617 && what_they_get > config->size)
1618 what_they_get = config->size;
1620 /* Limit it to the size of the targets ``g'' response unless we have
1621 permission from the stub to use a larger packet size. */
1622 if (rs->explicit_packet_size == 0
1623 && rsa->actual_register_packet_size > 0
1624 && what_they_get > rsa->actual_register_packet_size)
1625 what_they_get = rsa->actual_register_packet_size;
1627 if (what_they_get < MIN_MEMORY_PACKET_SIZE)
1628 what_they_get = MIN_MEMORY_PACKET_SIZE;
1630 /* Make sure there is room in the global buffer for this packet
1631 (including its trailing NUL byte). */
1632 if (rs->buf_size < what_they_get + 1)
1634 rs->buf_size = 2 * what_they_get;
1635 rs->buf = (char *) xrealloc (rs->buf, 2 * what_they_get);
1638 return what_they_get;
1641 /* Update the size of a read/write packet. If they user wants
1642 something really big then do a sanity check. */
1645 set_memory_packet_size (const char *args, struct memory_packet_config *config)
1647 int fixed_p = config->fixed_p;
1648 long size = config->size;
1651 error (_("Argument required (integer, `fixed' or `limited')."));
1652 else if (strcmp (args, "hard") == 0
1653 || strcmp (args, "fixed") == 0)
1655 else if (strcmp (args, "soft") == 0
1656 || strcmp (args, "limit") == 0)
1662 size = strtoul (args, &end, 0);
1664 error (_("Invalid %s (bad syntax)."), config->name);
1666 /* Instead of explicitly capping the size of a packet to or
1667 disallowing it, the user is allowed to set the size to
1668 something arbitrarily large. */
1672 if (fixed_p && !config->fixed_p)
1674 /* So that the query shows the correct value. */
1675 long query_size = (size <= 0
1676 ? DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
1679 if (! query (_("The target may not be able to correctly handle a %s\n"
1680 "of %ld bytes. Change the packet size? "),
1681 config->name, query_size))
1682 error (_("Packet size not changed."));
1684 /* Update the config. */
1685 config->fixed_p = fixed_p;
1686 config->size = size;
1690 show_memory_packet_size (struct memory_packet_config *config)
1692 if (config->size == 0)
1693 printf_filtered (_("The %s is 0 (default). "), config->name);
1695 printf_filtered (_("The %s is %ld. "), config->name, config->size);
1696 if (config->fixed_p)
1697 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
1698 get_fixed_memory_packet_size (config));
1701 remote_target *remote = get_current_remote_target ();
1704 printf_filtered (_("Packets are limited to %ld bytes.\n"),
1705 remote->get_memory_packet_size (config));
1707 puts_filtered ("The actual limit will be further reduced "
1708 "dependent on the target.\n");
1712 static struct memory_packet_config memory_write_packet_config =
1714 "memory-write-packet-size",
1718 set_memory_write_packet_size (const char *args, int from_tty)
1720 set_memory_packet_size (args, &memory_write_packet_config);
1724 show_memory_write_packet_size (const char *args, int from_tty)
1726 show_memory_packet_size (&memory_write_packet_config);
1729 /* Show the number of hardware watchpoints that can be used. */
1732 show_hardware_watchpoint_limit (struct ui_file *file, int from_tty,
1733 struct cmd_list_element *c,
1736 fprintf_filtered (file, _("The maximum number of target hardware "
1737 "watchpoints is %s.\n"), value);
1740 /* Show the length limit (in bytes) for hardware watchpoints. */
1743 show_hardware_watchpoint_length_limit (struct ui_file *file, int from_tty,
1744 struct cmd_list_element *c,
1747 fprintf_filtered (file, _("The maximum length (in bytes) of a target "
1748 "hardware watchpoint is %s.\n"), value);
1751 /* Show the number of hardware breakpoints that can be used. */
1754 show_hardware_breakpoint_limit (struct ui_file *file, int from_tty,
1755 struct cmd_list_element *c,
1758 fprintf_filtered (file, _("The maximum number of target hardware "
1759 "breakpoints is %s.\n"), value);
1763 remote_target::get_memory_write_packet_size ()
1765 return get_memory_packet_size (&memory_write_packet_config);
1768 static struct memory_packet_config memory_read_packet_config =
1770 "memory-read-packet-size",
1774 set_memory_read_packet_size (const char *args, int from_tty)
1776 set_memory_packet_size (args, &memory_read_packet_config);
1780 show_memory_read_packet_size (const char *args, int from_tty)
1782 show_memory_packet_size (&memory_read_packet_config);
1786 remote_target::get_memory_read_packet_size ()
1788 long size = get_memory_packet_size (&memory_read_packet_config);
1790 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1791 extra buffer size argument before the memory read size can be
1792 increased beyond this. */
1793 if (size > get_remote_packet_size ())
1794 size = get_remote_packet_size ();
1800 struct packet_config
1805 /* If auto, GDB auto-detects support for this packet or feature,
1806 either through qSupported, or by trying the packet and looking
1807 at the response. If true, GDB assumes the target supports this
1808 packet. If false, the packet is disabled. Configs that don't
1809 have an associated command always have this set to auto. */
1810 enum auto_boolean detect;
1812 /* Does the target support this packet? */
1813 enum packet_support support;
1816 static enum packet_support packet_config_support (struct packet_config *config);
1817 static enum packet_support packet_support (int packet);
1820 show_packet_config_cmd (struct packet_config *config)
1822 const char *support = "internal-error";
1824 switch (packet_config_support (config))
1827 support = "enabled";
1829 case PACKET_DISABLE:
1830 support = "disabled";
1832 case PACKET_SUPPORT_UNKNOWN:
1833 support = "unknown";
1836 switch (config->detect)
1838 case AUTO_BOOLEAN_AUTO:
1839 printf_filtered (_("Support for the `%s' packet "
1840 "is auto-detected, currently %s.\n"),
1841 config->name, support);
1843 case AUTO_BOOLEAN_TRUE:
1844 case AUTO_BOOLEAN_FALSE:
1845 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1846 config->name, support);
1852 add_packet_config_cmd (struct packet_config *config, const char *name,
1853 const char *title, int legacy)
1859 config->name = name;
1860 config->title = title;
1861 set_doc = xstrprintf ("Set use of remote protocol `%s' (%s) packet",
1863 show_doc = xstrprintf ("Show current use of remote "
1864 "protocol `%s' (%s) packet",
1866 /* set/show TITLE-packet {auto,on,off} */
1867 cmd_name = xstrprintf ("%s-packet", title);
1868 add_setshow_auto_boolean_cmd (cmd_name, class_obscure,
1869 &config->detect, set_doc,
1870 show_doc, NULL, /* help_doc */
1872 show_remote_protocol_packet_cmd,
1873 &remote_set_cmdlist, &remote_show_cmdlist);
1874 /* The command code copies the documentation strings. */
1877 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1882 legacy_name = xstrprintf ("%s-packet", name);
1883 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1884 &remote_set_cmdlist);
1885 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1886 &remote_show_cmdlist);
1890 static enum packet_result
1891 packet_check_result (const char *buf)
1895 /* The stub recognized the packet request. Check that the
1896 operation succeeded. */
1898 && isxdigit (buf[1]) && isxdigit (buf[2])
1900 /* "Enn" - definitly an error. */
1901 return PACKET_ERROR;
1903 /* Always treat "E." as an error. This will be used for
1904 more verbose error messages, such as E.memtypes. */
1905 if (buf[0] == 'E' && buf[1] == '.')
1906 return PACKET_ERROR;
1908 /* The packet may or may not be OK. Just assume it is. */
1912 /* The stub does not support the packet. */
1913 return PACKET_UNKNOWN;
1916 static enum packet_result
1917 packet_ok (const char *buf, struct packet_config *config)
1919 enum packet_result result;
1921 if (config->detect != AUTO_BOOLEAN_TRUE
1922 && config->support == PACKET_DISABLE)
1923 internal_error (__FILE__, __LINE__,
1924 _("packet_ok: attempt to use a disabled packet"));
1926 result = packet_check_result (buf);
1931 /* The stub recognized the packet request. */
1932 if (config->support == PACKET_SUPPORT_UNKNOWN)
1935 fprintf_unfiltered (gdb_stdlog,
1936 "Packet %s (%s) is supported\n",
1937 config->name, config->title);
1938 config->support = PACKET_ENABLE;
1941 case PACKET_UNKNOWN:
1942 /* The stub does not support the packet. */
1943 if (config->detect == AUTO_BOOLEAN_AUTO
1944 && config->support == PACKET_ENABLE)
1946 /* If the stub previously indicated that the packet was
1947 supported then there is a protocol error. */
1948 error (_("Protocol error: %s (%s) conflicting enabled responses."),
1949 config->name, config->title);
1951 else if (config->detect == AUTO_BOOLEAN_TRUE)
1953 /* The user set it wrong. */
1954 error (_("Enabled packet %s (%s) not recognized by stub"),
1955 config->name, config->title);
1959 fprintf_unfiltered (gdb_stdlog,
1960 "Packet %s (%s) is NOT supported\n",
1961 config->name, config->title);
1962 config->support = PACKET_DISABLE;
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, size, "qAttached:%x", pid);
2330 xsnprintf (rs->buf, size, "qAttached");
2333 getpkt (&rs->buf, &rs->buf_size, 0);
2335 switch (packet_ok (rs->buf,
2336 &remote_protocol_packets[PACKET_qAttached]))
2339 if (strcmp (rs->buf, "1") == 0)
2343 warning (_("Remote failure reply: %s"), rs->buf);
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, 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, &rs->buf_size, 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, &rs->buf_size, 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, 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, &rs->buf_size, 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;
2746 char *endbuf = rs->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, &rs->buf_size, 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))
2840 endp = rs->buf + get_remote_packet_size ();
2843 write_ptid (p, endp, ptid);
2846 getpkt (&rs->buf, &rs->buf_size, 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, fieldset, threadid);
3346 getpkt (&rs->buf, &rs->buf_size, 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, startflag, result_limit, nextthread);
3420 getpkt (&rs->buf, &rs->buf_size, 0);
3421 if (*rs->buf == '\0')
3423 /* Packet not supported. */
3428 parse_threadlist_response (rs->buf + 2, result_limit,
3429 &rs->echo_nextthread, threadlist, done);
3431 if (!threadmatch (&rs->echo_nextthread, nextthread))
3433 /* FIXME: This is a good reason to drop the packet. */
3434 /* Possably, there is a duplicate response. */
3436 retransmit immediatly - race conditions
3437 retransmit after timeout - yes
3439 wait for packet, then exit
3441 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
3442 return 0; /* I choose simply exiting. */
3444 if (*result_count <= 0)
3448 warning (_("RMT ERROR : failed to get remote thread list."));
3451 return result; /* break; */
3453 if (*result_count > result_limit)
3456 warning (_("RMT ERROR: threadlist response longer than requested."));
3462 /* Fetch the list of remote threads, with the qL packet, and call
3463 STEPFUNCTION for each thread found. Stops iterating and returns 1
3464 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
3465 STEPFUNCTION returns false. If the packet is not supported,
3469 remote_target::remote_threadlist_iterator (rmt_thread_action stepfunction,
3470 void *context, int looplimit)
3472 struct remote_state *rs = get_remote_state ();
3473 int done, i, result_count;
3481 if (loopcount++ > looplimit)
3484 warning (_("Remote fetch threadlist -infinite loop-."));
3487 result = remote_get_threadlist (startflag, &rs->nextthread,
3488 MAXTHREADLISTRESULTS,
3489 &done, &result_count,
3490 rs->resultthreadlist);
3493 /* Clear for later iterations. */
3495 /* Setup to resume next batch of thread references, set nextthread. */
3496 if (result_count >= 1)
3497 copy_threadref (&rs->nextthread,
3498 &rs->resultthreadlist[result_count - 1]);
3500 while (result_count--)
3502 if (!(*stepfunction) (&rs->resultthreadlist[i++], context))
3512 /* A thread found on the remote target. */
3516 explicit thread_item (ptid_t ptid_)
3520 thread_item (thread_item &&other) = default;
3521 thread_item &operator= (thread_item &&other) = default;
3523 DISABLE_COPY_AND_ASSIGN (thread_item);
3525 /* The thread's PTID. */
3528 /* The thread's extra info. */
3531 /* The thread's name. */
3534 /* The core the thread was running on. -1 if not known. */
3537 /* The thread handle associated with the thread. */
3538 gdb::byte_vector thread_handle;
3541 /* Context passed around to the various methods listing remote
3542 threads. As new threads are found, they're added to the ITEMS
3545 struct threads_listing_context
3547 /* Return true if this object contains an entry for a thread with ptid
3550 bool contains_thread (ptid_t ptid) const
3552 auto match_ptid = [&] (const thread_item &item)
3554 return item.ptid == ptid;
3557 auto it = std::find_if (this->items.begin (),
3561 return it != this->items.end ();
3564 /* Remove the thread with ptid PTID. */
3566 void remove_thread (ptid_t ptid)
3568 auto match_ptid = [&] (const thread_item &item)
3570 return item.ptid == ptid;
3573 auto it = std::remove_if (this->items.begin (),
3577 if (it != this->items.end ())
3578 this->items.erase (it);
3581 /* The threads found on the remote target. */
3582 std::vector<thread_item> items;
3586 remote_newthread_step (threadref *ref, void *data)
3588 struct threads_listing_context *context
3589 = (struct threads_listing_context *) data;
3590 int pid = inferior_ptid.pid ();
3591 int lwp = threadref_to_int (ref);
3592 ptid_t ptid (pid, lwp);
3594 context->items.emplace_back (ptid);
3596 return 1; /* continue iterator */
3599 #define CRAZY_MAX_THREADS 1000
3602 remote_target::remote_current_thread (ptid_t oldpid)
3604 struct remote_state *rs = get_remote_state ();
3607 getpkt (&rs->buf, &rs->buf_size, 0);
3608 if (rs->buf[0] == 'Q' && rs->buf[1] == 'C')
3613 result = read_ptid (&rs->buf[2], &obuf);
3614 if (*obuf != '\0' && remote_debug)
3615 fprintf_unfiltered (gdb_stdlog,
3616 "warning: garbage in qC reply\n");
3624 /* List remote threads using the deprecated qL packet. */
3627 remote_target::remote_get_threads_with_ql (threads_listing_context *context)
3629 if (remote_threadlist_iterator (remote_newthread_step, context,
3630 CRAZY_MAX_THREADS) >= 0)
3636 #if defined(HAVE_LIBEXPAT)
3639 start_thread (struct gdb_xml_parser *parser,
3640 const struct gdb_xml_element *element,
3642 std::vector<gdb_xml_value> &attributes)
3644 struct threads_listing_context *data
3645 = (struct threads_listing_context *) user_data;
3646 struct gdb_xml_value *attr;
3648 char *id = (char *) xml_find_attribute (attributes, "id")->value.get ();
3649 ptid_t ptid = read_ptid (id, NULL);
3651 data->items.emplace_back (ptid);
3652 thread_item &item = data->items.back ();
3654 attr = xml_find_attribute (attributes, "core");
3656 item.core = *(ULONGEST *) attr->value.get ();
3658 attr = xml_find_attribute (attributes, "name");
3660 item.name = (const char *) attr->value.get ();
3662 attr = xml_find_attribute (attributes, "handle");
3664 item.thread_handle = hex2bin ((const char *) attr->value.get ());
3668 end_thread (struct gdb_xml_parser *parser,
3669 const struct gdb_xml_element *element,
3670 void *user_data, const char *body_text)
3672 struct threads_listing_context *data
3673 = (struct threads_listing_context *) user_data;
3675 if (body_text != NULL && *body_text != '\0')
3676 data->items.back ().extra = body_text;
3679 const struct gdb_xml_attribute thread_attributes[] = {
3680 { "id", GDB_XML_AF_NONE, NULL, NULL },
3681 { "core", GDB_XML_AF_OPTIONAL, gdb_xml_parse_attr_ulongest, NULL },
3682 { "name", GDB_XML_AF_OPTIONAL, NULL, NULL },
3683 { "handle", GDB_XML_AF_OPTIONAL, NULL, NULL },
3684 { NULL, GDB_XML_AF_NONE, NULL, NULL }
3687 const struct gdb_xml_element thread_children[] = {
3688 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3691 const struct gdb_xml_element threads_children[] = {
3692 { "thread", thread_attributes, thread_children,
3693 GDB_XML_EF_REPEATABLE | GDB_XML_EF_OPTIONAL,
3694 start_thread, end_thread },
3695 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3698 const struct gdb_xml_element threads_elements[] = {
3699 { "threads", NULL, threads_children,
3700 GDB_XML_EF_NONE, NULL, NULL },
3701 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3706 /* List remote threads using qXfer:threads:read. */
3709 remote_target::remote_get_threads_with_qxfer (threads_listing_context *context)
3711 #if defined(HAVE_LIBEXPAT)
3712 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
3714 gdb::optional<gdb::char_vector> xml
3715 = target_read_stralloc (this, TARGET_OBJECT_THREADS, NULL);
3717 if (xml && (*xml)[0] != '\0')
3719 gdb_xml_parse_quick (_("threads"), "threads.dtd",
3720 threads_elements, xml->data (), context);
3730 /* List remote threads using qfThreadInfo/qsThreadInfo. */
3733 remote_target::remote_get_threads_with_qthreadinfo (threads_listing_context *context)
3735 struct remote_state *rs = get_remote_state ();
3737 if (rs->use_threadinfo_query)
3741 putpkt ("qfThreadInfo");
3742 getpkt (&rs->buf, &rs->buf_size, 0);
3744 if (bufp[0] != '\0') /* q packet recognized */
3746 while (*bufp++ == 'm') /* reply contains one or more TID */
3750 ptid_t ptid = read_ptid (bufp, &bufp);
3751 context->items.emplace_back (ptid);
3753 while (*bufp++ == ','); /* comma-separated list */
3754 putpkt ("qsThreadInfo");
3755 getpkt (&rs->buf, &rs->buf_size, 0);
3762 /* Packet not recognized. */
3763 rs->use_threadinfo_query = 0;
3770 /* Implement the to_update_thread_list function for the remote
3774 remote_target::update_thread_list ()
3776 struct threads_listing_context context;
3779 /* We have a few different mechanisms to fetch the thread list. Try
3780 them all, starting with the most preferred one first, falling
3781 back to older methods. */
3782 if (remote_get_threads_with_qxfer (&context)
3783 || remote_get_threads_with_qthreadinfo (&context)
3784 || remote_get_threads_with_ql (&context))
3788 if (context.items.empty ()
3789 && remote_thread_always_alive (inferior_ptid))
3791 /* Some targets don't really support threads, but still
3792 reply an (empty) thread list in response to the thread
3793 listing packets, instead of replying "packet not
3794 supported". Exit early so we don't delete the main
3799 /* CONTEXT now holds the current thread list on the remote
3800 target end. Delete GDB-side threads no longer found on the
3802 for (thread_info *tp : all_threads_safe ())
3804 if (!context.contains_thread (tp->ptid))
3811 /* Remove any unreported fork child threads from CONTEXT so
3812 that we don't interfere with follow fork, which is where
3813 creation of such threads is handled. */
3814 remove_new_fork_children (&context);
3816 /* And now add threads we don't know about yet to our list. */
3817 for (thread_item &item : context.items)
3819 if (item.ptid != null_ptid)
3821 /* In non-stop mode, we assume new found threads are
3822 executing until proven otherwise with a stop reply.
3823 In all-stop, we can only get here if all threads are
3825 int executing = target_is_non_stop_p () ? 1 : 0;
3827 remote_notice_new_inferior (item.ptid, executing);
3829 thread_info *tp = find_thread_ptid (item.ptid);
3830 remote_thread_info *info = get_remote_thread_info (tp);
3831 info->core = item.core;
3832 info->extra = std::move (item.extra);
3833 info->name = std::move (item.name);
3834 info->thread_handle = std::move (item.thread_handle);
3841 /* If no thread listing method is supported, then query whether
3842 each known thread is alive, one by one, with the T packet.
3843 If the target doesn't support threads at all, then this is a
3844 no-op. See remote_thread_alive. */
3850 * Collect a descriptive string about the given thread.
3851 * The target may say anything it wants to about the thread
3852 * (typically info about its blocked / runnable state, name, etc.).
3853 * This string will appear in the info threads display.
3855 * Optional: targets are not required to implement this function.
3859 remote_target::extra_thread_info (thread_info *tp)
3861 struct remote_state *rs = get_remote_state ();
3864 struct gdb_ext_thread_info threadinfo;
3866 if (rs->remote_desc == 0) /* paranoia */
3867 internal_error (__FILE__, __LINE__,
3868 _("remote_threads_extra_info"));
3870 if (tp->ptid == magic_null_ptid
3871 || (tp->ptid.pid () != 0 && tp->ptid.lwp () == 0))
3872 /* This is the main thread which was added by GDB. The remote
3873 server doesn't know about it. */
3876 std::string &extra = get_remote_thread_info (tp)->extra;
3878 /* If already have cached info, use it. */
3879 if (!extra.empty ())
3880 return extra.c_str ();
3882 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
3884 /* If we're using qXfer:threads:read, then the extra info is
3885 included in the XML. So if we didn't have anything cached,
3886 it's because there's really no extra info. */
3890 if (rs->use_threadextra_query)
3893 char *endb = rs->buf + get_remote_packet_size ();
3895 xsnprintf (b, endb - b, "qThreadExtraInfo,");
3897 write_ptid (b, endb, tp->ptid);
3900 getpkt (&rs->buf, &rs->buf_size, 0);
3901 if (rs->buf[0] != 0)
3903 extra.resize (strlen (rs->buf) / 2);
3904 hex2bin (rs->buf, (gdb_byte *) &extra[0], extra.size ());
3905 return extra.c_str ();
3909 /* If the above query fails, fall back to the old method. */
3910 rs->use_threadextra_query = 0;
3911 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
3912 | TAG_MOREDISPLAY | TAG_DISPLAY;
3913 int_to_threadref (&id, tp->ptid.lwp ());
3914 if (remote_get_threadinfo (&id, set, &threadinfo))
3915 if (threadinfo.active)
3917 if (*threadinfo.shortname)
3918 string_appendf (extra, " Name: %s", threadinfo.shortname);
3919 if (*threadinfo.display)
3921 if (!extra.empty ())
3923 string_appendf (extra, " State: %s", threadinfo.display);
3925 if (*threadinfo.more_display)
3927 if (!extra.empty ())
3929 string_appendf (extra, " Priority: %s", threadinfo.more_display);
3931 return extra.c_str ();
3938 remote_target::static_tracepoint_marker_at (CORE_ADDR addr,
3939 struct static_tracepoint_marker *marker)
3941 struct remote_state *rs = get_remote_state ();
3944 xsnprintf (p, get_remote_packet_size (), "qTSTMat:");
3946 p += hexnumstr (p, addr);
3948 getpkt (&rs->buf, &rs->buf_size, 0);
3952 error (_("Remote failure reply: %s"), p);
3956 parse_static_tracepoint_marker_definition (p, NULL, marker);
3963 std::vector<static_tracepoint_marker>
3964 remote_target::static_tracepoint_markers_by_strid (const char *strid)
3966 struct remote_state *rs = get_remote_state ();
3967 std::vector<static_tracepoint_marker> markers;
3969 static_tracepoint_marker marker;
3971 /* Ask for a first packet of static tracepoint marker
3974 getpkt (&rs->buf, &rs->buf_size, 0);
3977 error (_("Remote failure reply: %s"), p);
3983 parse_static_tracepoint_marker_definition (p, &p, &marker);
3985 if (strid == NULL || marker.str_id == strid)
3986 markers.push_back (std::move (marker));
3988 while (*p++ == ','); /* comma-separated list */
3989 /* Ask for another packet of static tracepoint definition. */
3991 getpkt (&rs->buf, &rs->buf_size, 0);
3999 /* Implement the to_get_ada_task_ptid function for the remote targets. */
4002 remote_target::get_ada_task_ptid (long lwp, long thread)
4004 return ptid_t (inferior_ptid.pid (), lwp, 0);
4008 /* Restart the remote side; this is an extended protocol operation. */
4011 remote_target::extended_remote_restart ()
4013 struct remote_state *rs = get_remote_state ();
4015 /* Send the restart command; for reasons I don't understand the
4016 remote side really expects a number after the "R". */
4017 xsnprintf (rs->buf, get_remote_packet_size (), "R%x", 0);
4020 remote_fileio_reset ();
4023 /* Clean up connection to a remote debugger. */
4026 remote_target::close ()
4028 /* Make sure we leave stdin registered in the event loop. */
4031 /* We don't have a connection to the remote stub anymore. Get rid
4032 of all the inferiors and their threads we were controlling.
4033 Reset inferior_ptid to null_ptid first, as otherwise has_stack_frame
4034 will be unable to find the thread corresponding to (pid, 0, 0). */
4035 inferior_ptid = null_ptid;
4036 discard_all_inferiors ();
4038 trace_reset_local_state ();
4043 remote_target::~remote_target ()
4045 struct remote_state *rs = get_remote_state ();
4047 /* Check for NULL because we may get here with a partially
4048 constructed target/connection. */
4049 if (rs->remote_desc == nullptr)
4052 serial_close (rs->remote_desc);
4054 /* We are destroying the remote target, so we should discard
4055 everything of this target. */
4056 discard_pending_stop_replies_in_queue ();
4058 if (rs->remote_async_inferior_event_token)
4059 delete_async_event_handler (&rs->remote_async_inferior_event_token);
4061 remote_notif_state_xfree (rs->notif_state);
4064 /* Query the remote side for the text, data and bss offsets. */
4067 remote_target::get_offsets ()
4069 struct remote_state *rs = get_remote_state ();
4072 int lose, num_segments = 0, do_sections, do_segments;
4073 CORE_ADDR text_addr, data_addr, bss_addr, segments[2];
4074 struct section_offsets *offs;
4075 struct symfile_segment_data *data;
4077 if (symfile_objfile == NULL)
4080 putpkt ("qOffsets");
4081 getpkt (&rs->buf, &rs->buf_size, 0);
4084 if (buf[0] == '\000')
4085 return; /* Return silently. Stub doesn't support
4089 warning (_("Remote failure reply: %s"), buf);
4093 /* Pick up each field in turn. This used to be done with scanf, but
4094 scanf will make trouble if CORE_ADDR size doesn't match
4095 conversion directives correctly. The following code will work
4096 with any size of CORE_ADDR. */
4097 text_addr = data_addr = bss_addr = 0;
4101 if (startswith (ptr, "Text="))
4104 /* Don't use strtol, could lose on big values. */
4105 while (*ptr && *ptr != ';')
4106 text_addr = (text_addr << 4) + fromhex (*ptr++);
4108 if (startswith (ptr, ";Data="))
4111 while (*ptr && *ptr != ';')
4112 data_addr = (data_addr << 4) + fromhex (*ptr++);
4117 if (!lose && startswith (ptr, ";Bss="))
4120 while (*ptr && *ptr != ';')
4121 bss_addr = (bss_addr << 4) + fromhex (*ptr++);
4123 if (bss_addr != data_addr)
4124 warning (_("Target reported unsupported offsets: %s"), buf);
4129 else if (startswith (ptr, "TextSeg="))
4132 /* Don't use strtol, could lose on big values. */
4133 while (*ptr && *ptr != ';')
4134 text_addr = (text_addr << 4) + fromhex (*ptr++);
4137 if (startswith (ptr, ";DataSeg="))
4140 while (*ptr && *ptr != ';')
4141 data_addr = (data_addr << 4) + fromhex (*ptr++);
4149 error (_("Malformed response to offset query, %s"), buf);
4150 else if (*ptr != '\0')
4151 warning (_("Target reported unsupported offsets: %s"), buf);
4153 offs = ((struct section_offsets *)
4154 alloca (SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections)));
4155 memcpy (offs, symfile_objfile->section_offsets,
4156 SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections));
4158 data = get_symfile_segment_data (symfile_objfile->obfd);
4159 do_segments = (data != NULL);
4160 do_sections = num_segments == 0;
4162 if (num_segments > 0)
4164 segments[0] = text_addr;
4165 segments[1] = data_addr;
4167 /* If we have two segments, we can still try to relocate everything
4168 by assuming that the .text and .data offsets apply to the whole
4169 text and data segments. Convert the offsets given in the packet
4170 to base addresses for symfile_map_offsets_to_segments. */
4171 else if (data && data->num_segments == 2)
4173 segments[0] = data->segment_bases[0] + text_addr;
4174 segments[1] = data->segment_bases[1] + data_addr;
4177 /* If the object file has only one segment, assume that it is text
4178 rather than data; main programs with no writable data are rare,
4179 but programs with no code are useless. Of course the code might
4180 have ended up in the data segment... to detect that we would need
4181 the permissions here. */
4182 else if (data && data->num_segments == 1)
4184 segments[0] = data->segment_bases[0] + text_addr;
4187 /* There's no way to relocate by segment. */
4193 int ret = symfile_map_offsets_to_segments (symfile_objfile->obfd, data,
4194 offs, num_segments, segments);
4196 if (ret == 0 && !do_sections)
4197 error (_("Can not handle qOffsets TextSeg "
4198 "response with this symbol file"));
4205 free_symfile_segment_data (data);
4209 offs->offsets[SECT_OFF_TEXT (symfile_objfile)] = text_addr;
4211 /* This is a temporary kludge to force data and bss to use the
4212 same offsets because that's what nlmconv does now. The real
4213 solution requires changes to the stub and remote.c that I
4214 don't have time to do right now. */
4216 offs->offsets[SECT_OFF_DATA (symfile_objfile)] = data_addr;
4217 offs->offsets[SECT_OFF_BSS (symfile_objfile)] = data_addr;
4220 objfile_relocate (symfile_objfile, offs);
4223 /* Send interrupt_sequence to remote target. */
4226 remote_target::send_interrupt_sequence ()
4228 struct remote_state *rs = get_remote_state ();
4230 if (interrupt_sequence_mode == interrupt_sequence_control_c)
4231 remote_serial_write ("\x03", 1);
4232 else if (interrupt_sequence_mode == interrupt_sequence_break)
4233 serial_send_break (rs->remote_desc);
4234 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
4236 serial_send_break (rs->remote_desc);
4237 remote_serial_write ("g", 1);
4240 internal_error (__FILE__, __LINE__,
4241 _("Invalid value for interrupt_sequence_mode: %s."),
4242 interrupt_sequence_mode);
4246 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
4247 and extract the PTID. Returns NULL_PTID if not found. */
4250 stop_reply_extract_thread (char *stop_reply)
4252 if (stop_reply[0] == 'T' && strlen (stop_reply) > 3)
4256 /* Txx r:val ; r:val (...) */
4259 /* Look for "register" named "thread". */
4264 p1 = strchr (p, ':');
4268 if (strncmp (p, "thread", p1 - p) == 0)
4269 return read_ptid (++p1, &p);
4271 p1 = strchr (p, ';');
4283 /* Determine the remote side's current thread. If we have a stop
4284 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
4285 "thread" register we can extract the current thread from. If not,
4286 ask the remote which is the current thread with qC. The former
4287 method avoids a roundtrip. */
4290 remote_target::get_current_thread (char *wait_status)
4292 ptid_t ptid = null_ptid;
4294 /* Note we don't use remote_parse_stop_reply as that makes use of
4295 the target architecture, which we haven't yet fully determined at
4297 if (wait_status != NULL)
4298 ptid = stop_reply_extract_thread (wait_status);
4299 if (ptid == null_ptid)
4300 ptid = remote_current_thread (inferior_ptid);
4305 /* Query the remote target for which is the current thread/process,
4306 add it to our tables, and update INFERIOR_PTID. The caller is
4307 responsible for setting the state such that the remote end is ready
4308 to return the current thread.
4310 This function is called after handling the '?' or 'vRun' packets,
4311 whose response is a stop reply from which we can also try
4312 extracting the thread. If the target doesn't support the explicit
4313 qC query, we infer the current thread from that stop reply, passed
4314 in in WAIT_STATUS, which may be NULL. */
4317 remote_target::add_current_inferior_and_thread (char *wait_status)
4319 struct remote_state *rs = get_remote_state ();
4322 inferior_ptid = null_ptid;
4324 /* Now, if we have thread information, update inferior_ptid. */
4325 ptid_t curr_ptid = get_current_thread (wait_status);
4327 if (curr_ptid != null_ptid)
4329 if (!remote_multi_process_p (rs))
4334 /* Without this, some commands which require an active target
4335 (such as kill) won't work. This variable serves (at least)
4336 double duty as both the pid of the target process (if it has
4337 such), and as a flag indicating that a target is active. */
4338 curr_ptid = magic_null_ptid;
4342 remote_add_inferior (fake_pid_p, curr_ptid.pid (), -1, 1);
4344 /* Add the main thread and switch to it. Don't try reading
4345 registers yet, since we haven't fetched the target description
4347 thread_info *tp = add_thread_silent (curr_ptid);
4348 switch_to_thread_no_regs (tp);
4351 /* Print info about a thread that was found already stopped on
4355 print_one_stopped_thread (struct thread_info *thread)
4357 struct target_waitstatus *ws = &thread->suspend.waitstatus;
4359 switch_to_thread (thread);
4360 thread->suspend.stop_pc = get_frame_pc (get_current_frame ());
4361 set_current_sal_from_frame (get_current_frame ());
4363 thread->suspend.waitstatus_pending_p = 0;
4365 if (ws->kind == TARGET_WAITKIND_STOPPED)
4367 enum gdb_signal sig = ws->value.sig;
4369 if (signal_print_state (sig))
4370 gdb::observers::signal_received.notify (sig);
4372 gdb::observers::normal_stop.notify (NULL, 1);
4375 /* Process all initial stop replies the remote side sent in response
4376 to the ? packet. These indicate threads that were already stopped
4377 on initial connection. We mark these threads as stopped and print
4378 their current frame before giving the user the prompt. */
4381 remote_target::process_initial_stop_replies (int from_tty)
4383 int pending_stop_replies = stop_reply_queue_length ();
4384 struct thread_info *selected = NULL;
4385 struct thread_info *lowest_stopped = NULL;
4386 struct thread_info *first = NULL;
4388 /* Consume the initial pending events. */
4389 while (pending_stop_replies-- > 0)
4391 ptid_t waiton_ptid = minus_one_ptid;
4393 struct target_waitstatus ws;
4394 int ignore_event = 0;
4396 memset (&ws, 0, sizeof (ws));
4397 event_ptid = target_wait (waiton_ptid, &ws, TARGET_WNOHANG);
4399 print_target_wait_results (waiton_ptid, event_ptid, &ws);
4403 case TARGET_WAITKIND_IGNORE:
4404 case TARGET_WAITKIND_NO_RESUMED:
4405 case TARGET_WAITKIND_SIGNALLED:
4406 case TARGET_WAITKIND_EXITED:
4407 /* We shouldn't see these, but if we do, just ignore. */
4409 fprintf_unfiltered (gdb_stdlog, "remote: event ignored\n");
4413 case TARGET_WAITKIND_EXECD:
4414 xfree (ws.value.execd_pathname);
4423 struct thread_info *evthread = find_thread_ptid (event_ptid);
4425 if (ws.kind == TARGET_WAITKIND_STOPPED)
4427 enum gdb_signal sig = ws.value.sig;
4429 /* Stubs traditionally report SIGTRAP as initial signal,
4430 instead of signal 0. Suppress it. */
4431 if (sig == GDB_SIGNAL_TRAP)
4433 evthread->suspend.stop_signal = sig;
4437 evthread->suspend.waitstatus = ws;
4439 if (ws.kind != TARGET_WAITKIND_STOPPED
4440 || ws.value.sig != GDB_SIGNAL_0)
4441 evthread->suspend.waitstatus_pending_p = 1;
4443 set_executing (event_ptid, 0);
4444 set_running (event_ptid, 0);
4445 get_remote_thread_info (evthread)->vcont_resumed = 0;
4448 /* "Notice" the new inferiors before anything related to
4449 registers/memory. */
4450 for (inferior *inf : all_non_exited_inferiors ())
4452 inf->needs_setup = 1;
4456 thread_info *thread = any_live_thread_of_inferior (inf);
4457 notice_new_inferior (thread, thread->state == THREAD_RUNNING,
4462 /* If all-stop on top of non-stop, pause all threads. Note this
4463 records the threads' stop pc, so must be done after "noticing"
4467 stop_all_threads ();
4469 /* If all threads of an inferior were already stopped, we
4470 haven't setup the inferior yet. */
4471 for (inferior *inf : all_non_exited_inferiors ())
4473 if (inf->needs_setup)
4475 thread_info *thread = any_live_thread_of_inferior (inf);
4476 switch_to_thread_no_regs (thread);
4482 /* Now go over all threads that are stopped, and print their current
4483 frame. If all-stop, then if there's a signalled thread, pick
4485 for (thread_info *thread : all_non_exited_threads ())
4491 thread->set_running (false);
4492 else if (thread->state != THREAD_STOPPED)
4495 if (selected == NULL
4496 && thread->suspend.waitstatus_pending_p)
4499 if (lowest_stopped == NULL
4500 || thread->inf->num < lowest_stopped->inf->num
4501 || thread->per_inf_num < lowest_stopped->per_inf_num)
4502 lowest_stopped = thread;
4505 print_one_stopped_thread (thread);
4508 /* In all-stop, we only print the status of one thread, and leave
4509 others with their status pending. */
4512 thread_info *thread = selected;
4514 thread = lowest_stopped;
4518 print_one_stopped_thread (thread);
4521 /* For "info program". */
4522 thread_info *thread = inferior_thread ();
4523 if (thread->state == THREAD_STOPPED)
4524 set_last_target_status (inferior_ptid, thread->suspend.waitstatus);
4527 /* Start the remote connection and sync state. */
4530 remote_target::start_remote (int from_tty, int extended_p)
4532 struct remote_state *rs = get_remote_state ();
4533 struct packet_config *noack_config;
4534 char *wait_status = NULL;
4536 /* Signal other parts that we're going through the initial setup,
4537 and so things may not be stable yet. E.g., we don't try to
4538 install tracepoints until we've relocated symbols. Also, a
4539 Ctrl-C before we're connected and synced up can't interrupt the
4540 target. Instead, it offers to drop the (potentially wedged)
4542 rs->starting_up = 1;
4546 if (interrupt_on_connect)
4547 send_interrupt_sequence ();
4549 /* Ack any packet which the remote side has already sent. */
4550 remote_serial_write ("+", 1);
4552 /* The first packet we send to the target is the optional "supported
4553 packets" request. If the target can answer this, it will tell us
4554 which later probes to skip. */
4555 remote_query_supported ();
4557 /* If the stub wants to get a QAllow, compose one and send it. */
4558 if (packet_support (PACKET_QAllow) != PACKET_DISABLE)
4561 /* gdbserver < 7.7 (before its fix from 2013-12-11) did reply to any
4562 unknown 'v' packet with string "OK". "OK" gets interpreted by GDB
4563 as a reply to known packet. For packet "vFile:setfs:" it is an
4564 invalid reply and GDB would return error in
4565 remote_hostio_set_filesystem, making remote files access impossible.
4566 Disable "vFile:setfs:" in such case. Do not disable other 'v' packets as
4567 other "vFile" packets get correctly detected even on gdbserver < 7.7. */
4569 const char v_mustreplyempty[] = "vMustReplyEmpty";
4571 putpkt (v_mustreplyempty);
4572 getpkt (&rs->buf, &rs->buf_size, 0);
4573 if (strcmp (rs->buf, "OK") == 0)
4574 remote_protocol_packets[PACKET_vFile_setfs].support = PACKET_DISABLE;
4575 else if (strcmp (rs->buf, "") != 0)
4576 error (_("Remote replied unexpectedly to '%s': %s"), v_mustreplyempty,
4580 /* Next, we possibly activate noack mode.
4582 If the QStartNoAckMode packet configuration is set to AUTO,
4583 enable noack mode if the stub reported a wish for it with
4586 If set to TRUE, then enable noack mode even if the stub didn't
4587 report it in qSupported. If the stub doesn't reply OK, the
4588 session ends with an error.
4590 If FALSE, then don't activate noack mode, regardless of what the
4591 stub claimed should be the default with qSupported. */
4593 noack_config = &remote_protocol_packets[PACKET_QStartNoAckMode];
4594 if (packet_config_support (noack_config) != PACKET_DISABLE)
4596 putpkt ("QStartNoAckMode");
4597 getpkt (&rs->buf, &rs->buf_size, 0);
4598 if (packet_ok (rs->buf, noack_config) == PACKET_OK)
4604 /* Tell the remote that we are using the extended protocol. */
4606 getpkt (&rs->buf, &rs->buf_size, 0);
4609 /* Let the target know which signals it is allowed to pass down to
4611 update_signals_program_target ();
4613 /* Next, if the target can specify a description, read it. We do
4614 this before anything involving memory or registers. */
4615 target_find_description ();
4617 /* Next, now that we know something about the target, update the
4618 address spaces in the program spaces. */
4619 update_address_spaces ();
4621 /* On OSs where the list of libraries is global to all
4622 processes, we fetch them early. */
4623 if (gdbarch_has_global_solist (target_gdbarch ()))
4624 solib_add (NULL, from_tty, auto_solib_add);
4626 if (target_is_non_stop_p ())
4628 if (packet_support (PACKET_QNonStop) != PACKET_ENABLE)
4629 error (_("Non-stop mode requested, but remote "
4630 "does not support non-stop"));
4632 putpkt ("QNonStop:1");
4633 getpkt (&rs->buf, &rs->buf_size, 0);
4635 if (strcmp (rs->buf, "OK") != 0)
4636 error (_("Remote refused setting non-stop mode with: %s"), rs->buf);
4638 /* Find about threads and processes the stub is already
4639 controlling. We default to adding them in the running state.
4640 The '?' query below will then tell us about which threads are
4642 this->update_thread_list ();
4644 else if (packet_support (PACKET_QNonStop) == PACKET_ENABLE)
4646 /* Don't assume that the stub can operate in all-stop mode.
4647 Request it explicitly. */
4648 putpkt ("QNonStop:0");
4649 getpkt (&rs->buf, &rs->buf_size, 0);
4651 if (strcmp (rs->buf, "OK") != 0)
4652 error (_("Remote refused setting all-stop mode with: %s"), rs->buf);
4655 /* Upload TSVs regardless of whether the target is running or not. The
4656 remote stub, such as GDBserver, may have some predefined or builtin
4657 TSVs, even if the target is not running. */
4658 if (get_trace_status (current_trace_status ()) != -1)
4660 struct uploaded_tsv *uploaded_tsvs = NULL;
4662 upload_trace_state_variables (&uploaded_tsvs);
4663 merge_uploaded_trace_state_variables (&uploaded_tsvs);
4666 /* Check whether the target is running now. */
4668 getpkt (&rs->buf, &rs->buf_size, 0);
4670 if (!target_is_non_stop_p ())
4672 if (rs->buf[0] == 'W' || rs->buf[0] == 'X')
4675 error (_("The target is not running (try extended-remote?)"));
4677 /* We're connected, but not running. Drop out before we
4678 call start_remote. */
4679 rs->starting_up = 0;
4684 /* Save the reply for later. */
4685 wait_status = (char *) alloca (strlen (rs->buf) + 1);
4686 strcpy (wait_status, rs->buf);
4689 /* Fetch thread list. */
4690 target_update_thread_list ();
4692 /* Let the stub know that we want it to return the thread. */
4693 set_continue_thread (minus_one_ptid);
4695 if (thread_count () == 0)
4697 /* Target has no concept of threads at all. GDB treats
4698 non-threaded target as single-threaded; add a main
4700 add_current_inferior_and_thread (wait_status);
4704 /* We have thread information; select the thread the target
4705 says should be current. If we're reconnecting to a
4706 multi-threaded program, this will ideally be the thread
4707 that last reported an event before GDB disconnected. */
4708 inferior_ptid = get_current_thread (wait_status);
4709 if (inferior_ptid == null_ptid)
4711 /* Odd... The target was able to list threads, but not
4712 tell us which thread was current (no "thread"
4713 register in T stop reply?). Just pick the first
4714 thread in the thread list then. */
4717 fprintf_unfiltered (gdb_stdlog,
4718 "warning: couldn't determine remote "
4719 "current thread; picking first in list.\n");
4721 inferior_ptid = inferior_list->thread_list->ptid;
4725 /* init_wait_for_inferior should be called before get_offsets in order
4726 to manage `inserted' flag in bp loc in a correct state.
4727 breakpoint_init_inferior, called from init_wait_for_inferior, set
4728 `inserted' flag to 0, while before breakpoint_re_set, called from
4729 start_remote, set `inserted' flag to 1. In the initialization of
4730 inferior, breakpoint_init_inferior should be called first, and then
4731 breakpoint_re_set can be called. If this order is broken, state of
4732 `inserted' flag is wrong, and cause some problems on breakpoint
4734 init_wait_for_inferior ();
4736 get_offsets (); /* Get text, data & bss offsets. */
4738 /* If we could not find a description using qXfer, and we know
4739 how to do it some other way, try again. This is not
4740 supported for non-stop; it could be, but it is tricky if
4741 there are no stopped threads when we connect. */
4742 if (remote_read_description_p (this)
4743 && gdbarch_target_desc (target_gdbarch ()) == NULL)
4745 target_clear_description ();
4746 target_find_description ();
4749 /* Use the previously fetched status. */
4750 gdb_assert (wait_status != NULL);
4751 strcpy (rs->buf, wait_status);
4752 rs->cached_wait_status = 1;
4754 ::start_remote (from_tty); /* Initialize gdb process mechanisms. */
4758 /* Clear WFI global state. Do this before finding about new
4759 threads and inferiors, and setting the current inferior.
4760 Otherwise we would clear the proceed status of the current
4761 inferior when we want its stop_soon state to be preserved
4762 (see notice_new_inferior). */
4763 init_wait_for_inferior ();
4765 /* In non-stop, we will either get an "OK", meaning that there
4766 are no stopped threads at this time; or, a regular stop
4767 reply. In the latter case, there may be more than one thread
4768 stopped --- we pull them all out using the vStopped
4770 if (strcmp (rs->buf, "OK") != 0)
4772 struct notif_client *notif = ¬if_client_stop;
4774 /* remote_notif_get_pending_replies acks this one, and gets
4776 rs->notif_state->pending_event[notif_client_stop.id]
4777 = remote_notif_parse (this, notif, rs->buf);
4778 remote_notif_get_pending_events (notif);
4781 if (thread_count () == 0)
4784 error (_("The target is not running (try extended-remote?)"));
4786 /* We're connected, but not running. Drop out before we
4787 call start_remote. */
4788 rs->starting_up = 0;
4792 /* In non-stop mode, any cached wait status will be stored in
4793 the stop reply queue. */
4794 gdb_assert (wait_status == NULL);
4796 /* Report all signals during attach/startup. */
4797 pass_signals (0, NULL);
4799 /* If there are already stopped threads, mark them stopped and
4800 report their stops before giving the prompt to the user. */
4801 process_initial_stop_replies (from_tty);
4803 if (target_can_async_p ())
4807 /* If we connected to a live target, do some additional setup. */
4808 if (target_has_execution)
4810 if (symfile_objfile) /* No use without a symbol-file. */
4811 remote_check_symbols ();
4814 /* Possibly the target has been engaged in a trace run started
4815 previously; find out where things are at. */
4816 if (get_trace_status (current_trace_status ()) != -1)
4818 struct uploaded_tp *uploaded_tps = NULL;
4820 if (current_trace_status ()->running)
4821 printf_filtered (_("Trace is already running on the target.\n"));
4823 upload_tracepoints (&uploaded_tps);
4825 merge_uploaded_tracepoints (&uploaded_tps);
4828 /* Possibly the target has been engaged in a btrace record started
4829 previously; find out where things are at. */
4830 remote_btrace_maybe_reopen ();
4832 /* The thread and inferior lists are now synchronized with the
4833 target, our symbols have been relocated, and we're merged the
4834 target's tracepoints with ours. We're done with basic start
4836 rs->starting_up = 0;
4838 /* Maybe breakpoints are global and need to be inserted now. */
4839 if (breakpoints_should_be_inserted_now ())
4840 insert_breakpoints ();
4843 /* Open a connection to a remote debugger.
4844 NAME is the filename used for communication. */
4847 remote_target::open (const char *name, int from_tty)
4849 open_1 (name, from_tty, 0);
4852 /* Open a connection to a remote debugger using the extended
4853 remote gdb protocol. NAME is the filename used for communication. */
4856 extended_remote_target::open (const char *name, int from_tty)
4858 open_1 (name, from_tty, 1 /*extended_p */);
4861 /* Reset all packets back to "unknown support". Called when opening a
4862 new connection to a remote target. */
4865 reset_all_packet_configs_support (void)
4869 for (i = 0; i < PACKET_MAX; i++)
4870 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
4873 /* Initialize all packet configs. */
4876 init_all_packet_configs (void)
4880 for (i = 0; i < PACKET_MAX; i++)
4882 remote_protocol_packets[i].detect = AUTO_BOOLEAN_AUTO;
4883 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
4887 /* Symbol look-up. */
4890 remote_target::remote_check_symbols ()
4892 char *msg, *reply, *tmp;
4895 struct cleanup *old_chain;
4897 /* The remote side has no concept of inferiors that aren't running
4898 yet, it only knows about running processes. If we're connected
4899 but our current inferior is not running, we should not invite the
4900 remote target to request symbol lookups related to its
4901 (unrelated) current process. */
4902 if (!target_has_execution)
4905 if (packet_support (PACKET_qSymbol) == PACKET_DISABLE)
4908 /* Make sure the remote is pointing at the right process. Note
4909 there's no way to select "no process". */
4910 set_general_process ();
4912 /* Allocate a message buffer. We can't reuse the input buffer in RS,
4913 because we need both at the same time. */
4914 msg = (char *) xmalloc (get_remote_packet_size ());
4915 old_chain = make_cleanup (xfree, msg);
4916 reply = (char *) xmalloc (get_remote_packet_size ());
4917 make_cleanup (free_current_contents, &reply);
4918 reply_size = get_remote_packet_size ();
4920 /* Invite target to request symbol lookups. */
4922 putpkt ("qSymbol::");
4923 getpkt (&reply, &reply_size, 0);
4924 packet_ok (reply, &remote_protocol_packets[PACKET_qSymbol]);
4926 while (startswith (reply, "qSymbol:"))
4928 struct bound_minimal_symbol sym;
4931 end = hex2bin (tmp, (gdb_byte *) msg, strlen (tmp) / 2);
4933 sym = lookup_minimal_symbol (msg, NULL, NULL);
4934 if (sym.minsym == NULL)
4935 xsnprintf (msg, get_remote_packet_size (), "qSymbol::%s", &reply[8]);
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, get_remote_packet_size (), "qSymbol:%s:%s",
4948 phex_nz (sym_addr, addr_size), &reply[8]);
4952 getpkt (&reply, &reply_size, 0);
4955 do_cleanups (old_chain);
4958 static struct serial *
4959 remote_serial_open (const char *name)
4961 static int udp_warning = 0;
4963 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
4964 of in ser-tcp.c, because it is the remote protocol assuming that the
4965 serial connection is reliable and not the serial connection promising
4967 if (!udp_warning && startswith (name, "udp:"))
4969 warning (_("The remote protocol may be unreliable over UDP.\n"
4970 "Some events may be lost, rendering further debugging "
4975 return serial_open (name);
4978 /* Inform the target of our permission settings. The permission flags
4979 work without this, but if the target knows the settings, it can do
4980 a couple things. First, it can add its own check, to catch cases
4981 that somehow manage to get by the permissions checks in target
4982 methods. Second, if the target is wired to disallow particular
4983 settings (for instance, a system in the field that is not set up to
4984 be able to stop at a breakpoint), it can object to any unavailable
4988 remote_target::set_permissions ()
4990 struct remote_state *rs = get_remote_state ();
4992 xsnprintf (rs->buf, get_remote_packet_size (), "QAllow:"
4993 "WriteReg:%x;WriteMem:%x;"
4994 "InsertBreak:%x;InsertTrace:%x;"
4995 "InsertFastTrace:%x;Stop:%x",
4996 may_write_registers, may_write_memory,
4997 may_insert_breakpoints, may_insert_tracepoints,
4998 may_insert_fast_tracepoints, may_stop);
5000 getpkt (&rs->buf, &rs->buf_size, 0);
5002 /* If the target didn't like the packet, warn the user. Do not try
5003 to undo the user's settings, that would just be maddening. */
5004 if (strcmp (rs->buf, "OK") != 0)
5005 warning (_("Remote refused setting permissions with: %s"), rs->buf);
5008 /* This type describes each known response to the qSupported
5010 struct protocol_feature
5012 /* The name of this protocol feature. */
5015 /* The default for this protocol feature. */
5016 enum packet_support default_support;
5018 /* The function to call when this feature is reported, or after
5019 qSupported processing if the feature is not supported.
5020 The first argument points to this structure. The second
5021 argument indicates whether the packet requested support be
5022 enabled, disabled, or probed (or the default, if this function
5023 is being called at the end of processing and this feature was
5024 not reported). The third argument may be NULL; if not NULL, it
5025 is a NUL-terminated string taken from the packet following
5026 this feature's name and an equals sign. */
5027 void (*func) (remote_target *remote, const struct protocol_feature *,
5028 enum packet_support, const char *);
5030 /* The corresponding packet for this feature. Only used if
5031 FUNC is remote_supported_packet. */
5036 remote_supported_packet (remote_target *remote,
5037 const struct protocol_feature *feature,
5038 enum packet_support support,
5039 const char *argument)
5043 warning (_("Remote qSupported response supplied an unexpected value for"
5044 " \"%s\"."), feature->name);
5048 remote_protocol_packets[feature->packet].support = support;
5052 remote_target::remote_packet_size (const protocol_feature *feature,
5053 enum packet_support support, const char *value)
5055 struct remote_state *rs = get_remote_state ();
5060 if (support != PACKET_ENABLE)
5063 if (value == NULL || *value == '\0')
5065 warning (_("Remote target reported \"%s\" without a size."),
5071 packet_size = strtol (value, &value_end, 16);
5072 if (errno != 0 || *value_end != '\0' || packet_size < 0)
5074 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
5075 feature->name, value);
5079 /* Record the new maximum packet size. */
5080 rs->explicit_packet_size = packet_size;
5084 remote_packet_size (remote_target *remote, const protocol_feature *feature,
5085 enum packet_support support, const char *value)
5087 remote->remote_packet_size (feature, support, value);
5090 static const struct protocol_feature remote_protocol_features[] = {
5091 { "PacketSize", PACKET_DISABLE, remote_packet_size, -1 },
5092 { "qXfer:auxv:read", PACKET_DISABLE, remote_supported_packet,
5093 PACKET_qXfer_auxv },
5094 { "qXfer:exec-file:read", PACKET_DISABLE, remote_supported_packet,
5095 PACKET_qXfer_exec_file },
5096 { "qXfer:features:read", PACKET_DISABLE, remote_supported_packet,
5097 PACKET_qXfer_features },
5098 { "qXfer:libraries:read", PACKET_DISABLE, remote_supported_packet,
5099 PACKET_qXfer_libraries },
5100 { "qXfer:libraries-svr4:read", PACKET_DISABLE, remote_supported_packet,
5101 PACKET_qXfer_libraries_svr4 },
5102 { "augmented-libraries-svr4-read", PACKET_DISABLE,
5103 remote_supported_packet, PACKET_augmented_libraries_svr4_read_feature },
5104 { "qXfer:memory-map:read", PACKET_DISABLE, remote_supported_packet,
5105 PACKET_qXfer_memory_map },
5106 { "qXfer:spu:read", PACKET_DISABLE, remote_supported_packet,
5107 PACKET_qXfer_spu_read },
5108 { "qXfer:spu:write", PACKET_DISABLE, remote_supported_packet,
5109 PACKET_qXfer_spu_write },
5110 { "qXfer:osdata:read", PACKET_DISABLE, remote_supported_packet,
5111 PACKET_qXfer_osdata },
5112 { "qXfer:threads:read", PACKET_DISABLE, remote_supported_packet,
5113 PACKET_qXfer_threads },
5114 { "qXfer:traceframe-info:read", PACKET_DISABLE, remote_supported_packet,
5115 PACKET_qXfer_traceframe_info },
5116 { "QPassSignals", PACKET_DISABLE, remote_supported_packet,
5117 PACKET_QPassSignals },
5118 { "QCatchSyscalls", PACKET_DISABLE, remote_supported_packet,
5119 PACKET_QCatchSyscalls },
5120 { "QProgramSignals", PACKET_DISABLE, remote_supported_packet,
5121 PACKET_QProgramSignals },
5122 { "QSetWorkingDir", PACKET_DISABLE, remote_supported_packet,
5123 PACKET_QSetWorkingDir },
5124 { "QStartupWithShell", PACKET_DISABLE, remote_supported_packet,
5125 PACKET_QStartupWithShell },
5126 { "QEnvironmentHexEncoded", PACKET_DISABLE, remote_supported_packet,
5127 PACKET_QEnvironmentHexEncoded },
5128 { "QEnvironmentReset", PACKET_DISABLE, remote_supported_packet,
5129 PACKET_QEnvironmentReset },
5130 { "QEnvironmentUnset", PACKET_DISABLE, remote_supported_packet,
5131 PACKET_QEnvironmentUnset },
5132 { "QStartNoAckMode", PACKET_DISABLE, remote_supported_packet,
5133 PACKET_QStartNoAckMode },
5134 { "multiprocess", PACKET_DISABLE, remote_supported_packet,
5135 PACKET_multiprocess_feature },
5136 { "QNonStop", PACKET_DISABLE, remote_supported_packet, PACKET_QNonStop },
5137 { "qXfer:siginfo:read", PACKET_DISABLE, remote_supported_packet,
5138 PACKET_qXfer_siginfo_read },
5139 { "qXfer:siginfo:write", PACKET_DISABLE, remote_supported_packet,
5140 PACKET_qXfer_siginfo_write },
5141 { "ConditionalTracepoints", PACKET_DISABLE, remote_supported_packet,
5142 PACKET_ConditionalTracepoints },
5143 { "ConditionalBreakpoints", PACKET_DISABLE, remote_supported_packet,
5144 PACKET_ConditionalBreakpoints },
5145 { "BreakpointCommands", PACKET_DISABLE, remote_supported_packet,
5146 PACKET_BreakpointCommands },
5147 { "FastTracepoints", PACKET_DISABLE, remote_supported_packet,
5148 PACKET_FastTracepoints },
5149 { "StaticTracepoints", PACKET_DISABLE, remote_supported_packet,
5150 PACKET_StaticTracepoints },
5151 {"InstallInTrace", PACKET_DISABLE, remote_supported_packet,
5152 PACKET_InstallInTrace},
5153 { "DisconnectedTracing", PACKET_DISABLE, remote_supported_packet,
5154 PACKET_DisconnectedTracing_feature },
5155 { "ReverseContinue", PACKET_DISABLE, remote_supported_packet,
5157 { "ReverseStep", PACKET_DISABLE, remote_supported_packet,
5159 { "TracepointSource", PACKET_DISABLE, remote_supported_packet,
5160 PACKET_TracepointSource },
5161 { "QAllow", PACKET_DISABLE, remote_supported_packet,
5163 { "EnableDisableTracepoints", PACKET_DISABLE, remote_supported_packet,
5164 PACKET_EnableDisableTracepoints_feature },
5165 { "qXfer:fdpic:read", PACKET_DISABLE, remote_supported_packet,
5166 PACKET_qXfer_fdpic },
5167 { "qXfer:uib:read", PACKET_DISABLE, remote_supported_packet,
5169 { "QDisableRandomization", PACKET_DISABLE, remote_supported_packet,
5170 PACKET_QDisableRandomization },
5171 { "QAgent", PACKET_DISABLE, remote_supported_packet, PACKET_QAgent},
5172 { "QTBuffer:size", PACKET_DISABLE,
5173 remote_supported_packet, PACKET_QTBuffer_size},
5174 { "tracenz", PACKET_DISABLE, remote_supported_packet, PACKET_tracenz_feature },
5175 { "Qbtrace:off", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_off },
5176 { "Qbtrace:bts", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_bts },
5177 { "Qbtrace:pt", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_pt },
5178 { "qXfer:btrace:read", PACKET_DISABLE, remote_supported_packet,
5179 PACKET_qXfer_btrace },
5180 { "qXfer:btrace-conf:read", PACKET_DISABLE, remote_supported_packet,
5181 PACKET_qXfer_btrace_conf },
5182 { "Qbtrace-conf:bts:size", PACKET_DISABLE, remote_supported_packet,
5183 PACKET_Qbtrace_conf_bts_size },
5184 { "swbreak", PACKET_DISABLE, remote_supported_packet, PACKET_swbreak_feature },
5185 { "hwbreak", PACKET_DISABLE, remote_supported_packet, PACKET_hwbreak_feature },
5186 { "fork-events", PACKET_DISABLE, remote_supported_packet,
5187 PACKET_fork_event_feature },
5188 { "vfork-events", PACKET_DISABLE, remote_supported_packet,
5189 PACKET_vfork_event_feature },
5190 { "exec-events", PACKET_DISABLE, remote_supported_packet,
5191 PACKET_exec_event_feature },
5192 { "Qbtrace-conf:pt:size", PACKET_DISABLE, remote_supported_packet,
5193 PACKET_Qbtrace_conf_pt_size },
5194 { "vContSupported", PACKET_DISABLE, remote_supported_packet, PACKET_vContSupported },
5195 { "QThreadEvents", PACKET_DISABLE, remote_supported_packet, PACKET_QThreadEvents },
5196 { "no-resumed", PACKET_DISABLE, remote_supported_packet, PACKET_no_resumed },
5199 static char *remote_support_xml;
5201 /* Register string appended to "xmlRegisters=" in qSupported query. */
5204 register_remote_support_xml (const char *xml)
5206 #if defined(HAVE_LIBEXPAT)
5207 if (remote_support_xml == NULL)
5208 remote_support_xml = concat ("xmlRegisters=", xml, (char *) NULL);
5211 char *copy = xstrdup (remote_support_xml + 13);
5212 char *p = strtok (copy, ",");
5216 if (strcmp (p, xml) == 0)
5223 while ((p = strtok (NULL, ",")) != NULL);
5226 remote_support_xml = reconcat (remote_support_xml,
5227 remote_support_xml, ",", xml,
5234 remote_query_supported_append (std::string *msg, const char *append)
5238 msg->append (append);
5242 remote_target::remote_query_supported ()
5244 struct remote_state *rs = get_remote_state ();
5247 unsigned char seen [ARRAY_SIZE (remote_protocol_features)];
5249 /* The packet support flags are handled differently for this packet
5250 than for most others. We treat an error, a disabled packet, and
5251 an empty response identically: any features which must be reported
5252 to be used will be automatically disabled. An empty buffer
5253 accomplishes this, since that is also the representation for a list
5254 containing no features. */
5257 if (packet_support (PACKET_qSupported) != PACKET_DISABLE)
5261 if (packet_set_cmd_state (PACKET_multiprocess_feature) != AUTO_BOOLEAN_FALSE)
5262 remote_query_supported_append (&q, "multiprocess+");
5264 if (packet_set_cmd_state (PACKET_swbreak_feature) != AUTO_BOOLEAN_FALSE)
5265 remote_query_supported_append (&q, "swbreak+");
5266 if (packet_set_cmd_state (PACKET_hwbreak_feature) != AUTO_BOOLEAN_FALSE)
5267 remote_query_supported_append (&q, "hwbreak+");
5269 remote_query_supported_append (&q, "qRelocInsn+");
5271 if (packet_set_cmd_state (PACKET_fork_event_feature)
5272 != AUTO_BOOLEAN_FALSE)
5273 remote_query_supported_append (&q, "fork-events+");
5274 if (packet_set_cmd_state (PACKET_vfork_event_feature)
5275 != AUTO_BOOLEAN_FALSE)
5276 remote_query_supported_append (&q, "vfork-events+");
5277 if (packet_set_cmd_state (PACKET_exec_event_feature)
5278 != AUTO_BOOLEAN_FALSE)
5279 remote_query_supported_append (&q, "exec-events+");
5281 if (packet_set_cmd_state (PACKET_vContSupported) != AUTO_BOOLEAN_FALSE)
5282 remote_query_supported_append (&q, "vContSupported+");
5284 if (packet_set_cmd_state (PACKET_QThreadEvents) != AUTO_BOOLEAN_FALSE)
5285 remote_query_supported_append (&q, "QThreadEvents+");
5287 if (packet_set_cmd_state (PACKET_no_resumed) != AUTO_BOOLEAN_FALSE)
5288 remote_query_supported_append (&q, "no-resumed+");
5290 /* Keep this one last to work around a gdbserver <= 7.10 bug in
5291 the qSupported:xmlRegisters=i386 handling. */
5292 if (remote_support_xml != NULL
5293 && packet_support (PACKET_qXfer_features) != PACKET_DISABLE)
5294 remote_query_supported_append (&q, remote_support_xml);
5296 q = "qSupported:" + q;
5297 putpkt (q.c_str ());
5299 getpkt (&rs->buf, &rs->buf_size, 0);
5301 /* If an error occured, warn, but do not return - just reset the
5302 buffer to empty and go on to disable features. */
5303 if (packet_ok (rs->buf, &remote_protocol_packets[PACKET_qSupported])
5306 warning (_("Remote failure reply: %s"), rs->buf);
5311 memset (seen, 0, sizeof (seen));
5316 enum packet_support is_supported;
5317 char *p, *end, *name_end, *value;
5319 /* First separate out this item from the rest of the packet. If
5320 there's another item after this, we overwrite the separator
5321 (terminated strings are much easier to work with). */
5323 end = strchr (p, ';');
5326 end = p + strlen (p);
5336 warning (_("empty item in \"qSupported\" response"));
5341 name_end = strchr (p, '=');
5344 /* This is a name=value entry. */
5345 is_supported = PACKET_ENABLE;
5346 value = name_end + 1;
5355 is_supported = PACKET_ENABLE;
5359 is_supported = PACKET_DISABLE;
5363 is_supported = PACKET_SUPPORT_UNKNOWN;
5367 warning (_("unrecognized item \"%s\" "
5368 "in \"qSupported\" response"), p);
5374 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
5375 if (strcmp (remote_protocol_features[i].name, p) == 0)
5377 const struct protocol_feature *feature;
5380 feature = &remote_protocol_features[i];
5381 feature->func (this, feature, is_supported, value);
5386 /* If we increased the packet size, make sure to increase the global
5387 buffer size also. We delay this until after parsing the entire
5388 qSupported packet, because this is the same buffer we were
5390 if (rs->buf_size < rs->explicit_packet_size)
5392 rs->buf_size = rs->explicit_packet_size;
5393 rs->buf = (char *) xrealloc (rs->buf, rs->buf_size);
5396 /* Handle the defaults for unmentioned features. */
5397 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
5400 const struct protocol_feature *feature;
5402 feature = &remote_protocol_features[i];
5403 feature->func (this, feature, feature->default_support, NULL);
5407 /* Serial QUIT handler for the remote serial descriptor.
5409 Defers handling a Ctrl-C until we're done with the current
5410 command/response packet sequence, unless:
5412 - We're setting up the connection. Don't send a remote interrupt
5413 request, as we're not fully synced yet. Quit immediately
5416 - The target has been resumed in the foreground
5417 (target_terminal::is_ours is false) with a synchronous resume
5418 packet, and we're blocked waiting for the stop reply, thus a
5419 Ctrl-C should be immediately sent to the target.
5421 - We get a second Ctrl-C while still within the same serial read or
5422 write. In that case the serial is seemingly wedged --- offer to
5425 - We see a second Ctrl-C without target response, after having
5426 previously interrupted the target. In that case the target/stub
5427 is probably wedged --- offer to quit/disconnect.
5431 remote_target::remote_serial_quit_handler ()
5433 struct remote_state *rs = get_remote_state ();
5435 if (check_quit_flag ())
5437 /* If we're starting up, we're not fully synced yet. Quit
5439 if (rs->starting_up)
5441 else if (rs->got_ctrlc_during_io)
5443 if (query (_("The target is not responding to GDB commands.\n"
5444 "Stop debugging it? ")))
5445 remote_unpush_and_throw ();
5447 /* If ^C has already been sent once, offer to disconnect. */
5448 else if (!target_terminal::is_ours () && rs->ctrlc_pending_p)
5450 /* All-stop protocol, and blocked waiting for stop reply. Send
5451 an interrupt request. */
5452 else if (!target_terminal::is_ours () && rs->waiting_for_stop_reply)
5453 target_interrupt ();
5455 rs->got_ctrlc_during_io = 1;
5459 /* The remote_target that is current while the quit handler is
5460 overridden with remote_serial_quit_handler. */
5461 static remote_target *curr_quit_handler_target;
5464 remote_serial_quit_handler ()
5466 curr_quit_handler_target->remote_serial_quit_handler ();
5469 /* Remove any of the remote.c targets from target stack. Upper targets depend
5470 on it so remove them first. */
5473 remote_unpush_target (void)
5475 pop_all_targets_at_and_above (process_stratum);
5479 remote_unpush_and_throw (void)
5481 remote_unpush_target ();
5482 throw_error (TARGET_CLOSE_ERROR, _("Disconnected from target."));
5486 remote_target::open_1 (const char *name, int from_tty, int extended_p)
5488 remote_target *curr_remote = get_current_remote_target ();
5491 error (_("To open a remote debug connection, you need to specify what\n"
5492 "serial device is attached to the remote system\n"
5493 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
5495 /* If we're connected to a running target, target_preopen will kill it.
5496 Ask this question first, before target_preopen has a chance to kill
5498 if (curr_remote != NULL && !have_inferiors ())
5501 && !query (_("Already connected to a remote target. Disconnect? ")))
5502 error (_("Still connected."));
5505 /* Here the possibly existing remote target gets unpushed. */
5506 target_preopen (from_tty);
5508 remote_fileio_reset ();
5509 reopen_exec_file ();
5512 remote_target *remote
5513 = (extended_p ? new extended_remote_target () : new remote_target ());
5514 target_ops_up target_holder (remote);
5516 remote_state *rs = remote->get_remote_state ();
5518 /* See FIXME above. */
5519 if (!target_async_permitted)
5520 rs->wait_forever_enabled_p = 1;
5522 rs->remote_desc = remote_serial_open (name);
5523 if (!rs->remote_desc)
5524 perror_with_name (name);
5526 if (baud_rate != -1)
5528 if (serial_setbaudrate (rs->remote_desc, baud_rate))
5530 /* The requested speed could not be set. Error out to
5531 top level after closing remote_desc. Take care to
5532 set remote_desc to NULL to avoid closing remote_desc
5534 serial_close (rs->remote_desc);
5535 rs->remote_desc = NULL;
5536 perror_with_name (name);
5540 serial_setparity (rs->remote_desc, serial_parity);
5541 serial_raw (rs->remote_desc);
5543 /* If there is something sitting in the buffer we might take it as a
5544 response to a command, which would be bad. */
5545 serial_flush_input (rs->remote_desc);
5549 puts_filtered ("Remote debugging using ");
5550 puts_filtered (name);
5551 puts_filtered ("\n");
5554 /* Switch to using the remote target now. */
5555 push_target (remote);
5556 /* The target stack owns the target now. */
5557 target_holder.release ();
5559 /* Register extra event sources in the event loop. */
5560 rs->remote_async_inferior_event_token
5561 = create_async_event_handler (remote_async_inferior_event_handler,
5563 rs->notif_state = remote_notif_state_allocate (remote);
5565 /* Reset the target state; these things will be queried either by
5566 remote_query_supported or as they are needed. */
5567 reset_all_packet_configs_support ();
5568 rs->cached_wait_status = 0;
5569 rs->explicit_packet_size = 0;
5571 rs->extended = extended_p;
5572 rs->waiting_for_stop_reply = 0;
5573 rs->ctrlc_pending_p = 0;
5574 rs->got_ctrlc_during_io = 0;
5576 rs->general_thread = not_sent_ptid;
5577 rs->continue_thread = not_sent_ptid;
5578 rs->remote_traceframe_number = -1;
5580 rs->last_resume_exec_dir = EXEC_FORWARD;
5582 /* Probe for ability to use "ThreadInfo" query, as required. */
5583 rs->use_threadinfo_query = 1;
5584 rs->use_threadextra_query = 1;
5586 rs->readahead_cache.invalidate ();
5588 if (target_async_permitted)
5590 /* FIXME: cagney/1999-09-23: During the initial connection it is
5591 assumed that the target is already ready and able to respond to
5592 requests. Unfortunately remote_start_remote() eventually calls
5593 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
5594 around this. Eventually a mechanism that allows
5595 wait_for_inferior() to expect/get timeouts will be
5597 rs->wait_forever_enabled_p = 0;
5600 /* First delete any symbols previously loaded from shared libraries. */
5601 no_shared_libraries (NULL, 0);
5603 /* Start the remote connection. If error() or QUIT, discard this
5604 target (we'd otherwise be in an inconsistent state) and then
5605 propogate the error on up the exception chain. This ensures that
5606 the caller doesn't stumble along blindly assuming that the
5607 function succeeded. The CLI doesn't have this problem but other
5608 UI's, such as MI do.
5610 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
5611 this function should return an error indication letting the
5612 caller restore the previous state. Unfortunately the command
5613 ``target remote'' is directly wired to this function making that
5614 impossible. On a positive note, the CLI side of this problem has
5615 been fixed - the function set_cmd_context() makes it possible for
5616 all the ``target ....'' commands to share a common callback
5617 function. See cli-dump.c. */
5622 remote->start_remote (from_tty, extended_p);
5624 CATCH (ex, RETURN_MASK_ALL)
5626 /* Pop the partially set up target - unless something else did
5627 already before throwing the exception. */
5628 if (ex.error != TARGET_CLOSE_ERROR)
5629 remote_unpush_target ();
5630 throw_exception (ex);
5635 remote_btrace_reset (rs);
5637 if (target_async_permitted)
5638 rs->wait_forever_enabled_p = 1;
5641 /* Detach the specified process. */
5644 remote_target::remote_detach_pid (int pid)
5646 struct remote_state *rs = get_remote_state ();
5648 /* This should not be necessary, but the handling for D;PID in
5649 GDBserver versions prior to 8.2 incorrectly assumes that the
5650 selected process points to the same process we're detaching,
5651 leading to misbehavior (and possibly GDBserver crashing) when it
5652 does not. Since it's easy and cheap, work around it by forcing
5653 GDBserver to select GDB's current process. */
5654 set_general_process ();
5656 if (remote_multi_process_p (rs))
5657 xsnprintf (rs->buf, get_remote_packet_size (), "D;%x", pid);
5659 strcpy (rs->buf, "D");
5662 getpkt (&rs->buf, &rs->buf_size, 0);
5664 if (rs->buf[0] == 'O' && rs->buf[1] == 'K')
5666 else if (rs->buf[0] == '\0')
5667 error (_("Remote doesn't know how to detach"));
5669 error (_("Can't detach process."));
5672 /* This detaches a program to which we previously attached, using
5673 inferior_ptid to identify the process. After this is done, GDB
5674 can be used to debug some other program. We better not have left
5675 any breakpoints in the target program or it'll die when it hits
5679 remote_target::remote_detach_1 (inferior *inf, int from_tty)
5681 int pid = inferior_ptid.pid ();
5682 struct remote_state *rs = get_remote_state ();
5685 if (!target_has_execution)
5686 error (_("No process to detach from."));
5688 target_announce_detach (from_tty);
5690 /* Tell the remote target to detach. */
5691 remote_detach_pid (pid);
5693 /* Exit only if this is the only active inferior. */
5694 if (from_tty && !rs->extended && number_of_live_inferiors () == 1)
5695 puts_filtered (_("Ending remote debugging.\n"));
5697 struct thread_info *tp = find_thread_ptid (inferior_ptid);
5699 /* Check to see if we are detaching a fork parent. Note that if we
5700 are detaching a fork child, tp == NULL. */
5701 is_fork_parent = (tp != NULL
5702 && tp->pending_follow.kind == TARGET_WAITKIND_FORKED);
5704 /* If doing detach-on-fork, we don't mourn, because that will delete
5705 breakpoints that should be available for the followed inferior. */
5706 if (!is_fork_parent)
5708 /* Save the pid as a string before mourning, since that will
5709 unpush the remote target, and we need the string after. */
5710 std::string infpid = target_pid_to_str (ptid_t (pid));
5712 target_mourn_inferior (inferior_ptid);
5713 if (print_inferior_events)
5714 printf_unfiltered (_("[Inferior %d (%s) detached]\n"),
5715 inf->num, infpid.c_str ());
5719 inferior_ptid = null_ptid;
5720 detach_inferior (current_inferior ());
5725 remote_target::detach (inferior *inf, int from_tty)
5727 remote_detach_1 (inf, from_tty);
5731 extended_remote_target::detach (inferior *inf, int from_tty)
5733 remote_detach_1 (inf, from_tty);
5736 /* Target follow-fork function for remote targets. On entry, and
5737 at return, the current inferior is the fork parent.
5739 Note that although this is currently only used for extended-remote,
5740 it is named remote_follow_fork in anticipation of using it for the
5741 remote target as well. */
5744 remote_target::follow_fork (int follow_child, int detach_fork)
5746 struct remote_state *rs = get_remote_state ();
5747 enum target_waitkind kind = inferior_thread ()->pending_follow.kind;
5749 if ((kind == TARGET_WAITKIND_FORKED && remote_fork_event_p (rs))
5750 || (kind == TARGET_WAITKIND_VFORKED && remote_vfork_event_p (rs)))
5752 /* When following the parent and detaching the child, we detach
5753 the child here. For the case of following the child and
5754 detaching the parent, the detach is done in the target-
5755 independent follow fork code in infrun.c. We can't use
5756 target_detach when detaching an unfollowed child because
5757 the client side doesn't know anything about the child. */
5758 if (detach_fork && !follow_child)
5760 /* Detach the fork child. */
5764 child_ptid = inferior_thread ()->pending_follow.value.related_pid;
5765 child_pid = child_ptid.pid ();
5767 remote_detach_pid (child_pid);
5773 /* Target follow-exec function for remote targets. Save EXECD_PATHNAME
5774 in the program space of the new inferior. On entry and at return the
5775 current inferior is the exec'ing inferior. INF is the new exec'd
5776 inferior, which may be the same as the exec'ing inferior unless
5777 follow-exec-mode is "new". */
5780 remote_target::follow_exec (struct inferior *inf, char *execd_pathname)
5782 /* We know that this is a target file name, so if it has the "target:"
5783 prefix we strip it off before saving it in the program space. */
5784 if (is_target_filename (execd_pathname))
5785 execd_pathname += strlen (TARGET_SYSROOT_PREFIX);
5787 set_pspace_remote_exec_file (inf->pspace, execd_pathname);
5790 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
5793 remote_target::disconnect (const char *args, int from_tty)
5796 error (_("Argument given to \"disconnect\" when remotely debugging."));
5798 /* Make sure we unpush even the extended remote targets. Calling
5799 target_mourn_inferior won't unpush, and remote_mourn won't
5800 unpush if there is more than one inferior left. */
5801 unpush_target (this);
5802 generic_mourn_inferior ();
5805 puts_filtered ("Ending remote debugging.\n");
5808 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
5809 be chatty about it. */
5812 extended_remote_target::attach (const char *args, int from_tty)
5814 struct remote_state *rs = get_remote_state ();
5816 char *wait_status = NULL;
5818 pid = parse_pid_to_attach (args);
5820 /* Remote PID can be freely equal to getpid, do not check it here the same
5821 way as in other targets. */
5823 if (packet_support (PACKET_vAttach) == PACKET_DISABLE)
5824 error (_("This target does not support attaching to a process"));
5828 char *exec_file = get_exec_file (0);
5831 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file,
5832 target_pid_to_str (ptid_t (pid)));
5834 printf_unfiltered (_("Attaching to %s\n"),
5835 target_pid_to_str (ptid_t (pid)));
5837 gdb_flush (gdb_stdout);
5840 xsnprintf (rs->buf, get_remote_packet_size (), "vAttach;%x", pid);
5842 getpkt (&rs->buf, &rs->buf_size, 0);
5844 switch (packet_ok (rs->buf,
5845 &remote_protocol_packets[PACKET_vAttach]))
5848 if (!target_is_non_stop_p ())
5850 /* Save the reply for later. */
5851 wait_status = (char *) alloca (strlen (rs->buf) + 1);
5852 strcpy (wait_status, rs->buf);
5854 else if (strcmp (rs->buf, "OK") != 0)
5855 error (_("Attaching to %s failed with: %s"),
5856 target_pid_to_str (ptid_t (pid)),
5859 case PACKET_UNKNOWN:
5860 error (_("This target does not support attaching to a process"));
5862 error (_("Attaching to %s failed"),
5863 target_pid_to_str (ptid_t (pid)));
5866 set_current_inferior (remote_add_inferior (0, pid, 1, 0));
5868 inferior_ptid = ptid_t (pid);
5870 if (target_is_non_stop_p ())
5872 struct thread_info *thread;
5874 /* Get list of threads. */
5875 update_thread_list ();
5877 thread = first_thread_of_inferior (current_inferior ());
5879 inferior_ptid = thread->ptid;
5881 inferior_ptid = ptid_t (pid);
5883 /* Invalidate our notion of the remote current thread. */
5884 record_currthread (rs, minus_one_ptid);
5888 /* Now, if we have thread information, update inferior_ptid. */
5889 inferior_ptid = remote_current_thread (inferior_ptid);
5891 /* Add the main thread to the thread list. */
5892 thread_info *thr = add_thread_silent (inferior_ptid);
5893 /* Don't consider the thread stopped until we've processed the
5894 saved stop reply. */
5895 set_executing (thr->ptid, true);
5898 /* Next, if the target can specify a description, read it. We do
5899 this before anything involving memory or registers. */
5900 target_find_description ();
5902 if (!target_is_non_stop_p ())
5904 /* Use the previously fetched status. */
5905 gdb_assert (wait_status != NULL);
5907 if (target_can_async_p ())
5909 struct notif_event *reply
5910 = remote_notif_parse (this, ¬if_client_stop, wait_status);
5912 push_stop_reply ((struct stop_reply *) reply);
5918 gdb_assert (wait_status != NULL);
5919 strcpy (rs->buf, wait_status);
5920 rs->cached_wait_status = 1;
5924 gdb_assert (wait_status == NULL);
5927 /* Implementation of the to_post_attach method. */
5930 extended_remote_target::post_attach (int pid)
5932 /* Get text, data & bss offsets. */
5935 /* In certain cases GDB might not have had the chance to start
5936 symbol lookup up until now. This could happen if the debugged
5937 binary is not using shared libraries, the vsyscall page is not
5938 present (on Linux) and the binary itself hadn't changed since the
5939 debugging process was started. */
5940 if (symfile_objfile != NULL)
5941 remote_check_symbols();
5945 /* Check for the availability of vCont. This function should also check
5949 remote_target::remote_vcont_probe ()
5951 remote_state *rs = get_remote_state ();
5954 strcpy (rs->buf, "vCont?");
5956 getpkt (&rs->buf, &rs->buf_size, 0);
5959 /* Make sure that the features we assume are supported. */
5960 if (startswith (buf, "vCont"))
5963 int support_c, support_C;
5965 rs->supports_vCont.s = 0;
5966 rs->supports_vCont.S = 0;
5969 rs->supports_vCont.t = 0;
5970 rs->supports_vCont.r = 0;
5971 while (p && *p == ';')
5974 if (*p == 's' && (*(p + 1) == ';' || *(p + 1) == 0))
5975 rs->supports_vCont.s = 1;
5976 else if (*p == 'S' && (*(p + 1) == ';' || *(p + 1) == 0))
5977 rs->supports_vCont.S = 1;
5978 else if (*p == 'c' && (*(p + 1) == ';' || *(p + 1) == 0))
5980 else if (*p == 'C' && (*(p + 1) == ';' || *(p + 1) == 0))
5982 else if (*p == 't' && (*(p + 1) == ';' || *(p + 1) == 0))
5983 rs->supports_vCont.t = 1;
5984 else if (*p == 'r' && (*(p + 1) == ';' || *(p + 1) == 0))
5985 rs->supports_vCont.r = 1;
5987 p = strchr (p, ';');
5990 /* If c, and C are not all supported, we can't use vCont. Clearing
5991 BUF will make packet_ok disable the packet. */
5992 if (!support_c || !support_C)
5996 packet_ok (buf, &remote_protocol_packets[PACKET_vCont]);
5999 /* Helper function for building "vCont" resumptions. Write a
6000 resumption to P. ENDP points to one-passed-the-end of the buffer
6001 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
6002 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
6003 resumed thread should be single-stepped and/or signalled. If PTID
6004 equals minus_one_ptid, then all threads are resumed; if PTID
6005 represents a process, then all threads of the process are resumed;
6006 the thread to be stepped and/or signalled is given in the global
6010 remote_target::append_resumption (char *p, char *endp,
6011 ptid_t ptid, int step, gdb_signal siggnal)
6013 struct remote_state *rs = get_remote_state ();
6015 if (step && siggnal != GDB_SIGNAL_0)
6016 p += xsnprintf (p, endp - p, ";S%02x", siggnal);
6018 /* GDB is willing to range step. */
6019 && use_range_stepping
6020 /* Target supports range stepping. */
6021 && rs->supports_vCont.r
6022 /* We don't currently support range stepping multiple
6023 threads with a wildcard (though the protocol allows it,
6024 so stubs shouldn't make an active effort to forbid
6026 && !(remote_multi_process_p (rs) && ptid.is_pid ()))
6028 struct thread_info *tp;
6030 if (ptid == minus_one_ptid)
6032 /* If we don't know about the target thread's tid, then
6033 we're resuming magic_null_ptid (see caller). */
6034 tp = find_thread_ptid (magic_null_ptid);
6037 tp = find_thread_ptid (ptid);
6038 gdb_assert (tp != NULL);
6040 if (tp->control.may_range_step)
6042 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
6044 p += xsnprintf (p, endp - p, ";r%s,%s",
6045 phex_nz (tp->control.step_range_start,
6047 phex_nz (tp->control.step_range_end,
6051 p += xsnprintf (p, endp - p, ";s");
6054 p += xsnprintf (p, endp - p, ";s");
6055 else if (siggnal != GDB_SIGNAL_0)
6056 p += xsnprintf (p, endp - p, ";C%02x", siggnal);
6058 p += xsnprintf (p, endp - p, ";c");
6060 if (remote_multi_process_p (rs) && ptid.is_pid ())
6064 /* All (-1) threads of process. */
6065 nptid = ptid_t (ptid.pid (), -1, 0);
6067 p += xsnprintf (p, endp - p, ":");
6068 p = write_ptid (p, endp, nptid);
6070 else if (ptid != minus_one_ptid)
6072 p += xsnprintf (p, endp - p, ":");
6073 p = write_ptid (p, endp, ptid);
6079 /* Clear the thread's private info on resume. */
6082 resume_clear_thread_private_info (struct thread_info *thread)
6084 if (thread->priv != NULL)
6086 remote_thread_info *priv = get_remote_thread_info (thread);
6088 priv->stop_reason = TARGET_STOPPED_BY_NO_REASON;
6089 priv->watch_data_address = 0;
6093 /* Append a vCont continue-with-signal action for threads that have a
6094 non-zero stop signal. */
6097 remote_target::append_pending_thread_resumptions (char *p, char *endp,
6100 for (thread_info *thread : all_non_exited_threads (ptid))
6101 if (inferior_ptid != thread->ptid
6102 && thread->suspend.stop_signal != GDB_SIGNAL_0)
6104 p = append_resumption (p, endp, thread->ptid,
6105 0, thread->suspend.stop_signal);
6106 thread->suspend.stop_signal = GDB_SIGNAL_0;
6107 resume_clear_thread_private_info (thread);
6113 /* Set the target running, using the packets that use Hc
6117 remote_target::remote_resume_with_hc (ptid_t ptid, int step,
6120 struct remote_state *rs = get_remote_state ();
6123 rs->last_sent_signal = siggnal;
6124 rs->last_sent_step = step;
6126 /* The c/s/C/S resume packets use Hc, so set the continue
6128 if (ptid == minus_one_ptid)
6129 set_continue_thread (any_thread_ptid);
6131 set_continue_thread (ptid);
6133 for (thread_info *thread : all_non_exited_threads ())
6134 resume_clear_thread_private_info (thread);
6137 if (::execution_direction == EXEC_REVERSE)
6139 /* We don't pass signals to the target in reverse exec mode. */
6140 if (info_verbose && siggnal != GDB_SIGNAL_0)
6141 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
6144 if (step && packet_support (PACKET_bs) == PACKET_DISABLE)
6145 error (_("Remote reverse-step not supported."));
6146 if (!step && packet_support (PACKET_bc) == PACKET_DISABLE)
6147 error (_("Remote reverse-continue not supported."));
6149 strcpy (buf, step ? "bs" : "bc");
6151 else if (siggnal != GDB_SIGNAL_0)
6153 buf[0] = step ? 'S' : 'C';
6154 buf[1] = tohex (((int) siggnal >> 4) & 0xf);
6155 buf[2] = tohex (((int) siggnal) & 0xf);
6159 strcpy (buf, step ? "s" : "c");
6164 /* Resume the remote inferior by using a "vCont" packet. The thread
6165 to be resumed is PTID; STEP and SIGGNAL indicate whether the
6166 resumed thread should be single-stepped and/or signalled. If PTID
6167 equals minus_one_ptid, then all threads are resumed; the thread to
6168 be stepped and/or signalled is given in the global INFERIOR_PTID.
6169 This function returns non-zero iff it resumes the inferior.
6171 This function issues a strict subset of all possible vCont commands
6175 remote_target::remote_resume_with_vcont (ptid_t ptid, int step,
6176 enum gdb_signal siggnal)
6178 struct remote_state *rs = get_remote_state ();
6182 /* No reverse execution actions defined for vCont. */
6183 if (::execution_direction == EXEC_REVERSE)
6186 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
6187 remote_vcont_probe ();
6189 if (packet_support (PACKET_vCont) == PACKET_DISABLE)
6193 endp = rs->buf + get_remote_packet_size ();
6195 /* If we could generate a wider range of packets, we'd have to worry
6196 about overflowing BUF. Should there be a generic
6197 "multi-part-packet" packet? */
6199 p += xsnprintf (p, endp - p, "vCont");
6201 if (ptid == magic_null_ptid)
6203 /* MAGIC_NULL_PTID means that we don't have any active threads,
6204 so we don't have any TID numbers the inferior will
6205 understand. Make sure to only send forms that do not specify
6207 append_resumption (p, endp, minus_one_ptid, step, siggnal);
6209 else if (ptid == minus_one_ptid || ptid.is_pid ())
6211 /* Resume all threads (of all processes, or of a single
6212 process), with preference for INFERIOR_PTID. This assumes
6213 inferior_ptid belongs to the set of all threads we are about
6215 if (step || siggnal != GDB_SIGNAL_0)
6217 /* Step inferior_ptid, with or without signal. */
6218 p = append_resumption (p, endp, inferior_ptid, step, siggnal);
6221 /* Also pass down any pending signaled resumption for other
6222 threads not the current. */
6223 p = append_pending_thread_resumptions (p, endp, ptid);
6225 /* And continue others without a signal. */
6226 append_resumption (p, endp, ptid, /*step=*/ 0, GDB_SIGNAL_0);
6230 /* Scheduler locking; resume only PTID. */
6231 append_resumption (p, endp, ptid, step, siggnal);
6234 gdb_assert (strlen (rs->buf) < get_remote_packet_size ());
6237 if (target_is_non_stop_p ())
6239 /* In non-stop, the stub replies to vCont with "OK". The stop
6240 reply will be reported asynchronously by means of a `%Stop'
6242 getpkt (&rs->buf, &rs->buf_size, 0);
6243 if (strcmp (rs->buf, "OK") != 0)
6244 error (_("Unexpected vCont reply in non-stop mode: %s"), rs->buf);
6250 /* Tell the remote machine to resume. */
6253 remote_target::resume (ptid_t ptid, int step, enum gdb_signal siggnal)
6255 struct remote_state *rs = get_remote_state ();
6257 /* When connected in non-stop mode, the core resumes threads
6258 individually. Resuming remote threads directly in target_resume
6259 would thus result in sending one packet per thread. Instead, to
6260 minimize roundtrip latency, here we just store the resume
6261 request; the actual remote resumption will be done in
6262 target_commit_resume / remote_commit_resume, where we'll be able
6263 to do vCont action coalescing. */
6264 if (target_is_non_stop_p () && ::execution_direction != EXEC_REVERSE)
6266 remote_thread_info *remote_thr;
6268 if (minus_one_ptid == ptid || ptid.is_pid ())
6269 remote_thr = get_remote_thread_info (inferior_ptid);
6271 remote_thr = get_remote_thread_info (ptid);
6273 remote_thr->last_resume_step = step;
6274 remote_thr->last_resume_sig = siggnal;
6278 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
6279 (explained in remote-notif.c:handle_notification) so
6280 remote_notif_process is not called. We need find a place where
6281 it is safe to start a 'vNotif' sequence. It is good to do it
6282 before resuming inferior, because inferior was stopped and no RSP
6283 traffic at that moment. */
6284 if (!target_is_non_stop_p ())
6285 remote_notif_process (rs->notif_state, ¬if_client_stop);
6287 rs->last_resume_exec_dir = ::execution_direction;
6289 /* Prefer vCont, and fallback to s/c/S/C, which use Hc. */
6290 if (!remote_resume_with_vcont (ptid, step, siggnal))
6291 remote_resume_with_hc (ptid, step, siggnal);
6293 /* We are about to start executing the inferior, let's register it
6294 with the event loop. NOTE: this is the one place where all the
6295 execution commands end up. We could alternatively do this in each
6296 of the execution commands in infcmd.c. */
6297 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
6298 into infcmd.c in order to allow inferior function calls to work
6299 NOT asynchronously. */
6300 if (target_can_async_p ())
6303 /* We've just told the target to resume. The remote server will
6304 wait for the inferior to stop, and then send a stop reply. In
6305 the mean time, we can't start another command/query ourselves
6306 because the stub wouldn't be ready to process it. This applies
6307 only to the base all-stop protocol, however. In non-stop (which
6308 only supports vCont), the stub replies with an "OK", and is
6309 immediate able to process further serial input. */
6310 if (!target_is_non_stop_p ())
6311 rs->waiting_for_stop_reply = 1;
6314 static int is_pending_fork_parent_thread (struct thread_info *thread);
6316 /* Private per-inferior info for target remote processes. */
6318 struct remote_inferior : public private_inferior
6320 /* Whether we can send a wildcard vCont for this process. */
6321 bool may_wildcard_vcont = true;
6324 /* Get the remote private inferior data associated to INF. */
6326 static remote_inferior *
6327 get_remote_inferior (inferior *inf)
6329 if (inf->priv == NULL)
6330 inf->priv.reset (new remote_inferior);
6332 return static_cast<remote_inferior *> (inf->priv.get ());
6335 /* Class used to track the construction of a vCont packet in the
6336 outgoing packet buffer. This is used to send multiple vCont
6337 packets if we have more actions than would fit a single packet. */
6342 explicit vcont_builder (remote_target *remote)
6349 void push_action (ptid_t ptid, bool step, gdb_signal siggnal);
6354 /* The remote target. */
6355 remote_target *m_remote;
6357 /* Pointer to the first action. P points here if no action has been
6359 char *m_first_action;
6361 /* Where the next action will be appended. */
6364 /* The end of the buffer. Must never write past this. */
6368 /* Prepare the outgoing buffer for a new vCont packet. */
6371 vcont_builder::restart ()
6373 struct remote_state *rs = m_remote->get_remote_state ();
6376 m_endp = rs->buf + m_remote->get_remote_packet_size ();
6377 m_p += xsnprintf (m_p, m_endp - m_p, "vCont");
6378 m_first_action = m_p;
6381 /* If the vCont packet being built has any action, send it to the
6385 vcont_builder::flush ()
6387 struct remote_state *rs;
6389 if (m_p == m_first_action)
6392 rs = m_remote->get_remote_state ();
6393 m_remote->putpkt (rs->buf);
6394 m_remote->getpkt (&rs->buf, &rs->buf_size, 0);
6395 if (strcmp (rs->buf, "OK") != 0)
6396 error (_("Unexpected vCont reply in non-stop mode: %s"), rs->buf);
6399 /* The largest action is range-stepping, with its two addresses. This
6400 is more than sufficient. If a new, bigger action is created, it'll
6401 quickly trigger a failed assertion in append_resumption (and we'll
6403 #define MAX_ACTION_SIZE 200
6405 /* Append a new vCont action in the outgoing packet being built. If
6406 the action doesn't fit the packet along with previous actions, push
6407 what we've got so far to the remote end and start over a new vCont
6408 packet (with the new action). */
6411 vcont_builder::push_action (ptid_t ptid, bool step, gdb_signal siggnal)
6413 char buf[MAX_ACTION_SIZE + 1];
6415 char *endp = m_remote->append_resumption (buf, buf + sizeof (buf),
6416 ptid, step, siggnal);
6418 /* Check whether this new action would fit in the vCont packet along
6419 with previous actions. If not, send what we've got so far and
6420 start a new vCont packet. */
6421 size_t rsize = endp - buf;
6422 if (rsize > m_endp - m_p)
6427 /* Should now fit. */
6428 gdb_assert (rsize <= m_endp - m_p);
6431 memcpy (m_p, buf, rsize);
6436 /* to_commit_resume implementation. */
6439 remote_target::commit_resume ()
6441 int any_process_wildcard;
6442 int may_global_wildcard_vcont;
6444 /* If connected in all-stop mode, we'd send the remote resume
6445 request directly from remote_resume. Likewise if
6446 reverse-debugging, as there are no defined vCont actions for
6447 reverse execution. */
6448 if (!target_is_non_stop_p () || ::execution_direction == EXEC_REVERSE)
6451 /* Try to send wildcard actions ("vCont;c" or "vCont;c:pPID.-1")
6452 instead of resuming all threads of each process individually.
6453 However, if any thread of a process must remain halted, we can't
6454 send wildcard resumes and must send one action per thread.
6456 Care must be taken to not resume threads/processes the server
6457 side already told us are stopped, but the core doesn't know about
6458 yet, because the events are still in the vStopped notification
6461 #1 => vCont s:p1.1;c
6463 #3 <= %Stopped T05 p1.1
6468 #8 (infrun handles the stop for p1.1 and continues stepping)
6469 #9 => vCont s:p1.1;c
6471 The last vCont above would resume thread p1.2 by mistake, because
6472 the server has no idea that the event for p1.2 had not been
6475 The server side must similarly ignore resume actions for the
6476 thread that has a pending %Stopped notification (and any other
6477 threads with events pending), until GDB acks the notification
6478 with vStopped. Otherwise, e.g., the following case is
6481 #1 => g (or any other packet)
6483 #3 <= %Stopped T05 p1.2
6484 #4 => vCont s:p1.1;c
6487 Above, the server must not resume thread p1.2. GDB can't know
6488 that p1.2 stopped until it acks the %Stopped notification, and
6489 since from GDB's perspective all threads should be running, it
6492 Finally, special care must also be given to handling fork/vfork
6493 events. A (v)fork event actually tells us that two processes
6494 stopped -- the parent and the child. Until we follow the fork,
6495 we must not resume the child. Therefore, if we have a pending
6496 fork follow, we must not send a global wildcard resume action
6497 (vCont;c). We can still send process-wide wildcards though. */
6499 /* Start by assuming a global wildcard (vCont;c) is possible. */
6500 may_global_wildcard_vcont = 1;
6502 /* And assume every process is individually wildcard-able too. */
6503 for (inferior *inf : all_non_exited_inferiors ())
6505 remote_inferior *priv = get_remote_inferior (inf);
6507 priv->may_wildcard_vcont = true;
6510 /* Check for any pending events (not reported or processed yet) and
6511 disable process and global wildcard resumes appropriately. */
6512 check_pending_events_prevent_wildcard_vcont (&may_global_wildcard_vcont);
6514 for (thread_info *tp : all_non_exited_threads ())
6516 /* If a thread of a process is not meant to be resumed, then we
6517 can't wildcard that process. */
6520 get_remote_inferior (tp->inf)->may_wildcard_vcont = false;
6522 /* And if we can't wildcard a process, we can't wildcard
6523 everything either. */
6524 may_global_wildcard_vcont = 0;
6528 /* If a thread is the parent of an unfollowed fork, then we
6529 can't do a global wildcard, as that would resume the fork
6531 if (is_pending_fork_parent_thread (tp))
6532 may_global_wildcard_vcont = 0;
6535 /* Now let's build the vCont packet(s). Actions must be appended
6536 from narrower to wider scopes (thread -> process -> global). If
6537 we end up with too many actions for a single packet vcont_builder
6538 flushes the current vCont packet to the remote side and starts a
6540 struct vcont_builder vcont_builder (this);
6542 /* Threads first. */
6543 for (thread_info *tp : all_non_exited_threads ())
6545 remote_thread_info *remote_thr = get_remote_thread_info (tp);
6547 if (!tp->executing || remote_thr->vcont_resumed)
6550 gdb_assert (!thread_is_in_step_over_chain (tp));
6552 if (!remote_thr->last_resume_step
6553 && remote_thr->last_resume_sig == GDB_SIGNAL_0
6554 && get_remote_inferior (tp->inf)->may_wildcard_vcont)
6556 /* We'll send a wildcard resume instead. */
6557 remote_thr->vcont_resumed = 1;
6561 vcont_builder.push_action (tp->ptid,
6562 remote_thr->last_resume_step,
6563 remote_thr->last_resume_sig);
6564 remote_thr->vcont_resumed = 1;
6567 /* Now check whether we can send any process-wide wildcard. This is
6568 to avoid sending a global wildcard in the case nothing is
6569 supposed to be resumed. */
6570 any_process_wildcard = 0;
6572 for (inferior *inf : all_non_exited_inferiors ())
6574 if (get_remote_inferior (inf)->may_wildcard_vcont)
6576 any_process_wildcard = 1;
6581 if (any_process_wildcard)
6583 /* If all processes are wildcard-able, then send a single "c"
6584 action, otherwise, send an "all (-1) threads of process"
6585 continue action for each running process, if any. */
6586 if (may_global_wildcard_vcont)
6588 vcont_builder.push_action (minus_one_ptid,
6589 false, GDB_SIGNAL_0);
6593 for (inferior *inf : all_non_exited_inferiors ())
6595 if (get_remote_inferior (inf)->may_wildcard_vcont)
6597 vcont_builder.push_action (ptid_t (inf->pid),
6598 false, GDB_SIGNAL_0);
6604 vcont_builder.flush ();
6609 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
6610 thread, all threads of a remote process, or all threads of all
6614 remote_target::remote_stop_ns (ptid_t ptid)
6616 struct remote_state *rs = get_remote_state ();
6618 char *endp = rs->buf + get_remote_packet_size ();
6620 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
6621 remote_vcont_probe ();
6623 if (!rs->supports_vCont.t)
6624 error (_("Remote server does not support stopping threads"));
6626 if (ptid == minus_one_ptid
6627 || (!remote_multi_process_p (rs) && ptid.is_pid ()))
6628 p += xsnprintf (p, endp - p, "vCont;t");
6633 p += xsnprintf (p, endp - p, "vCont;t:");
6636 /* All (-1) threads of process. */
6637 nptid = ptid_t (ptid.pid (), -1, 0);
6640 /* Small optimization: if we already have a stop reply for
6641 this thread, no use in telling the stub we want this
6643 if (peek_stop_reply (ptid))
6649 write_ptid (p, endp, nptid);
6652 /* In non-stop, we get an immediate OK reply. The stop reply will
6653 come in asynchronously by notification. */
6655 getpkt (&rs->buf, &rs->buf_size, 0);
6656 if (strcmp (rs->buf, "OK") != 0)
6657 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid), rs->buf);
6660 /* All-stop version of target_interrupt. Sends a break or a ^C to
6661 interrupt the remote target. It is undefined which thread of which
6662 process reports the interrupt. */
6665 remote_target::remote_interrupt_as ()
6667 struct remote_state *rs = get_remote_state ();
6669 rs->ctrlc_pending_p = 1;
6671 /* If the inferior is stopped already, but the core didn't know
6672 about it yet, just ignore the request. The cached wait status
6673 will be collected in remote_wait. */
6674 if (rs->cached_wait_status)
6677 /* Send interrupt_sequence to remote target. */
6678 send_interrupt_sequence ();
6681 /* Non-stop version of target_interrupt. Uses `vCtrlC' to interrupt
6682 the remote target. It is undefined which thread of which process
6683 reports the interrupt. Throws an error if the packet is not
6684 supported by the server. */
6687 remote_target::remote_interrupt_ns ()
6689 struct remote_state *rs = get_remote_state ();
6691 char *endp = rs->buf + get_remote_packet_size ();
6693 xsnprintf (p, endp - p, "vCtrlC");
6695 /* In non-stop, we get an immediate OK reply. The stop reply will
6696 come in asynchronously by notification. */
6698 getpkt (&rs->buf, &rs->buf_size, 0);
6700 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_vCtrlC]))
6704 case PACKET_UNKNOWN:
6705 error (_("No support for interrupting the remote target."));
6707 error (_("Interrupting target failed: %s"), rs->buf);
6711 /* Implement the to_stop function for the remote targets. */
6714 remote_target::stop (ptid_t ptid)
6717 fprintf_unfiltered (gdb_stdlog, "remote_stop called\n");
6719 if (target_is_non_stop_p ())
6720 remote_stop_ns (ptid);
6723 /* We don't currently have a way to transparently pause the
6724 remote target in all-stop mode. Interrupt it instead. */
6725 remote_interrupt_as ();
6729 /* Implement the to_interrupt function for the remote targets. */
6732 remote_target::interrupt ()
6735 fprintf_unfiltered (gdb_stdlog, "remote_interrupt called\n");
6737 if (target_is_non_stop_p ())
6738 remote_interrupt_ns ();
6740 remote_interrupt_as ();
6743 /* Implement the to_pass_ctrlc function for the remote targets. */
6746 remote_target::pass_ctrlc ()
6748 struct remote_state *rs = get_remote_state ();
6751 fprintf_unfiltered (gdb_stdlog, "remote_pass_ctrlc called\n");
6753 /* If we're starting up, we're not fully synced yet. Quit
6755 if (rs->starting_up)
6757 /* If ^C has already been sent once, offer to disconnect. */
6758 else if (rs->ctrlc_pending_p)
6761 target_interrupt ();
6764 /* Ask the user what to do when an interrupt is received. */
6767 remote_target::interrupt_query ()
6769 struct remote_state *rs = get_remote_state ();
6771 if (rs->waiting_for_stop_reply && rs->ctrlc_pending_p)
6773 if (query (_("The target is not responding to interrupt requests.\n"
6774 "Stop debugging it? ")))
6776 remote_unpush_target ();
6777 throw_error (TARGET_CLOSE_ERROR, _("Disconnected from target."));
6782 if (query (_("Interrupted while waiting for the program.\n"
6783 "Give up waiting? ")))
6788 /* Enable/disable target terminal ownership. Most targets can use
6789 terminal groups to control terminal ownership. Remote targets are
6790 different in that explicit transfer of ownership to/from GDB/target
6794 remote_target::terminal_inferior ()
6796 /* NOTE: At this point we could also register our selves as the
6797 recipient of all input. Any characters typed could then be
6798 passed on down to the target. */
6802 remote_target::terminal_ours ()
6807 remote_console_output (char *msg)
6811 for (p = msg; p[0] && p[1]; p += 2)
6814 char c = fromhex (p[0]) * 16 + fromhex (p[1]);
6818 fputs_unfiltered (tb, gdb_stdtarg);
6820 gdb_flush (gdb_stdtarg);
6823 DEF_VEC_O(cached_reg_t);
6825 typedef struct stop_reply
6827 struct notif_event base;
6829 /* The identifier of the thread about this event */
6832 /* The remote state this event is associated with. When the remote
6833 connection, represented by a remote_state object, is closed,
6834 all the associated stop_reply events should be released. */
6835 struct remote_state *rs;
6837 struct target_waitstatus ws;
6839 /* The architecture associated with the expedited registers. */
6842 /* Expedited registers. This makes remote debugging a bit more
6843 efficient for those targets that provide critical registers as
6844 part of their normal status mechanism (as another roundtrip to
6845 fetch them is avoided). */
6846 VEC(cached_reg_t) *regcache;
6848 enum target_stop_reason stop_reason;
6850 CORE_ADDR watch_data_address;
6856 stop_reply_xfree (struct stop_reply *r)
6858 notif_event_xfree ((struct notif_event *) r);
6861 /* Return the length of the stop reply queue. */
6864 remote_target::stop_reply_queue_length ()
6866 remote_state *rs = get_remote_state ();
6867 return rs->stop_reply_queue.size ();
6871 remote_notif_stop_parse (remote_target *remote,
6872 struct notif_client *self, char *buf,
6873 struct notif_event *event)
6875 remote->remote_parse_stop_reply (buf, (struct stop_reply *) event);
6879 remote_notif_stop_ack (remote_target *remote,
6880 struct notif_client *self, char *buf,
6881 struct notif_event *event)
6883 struct stop_reply *stop_reply = (struct stop_reply *) event;
6886 putpkt (remote, self->ack_command);
6888 if (stop_reply->ws.kind == TARGET_WAITKIND_IGNORE)
6890 /* We got an unknown stop reply. */
6891 error (_("Unknown stop reply"));
6894 remote->push_stop_reply (stop_reply);
6898 remote_notif_stop_can_get_pending_events (remote_target *remote,
6899 struct notif_client *self)
6901 /* We can't get pending events in remote_notif_process for
6902 notification stop, and we have to do this in remote_wait_ns
6903 instead. If we fetch all queued events from stub, remote stub
6904 may exit and we have no chance to process them back in
6906 remote_state *rs = remote->get_remote_state ();
6907 mark_async_event_handler (rs->remote_async_inferior_event_token);
6912 stop_reply_dtr (struct notif_event *event)
6914 struct stop_reply *r = (struct stop_reply *) event;
6919 VEC_iterate (cached_reg_t, r->regcache, ix, reg);
6923 VEC_free (cached_reg_t, r->regcache);
6926 static struct notif_event *
6927 remote_notif_stop_alloc_reply (void)
6929 /* We cast to a pointer to the "base class". */
6930 struct notif_event *r = (struct notif_event *) XNEW (struct stop_reply);
6932 r->dtr = stop_reply_dtr;
6937 /* A client of notification Stop. */
6939 struct notif_client notif_client_stop =
6943 remote_notif_stop_parse,
6944 remote_notif_stop_ack,
6945 remote_notif_stop_can_get_pending_events,
6946 remote_notif_stop_alloc_reply,
6950 /* Determine if THREAD_PTID is a pending fork parent thread. ARG contains
6951 the pid of the process that owns the threads we want to check, or
6952 -1 if we want to check all threads. */
6955 is_pending_fork_parent (struct target_waitstatus *ws, int event_pid,
6958 if (ws->kind == TARGET_WAITKIND_FORKED
6959 || ws->kind == TARGET_WAITKIND_VFORKED)
6961 if (event_pid == -1 || event_pid == thread_ptid.pid ())
6968 /* Return the thread's pending status used to determine whether the
6969 thread is a fork parent stopped at a fork event. */
6971 static struct target_waitstatus *
6972 thread_pending_fork_status (struct thread_info *thread)
6974 if (thread->suspend.waitstatus_pending_p)
6975 return &thread->suspend.waitstatus;
6977 return &thread->pending_follow;
6980 /* Determine if THREAD is a pending fork parent thread. */
6983 is_pending_fork_parent_thread (struct thread_info *thread)
6985 struct target_waitstatus *ws = thread_pending_fork_status (thread);
6988 return is_pending_fork_parent (ws, pid, thread->ptid);
6991 /* If CONTEXT contains any fork child threads that have not been
6992 reported yet, remove them from the CONTEXT list. If such a
6993 thread exists it is because we are stopped at a fork catchpoint
6994 and have not yet called follow_fork, which will set up the
6995 host-side data structures for the new process. */
6998 remote_target::remove_new_fork_children (threads_listing_context *context)
7001 struct notif_client *notif = ¬if_client_stop;
7003 /* For any threads stopped at a fork event, remove the corresponding
7004 fork child threads from the CONTEXT list. */
7005 for (thread_info *thread : all_non_exited_threads ())
7007 struct target_waitstatus *ws = thread_pending_fork_status (thread);
7009 if (is_pending_fork_parent (ws, pid, thread->ptid))
7010 context->remove_thread (ws->value.related_pid);
7013 /* Check for any pending fork events (not reported or processed yet)
7014 in process PID and remove those fork child threads from the
7015 CONTEXT list as well. */
7016 remote_notif_get_pending_events (notif);
7017 for (auto &event : get_remote_state ()->stop_reply_queue)
7018 if (event->ws.kind == TARGET_WAITKIND_FORKED
7019 || event->ws.kind == TARGET_WAITKIND_VFORKED
7020 || event->ws.kind == TARGET_WAITKIND_THREAD_EXITED)
7021 context->remove_thread (event->ws.value.related_pid);
7024 /* Check whether any event pending in the vStopped queue would prevent
7025 a global or process wildcard vCont action. Clear
7026 *may_global_wildcard if we can't do a global wildcard (vCont;c),
7027 and clear the event inferior's may_wildcard_vcont flag if we can't
7028 do a process-wide wildcard resume (vCont;c:pPID.-1). */
7031 remote_target::check_pending_events_prevent_wildcard_vcont
7032 (int *may_global_wildcard)
7034 struct notif_client *notif = ¬if_client_stop;
7036 remote_notif_get_pending_events (notif);
7037 for (auto &event : get_remote_state ()->stop_reply_queue)
7039 if (event->ws.kind == TARGET_WAITKIND_NO_RESUMED
7040 || event->ws.kind == TARGET_WAITKIND_NO_HISTORY)
7043 if (event->ws.kind == TARGET_WAITKIND_FORKED
7044 || event->ws.kind == TARGET_WAITKIND_VFORKED)
7045 *may_global_wildcard = 0;
7047 struct inferior *inf = find_inferior_ptid (event->ptid);
7049 /* This may be the first time we heard about this process.
7050 Regardless, we must not do a global wildcard resume, otherwise
7051 we'd resume this process too. */
7052 *may_global_wildcard = 0;
7054 get_remote_inferior (inf)->may_wildcard_vcont = false;
7058 /* Discard all pending stop replies of inferior INF. */
7061 remote_target::discard_pending_stop_replies (struct inferior *inf)
7063 struct stop_reply *reply;
7064 struct remote_state *rs = get_remote_state ();
7065 struct remote_notif_state *rns = rs->notif_state;
7067 /* This function can be notified when an inferior exists. When the
7068 target is not remote, the notification state is NULL. */
7069 if (rs->remote_desc == NULL)
7072 reply = (struct stop_reply *) rns->pending_event[notif_client_stop.id];
7074 /* Discard the in-flight notification. */
7075 if (reply != NULL && reply->ptid.pid () == inf->pid)
7077 stop_reply_xfree (reply);
7078 rns->pending_event[notif_client_stop.id] = NULL;
7081 /* Discard the stop replies we have already pulled with
7083 auto iter = std::remove_if (rs->stop_reply_queue.begin (),
7084 rs->stop_reply_queue.end (),
7085 [=] (const stop_reply_up &event)
7087 return event->ptid.pid () == inf->pid;
7089 rs->stop_reply_queue.erase (iter, rs->stop_reply_queue.end ());
7092 /* Discard the stop replies for RS in stop_reply_queue. */
7095 remote_target::discard_pending_stop_replies_in_queue ()
7097 remote_state *rs = get_remote_state ();
7099 /* Discard the stop replies we have already pulled with
7101 auto iter = std::remove_if (rs->stop_reply_queue.begin (),
7102 rs->stop_reply_queue.end (),
7103 [=] (const stop_reply_up &event)
7105 return event->rs == rs;
7107 rs->stop_reply_queue.erase (iter, rs->stop_reply_queue.end ());
7110 /* Remove the first reply in 'stop_reply_queue' which matches
7114 remote_target::remote_notif_remove_queued_reply (ptid_t ptid)
7116 remote_state *rs = get_remote_state ();
7118 auto iter = std::find_if (rs->stop_reply_queue.begin (),
7119 rs->stop_reply_queue.end (),
7120 [=] (const stop_reply_up &event)
7122 return event->ptid.matches (ptid);
7124 struct stop_reply *result;
7125 if (iter == rs->stop_reply_queue.end ())
7129 result = iter->release ();
7130 rs->stop_reply_queue.erase (iter);
7134 fprintf_unfiltered (gdb_stdlog,
7135 "notif: discard queued event: 'Stop' in %s\n",
7136 target_pid_to_str (ptid));
7141 /* Look for a queued stop reply belonging to PTID. If one is found,
7142 remove it from the queue, and return it. Returns NULL if none is
7143 found. If there are still queued events left to process, tell the
7144 event loop to get back to target_wait soon. */
7147 remote_target::queued_stop_reply (ptid_t ptid)
7149 remote_state *rs = get_remote_state ();
7150 struct stop_reply *r = remote_notif_remove_queued_reply (ptid);
7152 if (!rs->stop_reply_queue.empty ())
7154 /* There's still at least an event left. */
7155 mark_async_event_handler (rs->remote_async_inferior_event_token);
7161 /* Push a fully parsed stop reply in the stop reply queue. Since we
7162 know that we now have at least one queued event left to pass to the
7163 core side, tell the event loop to get back to target_wait soon. */
7166 remote_target::push_stop_reply (struct stop_reply *new_event)
7168 remote_state *rs = get_remote_state ();
7169 rs->stop_reply_queue.push_back (stop_reply_up (new_event));
7172 fprintf_unfiltered (gdb_stdlog,
7173 "notif: push 'Stop' %s to queue %d\n",
7174 target_pid_to_str (new_event->ptid),
7175 int (rs->stop_reply_queue.size ()));
7177 mark_async_event_handler (rs->remote_async_inferior_event_token);
7180 /* Returns true if we have a stop reply for PTID. */
7183 remote_target::peek_stop_reply (ptid_t ptid)
7185 remote_state *rs = get_remote_state ();
7186 for (auto &event : rs->stop_reply_queue)
7187 if (ptid == event->ptid
7188 && event->ws.kind == TARGET_WAITKIND_STOPPED)
7193 /* Helper for remote_parse_stop_reply. Return nonzero if the substring
7194 starting with P and ending with PEND matches PREFIX. */
7197 strprefix (const char *p, const char *pend, const char *prefix)
7199 for ( ; p < pend; p++, prefix++)
7202 return *prefix == '\0';
7205 /* Parse the stop reply in BUF. Either the function succeeds, and the
7206 result is stored in EVENT, or throws an error. */
7209 remote_target::remote_parse_stop_reply (char *buf, stop_reply *event)
7211 remote_arch_state *rsa = NULL;
7216 event->ptid = null_ptid;
7217 event->rs = get_remote_state ();
7218 event->ws.kind = TARGET_WAITKIND_IGNORE;
7219 event->ws.value.integer = 0;
7220 event->stop_reason = TARGET_STOPPED_BY_NO_REASON;
7221 event->regcache = NULL;
7226 case 'T': /* Status with PC, SP, FP, ... */
7227 /* Expedited reply, containing Signal, {regno, reg} repeat. */
7228 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
7230 n... = register number
7231 r... = register contents
7234 p = &buf[3]; /* after Txx */
7240 p1 = strchr (p, ':');
7242 error (_("Malformed packet(a) (missing colon): %s\n\
7246 error (_("Malformed packet(a) (missing register number): %s\n\
7250 /* Some "registers" are actually extended stop information.
7251 Note if you're adding a new entry here: GDB 7.9 and
7252 earlier assume that all register "numbers" that start
7253 with an hex digit are real register numbers. Make sure
7254 the server only sends such a packet if it knows the
7255 client understands it. */
7257 if (strprefix (p, p1, "thread"))
7258 event->ptid = read_ptid (++p1, &p);
7259 else if (strprefix (p, p1, "syscall_entry"))
7263 event->ws.kind = TARGET_WAITKIND_SYSCALL_ENTRY;
7264 p = unpack_varlen_hex (++p1, &sysno);
7265 event->ws.value.syscall_number = (int) sysno;
7267 else if (strprefix (p, p1, "syscall_return"))
7271 event->ws.kind = TARGET_WAITKIND_SYSCALL_RETURN;
7272 p = unpack_varlen_hex (++p1, &sysno);
7273 event->ws.value.syscall_number = (int) sysno;
7275 else if (strprefix (p, p1, "watch")
7276 || strprefix (p, p1, "rwatch")
7277 || strprefix (p, p1, "awatch"))
7279 event->stop_reason = TARGET_STOPPED_BY_WATCHPOINT;
7280 p = unpack_varlen_hex (++p1, &addr);
7281 event->watch_data_address = (CORE_ADDR) addr;
7283 else if (strprefix (p, p1, "swbreak"))
7285 event->stop_reason = TARGET_STOPPED_BY_SW_BREAKPOINT;
7287 /* Make sure the stub doesn't forget to indicate support
7289 if (packet_support (PACKET_swbreak_feature) != PACKET_ENABLE)
7290 error (_("Unexpected swbreak stop reason"));
7292 /* The value part is documented as "must be empty",
7293 though we ignore it, in case we ever decide to make
7294 use of it in a backward compatible way. */
7295 p = strchrnul (p1 + 1, ';');
7297 else if (strprefix (p, p1, "hwbreak"))
7299 event->stop_reason = TARGET_STOPPED_BY_HW_BREAKPOINT;
7301 /* Make sure the stub doesn't forget to indicate support
7303 if (packet_support (PACKET_hwbreak_feature) != PACKET_ENABLE)
7304 error (_("Unexpected hwbreak stop reason"));
7307 p = strchrnul (p1 + 1, ';');
7309 else if (strprefix (p, p1, "library"))
7311 event->ws.kind = TARGET_WAITKIND_LOADED;
7312 p = strchrnul (p1 + 1, ';');
7314 else if (strprefix (p, p1, "replaylog"))
7316 event->ws.kind = TARGET_WAITKIND_NO_HISTORY;
7317 /* p1 will indicate "begin" or "end", but it makes
7318 no difference for now, so ignore it. */
7319 p = strchrnul (p1 + 1, ';');
7321 else if (strprefix (p, p1, "core"))
7325 p = unpack_varlen_hex (++p1, &c);
7328 else if (strprefix (p, p1, "fork"))
7330 event->ws.value.related_pid = read_ptid (++p1, &p);
7331 event->ws.kind = TARGET_WAITKIND_FORKED;
7333 else if (strprefix (p, p1, "vfork"))
7335 event->ws.value.related_pid = read_ptid (++p1, &p);
7336 event->ws.kind = TARGET_WAITKIND_VFORKED;
7338 else if (strprefix (p, p1, "vforkdone"))
7340 event->ws.kind = TARGET_WAITKIND_VFORK_DONE;
7341 p = strchrnul (p1 + 1, ';');
7343 else if (strprefix (p, p1, "exec"))
7346 char pathname[PATH_MAX];
7349 /* Determine the length of the execd pathname. */
7350 p = unpack_varlen_hex (++p1, &ignored);
7351 pathlen = (p - p1) / 2;
7353 /* Save the pathname for event reporting and for
7354 the next run command. */
7355 hex2bin (p1, (gdb_byte *) pathname, pathlen);
7356 pathname[pathlen] = '\0';
7358 /* This is freed during event handling. */
7359 event->ws.value.execd_pathname = xstrdup (pathname);
7360 event->ws.kind = TARGET_WAITKIND_EXECD;
7362 /* Skip the registers included in this packet, since
7363 they may be for an architecture different from the
7364 one used by the original program. */
7367 else if (strprefix (p, p1, "create"))
7369 event->ws.kind = TARGET_WAITKIND_THREAD_CREATED;
7370 p = strchrnul (p1 + 1, ';');
7379 p = strchrnul (p1 + 1, ';');
7384 /* Maybe a real ``P'' register number. */
7385 p_temp = unpack_varlen_hex (p, &pnum);
7386 /* If the first invalid character is the colon, we got a
7387 register number. Otherwise, it's an unknown stop
7391 /* If we haven't parsed the event's thread yet, find
7392 it now, in order to find the architecture of the
7393 reported expedited registers. */
7394 if (event->ptid == null_ptid)
7396 const char *thr = strstr (p1 + 1, ";thread:");
7398 event->ptid = read_ptid (thr + strlen (";thread:"),
7402 /* Either the current thread hasn't changed,
7403 or the inferior is not multi-threaded.
7404 The event must be for the thread we last
7405 set as (or learned as being) current. */
7406 event->ptid = event->rs->general_thread;
7412 inferior *inf = (event->ptid == null_ptid
7414 : find_inferior_ptid (event->ptid));
7415 /* If this is the first time we learn anything
7416 about this process, skip the registers
7417 included in this packet, since we don't yet
7418 know which architecture to use to parse them.
7419 We'll determine the architecture later when
7420 we process the stop reply and retrieve the
7421 target description, via
7422 remote_notice_new_inferior ->
7423 post_create_inferior. */
7426 p = strchrnul (p1 + 1, ';');
7431 event->arch = inf->gdbarch;
7432 rsa = event->rs->get_remote_arch_state (event->arch);
7436 = packet_reg_from_pnum (event->arch, rsa, pnum);
7437 cached_reg_t cached_reg;
7440 error (_("Remote sent bad register number %s: %s\n\
7442 hex_string (pnum), p, buf);
7444 cached_reg.num = reg->regnum;
7445 cached_reg.data = (gdb_byte *)
7446 xmalloc (register_size (event->arch, reg->regnum));
7449 fieldsize = hex2bin (p, cached_reg.data,
7450 register_size (event->arch, reg->regnum));
7452 if (fieldsize < register_size (event->arch, reg->regnum))
7453 warning (_("Remote reply is too short: %s"), buf);
7455 VEC_safe_push (cached_reg_t, event->regcache, &cached_reg);
7459 /* Not a number. Silently skip unknown optional
7461 p = strchrnul (p1 + 1, ';');
7466 error (_("Remote register badly formatted: %s\nhere: %s"),
7471 if (event->ws.kind != TARGET_WAITKIND_IGNORE)
7475 case 'S': /* Old style status, just signal only. */
7479 event->ws.kind = TARGET_WAITKIND_STOPPED;
7480 sig = (fromhex (buf[1]) << 4) + fromhex (buf[2]);
7481 if (GDB_SIGNAL_FIRST <= sig && sig < GDB_SIGNAL_LAST)
7482 event->ws.value.sig = (enum gdb_signal) sig;
7484 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
7487 case 'w': /* Thread exited. */
7491 event->ws.kind = TARGET_WAITKIND_THREAD_EXITED;
7492 p = unpack_varlen_hex (&buf[1], &value);
7493 event->ws.value.integer = value;
7495 error (_("stop reply packet badly formatted: %s"), buf);
7496 event->ptid = read_ptid (++p, NULL);
7499 case 'W': /* Target exited. */
7505 /* GDB used to accept only 2 hex chars here. Stubs should
7506 only send more if they detect GDB supports multi-process
7508 p = unpack_varlen_hex (&buf[1], &value);
7512 /* The remote process exited. */
7513 event->ws.kind = TARGET_WAITKIND_EXITED;
7514 event->ws.value.integer = value;
7518 /* The remote process exited with a signal. */
7519 event->ws.kind = TARGET_WAITKIND_SIGNALLED;
7520 if (GDB_SIGNAL_FIRST <= value && value < GDB_SIGNAL_LAST)
7521 event->ws.value.sig = (enum gdb_signal) value;
7523 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
7526 /* If no process is specified, assume inferior_ptid. */
7527 pid = inferior_ptid.pid ();
7536 else if (startswith (p, "process:"))
7540 p += sizeof ("process:") - 1;
7541 unpack_varlen_hex (p, &upid);
7545 error (_("unknown stop reply packet: %s"), buf);
7548 error (_("unknown stop reply packet: %s"), buf);
7549 event->ptid = ptid_t (pid);
7553 event->ws.kind = TARGET_WAITKIND_NO_RESUMED;
7554 event->ptid = minus_one_ptid;
7558 if (target_is_non_stop_p () && event->ptid == null_ptid)
7559 error (_("No process or thread specified in stop reply: %s"), buf);
7562 /* When the stub wants to tell GDB about a new notification reply, it
7563 sends a notification (%Stop, for example). Those can come it at
7564 any time, hence, we have to make sure that any pending
7565 putpkt/getpkt sequence we're making is finished, before querying
7566 the stub for more events with the corresponding ack command
7567 (vStopped, for example). E.g., if we started a vStopped sequence
7568 immediately upon receiving the notification, something like this
7576 1.6) <-- (registers reply to step #1.3)
7578 Obviously, the reply in step #1.6 would be unexpected to a vStopped
7581 To solve this, whenever we parse a %Stop notification successfully,
7582 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
7583 doing whatever we were doing:
7589 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
7590 2.5) <-- (registers reply to step #2.3)
7592 Eventualy after step #2.5, we return to the event loop, which
7593 notices there's an event on the
7594 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
7595 associated callback --- the function below. At this point, we're
7596 always safe to start a vStopped sequence. :
7599 2.7) <-- T05 thread:2
7605 remote_target::remote_notif_get_pending_events (notif_client *nc)
7607 struct remote_state *rs = get_remote_state ();
7609 if (rs->notif_state->pending_event[nc->id] != NULL)
7612 fprintf_unfiltered (gdb_stdlog,
7613 "notif: process: '%s' ack pending event\n",
7617 nc->ack (this, nc, rs->buf, rs->notif_state->pending_event[nc->id]);
7618 rs->notif_state->pending_event[nc->id] = NULL;
7622 getpkt (&rs->buf, &rs->buf_size, 0);
7623 if (strcmp (rs->buf, "OK") == 0)
7626 remote_notif_ack (this, nc, rs->buf);
7632 fprintf_unfiltered (gdb_stdlog,
7633 "notif: process: '%s' no pending reply\n",
7638 /* Wrapper around remote_target::remote_notif_get_pending_events to
7639 avoid having to export the whole remote_target class. */
7642 remote_notif_get_pending_events (remote_target *remote, notif_client *nc)
7644 remote->remote_notif_get_pending_events (nc);
7647 /* Called when it is decided that STOP_REPLY holds the info of the
7648 event that is to be returned to the core. This function always
7649 destroys STOP_REPLY. */
7652 remote_target::process_stop_reply (struct stop_reply *stop_reply,
7653 struct target_waitstatus *status)
7657 *status = stop_reply->ws;
7658 ptid = stop_reply->ptid;
7660 /* If no thread/process was reported by the stub, assume the current
7662 if (ptid == null_ptid)
7663 ptid = inferior_ptid;
7665 if (status->kind != TARGET_WAITKIND_EXITED
7666 && status->kind != TARGET_WAITKIND_SIGNALLED
7667 && status->kind != TARGET_WAITKIND_NO_RESUMED)
7669 /* Expedited registers. */
7670 if (stop_reply->regcache)
7672 struct regcache *regcache
7673 = get_thread_arch_regcache (ptid, stop_reply->arch);
7678 VEC_iterate (cached_reg_t, stop_reply->regcache, ix, reg);
7681 regcache->raw_supply (reg->num, reg->data);
7685 VEC_free (cached_reg_t, stop_reply->regcache);
7688 remote_notice_new_inferior (ptid, 0);
7689 remote_thread_info *remote_thr = get_remote_thread_info (ptid);
7690 remote_thr->core = stop_reply->core;
7691 remote_thr->stop_reason = stop_reply->stop_reason;
7692 remote_thr->watch_data_address = stop_reply->watch_data_address;
7693 remote_thr->vcont_resumed = 0;
7696 stop_reply_xfree (stop_reply);
7700 /* The non-stop mode version of target_wait. */
7703 remote_target::wait_ns (ptid_t ptid, struct target_waitstatus *status, int options)
7705 struct remote_state *rs = get_remote_state ();
7706 struct stop_reply *stop_reply;
7710 /* If in non-stop mode, get out of getpkt even if a
7711 notification is received. */
7713 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
7714 0 /* forever */, &is_notif);
7717 if (ret != -1 && !is_notif)
7720 case 'E': /* Error of some sort. */
7721 /* We're out of sync with the target now. Did it continue
7722 or not? We can't tell which thread it was in non-stop,
7723 so just ignore this. */
7724 warning (_("Remote failure reply: %s"), rs->buf);
7726 case 'O': /* Console output. */
7727 remote_console_output (rs->buf + 1);
7730 warning (_("Invalid remote reply: %s"), rs->buf);
7734 /* Acknowledge a pending stop reply that may have arrived in the
7736 if (rs->notif_state->pending_event[notif_client_stop.id] != NULL)
7737 remote_notif_get_pending_events (¬if_client_stop);
7739 /* If indeed we noticed a stop reply, we're done. */
7740 stop_reply = queued_stop_reply (ptid);
7741 if (stop_reply != NULL)
7742 return process_stop_reply (stop_reply, status);
7744 /* Still no event. If we're just polling for an event, then
7745 return to the event loop. */
7746 if (options & TARGET_WNOHANG)
7748 status->kind = TARGET_WAITKIND_IGNORE;
7749 return minus_one_ptid;
7752 /* Otherwise do a blocking wait. */
7753 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
7754 1 /* forever */, &is_notif);
7758 /* Wait until the remote machine stops, then return, storing status in
7759 STATUS just as `wait' would. */
7762 remote_target::wait_as (ptid_t ptid, target_waitstatus *status, int options)
7764 struct remote_state *rs = get_remote_state ();
7765 ptid_t event_ptid = null_ptid;
7767 struct stop_reply *stop_reply;
7771 status->kind = TARGET_WAITKIND_IGNORE;
7772 status->value.integer = 0;
7774 stop_reply = queued_stop_reply (ptid);
7775 if (stop_reply != NULL)
7776 return process_stop_reply (stop_reply, status);
7778 if (rs->cached_wait_status)
7779 /* Use the cached wait status, but only once. */
7780 rs->cached_wait_status = 0;
7785 int forever = ((options & TARGET_WNOHANG) == 0
7786 && rs->wait_forever_enabled_p);
7788 if (!rs->waiting_for_stop_reply)
7790 status->kind = TARGET_WAITKIND_NO_RESUMED;
7791 return minus_one_ptid;
7794 /* FIXME: cagney/1999-09-27: If we're in async mode we should
7795 _never_ wait for ever -> test on target_is_async_p().
7796 However, before we do that we need to ensure that the caller
7797 knows how to take the target into/out of async mode. */
7798 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
7799 forever, &is_notif);
7801 /* GDB gets a notification. Return to core as this event is
7803 if (ret != -1 && is_notif)
7804 return minus_one_ptid;
7806 if (ret == -1 && (options & TARGET_WNOHANG) != 0)
7807 return minus_one_ptid;
7812 /* Assume that the target has acknowledged Ctrl-C unless we receive
7813 an 'F' or 'O' packet. */
7814 if (buf[0] != 'F' && buf[0] != 'O')
7815 rs->ctrlc_pending_p = 0;
7819 case 'E': /* Error of some sort. */
7820 /* We're out of sync with the target now. Did it continue or
7821 not? Not is more likely, so report a stop. */
7822 rs->waiting_for_stop_reply = 0;
7824 warning (_("Remote failure reply: %s"), buf);
7825 status->kind = TARGET_WAITKIND_STOPPED;
7826 status->value.sig = GDB_SIGNAL_0;
7828 case 'F': /* File-I/O request. */
7829 /* GDB may access the inferior memory while handling the File-I/O
7830 request, but we don't want GDB accessing memory while waiting
7831 for a stop reply. See the comments in putpkt_binary. Set
7832 waiting_for_stop_reply to 0 temporarily. */
7833 rs->waiting_for_stop_reply = 0;
7834 remote_fileio_request (this, buf, rs->ctrlc_pending_p);
7835 rs->ctrlc_pending_p = 0;
7836 /* GDB handled the File-I/O request, and the target is running
7837 again. Keep waiting for events. */
7838 rs->waiting_for_stop_reply = 1;
7840 case 'N': case 'T': case 'S': case 'X': case 'W':
7842 /* There is a stop reply to handle. */
7843 rs->waiting_for_stop_reply = 0;
7846 = (struct stop_reply *) remote_notif_parse (this,
7850 event_ptid = process_stop_reply (stop_reply, status);
7853 case 'O': /* Console output. */
7854 remote_console_output (buf + 1);
7857 if (rs->last_sent_signal != GDB_SIGNAL_0)
7859 /* Zero length reply means that we tried 'S' or 'C' and the
7860 remote system doesn't support it. */
7861 target_terminal::ours_for_output ();
7863 ("Can't send signals to this remote system. %s not sent.\n",
7864 gdb_signal_to_name (rs->last_sent_signal));
7865 rs->last_sent_signal = GDB_SIGNAL_0;
7866 target_terminal::inferior ();
7868 strcpy (buf, rs->last_sent_step ? "s" : "c");
7874 warning (_("Invalid remote reply: %s"), buf);
7878 if (status->kind == TARGET_WAITKIND_NO_RESUMED)
7879 return minus_one_ptid;
7880 else if (status->kind == TARGET_WAITKIND_IGNORE)
7882 /* Nothing interesting happened. If we're doing a non-blocking
7883 poll, we're done. Otherwise, go back to waiting. */
7884 if (options & TARGET_WNOHANG)
7885 return minus_one_ptid;
7889 else if (status->kind != TARGET_WAITKIND_EXITED
7890 && status->kind != TARGET_WAITKIND_SIGNALLED)
7892 if (event_ptid != null_ptid)
7893 record_currthread (rs, event_ptid);
7895 event_ptid = inferior_ptid;
7898 /* A process exit. Invalidate our notion of current thread. */
7899 record_currthread (rs, minus_one_ptid);
7904 /* Wait until the remote machine stops, then return, storing status in
7905 STATUS just as `wait' would. */
7908 remote_target::wait (ptid_t ptid, struct target_waitstatus *status, int options)
7912 if (target_is_non_stop_p ())
7913 event_ptid = wait_ns (ptid, status, options);
7915 event_ptid = wait_as (ptid, status, options);
7917 if (target_is_async_p ())
7919 remote_state *rs = get_remote_state ();
7921 /* If there are are events left in the queue tell the event loop
7923 if (!rs->stop_reply_queue.empty ())
7924 mark_async_event_handler (rs->remote_async_inferior_event_token);
7930 /* Fetch a single register using a 'p' packet. */
7933 remote_target::fetch_register_using_p (struct regcache *regcache,
7936 struct gdbarch *gdbarch = regcache->arch ();
7937 struct remote_state *rs = get_remote_state ();
7939 gdb_byte *regp = (gdb_byte *) alloca (register_size (gdbarch, reg->regnum));
7942 if (packet_support (PACKET_p) == PACKET_DISABLE)
7945 if (reg->pnum == -1)
7950 p += hexnumstr (p, reg->pnum);
7953 getpkt (&rs->buf, &rs->buf_size, 0);
7957 switch (packet_ok (buf, &remote_protocol_packets[PACKET_p]))
7961 case PACKET_UNKNOWN:
7964 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
7965 gdbarch_register_name (regcache->arch (),
7970 /* If this register is unfetchable, tell the regcache. */
7973 regcache->raw_supply (reg->regnum, NULL);
7977 /* Otherwise, parse and supply the value. */
7983 error (_("fetch_register_using_p: early buf termination"));
7985 regp[i++] = fromhex (p[0]) * 16 + fromhex (p[1]);
7988 regcache->raw_supply (reg->regnum, regp);
7992 /* Fetch the registers included in the target's 'g' packet. */
7995 remote_target::send_g_packet ()
7997 struct remote_state *rs = get_remote_state ();
8000 xsnprintf (rs->buf, get_remote_packet_size (), "g");
8002 getpkt (&rs->buf, &rs->buf_size, 0);
8003 if (packet_check_result (rs->buf) == PACKET_ERROR)
8004 error (_("Could not read registers; remote failure reply '%s'"),
8007 /* We can get out of synch in various cases. If the first character
8008 in the buffer is not a hex character, assume that has happened
8009 and try to fetch another packet to read. */
8010 while ((rs->buf[0] < '0' || rs->buf[0] > '9')
8011 && (rs->buf[0] < 'A' || rs->buf[0] > 'F')
8012 && (rs->buf[0] < 'a' || rs->buf[0] > 'f')
8013 && rs->buf[0] != 'x') /* New: unavailable register value. */
8016 fprintf_unfiltered (gdb_stdlog,
8017 "Bad register packet; fetching a new packet\n");
8018 getpkt (&rs->buf, &rs->buf_size, 0);
8021 buf_len = strlen (rs->buf);
8023 /* Sanity check the received packet. */
8024 if (buf_len % 2 != 0)
8025 error (_("Remote 'g' packet reply is of odd length: %s"), rs->buf);
8031 remote_target::process_g_packet (struct regcache *regcache)
8033 struct gdbarch *gdbarch = regcache->arch ();
8034 struct remote_state *rs = get_remote_state ();
8035 remote_arch_state *rsa = rs->get_remote_arch_state (gdbarch);
8040 buf_len = strlen (rs->buf);
8042 /* Further sanity checks, with knowledge of the architecture. */
8043 if (buf_len > 2 * rsa->sizeof_g_packet)
8044 error (_("Remote 'g' packet reply is too long (expected %ld bytes, got %d "
8045 "bytes): %s"), rsa->sizeof_g_packet, buf_len / 2, rs->buf);
8047 /* Save the size of the packet sent to us by the target. It is used
8048 as a heuristic when determining the max size of packets that the
8049 target can safely receive. */
8050 if (rsa->actual_register_packet_size == 0)
8051 rsa->actual_register_packet_size = buf_len;
8053 /* If this is smaller than we guessed the 'g' packet would be,
8054 update our records. A 'g' reply that doesn't include a register's
8055 value implies either that the register is not available, or that
8056 the 'p' packet must be used. */
8057 if (buf_len < 2 * rsa->sizeof_g_packet)
8059 long sizeof_g_packet = buf_len / 2;
8061 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
8063 long offset = rsa->regs[i].offset;
8064 long reg_size = register_size (gdbarch, i);
8066 if (rsa->regs[i].pnum == -1)
8069 if (offset >= sizeof_g_packet)
8070 rsa->regs[i].in_g_packet = 0;
8071 else if (offset + reg_size > sizeof_g_packet)
8072 error (_("Truncated register %d in remote 'g' packet"), i);
8074 rsa->regs[i].in_g_packet = 1;
8077 /* Looks valid enough, we can assume this is the correct length
8078 for a 'g' packet. It's important not to adjust
8079 rsa->sizeof_g_packet if we have truncated registers otherwise
8080 this "if" won't be run the next time the method is called
8081 with a packet of the same size and one of the internal errors
8082 below will trigger instead. */
8083 rsa->sizeof_g_packet = sizeof_g_packet;
8086 regs = (char *) alloca (rsa->sizeof_g_packet);
8088 /* Unimplemented registers read as all bits zero. */
8089 memset (regs, 0, rsa->sizeof_g_packet);
8091 /* Reply describes registers byte by byte, each byte encoded as two
8092 hex characters. Suck them all up, then supply them to the
8093 register cacheing/storage mechanism. */
8096 for (i = 0; i < rsa->sizeof_g_packet; i++)
8098 if (p[0] == 0 || p[1] == 0)
8099 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
8100 internal_error (__FILE__, __LINE__,
8101 _("unexpected end of 'g' packet reply"));
8103 if (p[0] == 'x' && p[1] == 'x')
8104 regs[i] = 0; /* 'x' */
8106 regs[i] = fromhex (p[0]) * 16 + fromhex (p[1]);
8110 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
8112 struct packet_reg *r = &rsa->regs[i];
8113 long reg_size = register_size (gdbarch, i);
8117 if ((r->offset + reg_size) * 2 > strlen (rs->buf))
8118 /* This shouldn't happen - we adjusted in_g_packet above. */
8119 internal_error (__FILE__, __LINE__,
8120 _("unexpected end of 'g' packet reply"));
8121 else if (rs->buf[r->offset * 2] == 'x')
8123 gdb_assert (r->offset * 2 < strlen (rs->buf));
8124 /* The register isn't available, mark it as such (at
8125 the same time setting the value to zero). */
8126 regcache->raw_supply (r->regnum, NULL);
8129 regcache->raw_supply (r->regnum, regs + r->offset);
8135 remote_target::fetch_registers_using_g (struct regcache *regcache)
8138 process_g_packet (regcache);
8141 /* Make the remote selected traceframe match GDB's selected
8145 remote_target::set_remote_traceframe ()
8148 struct remote_state *rs = get_remote_state ();
8150 if (rs->remote_traceframe_number == get_traceframe_number ())
8153 /* Avoid recursion, remote_trace_find calls us again. */
8154 rs->remote_traceframe_number = get_traceframe_number ();
8156 newnum = target_trace_find (tfind_number,
8157 get_traceframe_number (), 0, 0, NULL);
8159 /* Should not happen. If it does, all bets are off. */
8160 if (newnum != get_traceframe_number ())
8161 warning (_("could not set remote traceframe"));
8165 remote_target::fetch_registers (struct regcache *regcache, int regnum)
8167 struct gdbarch *gdbarch = regcache->arch ();
8168 struct remote_state *rs = get_remote_state ();
8169 remote_arch_state *rsa = rs->get_remote_arch_state (gdbarch);
8172 set_remote_traceframe ();
8173 set_general_thread (regcache->ptid ());
8177 packet_reg *reg = packet_reg_from_regnum (gdbarch, rsa, regnum);
8179 gdb_assert (reg != NULL);
8181 /* If this register might be in the 'g' packet, try that first -
8182 we are likely to read more than one register. If this is the
8183 first 'g' packet, we might be overly optimistic about its
8184 contents, so fall back to 'p'. */
8185 if (reg->in_g_packet)
8187 fetch_registers_using_g (regcache);
8188 if (reg->in_g_packet)
8192 if (fetch_register_using_p (regcache, reg))
8195 /* This register is not available. */
8196 regcache->raw_supply (reg->regnum, NULL);
8201 fetch_registers_using_g (regcache);
8203 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
8204 if (!rsa->regs[i].in_g_packet)
8205 if (!fetch_register_using_p (regcache, &rsa->regs[i]))
8207 /* This register is not available. */
8208 regcache->raw_supply (i, NULL);
8212 /* Prepare to store registers. Since we may send them all (using a
8213 'G' request), we have to read out the ones we don't want to change
8217 remote_target::prepare_to_store (struct regcache *regcache)
8219 struct remote_state *rs = get_remote_state ();
8220 remote_arch_state *rsa = rs->get_remote_arch_state (regcache->arch ());
8223 /* Make sure the entire registers array is valid. */
8224 switch (packet_support (PACKET_P))
8226 case PACKET_DISABLE:
8227 case PACKET_SUPPORT_UNKNOWN:
8228 /* Make sure all the necessary registers are cached. */
8229 for (i = 0; i < gdbarch_num_regs (regcache->arch ()); i++)
8230 if (rsa->regs[i].in_g_packet)
8231 regcache->raw_update (rsa->regs[i].regnum);
8238 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
8239 packet was not recognized. */
8242 remote_target::store_register_using_P (const struct regcache *regcache,
8245 struct gdbarch *gdbarch = regcache->arch ();
8246 struct remote_state *rs = get_remote_state ();
8247 /* Try storing a single register. */
8248 char *buf = rs->buf;
8249 gdb_byte *regp = (gdb_byte *) alloca (register_size (gdbarch, reg->regnum));
8252 if (packet_support (PACKET_P) == PACKET_DISABLE)
8255 if (reg->pnum == -1)
8258 xsnprintf (buf, get_remote_packet_size (), "P%s=", phex_nz (reg->pnum, 0));
8259 p = buf + strlen (buf);
8260 regcache->raw_collect (reg->regnum, regp);
8261 bin2hex (regp, p, register_size (gdbarch, reg->regnum));
8263 getpkt (&rs->buf, &rs->buf_size, 0);
8265 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_P]))
8270 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
8271 gdbarch_register_name (gdbarch, reg->regnum), rs->buf);
8272 case PACKET_UNKNOWN:
8275 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
8279 /* Store register REGNUM, or all registers if REGNUM == -1, from the
8280 contents of the register cache buffer. FIXME: ignores errors. */
8283 remote_target::store_registers_using_G (const struct regcache *regcache)
8285 struct remote_state *rs = get_remote_state ();
8286 remote_arch_state *rsa = rs->get_remote_arch_state (regcache->arch ());
8290 /* Extract all the registers in the regcache copying them into a
8295 regs = (gdb_byte *) alloca (rsa->sizeof_g_packet);
8296 memset (regs, 0, rsa->sizeof_g_packet);
8297 for (i = 0; i < gdbarch_num_regs (regcache->arch ()); i++)
8299 struct packet_reg *r = &rsa->regs[i];
8302 regcache->raw_collect (r->regnum, regs + r->offset);
8306 /* Command describes registers byte by byte,
8307 each byte encoded as two hex characters. */
8310 bin2hex (regs, p, rsa->sizeof_g_packet);
8312 getpkt (&rs->buf, &rs->buf_size, 0);
8313 if (packet_check_result (rs->buf) == PACKET_ERROR)
8314 error (_("Could not write registers; remote failure reply '%s'"),
8318 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
8319 of the register cache buffer. FIXME: ignores errors. */
8322 remote_target::store_registers (struct regcache *regcache, int regnum)
8324 struct gdbarch *gdbarch = regcache->arch ();
8325 struct remote_state *rs = get_remote_state ();
8326 remote_arch_state *rsa = rs->get_remote_arch_state (gdbarch);
8329 set_remote_traceframe ();
8330 set_general_thread (regcache->ptid ());
8334 packet_reg *reg = packet_reg_from_regnum (gdbarch, rsa, regnum);
8336 gdb_assert (reg != NULL);
8338 /* Always prefer to store registers using the 'P' packet if
8339 possible; we often change only a small number of registers.
8340 Sometimes we change a larger number; we'd need help from a
8341 higher layer to know to use 'G'. */
8342 if (store_register_using_P (regcache, reg))
8345 /* For now, don't complain if we have no way to write the
8346 register. GDB loses track of unavailable registers too
8347 easily. Some day, this may be an error. We don't have
8348 any way to read the register, either... */
8349 if (!reg->in_g_packet)
8352 store_registers_using_G (regcache);
8356 store_registers_using_G (regcache);
8358 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
8359 if (!rsa->regs[i].in_g_packet)
8360 if (!store_register_using_P (regcache, &rsa->regs[i]))
8361 /* See above for why we do not issue an error here. */
8366 /* Return the number of hex digits in num. */
8369 hexnumlen (ULONGEST num)
8373 for (i = 0; num != 0; i++)
8376 return std::max (i, 1);
8379 /* Set BUF to the minimum number of hex digits representing NUM. */
8382 hexnumstr (char *buf, ULONGEST num)
8384 int len = hexnumlen (num);
8386 return hexnumnstr (buf, num, len);
8390 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
8393 hexnumnstr (char *buf, ULONGEST num, int width)
8399 for (i = width - 1; i >= 0; i--)
8401 buf[i] = "0123456789abcdef"[(num & 0xf)];
8408 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
8411 remote_address_masked (CORE_ADDR addr)
8413 unsigned int address_size = remote_address_size;
8415 /* If "remoteaddresssize" was not set, default to target address size. */
8417 address_size = gdbarch_addr_bit (target_gdbarch ());
8419 if (address_size > 0
8420 && address_size < (sizeof (ULONGEST) * 8))
8422 /* Only create a mask when that mask can safely be constructed
8423 in a ULONGEST variable. */
8426 mask = (mask << address_size) - 1;
8432 /* Determine whether the remote target supports binary downloading.
8433 This is accomplished by sending a no-op memory write of zero length
8434 to the target at the specified address. It does not suffice to send
8435 the whole packet, since many stubs strip the eighth bit and
8436 subsequently compute a wrong checksum, which causes real havoc with
8439 NOTE: This can still lose if the serial line is not eight-bit
8440 clean. In cases like this, the user should clear "remote
8444 remote_target::check_binary_download (CORE_ADDR addr)
8446 struct remote_state *rs = get_remote_state ();
8448 switch (packet_support (PACKET_X))
8450 case PACKET_DISABLE:
8454 case PACKET_SUPPORT_UNKNOWN:
8460 p += hexnumstr (p, (ULONGEST) addr);
8462 p += hexnumstr (p, (ULONGEST) 0);
8466 putpkt_binary (rs->buf, (int) (p - rs->buf));
8467 getpkt (&rs->buf, &rs->buf_size, 0);
8469 if (rs->buf[0] == '\0')
8472 fprintf_unfiltered (gdb_stdlog,
8473 "binary downloading NOT "
8474 "supported by target\n");
8475 remote_protocol_packets[PACKET_X].support = PACKET_DISABLE;
8480 fprintf_unfiltered (gdb_stdlog,
8481 "binary downloading supported by target\n");
8482 remote_protocol_packets[PACKET_X].support = PACKET_ENABLE;
8489 /* Helper function to resize the payload in order to try to get a good
8490 alignment. We try to write an amount of data such that the next write will
8491 start on an address aligned on REMOTE_ALIGN_WRITES. */
8494 align_for_efficient_write (int todo, CORE_ADDR memaddr)
8496 return ((memaddr + todo) & ~(REMOTE_ALIGN_WRITES - 1)) - memaddr;
8499 /* Write memory data directly to the remote machine.
8500 This does not inform the data cache; the data cache uses this.
8501 HEADER is the starting part of the packet.
8502 MEMADDR is the address in the remote memory space.
8503 MYADDR is the address of the buffer in our space.
8504 LEN_UNITS is the number of addressable units to write.
8505 UNIT_SIZE is the length in bytes of an addressable unit.
8506 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
8507 should send data as binary ('X'), or hex-encoded ('M').
8509 The function creates packet of the form
8510 <HEADER><ADDRESS>,<LENGTH>:<DATA>
8512 where encoding of <DATA> is terminated by PACKET_FORMAT.
8514 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
8517 Return the transferred status, error or OK (an
8518 'enum target_xfer_status' value). Save the number of addressable units
8519 transferred in *XFERED_LEN_UNITS. Only transfer a single packet.
8521 On a platform with an addressable memory size of 2 bytes (UNIT_SIZE == 2), an
8522 exchange between gdb and the stub could look like (?? in place of the
8528 -> $M1000,3:eeeeffffeeee#??
8532 <- eeeeffffeeeedddd */
8535 remote_target::remote_write_bytes_aux (const char *header, CORE_ADDR memaddr,
8536 const gdb_byte *myaddr,
8539 ULONGEST *xfered_len_units,
8540 char packet_format, int use_length)
8542 struct remote_state *rs = get_remote_state ();
8548 int payload_capacity_bytes;
8549 int payload_length_bytes;
8551 if (packet_format != 'X' && packet_format != 'M')
8552 internal_error (__FILE__, __LINE__,
8553 _("remote_write_bytes_aux: bad packet format"));
8556 return TARGET_XFER_EOF;
8558 payload_capacity_bytes = get_memory_write_packet_size ();
8560 /* The packet buffer will be large enough for the payload;
8561 get_memory_packet_size ensures this. */
8564 /* Compute the size of the actual payload by subtracting out the
8565 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
8567 payload_capacity_bytes -= strlen ("$,:#NN");
8569 /* The comma won't be used. */
8570 payload_capacity_bytes += 1;
8571 payload_capacity_bytes -= strlen (header);
8572 payload_capacity_bytes -= hexnumlen (memaddr);
8574 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
8576 strcat (rs->buf, header);
8577 p = rs->buf + strlen (header);
8579 /* Compute a best guess of the number of bytes actually transfered. */
8580 if (packet_format == 'X')
8582 /* Best guess at number of bytes that will fit. */
8583 todo_units = std::min (len_units,
8584 (ULONGEST) payload_capacity_bytes / unit_size);
8586 payload_capacity_bytes -= hexnumlen (todo_units);
8587 todo_units = std::min (todo_units, payload_capacity_bytes / unit_size);
8591 /* Number of bytes that will fit. */
8593 = std::min (len_units,
8594 (ULONGEST) (payload_capacity_bytes / unit_size) / 2);
8596 payload_capacity_bytes -= hexnumlen (todo_units);
8597 todo_units = std::min (todo_units,
8598 (payload_capacity_bytes / unit_size) / 2);
8601 if (todo_units <= 0)
8602 internal_error (__FILE__, __LINE__,
8603 _("minimum packet size too small to write data"));
8605 /* If we already need another packet, then try to align the end
8606 of this packet to a useful boundary. */
8607 if (todo_units > 2 * REMOTE_ALIGN_WRITES && todo_units < len_units)
8608 todo_units = align_for_efficient_write (todo_units, memaddr);
8610 /* Append "<memaddr>". */
8611 memaddr = remote_address_masked (memaddr);
8612 p += hexnumstr (p, (ULONGEST) memaddr);
8619 /* Append the length and retain its location and size. It may need to be
8620 adjusted once the packet body has been created. */
8622 plenlen = hexnumstr (p, (ULONGEST) todo_units);
8630 /* Append the packet body. */
8631 if (packet_format == 'X')
8633 /* Binary mode. Send target system values byte by byte, in
8634 increasing byte addresses. Only escape certain critical
8636 payload_length_bytes =
8637 remote_escape_output (myaddr, todo_units, unit_size, (gdb_byte *) p,
8638 &units_written, payload_capacity_bytes);
8640 /* If not all TODO units fit, then we'll need another packet. Make
8641 a second try to keep the end of the packet aligned. Don't do
8642 this if the packet is tiny. */
8643 if (units_written < todo_units && units_written > 2 * REMOTE_ALIGN_WRITES)
8647 new_todo_units = align_for_efficient_write (units_written, memaddr);
8649 if (new_todo_units != units_written)
8650 payload_length_bytes =
8651 remote_escape_output (myaddr, new_todo_units, unit_size,
8652 (gdb_byte *) p, &units_written,
8653 payload_capacity_bytes);
8656 p += payload_length_bytes;
8657 if (use_length && units_written < todo_units)
8659 /* Escape chars have filled up the buffer prematurely,
8660 and we have actually sent fewer units than planned.
8661 Fix-up the length field of the packet. Use the same
8662 number of characters as before. */
8663 plen += hexnumnstr (plen, (ULONGEST) units_written,
8665 *plen = ':'; /* overwrite \0 from hexnumnstr() */
8670 /* Normal mode: Send target system values byte by byte, in
8671 increasing byte addresses. Each byte is encoded as a two hex
8673 p += 2 * bin2hex (myaddr, p, todo_units * unit_size);
8674 units_written = todo_units;
8677 putpkt_binary (rs->buf, (int) (p - rs->buf));
8678 getpkt (&rs->buf, &rs->buf_size, 0);
8680 if (rs->buf[0] == 'E')
8681 return TARGET_XFER_E_IO;
8683 /* Return UNITS_WRITTEN, not TODO_UNITS, in case escape chars caused us to
8684 send fewer units than we'd planned. */
8685 *xfered_len_units = (ULONGEST) units_written;
8686 return (*xfered_len_units != 0) ? TARGET_XFER_OK : TARGET_XFER_EOF;
8689 /* Write memory data directly to the remote machine.
8690 This does not inform the data cache; the data cache uses this.
8691 MEMADDR is the address in the remote memory space.
8692 MYADDR is the address of the buffer in our space.
8693 LEN is the number of bytes.
8695 Return the transferred status, error or OK (an
8696 'enum target_xfer_status' value). Save the number of bytes
8697 transferred in *XFERED_LEN. Only transfer a single packet. */
8700 remote_target::remote_write_bytes (CORE_ADDR memaddr, const gdb_byte *myaddr,
8701 ULONGEST len, int unit_size,
8702 ULONGEST *xfered_len)
8704 const char *packet_format = NULL;
8706 /* Check whether the target supports binary download. */
8707 check_binary_download (memaddr);
8709 switch (packet_support (PACKET_X))
8712 packet_format = "X";
8714 case PACKET_DISABLE:
8715 packet_format = "M";
8717 case PACKET_SUPPORT_UNKNOWN:
8718 internal_error (__FILE__, __LINE__,
8719 _("remote_write_bytes: bad internal state"));
8721 internal_error (__FILE__, __LINE__, _("bad switch"));
8724 return remote_write_bytes_aux (packet_format,
8725 memaddr, myaddr, len, unit_size, xfered_len,
8726 packet_format[0], 1);
8729 /* Read memory data directly from the remote machine.
8730 This does not use the data cache; the data cache uses this.
8731 MEMADDR is the address in the remote memory space.
8732 MYADDR is the address of the buffer in our space.
8733 LEN_UNITS is the number of addressable memory units to read..
8734 UNIT_SIZE is the length in bytes of an addressable unit.
8736 Return the transferred status, error or OK (an
8737 'enum target_xfer_status' value). Save the number of bytes
8738 transferred in *XFERED_LEN_UNITS.
8740 See the comment of remote_write_bytes_aux for an example of
8741 memory read/write exchange between gdb and the stub. */
8744 remote_target::remote_read_bytes_1 (CORE_ADDR memaddr, gdb_byte *myaddr,
8746 int unit_size, ULONGEST *xfered_len_units)
8748 struct remote_state *rs = get_remote_state ();
8749 int buf_size_bytes; /* Max size of packet output buffer. */
8754 buf_size_bytes = get_memory_read_packet_size ();
8755 /* The packet buffer will be large enough for the payload;
8756 get_memory_packet_size ensures this. */
8758 /* Number of units that will fit. */
8759 todo_units = std::min (len_units,
8760 (ULONGEST) (buf_size_bytes / unit_size) / 2);
8762 /* Construct "m"<memaddr>","<len>". */
8763 memaddr = remote_address_masked (memaddr);
8766 p += hexnumstr (p, (ULONGEST) memaddr);
8768 p += hexnumstr (p, (ULONGEST) todo_units);
8771 getpkt (&rs->buf, &rs->buf_size, 0);
8772 if (rs->buf[0] == 'E'
8773 && isxdigit (rs->buf[1]) && isxdigit (rs->buf[2])
8774 && rs->buf[3] == '\0')
8775 return TARGET_XFER_E_IO;
8776 /* Reply describes memory byte by byte, each byte encoded as two hex
8779 decoded_bytes = hex2bin (p, myaddr, todo_units * unit_size);
8780 /* Return what we have. Let higher layers handle partial reads. */
8781 *xfered_len_units = (ULONGEST) (decoded_bytes / unit_size);
8782 return (*xfered_len_units != 0) ? TARGET_XFER_OK : TARGET_XFER_EOF;
8785 /* Using the set of read-only target sections of remote, read live
8788 For interface/parameters/return description see target.h,
8792 remote_target::remote_xfer_live_readonly_partial (gdb_byte *readbuf,
8796 ULONGEST *xfered_len)
8798 struct target_section *secp;
8799 struct target_section_table *table;
8801 secp = target_section_by_addr (this, memaddr);
8803 && (bfd_get_section_flags (secp->the_bfd_section->owner,
8804 secp->the_bfd_section)
8807 struct target_section *p;
8808 ULONGEST memend = memaddr + len;
8810 table = target_get_section_table (this);
8812 for (p = table->sections; p < table->sections_end; p++)
8814 if (memaddr >= p->addr)
8816 if (memend <= p->endaddr)
8818 /* Entire transfer is within this section. */
8819 return remote_read_bytes_1 (memaddr, readbuf, len, unit_size,
8822 else if (memaddr >= p->endaddr)
8824 /* This section ends before the transfer starts. */
8829 /* This section overlaps the transfer. Just do half. */
8830 len = p->endaddr - memaddr;
8831 return remote_read_bytes_1 (memaddr, readbuf, len, unit_size,
8838 return TARGET_XFER_EOF;
8841 /* Similar to remote_read_bytes_1, but it reads from the remote stub
8842 first if the requested memory is unavailable in traceframe.
8843 Otherwise, fall back to remote_read_bytes_1. */
8846 remote_target::remote_read_bytes (CORE_ADDR memaddr,
8847 gdb_byte *myaddr, ULONGEST len, int unit_size,
8848 ULONGEST *xfered_len)
8851 return TARGET_XFER_EOF;
8853 if (get_traceframe_number () != -1)
8855 std::vector<mem_range> available;
8857 /* If we fail to get the set of available memory, then the
8858 target does not support querying traceframe info, and so we
8859 attempt reading from the traceframe anyway (assuming the
8860 target implements the old QTro packet then). */
8861 if (traceframe_available_memory (&available, memaddr, len))
8863 if (available.empty () || available[0].start != memaddr)
8865 enum target_xfer_status res;
8867 /* Don't read into the traceframe's available
8869 if (!available.empty ())
8871 LONGEST oldlen = len;
8873 len = available[0].start - memaddr;
8874 gdb_assert (len <= oldlen);
8877 /* This goes through the topmost target again. */
8878 res = remote_xfer_live_readonly_partial (myaddr, memaddr,
8879 len, unit_size, xfered_len);
8880 if (res == TARGET_XFER_OK)
8881 return TARGET_XFER_OK;
8884 /* No use trying further, we know some memory starting
8885 at MEMADDR isn't available. */
8887 return (*xfered_len != 0) ?
8888 TARGET_XFER_UNAVAILABLE : TARGET_XFER_EOF;
8892 /* Don't try to read more than how much is available, in
8893 case the target implements the deprecated QTro packet to
8894 cater for older GDBs (the target's knowledge of read-only
8895 sections may be outdated by now). */
8896 len = available[0].length;
8900 return remote_read_bytes_1 (memaddr, myaddr, len, unit_size, xfered_len);
8905 /* Sends a packet with content determined by the printf format string
8906 FORMAT and the remaining arguments, then gets the reply. Returns
8907 whether the packet was a success, a failure, or unknown. */
8910 remote_target::remote_send_printf (const char *format, ...)
8912 struct remote_state *rs = get_remote_state ();
8913 int max_size = get_remote_packet_size ();
8916 va_start (ap, format);
8919 int size = vsnprintf (rs->buf, max_size, format, ap);
8923 if (size >= max_size)
8924 internal_error (__FILE__, __LINE__, _("Too long remote packet."));
8926 if (putpkt (rs->buf) < 0)
8927 error (_("Communication problem with target."));
8930 getpkt (&rs->buf, &rs->buf_size, 0);
8932 return packet_check_result (rs->buf);
8935 /* Flash writing can take quite some time. We'll set
8936 effectively infinite timeout for flash operations.
8937 In future, we'll need to decide on a better approach. */
8938 static const int remote_flash_timeout = 1000;
8941 remote_target::flash_erase (ULONGEST address, LONGEST length)
8943 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
8944 enum packet_result ret;
8945 scoped_restore restore_timeout
8946 = make_scoped_restore (&remote_timeout, remote_flash_timeout);
8948 ret = remote_send_printf ("vFlashErase:%s,%s",
8949 phex (address, addr_size),
8953 case PACKET_UNKNOWN:
8954 error (_("Remote target does not support flash erase"));
8956 error (_("Error erasing flash with vFlashErase packet"));
8963 remote_target::remote_flash_write (ULONGEST address,
8964 ULONGEST length, ULONGEST *xfered_len,
8965 const gdb_byte *data)
8967 scoped_restore restore_timeout
8968 = make_scoped_restore (&remote_timeout, remote_flash_timeout);
8969 return remote_write_bytes_aux ("vFlashWrite:", address, data, length, 1,
8974 remote_target::flash_done ()
8978 scoped_restore restore_timeout
8979 = make_scoped_restore (&remote_timeout, remote_flash_timeout);
8981 ret = remote_send_printf ("vFlashDone");
8985 case PACKET_UNKNOWN:
8986 error (_("Remote target does not support vFlashDone"));
8988 error (_("Error finishing flash operation"));
8995 remote_target::files_info ()
8997 puts_filtered ("Debugging a target over a serial line.\n");
9000 /* Stuff for dealing with the packets which are part of this protocol.
9001 See comment at top of file for details. */
9003 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
9004 error to higher layers. Called when a serial error is detected.
9005 The exception message is STRING, followed by a colon and a blank,
9006 the system error message for errno at function entry and final dot
9007 for output compatibility with throw_perror_with_name. */
9010 unpush_and_perror (const char *string)
9012 int saved_errno = errno;
9014 remote_unpush_target ();
9015 throw_error (TARGET_CLOSE_ERROR, "%s: %s.", string,
9016 safe_strerror (saved_errno));
9019 /* Read a single character from the remote end. The current quit
9020 handler is overridden to avoid quitting in the middle of packet
9021 sequence, as that would break communication with the remote server.
9022 See remote_serial_quit_handler for more detail. */
9025 remote_target::readchar (int timeout)
9028 struct remote_state *rs = get_remote_state ();
9031 scoped_restore restore_quit_target
9032 = make_scoped_restore (&curr_quit_handler_target, this);
9033 scoped_restore restore_quit
9034 = make_scoped_restore (&quit_handler, ::remote_serial_quit_handler);
9036 rs->got_ctrlc_during_io = 0;
9038 ch = serial_readchar (rs->remote_desc, timeout);
9040 if (rs->got_ctrlc_during_io)
9047 switch ((enum serial_rc) ch)
9050 remote_unpush_target ();
9051 throw_error (TARGET_CLOSE_ERROR, _("Remote connection closed"));
9054 unpush_and_perror (_("Remote communication error. "
9055 "Target disconnected."));
9057 case SERIAL_TIMEOUT:
9063 /* Wrapper for serial_write that closes the target and throws if
9064 writing fails. The current quit handler is overridden to avoid
9065 quitting in the middle of packet sequence, as that would break
9066 communication with the remote server. See
9067 remote_serial_quit_handler for more detail. */
9070 remote_target::remote_serial_write (const char *str, int len)
9072 struct remote_state *rs = get_remote_state ();
9074 scoped_restore restore_quit_target
9075 = make_scoped_restore (&curr_quit_handler_target, this);
9076 scoped_restore restore_quit
9077 = make_scoped_restore (&quit_handler, ::remote_serial_quit_handler);
9079 rs->got_ctrlc_during_io = 0;
9081 if (serial_write (rs->remote_desc, str, len))
9083 unpush_and_perror (_("Remote communication error. "
9084 "Target disconnected."));
9087 if (rs->got_ctrlc_during_io)
9091 /* Return a string representing an escaped version of BUF, of len N.
9092 E.g. \n is converted to \\n, \t to \\t, etc. */
9095 escape_buffer (const char *buf, int n)
9099 stb.putstrn (buf, n, '\\');
9100 return std::move (stb.string ());
9103 /* Display a null-terminated packet on stdout, for debugging, using C
9107 print_packet (const char *buf)
9109 puts_filtered ("\"");
9110 fputstr_filtered (buf, '"', gdb_stdout);
9111 puts_filtered ("\"");
9115 remote_target::putpkt (const char *buf)
9117 return putpkt_binary (buf, strlen (buf));
9120 /* Wrapper around remote_target::putpkt to avoid exporting
9124 putpkt (remote_target *remote, const char *buf)
9126 return remote->putpkt (buf);
9129 /* Send a packet to the remote machine, with error checking. The data
9130 of the packet is in BUF. The string in BUF can be at most
9131 get_remote_packet_size () - 5 to account for the $, # and checksum,
9132 and for a possible /0 if we are debugging (remote_debug) and want
9133 to print the sent packet as a string. */
9136 remote_target::putpkt_binary (const char *buf, int cnt)
9138 struct remote_state *rs = get_remote_state ();
9140 unsigned char csum = 0;
9141 gdb::def_vector<char> data (cnt + 6);
9142 char *buf2 = data.data ();
9148 /* Catch cases like trying to read memory or listing threads while
9149 we're waiting for a stop reply. The remote server wouldn't be
9150 ready to handle this request, so we'd hang and timeout. We don't
9151 have to worry about this in synchronous mode, because in that
9152 case it's not possible to issue a command while the target is
9153 running. This is not a problem in non-stop mode, because in that
9154 case, the stub is always ready to process serial input. */
9155 if (!target_is_non_stop_p ()
9156 && target_is_async_p ()
9157 && rs->waiting_for_stop_reply)
9159 error (_("Cannot execute this command while the target is running.\n"
9160 "Use the \"interrupt\" command to stop the target\n"
9161 "and then try again."));
9164 /* We're sending out a new packet. Make sure we don't look at a
9165 stale cached response. */
9166 rs->cached_wait_status = 0;
9168 /* Copy the packet into buffer BUF2, encapsulating it
9169 and giving it a checksum. */
9174 for (i = 0; i < cnt; i++)
9180 *p++ = tohex ((csum >> 4) & 0xf);
9181 *p++ = tohex (csum & 0xf);
9183 /* Send it over and over until we get a positive ack. */
9187 int started_error_output = 0;
9193 int len = (int) (p - buf2);
9196 = escape_buffer (buf2, std::min (len, REMOTE_DEBUG_MAX_CHAR));
9198 fprintf_unfiltered (gdb_stdlog, "Sending packet: %s", str.c_str ());
9200 if (len > REMOTE_DEBUG_MAX_CHAR)
9201 fprintf_unfiltered (gdb_stdlog, "[%d bytes omitted]",
9202 len - REMOTE_DEBUG_MAX_CHAR);
9204 fprintf_unfiltered (gdb_stdlog, "...");
9206 gdb_flush (gdb_stdlog);
9208 remote_serial_write (buf2, p - buf2);
9210 /* If this is a no acks version of the remote protocol, send the
9211 packet and move on. */
9215 /* Read until either a timeout occurs (-2) or '+' is read.
9216 Handle any notification that arrives in the mean time. */
9219 ch = readchar (remote_timeout);
9227 case SERIAL_TIMEOUT:
9230 if (started_error_output)
9232 putchar_unfiltered ('\n');
9233 started_error_output = 0;
9242 fprintf_unfiltered (gdb_stdlog, "Ack\n");
9246 fprintf_unfiltered (gdb_stdlog, "Nak\n");
9248 case SERIAL_TIMEOUT:
9252 break; /* Retransmit buffer. */
9256 fprintf_unfiltered (gdb_stdlog,
9257 "Packet instead of Ack, ignoring it\n");
9258 /* It's probably an old response sent because an ACK
9259 was lost. Gobble up the packet and ack it so it
9260 doesn't get retransmitted when we resend this
9263 remote_serial_write ("+", 1);
9264 continue; /* Now, go look for +. */
9271 /* If we got a notification, handle it, and go back to looking
9273 /* We've found the start of a notification. Now
9274 collect the data. */
9275 val = read_frame (&rs->buf, &rs->buf_size);
9280 std::string str = escape_buffer (rs->buf, val);
9282 fprintf_unfiltered (gdb_stdlog,
9283 " Notification received: %s\n",
9286 handle_notification (rs->notif_state, rs->buf);
9287 /* We're in sync now, rewait for the ack. */
9294 if (!started_error_output)
9296 started_error_output = 1;
9297 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
9299 fputc_unfiltered (ch & 0177, gdb_stdlog);
9300 fprintf_unfiltered (gdb_stdlog, "%s", rs->buf);
9309 if (!started_error_output)
9311 started_error_output = 1;
9312 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
9314 fputc_unfiltered (ch & 0177, gdb_stdlog);
9318 break; /* Here to retransmit. */
9322 /* This is wrong. If doing a long backtrace, the user should be
9323 able to get out next time we call QUIT, without anything as
9324 violent as interrupt_query. If we want to provide a way out of
9325 here without getting to the next QUIT, it should be based on
9326 hitting ^C twice as in remote_wait. */
9338 /* Come here after finding the start of a frame when we expected an
9339 ack. Do our best to discard the rest of this packet. */
9342 remote_target::skip_frame ()
9348 c = readchar (remote_timeout);
9351 case SERIAL_TIMEOUT:
9352 /* Nothing we can do. */
9355 /* Discard the two bytes of checksum and stop. */
9356 c = readchar (remote_timeout);
9358 c = readchar (remote_timeout);
9361 case '*': /* Run length encoding. */
9362 /* Discard the repeat count. */
9363 c = readchar (remote_timeout);
9368 /* A regular character. */
9374 /* Come here after finding the start of the frame. Collect the rest
9375 into *BUF, verifying the checksum, length, and handling run-length
9376 compression. NUL terminate the buffer. If there is not enough room,
9377 expand *BUF using xrealloc.
9379 Returns -1 on error, number of characters in buffer (ignoring the
9380 trailing NULL) on success. (could be extended to return one of the
9381 SERIAL status indications). */
9384 remote_target::read_frame (char **buf_p, long *sizeof_buf)
9390 struct remote_state *rs = get_remote_state ();
9397 c = readchar (remote_timeout);
9400 case SERIAL_TIMEOUT:
9402 fputs_filtered ("Timeout in mid-packet, retrying\n", gdb_stdlog);
9406 fputs_filtered ("Saw new packet start in middle of old one\n",
9408 return -1; /* Start a new packet, count retries. */
9411 unsigned char pktcsum;
9417 check_0 = readchar (remote_timeout);
9419 check_1 = readchar (remote_timeout);
9421 if (check_0 == SERIAL_TIMEOUT || check_1 == SERIAL_TIMEOUT)
9424 fputs_filtered ("Timeout in checksum, retrying\n",
9428 else if (check_0 < 0 || check_1 < 0)
9431 fputs_filtered ("Communication error in checksum\n",
9436 /* Don't recompute the checksum; with no ack packets we
9437 don't have any way to indicate a packet retransmission
9442 pktcsum = (fromhex (check_0) << 4) | fromhex (check_1);
9443 if (csum == pktcsum)
9448 std::string str = escape_buffer (buf, bc);
9450 fprintf_unfiltered (gdb_stdlog,
9451 "Bad checksum, sentsum=0x%x, "
9452 "csum=0x%x, buf=%s\n",
9453 pktcsum, csum, str.c_str ());
9455 /* Number of characters in buffer ignoring trailing
9459 case '*': /* Run length encoding. */
9464 c = readchar (remote_timeout);
9466 repeat = c - ' ' + 3; /* Compute repeat count. */
9468 /* The character before ``*'' is repeated. */
9470 if (repeat > 0 && repeat <= 255 && bc > 0)
9472 if (bc + repeat - 1 >= *sizeof_buf - 1)
9474 /* Make some more room in the buffer. */
9475 *sizeof_buf += repeat;
9476 *buf_p = (char *) xrealloc (*buf_p, *sizeof_buf);
9480 memset (&buf[bc], buf[bc - 1], repeat);
9486 printf_filtered (_("Invalid run length encoding: %s\n"), buf);
9490 if (bc >= *sizeof_buf - 1)
9492 /* Make some more room in the buffer. */
9494 *buf_p = (char *) xrealloc (*buf_p, *sizeof_buf);
9505 /* Read a packet from the remote machine, with error checking, and
9506 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
9507 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
9508 rather than timing out; this is used (in synchronous mode) to wait
9509 for a target that is is executing user code to stop. */
9510 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
9511 don't have to change all the calls to getpkt to deal with the
9512 return value, because at the moment I don't know what the right
9513 thing to do it for those. */
9516 remote_target::getpkt (char **buf, long *sizeof_buf, int forever)
9518 getpkt_sane (buf, sizeof_buf, forever);
9522 /* Read a packet from the remote machine, with error checking, and
9523 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
9524 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
9525 rather than timing out; this is used (in synchronous mode) to wait
9526 for a target that is is executing user code to stop. If FOREVER ==
9527 0, this function is allowed to time out gracefully and return an
9528 indication of this to the caller. Otherwise return the number of
9529 bytes read. If EXPECTING_NOTIF, consider receiving a notification
9530 enough reason to return to the caller. *IS_NOTIF is an output
9531 boolean that indicates whether *BUF holds a notification or not
9532 (a regular packet). */
9535 remote_target::getpkt_or_notif_sane_1 (char **buf, long *sizeof_buf,
9536 int forever, int expecting_notif,
9539 struct remote_state *rs = get_remote_state ();
9545 /* We're reading a new response. Make sure we don't look at a
9546 previously cached response. */
9547 rs->cached_wait_status = 0;
9549 strcpy (*buf, "timeout");
9552 timeout = watchdog > 0 ? watchdog : -1;
9553 else if (expecting_notif)
9554 timeout = 0; /* There should already be a char in the buffer. If
9557 timeout = remote_timeout;
9561 /* Process any number of notifications, and then return when
9565 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
9567 for (tries = 1; tries <= MAX_TRIES; tries++)
9569 /* This can loop forever if the remote side sends us
9570 characters continuously, but if it pauses, we'll get
9571 SERIAL_TIMEOUT from readchar because of timeout. Then
9572 we'll count that as a retry.
9574 Note that even when forever is set, we will only wait
9575 forever prior to the start of a packet. After that, we
9576 expect characters to arrive at a brisk pace. They should
9577 show up within remote_timeout intervals. */
9579 c = readchar (timeout);
9580 while (c != SERIAL_TIMEOUT && c != '$' && c != '%');
9582 if (c == SERIAL_TIMEOUT)
9584 if (expecting_notif)
9585 return -1; /* Don't complain, it's normal to not get
9586 anything in this case. */
9588 if (forever) /* Watchdog went off? Kill the target. */
9590 remote_unpush_target ();
9591 throw_error (TARGET_CLOSE_ERROR,
9592 _("Watchdog timeout has expired. "
9593 "Target detached."));
9596 fputs_filtered ("Timed out.\n", gdb_stdlog);
9600 /* We've found the start of a packet or notification.
9601 Now collect the data. */
9602 val = read_frame (buf, sizeof_buf);
9607 remote_serial_write ("-", 1);
9610 if (tries > MAX_TRIES)
9612 /* We have tried hard enough, and just can't receive the
9613 packet/notification. Give up. */
9614 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
9616 /* Skip the ack char if we're in no-ack mode. */
9617 if (!rs->noack_mode)
9618 remote_serial_write ("+", 1);
9622 /* If we got an ordinary packet, return that to our caller. */
9628 = escape_buffer (*buf,
9629 std::min (val, REMOTE_DEBUG_MAX_CHAR));
9631 fprintf_unfiltered (gdb_stdlog, "Packet received: %s",
9634 if (val > REMOTE_DEBUG_MAX_CHAR)
9635 fprintf_unfiltered (gdb_stdlog, "[%d bytes omitted]",
9636 val - REMOTE_DEBUG_MAX_CHAR);
9638 fprintf_unfiltered (gdb_stdlog, "\n");
9641 /* Skip the ack char if we're in no-ack mode. */
9642 if (!rs->noack_mode)
9643 remote_serial_write ("+", 1);
9644 if (is_notif != NULL)
9649 /* If we got a notification, handle it, and go back to looking
9653 gdb_assert (c == '%');
9657 std::string str = escape_buffer (*buf, val);
9659 fprintf_unfiltered (gdb_stdlog,
9660 " Notification received: %s\n",
9663 if (is_notif != NULL)
9666 handle_notification (rs->notif_state, *buf);
9668 /* Notifications require no acknowledgement. */
9670 if (expecting_notif)
9677 remote_target::getpkt_sane (char **buf, long *sizeof_buf, int forever)
9679 return getpkt_or_notif_sane_1 (buf, sizeof_buf, forever, 0, NULL);
9683 remote_target::getpkt_or_notif_sane (char **buf, long *sizeof_buf, int forever,
9686 return getpkt_or_notif_sane_1 (buf, sizeof_buf, forever, 1,
9690 /* Kill any new fork children of process PID that haven't been
9691 processed by follow_fork. */
9694 remote_target::kill_new_fork_children (int pid)
9696 remote_state *rs = get_remote_state ();
9697 struct notif_client *notif = ¬if_client_stop;
9699 /* Kill the fork child threads of any threads in process PID
9700 that are stopped at a fork event. */
9701 for (thread_info *thread : all_non_exited_threads ())
9703 struct target_waitstatus *ws = &thread->pending_follow;
9705 if (is_pending_fork_parent (ws, pid, thread->ptid))
9707 int child_pid = ws->value.related_pid.pid ();
9710 res = remote_vkill (child_pid);
9712 error (_("Can't kill fork child process %d"), child_pid);
9716 /* Check for any pending fork events (not reported or processed yet)
9717 in process PID and kill those fork child threads as well. */
9718 remote_notif_get_pending_events (notif);
9719 for (auto &event : rs->stop_reply_queue)
9720 if (is_pending_fork_parent (&event->ws, pid, event->ptid))
9722 int child_pid = event->ws.value.related_pid.pid ();
9725 res = remote_vkill (child_pid);
9727 error (_("Can't kill fork child process %d"), child_pid);
9732 /* Target hook to kill the current inferior. */
9735 remote_target::kill ()
9738 int pid = inferior_ptid.pid ();
9739 struct remote_state *rs = get_remote_state ();
9741 if (packet_support (PACKET_vKill) != PACKET_DISABLE)
9743 /* If we're stopped while forking and we haven't followed yet,
9744 kill the child task. We need to do this before killing the
9745 parent task because if this is a vfork then the parent will
9747 kill_new_fork_children (pid);
9749 res = remote_vkill (pid);
9752 target_mourn_inferior (inferior_ptid);
9757 /* If we are in 'target remote' mode and we are killing the only
9758 inferior, then we will tell gdbserver to exit and unpush the
9760 if (res == -1 && !remote_multi_process_p (rs)
9761 && number_of_live_inferiors () == 1)
9765 /* We've killed the remote end, we get to mourn it. If we are
9766 not in extended mode, mourning the inferior also unpushes
9767 remote_ops from the target stack, which closes the remote
9769 target_mourn_inferior (inferior_ptid);
9774 error (_("Can't kill process"));
9777 /* Send a kill request to the target using the 'vKill' packet. */
9780 remote_target::remote_vkill (int pid)
9782 if (packet_support (PACKET_vKill) == PACKET_DISABLE)
9785 remote_state *rs = get_remote_state ();
9787 /* Tell the remote target to detach. */
9788 xsnprintf (rs->buf, get_remote_packet_size (), "vKill;%x", pid);
9790 getpkt (&rs->buf, &rs->buf_size, 0);
9792 switch (packet_ok (rs->buf,
9793 &remote_protocol_packets[PACKET_vKill]))
9799 case PACKET_UNKNOWN:
9802 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
9806 /* Send a kill request to the target using the 'k' packet. */
9809 remote_target::remote_kill_k ()
9811 /* Catch errors so the user can quit from gdb even when we
9812 aren't on speaking terms with the remote system. */
9817 CATCH (ex, RETURN_MASK_ERROR)
9819 if (ex.error == TARGET_CLOSE_ERROR)
9821 /* If we got an (EOF) error that caused the target
9822 to go away, then we're done, that's what we wanted.
9823 "k" is susceptible to cause a premature EOF, given
9824 that the remote server isn't actually required to
9825 reply to "k", and it can happen that it doesn't
9826 even get to reply ACK to the "k". */
9830 /* Otherwise, something went wrong. We didn't actually kill
9831 the target. Just propagate the exception, and let the
9832 user or higher layers decide what to do. */
9833 throw_exception (ex);
9839 remote_target::mourn_inferior ()
9841 struct remote_state *rs = get_remote_state ();
9843 /* We're no longer interested in notification events of an inferior
9844 that exited or was killed/detached. */
9845 discard_pending_stop_replies (current_inferior ());
9847 /* In 'target remote' mode with one inferior, we close the connection. */
9848 if (!rs->extended && number_of_live_inferiors () <= 1)
9850 unpush_target (this);
9852 /* remote_close takes care of doing most of the clean up. */
9853 generic_mourn_inferior ();
9857 /* In case we got here due to an error, but we're going to stay
9859 rs->waiting_for_stop_reply = 0;
9861 /* If the current general thread belonged to the process we just
9862 detached from or has exited, the remote side current general
9863 thread becomes undefined. Considering a case like this:
9865 - We just got here due to a detach.
9866 - The process that we're detaching from happens to immediately
9867 report a global breakpoint being hit in non-stop mode, in the
9868 same thread we had selected before.
9869 - GDB attaches to this process again.
9870 - This event happens to be the next event we handle.
9872 GDB would consider that the current general thread didn't need to
9873 be set on the stub side (with Hg), since for all it knew,
9874 GENERAL_THREAD hadn't changed.
9876 Notice that although in all-stop mode, the remote server always
9877 sets the current thread to the thread reporting the stop event,
9878 that doesn't happen in non-stop mode; in non-stop, the stub *must
9879 not* change the current thread when reporting a breakpoint hit,
9880 due to the decoupling of event reporting and event handling.
9882 To keep things simple, we always invalidate our notion of the
9884 record_currthread (rs, minus_one_ptid);
9886 /* Call common code to mark the inferior as not running. */
9887 generic_mourn_inferior ();
9889 if (!have_inferiors ())
9891 if (!remote_multi_process_p (rs))
9893 /* Check whether the target is running now - some remote stubs
9894 automatically restart after kill. */
9896 getpkt (&rs->buf, &rs->buf_size, 0);
9898 if (rs->buf[0] == 'S' || rs->buf[0] == 'T')
9900 /* Assume that the target has been restarted. Set
9901 inferior_ptid so that bits of core GDB realizes
9902 there's something here, e.g., so that the user can
9903 say "kill" again. */
9904 inferior_ptid = magic_null_ptid;
9911 extended_remote_target::supports_disable_randomization ()
9913 return packet_support (PACKET_QDisableRandomization) == PACKET_ENABLE;
9917 remote_target::extended_remote_disable_randomization (int val)
9919 struct remote_state *rs = get_remote_state ();
9922 xsnprintf (rs->buf, get_remote_packet_size (), "QDisableRandomization:%x",
9925 reply = remote_get_noisy_reply ();
9927 error (_("Target does not support QDisableRandomization."));
9928 if (strcmp (reply, "OK") != 0)
9929 error (_("Bogus QDisableRandomization reply from target: %s"), reply);
9933 remote_target::extended_remote_run (const std::string &args)
9935 struct remote_state *rs = get_remote_state ();
9937 const char *remote_exec_file = get_remote_exec_file ();
9939 /* If the user has disabled vRun support, or we have detected that
9940 support is not available, do not try it. */
9941 if (packet_support (PACKET_vRun) == PACKET_DISABLE)
9944 strcpy (rs->buf, "vRun;");
9945 len = strlen (rs->buf);
9947 if (strlen (remote_exec_file) * 2 + len >= get_remote_packet_size ())
9948 error (_("Remote file name too long for run packet"));
9949 len += 2 * bin2hex ((gdb_byte *) remote_exec_file, rs->buf + len,
9950 strlen (remote_exec_file));
9956 gdb_argv argv (args.c_str ());
9957 for (i = 0; argv[i] != NULL; i++)
9959 if (strlen (argv[i]) * 2 + 1 + len >= get_remote_packet_size ())
9960 error (_("Argument list too long for run packet"));
9961 rs->buf[len++] = ';';
9962 len += 2 * bin2hex ((gdb_byte *) argv[i], rs->buf + len,
9967 rs->buf[len++] = '\0';
9970 getpkt (&rs->buf, &rs->buf_size, 0);
9972 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_vRun]))
9975 /* We have a wait response. All is well. */
9977 case PACKET_UNKNOWN:
9980 if (remote_exec_file[0] == '\0')
9981 error (_("Running the default executable on the remote target failed; "
9982 "try \"set remote exec-file\"?"));
9984 error (_("Running \"%s\" on the remote target failed"),
9987 gdb_assert_not_reached (_("bad switch"));
9991 /* Helper function to send set/unset environment packets. ACTION is
9992 either "set" or "unset". PACKET is either "QEnvironmentHexEncoded"
9993 or "QEnvironmentUnsetVariable". VALUE is the variable to be
9997 remote_target::send_environment_packet (const char *action,
10001 remote_state *rs = get_remote_state ();
10003 /* Convert the environment variable to an hex string, which
10004 is the best format to be transmitted over the wire. */
10005 std::string encoded_value = bin2hex ((const gdb_byte *) value,
10008 xsnprintf (rs->buf, get_remote_packet_size (),
10009 "%s:%s", packet, encoded_value.c_str ());
10012 getpkt (&rs->buf, &rs->buf_size, 0);
10013 if (strcmp (rs->buf, "OK") != 0)
10014 warning (_("Unable to %s environment variable '%s' on remote."),
10018 /* Helper function to handle the QEnvironment* packets. */
10021 remote_target::extended_remote_environment_support ()
10023 remote_state *rs = get_remote_state ();
10025 if (packet_support (PACKET_QEnvironmentReset) != PACKET_DISABLE)
10027 putpkt ("QEnvironmentReset");
10028 getpkt (&rs->buf, &rs->buf_size, 0);
10029 if (strcmp (rs->buf, "OK") != 0)
10030 warning (_("Unable to reset environment on remote."));
10033 gdb_environ *e = ¤t_inferior ()->environment;
10035 if (packet_support (PACKET_QEnvironmentHexEncoded) != PACKET_DISABLE)
10036 for (const std::string &el : e->user_set_env ())
10037 send_environment_packet ("set", "QEnvironmentHexEncoded",
10040 if (packet_support (PACKET_QEnvironmentUnset) != PACKET_DISABLE)
10041 for (const std::string &el : e->user_unset_env ())
10042 send_environment_packet ("unset", "QEnvironmentUnset", el.c_str ());
10045 /* Helper function to set the current working directory for the
10046 inferior in the remote target. */
10049 remote_target::extended_remote_set_inferior_cwd ()
10051 if (packet_support (PACKET_QSetWorkingDir) != PACKET_DISABLE)
10053 const char *inferior_cwd = get_inferior_cwd ();
10054 remote_state *rs = get_remote_state ();
10056 if (inferior_cwd != NULL)
10058 std::string hexpath = bin2hex ((const gdb_byte *) inferior_cwd,
10059 strlen (inferior_cwd));
10061 xsnprintf (rs->buf, get_remote_packet_size (),
10062 "QSetWorkingDir:%s", hexpath.c_str ());
10066 /* An empty inferior_cwd means that the user wants us to
10067 reset the remote server's inferior's cwd. */
10068 xsnprintf (rs->buf, get_remote_packet_size (),
10069 "QSetWorkingDir:");
10073 getpkt (&rs->buf, &rs->buf_size, 0);
10074 if (packet_ok (rs->buf,
10075 &remote_protocol_packets[PACKET_QSetWorkingDir])
10078 Remote replied unexpectedly while setting the inferior's working\n\
10085 /* In the extended protocol we want to be able to do things like
10086 "run" and have them basically work as expected. So we need
10087 a special create_inferior function. We support changing the
10088 executable file and the command line arguments, but not the
10092 extended_remote_target::create_inferior (const char *exec_file,
10093 const std::string &args,
10094 char **env, int from_tty)
10098 struct remote_state *rs = get_remote_state ();
10099 const char *remote_exec_file = get_remote_exec_file ();
10101 /* If running asynchronously, register the target file descriptor
10102 with the event loop. */
10103 if (target_can_async_p ())
10106 /* Disable address space randomization if requested (and supported). */
10107 if (supports_disable_randomization ())
10108 extended_remote_disable_randomization (disable_randomization);
10110 /* If startup-with-shell is on, we inform gdbserver to start the
10111 remote inferior using a shell. */
10112 if (packet_support (PACKET_QStartupWithShell) != PACKET_DISABLE)
10114 xsnprintf (rs->buf, get_remote_packet_size (),
10115 "QStartupWithShell:%d", startup_with_shell ? 1 : 0);
10117 getpkt (&rs->buf, &rs->buf_size, 0);
10118 if (strcmp (rs->buf, "OK") != 0)
10120 Remote replied unexpectedly while setting startup-with-shell: %s"),
10124 extended_remote_environment_support ();
10126 extended_remote_set_inferior_cwd ();
10128 /* Now restart the remote server. */
10129 run_worked = extended_remote_run (args) != -1;
10132 /* vRun was not supported. Fail if we need it to do what the
10134 if (remote_exec_file[0])
10135 error (_("Remote target does not support \"set remote exec-file\""));
10136 if (!args.empty ())
10137 error (_("Remote target does not support \"set args\" or run ARGS"));
10139 /* Fall back to "R". */
10140 extended_remote_restart ();
10143 /* vRun's success return is a stop reply. */
10144 stop_reply = run_worked ? rs->buf : NULL;
10145 add_current_inferior_and_thread (stop_reply);
10147 /* Get updated offsets, if the stub uses qOffsets. */
10152 /* Given a location's target info BP_TGT and the packet buffer BUF, output
10153 the list of conditions (in agent expression bytecode format), if any, the
10154 target needs to evaluate. The output is placed into the packet buffer
10155 started from BUF and ended at BUF_END. */
10158 remote_add_target_side_condition (struct gdbarch *gdbarch,
10159 struct bp_target_info *bp_tgt, char *buf,
10162 if (bp_tgt->conditions.empty ())
10165 buf += strlen (buf);
10166 xsnprintf (buf, buf_end - buf, "%s", ";");
10169 /* Send conditions to the target. */
10170 for (agent_expr *aexpr : bp_tgt->conditions)
10172 xsnprintf (buf, buf_end - buf, "X%x,", aexpr->len);
10173 buf += strlen (buf);
10174 for (int i = 0; i < aexpr->len; ++i)
10175 buf = pack_hex_byte (buf, aexpr->buf[i]);
10182 remote_add_target_side_commands (struct gdbarch *gdbarch,
10183 struct bp_target_info *bp_tgt, char *buf)
10185 if (bp_tgt->tcommands.empty ())
10188 buf += strlen (buf);
10190 sprintf (buf, ";cmds:%x,", bp_tgt->persist);
10191 buf += strlen (buf);
10193 /* Concatenate all the agent expressions that are commands into the
10195 for (agent_expr *aexpr : bp_tgt->tcommands)
10197 sprintf (buf, "X%x,", aexpr->len);
10198 buf += strlen (buf);
10199 for (int i = 0; i < aexpr->len; ++i)
10200 buf = pack_hex_byte (buf, aexpr->buf[i]);
10205 /* Insert a breakpoint. On targets that have software breakpoint
10206 support, we ask the remote target to do the work; on targets
10207 which don't, we insert a traditional memory breakpoint. */
10210 remote_target::insert_breakpoint (struct gdbarch *gdbarch,
10211 struct bp_target_info *bp_tgt)
10213 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
10214 If it succeeds, then set the support to PACKET_ENABLE. If it
10215 fails, and the user has explicitly requested the Z support then
10216 report an error, otherwise, mark it disabled and go on. */
10218 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
10220 CORE_ADDR addr = bp_tgt->reqstd_address;
10221 struct remote_state *rs;
10224 /* Make sure the remote is pointing at the right process, if
10226 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10227 set_general_process ();
10229 rs = get_remote_state ();
10231 endbuf = rs->buf + get_remote_packet_size ();
10236 addr = (ULONGEST) remote_address_masked (addr);
10237 p += hexnumstr (p, addr);
10238 xsnprintf (p, endbuf - p, ",%d", bp_tgt->kind);
10240 if (supports_evaluation_of_breakpoint_conditions ())
10241 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
10243 if (can_run_breakpoint_commands ())
10244 remote_add_target_side_commands (gdbarch, bp_tgt, p);
10247 getpkt (&rs->buf, &rs->buf_size, 0);
10249 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0]))
10255 case PACKET_UNKNOWN:
10260 /* If this breakpoint has target-side commands but this stub doesn't
10261 support Z0 packets, throw error. */
10262 if (!bp_tgt->tcommands.empty ())
10263 throw_error (NOT_SUPPORTED_ERROR, _("\
10264 Target doesn't support breakpoints that have target side commands."));
10266 return memory_insert_breakpoint (this, gdbarch, bp_tgt);
10270 remote_target::remove_breakpoint (struct gdbarch *gdbarch,
10271 struct bp_target_info *bp_tgt,
10272 enum remove_bp_reason reason)
10274 CORE_ADDR addr = bp_tgt->placed_address;
10275 struct remote_state *rs = get_remote_state ();
10277 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
10280 char *endbuf = rs->buf + get_remote_packet_size ();
10282 /* Make sure the remote is pointing at the right process, if
10284 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10285 set_general_process ();
10291 addr = (ULONGEST) remote_address_masked (bp_tgt->placed_address);
10292 p += hexnumstr (p, addr);
10293 xsnprintf (p, endbuf - p, ",%d", bp_tgt->kind);
10296 getpkt (&rs->buf, &rs->buf_size, 0);
10298 return (rs->buf[0] == 'E');
10301 return memory_remove_breakpoint (this, gdbarch, bp_tgt, reason);
10304 static enum Z_packet_type
10305 watchpoint_to_Z_packet (int type)
10310 return Z_PACKET_WRITE_WP;
10313 return Z_PACKET_READ_WP;
10316 return Z_PACKET_ACCESS_WP;
10319 internal_error (__FILE__, __LINE__,
10320 _("hw_bp_to_z: bad watchpoint type %d"), type);
10325 remote_target::insert_watchpoint (CORE_ADDR addr, int len,
10326 enum target_hw_bp_type type, struct expression *cond)
10328 struct remote_state *rs = get_remote_state ();
10329 char *endbuf = rs->buf + get_remote_packet_size ();
10331 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
10333 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
10336 /* Make sure the remote is pointing at the right process, if
10338 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10339 set_general_process ();
10341 xsnprintf (rs->buf, endbuf - rs->buf, "Z%x,", packet);
10342 p = strchr (rs->buf, '\0');
10343 addr = remote_address_masked (addr);
10344 p += hexnumstr (p, (ULONGEST) addr);
10345 xsnprintf (p, endbuf - p, ",%x", len);
10348 getpkt (&rs->buf, &rs->buf_size, 0);
10350 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
10354 case PACKET_UNKNOWN:
10359 internal_error (__FILE__, __LINE__,
10360 _("remote_insert_watchpoint: reached end of function"));
10364 remote_target::watchpoint_addr_within_range (CORE_ADDR addr,
10365 CORE_ADDR start, int length)
10367 CORE_ADDR diff = remote_address_masked (addr - start);
10369 return diff < length;
10374 remote_target::remove_watchpoint (CORE_ADDR addr, int len,
10375 enum target_hw_bp_type type, struct expression *cond)
10377 struct remote_state *rs = get_remote_state ();
10378 char *endbuf = rs->buf + get_remote_packet_size ();
10380 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
10382 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
10385 /* Make sure the remote is pointing at the right process, if
10387 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10388 set_general_process ();
10390 xsnprintf (rs->buf, endbuf - rs->buf, "z%x,", packet);
10391 p = strchr (rs->buf, '\0');
10392 addr = remote_address_masked (addr);
10393 p += hexnumstr (p, (ULONGEST) addr);
10394 xsnprintf (p, endbuf - p, ",%x", len);
10396 getpkt (&rs->buf, &rs->buf_size, 0);
10398 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
10401 case PACKET_UNKNOWN:
10406 internal_error (__FILE__, __LINE__,
10407 _("remote_remove_watchpoint: reached end of function"));
10411 int remote_hw_watchpoint_limit = -1;
10412 int remote_hw_watchpoint_length_limit = -1;
10413 int remote_hw_breakpoint_limit = -1;
10416 remote_target::region_ok_for_hw_watchpoint (CORE_ADDR addr, int len)
10418 if (remote_hw_watchpoint_length_limit == 0)
10420 else if (remote_hw_watchpoint_length_limit < 0)
10422 else if (len <= remote_hw_watchpoint_length_limit)
10429 remote_target::can_use_hw_breakpoint (enum bptype type, int cnt, int ot)
10431 if (type == bp_hardware_breakpoint)
10433 if (remote_hw_breakpoint_limit == 0)
10435 else if (remote_hw_breakpoint_limit < 0)
10437 else if (cnt <= remote_hw_breakpoint_limit)
10442 if (remote_hw_watchpoint_limit == 0)
10444 else if (remote_hw_watchpoint_limit < 0)
10448 else if (cnt <= remote_hw_watchpoint_limit)
10454 /* The to_stopped_by_sw_breakpoint method of target remote. */
10457 remote_target::stopped_by_sw_breakpoint ()
10459 struct thread_info *thread = inferior_thread ();
10461 return (thread->priv != NULL
10462 && (get_remote_thread_info (thread)->stop_reason
10463 == TARGET_STOPPED_BY_SW_BREAKPOINT));
10466 /* The to_supports_stopped_by_sw_breakpoint method of target
10470 remote_target::supports_stopped_by_sw_breakpoint ()
10472 return (packet_support (PACKET_swbreak_feature) == PACKET_ENABLE);
10475 /* The to_stopped_by_hw_breakpoint method of target remote. */
10478 remote_target::stopped_by_hw_breakpoint ()
10480 struct thread_info *thread = inferior_thread ();
10482 return (thread->priv != NULL
10483 && (get_remote_thread_info (thread)->stop_reason
10484 == TARGET_STOPPED_BY_HW_BREAKPOINT));
10487 /* The to_supports_stopped_by_hw_breakpoint method of target
10491 remote_target::supports_stopped_by_hw_breakpoint ()
10493 return (packet_support (PACKET_hwbreak_feature) == PACKET_ENABLE);
10497 remote_target::stopped_by_watchpoint ()
10499 struct thread_info *thread = inferior_thread ();
10501 return (thread->priv != NULL
10502 && (get_remote_thread_info (thread)->stop_reason
10503 == TARGET_STOPPED_BY_WATCHPOINT));
10507 remote_target::stopped_data_address (CORE_ADDR *addr_p)
10509 struct thread_info *thread = inferior_thread ();
10511 if (thread->priv != NULL
10512 && (get_remote_thread_info (thread)->stop_reason
10513 == TARGET_STOPPED_BY_WATCHPOINT))
10515 *addr_p = get_remote_thread_info (thread)->watch_data_address;
10524 remote_target::insert_hw_breakpoint (struct gdbarch *gdbarch,
10525 struct bp_target_info *bp_tgt)
10527 CORE_ADDR addr = bp_tgt->reqstd_address;
10528 struct remote_state *rs;
10532 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
10535 /* Make sure the remote is pointing at the right process, if
10537 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10538 set_general_process ();
10540 rs = get_remote_state ();
10542 endbuf = rs->buf + get_remote_packet_size ();
10548 addr = remote_address_masked (addr);
10549 p += hexnumstr (p, (ULONGEST) addr);
10550 xsnprintf (p, endbuf - p, ",%x", bp_tgt->kind);
10552 if (supports_evaluation_of_breakpoint_conditions ())
10553 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
10555 if (can_run_breakpoint_commands ())
10556 remote_add_target_side_commands (gdbarch, bp_tgt, p);
10559 getpkt (&rs->buf, &rs->buf_size, 0);
10561 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
10564 if (rs->buf[1] == '.')
10566 message = strchr (rs->buf + 2, '.');
10568 error (_("Remote failure reply: %s"), message + 1);
10571 case PACKET_UNKNOWN:
10576 internal_error (__FILE__, __LINE__,
10577 _("remote_insert_hw_breakpoint: reached end of function"));
10582 remote_target::remove_hw_breakpoint (struct gdbarch *gdbarch,
10583 struct bp_target_info *bp_tgt)
10586 struct remote_state *rs = get_remote_state ();
10588 char *endbuf = rs->buf + get_remote_packet_size ();
10590 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
10593 /* Make sure the remote is pointing at the right process, if
10595 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10596 set_general_process ();
10602 addr = remote_address_masked (bp_tgt->placed_address);
10603 p += hexnumstr (p, (ULONGEST) addr);
10604 xsnprintf (p, endbuf - p, ",%x", bp_tgt->kind);
10607 getpkt (&rs->buf, &rs->buf_size, 0);
10609 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
10612 case PACKET_UNKNOWN:
10617 internal_error (__FILE__, __LINE__,
10618 _("remote_remove_hw_breakpoint: reached end of function"));
10621 /* Verify memory using the "qCRC:" request. */
10624 remote_target::verify_memory (const gdb_byte *data, CORE_ADDR lma, ULONGEST size)
10626 struct remote_state *rs = get_remote_state ();
10627 unsigned long host_crc, target_crc;
10630 /* It doesn't make sense to use qCRC if the remote target is
10631 connected but not running. */
10632 if (target_has_execution && packet_support (PACKET_qCRC) != PACKET_DISABLE)
10634 enum packet_result result;
10636 /* Make sure the remote is pointing at the right process. */
10637 set_general_process ();
10639 /* FIXME: assumes lma can fit into long. */
10640 xsnprintf (rs->buf, get_remote_packet_size (), "qCRC:%lx,%lx",
10641 (long) lma, (long) size);
10644 /* Be clever; compute the host_crc before waiting for target
10646 host_crc = xcrc32 (data, size, 0xffffffff);
10648 getpkt (&rs->buf, &rs->buf_size, 0);
10650 result = packet_ok (rs->buf,
10651 &remote_protocol_packets[PACKET_qCRC]);
10652 if (result == PACKET_ERROR)
10654 else if (result == PACKET_OK)
10656 for (target_crc = 0, tmp = &rs->buf[1]; *tmp; tmp++)
10657 target_crc = target_crc * 16 + fromhex (*tmp);
10659 return (host_crc == target_crc);
10663 return simple_verify_memory (this, data, lma, size);
10666 /* compare-sections command
10668 With no arguments, compares each loadable section in the exec bfd
10669 with the same memory range on the target, and reports mismatches.
10670 Useful for verifying the image on the target against the exec file. */
10673 compare_sections_command (const char *args, int from_tty)
10676 const char *sectname;
10677 bfd_size_type size;
10680 int mismatched = 0;
10685 error (_("command cannot be used without an exec file"));
10687 if (args != NULL && strcmp (args, "-r") == 0)
10693 for (s = exec_bfd->sections; s; s = s->next)
10695 if (!(s->flags & SEC_LOAD))
10696 continue; /* Skip non-loadable section. */
10698 if (read_only && (s->flags & SEC_READONLY) == 0)
10699 continue; /* Skip writeable sections */
10701 size = bfd_get_section_size (s);
10703 continue; /* Skip zero-length section. */
10705 sectname = bfd_get_section_name (exec_bfd, s);
10706 if (args && strcmp (args, sectname) != 0)
10707 continue; /* Not the section selected by user. */
10709 matched = 1; /* Do this section. */
10712 gdb::byte_vector sectdata (size);
10713 bfd_get_section_contents (exec_bfd, s, sectdata.data (), 0, size);
10715 res = target_verify_memory (sectdata.data (), lma, size);
10718 error (_("target memory fault, section %s, range %s -- %s"), sectname,
10719 paddress (target_gdbarch (), lma),
10720 paddress (target_gdbarch (), lma + size));
10722 printf_filtered ("Section %s, range %s -- %s: ", sectname,
10723 paddress (target_gdbarch (), lma),
10724 paddress (target_gdbarch (), lma + size));
10726 printf_filtered ("matched.\n");
10729 printf_filtered ("MIS-MATCHED!\n");
10733 if (mismatched > 0)
10734 warning (_("One or more sections of the target image does not match\n\
10735 the loaded file\n"));
10736 if (args && !matched)
10737 printf_filtered (_("No loaded section named '%s'.\n"), args);
10740 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
10741 into remote target. The number of bytes written to the remote
10742 target is returned, or -1 for error. */
10745 remote_target::remote_write_qxfer (const char *object_name,
10746 const char *annex, const gdb_byte *writebuf,
10747 ULONGEST offset, LONGEST len,
10748 ULONGEST *xfered_len,
10749 struct packet_config *packet)
10753 struct remote_state *rs = get_remote_state ();
10754 int max_size = get_memory_write_packet_size ();
10756 if (packet_config_support (packet) == PACKET_DISABLE)
10757 return TARGET_XFER_E_IO;
10759 /* Insert header. */
10760 i = snprintf (rs->buf, max_size,
10761 "qXfer:%s:write:%s:%s:",
10762 object_name, annex ? annex : "",
10763 phex_nz (offset, sizeof offset));
10764 max_size -= (i + 1);
10766 /* Escape as much data as fits into rs->buf. */
10767 buf_len = remote_escape_output
10768 (writebuf, len, 1, (gdb_byte *) rs->buf + i, &max_size, max_size);
10770 if (putpkt_binary (rs->buf, i + buf_len) < 0
10771 || getpkt_sane (&rs->buf, &rs->buf_size, 0) < 0
10772 || packet_ok (rs->buf, packet) != PACKET_OK)
10773 return TARGET_XFER_E_IO;
10775 unpack_varlen_hex (rs->buf, &n);
10778 return (*xfered_len != 0) ? TARGET_XFER_OK : TARGET_XFER_EOF;
10781 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
10782 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
10783 number of bytes read is returned, or 0 for EOF, or -1 for error.
10784 The number of bytes read may be less than LEN without indicating an
10785 EOF. PACKET is checked and updated to indicate whether the remote
10786 target supports this object. */
10789 remote_target::remote_read_qxfer (const char *object_name,
10791 gdb_byte *readbuf, ULONGEST offset,
10793 ULONGEST *xfered_len,
10794 struct packet_config *packet)
10796 struct remote_state *rs = get_remote_state ();
10797 LONGEST i, n, packet_len;
10799 if (packet_config_support (packet) == PACKET_DISABLE)
10800 return TARGET_XFER_E_IO;
10802 /* Check whether we've cached an end-of-object packet that matches
10804 if (rs->finished_object)
10806 if (strcmp (object_name, rs->finished_object) == 0
10807 && strcmp (annex ? annex : "", rs->finished_annex) == 0
10808 && offset == rs->finished_offset)
10809 return TARGET_XFER_EOF;
10812 /* Otherwise, we're now reading something different. Discard
10814 xfree (rs->finished_object);
10815 xfree (rs->finished_annex);
10816 rs->finished_object = NULL;
10817 rs->finished_annex = NULL;
10820 /* Request only enough to fit in a single packet. The actual data
10821 may not, since we don't know how much of it will need to be escaped;
10822 the target is free to respond with slightly less data. We subtract
10823 five to account for the response type and the protocol frame. */
10824 n = std::min<LONGEST> (get_remote_packet_size () - 5, len);
10825 snprintf (rs->buf, get_remote_packet_size () - 4, "qXfer:%s:read:%s:%s,%s",
10826 object_name, annex ? annex : "",
10827 phex_nz (offset, sizeof offset),
10828 phex_nz (n, sizeof n));
10829 i = putpkt (rs->buf);
10831 return TARGET_XFER_E_IO;
10834 packet_len = getpkt_sane (&rs->buf, &rs->buf_size, 0);
10835 if (packet_len < 0 || packet_ok (rs->buf, packet) != PACKET_OK)
10836 return TARGET_XFER_E_IO;
10838 if (rs->buf[0] != 'l' && rs->buf[0] != 'm')
10839 error (_("Unknown remote qXfer reply: %s"), rs->buf);
10841 /* 'm' means there is (or at least might be) more data after this
10842 batch. That does not make sense unless there's at least one byte
10843 of data in this reply. */
10844 if (rs->buf[0] == 'm' && packet_len == 1)
10845 error (_("Remote qXfer reply contained no data."));
10847 /* Got some data. */
10848 i = remote_unescape_input ((gdb_byte *) rs->buf + 1,
10849 packet_len - 1, readbuf, n);
10851 /* 'l' is an EOF marker, possibly including a final block of data,
10852 or possibly empty. If we have the final block of a non-empty
10853 object, record this fact to bypass a subsequent partial read. */
10854 if (rs->buf[0] == 'l' && offset + i > 0)
10856 rs->finished_object = xstrdup (object_name);
10857 rs->finished_annex = xstrdup (annex ? annex : "");
10858 rs->finished_offset = offset + i;
10862 return TARGET_XFER_EOF;
10866 return TARGET_XFER_OK;
10870 enum target_xfer_status
10871 remote_target::xfer_partial (enum target_object object,
10872 const char *annex, gdb_byte *readbuf,
10873 const gdb_byte *writebuf, ULONGEST offset, ULONGEST len,
10874 ULONGEST *xfered_len)
10876 struct remote_state *rs;
10880 int unit_size = gdbarch_addressable_memory_unit_size (target_gdbarch ());
10882 set_remote_traceframe ();
10883 set_general_thread (inferior_ptid);
10885 rs = get_remote_state ();
10887 /* Handle memory using the standard memory routines. */
10888 if (object == TARGET_OBJECT_MEMORY)
10890 /* If the remote target is connected but not running, we should
10891 pass this request down to a lower stratum (e.g. the executable
10893 if (!target_has_execution)
10894 return TARGET_XFER_EOF;
10896 if (writebuf != NULL)
10897 return remote_write_bytes (offset, writebuf, len, unit_size,
10900 return remote_read_bytes (offset, readbuf, len, unit_size,
10904 /* Handle SPU memory using qxfer packets. */
10905 if (object == TARGET_OBJECT_SPU)
10908 return remote_read_qxfer ("spu", annex, readbuf, offset, len,
10909 xfered_len, &remote_protocol_packets
10910 [PACKET_qXfer_spu_read]);
10912 return remote_write_qxfer ("spu", annex, writebuf, offset, len,
10913 xfered_len, &remote_protocol_packets
10914 [PACKET_qXfer_spu_write]);
10917 /* Handle extra signal info using qxfer packets. */
10918 if (object == TARGET_OBJECT_SIGNAL_INFO)
10921 return remote_read_qxfer ("siginfo", annex, readbuf, offset, len,
10922 xfered_len, &remote_protocol_packets
10923 [PACKET_qXfer_siginfo_read]);
10925 return remote_write_qxfer ("siginfo", annex,
10926 writebuf, offset, len, xfered_len,
10927 &remote_protocol_packets
10928 [PACKET_qXfer_siginfo_write]);
10931 if (object == TARGET_OBJECT_STATIC_TRACE_DATA)
10934 return remote_read_qxfer ("statictrace", annex,
10935 readbuf, offset, len, xfered_len,
10936 &remote_protocol_packets
10937 [PACKET_qXfer_statictrace_read]);
10939 return TARGET_XFER_E_IO;
10942 /* Only handle flash writes. */
10943 if (writebuf != NULL)
10947 case TARGET_OBJECT_FLASH:
10948 return remote_flash_write (offset, len, xfered_len,
10952 return TARGET_XFER_E_IO;
10956 /* Map pre-existing objects onto letters. DO NOT do this for new
10957 objects!!! Instead specify new query packets. */
10960 case TARGET_OBJECT_AVR:
10964 case TARGET_OBJECT_AUXV:
10965 gdb_assert (annex == NULL);
10966 return remote_read_qxfer ("auxv", annex, readbuf, offset, len,
10968 &remote_protocol_packets[PACKET_qXfer_auxv]);
10970 case TARGET_OBJECT_AVAILABLE_FEATURES:
10971 return remote_read_qxfer
10972 ("features", annex, readbuf, offset, len, xfered_len,
10973 &remote_protocol_packets[PACKET_qXfer_features]);
10975 case TARGET_OBJECT_LIBRARIES:
10976 return remote_read_qxfer
10977 ("libraries", annex, readbuf, offset, len, xfered_len,
10978 &remote_protocol_packets[PACKET_qXfer_libraries]);
10980 case TARGET_OBJECT_LIBRARIES_SVR4:
10981 return remote_read_qxfer
10982 ("libraries-svr4", annex, readbuf, offset, len, xfered_len,
10983 &remote_protocol_packets[PACKET_qXfer_libraries_svr4]);
10985 case TARGET_OBJECT_MEMORY_MAP:
10986 gdb_assert (annex == NULL);
10987 return remote_read_qxfer ("memory-map", annex, readbuf, offset, len,
10989 &remote_protocol_packets[PACKET_qXfer_memory_map]);
10991 case TARGET_OBJECT_OSDATA:
10992 /* Should only get here if we're connected. */
10993 gdb_assert (rs->remote_desc);
10994 return remote_read_qxfer
10995 ("osdata", annex, readbuf, offset, len, xfered_len,
10996 &remote_protocol_packets[PACKET_qXfer_osdata]);
10998 case TARGET_OBJECT_THREADS:
10999 gdb_assert (annex == NULL);
11000 return remote_read_qxfer ("threads", annex, readbuf, offset, len,
11002 &remote_protocol_packets[PACKET_qXfer_threads]);
11004 case TARGET_OBJECT_TRACEFRAME_INFO:
11005 gdb_assert (annex == NULL);
11006 return remote_read_qxfer
11007 ("traceframe-info", annex, readbuf, offset, len, xfered_len,
11008 &remote_protocol_packets[PACKET_qXfer_traceframe_info]);
11010 case TARGET_OBJECT_FDPIC:
11011 return remote_read_qxfer ("fdpic", annex, readbuf, offset, len,
11013 &remote_protocol_packets[PACKET_qXfer_fdpic]);
11015 case TARGET_OBJECT_OPENVMS_UIB:
11016 return remote_read_qxfer ("uib", annex, readbuf, offset, len,
11018 &remote_protocol_packets[PACKET_qXfer_uib]);
11020 case TARGET_OBJECT_BTRACE:
11021 return remote_read_qxfer ("btrace", annex, readbuf, offset, len,
11023 &remote_protocol_packets[PACKET_qXfer_btrace]);
11025 case TARGET_OBJECT_BTRACE_CONF:
11026 return remote_read_qxfer ("btrace-conf", annex, readbuf, offset,
11028 &remote_protocol_packets[PACKET_qXfer_btrace_conf]);
11030 case TARGET_OBJECT_EXEC_FILE:
11031 return remote_read_qxfer ("exec-file", annex, readbuf, offset,
11033 &remote_protocol_packets[PACKET_qXfer_exec_file]);
11036 return TARGET_XFER_E_IO;
11039 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
11040 large enough let the caller deal with it. */
11041 if (len < get_remote_packet_size ())
11042 return TARGET_XFER_E_IO;
11043 len = get_remote_packet_size ();
11045 /* Except for querying the minimum buffer size, target must be open. */
11046 if (!rs->remote_desc)
11047 error (_("remote query is only available after target open"));
11049 gdb_assert (annex != NULL);
11050 gdb_assert (readbuf != NULL);
11054 *p2++ = query_type;
11056 /* We used one buffer char for the remote protocol q command and
11057 another for the query type. As the remote protocol encapsulation
11058 uses 4 chars plus one extra in case we are debugging
11059 (remote_debug), we have PBUFZIZ - 7 left to pack the query
11062 while (annex[i] && (i < (get_remote_packet_size () - 8)))
11064 /* Bad caller may have sent forbidden characters. */
11065 gdb_assert (isprint (annex[i]) && annex[i] != '$' && annex[i] != '#');
11070 gdb_assert (annex[i] == '\0');
11072 i = putpkt (rs->buf);
11074 return TARGET_XFER_E_IO;
11076 getpkt (&rs->buf, &rs->buf_size, 0);
11077 strcpy ((char *) readbuf, rs->buf);
11079 *xfered_len = strlen ((char *) readbuf);
11080 return (*xfered_len != 0) ? TARGET_XFER_OK : TARGET_XFER_EOF;
11083 /* Implementation of to_get_memory_xfer_limit. */
11086 remote_target::get_memory_xfer_limit ()
11088 return get_memory_write_packet_size ();
11092 remote_target::search_memory (CORE_ADDR start_addr, ULONGEST search_space_len,
11093 const gdb_byte *pattern, ULONGEST pattern_len,
11094 CORE_ADDR *found_addrp)
11096 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
11097 struct remote_state *rs = get_remote_state ();
11098 int max_size = get_memory_write_packet_size ();
11099 struct packet_config *packet =
11100 &remote_protocol_packets[PACKET_qSearch_memory];
11101 /* Number of packet bytes used to encode the pattern;
11102 this could be more than PATTERN_LEN due to escape characters. */
11103 int escaped_pattern_len;
11104 /* Amount of pattern that was encodable in the packet. */
11105 int used_pattern_len;
11108 ULONGEST found_addr;
11110 /* Don't go to the target if we don't have to. This is done before
11111 checking packet_config_support to avoid the possibility that a
11112 success for this edge case means the facility works in
11114 if (pattern_len > search_space_len)
11116 if (pattern_len == 0)
11118 *found_addrp = start_addr;
11122 /* If we already know the packet isn't supported, fall back to the simple
11123 way of searching memory. */
11125 if (packet_config_support (packet) == PACKET_DISABLE)
11127 /* Target doesn't provided special support, fall back and use the
11128 standard support (copy memory and do the search here). */
11129 return simple_search_memory (this, start_addr, search_space_len,
11130 pattern, pattern_len, found_addrp);
11133 /* Make sure the remote is pointing at the right process. */
11134 set_general_process ();
11136 /* Insert header. */
11137 i = snprintf (rs->buf, max_size,
11138 "qSearch:memory:%s;%s;",
11139 phex_nz (start_addr, addr_size),
11140 phex_nz (search_space_len, sizeof (search_space_len)));
11141 max_size -= (i + 1);
11143 /* Escape as much data as fits into rs->buf. */
11144 escaped_pattern_len =
11145 remote_escape_output (pattern, pattern_len, 1, (gdb_byte *) rs->buf + i,
11146 &used_pattern_len, max_size);
11148 /* Bail if the pattern is too large. */
11149 if (used_pattern_len != pattern_len)
11150 error (_("Pattern is too large to transmit to remote target."));
11152 if (putpkt_binary (rs->buf, i + escaped_pattern_len) < 0
11153 || getpkt_sane (&rs->buf, &rs->buf_size, 0) < 0
11154 || packet_ok (rs->buf, packet) != PACKET_OK)
11156 /* The request may not have worked because the command is not
11157 supported. If so, fall back to the simple way. */
11158 if (packet_config_support (packet) == PACKET_DISABLE)
11160 return simple_search_memory (this, start_addr, search_space_len,
11161 pattern, pattern_len, found_addrp);
11166 if (rs->buf[0] == '0')
11168 else if (rs->buf[0] == '1')
11171 if (rs->buf[1] != ',')
11172 error (_("Unknown qSearch:memory reply: %s"), rs->buf);
11173 unpack_varlen_hex (rs->buf + 2, &found_addr);
11174 *found_addrp = found_addr;
11177 error (_("Unknown qSearch:memory reply: %s"), rs->buf);
11183 remote_target::rcmd (const char *command, struct ui_file *outbuf)
11185 struct remote_state *rs = get_remote_state ();
11188 if (!rs->remote_desc)
11189 error (_("remote rcmd is only available after target open"));
11191 /* Send a NULL command across as an empty command. */
11192 if (command == NULL)
11195 /* The query prefix. */
11196 strcpy (rs->buf, "qRcmd,");
11197 p = strchr (rs->buf, '\0');
11199 if ((strlen (rs->buf) + strlen (command) * 2 + 8/*misc*/)
11200 > get_remote_packet_size ())
11201 error (_("\"monitor\" command ``%s'' is too long."), command);
11203 /* Encode the actual command. */
11204 bin2hex ((const gdb_byte *) command, p, strlen (command));
11206 if (putpkt (rs->buf) < 0)
11207 error (_("Communication problem with target."));
11209 /* get/display the response */
11214 /* XXX - see also remote_get_noisy_reply(). */
11215 QUIT; /* Allow user to bail out with ^C. */
11217 if (getpkt_sane (&rs->buf, &rs->buf_size, 0) == -1)
11219 /* Timeout. Continue to (try to) read responses.
11220 This is better than stopping with an error, assuming the stub
11221 is still executing the (long) monitor command.
11222 If needed, the user can interrupt gdb using C-c, obtaining
11223 an effect similar to stop on timeout. */
11227 if (buf[0] == '\0')
11228 error (_("Target does not support this command."));
11229 if (buf[0] == 'O' && buf[1] != 'K')
11231 remote_console_output (buf + 1); /* 'O' message from stub. */
11234 if (strcmp (buf, "OK") == 0)
11236 if (strlen (buf) == 3 && buf[0] == 'E'
11237 && isdigit (buf[1]) && isdigit (buf[2]))
11239 error (_("Protocol error with Rcmd"));
11241 for (p = buf; p[0] != '\0' && p[1] != '\0'; p += 2)
11243 char c = (fromhex (p[0]) << 4) + fromhex (p[1]);
11245 fputc_unfiltered (c, outbuf);
11251 std::vector<mem_region>
11252 remote_target::memory_map ()
11254 std::vector<mem_region> result;
11255 gdb::optional<gdb::char_vector> text
11256 = target_read_stralloc (current_top_target (), TARGET_OBJECT_MEMORY_MAP, NULL);
11259 result = parse_memory_map (text->data ());
11265 packet_command (const char *args, int from_tty)
11267 remote_target *remote = get_current_remote_target ();
11269 if (remote == nullptr)
11270 error (_("command can only be used with remote target"));
11272 remote->packet_command (args, from_tty);
11276 remote_target::packet_command (const char *args, int from_tty)
11279 error (_("remote-packet command requires packet text as argument"));
11281 puts_filtered ("sending: ");
11282 print_packet (args);
11283 puts_filtered ("\n");
11286 remote_state *rs = get_remote_state ();
11288 getpkt (&rs->buf, &rs->buf_size, 0);
11289 puts_filtered ("received: ");
11290 print_packet (rs->buf);
11291 puts_filtered ("\n");
11295 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
11297 static void display_thread_info (struct gdb_ext_thread_info *info);
11299 static void threadset_test_cmd (char *cmd, int tty);
11301 static void threadalive_test (char *cmd, int tty);
11303 static void threadlist_test_cmd (char *cmd, int tty);
11305 int get_and_display_threadinfo (threadref *ref);
11307 static void threadinfo_test_cmd (char *cmd, int tty);
11309 static int thread_display_step (threadref *ref, void *context);
11311 static void threadlist_update_test_cmd (char *cmd, int tty);
11313 static void init_remote_threadtests (void);
11315 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
11318 threadset_test_cmd (const char *cmd, int tty)
11320 int sample_thread = SAMPLE_THREAD;
11322 printf_filtered (_("Remote threadset test\n"));
11323 set_general_thread (sample_thread);
11328 threadalive_test (const char *cmd, int tty)
11330 int sample_thread = SAMPLE_THREAD;
11331 int pid = inferior_ptid.pid ();
11332 ptid_t ptid = ptid_t (pid, sample_thread, 0);
11334 if (remote_thread_alive (ptid))
11335 printf_filtered ("PASS: Thread alive test\n");
11337 printf_filtered ("FAIL: Thread alive test\n");
11340 void output_threadid (char *title, threadref *ref);
11343 output_threadid (char *title, threadref *ref)
11347 pack_threadid (&hexid[0], ref); /* Convert threead id into hex. */
11349 printf_filtered ("%s %s\n", title, (&hexid[0]));
11353 threadlist_test_cmd (const char *cmd, int tty)
11356 threadref nextthread;
11357 int done, result_count;
11358 threadref threadlist[3];
11360 printf_filtered ("Remote Threadlist test\n");
11361 if (!remote_get_threadlist (startflag, &nextthread, 3, &done,
11362 &result_count, &threadlist[0]))
11363 printf_filtered ("FAIL: threadlist test\n");
11366 threadref *scan = threadlist;
11367 threadref *limit = scan + result_count;
11369 while (scan < limit)
11370 output_threadid (" thread ", scan++);
11375 display_thread_info (struct gdb_ext_thread_info *info)
11377 output_threadid ("Threadid: ", &info->threadid);
11378 printf_filtered ("Name: %s\n ", info->shortname);
11379 printf_filtered ("State: %s\n", info->display);
11380 printf_filtered ("other: %s\n\n", info->more_display);
11384 get_and_display_threadinfo (threadref *ref)
11388 struct gdb_ext_thread_info threadinfo;
11390 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
11391 | TAG_MOREDISPLAY | TAG_DISPLAY;
11392 if (0 != (result = remote_get_threadinfo (ref, set, &threadinfo)))
11393 display_thread_info (&threadinfo);
11398 threadinfo_test_cmd (const char *cmd, int tty)
11400 int athread = SAMPLE_THREAD;
11404 int_to_threadref (&thread, athread);
11405 printf_filtered ("Remote Threadinfo test\n");
11406 if (!get_and_display_threadinfo (&thread))
11407 printf_filtered ("FAIL cannot get thread info\n");
11411 thread_display_step (threadref *ref, void *context)
11413 /* output_threadid(" threadstep ",ref); *//* simple test */
11414 return get_and_display_threadinfo (ref);
11418 threadlist_update_test_cmd (const char *cmd, int tty)
11420 printf_filtered ("Remote Threadlist update test\n");
11421 remote_threadlist_iterator (thread_display_step, 0, CRAZY_MAX_THREADS);
11425 init_remote_threadtests (void)
11427 add_com ("tlist", class_obscure, threadlist_test_cmd,
11428 _("Fetch and print the remote list of "
11429 "thread identifiers, one pkt only"));
11430 add_com ("tinfo", class_obscure, threadinfo_test_cmd,
11431 _("Fetch and display info about one thread"));
11432 add_com ("tset", class_obscure, threadset_test_cmd,
11433 _("Test setting to a different thread"));
11434 add_com ("tupd", class_obscure, threadlist_update_test_cmd,
11435 _("Iterate through updating all remote thread info"));
11436 add_com ("talive", class_obscure, threadalive_test,
11437 _(" Remote thread alive test "));
11442 /* Convert a thread ID to a string. Returns the string in a static
11446 remote_target::pid_to_str (ptid_t ptid)
11448 static char buf[64];
11449 struct remote_state *rs = get_remote_state ();
11451 if (ptid == null_ptid)
11452 return normal_pid_to_str (ptid);
11453 else if (ptid.is_pid ())
11455 /* Printing an inferior target id. */
11457 /* When multi-process extensions are off, there's no way in the
11458 remote protocol to know the remote process id, if there's any
11459 at all. There's one exception --- when we're connected with
11460 target extended-remote, and we manually attached to a process
11461 with "attach PID". We don't record anywhere a flag that
11462 allows us to distinguish that case from the case of
11463 connecting with extended-remote and the stub already being
11464 attached to a process, and reporting yes to qAttached, hence
11465 no smart special casing here. */
11466 if (!remote_multi_process_p (rs))
11468 xsnprintf (buf, sizeof buf, "Remote target");
11472 return normal_pid_to_str (ptid);
11476 if (magic_null_ptid == ptid)
11477 xsnprintf (buf, sizeof buf, "Thread <main>");
11478 else if (remote_multi_process_p (rs))
11479 if (ptid.lwp () == 0)
11480 return normal_pid_to_str (ptid);
11482 xsnprintf (buf, sizeof buf, "Thread %d.%ld",
11483 ptid.pid (), ptid.lwp ());
11485 xsnprintf (buf, sizeof buf, "Thread %ld",
11491 /* Get the address of the thread local variable in OBJFILE which is
11492 stored at OFFSET within the thread local storage for thread PTID. */
11495 remote_target::get_thread_local_address (ptid_t ptid, CORE_ADDR lm,
11498 if (packet_support (PACKET_qGetTLSAddr) != PACKET_DISABLE)
11500 struct remote_state *rs = get_remote_state ();
11502 char *endp = rs->buf + get_remote_packet_size ();
11503 enum packet_result result;
11505 strcpy (p, "qGetTLSAddr:");
11507 p = write_ptid (p, endp, ptid);
11509 p += hexnumstr (p, offset);
11511 p += hexnumstr (p, lm);
11515 getpkt (&rs->buf, &rs->buf_size, 0);
11516 result = packet_ok (rs->buf,
11517 &remote_protocol_packets[PACKET_qGetTLSAddr]);
11518 if (result == PACKET_OK)
11522 unpack_varlen_hex (rs->buf, &addr);
11525 else if (result == PACKET_UNKNOWN)
11526 throw_error (TLS_GENERIC_ERROR,
11527 _("Remote target doesn't support qGetTLSAddr packet"));
11529 throw_error (TLS_GENERIC_ERROR,
11530 _("Remote target failed to process qGetTLSAddr request"));
11533 throw_error (TLS_GENERIC_ERROR,
11534 _("TLS not supported or disabled on this target"));
11539 /* Provide thread local base, i.e. Thread Information Block address.
11540 Returns 1 if ptid is found and thread_local_base is non zero. */
11543 remote_target::get_tib_address (ptid_t ptid, CORE_ADDR *addr)
11545 if (packet_support (PACKET_qGetTIBAddr) != PACKET_DISABLE)
11547 struct remote_state *rs = get_remote_state ();
11549 char *endp = rs->buf + get_remote_packet_size ();
11550 enum packet_result result;
11552 strcpy (p, "qGetTIBAddr:");
11554 p = write_ptid (p, endp, ptid);
11558 getpkt (&rs->buf, &rs->buf_size, 0);
11559 result = packet_ok (rs->buf,
11560 &remote_protocol_packets[PACKET_qGetTIBAddr]);
11561 if (result == PACKET_OK)
11564 unpack_varlen_hex (rs->buf, &val);
11566 *addr = (CORE_ADDR) val;
11569 else if (result == PACKET_UNKNOWN)
11570 error (_("Remote target doesn't support qGetTIBAddr packet"));
11572 error (_("Remote target failed to process qGetTIBAddr request"));
11575 error (_("qGetTIBAddr not supported or disabled on this target"));
11580 /* Support for inferring a target description based on the current
11581 architecture and the size of a 'g' packet. While the 'g' packet
11582 can have any size (since optional registers can be left off the
11583 end), some sizes are easily recognizable given knowledge of the
11584 approximate architecture. */
11586 struct remote_g_packet_guess
11588 remote_g_packet_guess (int bytes_, const struct target_desc *tdesc_)
11595 const struct target_desc *tdesc;
11598 struct remote_g_packet_data : public allocate_on_obstack
11600 std::vector<remote_g_packet_guess> guesses;
11603 static struct gdbarch_data *remote_g_packet_data_handle;
11606 remote_g_packet_data_init (struct obstack *obstack)
11608 return new (obstack) remote_g_packet_data;
11612 register_remote_g_packet_guess (struct gdbarch *gdbarch, int bytes,
11613 const struct target_desc *tdesc)
11615 struct remote_g_packet_data *data
11616 = ((struct remote_g_packet_data *)
11617 gdbarch_data (gdbarch, remote_g_packet_data_handle));
11619 gdb_assert (tdesc != NULL);
11621 for (const remote_g_packet_guess &guess : data->guesses)
11622 if (guess.bytes == bytes)
11623 internal_error (__FILE__, __LINE__,
11624 _("Duplicate g packet description added for size %d"),
11627 data->guesses.emplace_back (bytes, tdesc);
11630 /* Return true if remote_read_description would do anything on this target
11631 and architecture, false otherwise. */
11634 remote_read_description_p (struct target_ops *target)
11636 struct remote_g_packet_data *data
11637 = ((struct remote_g_packet_data *)
11638 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle));
11640 return !data->guesses.empty ();
11643 const struct target_desc *
11644 remote_target::read_description ()
11646 struct remote_g_packet_data *data
11647 = ((struct remote_g_packet_data *)
11648 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle));
11650 /* Do not try this during initial connection, when we do not know
11651 whether there is a running but stopped thread. */
11652 if (!target_has_execution || inferior_ptid == null_ptid)
11653 return beneath ()->read_description ();
11655 if (!data->guesses.empty ())
11657 int bytes = send_g_packet ();
11659 for (const remote_g_packet_guess &guess : data->guesses)
11660 if (guess.bytes == bytes)
11661 return guess.tdesc;
11663 /* We discard the g packet. A minor optimization would be to
11664 hold on to it, and fill the register cache once we have selected
11665 an architecture, but it's too tricky to do safely. */
11668 return beneath ()->read_description ();
11671 /* Remote file transfer support. This is host-initiated I/O, not
11672 target-initiated; for target-initiated, see remote-fileio.c. */
11674 /* If *LEFT is at least the length of STRING, copy STRING to
11675 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11676 decrease *LEFT. Otherwise raise an error. */
11679 remote_buffer_add_string (char **buffer, int *left, const char *string)
11681 int len = strlen (string);
11684 error (_("Packet too long for target."));
11686 memcpy (*buffer, string, len);
11690 /* NUL-terminate the buffer as a convenience, if there is
11696 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
11697 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11698 decrease *LEFT. Otherwise raise an error. */
11701 remote_buffer_add_bytes (char **buffer, int *left, const gdb_byte *bytes,
11704 if (2 * len > *left)
11705 error (_("Packet too long for target."));
11707 bin2hex (bytes, *buffer, len);
11708 *buffer += 2 * len;
11711 /* NUL-terminate the buffer as a convenience, if there is
11717 /* If *LEFT is large enough, convert VALUE to hex and add it to
11718 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11719 decrease *LEFT. Otherwise raise an error. */
11722 remote_buffer_add_int (char **buffer, int *left, ULONGEST value)
11724 int len = hexnumlen (value);
11727 error (_("Packet too long for target."));
11729 hexnumstr (*buffer, value);
11733 /* NUL-terminate the buffer as a convenience, if there is
11739 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
11740 value, *REMOTE_ERRNO to the remote error number or zero if none
11741 was included, and *ATTACHMENT to point to the start of the annex
11742 if any. The length of the packet isn't needed here; there may
11743 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
11745 Return 0 if the packet could be parsed, -1 if it could not. If
11746 -1 is returned, the other variables may not be initialized. */
11749 remote_hostio_parse_result (char *buffer, int *retcode,
11750 int *remote_errno, char **attachment)
11755 *attachment = NULL;
11757 if (buffer[0] != 'F')
11761 *retcode = strtol (&buffer[1], &p, 16);
11762 if (errno != 0 || p == &buffer[1])
11765 /* Check for ",errno". */
11769 *remote_errno = strtol (p + 1, &p2, 16);
11770 if (errno != 0 || p + 1 == p2)
11775 /* Check for ";attachment". If there is no attachment, the
11776 packet should end here. */
11779 *attachment = p + 1;
11782 else if (*p == '\0')
11788 /* Send a prepared I/O packet to the target and read its response.
11789 The prepared packet is in the global RS->BUF before this function
11790 is called, and the answer is there when we return.
11792 COMMAND_BYTES is the length of the request to send, which may include
11793 binary data. WHICH_PACKET is the packet configuration to check
11794 before attempting a packet. If an error occurs, *REMOTE_ERRNO
11795 is set to the error number and -1 is returned. Otherwise the value
11796 returned by the function is returned.
11798 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
11799 attachment is expected; an error will be reported if there's a
11800 mismatch. If one is found, *ATTACHMENT will be set to point into
11801 the packet buffer and *ATTACHMENT_LEN will be set to the
11802 attachment's length. */
11805 remote_target::remote_hostio_send_command (int command_bytes, int which_packet,
11806 int *remote_errno, char **attachment,
11807 int *attachment_len)
11809 struct remote_state *rs = get_remote_state ();
11810 int ret, bytes_read;
11811 char *attachment_tmp;
11813 if (packet_support (which_packet) == PACKET_DISABLE)
11815 *remote_errno = FILEIO_ENOSYS;
11819 putpkt_binary (rs->buf, command_bytes);
11820 bytes_read = getpkt_sane (&rs->buf, &rs->buf_size, 0);
11822 /* If it timed out, something is wrong. Don't try to parse the
11824 if (bytes_read < 0)
11826 *remote_errno = FILEIO_EINVAL;
11830 switch (packet_ok (rs->buf, &remote_protocol_packets[which_packet]))
11833 *remote_errno = FILEIO_EINVAL;
11835 case PACKET_UNKNOWN:
11836 *remote_errno = FILEIO_ENOSYS;
11842 if (remote_hostio_parse_result (rs->buf, &ret, remote_errno,
11845 *remote_errno = FILEIO_EINVAL;
11849 /* Make sure we saw an attachment if and only if we expected one. */
11850 if ((attachment_tmp == NULL && attachment != NULL)
11851 || (attachment_tmp != NULL && attachment == NULL))
11853 *remote_errno = FILEIO_EINVAL;
11857 /* If an attachment was found, it must point into the packet buffer;
11858 work out how many bytes there were. */
11859 if (attachment_tmp != NULL)
11861 *attachment = attachment_tmp;
11862 *attachment_len = bytes_read - (*attachment - rs->buf);
11868 /* See declaration.h. */
11871 readahead_cache::invalidate ()
11876 /* See declaration.h. */
11879 readahead_cache::invalidate_fd (int fd)
11881 if (this->fd == fd)
11885 /* Set the filesystem remote_hostio functions that take FILENAME
11886 arguments will use. Return 0 on success, or -1 if an error
11887 occurs (and set *REMOTE_ERRNO). */
11890 remote_target::remote_hostio_set_filesystem (struct inferior *inf,
11893 struct remote_state *rs = get_remote_state ();
11894 int required_pid = (inf == NULL || inf->fake_pid_p) ? 0 : inf->pid;
11896 int left = get_remote_packet_size () - 1;
11900 if (packet_support (PACKET_vFile_setfs) == PACKET_DISABLE)
11903 if (rs->fs_pid != -1 && required_pid == rs->fs_pid)
11906 remote_buffer_add_string (&p, &left, "vFile:setfs:");
11908 xsnprintf (arg, sizeof (arg), "%x", required_pid);
11909 remote_buffer_add_string (&p, &left, arg);
11911 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_setfs,
11912 remote_errno, NULL, NULL);
11914 if (packet_support (PACKET_vFile_setfs) == PACKET_DISABLE)
11918 rs->fs_pid = required_pid;
11923 /* Implementation of to_fileio_open. */
11926 remote_target::remote_hostio_open (inferior *inf, const char *filename,
11927 int flags, int mode, int warn_if_slow,
11930 struct remote_state *rs = get_remote_state ();
11932 int left = get_remote_packet_size () - 1;
11936 static int warning_issued = 0;
11938 printf_unfiltered (_("Reading %s from remote target...\n"),
11941 if (!warning_issued)
11943 warning (_("File transfers from remote targets can be slow."
11944 " Use \"set sysroot\" to access files locally"
11946 warning_issued = 1;
11950 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
11953 remote_buffer_add_string (&p, &left, "vFile:open:");
11955 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
11956 strlen (filename));
11957 remote_buffer_add_string (&p, &left, ",");
11959 remote_buffer_add_int (&p, &left, flags);
11960 remote_buffer_add_string (&p, &left, ",");
11962 remote_buffer_add_int (&p, &left, mode);
11964 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_open,
11965 remote_errno, NULL, NULL);
11969 remote_target::fileio_open (struct inferior *inf, const char *filename,
11970 int flags, int mode, int warn_if_slow,
11973 return remote_hostio_open (inf, filename, flags, mode, warn_if_slow,
11977 /* Implementation of to_fileio_pwrite. */
11980 remote_target::remote_hostio_pwrite (int fd, const gdb_byte *write_buf, int len,
11981 ULONGEST offset, int *remote_errno)
11983 struct remote_state *rs = get_remote_state ();
11985 int left = get_remote_packet_size ();
11988 rs->readahead_cache.invalidate_fd (fd);
11990 remote_buffer_add_string (&p, &left, "vFile:pwrite:");
11992 remote_buffer_add_int (&p, &left, fd);
11993 remote_buffer_add_string (&p, &left, ",");
11995 remote_buffer_add_int (&p, &left, offset);
11996 remote_buffer_add_string (&p, &left, ",");
11998 p += remote_escape_output (write_buf, len, 1, (gdb_byte *) p, &out_len,
11999 get_remote_packet_size () - (p - rs->buf));
12001 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_pwrite,
12002 remote_errno, NULL, NULL);
12006 remote_target::fileio_pwrite (int fd, const gdb_byte *write_buf, int len,
12007 ULONGEST offset, int *remote_errno)
12009 return remote_hostio_pwrite (fd, write_buf, len, offset, remote_errno);
12012 /* Helper for the implementation of to_fileio_pread. Read the file
12013 from the remote side with vFile:pread. */
12016 remote_target::remote_hostio_pread_vFile (int fd, gdb_byte *read_buf, int len,
12017 ULONGEST offset, int *remote_errno)
12019 struct remote_state *rs = get_remote_state ();
12022 int left = get_remote_packet_size ();
12023 int ret, attachment_len;
12026 remote_buffer_add_string (&p, &left, "vFile:pread:");
12028 remote_buffer_add_int (&p, &left, fd);
12029 remote_buffer_add_string (&p, &left, ",");
12031 remote_buffer_add_int (&p, &left, len);
12032 remote_buffer_add_string (&p, &left, ",");
12034 remote_buffer_add_int (&p, &left, offset);
12036 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_pread,
12037 remote_errno, &attachment,
12043 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
12045 if (read_len != ret)
12046 error (_("Read returned %d, but %d bytes."), ret, (int) read_len);
12051 /* See declaration.h. */
12054 readahead_cache::pread (int fd, gdb_byte *read_buf, size_t len,
12058 && this->offset <= offset
12059 && offset < this->offset + this->bufsize)
12061 ULONGEST max = this->offset + this->bufsize;
12063 if (offset + len > max)
12064 len = max - offset;
12066 memcpy (read_buf, this->buf + offset - this->offset, len);
12073 /* Implementation of to_fileio_pread. */
12076 remote_target::remote_hostio_pread (int fd, gdb_byte *read_buf, int len,
12077 ULONGEST offset, int *remote_errno)
12080 struct remote_state *rs = get_remote_state ();
12081 readahead_cache *cache = &rs->readahead_cache;
12083 ret = cache->pread (fd, read_buf, len, offset);
12086 cache->hit_count++;
12089 fprintf_unfiltered (gdb_stdlog, "readahead cache hit %s\n",
12090 pulongest (cache->hit_count));
12094 cache->miss_count++;
12096 fprintf_unfiltered (gdb_stdlog, "readahead cache miss %s\n",
12097 pulongest (cache->miss_count));
12100 cache->offset = offset;
12101 cache->bufsize = get_remote_packet_size ();
12102 cache->buf = (gdb_byte *) xrealloc (cache->buf, cache->bufsize);
12104 ret = remote_hostio_pread_vFile (cache->fd, cache->buf, cache->bufsize,
12105 cache->offset, remote_errno);
12108 cache->invalidate_fd (fd);
12112 cache->bufsize = ret;
12113 return cache->pread (fd, read_buf, len, offset);
12117 remote_target::fileio_pread (int fd, gdb_byte *read_buf, int len,
12118 ULONGEST offset, int *remote_errno)
12120 return remote_hostio_pread (fd, read_buf, len, offset, remote_errno);
12123 /* Implementation of to_fileio_close. */
12126 remote_target::remote_hostio_close (int fd, int *remote_errno)
12128 struct remote_state *rs = get_remote_state ();
12130 int left = get_remote_packet_size () - 1;
12132 rs->readahead_cache.invalidate_fd (fd);
12134 remote_buffer_add_string (&p, &left, "vFile:close:");
12136 remote_buffer_add_int (&p, &left, fd);
12138 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_close,
12139 remote_errno, NULL, NULL);
12143 remote_target::fileio_close (int fd, int *remote_errno)
12145 return remote_hostio_close (fd, remote_errno);
12148 /* Implementation of to_fileio_unlink. */
12151 remote_target::remote_hostio_unlink (inferior *inf, const char *filename,
12154 struct remote_state *rs = get_remote_state ();
12156 int left = get_remote_packet_size () - 1;
12158 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
12161 remote_buffer_add_string (&p, &left, "vFile:unlink:");
12163 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
12164 strlen (filename));
12166 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_unlink,
12167 remote_errno, NULL, NULL);
12171 remote_target::fileio_unlink (struct inferior *inf, const char *filename,
12174 return remote_hostio_unlink (inf, filename, remote_errno);
12177 /* Implementation of to_fileio_readlink. */
12179 gdb::optional<std::string>
12180 remote_target::fileio_readlink (struct inferior *inf, const char *filename,
12183 struct remote_state *rs = get_remote_state ();
12186 int left = get_remote_packet_size ();
12187 int len, attachment_len;
12190 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
12193 remote_buffer_add_string (&p, &left, "vFile:readlink:");
12195 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
12196 strlen (filename));
12198 len = remote_hostio_send_command (p - rs->buf, PACKET_vFile_readlink,
12199 remote_errno, &attachment,
12205 std::string ret (len, '\0');
12207 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
12208 (gdb_byte *) &ret[0], len);
12209 if (read_len != len)
12210 error (_("Readlink returned %d, but %d bytes."), len, read_len);
12215 /* Implementation of to_fileio_fstat. */
12218 remote_target::fileio_fstat (int fd, struct stat *st, int *remote_errno)
12220 struct remote_state *rs = get_remote_state ();
12222 int left = get_remote_packet_size ();
12223 int attachment_len, ret;
12225 struct fio_stat fst;
12228 remote_buffer_add_string (&p, &left, "vFile:fstat:");
12230 remote_buffer_add_int (&p, &left, fd);
12232 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_fstat,
12233 remote_errno, &attachment,
12237 if (*remote_errno != FILEIO_ENOSYS)
12240 /* Strictly we should return -1, ENOSYS here, but when
12241 "set sysroot remote:" was implemented in August 2008
12242 BFD's need for a stat function was sidestepped with
12243 this hack. This was not remedied until March 2015
12244 so we retain the previous behavior to avoid breaking
12247 Note that the memset is a March 2015 addition; older
12248 GDBs set st_size *and nothing else* so the structure
12249 would have garbage in all other fields. This might
12250 break something but retaining the previous behavior
12251 here would be just too wrong. */
12253 memset (st, 0, sizeof (struct stat));
12254 st->st_size = INT_MAX;
12258 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
12259 (gdb_byte *) &fst, sizeof (fst));
12261 if (read_len != ret)
12262 error (_("vFile:fstat returned %d, but %d bytes."), ret, read_len);
12264 if (read_len != sizeof (fst))
12265 error (_("vFile:fstat returned %d bytes, but expecting %d."),
12266 read_len, (int) sizeof (fst));
12268 remote_fileio_to_host_stat (&fst, st);
12273 /* Implementation of to_filesystem_is_local. */
12276 remote_target::filesystem_is_local ()
12278 /* Valgrind GDB presents itself as a remote target but works
12279 on the local filesystem: it does not implement remote get
12280 and users are not expected to set a sysroot. To handle
12281 this case we treat the remote filesystem as local if the
12282 sysroot is exactly TARGET_SYSROOT_PREFIX and if the stub
12283 does not support vFile:open. */
12284 if (strcmp (gdb_sysroot, TARGET_SYSROOT_PREFIX) == 0)
12286 enum packet_support ps = packet_support (PACKET_vFile_open);
12288 if (ps == PACKET_SUPPORT_UNKNOWN)
12290 int fd, remote_errno;
12292 /* Try opening a file to probe support. The supplied
12293 filename is irrelevant, we only care about whether
12294 the stub recognizes the packet or not. */
12295 fd = remote_hostio_open (NULL, "just probing",
12296 FILEIO_O_RDONLY, 0700, 0,
12300 remote_hostio_close (fd, &remote_errno);
12302 ps = packet_support (PACKET_vFile_open);
12305 if (ps == PACKET_DISABLE)
12307 static int warning_issued = 0;
12309 if (!warning_issued)
12311 warning (_("remote target does not support file"
12312 " transfer, attempting to access files"
12313 " from local filesystem."));
12314 warning_issued = 1;
12325 remote_fileio_errno_to_host (int errnum)
12331 case FILEIO_ENOENT:
12339 case FILEIO_EACCES:
12341 case FILEIO_EFAULT:
12345 case FILEIO_EEXIST:
12347 case FILEIO_ENODEV:
12349 case FILEIO_ENOTDIR:
12351 case FILEIO_EISDIR:
12353 case FILEIO_EINVAL:
12355 case FILEIO_ENFILE:
12357 case FILEIO_EMFILE:
12361 case FILEIO_ENOSPC:
12363 case FILEIO_ESPIPE:
12367 case FILEIO_ENOSYS:
12369 case FILEIO_ENAMETOOLONG:
12370 return ENAMETOOLONG;
12376 remote_hostio_error (int errnum)
12378 int host_error = remote_fileio_errno_to_host (errnum);
12380 if (host_error == -1)
12381 error (_("Unknown remote I/O error %d"), errnum);
12383 error (_("Remote I/O error: %s"), safe_strerror (host_error));
12386 /* A RAII wrapper around a remote file descriptor. */
12388 class scoped_remote_fd
12391 scoped_remote_fd (remote_target *remote, int fd)
12392 : m_remote (remote), m_fd (fd)
12396 ~scoped_remote_fd ()
12403 m_remote->remote_hostio_close (m_fd, &remote_errno);
12407 /* Swallow exception before it escapes the dtor. If
12408 something goes wrong, likely the connection is gone,
12409 and there's nothing else that can be done. */
12414 DISABLE_COPY_AND_ASSIGN (scoped_remote_fd);
12416 /* Release ownership of the file descriptor, and return it. */
12417 int release () noexcept
12424 /* Return the owned file descriptor. */
12425 int get () const noexcept
12431 /* The remote target. */
12432 remote_target *m_remote;
12434 /* The owned remote I/O file descriptor. */
12439 remote_file_put (const char *local_file, const char *remote_file, int from_tty)
12441 remote_target *remote = get_current_remote_target ();
12443 if (remote == nullptr)
12444 error (_("command can only be used with remote target"));
12446 remote->remote_file_put (local_file, remote_file, from_tty);
12450 remote_target::remote_file_put (const char *local_file, const char *remote_file,
12453 int retcode, remote_errno, bytes, io_size;
12454 int bytes_in_buffer;
12458 gdb_file_up file = gdb_fopen_cloexec (local_file, "rb");
12460 perror_with_name (local_file);
12462 scoped_remote_fd fd
12463 (this, remote_hostio_open (NULL,
12464 remote_file, (FILEIO_O_WRONLY | FILEIO_O_CREAT
12466 0700, 0, &remote_errno));
12467 if (fd.get () == -1)
12468 remote_hostio_error (remote_errno);
12470 /* Send up to this many bytes at once. They won't all fit in the
12471 remote packet limit, so we'll transfer slightly fewer. */
12472 io_size = get_remote_packet_size ();
12473 gdb::byte_vector buffer (io_size);
12475 bytes_in_buffer = 0;
12478 while (bytes_in_buffer || !saw_eof)
12482 bytes = fread (buffer.data () + bytes_in_buffer, 1,
12483 io_size - bytes_in_buffer,
12487 if (ferror (file.get ()))
12488 error (_("Error reading %s."), local_file);
12491 /* EOF. Unless there is something still in the
12492 buffer from the last iteration, we are done. */
12494 if (bytes_in_buffer == 0)
12502 bytes += bytes_in_buffer;
12503 bytes_in_buffer = 0;
12505 retcode = remote_hostio_pwrite (fd.get (), buffer.data (), bytes,
12506 offset, &remote_errno);
12509 remote_hostio_error (remote_errno);
12510 else if (retcode == 0)
12511 error (_("Remote write of %d bytes returned 0!"), bytes);
12512 else if (retcode < bytes)
12514 /* Short write. Save the rest of the read data for the next
12516 bytes_in_buffer = bytes - retcode;
12517 memmove (buffer.data (), buffer.data () + retcode, bytes_in_buffer);
12523 if (remote_hostio_close (fd.release (), &remote_errno))
12524 remote_hostio_error (remote_errno);
12527 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file);
12531 remote_file_get (const char *remote_file, const char *local_file, int from_tty)
12533 remote_target *remote = get_current_remote_target ();
12535 if (remote == nullptr)
12536 error (_("command can only be used with remote target"));
12538 remote->remote_file_get (remote_file, local_file, from_tty);
12542 remote_target::remote_file_get (const char *remote_file, const char *local_file,
12545 int remote_errno, bytes, io_size;
12548 scoped_remote_fd fd
12549 (this, remote_hostio_open (NULL,
12550 remote_file, FILEIO_O_RDONLY, 0, 0,
12552 if (fd.get () == -1)
12553 remote_hostio_error (remote_errno);
12555 gdb_file_up file = gdb_fopen_cloexec (local_file, "wb");
12557 perror_with_name (local_file);
12559 /* Send up to this many bytes at once. They won't all fit in the
12560 remote packet limit, so we'll transfer slightly fewer. */
12561 io_size = get_remote_packet_size ();
12562 gdb::byte_vector buffer (io_size);
12567 bytes = remote_hostio_pread (fd.get (), buffer.data (), io_size, offset,
12570 /* Success, but no bytes, means end-of-file. */
12573 remote_hostio_error (remote_errno);
12577 bytes = fwrite (buffer.data (), 1, bytes, file.get ());
12579 perror_with_name (local_file);
12582 if (remote_hostio_close (fd.release (), &remote_errno))
12583 remote_hostio_error (remote_errno);
12586 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file);
12590 remote_file_delete (const char *remote_file, int from_tty)
12592 remote_target *remote = get_current_remote_target ();
12594 if (remote == nullptr)
12595 error (_("command can only be used with remote target"));
12597 remote->remote_file_delete (remote_file, from_tty);
12601 remote_target::remote_file_delete (const char *remote_file, int from_tty)
12603 int retcode, remote_errno;
12605 retcode = remote_hostio_unlink (NULL, remote_file, &remote_errno);
12607 remote_hostio_error (remote_errno);
12610 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file);
12614 remote_put_command (const char *args, int from_tty)
12617 error_no_arg (_("file to put"));
12619 gdb_argv argv (args);
12620 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
12621 error (_("Invalid parameters to remote put"));
12623 remote_file_put (argv[0], argv[1], from_tty);
12627 remote_get_command (const char *args, int from_tty)
12630 error_no_arg (_("file to get"));
12632 gdb_argv argv (args);
12633 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
12634 error (_("Invalid parameters to remote get"));
12636 remote_file_get (argv[0], argv[1], from_tty);
12640 remote_delete_command (const char *args, int from_tty)
12643 error_no_arg (_("file to delete"));
12645 gdb_argv argv (args);
12646 if (argv[0] == NULL || argv[1] != NULL)
12647 error (_("Invalid parameters to remote delete"));
12649 remote_file_delete (argv[0], from_tty);
12653 remote_command (const char *args, int from_tty)
12655 help_list (remote_cmdlist, "remote ", all_commands, gdb_stdout);
12659 remote_target::can_execute_reverse ()
12661 if (packet_support (PACKET_bs) == PACKET_ENABLE
12662 || packet_support (PACKET_bc) == PACKET_ENABLE)
12669 remote_target::supports_non_stop ()
12675 remote_target::supports_disable_randomization ()
12677 /* Only supported in extended mode. */
12682 remote_target::supports_multi_process ()
12684 struct remote_state *rs = get_remote_state ();
12686 return remote_multi_process_p (rs);
12690 remote_supports_cond_tracepoints ()
12692 return packet_support (PACKET_ConditionalTracepoints) == PACKET_ENABLE;
12696 remote_target::supports_evaluation_of_breakpoint_conditions ()
12698 return packet_support (PACKET_ConditionalBreakpoints) == PACKET_ENABLE;
12702 remote_supports_fast_tracepoints ()
12704 return packet_support (PACKET_FastTracepoints) == PACKET_ENABLE;
12708 remote_supports_static_tracepoints ()
12710 return packet_support (PACKET_StaticTracepoints) == PACKET_ENABLE;
12714 remote_supports_install_in_trace ()
12716 return packet_support (PACKET_InstallInTrace) == PACKET_ENABLE;
12720 remote_target::supports_enable_disable_tracepoint ()
12722 return (packet_support (PACKET_EnableDisableTracepoints_feature)
12727 remote_target::supports_string_tracing ()
12729 return packet_support (PACKET_tracenz_feature) == PACKET_ENABLE;
12733 remote_target::can_run_breakpoint_commands ()
12735 return packet_support (PACKET_BreakpointCommands) == PACKET_ENABLE;
12739 remote_target::trace_init ()
12741 struct remote_state *rs = get_remote_state ();
12744 remote_get_noisy_reply ();
12745 if (strcmp (rs->buf, "OK") != 0)
12746 error (_("Target does not support this command."));
12749 /* Recursive routine to walk through command list including loops, and
12750 download packets for each command. */
12753 remote_target::remote_download_command_source (int num, ULONGEST addr,
12754 struct command_line *cmds)
12756 struct remote_state *rs = get_remote_state ();
12757 struct command_line *cmd;
12759 for (cmd = cmds; cmd; cmd = cmd->next)
12761 QUIT; /* Allow user to bail out with ^C. */
12762 strcpy (rs->buf, "QTDPsrc:");
12763 encode_source_string (num, addr, "cmd", cmd->line,
12764 rs->buf + strlen (rs->buf),
12765 rs->buf_size - strlen (rs->buf));
12767 remote_get_noisy_reply ();
12768 if (strcmp (rs->buf, "OK"))
12769 warning (_("Target does not support source download."));
12771 if (cmd->control_type == while_control
12772 || cmd->control_type == while_stepping_control)
12774 remote_download_command_source (num, addr, cmd->body_list_0.get ());
12776 QUIT; /* Allow user to bail out with ^C. */
12777 strcpy (rs->buf, "QTDPsrc:");
12778 encode_source_string (num, addr, "cmd", "end",
12779 rs->buf + strlen (rs->buf),
12780 rs->buf_size - strlen (rs->buf));
12782 remote_get_noisy_reply ();
12783 if (strcmp (rs->buf, "OK"))
12784 warning (_("Target does not support source download."));
12790 remote_target::download_tracepoint (struct bp_location *loc)
12794 std::vector<std::string> tdp_actions;
12795 std::vector<std::string> stepping_actions;
12797 struct breakpoint *b = loc->owner;
12798 struct tracepoint *t = (struct tracepoint *) b;
12799 struct remote_state *rs = get_remote_state ();
12801 const char *err_msg = _("Tracepoint packet too large for target.");
12804 /* We use a buffer other than rs->buf because we'll build strings
12805 across multiple statements, and other statements in between could
12807 gdb::char_vector buf (get_remote_packet_size ());
12809 encode_actions_rsp (loc, &tdp_actions, &stepping_actions);
12811 tpaddr = loc->address;
12812 sprintf_vma (addrbuf, tpaddr);
12813 ret = snprintf (buf.data (), buf.size (), "QTDP:%x:%s:%c:%lx:%x",
12814 b->number, addrbuf, /* address */
12815 (b->enable_state == bp_enabled ? 'E' : 'D'),
12816 t->step_count, t->pass_count);
12818 if (ret < 0 || ret >= buf.size ())
12819 error ("%s", err_msg);
12821 /* Fast tracepoints are mostly handled by the target, but we can
12822 tell the target how big of an instruction block should be moved
12824 if (b->type == bp_fast_tracepoint)
12826 /* Only test for support at download time; we may not know
12827 target capabilities at definition time. */
12828 if (remote_supports_fast_tracepoints ())
12830 if (gdbarch_fast_tracepoint_valid_at (loc->gdbarch, tpaddr,
12833 size_left = buf.size () - strlen (buf.data ());
12834 ret = snprintf (buf.data () + strlen (buf.data ()),
12836 gdb_insn_length (loc->gdbarch, tpaddr));
12838 if (ret < 0 || ret >= size_left)
12839 error ("%s", err_msg);
12842 /* If it passed validation at definition but fails now,
12843 something is very wrong. */
12844 internal_error (__FILE__, __LINE__,
12845 _("Fast tracepoint not "
12846 "valid during download"));
12849 /* Fast tracepoints are functionally identical to regular
12850 tracepoints, so don't take lack of support as a reason to
12851 give up on the trace run. */
12852 warning (_("Target does not support fast tracepoints, "
12853 "downloading %d as regular tracepoint"), b->number);
12855 else if (b->type == bp_static_tracepoint)
12857 /* Only test for support at download time; we may not know
12858 target capabilities at definition time. */
12859 if (remote_supports_static_tracepoints ())
12861 struct static_tracepoint_marker marker;
12863 if (target_static_tracepoint_marker_at (tpaddr, &marker))
12865 size_left = buf.size () - strlen (buf.data ());
12866 ret = snprintf (buf.data () + strlen (buf.data ()),
12869 if (ret < 0 || ret >= size_left)
12870 error ("%s", err_msg);
12873 error (_("Static tracepoint not valid during download"));
12876 /* Fast tracepoints are functionally identical to regular
12877 tracepoints, so don't take lack of support as a reason
12878 to give up on the trace run. */
12879 error (_("Target does not support static tracepoints"));
12881 /* If the tracepoint has a conditional, make it into an agent
12882 expression and append to the definition. */
12885 /* Only test support at download time, we may not know target
12886 capabilities at definition time. */
12887 if (remote_supports_cond_tracepoints ())
12889 agent_expr_up aexpr = gen_eval_for_expr (tpaddr,
12892 size_left = buf.size () - strlen (buf.data ());
12894 ret = snprintf (buf.data () + strlen (buf.data ()),
12895 size_left, ":X%x,", aexpr->len);
12897 if (ret < 0 || ret >= size_left)
12898 error ("%s", err_msg);
12900 size_left = buf.size () - strlen (buf.data ());
12902 /* Two bytes to encode each aexpr byte, plus the terminating
12904 if (aexpr->len * 2 + 1 > size_left)
12905 error ("%s", err_msg);
12907 pkt = buf.data () + strlen (buf.data ());
12909 for (int ndx = 0; ndx < aexpr->len; ++ndx)
12910 pkt = pack_hex_byte (pkt, aexpr->buf[ndx]);
12914 warning (_("Target does not support conditional tracepoints, "
12915 "ignoring tp %d cond"), b->number);
12918 if (b->commands || *default_collect)
12920 size_left = buf.size () - strlen (buf.data ());
12922 ret = snprintf (buf.data () + strlen (buf.data ()),
12925 if (ret < 0 || ret >= size_left)
12926 error ("%s", err_msg);
12929 putpkt (buf.data ());
12930 remote_get_noisy_reply ();
12931 if (strcmp (rs->buf, "OK"))
12932 error (_("Target does not support tracepoints."));
12934 /* do_single_steps (t); */
12935 for (auto action_it = tdp_actions.begin ();
12936 action_it != tdp_actions.end (); action_it++)
12938 QUIT; /* Allow user to bail out with ^C. */
12940 bool has_more = ((action_it + 1) != tdp_actions.end ()
12941 || !stepping_actions.empty ());
12943 ret = snprintf (buf.data (), buf.size (), "QTDP:-%x:%s:%s%c",
12944 b->number, addrbuf, /* address */
12945 action_it->c_str (),
12946 has_more ? '-' : 0);
12948 if (ret < 0 || ret >= buf.size ())
12949 error ("%s", err_msg);
12951 putpkt (buf.data ());
12952 remote_get_noisy_reply ();
12953 if (strcmp (rs->buf, "OK"))
12954 error (_("Error on target while setting tracepoints."));
12957 for (auto action_it = stepping_actions.begin ();
12958 action_it != stepping_actions.end (); action_it++)
12960 QUIT; /* Allow user to bail out with ^C. */
12962 bool is_first = action_it == stepping_actions.begin ();
12963 bool has_more = (action_it + 1) != stepping_actions.end ();
12965 ret = snprintf (buf.data (), buf.size (), "QTDP:-%x:%s:%s%s%s",
12966 b->number, addrbuf, /* address */
12967 is_first ? "S" : "",
12968 action_it->c_str (),
12969 has_more ? "-" : "");
12971 if (ret < 0 || ret >= buf.size ())
12972 error ("%s", err_msg);
12974 putpkt (buf.data ());
12975 remote_get_noisy_reply ();
12976 if (strcmp (rs->buf, "OK"))
12977 error (_("Error on target while setting tracepoints."));
12980 if (packet_support (PACKET_TracepointSource) == PACKET_ENABLE)
12982 if (b->location != NULL)
12984 ret = snprintf (buf.data (), buf.size (), "QTDPsrc:");
12986 if (ret < 0 || ret >= buf.size ())
12987 error ("%s", err_msg);
12989 encode_source_string (b->number, loc->address, "at",
12990 event_location_to_string (b->location.get ()),
12991 buf.data () + strlen (buf.data ()),
12992 buf.size () - strlen (buf.data ()));
12993 putpkt (buf.data ());
12994 remote_get_noisy_reply ();
12995 if (strcmp (rs->buf, "OK"))
12996 warning (_("Target does not support source download."));
12998 if (b->cond_string)
13000 ret = snprintf (buf.data (), buf.size (), "QTDPsrc:");
13002 if (ret < 0 || ret >= buf.size ())
13003 error ("%s", err_msg);
13005 encode_source_string (b->number, loc->address,
13006 "cond", b->cond_string,
13007 buf.data () + strlen (buf.data ()),
13008 buf.size () - strlen (buf.data ()));
13009 putpkt (buf.data ());
13010 remote_get_noisy_reply ();
13011 if (strcmp (rs->buf, "OK"))
13012 warning (_("Target does not support source download."));
13014 remote_download_command_source (b->number, loc->address,
13015 breakpoint_commands (b));
13020 remote_target::can_download_tracepoint ()
13022 struct remote_state *rs = get_remote_state ();
13023 struct trace_status *ts;
13026 /* Don't try to install tracepoints until we've relocated our
13027 symbols, and fetched and merged the target's tracepoint list with
13029 if (rs->starting_up)
13032 ts = current_trace_status ();
13033 status = get_trace_status (ts);
13035 if (status == -1 || !ts->running_known || !ts->running)
13038 /* If we are in a tracing experiment, but remote stub doesn't support
13039 installing tracepoint in trace, we have to return. */
13040 if (!remote_supports_install_in_trace ())
13048 remote_target::download_trace_state_variable (const trace_state_variable &tsv)
13050 struct remote_state *rs = get_remote_state ();
13053 xsnprintf (rs->buf, get_remote_packet_size (), "QTDV:%x:%s:%x:",
13054 tsv.number, phex ((ULONGEST) tsv.initial_value, 8),
13056 p = rs->buf + strlen (rs->buf);
13057 if ((p - rs->buf) + tsv.name.length () * 2 >= get_remote_packet_size ())
13058 error (_("Trace state variable name too long for tsv definition packet"));
13059 p += 2 * bin2hex ((gdb_byte *) (tsv.name.data ()), p, tsv.name.length ());
13062 remote_get_noisy_reply ();
13063 if (*rs->buf == '\0')
13064 error (_("Target does not support this command."));
13065 if (strcmp (rs->buf, "OK") != 0)
13066 error (_("Error on target while downloading trace state variable."));
13070 remote_target::enable_tracepoint (struct bp_location *location)
13072 struct remote_state *rs = get_remote_state ();
13075 sprintf_vma (addr_buf, location->address);
13076 xsnprintf (rs->buf, get_remote_packet_size (), "QTEnable:%x:%s",
13077 location->owner->number, addr_buf);
13079 remote_get_noisy_reply ();
13080 if (*rs->buf == '\0')
13081 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
13082 if (strcmp (rs->buf, "OK") != 0)
13083 error (_("Error on target while enabling tracepoint."));
13087 remote_target::disable_tracepoint (struct bp_location *location)
13089 struct remote_state *rs = get_remote_state ();
13092 sprintf_vma (addr_buf, location->address);
13093 xsnprintf (rs->buf, get_remote_packet_size (), "QTDisable:%x:%s",
13094 location->owner->number, addr_buf);
13096 remote_get_noisy_reply ();
13097 if (*rs->buf == '\0')
13098 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
13099 if (strcmp (rs->buf, "OK") != 0)
13100 error (_("Error on target while disabling tracepoint."));
13104 remote_target::trace_set_readonly_regions ()
13108 bfd_size_type size;
13114 return; /* No information to give. */
13116 struct remote_state *rs = get_remote_state ();
13118 strcpy (rs->buf, "QTro");
13119 offset = strlen (rs->buf);
13120 for (s = exec_bfd->sections; s; s = s->next)
13122 char tmp1[40], tmp2[40];
13125 if ((s->flags & SEC_LOAD) == 0 ||
13126 /* (s->flags & SEC_CODE) == 0 || */
13127 (s->flags & SEC_READONLY) == 0)
13131 vma = bfd_get_section_vma (abfd, s);
13132 size = bfd_get_section_size (s);
13133 sprintf_vma (tmp1, vma);
13134 sprintf_vma (tmp2, vma + size);
13135 sec_length = 1 + strlen (tmp1) + 1 + strlen (tmp2);
13136 if (offset + sec_length + 1 > rs->buf_size)
13138 if (packet_support (PACKET_qXfer_traceframe_info) != PACKET_ENABLE)
13140 Too many sections for read-only sections definition packet."));
13143 xsnprintf (rs->buf + offset, rs->buf_size - offset, ":%s,%s",
13145 offset += sec_length;
13150 getpkt (&rs->buf, &rs->buf_size, 0);
13155 remote_target::trace_start ()
13157 struct remote_state *rs = get_remote_state ();
13159 putpkt ("QTStart");
13160 remote_get_noisy_reply ();
13161 if (*rs->buf == '\0')
13162 error (_("Target does not support this command."));
13163 if (strcmp (rs->buf, "OK") != 0)
13164 error (_("Bogus reply from target: %s"), rs->buf);
13168 remote_target::get_trace_status (struct trace_status *ts)
13170 /* Initialize it just to avoid a GCC false warning. */
13172 /* FIXME we need to get register block size some other way. */
13173 extern int trace_regblock_size;
13174 enum packet_result result;
13175 struct remote_state *rs = get_remote_state ();
13177 if (packet_support (PACKET_qTStatus) == PACKET_DISABLE)
13180 trace_regblock_size
13181 = rs->get_remote_arch_state (target_gdbarch ())->sizeof_g_packet;
13183 putpkt ("qTStatus");
13187 p = remote_get_noisy_reply ();
13189 CATCH (ex, RETURN_MASK_ERROR)
13191 if (ex.error != TARGET_CLOSE_ERROR)
13193 exception_fprintf (gdb_stderr, ex, "qTStatus: ");
13196 throw_exception (ex);
13200 result = packet_ok (p, &remote_protocol_packets[PACKET_qTStatus]);
13202 /* If the remote target doesn't do tracing, flag it. */
13203 if (result == PACKET_UNKNOWN)
13206 /* We're working with a live target. */
13207 ts->filename = NULL;
13210 error (_("Bogus trace status reply from target: %s"), rs->buf);
13212 /* Function 'parse_trace_status' sets default value of each field of
13213 'ts' at first, so we don't have to do it here. */
13214 parse_trace_status (p, ts);
13216 return ts->running;
13220 remote_target::get_tracepoint_status (struct breakpoint *bp,
13221 struct uploaded_tp *utp)
13223 struct remote_state *rs = get_remote_state ();
13225 struct bp_location *loc;
13226 struct tracepoint *tp = (struct tracepoint *) bp;
13227 size_t size = get_remote_packet_size ();
13232 tp->traceframe_usage = 0;
13233 for (loc = tp->loc; loc; loc = loc->next)
13235 /* If the tracepoint was never downloaded, don't go asking for
13237 if (tp->number_on_target == 0)
13239 xsnprintf (rs->buf, size, "qTP:%x:%s", tp->number_on_target,
13240 phex_nz (loc->address, 0));
13242 reply = remote_get_noisy_reply ();
13243 if (reply && *reply)
13246 parse_tracepoint_status (reply + 1, bp, utp);
13252 utp->hit_count = 0;
13253 utp->traceframe_usage = 0;
13254 xsnprintf (rs->buf, size, "qTP:%x:%s", utp->number,
13255 phex_nz (utp->addr, 0));
13257 reply = remote_get_noisy_reply ();
13258 if (reply && *reply)
13261 parse_tracepoint_status (reply + 1, bp, utp);
13267 remote_target::trace_stop ()
13269 struct remote_state *rs = get_remote_state ();
13272 remote_get_noisy_reply ();
13273 if (*rs->buf == '\0')
13274 error (_("Target does not support this command."));
13275 if (strcmp (rs->buf, "OK") != 0)
13276 error (_("Bogus reply from target: %s"), rs->buf);
13280 remote_target::trace_find (enum trace_find_type type, int num,
13281 CORE_ADDR addr1, CORE_ADDR addr2,
13284 struct remote_state *rs = get_remote_state ();
13285 char *endbuf = rs->buf + get_remote_packet_size ();
13287 int target_frameno = -1, target_tracept = -1;
13289 /* Lookups other than by absolute frame number depend on the current
13290 trace selected, so make sure it is correct on the remote end
13292 if (type != tfind_number)
13293 set_remote_traceframe ();
13296 strcpy (p, "QTFrame:");
13297 p = strchr (p, '\0');
13301 xsnprintf (p, endbuf - p, "%x", num);
13304 xsnprintf (p, endbuf - p, "pc:%s", phex_nz (addr1, 0));
13307 xsnprintf (p, endbuf - p, "tdp:%x", num);
13310 xsnprintf (p, endbuf - p, "range:%s:%s", phex_nz (addr1, 0),
13311 phex_nz (addr2, 0));
13313 case tfind_outside:
13314 xsnprintf (p, endbuf - p, "outside:%s:%s", phex_nz (addr1, 0),
13315 phex_nz (addr2, 0));
13318 error (_("Unknown trace find type %d"), type);
13322 reply = remote_get_noisy_reply ();
13323 if (*reply == '\0')
13324 error (_("Target does not support this command."));
13326 while (reply && *reply)
13331 target_frameno = (int) strtol (p, &reply, 16);
13333 error (_("Unable to parse trace frame number"));
13334 /* Don't update our remote traceframe number cache on failure
13335 to select a remote traceframe. */
13336 if (target_frameno == -1)
13341 target_tracept = (int) strtol (p, &reply, 16);
13343 error (_("Unable to parse tracepoint number"));
13345 case 'O': /* "OK"? */
13346 if (reply[1] == 'K' && reply[2] == '\0')
13349 error (_("Bogus reply from target: %s"), reply);
13352 error (_("Bogus reply from target: %s"), reply);
13355 *tpp = target_tracept;
13357 rs->remote_traceframe_number = target_frameno;
13358 return target_frameno;
13362 remote_target::get_trace_state_variable_value (int tsvnum, LONGEST *val)
13364 struct remote_state *rs = get_remote_state ();
13368 set_remote_traceframe ();
13370 xsnprintf (rs->buf, get_remote_packet_size (), "qTV:%x", tsvnum);
13372 reply = remote_get_noisy_reply ();
13373 if (reply && *reply)
13377 unpack_varlen_hex (reply + 1, &uval);
13378 *val = (LONGEST) uval;
13386 remote_target::save_trace_data (const char *filename)
13388 struct remote_state *rs = get_remote_state ();
13392 strcpy (p, "QTSave:");
13394 if ((p - rs->buf) + strlen (filename) * 2 >= get_remote_packet_size ())
13395 error (_("Remote file name too long for trace save packet"));
13396 p += 2 * bin2hex ((gdb_byte *) filename, p, strlen (filename));
13399 reply = remote_get_noisy_reply ();
13400 if (*reply == '\0')
13401 error (_("Target does not support this command."));
13402 if (strcmp (reply, "OK") != 0)
13403 error (_("Bogus reply from target: %s"), reply);
13407 /* This is basically a memory transfer, but needs to be its own packet
13408 because we don't know how the target actually organizes its trace
13409 memory, plus we want to be able to ask for as much as possible, but
13410 not be unhappy if we don't get as much as we ask for. */
13413 remote_target::get_raw_trace_data (gdb_byte *buf, ULONGEST offset, LONGEST len)
13415 struct remote_state *rs = get_remote_state ();
13421 strcpy (p, "qTBuffer:");
13423 p += hexnumstr (p, offset);
13425 p += hexnumstr (p, len);
13429 reply = remote_get_noisy_reply ();
13430 if (reply && *reply)
13432 /* 'l' by itself means we're at the end of the buffer and
13433 there is nothing more to get. */
13437 /* Convert the reply into binary. Limit the number of bytes to
13438 convert according to our passed-in buffer size, rather than
13439 what was returned in the packet; if the target is
13440 unexpectedly generous and gives us a bigger reply than we
13441 asked for, we don't want to crash. */
13442 rslt = hex2bin (reply, buf, len);
13446 /* Something went wrong, flag as an error. */
13451 remote_target::set_disconnected_tracing (int val)
13453 struct remote_state *rs = get_remote_state ();
13455 if (packet_support (PACKET_DisconnectedTracing_feature) == PACKET_ENABLE)
13459 xsnprintf (rs->buf, get_remote_packet_size (), "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, get_remote_packet_size (), "QTBuffer:circular:%x", val);
13490 reply = remote_get_noisy_reply ();
13491 if (*reply == '\0')
13492 error (_("Target does not support this command."));
13493 if (strcmp (reply, "OK") != 0)
13494 error (_("Bogus reply from target: %s"), reply);
13498 remote_target::traceframe_info ()
13500 gdb::optional<gdb::char_vector> text
13501 = target_read_stralloc (current_top_target (), TARGET_OBJECT_TRACEFRAME_INFO,
13504 return parse_traceframe_info (text->data ());
13509 /* Handle the qTMinFTPILen packet. Returns the minimum length of
13510 instruction on which a fast tracepoint may be placed. Returns -1
13511 if the packet is not supported, and 0 if the minimum instruction
13512 length is unknown. */
13515 remote_target::get_min_fast_tracepoint_insn_len ()
13517 struct remote_state *rs = get_remote_state ();
13520 /* If we're not debugging a process yet, the IPA can't be
13522 if (!target_has_execution)
13525 /* Make sure the remote is pointing at the right process. */
13526 set_general_process ();
13528 xsnprintf (rs->buf, get_remote_packet_size (), "qTMinFTPILen");
13530 reply = remote_get_noisy_reply ();
13531 if (*reply == '\0')
13535 ULONGEST min_insn_len;
13537 unpack_varlen_hex (reply, &min_insn_len);
13539 return (int) min_insn_len;
13544 remote_target::set_trace_buffer_size (LONGEST val)
13546 if (packet_support (PACKET_QTBuffer_size) != PACKET_DISABLE)
13548 struct remote_state *rs = get_remote_state ();
13549 char *buf = rs->buf;
13550 char *endbuf = rs->buf + get_remote_packet_size ();
13551 enum packet_result result;
13553 gdb_assert (val >= 0 || val == -1);
13554 buf += xsnprintf (buf, endbuf - buf, "QTBuffer:size:");
13555 /* Send -1 as literal "-1" to avoid host size dependency. */
13559 buf += hexnumstr (buf, (ULONGEST) -val);
13562 buf += hexnumstr (buf, (ULONGEST) val);
13565 remote_get_noisy_reply ();
13566 result = packet_ok (rs->buf,
13567 &remote_protocol_packets[PACKET_QTBuffer_size]);
13569 if (result != PACKET_OK)
13570 warning (_("Bogus reply from target: %s"), rs->buf);
13575 remote_target::set_trace_notes (const char *user, const char *notes,
13576 const char *stop_notes)
13578 struct remote_state *rs = get_remote_state ();
13580 char *buf = rs->buf;
13581 char *endbuf = rs->buf + get_remote_packet_size ();
13584 buf += xsnprintf (buf, endbuf - buf, "QTNotes:");
13587 buf += xsnprintf (buf, endbuf - buf, "user:");
13588 nbytes = bin2hex ((gdb_byte *) user, buf, strlen (user));
13594 buf += xsnprintf (buf, endbuf - buf, "notes:");
13595 nbytes = bin2hex ((gdb_byte *) notes, buf, strlen (notes));
13601 buf += xsnprintf (buf, endbuf - buf, "tstop:");
13602 nbytes = bin2hex ((gdb_byte *) stop_notes, buf, strlen (stop_notes));
13606 /* Ensure the buffer is terminated. */
13610 reply = remote_get_noisy_reply ();
13611 if (*reply == '\0')
13614 if (strcmp (reply, "OK") != 0)
13615 error (_("Bogus reply from target: %s"), reply);
13621 remote_target::use_agent (bool use)
13623 if (packet_support (PACKET_QAgent) != PACKET_DISABLE)
13625 struct remote_state *rs = get_remote_state ();
13627 /* If the stub supports QAgent. */
13628 xsnprintf (rs->buf, get_remote_packet_size (), "QAgent:%d", use);
13630 getpkt (&rs->buf, &rs->buf_size, 0);
13632 if (strcmp (rs->buf, "OK") == 0)
13643 remote_target::can_use_agent ()
13645 return (packet_support (PACKET_QAgent) != PACKET_DISABLE);
13648 struct btrace_target_info
13650 /* The ptid of the traced thread. */
13653 /* The obtained branch trace configuration. */
13654 struct btrace_config conf;
13657 /* Reset our idea of our target's btrace configuration. */
13660 remote_btrace_reset (remote_state *rs)
13662 memset (&rs->btrace_config, 0, sizeof (rs->btrace_config));
13665 /* Synchronize the configuration with the target. */
13668 remote_target::btrace_sync_conf (const btrace_config *conf)
13670 struct packet_config *packet;
13671 struct remote_state *rs;
13672 char *buf, *pos, *endbuf;
13674 rs = get_remote_state ();
13676 endbuf = buf + get_remote_packet_size ();
13678 packet = &remote_protocol_packets[PACKET_Qbtrace_conf_bts_size];
13679 if (packet_config_support (packet) == PACKET_ENABLE
13680 && conf->bts.size != rs->btrace_config.bts.size)
13683 pos += xsnprintf (pos, endbuf - pos, "%s=0x%x", packet->name,
13687 getpkt (&buf, &rs->buf_size, 0);
13689 if (packet_ok (buf, packet) == PACKET_ERROR)
13691 if (buf[0] == 'E' && buf[1] == '.')
13692 error (_("Failed to configure the BTS buffer size: %s"), buf + 2);
13694 error (_("Failed to configure the BTS buffer size."));
13697 rs->btrace_config.bts.size = conf->bts.size;
13700 packet = &remote_protocol_packets[PACKET_Qbtrace_conf_pt_size];
13701 if (packet_config_support (packet) == PACKET_ENABLE
13702 && conf->pt.size != rs->btrace_config.pt.size)
13705 pos += xsnprintf (pos, endbuf - pos, "%s=0x%x", packet->name,
13709 getpkt (&buf, &rs->buf_size, 0);
13711 if (packet_ok (buf, packet) == PACKET_ERROR)
13713 if (buf[0] == 'E' && buf[1] == '.')
13714 error (_("Failed to configure the trace buffer size: %s"), buf + 2);
13716 error (_("Failed to configure the trace buffer size."));
13719 rs->btrace_config.pt.size = conf->pt.size;
13723 /* Read the current thread's btrace configuration from the target and
13724 store it into CONF. */
13727 btrace_read_config (struct btrace_config *conf)
13729 gdb::optional<gdb::char_vector> xml
13730 = target_read_stralloc (current_top_target (), TARGET_OBJECT_BTRACE_CONF, "");
13732 parse_xml_btrace_conf (conf, xml->data ());
13735 /* Maybe reopen target btrace. */
13738 remote_target::remote_btrace_maybe_reopen ()
13740 struct remote_state *rs = get_remote_state ();
13741 int btrace_target_pushed = 0;
13742 #if !defined (HAVE_LIBIPT)
13746 scoped_restore_current_thread restore_thread;
13748 for (thread_info *tp : all_non_exited_threads ())
13750 set_general_thread (tp->ptid);
13752 memset (&rs->btrace_config, 0x00, sizeof (struct btrace_config));
13753 btrace_read_config (&rs->btrace_config);
13755 if (rs->btrace_config.format == BTRACE_FORMAT_NONE)
13758 #if !defined (HAVE_LIBIPT)
13759 if (rs->btrace_config.format == BTRACE_FORMAT_PT)
13764 warning (_("Target is recording using Intel Processor Trace "
13765 "but support was disabled at compile time."));
13770 #endif /* !defined (HAVE_LIBIPT) */
13772 /* Push target, once, but before anything else happens. This way our
13773 changes to the threads will be cleaned up by unpushing the target
13774 in case btrace_read_config () throws. */
13775 if (!btrace_target_pushed)
13777 btrace_target_pushed = 1;
13778 record_btrace_push_target ();
13779 printf_filtered (_("Target is recording using %s.\n"),
13780 btrace_format_string (rs->btrace_config.format));
13783 tp->btrace.target = XCNEW (struct btrace_target_info);
13784 tp->btrace.target->ptid = tp->ptid;
13785 tp->btrace.target->conf = rs->btrace_config;
13789 /* Enable branch tracing. */
13791 struct btrace_target_info *
13792 remote_target::enable_btrace (ptid_t ptid, const struct btrace_config *conf)
13794 struct btrace_target_info *tinfo = NULL;
13795 struct packet_config *packet = NULL;
13796 struct remote_state *rs = get_remote_state ();
13797 char *buf = rs->buf;
13798 char *endbuf = rs->buf + get_remote_packet_size ();
13800 switch (conf->format)
13802 case BTRACE_FORMAT_BTS:
13803 packet = &remote_protocol_packets[PACKET_Qbtrace_bts];
13806 case BTRACE_FORMAT_PT:
13807 packet = &remote_protocol_packets[PACKET_Qbtrace_pt];
13811 if (packet == NULL || packet_config_support (packet) != PACKET_ENABLE)
13812 error (_("Target does not support branch tracing."));
13814 btrace_sync_conf (conf);
13816 set_general_thread (ptid);
13818 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
13820 getpkt (&rs->buf, &rs->buf_size, 0);
13822 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
13824 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
13825 error (_("Could not enable branch tracing for %s: %s"),
13826 target_pid_to_str (ptid), rs->buf + 2);
13828 error (_("Could not enable branch tracing for %s."),
13829 target_pid_to_str (ptid));
13832 tinfo = XCNEW (struct btrace_target_info);
13833 tinfo->ptid = ptid;
13835 /* If we fail to read the configuration, we lose some information, but the
13836 tracing itself is not impacted. */
13839 btrace_read_config (&tinfo->conf);
13841 CATCH (err, RETURN_MASK_ERROR)
13843 if (err.message != NULL)
13844 warning ("%s", err.message);
13851 /* Disable branch tracing. */
13854 remote_target::disable_btrace (struct btrace_target_info *tinfo)
13856 struct packet_config *packet = &remote_protocol_packets[PACKET_Qbtrace_off];
13857 struct remote_state *rs = get_remote_state ();
13858 char *buf = rs->buf;
13859 char *endbuf = rs->buf + get_remote_packet_size ();
13861 if (packet_config_support (packet) != PACKET_ENABLE)
13862 error (_("Target does not support branch tracing."));
13864 set_general_thread (tinfo->ptid);
13866 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
13868 getpkt (&rs->buf, &rs->buf_size, 0);
13870 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
13872 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
13873 error (_("Could not disable branch tracing for %s: %s"),
13874 target_pid_to_str (tinfo->ptid), rs->buf + 2);
13876 error (_("Could not disable branch tracing for %s."),
13877 target_pid_to_str (tinfo->ptid));
13883 /* Teardown branch tracing. */
13886 remote_target::teardown_btrace (struct btrace_target_info *tinfo)
13888 /* We must not talk to the target during teardown. */
13892 /* Read the branch trace. */
13895 remote_target::read_btrace (struct btrace_data *btrace,
13896 struct btrace_target_info *tinfo,
13897 enum btrace_read_type type)
13899 struct packet_config *packet = &remote_protocol_packets[PACKET_qXfer_btrace];
13902 if (packet_config_support (packet) != PACKET_ENABLE)
13903 error (_("Target does not support branch tracing."));
13905 #if !defined(HAVE_LIBEXPAT)
13906 error (_("Cannot process branch tracing result. XML parsing not supported."));
13911 case BTRACE_READ_ALL:
13914 case BTRACE_READ_NEW:
13917 case BTRACE_READ_DELTA:
13921 internal_error (__FILE__, __LINE__,
13922 _("Bad branch tracing read type: %u."),
13923 (unsigned int) type);
13926 gdb::optional<gdb::char_vector> xml
13927 = target_read_stralloc (current_top_target (), TARGET_OBJECT_BTRACE, annex);
13929 return BTRACE_ERR_UNKNOWN;
13931 parse_xml_btrace (btrace, xml->data ());
13933 return BTRACE_ERR_NONE;
13936 const struct btrace_config *
13937 remote_target::btrace_conf (const struct btrace_target_info *tinfo)
13939 return &tinfo->conf;
13943 remote_target::augmented_libraries_svr4_read ()
13945 return (packet_support (PACKET_augmented_libraries_svr4_read_feature)
13949 /* Implementation of to_load. */
13952 remote_target::load (const char *name, int from_tty)
13954 generic_load (name, from_tty);
13957 /* Accepts an integer PID; returns a string representing a file that
13958 can be opened on the remote side to get the symbols for the child
13959 process. Returns NULL if the operation is not supported. */
13962 remote_target::pid_to_exec_file (int pid)
13964 static gdb::optional<gdb::char_vector> filename;
13965 struct inferior *inf;
13966 char *annex = NULL;
13968 if (packet_support (PACKET_qXfer_exec_file) != PACKET_ENABLE)
13971 inf = find_inferior_pid (pid);
13973 internal_error (__FILE__, __LINE__,
13974 _("not currently attached to process %d"), pid);
13976 if (!inf->fake_pid_p)
13978 const int annex_size = 9;
13980 annex = (char *) alloca (annex_size);
13981 xsnprintf (annex, annex_size, "%x", pid);
13984 filename = target_read_stralloc (current_top_target (),
13985 TARGET_OBJECT_EXEC_FILE, annex);
13987 return filename ? filename->data () : nullptr;
13990 /* Implement the to_can_do_single_step target_ops method. */
13993 remote_target::can_do_single_step ()
13995 /* We can only tell whether target supports single step or not by
13996 supported s and S vCont actions if the stub supports vContSupported
13997 feature. If the stub doesn't support vContSupported feature,
13998 we have conservatively to think target doesn't supports single
14000 if (packet_support (PACKET_vContSupported) == PACKET_ENABLE)
14002 struct remote_state *rs = get_remote_state ();
14004 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
14005 remote_vcont_probe ();
14007 return rs->supports_vCont.s && rs->supports_vCont.S;
14013 /* Implementation of the to_execution_direction method for the remote
14016 enum exec_direction_kind
14017 remote_target::execution_direction ()
14019 struct remote_state *rs = get_remote_state ();
14021 return rs->last_resume_exec_dir;
14024 /* Return pointer to the thread_info struct which corresponds to
14025 THREAD_HANDLE (having length HANDLE_LEN). */
14028 remote_target::thread_handle_to_thread_info (const gdb_byte *thread_handle,
14032 for (thread_info *tp : all_non_exited_threads ())
14034 remote_thread_info *priv = get_remote_thread_info (tp);
14036 if (tp->inf == inf && priv != NULL)
14038 if (handle_len != priv->thread_handle.size ())
14039 error (_("Thread handle size mismatch: %d vs %zu (from remote)"),
14040 handle_len, priv->thread_handle.size ());
14041 if (memcmp (thread_handle, priv->thread_handle.data (),
14051 remote_target::can_async_p ()
14053 struct remote_state *rs = get_remote_state ();
14055 /* We don't go async if the user has explicitly prevented it with the
14056 "maint set target-async" command. */
14057 if (!target_async_permitted)
14060 /* We're async whenever the serial device is. */
14061 return serial_can_async_p (rs->remote_desc);
14065 remote_target::is_async_p ()
14067 struct remote_state *rs = get_remote_state ();
14069 if (!target_async_permitted)
14070 /* We only enable async when the user specifically asks for it. */
14073 /* We're async whenever the serial device is. */
14074 return serial_is_async_p (rs->remote_desc);
14077 /* Pass the SERIAL event on and up to the client. One day this code
14078 will be able to delay notifying the client of an event until the
14079 point where an entire packet has been received. */
14081 static serial_event_ftype remote_async_serial_handler;
14084 remote_async_serial_handler (struct serial *scb, void *context)
14086 /* Don't propogate error information up to the client. Instead let
14087 the client find out about the error by querying the target. */
14088 inferior_event_handler (INF_REG_EVENT, NULL);
14092 remote_async_inferior_event_handler (gdb_client_data data)
14094 inferior_event_handler (INF_REG_EVENT, data);
14098 remote_target::async (int enable)
14100 struct remote_state *rs = get_remote_state ();
14104 serial_async (rs->remote_desc, remote_async_serial_handler, rs);
14106 /* If there are pending events in the stop reply queue tell the
14107 event loop to process them. */
14108 if (!rs->stop_reply_queue.empty ())
14109 mark_async_event_handler (rs->remote_async_inferior_event_token);
14110 /* For simplicity, below we clear the pending events token
14111 without remembering whether it is marked, so here we always
14112 mark it. If there's actually no pending notification to
14113 process, this ends up being a no-op (other than a spurious
14114 event-loop wakeup). */
14115 if (target_is_non_stop_p ())
14116 mark_async_event_handler (rs->notif_state->get_pending_events_token);
14120 serial_async (rs->remote_desc, NULL, NULL);
14121 /* If the core is disabling async, it doesn't want to be
14122 disturbed with target events. Clear all async event sources
14124 clear_async_event_handler (rs->remote_async_inferior_event_token);
14125 if (target_is_non_stop_p ())
14126 clear_async_event_handler (rs->notif_state->get_pending_events_token);
14130 /* Implementation of the to_thread_events method. */
14133 remote_target::thread_events (int enable)
14135 struct remote_state *rs = get_remote_state ();
14136 size_t size = get_remote_packet_size ();
14138 if (packet_support (PACKET_QThreadEvents) == PACKET_DISABLE)
14141 xsnprintf (rs->buf, size, "QThreadEvents:%x", enable ? 1 : 0);
14143 getpkt (&rs->buf, &rs->buf_size, 0);
14145 switch (packet_ok (rs->buf,
14146 &remote_protocol_packets[PACKET_QThreadEvents]))
14149 if (strcmp (rs->buf, "OK") != 0)
14150 error (_("Remote refused setting thread events: %s"), rs->buf);
14153 warning (_("Remote failure reply: %s"), rs->buf);
14155 case PACKET_UNKNOWN:
14161 set_remote_cmd (const char *args, int from_tty)
14163 help_list (remote_set_cmdlist, "set remote ", all_commands, gdb_stdout);
14167 show_remote_cmd (const char *args, int from_tty)
14169 /* We can't just use cmd_show_list here, because we want to skip
14170 the redundant "show remote Z-packet" and the legacy aliases. */
14171 struct cmd_list_element *list = remote_show_cmdlist;
14172 struct ui_out *uiout = current_uiout;
14174 ui_out_emit_tuple tuple_emitter (uiout, "showlist");
14175 for (; list != NULL; list = list->next)
14176 if (strcmp (list->name, "Z-packet") == 0)
14178 else if (list->type == not_set_cmd)
14179 /* Alias commands are exactly like the original, except they
14180 don't have the normal type. */
14184 ui_out_emit_tuple option_emitter (uiout, "option");
14186 uiout->field_string ("name", list->name);
14187 uiout->text (": ");
14188 if (list->type == show_cmd)
14189 do_show_command (NULL, from_tty, list);
14191 cmd_func (list, NULL, from_tty);
14196 /* Function to be called whenever a new objfile (shlib) is detected. */
14198 remote_new_objfile (struct objfile *objfile)
14200 remote_target *remote = get_current_remote_target ();
14202 if (remote != NULL) /* Have a remote connection. */
14203 remote->remote_check_symbols ();
14206 /* Pull all the tracepoints defined on the target and create local
14207 data structures representing them. We don't want to create real
14208 tracepoints yet, we don't want to mess up the user's existing
14212 remote_target::upload_tracepoints (struct uploaded_tp **utpp)
14214 struct remote_state *rs = get_remote_state ();
14217 /* Ask for a first packet of tracepoint definition. */
14219 getpkt (&rs->buf, &rs->buf_size, 0);
14221 while (*p && *p != 'l')
14223 parse_tracepoint_definition (p, utpp);
14224 /* Ask for another packet of tracepoint definition. */
14226 getpkt (&rs->buf, &rs->buf_size, 0);
14233 remote_target::upload_trace_state_variables (struct uploaded_tsv **utsvp)
14235 struct remote_state *rs = get_remote_state ();
14238 /* Ask for a first packet of variable definition. */
14240 getpkt (&rs->buf, &rs->buf_size, 0);
14242 while (*p && *p != 'l')
14244 parse_tsv_definition (p, utsvp);
14245 /* Ask for another packet of variable definition. */
14247 getpkt (&rs->buf, &rs->buf_size, 0);
14253 /* The "set/show range-stepping" show hook. */
14256 show_range_stepping (struct ui_file *file, int from_tty,
14257 struct cmd_list_element *c,
14260 fprintf_filtered (file,
14261 _("Debugger's willingness to use range stepping "
14262 "is %s.\n"), value);
14265 /* Return true if the vCont;r action is supported by the remote
14269 remote_target::vcont_r_supported ()
14271 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
14272 remote_vcont_probe ();
14274 return (packet_support (PACKET_vCont) == PACKET_ENABLE
14275 && get_remote_state ()->supports_vCont.r);
14278 /* The "set/show range-stepping" set hook. */
14281 set_range_stepping (const char *ignore_args, int from_tty,
14282 struct cmd_list_element *c)
14284 /* When enabling, check whether range stepping is actually supported
14285 by the target, and warn if not. */
14286 if (use_range_stepping)
14288 remote_target *remote = get_current_remote_target ();
14290 || !remote->vcont_r_supported ())
14291 warning (_("Range stepping is not supported by the current target"));
14296 _initialize_remote (void)
14298 struct cmd_list_element *cmd;
14299 const char *cmd_name;
14301 /* architecture specific data */
14302 remote_g_packet_data_handle =
14303 gdbarch_data_register_pre_init (remote_g_packet_data_init);
14306 = register_program_space_data_with_cleanup (NULL,
14307 remote_pspace_data_cleanup);
14309 add_target (remote_target_info, remote_target::open);
14310 add_target (extended_remote_target_info, extended_remote_target::open);
14312 /* Hook into new objfile notification. */
14313 gdb::observers::new_objfile.attach (remote_new_objfile);
14316 init_remote_threadtests ();
14319 /* set/show remote ... */
14321 add_prefix_cmd ("remote", class_maintenance, set_remote_cmd, _("\
14322 Remote protocol specific variables\n\
14323 Configure various remote-protocol specific variables such as\n\
14324 the packets being used"),
14325 &remote_set_cmdlist, "set remote ",
14326 0 /* allow-unknown */, &setlist);
14327 add_prefix_cmd ("remote", class_maintenance, show_remote_cmd, _("\
14328 Remote protocol specific variables\n\
14329 Configure various remote-protocol specific variables such as\n\
14330 the packets being used"),
14331 &remote_show_cmdlist, "show remote ",
14332 0 /* allow-unknown */, &showlist);
14334 add_cmd ("compare-sections", class_obscure, compare_sections_command, _("\
14335 Compare section data on target to the exec file.\n\
14336 Argument is a single section name (default: all loaded sections).\n\
14337 To compare only read-only loaded sections, specify the -r option."),
14340 add_cmd ("packet", class_maintenance, packet_command, _("\
14341 Send an arbitrary packet to a remote target.\n\
14342 maintenance packet TEXT\n\
14343 If GDB is talking to an inferior via the GDB serial protocol, then\n\
14344 this command sends the string TEXT to the inferior, and displays the\n\
14345 response packet. GDB supplies the initial `$' character, and the\n\
14346 terminating `#' character and checksum."),
14349 add_setshow_boolean_cmd ("remotebreak", no_class, &remote_break, _("\
14350 Set whether to send break if interrupted."), _("\
14351 Show whether to send break if interrupted."), _("\
14352 If set, a break, instead of a cntrl-c, is sent to the remote target."),
14353 set_remotebreak, show_remotebreak,
14354 &setlist, &showlist);
14355 cmd_name = "remotebreak";
14356 cmd = lookup_cmd (&cmd_name, setlist, "", -1, 1);
14357 deprecate_cmd (cmd, "set remote interrupt-sequence");
14358 cmd_name = "remotebreak"; /* needed because lookup_cmd updates the pointer */
14359 cmd = lookup_cmd (&cmd_name, showlist, "", -1, 1);
14360 deprecate_cmd (cmd, "show remote interrupt-sequence");
14362 add_setshow_enum_cmd ("interrupt-sequence", class_support,
14363 interrupt_sequence_modes, &interrupt_sequence_mode,
14365 Set interrupt sequence to remote target."), _("\
14366 Show interrupt sequence to remote target."), _("\
14367 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
14368 NULL, show_interrupt_sequence,
14369 &remote_set_cmdlist,
14370 &remote_show_cmdlist);
14372 add_setshow_boolean_cmd ("interrupt-on-connect", class_support,
14373 &interrupt_on_connect, _("\
14374 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
14375 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
14376 If set, interrupt sequence is sent to remote target."),
14378 &remote_set_cmdlist, &remote_show_cmdlist);
14380 /* Install commands for configuring memory read/write packets. */
14382 add_cmd ("remotewritesize", no_class, set_memory_write_packet_size, _("\
14383 Set the maximum number of bytes per memory write packet (deprecated)."),
14385 add_cmd ("remotewritesize", no_class, show_memory_write_packet_size, _("\
14386 Show the maximum number of bytes per memory write packet (deprecated)."),
14388 add_cmd ("memory-write-packet-size", no_class,
14389 set_memory_write_packet_size, _("\
14390 Set the maximum number of bytes per memory-write packet.\n\
14391 Specify the number of bytes in a packet or 0 (zero) for the\n\
14392 default packet size. The actual limit is further reduced\n\
14393 dependent on the target. Specify ``fixed'' to disable the\n\
14394 further restriction and ``limit'' to enable that restriction."),
14395 &remote_set_cmdlist);
14396 add_cmd ("memory-read-packet-size", no_class,
14397 set_memory_read_packet_size, _("\
14398 Set the maximum number of bytes per memory-read packet.\n\
14399 Specify the number of bytes in a packet or 0 (zero) for the\n\
14400 default packet size. The actual limit is further reduced\n\
14401 dependent on the target. Specify ``fixed'' to disable the\n\
14402 further restriction and ``limit'' to enable that restriction."),
14403 &remote_set_cmdlist);
14404 add_cmd ("memory-write-packet-size", no_class,
14405 show_memory_write_packet_size,
14406 _("Show the maximum number of bytes per memory-write packet."),
14407 &remote_show_cmdlist);
14408 add_cmd ("memory-read-packet-size", no_class,
14409 show_memory_read_packet_size,
14410 _("Show the maximum number of bytes per memory-read packet."),
14411 &remote_show_cmdlist);
14413 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-limit", no_class,
14414 &remote_hw_watchpoint_limit, _("\
14415 Set the maximum number of target hardware watchpoints."), _("\
14416 Show the maximum number of target hardware watchpoints."), _("\
14417 Specify \"unlimited\" for unlimited hardware watchpoints."),
14418 NULL, show_hardware_watchpoint_limit,
14419 &remote_set_cmdlist,
14420 &remote_show_cmdlist);
14421 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-length-limit",
14423 &remote_hw_watchpoint_length_limit, _("\
14424 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
14425 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
14426 Specify \"unlimited\" to allow watchpoints of unlimited size."),
14427 NULL, show_hardware_watchpoint_length_limit,
14428 &remote_set_cmdlist, &remote_show_cmdlist);
14429 add_setshow_zuinteger_unlimited_cmd ("hardware-breakpoint-limit", no_class,
14430 &remote_hw_breakpoint_limit, _("\
14431 Set the maximum number of target hardware breakpoints."), _("\
14432 Show the maximum number of target hardware breakpoints."), _("\
14433 Specify \"unlimited\" for unlimited hardware breakpoints."),
14434 NULL, show_hardware_breakpoint_limit,
14435 &remote_set_cmdlist, &remote_show_cmdlist);
14437 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure,
14438 &remote_address_size, _("\
14439 Set the maximum size of the address (in bits) in a memory packet."), _("\
14440 Show the maximum size of the address (in bits) in a memory packet."), NULL,
14442 NULL, /* FIXME: i18n: */
14443 &setlist, &showlist);
14445 init_all_packet_configs ();
14447 add_packet_config_cmd (&remote_protocol_packets[PACKET_X],
14448 "X", "binary-download", 1);
14450 add_packet_config_cmd (&remote_protocol_packets[PACKET_vCont],
14451 "vCont", "verbose-resume", 0);
14453 add_packet_config_cmd (&remote_protocol_packets[PACKET_QPassSignals],
14454 "QPassSignals", "pass-signals", 0);
14456 add_packet_config_cmd (&remote_protocol_packets[PACKET_QCatchSyscalls],
14457 "QCatchSyscalls", "catch-syscalls", 0);
14459 add_packet_config_cmd (&remote_protocol_packets[PACKET_QProgramSignals],
14460 "QProgramSignals", "program-signals", 0);
14462 add_packet_config_cmd (&remote_protocol_packets[PACKET_QSetWorkingDir],
14463 "QSetWorkingDir", "set-working-dir", 0);
14465 add_packet_config_cmd (&remote_protocol_packets[PACKET_QStartupWithShell],
14466 "QStartupWithShell", "startup-with-shell", 0);
14468 add_packet_config_cmd (&remote_protocol_packets
14469 [PACKET_QEnvironmentHexEncoded],
14470 "QEnvironmentHexEncoded", "environment-hex-encoded",
14473 add_packet_config_cmd (&remote_protocol_packets[PACKET_QEnvironmentReset],
14474 "QEnvironmentReset", "environment-reset",
14477 add_packet_config_cmd (&remote_protocol_packets[PACKET_QEnvironmentUnset],
14478 "QEnvironmentUnset", "environment-unset",
14481 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSymbol],
14482 "qSymbol", "symbol-lookup", 0);
14484 add_packet_config_cmd (&remote_protocol_packets[PACKET_P],
14485 "P", "set-register", 1);
14487 add_packet_config_cmd (&remote_protocol_packets[PACKET_p],
14488 "p", "fetch-register", 1);
14490 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z0],
14491 "Z0", "software-breakpoint", 0);
14493 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z1],
14494 "Z1", "hardware-breakpoint", 0);
14496 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z2],
14497 "Z2", "write-watchpoint", 0);
14499 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z3],
14500 "Z3", "read-watchpoint", 0);
14502 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z4],
14503 "Z4", "access-watchpoint", 0);
14505 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_auxv],
14506 "qXfer:auxv:read", "read-aux-vector", 0);
14508 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_exec_file],
14509 "qXfer:exec-file:read", "pid-to-exec-file", 0);
14511 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_features],
14512 "qXfer:features:read", "target-features", 0);
14514 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries],
14515 "qXfer:libraries:read", "library-info", 0);
14517 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries_svr4],
14518 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
14520 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_memory_map],
14521 "qXfer:memory-map:read", "memory-map", 0);
14523 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_read],
14524 "qXfer:spu:read", "read-spu-object", 0);
14526 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_write],
14527 "qXfer:spu:write", "write-spu-object", 0);
14529 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_osdata],
14530 "qXfer:osdata:read", "osdata", 0);
14532 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_threads],
14533 "qXfer:threads:read", "threads", 0);
14535 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_read],
14536 "qXfer:siginfo:read", "read-siginfo-object", 0);
14538 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_write],
14539 "qXfer:siginfo:write", "write-siginfo-object", 0);
14541 add_packet_config_cmd
14542 (&remote_protocol_packets[PACKET_qXfer_traceframe_info],
14543 "qXfer:traceframe-info:read", "traceframe-info", 0);
14545 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_uib],
14546 "qXfer:uib:read", "unwind-info-block", 0);
14548 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTLSAddr],
14549 "qGetTLSAddr", "get-thread-local-storage-address",
14552 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTIBAddr],
14553 "qGetTIBAddr", "get-thread-information-block-address",
14556 add_packet_config_cmd (&remote_protocol_packets[PACKET_bc],
14557 "bc", "reverse-continue", 0);
14559 add_packet_config_cmd (&remote_protocol_packets[PACKET_bs],
14560 "bs", "reverse-step", 0);
14562 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSupported],
14563 "qSupported", "supported-packets", 0);
14565 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSearch_memory],
14566 "qSearch:memory", "search-memory", 0);
14568 add_packet_config_cmd (&remote_protocol_packets[PACKET_qTStatus],
14569 "qTStatus", "trace-status", 0);
14571 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_setfs],
14572 "vFile:setfs", "hostio-setfs", 0);
14574 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_open],
14575 "vFile:open", "hostio-open", 0);
14577 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pread],
14578 "vFile:pread", "hostio-pread", 0);
14580 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pwrite],
14581 "vFile:pwrite", "hostio-pwrite", 0);
14583 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_close],
14584 "vFile:close", "hostio-close", 0);
14586 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_unlink],
14587 "vFile:unlink", "hostio-unlink", 0);
14589 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_readlink],
14590 "vFile:readlink", "hostio-readlink", 0);
14592 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_fstat],
14593 "vFile:fstat", "hostio-fstat", 0);
14595 add_packet_config_cmd (&remote_protocol_packets[PACKET_vAttach],
14596 "vAttach", "attach", 0);
14598 add_packet_config_cmd (&remote_protocol_packets[PACKET_vRun],
14601 add_packet_config_cmd (&remote_protocol_packets[PACKET_QStartNoAckMode],
14602 "QStartNoAckMode", "noack", 0);
14604 add_packet_config_cmd (&remote_protocol_packets[PACKET_vKill],
14605 "vKill", "kill", 0);
14607 add_packet_config_cmd (&remote_protocol_packets[PACKET_qAttached],
14608 "qAttached", "query-attached", 0);
14610 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalTracepoints],
14611 "ConditionalTracepoints",
14612 "conditional-tracepoints", 0);
14614 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalBreakpoints],
14615 "ConditionalBreakpoints",
14616 "conditional-breakpoints", 0);
14618 add_packet_config_cmd (&remote_protocol_packets[PACKET_BreakpointCommands],
14619 "BreakpointCommands",
14620 "breakpoint-commands", 0);
14622 add_packet_config_cmd (&remote_protocol_packets[PACKET_FastTracepoints],
14623 "FastTracepoints", "fast-tracepoints", 0);
14625 add_packet_config_cmd (&remote_protocol_packets[PACKET_TracepointSource],
14626 "TracepointSource", "TracepointSource", 0);
14628 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAllow],
14629 "QAllow", "allow", 0);
14631 add_packet_config_cmd (&remote_protocol_packets[PACKET_StaticTracepoints],
14632 "StaticTracepoints", "static-tracepoints", 0);
14634 add_packet_config_cmd (&remote_protocol_packets[PACKET_InstallInTrace],
14635 "InstallInTrace", "install-in-trace", 0);
14637 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_statictrace_read],
14638 "qXfer:statictrace:read", "read-sdata-object", 0);
14640 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_fdpic],
14641 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
14643 add_packet_config_cmd (&remote_protocol_packets[PACKET_QDisableRandomization],
14644 "QDisableRandomization", "disable-randomization", 0);
14646 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAgent],
14647 "QAgent", "agent", 0);
14649 add_packet_config_cmd (&remote_protocol_packets[PACKET_QTBuffer_size],
14650 "QTBuffer:size", "trace-buffer-size", 0);
14652 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_off],
14653 "Qbtrace:off", "disable-btrace", 0);
14655 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_bts],
14656 "Qbtrace:bts", "enable-btrace-bts", 0);
14658 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_pt],
14659 "Qbtrace:pt", "enable-btrace-pt", 0);
14661 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace],
14662 "qXfer:btrace", "read-btrace", 0);
14664 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace_conf],
14665 "qXfer:btrace-conf", "read-btrace-conf", 0);
14667 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_conf_bts_size],
14668 "Qbtrace-conf:bts:size", "btrace-conf-bts-size", 0);
14670 add_packet_config_cmd (&remote_protocol_packets[PACKET_multiprocess_feature],
14671 "multiprocess-feature", "multiprocess-feature", 0);
14673 add_packet_config_cmd (&remote_protocol_packets[PACKET_swbreak_feature],
14674 "swbreak-feature", "swbreak-feature", 0);
14676 add_packet_config_cmd (&remote_protocol_packets[PACKET_hwbreak_feature],
14677 "hwbreak-feature", "hwbreak-feature", 0);
14679 add_packet_config_cmd (&remote_protocol_packets[PACKET_fork_event_feature],
14680 "fork-event-feature", "fork-event-feature", 0);
14682 add_packet_config_cmd (&remote_protocol_packets[PACKET_vfork_event_feature],
14683 "vfork-event-feature", "vfork-event-feature", 0);
14685 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_conf_pt_size],
14686 "Qbtrace-conf:pt:size", "btrace-conf-pt-size", 0);
14688 add_packet_config_cmd (&remote_protocol_packets[PACKET_vContSupported],
14689 "vContSupported", "verbose-resume-supported", 0);
14691 add_packet_config_cmd (&remote_protocol_packets[PACKET_exec_event_feature],
14692 "exec-event-feature", "exec-event-feature", 0);
14694 add_packet_config_cmd (&remote_protocol_packets[PACKET_vCtrlC],
14695 "vCtrlC", "ctrl-c", 0);
14697 add_packet_config_cmd (&remote_protocol_packets[PACKET_QThreadEvents],
14698 "QThreadEvents", "thread-events", 0);
14700 add_packet_config_cmd (&remote_protocol_packets[PACKET_no_resumed],
14701 "N stop reply", "no-resumed-stop-reply", 0);
14703 /* Assert that we've registered "set remote foo-packet" commands
14704 for all packet configs. */
14708 for (i = 0; i < PACKET_MAX; i++)
14710 /* Ideally all configs would have a command associated. Some
14711 still don't though. */
14716 case PACKET_QNonStop:
14717 case PACKET_EnableDisableTracepoints_feature:
14718 case PACKET_tracenz_feature:
14719 case PACKET_DisconnectedTracing_feature:
14720 case PACKET_augmented_libraries_svr4_read_feature:
14722 /* Additions to this list need to be well justified:
14723 pre-existing packets are OK; new packets are not. */
14731 /* This catches both forgetting to add a config command, and
14732 forgetting to remove a packet from the exception list. */
14733 gdb_assert (excepted == (remote_protocol_packets[i].name == NULL));
14737 /* Keep the old ``set remote Z-packet ...'' working. Each individual
14738 Z sub-packet has its own set and show commands, but users may
14739 have sets to this variable in their .gdbinit files (or in their
14741 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure,
14742 &remote_Z_packet_detect, _("\
14743 Set use of remote protocol `Z' packets"), _("\
14744 Show use of remote protocol `Z' packets "), _("\
14745 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
14747 set_remote_protocol_Z_packet_cmd,
14748 show_remote_protocol_Z_packet_cmd,
14749 /* FIXME: i18n: Use of remote protocol
14750 `Z' packets is %s. */
14751 &remote_set_cmdlist, &remote_show_cmdlist);
14753 add_prefix_cmd ("remote", class_files, remote_command, _("\
14754 Manipulate files on the remote system\n\
14755 Transfer files to and from the remote target system."),
14756 &remote_cmdlist, "remote ",
14757 0 /* allow-unknown */, &cmdlist);
14759 add_cmd ("put", class_files, remote_put_command,
14760 _("Copy a local file to the remote system."),
14763 add_cmd ("get", class_files, remote_get_command,
14764 _("Copy a remote file to the local system."),
14767 add_cmd ("delete", class_files, remote_delete_command,
14768 _("Delete a remote file."),
14771 add_setshow_string_noescape_cmd ("exec-file", class_files,
14772 &remote_exec_file_var, _("\
14773 Set the remote pathname for \"run\""), _("\
14774 Show the remote pathname for \"run\""), NULL,
14775 set_remote_exec_file,
14776 show_remote_exec_file,
14777 &remote_set_cmdlist,
14778 &remote_show_cmdlist);
14780 add_setshow_boolean_cmd ("range-stepping", class_run,
14781 &use_range_stepping, _("\
14782 Enable or disable range stepping."), _("\
14783 Show whether target-assisted range stepping is enabled."), _("\
14784 If on, and the target supports it, when stepping a source line, GDB\n\
14785 tells the target to step the corresponding range of addresses itself instead\n\
14786 of issuing multiple single-steps. This speeds up source level\n\
14787 stepping. If off, GDB always issues single-steps, even if range\n\
14788 stepping is supported by the target. The default is on."),
14789 set_range_stepping,
14790 show_range_stepping,
14794 /* Eventually initialize fileio. See fileio.c */
14795 initialize_remote_fileio (remote_set_cmdlist, remote_show_cmdlist);
14797 /* Take advantage of the fact that the TID field is not used, to tag
14798 special ptids with it set to != 0. */
14799 magic_null_ptid = ptid_t (42000, -1, 1);
14800 not_sent_ptid = ptid_t (42000, -2, 1);
14801 any_thread_ptid = ptid_t (42000, 0, 1);