1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2021 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
20 /* See the GDB User Guide for details of the GDB remote protocol. */
30 #include "process-stratum-target.h"
33 #include "gdb-stabs.h"
34 #include "gdbthread.h"
36 #include "remote-notif.h"
39 #include "observable.h"
41 #include "cli/cli-decode.h"
42 #include "cli/cli-setshow.h"
43 #include "target-descriptions.h"
45 #include "gdbsupport/filestuff.h"
46 #include "gdbsupport/rsp-low.h"
50 #include "gdbsupport/gdb_sys_time.h"
52 #include "gdbsupport/event-loop.h"
53 #include "event-top.h"
61 #include "remote-fileio.h"
62 #include "gdb/fileio.h"
64 #include "xml-support.h"
66 #include "memory-map.h"
68 #include "tracepoint.h"
71 #include "gdbsupport/agent.h"
73 #include "record-btrace.h"
75 #include "gdbsupport/scoped_restore.h"
76 #include "gdbsupport/environ.h"
77 #include "gdbsupport/byte-vector.h"
78 #include "gdbsupport/search.h"
80 #include <unordered_map>
81 #include "async-event.h"
83 /* The remote target. */
85 static const char remote_doc
[] = N_("\
86 Use a remote computer via a serial line, using a gdb-specific protocol.\n\
87 Specify the serial device it is connected to\n\
88 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).");
90 #define OPAQUETHREADBYTES 8
92 /* a 64 bit opaque identifier */
93 typedef unsigned char threadref
[OPAQUETHREADBYTES
];
95 struct gdb_ext_thread_info
;
96 struct threads_listing_context
;
97 typedef int (*rmt_thread_action
) (threadref
*ref
, void *context
);
98 struct protocol_feature
;
102 typedef std::unique_ptr
<stop_reply
> stop_reply_up
;
104 /* Generic configuration support for packets the stub optionally
105 supports. Allows the user to specify the use of the packet as well
106 as allowing GDB to auto-detect support in the remote stub. */
110 PACKET_SUPPORT_UNKNOWN
= 0,
115 /* Analyze a packet's return value and update the packet config
125 struct threads_listing_context
;
127 /* Stub vCont actions support.
129 Each field is a boolean flag indicating whether the stub reports
130 support for the corresponding action. */
132 struct vCont_action_support
147 /* About this many threadids fit in a packet. */
149 #define MAXTHREADLISTRESULTS 32
151 /* Data for the vFile:pread readahead cache. */
153 struct readahead_cache
155 /* Invalidate the readahead cache. */
158 /* Invalidate the readahead cache if it is holding data for FD. */
159 void invalidate_fd (int fd
);
161 /* Serve pread from the readahead cache. Returns number of bytes
162 read, or 0 if the request can't be served from the cache. */
163 int pread (int fd
, gdb_byte
*read_buf
, size_t len
, ULONGEST offset
);
165 /* The file descriptor for the file that is being cached. -1 if the
169 /* The offset into the file that the cache buffer corresponds
173 /* The buffer holding the cache contents. */
174 gdb_byte
*buf
= nullptr;
175 /* The buffer's size. We try to read as much as fits into a packet
179 /* Cache hit and miss counters. */
180 ULONGEST hit_count
= 0;
181 ULONGEST miss_count
= 0;
184 /* Description of the remote protocol for a given architecture. */
188 long offset
; /* Offset into G packet. */
189 long regnum
; /* GDB's internal register number. */
190 LONGEST pnum
; /* Remote protocol register number. */
191 int in_g_packet
; /* Always part of G packet. */
192 /* long size in bytes; == register_size (target_gdbarch (), regnum);
194 /* char *name; == gdbarch_register_name (target_gdbarch (), regnum);
198 struct remote_arch_state
200 explicit remote_arch_state (struct gdbarch
*gdbarch
);
202 /* Description of the remote protocol registers. */
203 long sizeof_g_packet
;
205 /* Description of the remote protocol registers indexed by REGNUM
206 (making an array gdbarch_num_regs in size). */
207 std::unique_ptr
<packet_reg
[]> regs
;
209 /* This is the size (in chars) of the first response to the ``g''
210 packet. It is used as a heuristic when determining the maximum
211 size of memory-read and memory-write packets. A target will
212 typically only reserve a buffer large enough to hold the ``g''
213 packet. The size does not include packet overhead (headers and
215 long actual_register_packet_size
;
217 /* This is the maximum size (in chars) of a non read/write packet.
218 It is also used as a cap on the size of read/write packets. */
219 long remote_packet_size
;
222 /* Description of the remote protocol state for the currently
223 connected target. This is per-target state, and independent of the
224 selected architecture. */
233 /* Get the remote arch state for GDBARCH. */
234 struct remote_arch_state
*get_remote_arch_state (struct gdbarch
*gdbarch
);
238 /* A buffer to use for incoming packets, and its current size. The
239 buffer is grown dynamically for larger incoming packets.
240 Outgoing packets may also be constructed in this buffer.
241 The size of the buffer is always at least REMOTE_PACKET_SIZE;
242 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
244 gdb::char_vector buf
;
246 /* True if we're going through initial connection setup (finding out
247 about the remote side's threads, relocating symbols, etc.). */
248 bool starting_up
= false;
250 /* If we negotiated packet size explicitly (and thus can bypass
251 heuristics for the largest packet size that will not overflow
252 a buffer in the stub), this will be set to that packet size.
253 Otherwise zero, meaning to use the guessed size. */
254 long explicit_packet_size
= 0;
256 /* remote_wait is normally called when the target is running and
257 waits for a stop reply packet. But sometimes we need to call it
258 when the target is already stopped. We can send a "?" packet
259 and have remote_wait read the response. Or, if we already have
260 the response, we can stash it in BUF and tell remote_wait to
261 skip calling getpkt. This flag is set when BUF contains a
262 stop reply packet and the target is not waiting. */
263 int cached_wait_status
= 0;
265 /* True, if in no ack mode. That is, neither GDB nor the stub will
266 expect acks from each other. The connection is assumed to be
268 bool noack_mode
= false;
270 /* True if we're connected in extended remote mode. */
271 bool extended
= false;
273 /* True if we resumed the target and we're waiting for the target to
274 stop. In the mean time, we can't start another command/query.
275 The remote server wouldn't be ready to process it, so we'd
276 timeout waiting for a reply that would never come and eventually
277 we'd close the connection. This can happen in asynchronous mode
278 because we allow GDB commands while the target is running. */
279 bool waiting_for_stop_reply
= false;
281 /* The status of the stub support for the various vCont actions. */
282 vCont_action_support supports_vCont
;
283 /* Whether vCont support was probed already. This is a workaround
284 until packet_support is per-connection. */
285 bool supports_vCont_probed
;
287 /* True if the user has pressed Ctrl-C, but the target hasn't
288 responded to that. */
289 bool ctrlc_pending_p
= false;
291 /* True if we saw a Ctrl-C while reading or writing from/to the
292 remote descriptor. At that point it is not safe to send a remote
293 interrupt packet, so we instead remember we saw the Ctrl-C and
294 process it once we're done with sending/receiving the current
295 packet, which should be shortly. If however that takes too long,
296 and the user presses Ctrl-C again, we offer to disconnect. */
297 bool got_ctrlc_during_io
= false;
299 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
300 remote_open knows that we don't have a file open when the program
302 struct serial
*remote_desc
= nullptr;
304 /* These are the threads which we last sent to the remote system. The
305 TID member will be -1 for all or -2 for not sent yet. */
306 ptid_t general_thread
= null_ptid
;
307 ptid_t continue_thread
= null_ptid
;
309 /* This is the traceframe which we last selected on the remote system.
310 It will be -1 if no traceframe is selected. */
311 int remote_traceframe_number
= -1;
313 char *last_pass_packet
= nullptr;
315 /* The last QProgramSignals packet sent to the target. We bypass
316 sending a new program signals list down to the target if the new
317 packet is exactly the same as the last we sent. IOW, we only let
318 the target know about program signals list changes. */
319 char *last_program_signals_packet
= nullptr;
321 gdb_signal last_sent_signal
= GDB_SIGNAL_0
;
323 bool last_sent_step
= false;
325 /* The execution direction of the last resume we got. */
326 exec_direction_kind last_resume_exec_dir
= EXEC_FORWARD
;
328 char *finished_object
= nullptr;
329 char *finished_annex
= nullptr;
330 ULONGEST finished_offset
= 0;
332 /* Should we try the 'ThreadInfo' query packet?
334 This variable (NOT available to the user: auto-detect only!)
335 determines whether GDB will use the new, simpler "ThreadInfo"
336 query or the older, more complex syntax for thread queries.
337 This is an auto-detect variable (set to true at each connect,
338 and set to false when the target fails to recognize it). */
339 bool use_threadinfo_query
= false;
340 bool use_threadextra_query
= false;
342 threadref echo_nextthread
{};
343 threadref nextthread
{};
344 threadref resultthreadlist
[MAXTHREADLISTRESULTS
] {};
346 /* The state of remote notification. */
347 struct remote_notif_state
*notif_state
= nullptr;
349 /* The branch trace configuration. */
350 struct btrace_config btrace_config
{};
352 /* The argument to the last "vFile:setfs:" packet we sent, used
353 to avoid sending repeated unnecessary "vFile:setfs:" packets.
354 Initialized to -1 to indicate that no "vFile:setfs:" packet
355 has yet been sent. */
358 /* A readahead cache for vFile:pread. Often, reading a binary
359 involves a sequence of small reads. E.g., when parsing an ELF
360 file. A readahead cache helps mostly the case of remote
361 debugging on a connection with higher latency, due to the
362 request/reply nature of the RSP. We only cache data for a single
363 file descriptor at a time. */
364 struct readahead_cache readahead_cache
;
366 /* The list of already fetched and acknowledged stop events. This
367 queue is used for notification Stop, and other notifications
368 don't need queue for their events, because the notification
369 events of Stop can't be consumed immediately, so that events
370 should be queued first, and be consumed by remote_wait_{ns,as}
371 one per time. Other notifications can consume their events
372 immediately, so queue is not needed for them. */
373 std::vector
<stop_reply_up
> stop_reply_queue
;
375 /* Asynchronous signal handle registered as event loop source for
376 when we have pending events ready to be passed to the core. */
377 struct async_event_handler
*remote_async_inferior_event_token
= nullptr;
379 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
380 ``forever'' still use the normal timeout mechanism. This is
381 currently used by the ASYNC code to guarentee that target reads
382 during the initial connect always time-out. Once getpkt has been
383 modified to return a timeout indication and, in turn
384 remote_wait()/wait_for_inferior() have gained a timeout parameter
386 int wait_forever_enabled_p
= 1;
389 /* Mapping of remote protocol data for each gdbarch. Usually there
390 is only one entry here, though we may see more with stubs that
391 support multi-process. */
392 std::unordered_map
<struct gdbarch
*, remote_arch_state
>
396 static const target_info remote_target_info
= {
398 N_("Remote serial target in gdb-specific protocol"),
402 class remote_target
: public process_stratum_target
405 remote_target () = default;
406 ~remote_target () override
;
408 const target_info
&info () const override
409 { return remote_target_info
; }
411 const char *connection_string () override
;
413 thread_control_capabilities
get_thread_control_capabilities () override
414 { return tc_schedlock
; }
416 /* Open a remote connection. */
417 static void open (const char *, int);
419 void close () override
;
421 void detach (inferior
*, int) override
;
422 void disconnect (const char *, int) override
;
424 void commit_resume () override
;
425 void resume (ptid_t
, int, enum gdb_signal
) override
;
426 ptid_t
wait (ptid_t
, struct target_waitstatus
*, target_wait_flags
) override
;
428 void fetch_registers (struct regcache
*, int) override
;
429 void store_registers (struct regcache
*, int) override
;
430 void prepare_to_store (struct regcache
*) override
;
432 void files_info () override
;
434 int insert_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
436 int remove_breakpoint (struct gdbarch
*, struct bp_target_info
*,
437 enum remove_bp_reason
) override
;
440 bool stopped_by_sw_breakpoint () override
;
441 bool supports_stopped_by_sw_breakpoint () override
;
443 bool stopped_by_hw_breakpoint () override
;
445 bool supports_stopped_by_hw_breakpoint () override
;
447 bool stopped_by_watchpoint () override
;
449 bool stopped_data_address (CORE_ADDR
*) override
;
451 bool watchpoint_addr_within_range (CORE_ADDR
, CORE_ADDR
, int) override
;
453 int can_use_hw_breakpoint (enum bptype
, int, int) override
;
455 int insert_hw_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
457 int remove_hw_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
459 int region_ok_for_hw_watchpoint (CORE_ADDR
, int) override
;
461 int insert_watchpoint (CORE_ADDR
, int, enum target_hw_bp_type
,
462 struct expression
*) override
;
464 int remove_watchpoint (CORE_ADDR
, int, enum target_hw_bp_type
,
465 struct expression
*) override
;
467 void kill () override
;
469 void load (const char *, int) override
;
471 void mourn_inferior () override
;
473 void pass_signals (gdb::array_view
<const unsigned char>) override
;
475 int set_syscall_catchpoint (int, bool, int,
476 gdb::array_view
<const int>) override
;
478 void program_signals (gdb::array_view
<const unsigned char>) override
;
480 bool thread_alive (ptid_t ptid
) override
;
482 const char *thread_name (struct thread_info
*) override
;
484 void update_thread_list () override
;
486 std::string
pid_to_str (ptid_t
) override
;
488 const char *extra_thread_info (struct thread_info
*) override
;
490 ptid_t
get_ada_task_ptid (long lwp
, long thread
) override
;
492 thread_info
*thread_handle_to_thread_info (const gdb_byte
*thread_handle
,
494 inferior
*inf
) override
;
496 gdb::byte_vector
thread_info_to_thread_handle (struct thread_info
*tp
)
499 void stop (ptid_t
) override
;
501 void interrupt () override
;
503 void pass_ctrlc () override
;
505 enum target_xfer_status
xfer_partial (enum target_object object
,
508 const gdb_byte
*writebuf
,
509 ULONGEST offset
, ULONGEST len
,
510 ULONGEST
*xfered_len
) override
;
512 ULONGEST
get_memory_xfer_limit () override
;
514 void rcmd (const char *command
, struct ui_file
*output
) override
;
516 char *pid_to_exec_file (int pid
) override
;
518 void log_command (const char *cmd
) override
520 serial_log_command (this, cmd
);
523 CORE_ADDR
get_thread_local_address (ptid_t ptid
,
524 CORE_ADDR load_module_addr
,
525 CORE_ADDR offset
) override
;
527 bool can_execute_reverse () override
;
529 std::vector
<mem_region
> memory_map () override
;
531 void flash_erase (ULONGEST address
, LONGEST length
) override
;
533 void flash_done () override
;
535 const struct target_desc
*read_description () override
;
537 int search_memory (CORE_ADDR start_addr
, ULONGEST search_space_len
,
538 const gdb_byte
*pattern
, ULONGEST pattern_len
,
539 CORE_ADDR
*found_addrp
) override
;
541 bool can_async_p () override
;
543 bool is_async_p () override
;
545 void async (int) override
;
547 int async_wait_fd () override
;
549 void thread_events (int) override
;
551 int can_do_single_step () override
;
553 void terminal_inferior () override
;
555 void terminal_ours () override
;
557 bool supports_non_stop () override
;
559 bool supports_multi_process () override
;
561 bool supports_disable_randomization () override
;
563 bool filesystem_is_local () override
;
566 int fileio_open (struct inferior
*inf
, const char *filename
,
567 int flags
, int mode
, int warn_if_slow
,
568 int *target_errno
) override
;
570 int fileio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
571 ULONGEST offset
, int *target_errno
) override
;
573 int fileio_pread (int fd
, gdb_byte
*read_buf
, int len
,
574 ULONGEST offset
, int *target_errno
) override
;
576 int fileio_fstat (int fd
, struct stat
*sb
, int *target_errno
) override
;
578 int fileio_close (int fd
, int *target_errno
) override
;
580 int fileio_unlink (struct inferior
*inf
,
581 const char *filename
,
582 int *target_errno
) override
;
584 gdb::optional
<std::string
>
585 fileio_readlink (struct inferior
*inf
,
586 const char *filename
,
587 int *target_errno
) override
;
589 bool supports_enable_disable_tracepoint () override
;
591 bool supports_string_tracing () override
;
593 bool supports_evaluation_of_breakpoint_conditions () override
;
595 bool can_run_breakpoint_commands () override
;
597 void trace_init () override
;
599 void download_tracepoint (struct bp_location
*location
) override
;
601 bool can_download_tracepoint () override
;
603 void download_trace_state_variable (const trace_state_variable
&tsv
) override
;
605 void enable_tracepoint (struct bp_location
*location
) override
;
607 void disable_tracepoint (struct bp_location
*location
) override
;
609 void trace_set_readonly_regions () override
;
611 void trace_start () override
;
613 int get_trace_status (struct trace_status
*ts
) override
;
615 void get_tracepoint_status (struct breakpoint
*tp
, struct uploaded_tp
*utp
)
618 void trace_stop () override
;
620 int trace_find (enum trace_find_type type
, int num
,
621 CORE_ADDR addr1
, CORE_ADDR addr2
, int *tpp
) override
;
623 bool get_trace_state_variable_value (int tsv
, LONGEST
*val
) override
;
625 int save_trace_data (const char *filename
) override
;
627 int upload_tracepoints (struct uploaded_tp
**utpp
) override
;
629 int upload_trace_state_variables (struct uploaded_tsv
**utsvp
) override
;
631 LONGEST
get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
) override
;
633 int get_min_fast_tracepoint_insn_len () override
;
635 void set_disconnected_tracing (int val
) override
;
637 void set_circular_trace_buffer (int val
) override
;
639 void set_trace_buffer_size (LONGEST val
) override
;
641 bool set_trace_notes (const char *user
, const char *notes
,
642 const char *stopnotes
) override
;
644 int core_of_thread (ptid_t ptid
) override
;
646 int verify_memory (const gdb_byte
*data
,
647 CORE_ADDR memaddr
, ULONGEST size
) override
;
650 bool get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
) override
;
652 void set_permissions () override
;
654 bool static_tracepoint_marker_at (CORE_ADDR
,
655 struct static_tracepoint_marker
*marker
)
658 std::vector
<static_tracepoint_marker
>
659 static_tracepoint_markers_by_strid (const char *id
) override
;
661 traceframe_info_up
traceframe_info () override
;
663 bool use_agent (bool use
) override
;
664 bool can_use_agent () override
;
666 struct btrace_target_info
*enable_btrace (ptid_t ptid
,
667 const struct btrace_config
*conf
) override
;
669 void disable_btrace (struct btrace_target_info
*tinfo
) override
;
671 void teardown_btrace (struct btrace_target_info
*tinfo
) override
;
673 enum btrace_error
read_btrace (struct btrace_data
*data
,
674 struct btrace_target_info
*btinfo
,
675 enum btrace_read_type type
) override
;
677 const struct btrace_config
*btrace_conf (const struct btrace_target_info
*) override
;
678 bool augmented_libraries_svr4_read () override
;
679 bool follow_fork (bool, bool) override
;
680 void follow_exec (struct inferior
*, const char *) override
;
681 int insert_fork_catchpoint (int) override
;
682 int remove_fork_catchpoint (int) override
;
683 int insert_vfork_catchpoint (int) override
;
684 int remove_vfork_catchpoint (int) override
;
685 int insert_exec_catchpoint (int) override
;
686 int remove_exec_catchpoint (int) override
;
687 enum exec_direction_kind
execution_direction () override
;
689 public: /* Remote specific methods. */
691 void remote_download_command_source (int num
, ULONGEST addr
,
692 struct command_line
*cmds
);
694 void remote_file_put (const char *local_file
, const char *remote_file
,
696 void remote_file_get (const char *remote_file
, const char *local_file
,
698 void remote_file_delete (const char *remote_file
, int from_tty
);
700 int remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
701 ULONGEST offset
, int *remote_errno
);
702 int remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
703 ULONGEST offset
, int *remote_errno
);
704 int remote_hostio_pread_vFile (int fd
, gdb_byte
*read_buf
, int len
,
705 ULONGEST offset
, int *remote_errno
);
707 int remote_hostio_send_command (int command_bytes
, int which_packet
,
708 int *remote_errno
, char **attachment
,
709 int *attachment_len
);
710 int remote_hostio_set_filesystem (struct inferior
*inf
,
712 /* We should get rid of this and use fileio_open directly. */
713 int remote_hostio_open (struct inferior
*inf
, const char *filename
,
714 int flags
, int mode
, int warn_if_slow
,
716 int remote_hostio_close (int fd
, int *remote_errno
);
718 int remote_hostio_unlink (inferior
*inf
, const char *filename
,
721 struct remote_state
*get_remote_state ();
723 long get_remote_packet_size (void);
724 long get_memory_packet_size (struct memory_packet_config
*config
);
726 long get_memory_write_packet_size ();
727 long get_memory_read_packet_size ();
729 char *append_pending_thread_resumptions (char *p
, char *endp
,
731 static void open_1 (const char *name
, int from_tty
, int extended_p
);
732 void start_remote (int from_tty
, int extended_p
);
733 void remote_detach_1 (struct inferior
*inf
, int from_tty
);
735 char *append_resumption (char *p
, char *endp
,
736 ptid_t ptid
, int step
, gdb_signal siggnal
);
737 int remote_resume_with_vcont (ptid_t ptid
, int step
,
740 void add_current_inferior_and_thread (const char *wait_status
);
742 ptid_t
wait_ns (ptid_t ptid
, struct target_waitstatus
*status
,
743 target_wait_flags options
);
744 ptid_t
wait_as (ptid_t ptid
, target_waitstatus
*status
,
745 target_wait_flags options
);
747 ptid_t
process_stop_reply (struct stop_reply
*stop_reply
,
748 target_waitstatus
*status
);
750 ptid_t select_thread_for_ambiguous_stop_reply
751 (const struct target_waitstatus
*status
);
753 void remote_notice_new_inferior (ptid_t currthread
, int executing
);
755 void process_initial_stop_replies (int from_tty
);
757 thread_info
*remote_add_thread (ptid_t ptid
, bool running
, bool executing
);
759 void btrace_sync_conf (const btrace_config
*conf
);
761 void remote_btrace_maybe_reopen ();
763 void remove_new_fork_children (threads_listing_context
*context
);
764 void kill_new_fork_children (int pid
);
765 void discard_pending_stop_replies (struct inferior
*inf
);
766 int stop_reply_queue_length ();
768 void check_pending_events_prevent_wildcard_vcont
769 (int *may_global_wildcard_vcont
);
771 void discard_pending_stop_replies_in_queue ();
772 struct stop_reply
*remote_notif_remove_queued_reply (ptid_t ptid
);
773 struct stop_reply
*queued_stop_reply (ptid_t ptid
);
774 int peek_stop_reply (ptid_t ptid
);
775 void remote_parse_stop_reply (const char *buf
, stop_reply
*event
);
777 void remote_stop_ns (ptid_t ptid
);
778 void remote_interrupt_as ();
779 void remote_interrupt_ns ();
781 char *remote_get_noisy_reply ();
782 int remote_query_attached (int pid
);
783 inferior
*remote_add_inferior (bool fake_pid_p
, int pid
, int attached
,
786 ptid_t
remote_current_thread (ptid_t oldpid
);
787 ptid_t
get_current_thread (const char *wait_status
);
789 void set_thread (ptid_t ptid
, int gen
);
790 void set_general_thread (ptid_t ptid
);
791 void set_continue_thread (ptid_t ptid
);
792 void set_general_process ();
794 char *write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
);
796 int remote_unpack_thread_info_response (const char *pkt
, threadref
*expectedref
,
797 gdb_ext_thread_info
*info
);
798 int remote_get_threadinfo (threadref
*threadid
, int fieldset
,
799 gdb_ext_thread_info
*info
);
801 int parse_threadlist_response (const char *pkt
, int result_limit
,
802 threadref
*original_echo
,
803 threadref
*resultlist
,
805 int remote_get_threadlist (int startflag
, threadref
*nextthread
,
806 int result_limit
, int *done
, int *result_count
,
807 threadref
*threadlist
);
809 int remote_threadlist_iterator (rmt_thread_action stepfunction
,
810 void *context
, int looplimit
);
812 int remote_get_threads_with_ql (threads_listing_context
*context
);
813 int remote_get_threads_with_qxfer (threads_listing_context
*context
);
814 int remote_get_threads_with_qthreadinfo (threads_listing_context
*context
);
816 void extended_remote_restart ();
820 void remote_check_symbols ();
822 void remote_supported_packet (const struct protocol_feature
*feature
,
823 enum packet_support support
,
824 const char *argument
);
826 void remote_query_supported ();
828 void remote_packet_size (const protocol_feature
*feature
,
829 packet_support support
, const char *value
);
831 void remote_serial_quit_handler ();
833 void remote_detach_pid (int pid
);
835 void remote_vcont_probe ();
837 void remote_resume_with_hc (ptid_t ptid
, int step
,
840 void send_interrupt_sequence ();
841 void interrupt_query ();
843 void remote_notif_get_pending_events (notif_client
*nc
);
845 int fetch_register_using_p (struct regcache
*regcache
,
847 int send_g_packet ();
848 void process_g_packet (struct regcache
*regcache
);
849 void fetch_registers_using_g (struct regcache
*regcache
);
850 int store_register_using_P (const struct regcache
*regcache
,
852 void store_registers_using_G (const struct regcache
*regcache
);
854 void set_remote_traceframe ();
856 void check_binary_download (CORE_ADDR addr
);
858 target_xfer_status
remote_write_bytes_aux (const char *header
,
860 const gdb_byte
*myaddr
,
863 ULONGEST
*xfered_len_units
,
867 target_xfer_status
remote_write_bytes (CORE_ADDR memaddr
,
868 const gdb_byte
*myaddr
, ULONGEST len
,
869 int unit_size
, ULONGEST
*xfered_len
);
871 target_xfer_status
remote_read_bytes_1 (CORE_ADDR memaddr
, gdb_byte
*myaddr
,
873 int unit_size
, ULONGEST
*xfered_len_units
);
875 target_xfer_status
remote_xfer_live_readonly_partial (gdb_byte
*readbuf
,
879 ULONGEST
*xfered_len
);
881 target_xfer_status
remote_read_bytes (CORE_ADDR memaddr
,
882 gdb_byte
*myaddr
, ULONGEST len
,
884 ULONGEST
*xfered_len
);
886 packet_result
remote_send_printf (const char *format
, ...)
887 ATTRIBUTE_PRINTF (2, 3);
889 target_xfer_status
remote_flash_write (ULONGEST address
,
890 ULONGEST length
, ULONGEST
*xfered_len
,
891 const gdb_byte
*data
);
893 int readchar (int timeout
);
895 void remote_serial_write (const char *str
, int len
);
897 int putpkt (const char *buf
);
898 int putpkt_binary (const char *buf
, int cnt
);
900 int putpkt (const gdb::char_vector
&buf
)
902 return putpkt (buf
.data ());
906 long read_frame (gdb::char_vector
*buf_p
);
907 void getpkt (gdb::char_vector
*buf
, int forever
);
908 int getpkt_or_notif_sane_1 (gdb::char_vector
*buf
, int forever
,
909 int expecting_notif
, int *is_notif
);
910 int getpkt_sane (gdb::char_vector
*buf
, int forever
);
911 int getpkt_or_notif_sane (gdb::char_vector
*buf
, int forever
,
913 int remote_vkill (int pid
);
914 void remote_kill_k ();
916 void extended_remote_disable_randomization (int val
);
917 int extended_remote_run (const std::string
&args
);
919 void send_environment_packet (const char *action
,
923 void extended_remote_environment_support ();
924 void extended_remote_set_inferior_cwd ();
926 target_xfer_status
remote_write_qxfer (const char *object_name
,
928 const gdb_byte
*writebuf
,
929 ULONGEST offset
, LONGEST len
,
930 ULONGEST
*xfered_len
,
931 struct packet_config
*packet
);
933 target_xfer_status
remote_read_qxfer (const char *object_name
,
935 gdb_byte
*readbuf
, ULONGEST offset
,
937 ULONGEST
*xfered_len
,
938 struct packet_config
*packet
);
940 void push_stop_reply (struct stop_reply
*new_event
);
942 bool vcont_r_supported ();
944 void packet_command (const char *args
, int from_tty
);
946 private: /* data fields */
948 /* The remote state. Don't reference this directly. Use the
949 get_remote_state method instead. */
950 remote_state m_remote_state
;
953 static const target_info extended_remote_target_info
= {
955 N_("Extended remote serial target in gdb-specific protocol"),
959 /* Set up the extended remote target by extending the standard remote
960 target and adding to it. */
962 class extended_remote_target final
: public remote_target
965 const target_info
&info () const override
966 { return extended_remote_target_info
; }
968 /* Open an extended-remote connection. */
969 static void open (const char *, int);
971 bool can_create_inferior () override
{ return true; }
972 void create_inferior (const char *, const std::string
&,
973 char **, int) override
;
975 void detach (inferior
*, int) override
;
977 bool can_attach () override
{ return true; }
978 void attach (const char *, int) override
;
980 void post_attach (int) override
;
981 bool supports_disable_randomization () override
;
984 /* Per-program-space data key. */
985 static const struct program_space_key
<char, gdb::xfree_deleter
<char>>
988 /* The variable registered as the control variable used by the
989 remote exec-file commands. While the remote exec-file setting is
990 per-program-space, the set/show machinery uses this as the
991 location of the remote exec-file value. */
992 static char *remote_exec_file_var
;
994 /* The size to align memory write packets, when practical. The protocol
995 does not guarantee any alignment, and gdb will generate short
996 writes and unaligned writes, but even as a best-effort attempt this
997 can improve bulk transfers. For instance, if a write is misaligned
998 relative to the target's data bus, the stub may need to make an extra
999 round trip fetching data from the target. This doesn't make a
1000 huge difference, but it's easy to do, so we try to be helpful.
1002 The alignment chosen is arbitrary; usually data bus width is
1003 important here, not the possibly larger cache line size. */
1004 enum { REMOTE_ALIGN_WRITES
= 16 };
1006 /* Prototypes for local functions. */
1008 static int hexnumlen (ULONGEST num
);
1010 static int stubhex (int ch
);
1012 static int hexnumstr (char *, ULONGEST
);
1014 static int hexnumnstr (char *, ULONGEST
, int);
1016 static CORE_ADDR
remote_address_masked (CORE_ADDR
);
1018 static void print_packet (const char *);
1020 static int stub_unpack_int (const char *buff
, int fieldlength
);
1022 struct packet_config
;
1024 static void show_packet_config_cmd (struct packet_config
*config
);
1026 static void show_remote_protocol_packet_cmd (struct ui_file
*file
,
1028 struct cmd_list_element
*c
,
1031 static ptid_t
read_ptid (const char *buf
, const char **obuf
);
1033 static void remote_async_inferior_event_handler (gdb_client_data
);
1035 static bool remote_read_description_p (struct target_ops
*target
);
1037 static void remote_console_output (const char *msg
);
1039 static void remote_btrace_reset (remote_state
*rs
);
1041 static void remote_unpush_and_throw (remote_target
*target
);
1045 static struct cmd_list_element
*remote_cmdlist
;
1047 /* For "set remote" and "show remote". */
1049 static struct cmd_list_element
*remote_set_cmdlist
;
1050 static struct cmd_list_element
*remote_show_cmdlist
;
1052 /* Controls whether GDB is willing to use range stepping. */
1054 static bool use_range_stepping
= true;
1056 /* From the remote target's point of view, each thread is in one of these three
1058 enum class resume_state
1060 /* Not resumed - we haven't been asked to resume this thread. */
1063 /* We have been asked to resume this thread, but haven't sent a vCont action
1064 for it yet. We'll need to consider it next time commit_resume is
1066 RESUMED_PENDING_VCONT
,
1068 /* We have been asked to resume this thread, and we have sent a vCont action
1073 /* Information about a thread's pending vCont-resume. Used when a thread is in
1074 the remote_resume_state::RESUMED_PENDING_VCONT state. remote_target::resume
1075 stores this information which is then picked up by
1076 remote_target::commit_resume to know which is the proper action for this
1077 thread to include in the vCont packet. */
1078 struct resumed_pending_vcont_info
1080 /* True if the last resume call for this thread was a step request, false
1081 if a continue request. */
1084 /* The signal specified in the last resume call for this thread. */
1088 /* Private data that we'll store in (struct thread_info)->priv. */
1089 struct remote_thread_info
: public private_thread_info
1095 /* Thread handle, perhaps a pthread_t or thread_t value, stored as a
1096 sequence of bytes. */
1097 gdb::byte_vector thread_handle
;
1099 /* Whether the target stopped for a breakpoint/watchpoint. */
1100 enum target_stop_reason stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
1102 /* This is set to the data address of the access causing the target
1103 to stop for a watchpoint. */
1104 CORE_ADDR watch_data_address
= 0;
1106 /* Get the thread's resume state. */
1107 enum resume_state
resume_state () const
1109 return m_resume_state
;
1112 /* Put the thread in the NOT_RESUMED state. */
1113 void set_not_resumed ()
1115 m_resume_state
= resume_state::NOT_RESUMED
;
1118 /* Put the thread in the RESUMED_PENDING_VCONT state. */
1119 void set_resumed_pending_vcont (bool step
, gdb_signal sig
)
1121 m_resume_state
= resume_state::RESUMED_PENDING_VCONT
;
1122 m_resumed_pending_vcont_info
.step
= step
;
1123 m_resumed_pending_vcont_info
.sig
= sig
;
1126 /* Get the information this thread's pending vCont-resumption.
1128 Must only be called if the thread is in the RESUMED_PENDING_VCONT resume
1130 const struct resumed_pending_vcont_info
&resumed_pending_vcont_info () const
1132 gdb_assert (m_resume_state
== resume_state::RESUMED_PENDING_VCONT
);
1134 return m_resumed_pending_vcont_info
;
1137 /* Put the thread in the VCONT_RESUMED state. */
1140 m_resume_state
= resume_state::RESUMED
;
1144 /* Resume state for this thread. This is used to implement vCont action
1145 coalescing (only when the target operates in non-stop mode).
1147 remote_target::resume moves the thread to the RESUMED_PENDING_VCONT state,
1148 which notes that this thread must be considered in the next commit_resume
1151 remote_target::commit_resume sends a vCont packet with actions for the
1152 threads in the RESUMED_PENDING_VCONT state and moves them to the
1153 VCONT_RESUMED state.
1155 When reporting a stop to the core for a thread, that thread is moved back
1156 to the NOT_RESUMED state. */
1157 enum resume_state m_resume_state
= resume_state::NOT_RESUMED
;
1159 /* Extra info used if the thread is in the RESUMED_PENDING_VCONT state. */
1160 struct resumed_pending_vcont_info m_resumed_pending_vcont_info
;
1163 remote_state::remote_state ()
1168 remote_state::~remote_state ()
1170 xfree (this->last_pass_packet
);
1171 xfree (this->last_program_signals_packet
);
1172 xfree (this->finished_object
);
1173 xfree (this->finished_annex
);
1176 /* Utility: generate error from an incoming stub packet. */
1178 trace_error (char *buf
)
1181 return; /* not an error msg */
1184 case '1': /* malformed packet error */
1185 if (*++buf
== '0') /* general case: */
1186 error (_("remote.c: error in outgoing packet."));
1188 error (_("remote.c: error in outgoing packet at field #%ld."),
1189 strtol (buf
, NULL
, 16));
1191 error (_("Target returns error code '%s'."), buf
);
1195 /* Utility: wait for reply from stub, while accepting "O" packets. */
1198 remote_target::remote_get_noisy_reply ()
1200 struct remote_state
*rs
= get_remote_state ();
1202 do /* Loop on reply from remote stub. */
1206 QUIT
; /* Allow user to bail out with ^C. */
1207 getpkt (&rs
->buf
, 0);
1208 buf
= rs
->buf
.data ();
1211 else if (startswith (buf
, "qRelocInsn:"))
1214 CORE_ADDR from
, to
, org_to
;
1216 int adjusted_size
= 0;
1219 p
= buf
+ strlen ("qRelocInsn:");
1220 pp
= unpack_varlen_hex (p
, &ul
);
1222 error (_("invalid qRelocInsn packet: %s"), buf
);
1226 unpack_varlen_hex (p
, &ul
);
1233 gdbarch_relocate_instruction (target_gdbarch (), &to
, from
);
1236 catch (const gdb_exception
&ex
)
1238 if (ex
.error
== MEMORY_ERROR
)
1240 /* Propagate memory errors silently back to the
1241 target. The stub may have limited the range of
1242 addresses we can write to, for example. */
1246 /* Something unexpectedly bad happened. Be verbose
1247 so we can tell what, and propagate the error back
1248 to the stub, so it doesn't get stuck waiting for
1250 exception_fprintf (gdb_stderr
, ex
,
1251 _("warning: relocating instruction: "));
1258 adjusted_size
= to
- org_to
;
1260 xsnprintf (buf
, rs
->buf
.size (), "qRelocInsn:%x", adjusted_size
);
1264 else if (buf
[0] == 'O' && buf
[1] != 'K')
1265 remote_console_output (buf
+ 1); /* 'O' message from stub */
1267 return buf
; /* Here's the actual reply. */
1272 struct remote_arch_state
*
1273 remote_state::get_remote_arch_state (struct gdbarch
*gdbarch
)
1275 remote_arch_state
*rsa
;
1277 auto it
= this->m_arch_states
.find (gdbarch
);
1278 if (it
== this->m_arch_states
.end ())
1280 auto p
= this->m_arch_states
.emplace (std::piecewise_construct
,
1281 std::forward_as_tuple (gdbarch
),
1282 std::forward_as_tuple (gdbarch
));
1283 rsa
= &p
.first
->second
;
1285 /* Make sure that the packet buffer is plenty big enough for
1286 this architecture. */
1287 if (this->buf
.size () < rsa
->remote_packet_size
)
1288 this->buf
.resize (2 * rsa
->remote_packet_size
);
1296 /* Fetch the global remote target state. */
1299 remote_target::get_remote_state ()
1301 /* Make sure that the remote architecture state has been
1302 initialized, because doing so might reallocate rs->buf. Any
1303 function which calls getpkt also needs to be mindful of changes
1304 to rs->buf, but this call limits the number of places which run
1306 m_remote_state
.get_remote_arch_state (target_gdbarch ());
1308 return &m_remote_state
;
1311 /* Fetch the remote exec-file from the current program space. */
1314 get_remote_exec_file (void)
1316 char *remote_exec_file
;
1318 remote_exec_file
= remote_pspace_data
.get (current_program_space
);
1319 if (remote_exec_file
== NULL
)
1322 return remote_exec_file
;
1325 /* Set the remote exec file for PSPACE. */
1328 set_pspace_remote_exec_file (struct program_space
*pspace
,
1329 const char *remote_exec_file
)
1331 char *old_file
= remote_pspace_data
.get (pspace
);
1334 remote_pspace_data
.set (pspace
, xstrdup (remote_exec_file
));
1337 /* The "set/show remote exec-file" set command hook. */
1340 set_remote_exec_file (const char *ignored
, int from_tty
,
1341 struct cmd_list_element
*c
)
1343 gdb_assert (remote_exec_file_var
!= NULL
);
1344 set_pspace_remote_exec_file (current_program_space
, remote_exec_file_var
);
1347 /* The "set/show remote exec-file" show command hook. */
1350 show_remote_exec_file (struct ui_file
*file
, int from_tty
,
1351 struct cmd_list_element
*cmd
, const char *value
)
1353 fprintf_filtered (file
, "%s\n", get_remote_exec_file ());
1357 map_regcache_remote_table (struct gdbarch
*gdbarch
, struct packet_reg
*regs
)
1359 int regnum
, num_remote_regs
, offset
;
1360 struct packet_reg
**remote_regs
;
1362 for (regnum
= 0; regnum
< gdbarch_num_regs (gdbarch
); regnum
++)
1364 struct packet_reg
*r
= ®s
[regnum
];
1366 if (register_size (gdbarch
, regnum
) == 0)
1367 /* Do not try to fetch zero-sized (placeholder) registers. */
1370 r
->pnum
= gdbarch_remote_register_number (gdbarch
, regnum
);
1375 /* Define the g/G packet format as the contents of each register
1376 with a remote protocol number, in order of ascending protocol
1379 remote_regs
= XALLOCAVEC (struct packet_reg
*, gdbarch_num_regs (gdbarch
));
1380 for (num_remote_regs
= 0, regnum
= 0;
1381 regnum
< gdbarch_num_regs (gdbarch
);
1383 if (regs
[regnum
].pnum
!= -1)
1384 remote_regs
[num_remote_regs
++] = ®s
[regnum
];
1386 std::sort (remote_regs
, remote_regs
+ num_remote_regs
,
1387 [] (const packet_reg
*a
, const packet_reg
*b
)
1388 { return a
->pnum
< b
->pnum
; });
1390 for (regnum
= 0, offset
= 0; regnum
< num_remote_regs
; regnum
++)
1392 remote_regs
[regnum
]->in_g_packet
= 1;
1393 remote_regs
[regnum
]->offset
= offset
;
1394 offset
+= register_size (gdbarch
, remote_regs
[regnum
]->regnum
);
1400 /* Given the architecture described by GDBARCH, return the remote
1401 protocol register's number and the register's offset in the g/G
1402 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
1403 If the target does not have a mapping for REGNUM, return false,
1404 otherwise, return true. */
1407 remote_register_number_and_offset (struct gdbarch
*gdbarch
, int regnum
,
1408 int *pnum
, int *poffset
)
1410 gdb_assert (regnum
< gdbarch_num_regs (gdbarch
));
1412 std::vector
<packet_reg
> regs (gdbarch_num_regs (gdbarch
));
1414 map_regcache_remote_table (gdbarch
, regs
.data ());
1416 *pnum
= regs
[regnum
].pnum
;
1417 *poffset
= regs
[regnum
].offset
;
1422 remote_arch_state::remote_arch_state (struct gdbarch
*gdbarch
)
1424 /* Use the architecture to build a regnum<->pnum table, which will be
1425 1:1 unless a feature set specifies otherwise. */
1426 this->regs
.reset (new packet_reg
[gdbarch_num_regs (gdbarch
)] ());
1428 /* Record the maximum possible size of the g packet - it may turn out
1430 this->sizeof_g_packet
1431 = map_regcache_remote_table (gdbarch
, this->regs
.get ());
1433 /* Default maximum number of characters in a packet body. Many
1434 remote stubs have a hardwired buffer size of 400 bytes
1435 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
1436 as the maximum packet-size to ensure that the packet and an extra
1437 NUL character can always fit in the buffer. This stops GDB
1438 trashing stubs that try to squeeze an extra NUL into what is
1439 already a full buffer (As of 1999-12-04 that was most stubs). */
1440 this->remote_packet_size
= 400 - 1;
1442 /* This one is filled in when a ``g'' packet is received. */
1443 this->actual_register_packet_size
= 0;
1445 /* Should rsa->sizeof_g_packet needs more space than the
1446 default, adjust the size accordingly. Remember that each byte is
1447 encoded as two characters. 32 is the overhead for the packet
1448 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
1449 (``$NN:G...#NN'') is a better guess, the below has been padded a
1451 if (this->sizeof_g_packet
> ((this->remote_packet_size
- 32) / 2))
1452 this->remote_packet_size
= (this->sizeof_g_packet
* 2 + 32);
1455 /* Get a pointer to the current remote target. If not connected to a
1456 remote target, return NULL. */
1458 static remote_target
*
1459 get_current_remote_target ()
1461 target_ops
*proc_target
= current_inferior ()->process_target ();
1462 return dynamic_cast<remote_target
*> (proc_target
);
1465 /* Return the current allowed size of a remote packet. This is
1466 inferred from the current architecture, and should be used to
1467 limit the length of outgoing packets. */
1469 remote_target::get_remote_packet_size ()
1471 struct remote_state
*rs
= get_remote_state ();
1472 remote_arch_state
*rsa
= rs
->get_remote_arch_state (target_gdbarch ());
1474 if (rs
->explicit_packet_size
)
1475 return rs
->explicit_packet_size
;
1477 return rsa
->remote_packet_size
;
1480 static struct packet_reg
*
1481 packet_reg_from_regnum (struct gdbarch
*gdbarch
, struct remote_arch_state
*rsa
,
1484 if (regnum
< 0 && regnum
>= gdbarch_num_regs (gdbarch
))
1488 struct packet_reg
*r
= &rsa
->regs
[regnum
];
1490 gdb_assert (r
->regnum
== regnum
);
1495 static struct packet_reg
*
1496 packet_reg_from_pnum (struct gdbarch
*gdbarch
, struct remote_arch_state
*rsa
,
1501 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
1503 struct packet_reg
*r
= &rsa
->regs
[i
];
1505 if (r
->pnum
== pnum
)
1511 /* Allow the user to specify what sequence to send to the remote
1512 when he requests a program interruption: Although ^C is usually
1513 what remote systems expect (this is the default, here), it is
1514 sometimes preferable to send a break. On other systems such
1515 as the Linux kernel, a break followed by g, which is Magic SysRq g
1516 is required in order to interrupt the execution. */
1517 const char interrupt_sequence_control_c
[] = "Ctrl-C";
1518 const char interrupt_sequence_break
[] = "BREAK";
1519 const char interrupt_sequence_break_g
[] = "BREAK-g";
1520 static const char *const interrupt_sequence_modes
[] =
1522 interrupt_sequence_control_c
,
1523 interrupt_sequence_break
,
1524 interrupt_sequence_break_g
,
1527 static const char *interrupt_sequence_mode
= interrupt_sequence_control_c
;
1530 show_interrupt_sequence (struct ui_file
*file
, int from_tty
,
1531 struct cmd_list_element
*c
,
1534 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
1535 fprintf_filtered (file
,
1536 _("Send the ASCII ETX character (Ctrl-c) "
1537 "to the remote target to interrupt the "
1538 "execution of the program.\n"));
1539 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
1540 fprintf_filtered (file
,
1541 _("send a break signal to the remote target "
1542 "to interrupt the execution of the program.\n"));
1543 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
1544 fprintf_filtered (file
,
1545 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
1546 "the remote target to interrupt the execution "
1547 "of Linux kernel.\n"));
1549 internal_error (__FILE__
, __LINE__
,
1550 _("Invalid value for interrupt_sequence_mode: %s."),
1551 interrupt_sequence_mode
);
1554 /* This boolean variable specifies whether interrupt_sequence is sent
1555 to the remote target when gdb connects to it.
1556 This is mostly needed when you debug the Linux kernel: The Linux kernel
1557 expects BREAK g which is Magic SysRq g for connecting gdb. */
1558 static bool interrupt_on_connect
= false;
1560 /* This variable is used to implement the "set/show remotebreak" commands.
1561 Since these commands are now deprecated in favor of "set/show remote
1562 interrupt-sequence", it no longer has any effect on the code. */
1563 static bool remote_break
;
1566 set_remotebreak (const char *args
, int from_tty
, struct cmd_list_element
*c
)
1569 interrupt_sequence_mode
= interrupt_sequence_break
;
1571 interrupt_sequence_mode
= interrupt_sequence_control_c
;
1575 show_remotebreak (struct ui_file
*file
, int from_tty
,
1576 struct cmd_list_element
*c
,
1581 /* This variable sets the number of bits in an address that are to be
1582 sent in a memory ("M" or "m") packet. Normally, after stripping
1583 leading zeros, the entire address would be sent. This variable
1584 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
1585 initial implementation of remote.c restricted the address sent in
1586 memory packets to ``host::sizeof long'' bytes - (typically 32
1587 bits). Consequently, for 64 bit targets, the upper 32 bits of an
1588 address was never sent. Since fixing this bug may cause a break in
1589 some remote targets this variable is principally provided to
1590 facilitate backward compatibility. */
1592 static unsigned int remote_address_size
;
1595 /* User configurable variables for the number of characters in a
1596 memory read/write packet. MIN (rsa->remote_packet_size,
1597 rsa->sizeof_g_packet) is the default. Some targets need smaller
1598 values (fifo overruns, et.al.) and some users need larger values
1599 (speed up transfers). The variables ``preferred_*'' (the user
1600 request), ``current_*'' (what was actually set) and ``forced_*''
1601 (Positive - a soft limit, negative - a hard limit). */
1603 struct memory_packet_config
1610 /* The default max memory-write-packet-size, when the setting is
1611 "fixed". The 16k is historical. (It came from older GDB's using
1612 alloca for buffers and the knowledge (folklore?) that some hosts
1613 don't cope very well with large alloca calls.) */
1614 #define DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED 16384
1616 /* The minimum remote packet size for memory transfers. Ensures we
1617 can write at least one byte. */
1618 #define MIN_MEMORY_PACKET_SIZE 20
1620 /* Get the memory packet size, assuming it is fixed. */
1623 get_fixed_memory_packet_size (struct memory_packet_config
*config
)
1625 gdb_assert (config
->fixed_p
);
1627 if (config
->size
<= 0)
1628 return DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
;
1630 return config
->size
;
1633 /* Compute the current size of a read/write packet. Since this makes
1634 use of ``actual_register_packet_size'' the computation is dynamic. */
1637 remote_target::get_memory_packet_size (struct memory_packet_config
*config
)
1639 struct remote_state
*rs
= get_remote_state ();
1640 remote_arch_state
*rsa
= rs
->get_remote_arch_state (target_gdbarch ());
1643 if (config
->fixed_p
)
1644 what_they_get
= get_fixed_memory_packet_size (config
);
1647 what_they_get
= get_remote_packet_size ();
1648 /* Limit the packet to the size specified by the user. */
1649 if (config
->size
> 0
1650 && what_they_get
> config
->size
)
1651 what_they_get
= config
->size
;
1653 /* Limit it to the size of the targets ``g'' response unless we have
1654 permission from the stub to use a larger packet size. */
1655 if (rs
->explicit_packet_size
== 0
1656 && rsa
->actual_register_packet_size
> 0
1657 && what_they_get
> rsa
->actual_register_packet_size
)
1658 what_they_get
= rsa
->actual_register_packet_size
;
1660 if (what_they_get
< MIN_MEMORY_PACKET_SIZE
)
1661 what_they_get
= MIN_MEMORY_PACKET_SIZE
;
1663 /* Make sure there is room in the global buffer for this packet
1664 (including its trailing NUL byte). */
1665 if (rs
->buf
.size () < what_they_get
+ 1)
1666 rs
->buf
.resize (2 * what_they_get
);
1668 return what_they_get
;
1671 /* Update the size of a read/write packet. If they user wants
1672 something really big then do a sanity check. */
1675 set_memory_packet_size (const char *args
, struct memory_packet_config
*config
)
1677 int fixed_p
= config
->fixed_p
;
1678 long size
= config
->size
;
1681 error (_("Argument required (integer, `fixed' or `limited')."));
1682 else if (strcmp (args
, "hard") == 0
1683 || strcmp (args
, "fixed") == 0)
1685 else if (strcmp (args
, "soft") == 0
1686 || strcmp (args
, "limit") == 0)
1692 size
= strtoul (args
, &end
, 0);
1694 error (_("Invalid %s (bad syntax)."), config
->name
);
1696 /* Instead of explicitly capping the size of a packet to or
1697 disallowing it, the user is allowed to set the size to
1698 something arbitrarily large. */
1702 if (fixed_p
&& !config
->fixed_p
)
1704 /* So that the query shows the correct value. */
1705 long query_size
= (size
<= 0
1706 ? DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
1709 if (! query (_("The target may not be able to correctly handle a %s\n"
1710 "of %ld bytes. Change the packet size? "),
1711 config
->name
, query_size
))
1712 error (_("Packet size not changed."));
1714 /* Update the config. */
1715 config
->fixed_p
= fixed_p
;
1716 config
->size
= size
;
1720 show_memory_packet_size (struct memory_packet_config
*config
)
1722 if (config
->size
== 0)
1723 printf_filtered (_("The %s is 0 (default). "), config
->name
);
1725 printf_filtered (_("The %s is %ld. "), config
->name
, config
->size
);
1726 if (config
->fixed_p
)
1727 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
1728 get_fixed_memory_packet_size (config
));
1731 remote_target
*remote
= get_current_remote_target ();
1734 printf_filtered (_("Packets are limited to %ld bytes.\n"),
1735 remote
->get_memory_packet_size (config
));
1737 puts_filtered ("The actual limit will be further reduced "
1738 "dependent on the target.\n");
1742 /* FIXME: needs to be per-remote-target. */
1743 static struct memory_packet_config memory_write_packet_config
=
1745 "memory-write-packet-size",
1749 set_memory_write_packet_size (const char *args
, int from_tty
)
1751 set_memory_packet_size (args
, &memory_write_packet_config
);
1755 show_memory_write_packet_size (const char *args
, int from_tty
)
1757 show_memory_packet_size (&memory_write_packet_config
);
1760 /* Show the number of hardware watchpoints that can be used. */
1763 show_hardware_watchpoint_limit (struct ui_file
*file
, int from_tty
,
1764 struct cmd_list_element
*c
,
1767 fprintf_filtered (file
, _("The maximum number of target hardware "
1768 "watchpoints is %s.\n"), value
);
1771 /* Show the length limit (in bytes) for hardware watchpoints. */
1774 show_hardware_watchpoint_length_limit (struct ui_file
*file
, int from_tty
,
1775 struct cmd_list_element
*c
,
1778 fprintf_filtered (file
, _("The maximum length (in bytes) of a target "
1779 "hardware watchpoint is %s.\n"), value
);
1782 /* Show the number of hardware breakpoints that can be used. */
1785 show_hardware_breakpoint_limit (struct ui_file
*file
, int from_tty
,
1786 struct cmd_list_element
*c
,
1789 fprintf_filtered (file
, _("The maximum number of target hardware "
1790 "breakpoints is %s.\n"), value
);
1793 /* Controls the maximum number of characters to display in the debug output
1794 for each remote packet. The remaining characters are omitted. */
1796 static int remote_packet_max_chars
= 512;
1798 /* Show the maximum number of characters to display for each remote packet
1799 when remote debugging is enabled. */
1802 show_remote_packet_max_chars (struct ui_file
*file
, int from_tty
,
1803 struct cmd_list_element
*c
,
1806 fprintf_filtered (file
, _("Number of remote packet characters to "
1807 "display is %s.\n"), value
);
1811 remote_target::get_memory_write_packet_size ()
1813 return get_memory_packet_size (&memory_write_packet_config
);
1816 /* FIXME: needs to be per-remote-target. */
1817 static struct memory_packet_config memory_read_packet_config
=
1819 "memory-read-packet-size",
1823 set_memory_read_packet_size (const char *args
, int from_tty
)
1825 set_memory_packet_size (args
, &memory_read_packet_config
);
1829 show_memory_read_packet_size (const char *args
, int from_tty
)
1831 show_memory_packet_size (&memory_read_packet_config
);
1835 remote_target::get_memory_read_packet_size ()
1837 long size
= get_memory_packet_size (&memory_read_packet_config
);
1839 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1840 extra buffer size argument before the memory read size can be
1841 increased beyond this. */
1842 if (size
> get_remote_packet_size ())
1843 size
= get_remote_packet_size ();
1849 struct packet_config
1854 /* If auto, GDB auto-detects support for this packet or feature,
1855 either through qSupported, or by trying the packet and looking
1856 at the response. If true, GDB assumes the target supports this
1857 packet. If false, the packet is disabled. Configs that don't
1858 have an associated command always have this set to auto. */
1859 enum auto_boolean detect
;
1861 /* Does the target support this packet? */
1862 enum packet_support support
;
1865 static enum packet_support
packet_config_support (struct packet_config
*config
);
1866 static enum packet_support
packet_support (int packet
);
1869 show_packet_config_cmd (struct packet_config
*config
)
1871 const char *support
= "internal-error";
1873 switch (packet_config_support (config
))
1876 support
= "enabled";
1878 case PACKET_DISABLE
:
1879 support
= "disabled";
1881 case PACKET_SUPPORT_UNKNOWN
:
1882 support
= "unknown";
1885 switch (config
->detect
)
1887 case AUTO_BOOLEAN_AUTO
:
1888 printf_filtered (_("Support for the `%s' packet "
1889 "is auto-detected, currently %s.\n"),
1890 config
->name
, support
);
1892 case AUTO_BOOLEAN_TRUE
:
1893 case AUTO_BOOLEAN_FALSE
:
1894 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1895 config
->name
, support
);
1901 add_packet_config_cmd (struct packet_config
*config
, const char *name
,
1902 const char *title
, int legacy
)
1908 config
->name
= name
;
1909 config
->title
= title
;
1910 set_doc
= xstrprintf ("Set use of remote protocol `%s' (%s) packet.",
1912 show_doc
= xstrprintf ("Show current use of remote "
1913 "protocol `%s' (%s) packet.",
1915 /* set/show TITLE-packet {auto,on,off} */
1916 cmd_name
= xstrprintf ("%s-packet", title
);
1917 add_setshow_auto_boolean_cmd (cmd_name
, class_obscure
,
1918 &config
->detect
, set_doc
,
1919 show_doc
, NULL
, /* help_doc */
1921 show_remote_protocol_packet_cmd
,
1922 &remote_set_cmdlist
, &remote_show_cmdlist
);
1923 /* The command code copies the documentation strings. */
1926 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1931 legacy_name
= xstrprintf ("%s-packet", name
);
1932 add_alias_cmd (legacy_name
, cmd_name
, class_obscure
, 0,
1933 &remote_set_cmdlist
);
1934 add_alias_cmd (legacy_name
, cmd_name
, class_obscure
, 0,
1935 &remote_show_cmdlist
);
1939 static enum packet_result
1940 packet_check_result (const char *buf
)
1944 /* The stub recognized the packet request. Check that the
1945 operation succeeded. */
1947 && isxdigit (buf
[1]) && isxdigit (buf
[2])
1949 /* "Enn" - definitely an error. */
1950 return PACKET_ERROR
;
1952 /* Always treat "E." as an error. This will be used for
1953 more verbose error messages, such as E.memtypes. */
1954 if (buf
[0] == 'E' && buf
[1] == '.')
1955 return PACKET_ERROR
;
1957 /* The packet may or may not be OK. Just assume it is. */
1961 /* The stub does not support the packet. */
1962 return PACKET_UNKNOWN
;
1965 static enum packet_result
1966 packet_check_result (const gdb::char_vector
&buf
)
1968 return packet_check_result (buf
.data ());
1971 static enum packet_result
1972 packet_ok (const char *buf
, struct packet_config
*config
)
1974 enum packet_result result
;
1976 if (config
->detect
!= AUTO_BOOLEAN_TRUE
1977 && config
->support
== PACKET_DISABLE
)
1978 internal_error (__FILE__
, __LINE__
,
1979 _("packet_ok: attempt to use a disabled packet"));
1981 result
= packet_check_result (buf
);
1986 /* The stub recognized the packet request. */
1987 if (config
->support
== PACKET_SUPPORT_UNKNOWN
)
1990 fprintf_unfiltered (gdb_stdlog
,
1991 "Packet %s (%s) is supported\n",
1992 config
->name
, config
->title
);
1993 config
->support
= PACKET_ENABLE
;
1996 case PACKET_UNKNOWN
:
1997 /* The stub does not support the packet. */
1998 if (config
->detect
== AUTO_BOOLEAN_AUTO
1999 && config
->support
== PACKET_ENABLE
)
2001 /* If the stub previously indicated that the packet was
2002 supported then there is a protocol error. */
2003 error (_("Protocol error: %s (%s) conflicting enabled responses."),
2004 config
->name
, config
->title
);
2006 else if (config
->detect
== AUTO_BOOLEAN_TRUE
)
2008 /* The user set it wrong. */
2009 error (_("Enabled packet %s (%s) not recognized by stub"),
2010 config
->name
, config
->title
);
2014 fprintf_unfiltered (gdb_stdlog
,
2015 "Packet %s (%s) is NOT supported\n",
2016 config
->name
, config
->title
);
2017 config
->support
= PACKET_DISABLE
;
2024 static enum packet_result
2025 packet_ok (const gdb::char_vector
&buf
, struct packet_config
*config
)
2027 return packet_ok (buf
.data (), config
);
2044 PACKET_vFile_pwrite
,
2046 PACKET_vFile_unlink
,
2047 PACKET_vFile_readlink
,
2050 PACKET_qXfer_features
,
2051 PACKET_qXfer_exec_file
,
2052 PACKET_qXfer_libraries
,
2053 PACKET_qXfer_libraries_svr4
,
2054 PACKET_qXfer_memory_map
,
2055 PACKET_qXfer_osdata
,
2056 PACKET_qXfer_threads
,
2057 PACKET_qXfer_statictrace_read
,
2058 PACKET_qXfer_traceframe_info
,
2064 PACKET_QPassSignals
,
2065 PACKET_QCatchSyscalls
,
2066 PACKET_QProgramSignals
,
2067 PACKET_QSetWorkingDir
,
2068 PACKET_QStartupWithShell
,
2069 PACKET_QEnvironmentHexEncoded
,
2070 PACKET_QEnvironmentReset
,
2071 PACKET_QEnvironmentUnset
,
2073 PACKET_qSearch_memory
,
2076 PACKET_QStartNoAckMode
,
2078 PACKET_qXfer_siginfo_read
,
2079 PACKET_qXfer_siginfo_write
,
2082 /* Support for conditional tracepoints. */
2083 PACKET_ConditionalTracepoints
,
2085 /* Support for target-side breakpoint conditions. */
2086 PACKET_ConditionalBreakpoints
,
2088 /* Support for target-side breakpoint commands. */
2089 PACKET_BreakpointCommands
,
2091 /* Support for fast tracepoints. */
2092 PACKET_FastTracepoints
,
2094 /* Support for static tracepoints. */
2095 PACKET_StaticTracepoints
,
2097 /* Support for installing tracepoints while a trace experiment is
2099 PACKET_InstallInTrace
,
2103 PACKET_TracepointSource
,
2106 PACKET_QDisableRandomization
,
2108 PACKET_QTBuffer_size
,
2112 PACKET_qXfer_btrace
,
2114 /* Support for the QNonStop packet. */
2117 /* Support for the QThreadEvents packet. */
2118 PACKET_QThreadEvents
,
2120 /* Support for multi-process extensions. */
2121 PACKET_multiprocess_feature
,
2123 /* Support for enabling and disabling tracepoints while a trace
2124 experiment is running. */
2125 PACKET_EnableDisableTracepoints_feature
,
2127 /* Support for collecting strings using the tracenz bytecode. */
2128 PACKET_tracenz_feature
,
2130 /* Support for continuing to run a trace experiment while GDB is
2132 PACKET_DisconnectedTracing_feature
,
2134 /* Support for qXfer:libraries-svr4:read with a non-empty annex. */
2135 PACKET_augmented_libraries_svr4_read_feature
,
2137 /* Support for the qXfer:btrace-conf:read packet. */
2138 PACKET_qXfer_btrace_conf
,
2140 /* Support for the Qbtrace-conf:bts:size packet. */
2141 PACKET_Qbtrace_conf_bts_size
,
2143 /* Support for swbreak+ feature. */
2144 PACKET_swbreak_feature
,
2146 /* Support for hwbreak+ feature. */
2147 PACKET_hwbreak_feature
,
2149 /* Support for fork events. */
2150 PACKET_fork_event_feature
,
2152 /* Support for vfork events. */
2153 PACKET_vfork_event_feature
,
2155 /* Support for the Qbtrace-conf:pt:size packet. */
2156 PACKET_Qbtrace_conf_pt_size
,
2158 /* Support for exec events. */
2159 PACKET_exec_event_feature
,
2161 /* Support for query supported vCont actions. */
2162 PACKET_vContSupported
,
2164 /* Support remote CTRL-C. */
2167 /* Support TARGET_WAITKIND_NO_RESUMED. */
2173 /* FIXME: needs to be per-remote-target. Ignoring this for now,
2174 assuming all remote targets are the same server (thus all support
2175 the same packets). */
2176 static struct packet_config remote_protocol_packets
[PACKET_MAX
];
2178 /* Returns the packet's corresponding "set remote foo-packet" command
2179 state. See struct packet_config for more details. */
2181 static enum auto_boolean
2182 packet_set_cmd_state (int packet
)
2184 return remote_protocol_packets
[packet
].detect
;
2187 /* Returns whether a given packet or feature is supported. This takes
2188 into account the state of the corresponding "set remote foo-packet"
2189 command, which may be used to bypass auto-detection. */
2191 static enum packet_support
2192 packet_config_support (struct packet_config
*config
)
2194 switch (config
->detect
)
2196 case AUTO_BOOLEAN_TRUE
:
2197 return PACKET_ENABLE
;
2198 case AUTO_BOOLEAN_FALSE
:
2199 return PACKET_DISABLE
;
2200 case AUTO_BOOLEAN_AUTO
:
2201 return config
->support
;
2203 gdb_assert_not_reached (_("bad switch"));
2207 /* Same as packet_config_support, but takes the packet's enum value as
2210 static enum packet_support
2211 packet_support (int packet
)
2213 struct packet_config
*config
= &remote_protocol_packets
[packet
];
2215 return packet_config_support (config
);
2219 show_remote_protocol_packet_cmd (struct ui_file
*file
, int from_tty
,
2220 struct cmd_list_element
*c
,
2223 struct packet_config
*packet
;
2225 for (packet
= remote_protocol_packets
;
2226 packet
< &remote_protocol_packets
[PACKET_MAX
];
2229 if (&packet
->detect
== c
->var
)
2231 show_packet_config_cmd (packet
);
2235 internal_error (__FILE__
, __LINE__
, _("Could not find config for %s"),
2239 /* Should we try one of the 'Z' requests? */
2243 Z_PACKET_SOFTWARE_BP
,
2244 Z_PACKET_HARDWARE_BP
,
2251 /* For compatibility with older distributions. Provide a ``set remote
2252 Z-packet ...'' command that updates all the Z packet types. */
2254 static enum auto_boolean remote_Z_packet_detect
;
2257 set_remote_protocol_Z_packet_cmd (const char *args
, int from_tty
,
2258 struct cmd_list_element
*c
)
2262 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
2263 remote_protocol_packets
[PACKET_Z0
+ i
].detect
= remote_Z_packet_detect
;
2267 show_remote_protocol_Z_packet_cmd (struct ui_file
*file
, int from_tty
,
2268 struct cmd_list_element
*c
,
2273 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
2275 show_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
+ i
]);
2279 /* Returns true if the multi-process extensions are in effect. */
2282 remote_multi_process_p (struct remote_state
*rs
)
2284 return packet_support (PACKET_multiprocess_feature
) == PACKET_ENABLE
;
2287 /* Returns true if fork events are supported. */
2290 remote_fork_event_p (struct remote_state
*rs
)
2292 return packet_support (PACKET_fork_event_feature
) == PACKET_ENABLE
;
2295 /* Returns true if vfork events are supported. */
2298 remote_vfork_event_p (struct remote_state
*rs
)
2300 return packet_support (PACKET_vfork_event_feature
) == PACKET_ENABLE
;
2303 /* Returns true if exec events are supported. */
2306 remote_exec_event_p (struct remote_state
*rs
)
2308 return packet_support (PACKET_exec_event_feature
) == PACKET_ENABLE
;
2311 /* Insert fork catchpoint target routine. If fork events are enabled
2312 then return success, nothing more to do. */
2315 remote_target::insert_fork_catchpoint (int pid
)
2317 struct remote_state
*rs
= get_remote_state ();
2319 return !remote_fork_event_p (rs
);
2322 /* Remove fork catchpoint target routine. Nothing to do, just
2326 remote_target::remove_fork_catchpoint (int pid
)
2331 /* Insert vfork catchpoint target routine. If vfork events are enabled
2332 then return success, nothing more to do. */
2335 remote_target::insert_vfork_catchpoint (int pid
)
2337 struct remote_state
*rs
= get_remote_state ();
2339 return !remote_vfork_event_p (rs
);
2342 /* Remove vfork catchpoint target routine. Nothing to do, just
2346 remote_target::remove_vfork_catchpoint (int pid
)
2351 /* Insert exec catchpoint target routine. If exec events are
2352 enabled, just return success. */
2355 remote_target::insert_exec_catchpoint (int pid
)
2357 struct remote_state
*rs
= get_remote_state ();
2359 return !remote_exec_event_p (rs
);
2362 /* Remove exec catchpoint target routine. Nothing to do, just
2366 remote_target::remove_exec_catchpoint (int pid
)
2373 /* Take advantage of the fact that the TID field is not used, to tag
2374 special ptids with it set to != 0. */
2375 static const ptid_t
magic_null_ptid (42000, -1, 1);
2376 static const ptid_t
not_sent_ptid (42000, -2, 1);
2377 static const ptid_t
any_thread_ptid (42000, 0, 1);
2379 /* Find out if the stub attached to PID (and hence GDB should offer to
2380 detach instead of killing it when bailing out). */
2383 remote_target::remote_query_attached (int pid
)
2385 struct remote_state
*rs
= get_remote_state ();
2386 size_t size
= get_remote_packet_size ();
2388 if (packet_support (PACKET_qAttached
) == PACKET_DISABLE
)
2391 if (remote_multi_process_p (rs
))
2392 xsnprintf (rs
->buf
.data (), size
, "qAttached:%x", pid
);
2394 xsnprintf (rs
->buf
.data (), size
, "qAttached");
2397 getpkt (&rs
->buf
, 0);
2399 switch (packet_ok (rs
->buf
,
2400 &remote_protocol_packets
[PACKET_qAttached
]))
2403 if (strcmp (rs
->buf
.data (), "1") == 0)
2407 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
2409 case PACKET_UNKNOWN
:
2416 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
2417 has been invented by GDB, instead of reported by the target. Since
2418 we can be connected to a remote system before before knowing about
2419 any inferior, mark the target with execution when we find the first
2420 inferior. If ATTACHED is 1, then we had just attached to this
2421 inferior. If it is 0, then we just created this inferior. If it
2422 is -1, then try querying the remote stub to find out if it had
2423 attached to the inferior or not. If TRY_OPEN_EXEC is true then
2424 attempt to open this inferior's executable as the main executable
2425 if no main executable is open already. */
2428 remote_target::remote_add_inferior (bool fake_pid_p
, int pid
, int attached
,
2431 struct inferior
*inf
;
2433 /* Check whether this process we're learning about is to be
2434 considered attached, or if is to be considered to have been
2435 spawned by the stub. */
2437 attached
= remote_query_attached (pid
);
2439 if (gdbarch_has_global_solist (target_gdbarch ()))
2441 /* If the target shares code across all inferiors, then every
2442 attach adds a new inferior. */
2443 inf
= add_inferior (pid
);
2445 /* ... and every inferior is bound to the same program space.
2446 However, each inferior may still have its own address
2448 inf
->aspace
= maybe_new_address_space ();
2449 inf
->pspace
= current_program_space
;
2453 /* In the traditional debugging scenario, there's a 1-1 match
2454 between program/address spaces. We simply bind the inferior
2455 to the program space's address space. */
2456 inf
= current_inferior ();
2458 /* However, if the current inferior is already bound to a
2459 process, find some other empty inferior. */
2463 for (inferior
*it
: all_inferiors ())
2472 /* Since all inferiors were already bound to a process, add
2474 inf
= add_inferior_with_spaces ();
2476 switch_to_inferior_no_thread (inf
);
2478 inferior_appeared (inf
, pid
);
2481 inf
->attach_flag
= attached
;
2482 inf
->fake_pid_p
= fake_pid_p
;
2484 /* If no main executable is currently open then attempt to
2485 open the file that was executed to create this inferior. */
2486 if (try_open_exec
&& get_exec_file (0) == NULL
)
2487 exec_file_locate_attach (pid
, 0, 1);
2489 /* Check for exec file mismatch, and let the user solve it. */
2490 validate_exec_file (1);
2495 static remote_thread_info
*get_remote_thread_info (thread_info
*thread
);
2496 static remote_thread_info
*get_remote_thread_info (remote_target
*target
,
2499 /* Add thread PTID to GDB's thread list. Tag it as executing/running
2500 according to RUNNING. */
2503 remote_target::remote_add_thread (ptid_t ptid
, bool running
, bool executing
)
2505 struct remote_state
*rs
= get_remote_state ();
2506 struct thread_info
*thread
;
2508 /* GDB historically didn't pull threads in the initial connection
2509 setup. If the remote target doesn't even have a concept of
2510 threads (e.g., a bare-metal target), even if internally we
2511 consider that a single-threaded target, mentioning a new thread
2512 might be confusing to the user. Be silent then, preserving the
2513 age old behavior. */
2514 if (rs
->starting_up
)
2515 thread
= add_thread_silent (this, ptid
);
2517 thread
= add_thread (this, ptid
);
2519 /* We start by assuming threads are resumed. That state then gets updated
2520 when we process a matching stop reply. */
2521 get_remote_thread_info (thread
)->set_resumed ();
2523 set_executing (this, ptid
, executing
);
2524 set_running (this, ptid
, running
);
2529 /* Come here when we learn about a thread id from the remote target.
2530 It may be the first time we hear about such thread, so take the
2531 opportunity to add it to GDB's thread list. In case this is the
2532 first time we're noticing its corresponding inferior, add it to
2533 GDB's inferior list as well. EXECUTING indicates whether the
2534 thread is (internally) executing or stopped. */
2537 remote_target::remote_notice_new_inferior (ptid_t currthread
, int executing
)
2539 /* In non-stop mode, we assume new found threads are (externally)
2540 running until proven otherwise with a stop reply. In all-stop,
2541 we can only get here if all threads are stopped. */
2542 int running
= target_is_non_stop_p () ? 1 : 0;
2544 /* If this is a new thread, add it to GDB's thread list.
2545 If we leave it up to WFI to do this, bad things will happen. */
2547 thread_info
*tp
= find_thread_ptid (this, currthread
);
2548 if (tp
!= NULL
&& tp
->state
== THREAD_EXITED
)
2550 /* We're seeing an event on a thread id we knew had exited.
2551 This has to be a new thread reusing the old id. Add it. */
2552 remote_add_thread (currthread
, running
, executing
);
2556 if (!in_thread_list (this, currthread
))
2558 struct inferior
*inf
= NULL
;
2559 int pid
= currthread
.pid ();
2561 if (inferior_ptid
.is_pid ()
2562 && pid
== inferior_ptid
.pid ())
2564 /* inferior_ptid has no thread member yet. This can happen
2565 with the vAttach -> remote_wait,"TAAthread:" path if the
2566 stub doesn't support qC. This is the first stop reported
2567 after an attach, so this is the main thread. Update the
2568 ptid in the thread list. */
2569 if (in_thread_list (this, ptid_t (pid
)))
2570 thread_change_ptid (this, inferior_ptid
, currthread
);
2574 = remote_add_thread (currthread
, running
, executing
);
2575 switch_to_thread (thr
);
2580 if (magic_null_ptid
== inferior_ptid
)
2582 /* inferior_ptid is not set yet. This can happen with the
2583 vRun -> remote_wait,"TAAthread:" path if the stub
2584 doesn't support qC. This is the first stop reported
2585 after an attach, so this is the main thread. Update the
2586 ptid in the thread list. */
2587 thread_change_ptid (this, inferior_ptid
, currthread
);
2591 /* When connecting to a target remote, or to a target
2592 extended-remote which already was debugging an inferior, we
2593 may not know about it yet. Add it before adding its child
2594 thread, so notifications are emitted in a sensible order. */
2595 if (find_inferior_pid (this, currthread
.pid ()) == NULL
)
2597 struct remote_state
*rs
= get_remote_state ();
2598 bool fake_pid_p
= !remote_multi_process_p (rs
);
2600 inf
= remote_add_inferior (fake_pid_p
,
2601 currthread
.pid (), -1, 1);
2604 /* This is really a new thread. Add it. */
2605 thread_info
*new_thr
2606 = remote_add_thread (currthread
, running
, executing
);
2608 /* If we found a new inferior, let the common code do whatever
2609 it needs to with it (e.g., read shared libraries, insert
2610 breakpoints), unless we're just setting up an all-stop
2614 struct remote_state
*rs
= get_remote_state ();
2616 if (!rs
->starting_up
)
2617 notice_new_inferior (new_thr
, executing
, 0);
2622 /* Return THREAD's private thread data, creating it if necessary. */
2624 static remote_thread_info
*
2625 get_remote_thread_info (thread_info
*thread
)
2627 gdb_assert (thread
!= NULL
);
2629 if (thread
->priv
== NULL
)
2630 thread
->priv
.reset (new remote_thread_info
);
2632 return static_cast<remote_thread_info
*> (thread
->priv
.get ());
2635 /* Return PTID's private thread data, creating it if necessary. */
2637 static remote_thread_info
*
2638 get_remote_thread_info (remote_target
*target
, ptid_t ptid
)
2640 thread_info
*thr
= find_thread_ptid (target
, ptid
);
2641 return get_remote_thread_info (thr
);
2644 /* Call this function as a result of
2645 1) A halt indication (T packet) containing a thread id
2646 2) A direct query of currthread
2647 3) Successful execution of set thread */
2650 record_currthread (struct remote_state
*rs
, ptid_t currthread
)
2652 rs
->general_thread
= currthread
;
2655 /* If 'QPassSignals' is supported, tell the remote stub what signals
2656 it can simply pass through to the inferior without reporting. */
2659 remote_target::pass_signals (gdb::array_view
<const unsigned char> pass_signals
)
2661 if (packet_support (PACKET_QPassSignals
) != PACKET_DISABLE
)
2663 char *pass_packet
, *p
;
2665 struct remote_state
*rs
= get_remote_state ();
2667 gdb_assert (pass_signals
.size () < 256);
2668 for (size_t i
= 0; i
< pass_signals
.size (); i
++)
2670 if (pass_signals
[i
])
2673 pass_packet
= (char *) xmalloc (count
* 3 + strlen ("QPassSignals:") + 1);
2674 strcpy (pass_packet
, "QPassSignals:");
2675 p
= pass_packet
+ strlen (pass_packet
);
2676 for (size_t i
= 0; i
< pass_signals
.size (); i
++)
2678 if (pass_signals
[i
])
2681 *p
++ = tohex (i
>> 4);
2682 *p
++ = tohex (i
& 15);
2691 if (!rs
->last_pass_packet
|| strcmp (rs
->last_pass_packet
, pass_packet
))
2693 putpkt (pass_packet
);
2694 getpkt (&rs
->buf
, 0);
2695 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QPassSignals
]);
2696 xfree (rs
->last_pass_packet
);
2697 rs
->last_pass_packet
= pass_packet
;
2700 xfree (pass_packet
);
2704 /* If 'QCatchSyscalls' is supported, tell the remote stub
2705 to report syscalls to GDB. */
2708 remote_target::set_syscall_catchpoint (int pid
, bool needed
, int any_count
,
2709 gdb::array_view
<const int> syscall_counts
)
2711 const char *catch_packet
;
2712 enum packet_result result
;
2715 if (packet_support (PACKET_QCatchSyscalls
) == PACKET_DISABLE
)
2717 /* Not supported. */
2721 if (needed
&& any_count
== 0)
2723 /* Count how many syscalls are to be caught. */
2724 for (size_t i
= 0; i
< syscall_counts
.size (); i
++)
2726 if (syscall_counts
[i
] != 0)
2733 fprintf_unfiltered (gdb_stdlog
,
2734 "remote_set_syscall_catchpoint "
2735 "pid %d needed %d any_count %d n_sysno %d\n",
2736 pid
, needed
, any_count
, n_sysno
);
2739 std::string built_packet
;
2742 /* Prepare a packet with the sysno list, assuming max 8+1
2743 characters for a sysno. If the resulting packet size is too
2744 big, fallback on the non-selective packet. */
2745 const int maxpktsz
= strlen ("QCatchSyscalls:1") + n_sysno
* 9 + 1;
2746 built_packet
.reserve (maxpktsz
);
2747 built_packet
= "QCatchSyscalls:1";
2750 /* Add in each syscall to be caught. */
2751 for (size_t i
= 0; i
< syscall_counts
.size (); i
++)
2753 if (syscall_counts
[i
] != 0)
2754 string_appendf (built_packet
, ";%zx", i
);
2757 if (built_packet
.size () > get_remote_packet_size ())
2759 /* catch_packet too big. Fallback to less efficient
2760 non selective mode, with GDB doing the filtering. */
2761 catch_packet
= "QCatchSyscalls:1";
2764 catch_packet
= built_packet
.c_str ();
2767 catch_packet
= "QCatchSyscalls:0";
2769 struct remote_state
*rs
= get_remote_state ();
2771 putpkt (catch_packet
);
2772 getpkt (&rs
->buf
, 0);
2773 result
= packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QCatchSyscalls
]);
2774 if (result
== PACKET_OK
)
2780 /* If 'QProgramSignals' is supported, tell the remote stub what
2781 signals it should pass through to the inferior when detaching. */
2784 remote_target::program_signals (gdb::array_view
<const unsigned char> signals
)
2786 if (packet_support (PACKET_QProgramSignals
) != PACKET_DISABLE
)
2790 struct remote_state
*rs
= get_remote_state ();
2792 gdb_assert (signals
.size () < 256);
2793 for (size_t i
= 0; i
< signals
.size (); i
++)
2798 packet
= (char *) xmalloc (count
* 3 + strlen ("QProgramSignals:") + 1);
2799 strcpy (packet
, "QProgramSignals:");
2800 p
= packet
+ strlen (packet
);
2801 for (size_t i
= 0; i
< signals
.size (); i
++)
2803 if (signal_pass_state (i
))
2806 *p
++ = tohex (i
>> 4);
2807 *p
++ = tohex (i
& 15);
2816 if (!rs
->last_program_signals_packet
2817 || strcmp (rs
->last_program_signals_packet
, packet
) != 0)
2820 getpkt (&rs
->buf
, 0);
2821 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QProgramSignals
]);
2822 xfree (rs
->last_program_signals_packet
);
2823 rs
->last_program_signals_packet
= packet
;
2830 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
2831 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
2832 thread. If GEN is set, set the general thread, if not, then set
2833 the step/continue thread. */
2835 remote_target::set_thread (ptid_t ptid
, int gen
)
2837 struct remote_state
*rs
= get_remote_state ();
2838 ptid_t state
= gen
? rs
->general_thread
: rs
->continue_thread
;
2839 char *buf
= rs
->buf
.data ();
2840 char *endbuf
= buf
+ get_remote_packet_size ();
2846 *buf
++ = gen
? 'g' : 'c';
2847 if (ptid
== magic_null_ptid
)
2848 xsnprintf (buf
, endbuf
- buf
, "0");
2849 else if (ptid
== any_thread_ptid
)
2850 xsnprintf (buf
, endbuf
- buf
, "0");
2851 else if (ptid
== minus_one_ptid
)
2852 xsnprintf (buf
, endbuf
- buf
, "-1");
2854 write_ptid (buf
, endbuf
, ptid
);
2856 getpkt (&rs
->buf
, 0);
2858 rs
->general_thread
= ptid
;
2860 rs
->continue_thread
= ptid
;
2864 remote_target::set_general_thread (ptid_t ptid
)
2866 set_thread (ptid
, 1);
2870 remote_target::set_continue_thread (ptid_t ptid
)
2872 set_thread (ptid
, 0);
2875 /* Change the remote current process. Which thread within the process
2876 ends up selected isn't important, as long as it is the same process
2877 as what INFERIOR_PTID points to.
2879 This comes from that fact that there is no explicit notion of
2880 "selected process" in the protocol. The selected process for
2881 general operations is the process the selected general thread
2885 remote_target::set_general_process ()
2887 struct remote_state
*rs
= get_remote_state ();
2889 /* If the remote can't handle multiple processes, don't bother. */
2890 if (!remote_multi_process_p (rs
))
2893 /* We only need to change the remote current thread if it's pointing
2894 at some other process. */
2895 if (rs
->general_thread
.pid () != inferior_ptid
.pid ())
2896 set_general_thread (inferior_ptid
);
2900 /* Return nonzero if this is the main thread that we made up ourselves
2901 to model non-threaded targets as single-threaded. */
2904 remote_thread_always_alive (ptid_t ptid
)
2906 if (ptid
== magic_null_ptid
)
2907 /* The main thread is always alive. */
2910 if (ptid
.pid () != 0 && ptid
.lwp () == 0)
2911 /* The main thread is always alive. This can happen after a
2912 vAttach, if the remote side doesn't support
2919 /* Return nonzero if the thread PTID is still alive on the remote
2923 remote_target::thread_alive (ptid_t ptid
)
2925 struct remote_state
*rs
= get_remote_state ();
2928 /* Check if this is a thread that we made up ourselves to model
2929 non-threaded targets as single-threaded. */
2930 if (remote_thread_always_alive (ptid
))
2933 p
= rs
->buf
.data ();
2934 endp
= p
+ get_remote_packet_size ();
2937 write_ptid (p
, endp
, ptid
);
2940 getpkt (&rs
->buf
, 0);
2941 return (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K');
2944 /* Return a pointer to a thread name if we know it and NULL otherwise.
2945 The thread_info object owns the memory for the name. */
2948 remote_target::thread_name (struct thread_info
*info
)
2950 if (info
->priv
!= NULL
)
2952 const std::string
&name
= get_remote_thread_info (info
)->name
;
2953 return !name
.empty () ? name
.c_str () : NULL
;
2959 /* About these extended threadlist and threadinfo packets. They are
2960 variable length packets but, the fields within them are often fixed
2961 length. They are redundant enough to send over UDP as is the
2962 remote protocol in general. There is a matching unit test module
2965 /* WARNING: This threadref data structure comes from the remote O.S.,
2966 libstub protocol encoding, and remote.c. It is not particularly
2969 /* Right now, the internal structure is int. We want it to be bigger.
2970 Plan to fix this. */
2972 typedef int gdb_threadref
; /* Internal GDB thread reference. */
2974 /* gdb_ext_thread_info is an internal GDB data structure which is
2975 equivalent to the reply of the remote threadinfo packet. */
2977 struct gdb_ext_thread_info
2979 threadref threadid
; /* External form of thread reference. */
2980 int active
; /* Has state interesting to GDB?
2982 char display
[256]; /* Brief state display, name,
2983 blocked/suspended. */
2984 char shortname
[32]; /* To be used to name threads. */
2985 char more_display
[256]; /* Long info, statistics, queue depth,
2989 /* The volume of remote transfers can be limited by submitting
2990 a mask containing bits specifying the desired information.
2991 Use a union of these values as the 'selection' parameter to
2992 get_thread_info. FIXME: Make these TAG names more thread specific. */
2994 #define TAG_THREADID 1
2995 #define TAG_EXISTS 2
2996 #define TAG_DISPLAY 4
2997 #define TAG_THREADNAME 8
2998 #define TAG_MOREDISPLAY 16
3000 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
3002 static const char *unpack_nibble (const char *buf
, int *val
);
3004 static const char *unpack_byte (const char *buf
, int *value
);
3006 static char *pack_int (char *buf
, int value
);
3008 static const char *unpack_int (const char *buf
, int *value
);
3010 static const char *unpack_string (const char *src
, char *dest
, int length
);
3012 static char *pack_threadid (char *pkt
, threadref
*id
);
3014 static const char *unpack_threadid (const char *inbuf
, threadref
*id
);
3016 void int_to_threadref (threadref
*id
, int value
);
3018 static int threadref_to_int (threadref
*ref
);
3020 static void copy_threadref (threadref
*dest
, threadref
*src
);
3022 static int threadmatch (threadref
*dest
, threadref
*src
);
3024 static char *pack_threadinfo_request (char *pkt
, int mode
,
3027 static char *pack_threadlist_request (char *pkt
, int startflag
,
3029 threadref
*nextthread
);
3031 static int remote_newthread_step (threadref
*ref
, void *context
);
3034 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
3035 buffer we're allowed to write to. Returns
3036 BUF+CHARACTERS_WRITTEN. */
3039 remote_target::write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
)
3042 struct remote_state
*rs
= get_remote_state ();
3044 if (remote_multi_process_p (rs
))
3048 buf
+= xsnprintf (buf
, endbuf
- buf
, "p-%x.", -pid
);
3050 buf
+= xsnprintf (buf
, endbuf
- buf
, "p%x.", pid
);
3054 buf
+= xsnprintf (buf
, endbuf
- buf
, "-%x", -tid
);
3056 buf
+= xsnprintf (buf
, endbuf
- buf
, "%x", tid
);
3061 /* Extract a PTID from BUF. If non-null, OBUF is set to one past the
3062 last parsed char. Returns null_ptid if no thread id is found, and
3063 throws an error if the thread id has an invalid format. */
3066 read_ptid (const char *buf
, const char **obuf
)
3068 const char *p
= buf
;
3070 ULONGEST pid
= 0, tid
= 0;
3074 /* Multi-process ptid. */
3075 pp
= unpack_varlen_hex (p
+ 1, &pid
);
3077 error (_("invalid remote ptid: %s"), p
);
3080 pp
= unpack_varlen_hex (p
+ 1, &tid
);
3083 return ptid_t (pid
, tid
, 0);
3086 /* No multi-process. Just a tid. */
3087 pp
= unpack_varlen_hex (p
, &tid
);
3089 /* Return null_ptid when no thread id is found. */
3097 /* Since the stub is not sending a process id, then default to
3098 what's in inferior_ptid, unless it's null at this point. If so,
3099 then since there's no way to know the pid of the reported
3100 threads, use the magic number. */
3101 if (inferior_ptid
== null_ptid
)
3102 pid
= magic_null_ptid
.pid ();
3104 pid
= inferior_ptid
.pid ();
3108 return ptid_t (pid
, tid
, 0);
3114 if (ch
>= 'a' && ch
<= 'f')
3115 return ch
- 'a' + 10;
3116 if (ch
>= '0' && ch
<= '9')
3118 if (ch
>= 'A' && ch
<= 'F')
3119 return ch
- 'A' + 10;
3124 stub_unpack_int (const char *buff
, int fieldlength
)
3131 nibble
= stubhex (*buff
++);
3135 retval
= retval
<< 4;
3141 unpack_nibble (const char *buf
, int *val
)
3143 *val
= fromhex (*buf
++);
3148 unpack_byte (const char *buf
, int *value
)
3150 *value
= stub_unpack_int (buf
, 2);
3155 pack_int (char *buf
, int value
)
3157 buf
= pack_hex_byte (buf
, (value
>> 24) & 0xff);
3158 buf
= pack_hex_byte (buf
, (value
>> 16) & 0xff);
3159 buf
= pack_hex_byte (buf
, (value
>> 8) & 0x0ff);
3160 buf
= pack_hex_byte (buf
, (value
& 0xff));
3165 unpack_int (const char *buf
, int *value
)
3167 *value
= stub_unpack_int (buf
, 8);
3171 #if 0 /* Currently unused, uncomment when needed. */
3172 static char *pack_string (char *pkt
, char *string
);
3175 pack_string (char *pkt
, char *string
)
3180 len
= strlen (string
);
3182 len
= 200; /* Bigger than most GDB packets, junk??? */
3183 pkt
= pack_hex_byte (pkt
, len
);
3187 if ((ch
== '\0') || (ch
== '#'))
3188 ch
= '*'; /* Protect encapsulation. */
3193 #endif /* 0 (unused) */
3196 unpack_string (const char *src
, char *dest
, int length
)
3205 pack_threadid (char *pkt
, threadref
*id
)
3208 unsigned char *altid
;
3210 altid
= (unsigned char *) id
;
3211 limit
= pkt
+ BUF_THREAD_ID_SIZE
;
3213 pkt
= pack_hex_byte (pkt
, *altid
++);
3219 unpack_threadid (const char *inbuf
, threadref
*id
)
3222 const char *limit
= inbuf
+ BUF_THREAD_ID_SIZE
;
3225 altref
= (char *) id
;
3227 while (inbuf
< limit
)
3229 x
= stubhex (*inbuf
++);
3230 y
= stubhex (*inbuf
++);
3231 *altref
++ = (x
<< 4) | y
;
3236 /* Externally, threadrefs are 64 bits but internally, they are still
3237 ints. This is due to a mismatch of specifications. We would like
3238 to use 64bit thread references internally. This is an adapter
3242 int_to_threadref (threadref
*id
, int value
)
3244 unsigned char *scan
;
3246 scan
= (unsigned char *) id
;
3252 *scan
++ = (value
>> 24) & 0xff;
3253 *scan
++ = (value
>> 16) & 0xff;
3254 *scan
++ = (value
>> 8) & 0xff;
3255 *scan
++ = (value
& 0xff);
3259 threadref_to_int (threadref
*ref
)
3262 unsigned char *scan
;
3268 value
= (value
<< 8) | ((*scan
++) & 0xff);
3273 copy_threadref (threadref
*dest
, threadref
*src
)
3276 unsigned char *csrc
, *cdest
;
3278 csrc
= (unsigned char *) src
;
3279 cdest
= (unsigned char *) dest
;
3286 threadmatch (threadref
*dest
, threadref
*src
)
3288 /* Things are broken right now, so just assume we got a match. */
3290 unsigned char *srcp
, *destp
;
3292 srcp
= (char *) src
;
3293 destp
= (char *) dest
;
3297 result
&= (*srcp
++ == *destp
++) ? 1 : 0;
3304 threadid:1, # always request threadid
3311 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
3314 pack_threadinfo_request (char *pkt
, int mode
, threadref
*id
)
3316 *pkt
++ = 'q'; /* Info Query */
3317 *pkt
++ = 'P'; /* process or thread info */
3318 pkt
= pack_int (pkt
, mode
); /* mode */
3319 pkt
= pack_threadid (pkt
, id
); /* threadid */
3320 *pkt
= '\0'; /* terminate */
3324 /* These values tag the fields in a thread info response packet. */
3325 /* Tagging the fields allows us to request specific fields and to
3326 add more fields as time goes by. */
3328 #define TAG_THREADID 1 /* Echo the thread identifier. */
3329 #define TAG_EXISTS 2 /* Is this process defined enough to
3330 fetch registers and its stack? */
3331 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
3332 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
3333 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
3337 remote_target::remote_unpack_thread_info_response (const char *pkt
,
3338 threadref
*expectedref
,
3339 gdb_ext_thread_info
*info
)
3341 struct remote_state
*rs
= get_remote_state ();
3345 const char *limit
= pkt
+ rs
->buf
.size (); /* Plausible parsing limit. */
3348 /* info->threadid = 0; FIXME: implement zero_threadref. */
3350 info
->display
[0] = '\0';
3351 info
->shortname
[0] = '\0';
3352 info
->more_display
[0] = '\0';
3354 /* Assume the characters indicating the packet type have been
3356 pkt
= unpack_int (pkt
, &mask
); /* arg mask */
3357 pkt
= unpack_threadid (pkt
, &ref
);
3360 warning (_("Incomplete response to threadinfo request."));
3361 if (!threadmatch (&ref
, expectedref
))
3362 { /* This is an answer to a different request. */
3363 warning (_("ERROR RMT Thread info mismatch."));
3366 copy_threadref (&info
->threadid
, &ref
);
3368 /* Loop on tagged fields , try to bail if something goes wrong. */
3370 /* Packets are terminated with nulls. */
3371 while ((pkt
< limit
) && mask
&& *pkt
)
3373 pkt
= unpack_int (pkt
, &tag
); /* tag */
3374 pkt
= unpack_byte (pkt
, &length
); /* length */
3375 if (!(tag
& mask
)) /* Tags out of synch with mask. */
3377 warning (_("ERROR RMT: threadinfo tag mismatch."));
3381 if (tag
== TAG_THREADID
)
3385 warning (_("ERROR RMT: length of threadid is not 16."));
3389 pkt
= unpack_threadid (pkt
, &ref
);
3390 mask
= mask
& ~TAG_THREADID
;
3393 if (tag
== TAG_EXISTS
)
3395 info
->active
= stub_unpack_int (pkt
, length
);
3397 mask
= mask
& ~(TAG_EXISTS
);
3400 warning (_("ERROR RMT: 'exists' length too long."));
3406 if (tag
== TAG_THREADNAME
)
3408 pkt
= unpack_string (pkt
, &info
->shortname
[0], length
);
3409 mask
= mask
& ~TAG_THREADNAME
;
3412 if (tag
== TAG_DISPLAY
)
3414 pkt
= unpack_string (pkt
, &info
->display
[0], length
);
3415 mask
= mask
& ~TAG_DISPLAY
;
3418 if (tag
== TAG_MOREDISPLAY
)
3420 pkt
= unpack_string (pkt
, &info
->more_display
[0], length
);
3421 mask
= mask
& ~TAG_MOREDISPLAY
;
3424 warning (_("ERROR RMT: unknown thread info tag."));
3425 break; /* Not a tag we know about. */
3431 remote_target::remote_get_threadinfo (threadref
*threadid
,
3433 gdb_ext_thread_info
*info
)
3435 struct remote_state
*rs
= get_remote_state ();
3438 pack_threadinfo_request (rs
->buf
.data (), fieldset
, threadid
);
3440 getpkt (&rs
->buf
, 0);
3442 if (rs
->buf
[0] == '\0')
3445 result
= remote_unpack_thread_info_response (&rs
->buf
[2],
3450 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
3453 pack_threadlist_request (char *pkt
, int startflag
, int threadcount
,
3454 threadref
*nextthread
)
3456 *pkt
++ = 'q'; /* info query packet */
3457 *pkt
++ = 'L'; /* Process LIST or threadLIST request */
3458 pkt
= pack_nibble (pkt
, startflag
); /* initflag 1 bytes */
3459 pkt
= pack_hex_byte (pkt
, threadcount
); /* threadcount 2 bytes */
3460 pkt
= pack_threadid (pkt
, nextthread
); /* 64 bit thread identifier */
3465 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
3468 remote_target::parse_threadlist_response (const char *pkt
, int result_limit
,
3469 threadref
*original_echo
,
3470 threadref
*resultlist
,
3473 struct remote_state
*rs
= get_remote_state ();
3474 int count
, resultcount
, done
;
3477 /* Assume the 'q' and 'M chars have been stripped. */
3478 const char *limit
= pkt
+ (rs
->buf
.size () - BUF_THREAD_ID_SIZE
);
3479 /* done parse past here */
3480 pkt
= unpack_byte (pkt
, &count
); /* count field */
3481 pkt
= unpack_nibble (pkt
, &done
);
3482 /* The first threadid is the argument threadid. */
3483 pkt
= unpack_threadid (pkt
, original_echo
); /* should match query packet */
3484 while ((count
-- > 0) && (pkt
< limit
))
3486 pkt
= unpack_threadid (pkt
, resultlist
++);
3487 if (resultcount
++ >= result_limit
)
3495 /* Fetch the next batch of threads from the remote. Returns -1 if the
3496 qL packet is not supported, 0 on error and 1 on success. */
3499 remote_target::remote_get_threadlist (int startflag
, threadref
*nextthread
,
3500 int result_limit
, int *done
, int *result_count
,
3501 threadref
*threadlist
)
3503 struct remote_state
*rs
= get_remote_state ();
3506 /* Truncate result limit to be smaller than the packet size. */
3507 if ((((result_limit
+ 1) * BUF_THREAD_ID_SIZE
) + 10)
3508 >= get_remote_packet_size ())
3509 result_limit
= (get_remote_packet_size () / BUF_THREAD_ID_SIZE
) - 2;
3511 pack_threadlist_request (rs
->buf
.data (), startflag
, result_limit
,
3514 getpkt (&rs
->buf
, 0);
3515 if (rs
->buf
[0] == '\0')
3517 /* Packet not supported. */
3522 parse_threadlist_response (&rs
->buf
[2], result_limit
,
3523 &rs
->echo_nextthread
, threadlist
, done
);
3525 if (!threadmatch (&rs
->echo_nextthread
, nextthread
))
3527 /* FIXME: This is a good reason to drop the packet. */
3528 /* Possibly, there is a duplicate response. */
3530 retransmit immediatly - race conditions
3531 retransmit after timeout - yes
3533 wait for packet, then exit
3535 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
3536 return 0; /* I choose simply exiting. */
3538 if (*result_count
<= 0)
3542 warning (_("RMT ERROR : failed to get remote thread list."));
3545 return result
; /* break; */
3547 if (*result_count
> result_limit
)
3550 warning (_("RMT ERROR: threadlist response longer than requested."));
3556 /* Fetch the list of remote threads, with the qL packet, and call
3557 STEPFUNCTION for each thread found. Stops iterating and returns 1
3558 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
3559 STEPFUNCTION returns false. If the packet is not supported,
3563 remote_target::remote_threadlist_iterator (rmt_thread_action stepfunction
,
3564 void *context
, int looplimit
)
3566 struct remote_state
*rs
= get_remote_state ();
3567 int done
, i
, result_count
;
3575 if (loopcount
++ > looplimit
)
3578 warning (_("Remote fetch threadlist -infinite loop-."));
3581 result
= remote_get_threadlist (startflag
, &rs
->nextthread
,
3582 MAXTHREADLISTRESULTS
,
3583 &done
, &result_count
,
3584 rs
->resultthreadlist
);
3587 /* Clear for later iterations. */
3589 /* Setup to resume next batch of thread references, set nextthread. */
3590 if (result_count
>= 1)
3591 copy_threadref (&rs
->nextthread
,
3592 &rs
->resultthreadlist
[result_count
- 1]);
3594 while (result_count
--)
3596 if (!(*stepfunction
) (&rs
->resultthreadlist
[i
++], context
))
3606 /* A thread found on the remote target. */
3610 explicit thread_item (ptid_t ptid_
)
3614 thread_item (thread_item
&&other
) = default;
3615 thread_item
&operator= (thread_item
&&other
) = default;
3617 DISABLE_COPY_AND_ASSIGN (thread_item
);
3619 /* The thread's PTID. */
3622 /* The thread's extra info. */
3625 /* The thread's name. */
3628 /* The core the thread was running on. -1 if not known. */
3631 /* The thread handle associated with the thread. */
3632 gdb::byte_vector thread_handle
;
3635 /* Context passed around to the various methods listing remote
3636 threads. As new threads are found, they're added to the ITEMS
3639 struct threads_listing_context
3641 /* Return true if this object contains an entry for a thread with ptid
3644 bool contains_thread (ptid_t ptid
) const
3646 auto match_ptid
= [&] (const thread_item
&item
)
3648 return item
.ptid
== ptid
;
3651 auto it
= std::find_if (this->items
.begin (),
3655 return it
!= this->items
.end ();
3658 /* Remove the thread with ptid PTID. */
3660 void remove_thread (ptid_t ptid
)
3662 auto match_ptid
= [&] (const thread_item
&item
)
3664 return item
.ptid
== ptid
;
3667 auto it
= std::remove_if (this->items
.begin (),
3671 if (it
!= this->items
.end ())
3672 this->items
.erase (it
);
3675 /* The threads found on the remote target. */
3676 std::vector
<thread_item
> items
;
3680 remote_newthread_step (threadref
*ref
, void *data
)
3682 struct threads_listing_context
*context
3683 = (struct threads_listing_context
*) data
;
3684 int pid
= inferior_ptid
.pid ();
3685 int lwp
= threadref_to_int (ref
);
3686 ptid_t
ptid (pid
, lwp
);
3688 context
->items
.emplace_back (ptid
);
3690 return 1; /* continue iterator */
3693 #define CRAZY_MAX_THREADS 1000
3696 remote_target::remote_current_thread (ptid_t oldpid
)
3698 struct remote_state
*rs
= get_remote_state ();
3701 getpkt (&rs
->buf
, 0);
3702 if (rs
->buf
[0] == 'Q' && rs
->buf
[1] == 'C')
3707 result
= read_ptid (&rs
->buf
[2], &obuf
);
3708 if (*obuf
!= '\0' && remote_debug
)
3709 fprintf_unfiltered (gdb_stdlog
,
3710 "warning: garbage in qC reply\n");
3718 /* List remote threads using the deprecated qL packet. */
3721 remote_target::remote_get_threads_with_ql (threads_listing_context
*context
)
3723 if (remote_threadlist_iterator (remote_newthread_step
, context
,
3724 CRAZY_MAX_THREADS
) >= 0)
3730 #if defined(HAVE_LIBEXPAT)
3733 start_thread (struct gdb_xml_parser
*parser
,
3734 const struct gdb_xml_element
*element
,
3736 std::vector
<gdb_xml_value
> &attributes
)
3738 struct threads_listing_context
*data
3739 = (struct threads_listing_context
*) user_data
;
3740 struct gdb_xml_value
*attr
;
3742 char *id
= (char *) xml_find_attribute (attributes
, "id")->value
.get ();
3743 ptid_t ptid
= read_ptid (id
, NULL
);
3745 data
->items
.emplace_back (ptid
);
3746 thread_item
&item
= data
->items
.back ();
3748 attr
= xml_find_attribute (attributes
, "core");
3750 item
.core
= *(ULONGEST
*) attr
->value
.get ();
3752 attr
= xml_find_attribute (attributes
, "name");
3754 item
.name
= (const char *) attr
->value
.get ();
3756 attr
= xml_find_attribute (attributes
, "handle");
3758 item
.thread_handle
= hex2bin ((const char *) attr
->value
.get ());
3762 end_thread (struct gdb_xml_parser
*parser
,
3763 const struct gdb_xml_element
*element
,
3764 void *user_data
, const char *body_text
)
3766 struct threads_listing_context
*data
3767 = (struct threads_listing_context
*) user_data
;
3769 if (body_text
!= NULL
&& *body_text
!= '\0')
3770 data
->items
.back ().extra
= body_text
;
3773 const struct gdb_xml_attribute thread_attributes
[] = {
3774 { "id", GDB_XML_AF_NONE
, NULL
, NULL
},
3775 { "core", GDB_XML_AF_OPTIONAL
, gdb_xml_parse_attr_ulongest
, NULL
},
3776 { "name", GDB_XML_AF_OPTIONAL
, NULL
, NULL
},
3777 { "handle", GDB_XML_AF_OPTIONAL
, NULL
, NULL
},
3778 { NULL
, GDB_XML_AF_NONE
, NULL
, NULL
}
3781 const struct gdb_xml_element thread_children
[] = {
3782 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3785 const struct gdb_xml_element threads_children
[] = {
3786 { "thread", thread_attributes
, thread_children
,
3787 GDB_XML_EF_REPEATABLE
| GDB_XML_EF_OPTIONAL
,
3788 start_thread
, end_thread
},
3789 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3792 const struct gdb_xml_element threads_elements
[] = {
3793 { "threads", NULL
, threads_children
,
3794 GDB_XML_EF_NONE
, NULL
, NULL
},
3795 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3800 /* List remote threads using qXfer:threads:read. */
3803 remote_target::remote_get_threads_with_qxfer (threads_listing_context
*context
)
3805 #if defined(HAVE_LIBEXPAT)
3806 if (packet_support (PACKET_qXfer_threads
) == PACKET_ENABLE
)
3808 gdb::optional
<gdb::char_vector
> xml
3809 = target_read_stralloc (this, TARGET_OBJECT_THREADS
, NULL
);
3811 if (xml
&& (*xml
)[0] != '\0')
3813 gdb_xml_parse_quick (_("threads"), "threads.dtd",
3814 threads_elements
, xml
->data (), context
);
3824 /* List remote threads using qfThreadInfo/qsThreadInfo. */
3827 remote_target::remote_get_threads_with_qthreadinfo (threads_listing_context
*context
)
3829 struct remote_state
*rs
= get_remote_state ();
3831 if (rs
->use_threadinfo_query
)
3835 putpkt ("qfThreadInfo");
3836 getpkt (&rs
->buf
, 0);
3837 bufp
= rs
->buf
.data ();
3838 if (bufp
[0] != '\0') /* q packet recognized */
3840 while (*bufp
++ == 'm') /* reply contains one or more TID */
3844 ptid_t ptid
= read_ptid (bufp
, &bufp
);
3845 context
->items
.emplace_back (ptid
);
3847 while (*bufp
++ == ','); /* comma-separated list */
3848 putpkt ("qsThreadInfo");
3849 getpkt (&rs
->buf
, 0);
3850 bufp
= rs
->buf
.data ();
3856 /* Packet not recognized. */
3857 rs
->use_threadinfo_query
= 0;
3864 /* Return true if INF only has one non-exited thread. */
3867 has_single_non_exited_thread (inferior
*inf
)
3870 for (thread_info
*tp ATTRIBUTE_UNUSED
: inf
->non_exited_threads ())
3876 /* Implement the to_update_thread_list function for the remote
3880 remote_target::update_thread_list ()
3882 struct threads_listing_context context
;
3885 /* We have a few different mechanisms to fetch the thread list. Try
3886 them all, starting with the most preferred one first, falling
3887 back to older methods. */
3888 if (remote_get_threads_with_qxfer (&context
)
3889 || remote_get_threads_with_qthreadinfo (&context
)
3890 || remote_get_threads_with_ql (&context
))
3894 if (context
.items
.empty ()
3895 && remote_thread_always_alive (inferior_ptid
))
3897 /* Some targets don't really support threads, but still
3898 reply an (empty) thread list in response to the thread
3899 listing packets, instead of replying "packet not
3900 supported". Exit early so we don't delete the main
3905 /* CONTEXT now holds the current thread list on the remote
3906 target end. Delete GDB-side threads no longer found on the
3908 for (thread_info
*tp
: all_threads_safe ())
3910 if (tp
->inf
->process_target () != this)
3913 if (!context
.contains_thread (tp
->ptid
))
3915 /* Do not remove the thread if it is the last thread in
3916 the inferior. This situation happens when we have a
3917 pending exit process status to process. Otherwise we
3918 may end up with a seemingly live inferior (i.e. pid
3919 != 0) that has no threads. */
3920 if (has_single_non_exited_thread (tp
->inf
))
3928 /* Remove any unreported fork child threads from CONTEXT so
3929 that we don't interfere with follow fork, which is where
3930 creation of such threads is handled. */
3931 remove_new_fork_children (&context
);
3933 /* And now add threads we don't know about yet to our list. */
3934 for (thread_item
&item
: context
.items
)
3936 if (item
.ptid
!= null_ptid
)
3938 /* In non-stop mode, we assume new found threads are
3939 executing until proven otherwise with a stop reply.
3940 In all-stop, we can only get here if all threads are
3942 int executing
= target_is_non_stop_p () ? 1 : 0;
3944 remote_notice_new_inferior (item
.ptid
, executing
);
3946 thread_info
*tp
= find_thread_ptid (this, item
.ptid
);
3947 remote_thread_info
*info
= get_remote_thread_info (tp
);
3948 info
->core
= item
.core
;
3949 info
->extra
= std::move (item
.extra
);
3950 info
->name
= std::move (item
.name
);
3951 info
->thread_handle
= std::move (item
.thread_handle
);
3958 /* If no thread listing method is supported, then query whether
3959 each known thread is alive, one by one, with the T packet.
3960 If the target doesn't support threads at all, then this is a
3961 no-op. See remote_thread_alive. */
3967 * Collect a descriptive string about the given thread.
3968 * The target may say anything it wants to about the thread
3969 * (typically info about its blocked / runnable state, name, etc.).
3970 * This string will appear in the info threads display.
3972 * Optional: targets are not required to implement this function.
3976 remote_target::extra_thread_info (thread_info
*tp
)
3978 struct remote_state
*rs
= get_remote_state ();
3981 struct gdb_ext_thread_info threadinfo
;
3983 if (rs
->remote_desc
== 0) /* paranoia */
3984 internal_error (__FILE__
, __LINE__
,
3985 _("remote_threads_extra_info"));
3987 if (tp
->ptid
== magic_null_ptid
3988 || (tp
->ptid
.pid () != 0 && tp
->ptid
.lwp () == 0))
3989 /* This is the main thread which was added by GDB. The remote
3990 server doesn't know about it. */
3993 std::string
&extra
= get_remote_thread_info (tp
)->extra
;
3995 /* If already have cached info, use it. */
3996 if (!extra
.empty ())
3997 return extra
.c_str ();
3999 if (packet_support (PACKET_qXfer_threads
) == PACKET_ENABLE
)
4001 /* If we're using qXfer:threads:read, then the extra info is
4002 included in the XML. So if we didn't have anything cached,
4003 it's because there's really no extra info. */
4007 if (rs
->use_threadextra_query
)
4009 char *b
= rs
->buf
.data ();
4010 char *endb
= b
+ get_remote_packet_size ();
4012 xsnprintf (b
, endb
- b
, "qThreadExtraInfo,");
4014 write_ptid (b
, endb
, tp
->ptid
);
4017 getpkt (&rs
->buf
, 0);
4018 if (rs
->buf
[0] != 0)
4020 extra
.resize (strlen (rs
->buf
.data ()) / 2);
4021 hex2bin (rs
->buf
.data (), (gdb_byte
*) &extra
[0], extra
.size ());
4022 return extra
.c_str ();
4026 /* If the above query fails, fall back to the old method. */
4027 rs
->use_threadextra_query
= 0;
4028 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
4029 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
4030 int_to_threadref (&id
, tp
->ptid
.lwp ());
4031 if (remote_get_threadinfo (&id
, set
, &threadinfo
))
4032 if (threadinfo
.active
)
4034 if (*threadinfo
.shortname
)
4035 string_appendf (extra
, " Name: %s", threadinfo
.shortname
);
4036 if (*threadinfo
.display
)
4038 if (!extra
.empty ())
4040 string_appendf (extra
, " State: %s", threadinfo
.display
);
4042 if (*threadinfo
.more_display
)
4044 if (!extra
.empty ())
4046 string_appendf (extra
, " Priority: %s", threadinfo
.more_display
);
4048 return extra
.c_str ();
4055 remote_target::static_tracepoint_marker_at (CORE_ADDR addr
,
4056 struct static_tracepoint_marker
*marker
)
4058 struct remote_state
*rs
= get_remote_state ();
4059 char *p
= rs
->buf
.data ();
4061 xsnprintf (p
, get_remote_packet_size (), "qTSTMat:");
4063 p
+= hexnumstr (p
, addr
);
4065 getpkt (&rs
->buf
, 0);
4066 p
= rs
->buf
.data ();
4069 error (_("Remote failure reply: %s"), p
);
4073 parse_static_tracepoint_marker_definition (p
, NULL
, marker
);
4080 std::vector
<static_tracepoint_marker
>
4081 remote_target::static_tracepoint_markers_by_strid (const char *strid
)
4083 struct remote_state
*rs
= get_remote_state ();
4084 std::vector
<static_tracepoint_marker
> markers
;
4086 static_tracepoint_marker marker
;
4088 /* Ask for a first packet of static tracepoint marker
4091 getpkt (&rs
->buf
, 0);
4092 p
= rs
->buf
.data ();
4094 error (_("Remote failure reply: %s"), p
);
4100 parse_static_tracepoint_marker_definition (p
, &p
, &marker
);
4102 if (strid
== NULL
|| marker
.str_id
== strid
)
4103 markers
.push_back (std::move (marker
));
4105 while (*p
++ == ','); /* comma-separated list */
4106 /* Ask for another packet of static tracepoint definition. */
4108 getpkt (&rs
->buf
, 0);
4109 p
= rs
->buf
.data ();
4116 /* Implement the to_get_ada_task_ptid function for the remote targets. */
4119 remote_target::get_ada_task_ptid (long lwp
, long thread
)
4121 return ptid_t (inferior_ptid
.pid (), lwp
, 0);
4125 /* Restart the remote side; this is an extended protocol operation. */
4128 remote_target::extended_remote_restart ()
4130 struct remote_state
*rs
= get_remote_state ();
4132 /* Send the restart command; for reasons I don't understand the
4133 remote side really expects a number after the "R". */
4134 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "R%x", 0);
4137 remote_fileio_reset ();
4140 /* Clean up connection to a remote debugger. */
4143 remote_target::close ()
4145 /* Make sure we leave stdin registered in the event loop. */
4148 trace_reset_local_state ();
4153 remote_target::~remote_target ()
4155 struct remote_state
*rs
= get_remote_state ();
4157 /* Check for NULL because we may get here with a partially
4158 constructed target/connection. */
4159 if (rs
->remote_desc
== nullptr)
4162 serial_close (rs
->remote_desc
);
4164 /* We are destroying the remote target, so we should discard
4165 everything of this target. */
4166 discard_pending_stop_replies_in_queue ();
4168 if (rs
->remote_async_inferior_event_token
)
4169 delete_async_event_handler (&rs
->remote_async_inferior_event_token
);
4171 delete rs
->notif_state
;
4174 /* Query the remote side for the text, data and bss offsets. */
4177 remote_target::get_offsets ()
4179 struct remote_state
*rs
= get_remote_state ();
4182 int lose
, num_segments
= 0, do_sections
, do_segments
;
4183 CORE_ADDR text_addr
, data_addr
, bss_addr
, segments
[2];
4185 if (current_program_space
->symfile_object_file
== NULL
)
4188 putpkt ("qOffsets");
4189 getpkt (&rs
->buf
, 0);
4190 buf
= rs
->buf
.data ();
4192 if (buf
[0] == '\000')
4193 return; /* Return silently. Stub doesn't support
4197 warning (_("Remote failure reply: %s"), buf
);
4201 /* Pick up each field in turn. This used to be done with scanf, but
4202 scanf will make trouble if CORE_ADDR size doesn't match
4203 conversion directives correctly. The following code will work
4204 with any size of CORE_ADDR. */
4205 text_addr
= data_addr
= bss_addr
= 0;
4209 if (startswith (ptr
, "Text="))
4212 /* Don't use strtol, could lose on big values. */
4213 while (*ptr
&& *ptr
!= ';')
4214 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
4216 if (startswith (ptr
, ";Data="))
4219 while (*ptr
&& *ptr
!= ';')
4220 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
4225 if (!lose
&& startswith (ptr
, ";Bss="))
4228 while (*ptr
&& *ptr
!= ';')
4229 bss_addr
= (bss_addr
<< 4) + fromhex (*ptr
++);
4231 if (bss_addr
!= data_addr
)
4232 warning (_("Target reported unsupported offsets: %s"), buf
);
4237 else if (startswith (ptr
, "TextSeg="))
4240 /* Don't use strtol, could lose on big values. */
4241 while (*ptr
&& *ptr
!= ';')
4242 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
4245 if (startswith (ptr
, ";DataSeg="))
4248 while (*ptr
&& *ptr
!= ';')
4249 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
4257 error (_("Malformed response to offset query, %s"), buf
);
4258 else if (*ptr
!= '\0')
4259 warning (_("Target reported unsupported offsets: %s"), buf
);
4261 objfile
*objf
= current_program_space
->symfile_object_file
;
4262 section_offsets offs
= objf
->section_offsets
;
4264 symfile_segment_data_up data
= get_symfile_segment_data (objf
->obfd
);
4265 do_segments
= (data
!= NULL
);
4266 do_sections
= num_segments
== 0;
4268 if (num_segments
> 0)
4270 segments
[0] = text_addr
;
4271 segments
[1] = data_addr
;
4273 /* If we have two segments, we can still try to relocate everything
4274 by assuming that the .text and .data offsets apply to the whole
4275 text and data segments. Convert the offsets given in the packet
4276 to base addresses for symfile_map_offsets_to_segments. */
4277 else if (data
!= nullptr && data
->segments
.size () == 2)
4279 segments
[0] = data
->segments
[0].base
+ text_addr
;
4280 segments
[1] = data
->segments
[1].base
+ data_addr
;
4283 /* If the object file has only one segment, assume that it is text
4284 rather than data; main programs with no writable data are rare,
4285 but programs with no code are useless. Of course the code might
4286 have ended up in the data segment... to detect that we would need
4287 the permissions here. */
4288 else if (data
&& data
->segments
.size () == 1)
4290 segments
[0] = data
->segments
[0].base
+ text_addr
;
4293 /* There's no way to relocate by segment. */
4299 int ret
= symfile_map_offsets_to_segments (objf
->obfd
,
4301 num_segments
, segments
);
4303 if (ret
== 0 && !do_sections
)
4304 error (_("Can not handle qOffsets TextSeg "
4305 "response with this symbol file"));
4313 offs
[SECT_OFF_TEXT (objf
)] = text_addr
;
4315 /* This is a temporary kludge to force data and bss to use the
4316 same offsets because that's what nlmconv does now. The real
4317 solution requires changes to the stub and remote.c that I
4318 don't have time to do right now. */
4320 offs
[SECT_OFF_DATA (objf
)] = data_addr
;
4321 offs
[SECT_OFF_BSS (objf
)] = data_addr
;
4324 objfile_relocate (objf
, offs
);
4327 /* Send interrupt_sequence to remote target. */
4330 remote_target::send_interrupt_sequence ()
4332 struct remote_state
*rs
= get_remote_state ();
4334 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
4335 remote_serial_write ("\x03", 1);
4336 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
4337 serial_send_break (rs
->remote_desc
);
4338 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
4340 serial_send_break (rs
->remote_desc
);
4341 remote_serial_write ("g", 1);
4344 internal_error (__FILE__
, __LINE__
,
4345 _("Invalid value for interrupt_sequence_mode: %s."),
4346 interrupt_sequence_mode
);
4350 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
4351 and extract the PTID. Returns NULL_PTID if not found. */
4354 stop_reply_extract_thread (const char *stop_reply
)
4356 if (stop_reply
[0] == 'T' && strlen (stop_reply
) > 3)
4360 /* Txx r:val ; r:val (...) */
4363 /* Look for "register" named "thread". */
4368 p1
= strchr (p
, ':');
4372 if (strncmp (p
, "thread", p1
- p
) == 0)
4373 return read_ptid (++p1
, &p
);
4375 p1
= strchr (p
, ';');
4387 /* Determine the remote side's current thread. If we have a stop
4388 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
4389 "thread" register we can extract the current thread from. If not,
4390 ask the remote which is the current thread with qC. The former
4391 method avoids a roundtrip. */
4394 remote_target::get_current_thread (const char *wait_status
)
4396 ptid_t ptid
= null_ptid
;
4398 /* Note we don't use remote_parse_stop_reply as that makes use of
4399 the target architecture, which we haven't yet fully determined at
4401 if (wait_status
!= NULL
)
4402 ptid
= stop_reply_extract_thread (wait_status
);
4403 if (ptid
== null_ptid
)
4404 ptid
= remote_current_thread (inferior_ptid
);
4409 /* Query the remote target for which is the current thread/process,
4410 add it to our tables, and update INFERIOR_PTID. The caller is
4411 responsible for setting the state such that the remote end is ready
4412 to return the current thread.
4414 This function is called after handling the '?' or 'vRun' packets,
4415 whose response is a stop reply from which we can also try
4416 extracting the thread. If the target doesn't support the explicit
4417 qC query, we infer the current thread from that stop reply, passed
4418 in in WAIT_STATUS, which may be NULL. */
4421 remote_target::add_current_inferior_and_thread (const char *wait_status
)
4423 struct remote_state
*rs
= get_remote_state ();
4424 bool fake_pid_p
= false;
4426 switch_to_no_thread ();
4428 /* Now, if we have thread information, update the current thread's
4430 ptid_t curr_ptid
= get_current_thread (wait_status
);
4432 if (curr_ptid
!= null_ptid
)
4434 if (!remote_multi_process_p (rs
))
4439 /* Without this, some commands which require an active target
4440 (such as kill) won't work. This variable serves (at least)
4441 double duty as both the pid of the target process (if it has
4442 such), and as a flag indicating that a target is active. */
4443 curr_ptid
= magic_null_ptid
;
4447 remote_add_inferior (fake_pid_p
, curr_ptid
.pid (), -1, 1);
4449 /* Add the main thread and switch to it. Don't try reading
4450 registers yet, since we haven't fetched the target description
4452 thread_info
*tp
= add_thread_silent (this, curr_ptid
);
4453 switch_to_thread_no_regs (tp
);
4456 /* Print info about a thread that was found already stopped on
4460 print_one_stopped_thread (struct thread_info
*thread
)
4462 struct target_waitstatus
*ws
= &thread
->suspend
.waitstatus
;
4464 switch_to_thread (thread
);
4465 thread
->suspend
.stop_pc
= get_frame_pc (get_current_frame ());
4466 set_current_sal_from_frame (get_current_frame ());
4468 thread
->suspend
.waitstatus_pending_p
= 0;
4470 if (ws
->kind
== TARGET_WAITKIND_STOPPED
)
4472 enum gdb_signal sig
= ws
->value
.sig
;
4474 if (signal_print_state (sig
))
4475 gdb::observers::signal_received
.notify (sig
);
4477 gdb::observers::normal_stop
.notify (NULL
, 1);
4480 /* Process all initial stop replies the remote side sent in response
4481 to the ? packet. These indicate threads that were already stopped
4482 on initial connection. We mark these threads as stopped and print
4483 their current frame before giving the user the prompt. */
4486 remote_target::process_initial_stop_replies (int from_tty
)
4488 int pending_stop_replies
= stop_reply_queue_length ();
4489 struct thread_info
*selected
= NULL
;
4490 struct thread_info
*lowest_stopped
= NULL
;
4491 struct thread_info
*first
= NULL
;
4493 /* Consume the initial pending events. */
4494 while (pending_stop_replies
-- > 0)
4496 ptid_t waiton_ptid
= minus_one_ptid
;
4498 struct target_waitstatus ws
;
4499 int ignore_event
= 0;
4501 memset (&ws
, 0, sizeof (ws
));
4502 event_ptid
= target_wait (waiton_ptid
, &ws
, TARGET_WNOHANG
);
4504 print_target_wait_results (waiton_ptid
, event_ptid
, &ws
);
4508 case TARGET_WAITKIND_IGNORE
:
4509 case TARGET_WAITKIND_NO_RESUMED
:
4510 case TARGET_WAITKIND_SIGNALLED
:
4511 case TARGET_WAITKIND_EXITED
:
4512 /* We shouldn't see these, but if we do, just ignore. */
4514 fprintf_unfiltered (gdb_stdlog
, "remote: event ignored\n");
4518 case TARGET_WAITKIND_EXECD
:
4519 xfree (ws
.value
.execd_pathname
);
4528 thread_info
*evthread
= find_thread_ptid (this, event_ptid
);
4530 if (ws
.kind
== TARGET_WAITKIND_STOPPED
)
4532 enum gdb_signal sig
= ws
.value
.sig
;
4534 /* Stubs traditionally report SIGTRAP as initial signal,
4535 instead of signal 0. Suppress it. */
4536 if (sig
== GDB_SIGNAL_TRAP
)
4538 evthread
->suspend
.stop_signal
= sig
;
4542 evthread
->suspend
.waitstatus
= ws
;
4544 if (ws
.kind
!= TARGET_WAITKIND_STOPPED
4545 || ws
.value
.sig
!= GDB_SIGNAL_0
)
4546 evthread
->suspend
.waitstatus_pending_p
= 1;
4548 set_executing (this, event_ptid
, false);
4549 set_running (this, event_ptid
, false);
4550 get_remote_thread_info (evthread
)->set_not_resumed ();
4553 /* "Notice" the new inferiors before anything related to
4554 registers/memory. */
4555 for (inferior
*inf
: all_non_exited_inferiors (this))
4557 inf
->needs_setup
= 1;
4561 thread_info
*thread
= any_live_thread_of_inferior (inf
);
4562 notice_new_inferior (thread
, thread
->state
== THREAD_RUNNING
,
4567 /* If all-stop on top of non-stop, pause all threads. Note this
4568 records the threads' stop pc, so must be done after "noticing"
4572 stop_all_threads ();
4574 /* If all threads of an inferior were already stopped, we
4575 haven't setup the inferior yet. */
4576 for (inferior
*inf
: all_non_exited_inferiors (this))
4578 if (inf
->needs_setup
)
4580 thread_info
*thread
= any_live_thread_of_inferior (inf
);
4581 switch_to_thread_no_regs (thread
);
4587 /* Now go over all threads that are stopped, and print their current
4588 frame. If all-stop, then if there's a signalled thread, pick
4590 for (thread_info
*thread
: all_non_exited_threads (this))
4596 thread
->set_running (false);
4597 else if (thread
->state
!= THREAD_STOPPED
)
4600 if (selected
== NULL
4601 && thread
->suspend
.waitstatus_pending_p
)
4604 if (lowest_stopped
== NULL
4605 || thread
->inf
->num
< lowest_stopped
->inf
->num
4606 || thread
->per_inf_num
< lowest_stopped
->per_inf_num
)
4607 lowest_stopped
= thread
;
4610 print_one_stopped_thread (thread
);
4613 /* In all-stop, we only print the status of one thread, and leave
4614 others with their status pending. */
4617 thread_info
*thread
= selected
;
4619 thread
= lowest_stopped
;
4623 print_one_stopped_thread (thread
);
4626 /* For "info program". */
4627 thread_info
*thread
= inferior_thread ();
4628 if (thread
->state
== THREAD_STOPPED
)
4629 set_last_target_status (this, inferior_ptid
, thread
->suspend
.waitstatus
);
4632 /* Start the remote connection and sync state. */
4635 remote_target::start_remote (int from_tty
, int extended_p
)
4637 struct remote_state
*rs
= get_remote_state ();
4638 struct packet_config
*noack_config
;
4639 char *wait_status
= NULL
;
4641 /* Signal other parts that we're going through the initial setup,
4642 and so things may not be stable yet. E.g., we don't try to
4643 install tracepoints until we've relocated symbols. Also, a
4644 Ctrl-C before we're connected and synced up can't interrupt the
4645 target. Instead, it offers to drop the (potentially wedged)
4647 rs
->starting_up
= 1;
4651 if (interrupt_on_connect
)
4652 send_interrupt_sequence ();
4654 /* Ack any packet which the remote side has already sent. */
4655 remote_serial_write ("+", 1);
4657 /* The first packet we send to the target is the optional "supported
4658 packets" request. If the target can answer this, it will tell us
4659 which later probes to skip. */
4660 remote_query_supported ();
4662 /* If the stub wants to get a QAllow, compose one and send it. */
4663 if (packet_support (PACKET_QAllow
) != PACKET_DISABLE
)
4666 /* gdbserver < 7.7 (before its fix from 2013-12-11) did reply to any
4667 unknown 'v' packet with string "OK". "OK" gets interpreted by GDB
4668 as a reply to known packet. For packet "vFile:setfs:" it is an
4669 invalid reply and GDB would return error in
4670 remote_hostio_set_filesystem, making remote files access impossible.
4671 Disable "vFile:setfs:" in such case. Do not disable other 'v' packets as
4672 other "vFile" packets get correctly detected even on gdbserver < 7.7. */
4674 const char v_mustreplyempty
[] = "vMustReplyEmpty";
4676 putpkt (v_mustreplyempty
);
4677 getpkt (&rs
->buf
, 0);
4678 if (strcmp (rs
->buf
.data (), "OK") == 0)
4679 remote_protocol_packets
[PACKET_vFile_setfs
].support
= PACKET_DISABLE
;
4680 else if (strcmp (rs
->buf
.data (), "") != 0)
4681 error (_("Remote replied unexpectedly to '%s': %s"), v_mustreplyempty
,
4685 /* Next, we possibly activate noack mode.
4687 If the QStartNoAckMode packet configuration is set to AUTO,
4688 enable noack mode if the stub reported a wish for it with
4691 If set to TRUE, then enable noack mode even if the stub didn't
4692 report it in qSupported. If the stub doesn't reply OK, the
4693 session ends with an error.
4695 If FALSE, then don't activate noack mode, regardless of what the
4696 stub claimed should be the default with qSupported. */
4698 noack_config
= &remote_protocol_packets
[PACKET_QStartNoAckMode
];
4699 if (packet_config_support (noack_config
) != PACKET_DISABLE
)
4701 putpkt ("QStartNoAckMode");
4702 getpkt (&rs
->buf
, 0);
4703 if (packet_ok (rs
->buf
, noack_config
) == PACKET_OK
)
4709 /* Tell the remote that we are using the extended protocol. */
4711 getpkt (&rs
->buf
, 0);
4714 /* Let the target know which signals it is allowed to pass down to
4716 update_signals_program_target ();
4718 /* Next, if the target can specify a description, read it. We do
4719 this before anything involving memory or registers. */
4720 target_find_description ();
4722 /* Next, now that we know something about the target, update the
4723 address spaces in the program spaces. */
4724 update_address_spaces ();
4726 /* On OSs where the list of libraries is global to all
4727 processes, we fetch them early. */
4728 if (gdbarch_has_global_solist (target_gdbarch ()))
4729 solib_add (NULL
, from_tty
, auto_solib_add
);
4731 if (target_is_non_stop_p ())
4733 if (packet_support (PACKET_QNonStop
) != PACKET_ENABLE
)
4734 error (_("Non-stop mode requested, but remote "
4735 "does not support non-stop"));
4737 putpkt ("QNonStop:1");
4738 getpkt (&rs
->buf
, 0);
4740 if (strcmp (rs
->buf
.data (), "OK") != 0)
4741 error (_("Remote refused setting non-stop mode with: %s"),
4744 /* Find about threads and processes the stub is already
4745 controlling. We default to adding them in the running state.
4746 The '?' query below will then tell us about which threads are
4748 this->update_thread_list ();
4750 else if (packet_support (PACKET_QNonStop
) == PACKET_ENABLE
)
4752 /* Don't assume that the stub can operate in all-stop mode.
4753 Request it explicitly. */
4754 putpkt ("QNonStop:0");
4755 getpkt (&rs
->buf
, 0);
4757 if (strcmp (rs
->buf
.data (), "OK") != 0)
4758 error (_("Remote refused setting all-stop mode with: %s"),
4762 /* Upload TSVs regardless of whether the target is running or not. The
4763 remote stub, such as GDBserver, may have some predefined or builtin
4764 TSVs, even if the target is not running. */
4765 if (get_trace_status (current_trace_status ()) != -1)
4767 struct uploaded_tsv
*uploaded_tsvs
= NULL
;
4769 upload_trace_state_variables (&uploaded_tsvs
);
4770 merge_uploaded_trace_state_variables (&uploaded_tsvs
);
4773 /* Check whether the target is running now. */
4775 getpkt (&rs
->buf
, 0);
4777 if (!target_is_non_stop_p ())
4779 if (rs
->buf
[0] == 'W' || rs
->buf
[0] == 'X')
4782 error (_("The target is not running (try extended-remote?)"));
4784 /* We're connected, but not running. Drop out before we
4785 call start_remote. */
4786 rs
->starting_up
= 0;
4791 /* Save the reply for later. */
4792 wait_status
= (char *) alloca (strlen (rs
->buf
.data ()) + 1);
4793 strcpy (wait_status
, rs
->buf
.data ());
4796 /* Fetch thread list. */
4797 target_update_thread_list ();
4799 /* Let the stub know that we want it to return the thread. */
4800 set_continue_thread (minus_one_ptid
);
4802 if (thread_count (this) == 0)
4804 /* Target has no concept of threads at all. GDB treats
4805 non-threaded target as single-threaded; add a main
4807 add_current_inferior_and_thread (wait_status
);
4811 /* We have thread information; select the thread the target
4812 says should be current. If we're reconnecting to a
4813 multi-threaded program, this will ideally be the thread
4814 that last reported an event before GDB disconnected. */
4815 ptid_t curr_thread
= get_current_thread (wait_status
);
4816 if (curr_thread
== null_ptid
)
4818 /* Odd... The target was able to list threads, but not
4819 tell us which thread was current (no "thread"
4820 register in T stop reply?). Just pick the first
4821 thread in the thread list then. */
4824 fprintf_unfiltered (gdb_stdlog
,
4825 "warning: couldn't determine remote "
4826 "current thread; picking first in list.\n");
4828 for (thread_info
*tp
: all_non_exited_threads (this,
4831 switch_to_thread (tp
);
4836 switch_to_thread (find_thread_ptid (this, curr_thread
));
4839 /* init_wait_for_inferior should be called before get_offsets in order
4840 to manage `inserted' flag in bp loc in a correct state.
4841 breakpoint_init_inferior, called from init_wait_for_inferior, set
4842 `inserted' flag to 0, while before breakpoint_re_set, called from
4843 start_remote, set `inserted' flag to 1. In the initialization of
4844 inferior, breakpoint_init_inferior should be called first, and then
4845 breakpoint_re_set can be called. If this order is broken, state of
4846 `inserted' flag is wrong, and cause some problems on breakpoint
4848 init_wait_for_inferior ();
4850 get_offsets (); /* Get text, data & bss offsets. */
4852 /* If we could not find a description using qXfer, and we know
4853 how to do it some other way, try again. This is not
4854 supported for non-stop; it could be, but it is tricky if
4855 there are no stopped threads when we connect. */
4856 if (remote_read_description_p (this)
4857 && gdbarch_target_desc (target_gdbarch ()) == NULL
)
4859 target_clear_description ();
4860 target_find_description ();
4863 /* Use the previously fetched status. */
4864 gdb_assert (wait_status
!= NULL
);
4865 strcpy (rs
->buf
.data (), wait_status
);
4866 rs
->cached_wait_status
= 1;
4868 ::start_remote (from_tty
); /* Initialize gdb process mechanisms. */
4872 /* Clear WFI global state. Do this before finding about new
4873 threads and inferiors, and setting the current inferior.
4874 Otherwise we would clear the proceed status of the current
4875 inferior when we want its stop_soon state to be preserved
4876 (see notice_new_inferior). */
4877 init_wait_for_inferior ();
4879 /* In non-stop, we will either get an "OK", meaning that there
4880 are no stopped threads at this time; or, a regular stop
4881 reply. In the latter case, there may be more than one thread
4882 stopped --- we pull them all out using the vStopped
4884 if (strcmp (rs
->buf
.data (), "OK") != 0)
4886 struct notif_client
*notif
= ¬if_client_stop
;
4888 /* remote_notif_get_pending_replies acks this one, and gets
4890 rs
->notif_state
->pending_event
[notif_client_stop
.id
]
4891 = remote_notif_parse (this, notif
, rs
->buf
.data ());
4892 remote_notif_get_pending_events (notif
);
4895 if (thread_count (this) == 0)
4898 error (_("The target is not running (try extended-remote?)"));
4900 /* We're connected, but not running. Drop out before we
4901 call start_remote. */
4902 rs
->starting_up
= 0;
4906 /* In non-stop mode, any cached wait status will be stored in
4907 the stop reply queue. */
4908 gdb_assert (wait_status
== NULL
);
4910 /* Report all signals during attach/startup. */
4913 /* If there are already stopped threads, mark them stopped and
4914 report their stops before giving the prompt to the user. */
4915 process_initial_stop_replies (from_tty
);
4917 if (target_can_async_p ())
4921 /* If we connected to a live target, do some additional setup. */
4922 if (target_has_execution ())
4924 /* No use without a symbol-file. */
4925 if (current_program_space
->symfile_object_file
)
4926 remote_check_symbols ();
4929 /* Possibly the target has been engaged in a trace run started
4930 previously; find out where things are at. */
4931 if (get_trace_status (current_trace_status ()) != -1)
4933 struct uploaded_tp
*uploaded_tps
= NULL
;
4935 if (current_trace_status ()->running
)
4936 printf_filtered (_("Trace is already running on the target.\n"));
4938 upload_tracepoints (&uploaded_tps
);
4940 merge_uploaded_tracepoints (&uploaded_tps
);
4943 /* Possibly the target has been engaged in a btrace record started
4944 previously; find out where things are at. */
4945 remote_btrace_maybe_reopen ();
4947 /* The thread and inferior lists are now synchronized with the
4948 target, our symbols have been relocated, and we're merged the
4949 target's tracepoints with ours. We're done with basic start
4951 rs
->starting_up
= 0;
4953 /* Maybe breakpoints are global and need to be inserted now. */
4954 if (breakpoints_should_be_inserted_now ())
4955 insert_breakpoints ();
4959 remote_target::connection_string ()
4961 remote_state
*rs
= get_remote_state ();
4963 if (rs
->remote_desc
->name
!= NULL
)
4964 return rs
->remote_desc
->name
;
4969 /* Open a connection to a remote debugger.
4970 NAME is the filename used for communication. */
4973 remote_target::open (const char *name
, int from_tty
)
4975 open_1 (name
, from_tty
, 0);
4978 /* Open a connection to a remote debugger using the extended
4979 remote gdb protocol. NAME is the filename used for communication. */
4982 extended_remote_target::open (const char *name
, int from_tty
)
4984 open_1 (name
, from_tty
, 1 /*extended_p */);
4987 /* Reset all packets back to "unknown support". Called when opening a
4988 new connection to a remote target. */
4991 reset_all_packet_configs_support (void)
4995 for (i
= 0; i
< PACKET_MAX
; i
++)
4996 remote_protocol_packets
[i
].support
= PACKET_SUPPORT_UNKNOWN
;
4999 /* Initialize all packet configs. */
5002 init_all_packet_configs (void)
5006 for (i
= 0; i
< PACKET_MAX
; i
++)
5008 remote_protocol_packets
[i
].detect
= AUTO_BOOLEAN_AUTO
;
5009 remote_protocol_packets
[i
].support
= PACKET_SUPPORT_UNKNOWN
;
5013 /* Symbol look-up. */
5016 remote_target::remote_check_symbols ()
5021 /* The remote side has no concept of inferiors that aren't running
5022 yet, it only knows about running processes. If we're connected
5023 but our current inferior is not running, we should not invite the
5024 remote target to request symbol lookups related to its
5025 (unrelated) current process. */
5026 if (!target_has_execution ())
5029 if (packet_support (PACKET_qSymbol
) == PACKET_DISABLE
)
5032 /* Make sure the remote is pointing at the right process. Note
5033 there's no way to select "no process". */
5034 set_general_process ();
5036 /* Allocate a message buffer. We can't reuse the input buffer in RS,
5037 because we need both at the same time. */
5038 gdb::char_vector
msg (get_remote_packet_size ());
5039 gdb::char_vector
reply (get_remote_packet_size ());
5041 /* Invite target to request symbol lookups. */
5043 putpkt ("qSymbol::");
5045 packet_ok (reply
, &remote_protocol_packets
[PACKET_qSymbol
]);
5047 while (startswith (reply
.data (), "qSymbol:"))
5049 struct bound_minimal_symbol sym
;
5052 end
= hex2bin (tmp
, reinterpret_cast <gdb_byte
*> (msg
.data ()),
5055 sym
= lookup_minimal_symbol (msg
.data (), NULL
, NULL
);
5056 if (sym
.minsym
== NULL
)
5057 xsnprintf (msg
.data (), get_remote_packet_size (), "qSymbol::%s",
5061 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
5062 CORE_ADDR sym_addr
= BMSYMBOL_VALUE_ADDRESS (sym
);
5064 /* If this is a function address, return the start of code
5065 instead of any data function descriptor. */
5066 sym_addr
= gdbarch_convert_from_func_ptr_addr (target_gdbarch (),
5068 current_top_target ());
5070 xsnprintf (msg
.data (), get_remote_packet_size (), "qSymbol:%s:%s",
5071 phex_nz (sym_addr
, addr_size
), &reply
[8]);
5074 putpkt (msg
.data ());
5079 static struct serial
*
5080 remote_serial_open (const char *name
)
5082 static int udp_warning
= 0;
5084 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
5085 of in ser-tcp.c, because it is the remote protocol assuming that the
5086 serial connection is reliable and not the serial connection promising
5088 if (!udp_warning
&& startswith (name
, "udp:"))
5090 warning (_("The remote protocol may be unreliable over UDP.\n"
5091 "Some events may be lost, rendering further debugging "
5096 return serial_open (name
);
5099 /* Inform the target of our permission settings. The permission flags
5100 work without this, but if the target knows the settings, it can do
5101 a couple things. First, it can add its own check, to catch cases
5102 that somehow manage to get by the permissions checks in target
5103 methods. Second, if the target is wired to disallow particular
5104 settings (for instance, a system in the field that is not set up to
5105 be able to stop at a breakpoint), it can object to any unavailable
5109 remote_target::set_permissions ()
5111 struct remote_state
*rs
= get_remote_state ();
5113 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QAllow:"
5114 "WriteReg:%x;WriteMem:%x;"
5115 "InsertBreak:%x;InsertTrace:%x;"
5116 "InsertFastTrace:%x;Stop:%x",
5117 may_write_registers
, may_write_memory
,
5118 may_insert_breakpoints
, may_insert_tracepoints
,
5119 may_insert_fast_tracepoints
, may_stop
);
5121 getpkt (&rs
->buf
, 0);
5123 /* If the target didn't like the packet, warn the user. Do not try
5124 to undo the user's settings, that would just be maddening. */
5125 if (strcmp (rs
->buf
.data (), "OK") != 0)
5126 warning (_("Remote refused setting permissions with: %s"),
5130 /* This type describes each known response to the qSupported
5132 struct protocol_feature
5134 /* The name of this protocol feature. */
5137 /* The default for this protocol feature. */
5138 enum packet_support default_support
;
5140 /* The function to call when this feature is reported, or after
5141 qSupported processing if the feature is not supported.
5142 The first argument points to this structure. The second
5143 argument indicates whether the packet requested support be
5144 enabled, disabled, or probed (or the default, if this function
5145 is being called at the end of processing and this feature was
5146 not reported). The third argument may be NULL; if not NULL, it
5147 is a NUL-terminated string taken from the packet following
5148 this feature's name and an equals sign. */
5149 void (*func
) (remote_target
*remote
, const struct protocol_feature
*,
5150 enum packet_support
, const char *);
5152 /* The corresponding packet for this feature. Only used if
5153 FUNC is remote_supported_packet. */
5158 remote_supported_packet (remote_target
*remote
,
5159 const struct protocol_feature
*feature
,
5160 enum packet_support support
,
5161 const char *argument
)
5165 warning (_("Remote qSupported response supplied an unexpected value for"
5166 " \"%s\"."), feature
->name
);
5170 remote_protocol_packets
[feature
->packet
].support
= support
;
5174 remote_target::remote_packet_size (const protocol_feature
*feature
,
5175 enum packet_support support
, const char *value
)
5177 struct remote_state
*rs
= get_remote_state ();
5182 if (support
!= PACKET_ENABLE
)
5185 if (value
== NULL
|| *value
== '\0')
5187 warning (_("Remote target reported \"%s\" without a size."),
5193 packet_size
= strtol (value
, &value_end
, 16);
5194 if (errno
!= 0 || *value_end
!= '\0' || packet_size
< 0)
5196 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
5197 feature
->name
, value
);
5201 /* Record the new maximum packet size. */
5202 rs
->explicit_packet_size
= packet_size
;
5206 remote_packet_size (remote_target
*remote
, const protocol_feature
*feature
,
5207 enum packet_support support
, const char *value
)
5209 remote
->remote_packet_size (feature
, support
, value
);
5212 static const struct protocol_feature remote_protocol_features
[] = {
5213 { "PacketSize", PACKET_DISABLE
, remote_packet_size
, -1 },
5214 { "qXfer:auxv:read", PACKET_DISABLE
, remote_supported_packet
,
5215 PACKET_qXfer_auxv
},
5216 { "qXfer:exec-file:read", PACKET_DISABLE
, remote_supported_packet
,
5217 PACKET_qXfer_exec_file
},
5218 { "qXfer:features:read", PACKET_DISABLE
, remote_supported_packet
,
5219 PACKET_qXfer_features
},
5220 { "qXfer:libraries:read", PACKET_DISABLE
, remote_supported_packet
,
5221 PACKET_qXfer_libraries
},
5222 { "qXfer:libraries-svr4:read", PACKET_DISABLE
, remote_supported_packet
,
5223 PACKET_qXfer_libraries_svr4
},
5224 { "augmented-libraries-svr4-read", PACKET_DISABLE
,
5225 remote_supported_packet
, PACKET_augmented_libraries_svr4_read_feature
},
5226 { "qXfer:memory-map:read", PACKET_DISABLE
, remote_supported_packet
,
5227 PACKET_qXfer_memory_map
},
5228 { "qXfer:osdata:read", PACKET_DISABLE
, remote_supported_packet
,
5229 PACKET_qXfer_osdata
},
5230 { "qXfer:threads:read", PACKET_DISABLE
, remote_supported_packet
,
5231 PACKET_qXfer_threads
},
5232 { "qXfer:traceframe-info:read", PACKET_DISABLE
, remote_supported_packet
,
5233 PACKET_qXfer_traceframe_info
},
5234 { "QPassSignals", PACKET_DISABLE
, remote_supported_packet
,
5235 PACKET_QPassSignals
},
5236 { "QCatchSyscalls", PACKET_DISABLE
, remote_supported_packet
,
5237 PACKET_QCatchSyscalls
},
5238 { "QProgramSignals", PACKET_DISABLE
, remote_supported_packet
,
5239 PACKET_QProgramSignals
},
5240 { "QSetWorkingDir", PACKET_DISABLE
, remote_supported_packet
,
5241 PACKET_QSetWorkingDir
},
5242 { "QStartupWithShell", PACKET_DISABLE
, remote_supported_packet
,
5243 PACKET_QStartupWithShell
},
5244 { "QEnvironmentHexEncoded", PACKET_DISABLE
, remote_supported_packet
,
5245 PACKET_QEnvironmentHexEncoded
},
5246 { "QEnvironmentReset", PACKET_DISABLE
, remote_supported_packet
,
5247 PACKET_QEnvironmentReset
},
5248 { "QEnvironmentUnset", PACKET_DISABLE
, remote_supported_packet
,
5249 PACKET_QEnvironmentUnset
},
5250 { "QStartNoAckMode", PACKET_DISABLE
, remote_supported_packet
,
5251 PACKET_QStartNoAckMode
},
5252 { "multiprocess", PACKET_DISABLE
, remote_supported_packet
,
5253 PACKET_multiprocess_feature
},
5254 { "QNonStop", PACKET_DISABLE
, remote_supported_packet
, PACKET_QNonStop
},
5255 { "qXfer:siginfo:read", PACKET_DISABLE
, remote_supported_packet
,
5256 PACKET_qXfer_siginfo_read
},
5257 { "qXfer:siginfo:write", PACKET_DISABLE
, remote_supported_packet
,
5258 PACKET_qXfer_siginfo_write
},
5259 { "ConditionalTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5260 PACKET_ConditionalTracepoints
},
5261 { "ConditionalBreakpoints", PACKET_DISABLE
, remote_supported_packet
,
5262 PACKET_ConditionalBreakpoints
},
5263 { "BreakpointCommands", PACKET_DISABLE
, remote_supported_packet
,
5264 PACKET_BreakpointCommands
},
5265 { "FastTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5266 PACKET_FastTracepoints
},
5267 { "StaticTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5268 PACKET_StaticTracepoints
},
5269 {"InstallInTrace", PACKET_DISABLE
, remote_supported_packet
,
5270 PACKET_InstallInTrace
},
5271 { "DisconnectedTracing", PACKET_DISABLE
, remote_supported_packet
,
5272 PACKET_DisconnectedTracing_feature
},
5273 { "ReverseContinue", PACKET_DISABLE
, remote_supported_packet
,
5275 { "ReverseStep", PACKET_DISABLE
, remote_supported_packet
,
5277 { "TracepointSource", PACKET_DISABLE
, remote_supported_packet
,
5278 PACKET_TracepointSource
},
5279 { "QAllow", PACKET_DISABLE
, remote_supported_packet
,
5281 { "EnableDisableTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5282 PACKET_EnableDisableTracepoints_feature
},
5283 { "qXfer:fdpic:read", PACKET_DISABLE
, remote_supported_packet
,
5284 PACKET_qXfer_fdpic
},
5285 { "qXfer:uib:read", PACKET_DISABLE
, remote_supported_packet
,
5287 { "QDisableRandomization", PACKET_DISABLE
, remote_supported_packet
,
5288 PACKET_QDisableRandomization
},
5289 { "QAgent", PACKET_DISABLE
, remote_supported_packet
, PACKET_QAgent
},
5290 { "QTBuffer:size", PACKET_DISABLE
,
5291 remote_supported_packet
, PACKET_QTBuffer_size
},
5292 { "tracenz", PACKET_DISABLE
, remote_supported_packet
, PACKET_tracenz_feature
},
5293 { "Qbtrace:off", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_off
},
5294 { "Qbtrace:bts", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_bts
},
5295 { "Qbtrace:pt", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_pt
},
5296 { "qXfer:btrace:read", PACKET_DISABLE
, remote_supported_packet
,
5297 PACKET_qXfer_btrace
},
5298 { "qXfer:btrace-conf:read", PACKET_DISABLE
, remote_supported_packet
,
5299 PACKET_qXfer_btrace_conf
},
5300 { "Qbtrace-conf:bts:size", PACKET_DISABLE
, remote_supported_packet
,
5301 PACKET_Qbtrace_conf_bts_size
},
5302 { "swbreak", PACKET_DISABLE
, remote_supported_packet
, PACKET_swbreak_feature
},
5303 { "hwbreak", PACKET_DISABLE
, remote_supported_packet
, PACKET_hwbreak_feature
},
5304 { "fork-events", PACKET_DISABLE
, remote_supported_packet
,
5305 PACKET_fork_event_feature
},
5306 { "vfork-events", PACKET_DISABLE
, remote_supported_packet
,
5307 PACKET_vfork_event_feature
},
5308 { "exec-events", PACKET_DISABLE
, remote_supported_packet
,
5309 PACKET_exec_event_feature
},
5310 { "Qbtrace-conf:pt:size", PACKET_DISABLE
, remote_supported_packet
,
5311 PACKET_Qbtrace_conf_pt_size
},
5312 { "vContSupported", PACKET_DISABLE
, remote_supported_packet
, PACKET_vContSupported
},
5313 { "QThreadEvents", PACKET_DISABLE
, remote_supported_packet
, PACKET_QThreadEvents
},
5314 { "no-resumed", PACKET_DISABLE
, remote_supported_packet
, PACKET_no_resumed
},
5317 static char *remote_support_xml
;
5319 /* Register string appended to "xmlRegisters=" in qSupported query. */
5322 register_remote_support_xml (const char *xml
)
5324 #if defined(HAVE_LIBEXPAT)
5325 if (remote_support_xml
== NULL
)
5326 remote_support_xml
= concat ("xmlRegisters=", xml
, (char *) NULL
);
5329 char *copy
= xstrdup (remote_support_xml
+ 13);
5331 char *p
= strtok_r (copy
, ",", &saveptr
);
5335 if (strcmp (p
, xml
) == 0)
5342 while ((p
= strtok_r (NULL
, ",", &saveptr
)) != NULL
);
5345 remote_support_xml
= reconcat (remote_support_xml
,
5346 remote_support_xml
, ",", xml
,
5353 remote_query_supported_append (std::string
*msg
, const char *append
)
5357 msg
->append (append
);
5361 remote_target::remote_query_supported ()
5363 struct remote_state
*rs
= get_remote_state ();
5366 unsigned char seen
[ARRAY_SIZE (remote_protocol_features
)];
5368 /* The packet support flags are handled differently for this packet
5369 than for most others. We treat an error, a disabled packet, and
5370 an empty response identically: any features which must be reported
5371 to be used will be automatically disabled. An empty buffer
5372 accomplishes this, since that is also the representation for a list
5373 containing no features. */
5376 if (packet_support (PACKET_qSupported
) != PACKET_DISABLE
)
5380 if (packet_set_cmd_state (PACKET_multiprocess_feature
) != AUTO_BOOLEAN_FALSE
)
5381 remote_query_supported_append (&q
, "multiprocess+");
5383 if (packet_set_cmd_state (PACKET_swbreak_feature
) != AUTO_BOOLEAN_FALSE
)
5384 remote_query_supported_append (&q
, "swbreak+");
5385 if (packet_set_cmd_state (PACKET_hwbreak_feature
) != AUTO_BOOLEAN_FALSE
)
5386 remote_query_supported_append (&q
, "hwbreak+");
5388 remote_query_supported_append (&q
, "qRelocInsn+");
5390 if (packet_set_cmd_state (PACKET_fork_event_feature
)
5391 != AUTO_BOOLEAN_FALSE
)
5392 remote_query_supported_append (&q
, "fork-events+");
5393 if (packet_set_cmd_state (PACKET_vfork_event_feature
)
5394 != AUTO_BOOLEAN_FALSE
)
5395 remote_query_supported_append (&q
, "vfork-events+");
5396 if (packet_set_cmd_state (PACKET_exec_event_feature
)
5397 != AUTO_BOOLEAN_FALSE
)
5398 remote_query_supported_append (&q
, "exec-events+");
5400 if (packet_set_cmd_state (PACKET_vContSupported
) != AUTO_BOOLEAN_FALSE
)
5401 remote_query_supported_append (&q
, "vContSupported+");
5403 if (packet_set_cmd_state (PACKET_QThreadEvents
) != AUTO_BOOLEAN_FALSE
)
5404 remote_query_supported_append (&q
, "QThreadEvents+");
5406 if (packet_set_cmd_state (PACKET_no_resumed
) != AUTO_BOOLEAN_FALSE
)
5407 remote_query_supported_append (&q
, "no-resumed+");
5409 /* Keep this one last to work around a gdbserver <= 7.10 bug in
5410 the qSupported:xmlRegisters=i386 handling. */
5411 if (remote_support_xml
!= NULL
5412 && packet_support (PACKET_qXfer_features
) != PACKET_DISABLE
)
5413 remote_query_supported_append (&q
, remote_support_xml
);
5415 q
= "qSupported:" + q
;
5416 putpkt (q
.c_str ());
5418 getpkt (&rs
->buf
, 0);
5420 /* If an error occured, warn, but do not return - just reset the
5421 buffer to empty and go on to disable features. */
5422 if (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_qSupported
])
5425 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
5430 memset (seen
, 0, sizeof (seen
));
5432 next
= rs
->buf
.data ();
5435 enum packet_support is_supported
;
5436 char *p
, *end
, *name_end
, *value
;
5438 /* First separate out this item from the rest of the packet. If
5439 there's another item after this, we overwrite the separator
5440 (terminated strings are much easier to work with). */
5442 end
= strchr (p
, ';');
5445 end
= p
+ strlen (p
);
5455 warning (_("empty item in \"qSupported\" response"));
5460 name_end
= strchr (p
, '=');
5463 /* This is a name=value entry. */
5464 is_supported
= PACKET_ENABLE
;
5465 value
= name_end
+ 1;
5474 is_supported
= PACKET_ENABLE
;
5478 is_supported
= PACKET_DISABLE
;
5482 is_supported
= PACKET_SUPPORT_UNKNOWN
;
5486 warning (_("unrecognized item \"%s\" "
5487 "in \"qSupported\" response"), p
);
5493 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
5494 if (strcmp (remote_protocol_features
[i
].name
, p
) == 0)
5496 const struct protocol_feature
*feature
;
5499 feature
= &remote_protocol_features
[i
];
5500 feature
->func (this, feature
, is_supported
, value
);
5505 /* If we increased the packet size, make sure to increase the global
5506 buffer size also. We delay this until after parsing the entire
5507 qSupported packet, because this is the same buffer we were
5509 if (rs
->buf
.size () < rs
->explicit_packet_size
)
5510 rs
->buf
.resize (rs
->explicit_packet_size
);
5512 /* Handle the defaults for unmentioned features. */
5513 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
5516 const struct protocol_feature
*feature
;
5518 feature
= &remote_protocol_features
[i
];
5519 feature
->func (this, feature
, feature
->default_support
, NULL
);
5523 /* Serial QUIT handler for the remote serial descriptor.
5525 Defers handling a Ctrl-C until we're done with the current
5526 command/response packet sequence, unless:
5528 - We're setting up the connection. Don't send a remote interrupt
5529 request, as we're not fully synced yet. Quit immediately
5532 - The target has been resumed in the foreground
5533 (target_terminal::is_ours is false) with a synchronous resume
5534 packet, and we're blocked waiting for the stop reply, thus a
5535 Ctrl-C should be immediately sent to the target.
5537 - We get a second Ctrl-C while still within the same serial read or
5538 write. In that case the serial is seemingly wedged --- offer to
5541 - We see a second Ctrl-C without target response, after having
5542 previously interrupted the target. In that case the target/stub
5543 is probably wedged --- offer to quit/disconnect.
5547 remote_target::remote_serial_quit_handler ()
5549 struct remote_state
*rs
= get_remote_state ();
5551 if (check_quit_flag ())
5553 /* If we're starting up, we're not fully synced yet. Quit
5555 if (rs
->starting_up
)
5557 else if (rs
->got_ctrlc_during_io
)
5559 if (query (_("The target is not responding to GDB commands.\n"
5560 "Stop debugging it? ")))
5561 remote_unpush_and_throw (this);
5563 /* If ^C has already been sent once, offer to disconnect. */
5564 else if (!target_terminal::is_ours () && rs
->ctrlc_pending_p
)
5566 /* All-stop protocol, and blocked waiting for stop reply. Send
5567 an interrupt request. */
5568 else if (!target_terminal::is_ours () && rs
->waiting_for_stop_reply
)
5569 target_interrupt ();
5571 rs
->got_ctrlc_during_io
= 1;
5575 /* The remote_target that is current while the quit handler is
5576 overridden with remote_serial_quit_handler. */
5577 static remote_target
*curr_quit_handler_target
;
5580 remote_serial_quit_handler ()
5582 curr_quit_handler_target
->remote_serial_quit_handler ();
5585 /* Remove the remote target from the target stack of each inferior
5586 that is using it. Upper targets depend on it so remove them
5590 remote_unpush_target (remote_target
*target
)
5592 /* We have to unpush the target from all inferiors, even those that
5594 scoped_restore_current_inferior restore_current_inferior
;
5596 for (inferior
*inf
: all_inferiors (target
))
5598 switch_to_inferior_no_thread (inf
);
5599 pop_all_targets_at_and_above (process_stratum
);
5600 generic_mourn_inferior ();
5605 remote_unpush_and_throw (remote_target
*target
)
5607 remote_unpush_target (target
);
5608 throw_error (TARGET_CLOSE_ERROR
, _("Disconnected from target."));
5612 remote_target::open_1 (const char *name
, int from_tty
, int extended_p
)
5614 remote_target
*curr_remote
= get_current_remote_target ();
5617 error (_("To open a remote debug connection, you need to specify what\n"
5618 "serial device is attached to the remote system\n"
5619 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
5621 /* If we're connected to a running target, target_preopen will kill it.
5622 Ask this question first, before target_preopen has a chance to kill
5624 if (curr_remote
!= NULL
&& !target_has_execution ())
5627 && !query (_("Already connected to a remote target. Disconnect? ")))
5628 error (_("Still connected."));
5631 /* Here the possibly existing remote target gets unpushed. */
5632 target_preopen (from_tty
);
5634 remote_fileio_reset ();
5635 reopen_exec_file ();
5638 remote_target
*remote
5639 = (extended_p
? new extended_remote_target () : new remote_target ());
5640 target_ops_up
target_holder (remote
);
5642 remote_state
*rs
= remote
->get_remote_state ();
5644 /* See FIXME above. */
5645 if (!target_async_permitted
)
5646 rs
->wait_forever_enabled_p
= 1;
5648 rs
->remote_desc
= remote_serial_open (name
);
5649 if (!rs
->remote_desc
)
5650 perror_with_name (name
);
5652 if (baud_rate
!= -1)
5654 if (serial_setbaudrate (rs
->remote_desc
, baud_rate
))
5656 /* The requested speed could not be set. Error out to
5657 top level after closing remote_desc. Take care to
5658 set remote_desc to NULL to avoid closing remote_desc
5660 serial_close (rs
->remote_desc
);
5661 rs
->remote_desc
= NULL
;
5662 perror_with_name (name
);
5666 serial_setparity (rs
->remote_desc
, serial_parity
);
5667 serial_raw (rs
->remote_desc
);
5669 /* If there is something sitting in the buffer we might take it as a
5670 response to a command, which would be bad. */
5671 serial_flush_input (rs
->remote_desc
);
5675 puts_filtered ("Remote debugging using ");
5676 puts_filtered (name
);
5677 puts_filtered ("\n");
5680 /* Switch to using the remote target now. */
5681 push_target (std::move (target_holder
));
5683 /* Register extra event sources in the event loop. */
5684 rs
->remote_async_inferior_event_token
5685 = create_async_event_handler (remote_async_inferior_event_handler
, remote
,
5687 rs
->notif_state
= remote_notif_state_allocate (remote
);
5689 /* Reset the target state; these things will be queried either by
5690 remote_query_supported or as they are needed. */
5691 reset_all_packet_configs_support ();
5692 rs
->cached_wait_status
= 0;
5693 rs
->explicit_packet_size
= 0;
5695 rs
->extended
= extended_p
;
5696 rs
->waiting_for_stop_reply
= 0;
5697 rs
->ctrlc_pending_p
= 0;
5698 rs
->got_ctrlc_during_io
= 0;
5700 rs
->general_thread
= not_sent_ptid
;
5701 rs
->continue_thread
= not_sent_ptid
;
5702 rs
->remote_traceframe_number
= -1;
5704 rs
->last_resume_exec_dir
= EXEC_FORWARD
;
5706 /* Probe for ability to use "ThreadInfo" query, as required. */
5707 rs
->use_threadinfo_query
= 1;
5708 rs
->use_threadextra_query
= 1;
5710 rs
->readahead_cache
.invalidate ();
5712 if (target_async_permitted
)
5714 /* FIXME: cagney/1999-09-23: During the initial connection it is
5715 assumed that the target is already ready and able to respond to
5716 requests. Unfortunately remote_start_remote() eventually calls
5717 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
5718 around this. Eventually a mechanism that allows
5719 wait_for_inferior() to expect/get timeouts will be
5721 rs
->wait_forever_enabled_p
= 0;
5724 /* First delete any symbols previously loaded from shared libraries. */
5725 no_shared_libraries (NULL
, 0);
5727 /* Start the remote connection. If error() or QUIT, discard this
5728 target (we'd otherwise be in an inconsistent state) and then
5729 propogate the error on up the exception chain. This ensures that
5730 the caller doesn't stumble along blindly assuming that the
5731 function succeeded. The CLI doesn't have this problem but other
5732 UI's, such as MI do.
5734 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
5735 this function should return an error indication letting the
5736 caller restore the previous state. Unfortunately the command
5737 ``target remote'' is directly wired to this function making that
5738 impossible. On a positive note, the CLI side of this problem has
5739 been fixed - the function set_cmd_context() makes it possible for
5740 all the ``target ....'' commands to share a common callback
5741 function. See cli-dump.c. */
5746 remote
->start_remote (from_tty
, extended_p
);
5748 catch (const gdb_exception
&ex
)
5750 /* Pop the partially set up target - unless something else did
5751 already before throwing the exception. */
5752 if (ex
.error
!= TARGET_CLOSE_ERROR
)
5753 remote_unpush_target (remote
);
5758 remote_btrace_reset (rs
);
5760 if (target_async_permitted
)
5761 rs
->wait_forever_enabled_p
= 1;
5764 /* Detach the specified process. */
5767 remote_target::remote_detach_pid (int pid
)
5769 struct remote_state
*rs
= get_remote_state ();
5771 /* This should not be necessary, but the handling for D;PID in
5772 GDBserver versions prior to 8.2 incorrectly assumes that the
5773 selected process points to the same process we're detaching,
5774 leading to misbehavior (and possibly GDBserver crashing) when it
5775 does not. Since it's easy and cheap, work around it by forcing
5776 GDBserver to select GDB's current process. */
5777 set_general_process ();
5779 if (remote_multi_process_p (rs
))
5780 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "D;%x", pid
);
5782 strcpy (rs
->buf
.data (), "D");
5785 getpkt (&rs
->buf
, 0);
5787 if (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K')
5789 else if (rs
->buf
[0] == '\0')
5790 error (_("Remote doesn't know how to detach"));
5792 error (_("Can't detach process."));
5795 /* This detaches a program to which we previously attached, using
5796 inferior_ptid to identify the process. After this is done, GDB
5797 can be used to debug some other program. We better not have left
5798 any breakpoints in the target program or it'll die when it hits
5802 remote_target::remote_detach_1 (inferior
*inf
, int from_tty
)
5804 int pid
= inferior_ptid
.pid ();
5805 struct remote_state
*rs
= get_remote_state ();
5808 if (!target_has_execution ())
5809 error (_("No process to detach from."));
5811 target_announce_detach (from_tty
);
5813 /* Tell the remote target to detach. */
5814 remote_detach_pid (pid
);
5816 /* Exit only if this is the only active inferior. */
5817 if (from_tty
&& !rs
->extended
&& number_of_live_inferiors (this) == 1)
5818 puts_filtered (_("Ending remote debugging.\n"));
5820 thread_info
*tp
= find_thread_ptid (this, inferior_ptid
);
5822 /* Check to see if we are detaching a fork parent. Note that if we
5823 are detaching a fork child, tp == NULL. */
5824 is_fork_parent
= (tp
!= NULL
5825 && tp
->pending_follow
.kind
== TARGET_WAITKIND_FORKED
);
5827 /* If doing detach-on-fork, we don't mourn, because that will delete
5828 breakpoints that should be available for the followed inferior. */
5829 if (!is_fork_parent
)
5831 /* Save the pid as a string before mourning, since that will
5832 unpush the remote target, and we need the string after. */
5833 std::string infpid
= target_pid_to_str (ptid_t (pid
));
5835 target_mourn_inferior (inferior_ptid
);
5836 if (print_inferior_events
)
5837 printf_unfiltered (_("[Inferior %d (%s) detached]\n"),
5838 inf
->num
, infpid
.c_str ());
5842 switch_to_no_thread ();
5843 detach_inferior (current_inferior ());
5848 remote_target::detach (inferior
*inf
, int from_tty
)
5850 remote_detach_1 (inf
, from_tty
);
5854 extended_remote_target::detach (inferior
*inf
, int from_tty
)
5856 remote_detach_1 (inf
, from_tty
);
5859 /* Target follow-fork function for remote targets. On entry, and
5860 at return, the current inferior is the fork parent.
5862 Note that although this is currently only used for extended-remote,
5863 it is named remote_follow_fork in anticipation of using it for the
5864 remote target as well. */
5867 remote_target::follow_fork (bool follow_child
, bool detach_fork
)
5869 struct remote_state
*rs
= get_remote_state ();
5870 enum target_waitkind kind
= inferior_thread ()->pending_follow
.kind
;
5872 if ((kind
== TARGET_WAITKIND_FORKED
&& remote_fork_event_p (rs
))
5873 || (kind
== TARGET_WAITKIND_VFORKED
&& remote_vfork_event_p (rs
)))
5875 /* When following the parent and detaching the child, we detach
5876 the child here. For the case of following the child and
5877 detaching the parent, the detach is done in the target-
5878 independent follow fork code in infrun.c. We can't use
5879 target_detach when detaching an unfollowed child because
5880 the client side doesn't know anything about the child. */
5881 if (detach_fork
&& !follow_child
)
5883 /* Detach the fork child. */
5887 child_ptid
= inferior_thread ()->pending_follow
.value
.related_pid
;
5888 child_pid
= child_ptid
.pid ();
5890 remote_detach_pid (child_pid
);
5897 /* Target follow-exec function for remote targets. Save EXECD_PATHNAME
5898 in the program space of the new inferior. On entry and at return the
5899 current inferior is the exec'ing inferior. INF is the new exec'd
5900 inferior, which may be the same as the exec'ing inferior unless
5901 follow-exec-mode is "new". */
5904 remote_target::follow_exec (struct inferior
*inf
, const char *execd_pathname
)
5906 /* We know that this is a target file name, so if it has the "target:"
5907 prefix we strip it off before saving it in the program space. */
5908 if (is_target_filename (execd_pathname
))
5909 execd_pathname
+= strlen (TARGET_SYSROOT_PREFIX
);
5911 set_pspace_remote_exec_file (inf
->pspace
, execd_pathname
);
5914 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
5917 remote_target::disconnect (const char *args
, int from_tty
)
5920 error (_("Argument given to \"disconnect\" when remotely debugging."));
5922 /* Make sure we unpush even the extended remote targets. Calling
5923 target_mourn_inferior won't unpush, and
5924 remote_target::mourn_inferior won't unpush if there is more than
5925 one inferior left. */
5926 remote_unpush_target (this);
5929 puts_filtered ("Ending remote debugging.\n");
5932 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
5933 be chatty about it. */
5936 extended_remote_target::attach (const char *args
, int from_tty
)
5938 struct remote_state
*rs
= get_remote_state ();
5940 char *wait_status
= NULL
;
5942 pid
= parse_pid_to_attach (args
);
5944 /* Remote PID can be freely equal to getpid, do not check it here the same
5945 way as in other targets. */
5947 if (packet_support (PACKET_vAttach
) == PACKET_DISABLE
)
5948 error (_("This target does not support attaching to a process"));
5952 const char *exec_file
= get_exec_file (0);
5955 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file
,
5956 target_pid_to_str (ptid_t (pid
)).c_str ());
5958 printf_unfiltered (_("Attaching to %s\n"),
5959 target_pid_to_str (ptid_t (pid
)).c_str ());
5962 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "vAttach;%x", pid
);
5964 getpkt (&rs
->buf
, 0);
5966 switch (packet_ok (rs
->buf
,
5967 &remote_protocol_packets
[PACKET_vAttach
]))
5970 if (!target_is_non_stop_p ())
5972 /* Save the reply for later. */
5973 wait_status
= (char *) alloca (strlen (rs
->buf
.data ()) + 1);
5974 strcpy (wait_status
, rs
->buf
.data ());
5976 else if (strcmp (rs
->buf
.data (), "OK") != 0)
5977 error (_("Attaching to %s failed with: %s"),
5978 target_pid_to_str (ptid_t (pid
)).c_str (),
5981 case PACKET_UNKNOWN
:
5982 error (_("This target does not support attaching to a process"));
5984 error (_("Attaching to %s failed"),
5985 target_pid_to_str (ptid_t (pid
)).c_str ());
5988 switch_to_inferior_no_thread (remote_add_inferior (false, pid
, 1, 0));
5990 inferior_ptid
= ptid_t (pid
);
5992 if (target_is_non_stop_p ())
5994 /* Get list of threads. */
5995 update_thread_list ();
5997 thread_info
*thread
= first_thread_of_inferior (current_inferior ());
5998 if (thread
!= nullptr)
5999 switch_to_thread (thread
);
6001 /* Invalidate our notion of the remote current thread. */
6002 record_currthread (rs
, minus_one_ptid
);
6006 /* Now, if we have thread information, update the main thread's
6008 ptid_t curr_ptid
= remote_current_thread (ptid_t (pid
));
6010 /* Add the main thread to the thread list. */
6011 thread_info
*thr
= add_thread_silent (this, curr_ptid
);
6013 switch_to_thread (thr
);
6015 /* Don't consider the thread stopped until we've processed the
6016 saved stop reply. */
6017 set_executing (this, thr
->ptid
, true);
6020 /* Next, if the target can specify a description, read it. We do
6021 this before anything involving memory or registers. */
6022 target_find_description ();
6024 if (!target_is_non_stop_p ())
6026 /* Use the previously fetched status. */
6027 gdb_assert (wait_status
!= NULL
);
6029 if (target_can_async_p ())
6031 struct notif_event
*reply
6032 = remote_notif_parse (this, ¬if_client_stop
, wait_status
);
6034 push_stop_reply ((struct stop_reply
*) reply
);
6040 gdb_assert (wait_status
!= NULL
);
6041 strcpy (rs
->buf
.data (), wait_status
);
6042 rs
->cached_wait_status
= 1;
6046 gdb_assert (wait_status
== NULL
);
6049 /* Implementation of the to_post_attach method. */
6052 extended_remote_target::post_attach (int pid
)
6054 /* Get text, data & bss offsets. */
6057 /* In certain cases GDB might not have had the chance to start
6058 symbol lookup up until now. This could happen if the debugged
6059 binary is not using shared libraries, the vsyscall page is not
6060 present (on Linux) and the binary itself hadn't changed since the
6061 debugging process was started. */
6062 if (current_program_space
->symfile_object_file
!= NULL
)
6063 remote_check_symbols();
6067 /* Check for the availability of vCont. This function should also check
6071 remote_target::remote_vcont_probe ()
6073 remote_state
*rs
= get_remote_state ();
6076 strcpy (rs
->buf
.data (), "vCont?");
6078 getpkt (&rs
->buf
, 0);
6079 buf
= rs
->buf
.data ();
6081 /* Make sure that the features we assume are supported. */
6082 if (startswith (buf
, "vCont"))
6085 int support_c
, support_C
;
6087 rs
->supports_vCont
.s
= 0;
6088 rs
->supports_vCont
.S
= 0;
6091 rs
->supports_vCont
.t
= 0;
6092 rs
->supports_vCont
.r
= 0;
6093 while (p
&& *p
== ';')
6096 if (*p
== 's' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6097 rs
->supports_vCont
.s
= 1;
6098 else if (*p
== 'S' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6099 rs
->supports_vCont
.S
= 1;
6100 else if (*p
== 'c' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6102 else if (*p
== 'C' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6104 else if (*p
== 't' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6105 rs
->supports_vCont
.t
= 1;
6106 else if (*p
== 'r' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6107 rs
->supports_vCont
.r
= 1;
6109 p
= strchr (p
, ';');
6112 /* If c, and C are not all supported, we can't use vCont. Clearing
6113 BUF will make packet_ok disable the packet. */
6114 if (!support_c
|| !support_C
)
6118 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vCont
]);
6119 rs
->supports_vCont_probed
= true;
6122 /* Helper function for building "vCont" resumptions. Write a
6123 resumption to P. ENDP points to one-passed-the-end of the buffer
6124 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
6125 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
6126 resumed thread should be single-stepped and/or signalled. If PTID
6127 equals minus_one_ptid, then all threads are resumed; if PTID
6128 represents a process, then all threads of the process are resumed;
6129 the thread to be stepped and/or signalled is given in the global
6133 remote_target::append_resumption (char *p
, char *endp
,
6134 ptid_t ptid
, int step
, gdb_signal siggnal
)
6136 struct remote_state
*rs
= get_remote_state ();
6138 if (step
&& siggnal
!= GDB_SIGNAL_0
)
6139 p
+= xsnprintf (p
, endp
- p
, ";S%02x", siggnal
);
6141 /* GDB is willing to range step. */
6142 && use_range_stepping
6143 /* Target supports range stepping. */
6144 && rs
->supports_vCont
.r
6145 /* We don't currently support range stepping multiple
6146 threads with a wildcard (though the protocol allows it,
6147 so stubs shouldn't make an active effort to forbid
6149 && !(remote_multi_process_p (rs
) && ptid
.is_pid ()))
6151 struct thread_info
*tp
;
6153 if (ptid
== minus_one_ptid
)
6155 /* If we don't know about the target thread's tid, then
6156 we're resuming magic_null_ptid (see caller). */
6157 tp
= find_thread_ptid (this, magic_null_ptid
);
6160 tp
= find_thread_ptid (this, ptid
);
6161 gdb_assert (tp
!= NULL
);
6163 if (tp
->control
.may_range_step
)
6165 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
6167 p
+= xsnprintf (p
, endp
- p
, ";r%s,%s",
6168 phex_nz (tp
->control
.step_range_start
,
6170 phex_nz (tp
->control
.step_range_end
,
6174 p
+= xsnprintf (p
, endp
- p
, ";s");
6177 p
+= xsnprintf (p
, endp
- p
, ";s");
6178 else if (siggnal
!= GDB_SIGNAL_0
)
6179 p
+= xsnprintf (p
, endp
- p
, ";C%02x", siggnal
);
6181 p
+= xsnprintf (p
, endp
- p
, ";c");
6183 if (remote_multi_process_p (rs
) && ptid
.is_pid ())
6187 /* All (-1) threads of process. */
6188 nptid
= ptid_t (ptid
.pid (), -1, 0);
6190 p
+= xsnprintf (p
, endp
- p
, ":");
6191 p
= write_ptid (p
, endp
, nptid
);
6193 else if (ptid
!= minus_one_ptid
)
6195 p
+= xsnprintf (p
, endp
- p
, ":");
6196 p
= write_ptid (p
, endp
, ptid
);
6202 /* Clear the thread's private info on resume. */
6205 resume_clear_thread_private_info (struct thread_info
*thread
)
6207 if (thread
->priv
!= NULL
)
6209 remote_thread_info
*priv
= get_remote_thread_info (thread
);
6211 priv
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
6212 priv
->watch_data_address
= 0;
6216 /* Append a vCont continue-with-signal action for threads that have a
6217 non-zero stop signal. */
6220 remote_target::append_pending_thread_resumptions (char *p
, char *endp
,
6223 for (thread_info
*thread
: all_non_exited_threads (this, ptid
))
6224 if (inferior_ptid
!= thread
->ptid
6225 && thread
->suspend
.stop_signal
!= GDB_SIGNAL_0
)
6227 p
= append_resumption (p
, endp
, thread
->ptid
,
6228 0, thread
->suspend
.stop_signal
);
6229 thread
->suspend
.stop_signal
= GDB_SIGNAL_0
;
6230 resume_clear_thread_private_info (thread
);
6236 /* Set the target running, using the packets that use Hc
6240 remote_target::remote_resume_with_hc (ptid_t ptid
, int step
,
6243 struct remote_state
*rs
= get_remote_state ();
6246 rs
->last_sent_signal
= siggnal
;
6247 rs
->last_sent_step
= step
;
6249 /* The c/s/C/S resume packets use Hc, so set the continue
6251 if (ptid
== minus_one_ptid
)
6252 set_continue_thread (any_thread_ptid
);
6254 set_continue_thread (ptid
);
6256 for (thread_info
*thread
: all_non_exited_threads (this))
6257 resume_clear_thread_private_info (thread
);
6259 buf
= rs
->buf
.data ();
6260 if (::execution_direction
== EXEC_REVERSE
)
6262 /* We don't pass signals to the target in reverse exec mode. */
6263 if (info_verbose
&& siggnal
!= GDB_SIGNAL_0
)
6264 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
6267 if (step
&& packet_support (PACKET_bs
) == PACKET_DISABLE
)
6268 error (_("Remote reverse-step not supported."));
6269 if (!step
&& packet_support (PACKET_bc
) == PACKET_DISABLE
)
6270 error (_("Remote reverse-continue not supported."));
6272 strcpy (buf
, step
? "bs" : "bc");
6274 else if (siggnal
!= GDB_SIGNAL_0
)
6276 buf
[0] = step
? 'S' : 'C';
6277 buf
[1] = tohex (((int) siggnal
>> 4) & 0xf);
6278 buf
[2] = tohex (((int) siggnal
) & 0xf);
6282 strcpy (buf
, step
? "s" : "c");
6287 /* Resume the remote inferior by using a "vCont" packet. The thread
6288 to be resumed is PTID; STEP and SIGGNAL indicate whether the
6289 resumed thread should be single-stepped and/or signalled. If PTID
6290 equals minus_one_ptid, then all threads are resumed; the thread to
6291 be stepped and/or signalled is given in the global INFERIOR_PTID.
6292 This function returns non-zero iff it resumes the inferior.
6294 This function issues a strict subset of all possible vCont commands
6298 remote_target::remote_resume_with_vcont (ptid_t ptid
, int step
,
6299 enum gdb_signal siggnal
)
6301 struct remote_state
*rs
= get_remote_state ();
6305 /* No reverse execution actions defined for vCont. */
6306 if (::execution_direction
== EXEC_REVERSE
)
6309 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
6310 remote_vcont_probe ();
6312 if (packet_support (PACKET_vCont
) == PACKET_DISABLE
)
6315 p
= rs
->buf
.data ();
6316 endp
= p
+ get_remote_packet_size ();
6318 /* If we could generate a wider range of packets, we'd have to worry
6319 about overflowing BUF. Should there be a generic
6320 "multi-part-packet" packet? */
6322 p
+= xsnprintf (p
, endp
- p
, "vCont");
6324 if (ptid
== magic_null_ptid
)
6326 /* MAGIC_NULL_PTID means that we don't have any active threads,
6327 so we don't have any TID numbers the inferior will
6328 understand. Make sure to only send forms that do not specify
6330 append_resumption (p
, endp
, minus_one_ptid
, step
, siggnal
);
6332 else if (ptid
== minus_one_ptid
|| ptid
.is_pid ())
6334 /* Resume all threads (of all processes, or of a single
6335 process), with preference for INFERIOR_PTID. This assumes
6336 inferior_ptid belongs to the set of all threads we are about
6338 if (step
|| siggnal
!= GDB_SIGNAL_0
)
6340 /* Step inferior_ptid, with or without signal. */
6341 p
= append_resumption (p
, endp
, inferior_ptid
, step
, siggnal
);
6344 /* Also pass down any pending signaled resumption for other
6345 threads not the current. */
6346 p
= append_pending_thread_resumptions (p
, endp
, ptid
);
6348 /* And continue others without a signal. */
6349 append_resumption (p
, endp
, ptid
, /*step=*/ 0, GDB_SIGNAL_0
);
6353 /* Scheduler locking; resume only PTID. */
6354 append_resumption (p
, endp
, ptid
, step
, siggnal
);
6357 gdb_assert (strlen (rs
->buf
.data ()) < get_remote_packet_size ());
6360 if (target_is_non_stop_p ())
6362 /* In non-stop, the stub replies to vCont with "OK". The stop
6363 reply will be reported asynchronously by means of a `%Stop'
6365 getpkt (&rs
->buf
, 0);
6366 if (strcmp (rs
->buf
.data (), "OK") != 0)
6367 error (_("Unexpected vCont reply in non-stop mode: %s"),
6374 /* Tell the remote machine to resume. */
6377 remote_target::resume (ptid_t ptid
, int step
, enum gdb_signal siggnal
)
6379 struct remote_state
*rs
= get_remote_state ();
6381 /* When connected in non-stop mode, the core resumes threads
6382 individually. Resuming remote threads directly in target_resume
6383 would thus result in sending one packet per thread. Instead, to
6384 minimize roundtrip latency, here we just store the resume
6385 request (put the thread in RESUMED_PENDING_VCONT state); the actual remote
6386 resumption will be done in remote_target::commit_resume, where we'll be
6387 able to do vCont action coalescing. */
6388 if (target_is_non_stop_p () && ::execution_direction
!= EXEC_REVERSE
)
6390 remote_thread_info
*remote_thr
;
6392 if (minus_one_ptid
== ptid
|| ptid
.is_pid ())
6393 remote_thr
= get_remote_thread_info (this, inferior_ptid
);
6395 remote_thr
= get_remote_thread_info (this, ptid
);
6397 /* We don't expect the core to ask to resume an already resumed (from
6398 its point of view) thread. */
6399 gdb_assert (remote_thr
->resume_state () == resume_state::NOT_RESUMED
);
6401 remote_thr
->set_resumed_pending_vcont (step
, siggnal
);
6405 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
6406 (explained in remote-notif.c:handle_notification) so
6407 remote_notif_process is not called. We need find a place where
6408 it is safe to start a 'vNotif' sequence. It is good to do it
6409 before resuming inferior, because inferior was stopped and no RSP
6410 traffic at that moment. */
6411 if (!target_is_non_stop_p ())
6412 remote_notif_process (rs
->notif_state
, ¬if_client_stop
);
6414 rs
->last_resume_exec_dir
= ::execution_direction
;
6416 /* Prefer vCont, and fallback to s/c/S/C, which use Hc. */
6417 if (!remote_resume_with_vcont (ptid
, step
, siggnal
))
6418 remote_resume_with_hc (ptid
, step
, siggnal
);
6420 /* Update resumed state tracked by the remote target. */
6421 for (thread_info
*tp
: all_non_exited_threads (this, ptid
))
6422 get_remote_thread_info (tp
)->set_resumed ();
6424 /* We are about to start executing the inferior, let's register it
6425 with the event loop. NOTE: this is the one place where all the
6426 execution commands end up. We could alternatively do this in each
6427 of the execution commands in infcmd.c. */
6428 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
6429 into infcmd.c in order to allow inferior function calls to work
6430 NOT asynchronously. */
6431 if (target_can_async_p ())
6434 /* We've just told the target to resume. The remote server will
6435 wait for the inferior to stop, and then send a stop reply. In
6436 the mean time, we can't start another command/query ourselves
6437 because the stub wouldn't be ready to process it. This applies
6438 only to the base all-stop protocol, however. In non-stop (which
6439 only supports vCont), the stub replies with an "OK", and is
6440 immediate able to process further serial input. */
6441 if (!target_is_non_stop_p ())
6442 rs
->waiting_for_stop_reply
= 1;
6445 static int is_pending_fork_parent_thread (struct thread_info
*thread
);
6447 /* Private per-inferior info for target remote processes. */
6449 struct remote_inferior
: public private_inferior
6451 /* Whether we can send a wildcard vCont for this process. */
6452 bool may_wildcard_vcont
= true;
6455 /* Get the remote private inferior data associated to INF. */
6457 static remote_inferior
*
6458 get_remote_inferior (inferior
*inf
)
6460 if (inf
->priv
== NULL
)
6461 inf
->priv
.reset (new remote_inferior
);
6463 return static_cast<remote_inferior
*> (inf
->priv
.get ());
6466 /* Class used to track the construction of a vCont packet in the
6467 outgoing packet buffer. This is used to send multiple vCont
6468 packets if we have more actions than would fit a single packet. */
6473 explicit vcont_builder (remote_target
*remote
)
6480 void push_action (ptid_t ptid
, bool step
, gdb_signal siggnal
);
6485 /* The remote target. */
6486 remote_target
*m_remote
;
6488 /* Pointer to the first action. P points here if no action has been
6490 char *m_first_action
;
6492 /* Where the next action will be appended. */
6495 /* The end of the buffer. Must never write past this. */
6499 /* Prepare the outgoing buffer for a new vCont packet. */
6502 vcont_builder::restart ()
6504 struct remote_state
*rs
= m_remote
->get_remote_state ();
6506 m_p
= rs
->buf
.data ();
6507 m_endp
= m_p
+ m_remote
->get_remote_packet_size ();
6508 m_p
+= xsnprintf (m_p
, m_endp
- m_p
, "vCont");
6509 m_first_action
= m_p
;
6512 /* If the vCont packet being built has any action, send it to the
6516 vcont_builder::flush ()
6518 struct remote_state
*rs
;
6520 if (m_p
== m_first_action
)
6523 rs
= m_remote
->get_remote_state ();
6524 m_remote
->putpkt (rs
->buf
);
6525 m_remote
->getpkt (&rs
->buf
, 0);
6526 if (strcmp (rs
->buf
.data (), "OK") != 0)
6527 error (_("Unexpected vCont reply in non-stop mode: %s"), rs
->buf
.data ());
6530 /* The largest action is range-stepping, with its two addresses. This
6531 is more than sufficient. If a new, bigger action is created, it'll
6532 quickly trigger a failed assertion in append_resumption (and we'll
6534 #define MAX_ACTION_SIZE 200
6536 /* Append a new vCont action in the outgoing packet being built. If
6537 the action doesn't fit the packet along with previous actions, push
6538 what we've got so far to the remote end and start over a new vCont
6539 packet (with the new action). */
6542 vcont_builder::push_action (ptid_t ptid
, bool step
, gdb_signal siggnal
)
6544 char buf
[MAX_ACTION_SIZE
+ 1];
6546 char *endp
= m_remote
->append_resumption (buf
, buf
+ sizeof (buf
),
6547 ptid
, step
, siggnal
);
6549 /* Check whether this new action would fit in the vCont packet along
6550 with previous actions. If not, send what we've got so far and
6551 start a new vCont packet. */
6552 size_t rsize
= endp
- buf
;
6553 if (rsize
> m_endp
- m_p
)
6558 /* Should now fit. */
6559 gdb_assert (rsize
<= m_endp
- m_p
);
6562 memcpy (m_p
, buf
, rsize
);
6567 /* to_commit_resume implementation. */
6570 remote_target::commit_resume ()
6572 int any_process_wildcard
;
6573 int may_global_wildcard_vcont
;
6575 /* If connected in all-stop mode, we'd send the remote resume
6576 request directly from remote_resume. Likewise if
6577 reverse-debugging, as there are no defined vCont actions for
6578 reverse execution. */
6579 if (!target_is_non_stop_p () || ::execution_direction
== EXEC_REVERSE
)
6582 /* Try to send wildcard actions ("vCont;c" or "vCont;c:pPID.-1")
6583 instead of resuming all threads of each process individually.
6584 However, if any thread of a process must remain halted, we can't
6585 send wildcard resumes and must send one action per thread.
6587 Care must be taken to not resume threads/processes the server
6588 side already told us are stopped, but the core doesn't know about
6589 yet, because the events are still in the vStopped notification
6592 #1 => vCont s:p1.1;c
6594 #3 <= %Stopped T05 p1.1
6599 #8 (infrun handles the stop for p1.1 and continues stepping)
6600 #9 => vCont s:p1.1;c
6602 The last vCont above would resume thread p1.2 by mistake, because
6603 the server has no idea that the event for p1.2 had not been
6606 The server side must similarly ignore resume actions for the
6607 thread that has a pending %Stopped notification (and any other
6608 threads with events pending), until GDB acks the notification
6609 with vStopped. Otherwise, e.g., the following case is
6612 #1 => g (or any other packet)
6614 #3 <= %Stopped T05 p1.2
6615 #4 => vCont s:p1.1;c
6618 Above, the server must not resume thread p1.2. GDB can't know
6619 that p1.2 stopped until it acks the %Stopped notification, and
6620 since from GDB's perspective all threads should be running, it
6623 Finally, special care must also be given to handling fork/vfork
6624 events. A (v)fork event actually tells us that two processes
6625 stopped -- the parent and the child. Until we follow the fork,
6626 we must not resume the child. Therefore, if we have a pending
6627 fork follow, we must not send a global wildcard resume action
6628 (vCont;c). We can still send process-wide wildcards though. */
6630 /* Start by assuming a global wildcard (vCont;c) is possible. */
6631 may_global_wildcard_vcont
= 1;
6633 /* And assume every process is individually wildcard-able too. */
6634 for (inferior
*inf
: all_non_exited_inferiors (this))
6636 remote_inferior
*priv
= get_remote_inferior (inf
);
6638 priv
->may_wildcard_vcont
= true;
6641 /* Check for any pending events (not reported or processed yet) and
6642 disable process and global wildcard resumes appropriately. */
6643 check_pending_events_prevent_wildcard_vcont (&may_global_wildcard_vcont
);
6645 for (thread_info
*tp
: all_non_exited_threads (this))
6647 remote_thread_info
*priv
= get_remote_thread_info (tp
);
6649 /* If a thread of a process is not meant to be resumed, then we
6650 can't wildcard that process. */
6651 if (priv
->resume_state () == resume_state::NOT_RESUMED
)
6653 get_remote_inferior (tp
->inf
)->may_wildcard_vcont
= false;
6655 /* And if we can't wildcard a process, we can't wildcard
6656 everything either. */
6657 may_global_wildcard_vcont
= 0;
6661 /* If a thread is the parent of an unfollowed fork, then we
6662 can't do a global wildcard, as that would resume the fork
6664 if (is_pending_fork_parent_thread (tp
))
6665 may_global_wildcard_vcont
= 0;
6668 /* Now let's build the vCont packet(s). Actions must be appended
6669 from narrower to wider scopes (thread -> process -> global). If
6670 we end up with too many actions for a single packet vcont_builder
6671 flushes the current vCont packet to the remote side and starts a
6673 struct vcont_builder
vcont_builder (this);
6675 /* Threads first. */
6676 for (thread_info
*tp
: all_non_exited_threads (this))
6678 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6680 /* If the thread was previously vCont-resumed, no need to send a specific
6681 action for it. If we didn't receive a resume request for it, don't
6682 send an action for it either. */
6683 if (remote_thr
->resume_state () != resume_state::RESUMED_PENDING_VCONT
)
6686 gdb_assert (!thread_is_in_step_over_chain (tp
));
6688 const resumed_pending_vcont_info
&info
6689 = remote_thr
->resumed_pending_vcont_info ();
6691 /* Check if we need to send a specific action for this thread. If not,
6692 it will be included in a wildcard resume instead. */
6693 if (info
.step
|| info
.sig
!= GDB_SIGNAL_0
6694 || !get_remote_inferior (tp
->inf
)->may_wildcard_vcont
)
6695 vcont_builder
.push_action (tp
->ptid
, info
.step
, info
.sig
);
6697 remote_thr
->set_resumed ();
6700 /* Now check whether we can send any process-wide wildcard. This is
6701 to avoid sending a global wildcard in the case nothing is
6702 supposed to be resumed. */
6703 any_process_wildcard
= 0;
6705 for (inferior
*inf
: all_non_exited_inferiors (this))
6707 if (get_remote_inferior (inf
)->may_wildcard_vcont
)
6709 any_process_wildcard
= 1;
6714 if (any_process_wildcard
)
6716 /* If all processes are wildcard-able, then send a single "c"
6717 action, otherwise, send an "all (-1) threads of process"
6718 continue action for each running process, if any. */
6719 if (may_global_wildcard_vcont
)
6721 vcont_builder
.push_action (minus_one_ptid
,
6722 false, GDB_SIGNAL_0
);
6726 for (inferior
*inf
: all_non_exited_inferiors (this))
6728 if (get_remote_inferior (inf
)->may_wildcard_vcont
)
6730 vcont_builder
.push_action (ptid_t (inf
->pid
),
6731 false, GDB_SIGNAL_0
);
6737 vcont_builder
.flush ();
6742 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
6743 thread, all threads of a remote process, or all threads of all
6747 remote_target::remote_stop_ns (ptid_t ptid
)
6749 struct remote_state
*rs
= get_remote_state ();
6750 char *p
= rs
->buf
.data ();
6751 char *endp
= p
+ get_remote_packet_size ();
6753 /* FIXME: This supports_vCont_probed check is a workaround until
6754 packet_support is per-connection. */
6755 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
6756 || !rs
->supports_vCont_probed
)
6757 remote_vcont_probe ();
6759 if (!rs
->supports_vCont
.t
)
6760 error (_("Remote server does not support stopping threads"));
6762 if (ptid
== minus_one_ptid
6763 || (!remote_multi_process_p (rs
) && ptid
.is_pid ()))
6764 p
+= xsnprintf (p
, endp
- p
, "vCont;t");
6769 p
+= xsnprintf (p
, endp
- p
, "vCont;t:");
6772 /* All (-1) threads of process. */
6773 nptid
= ptid_t (ptid
.pid (), -1, 0);
6776 /* Small optimization: if we already have a stop reply for
6777 this thread, no use in telling the stub we want this
6779 if (peek_stop_reply (ptid
))
6785 write_ptid (p
, endp
, nptid
);
6788 /* In non-stop, we get an immediate OK reply. The stop reply will
6789 come in asynchronously by notification. */
6791 getpkt (&rs
->buf
, 0);
6792 if (strcmp (rs
->buf
.data (), "OK") != 0)
6793 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid
).c_str (),
6797 /* All-stop version of target_interrupt. Sends a break or a ^C to
6798 interrupt the remote target. It is undefined which thread of which
6799 process reports the interrupt. */
6802 remote_target::remote_interrupt_as ()
6804 struct remote_state
*rs
= get_remote_state ();
6806 rs
->ctrlc_pending_p
= 1;
6808 /* If the inferior is stopped already, but the core didn't know
6809 about it yet, just ignore the request. The cached wait status
6810 will be collected in remote_wait. */
6811 if (rs
->cached_wait_status
)
6814 /* Send interrupt_sequence to remote target. */
6815 send_interrupt_sequence ();
6818 /* Non-stop version of target_interrupt. Uses `vCtrlC' to interrupt
6819 the remote target. It is undefined which thread of which process
6820 reports the interrupt. Throws an error if the packet is not
6821 supported by the server. */
6824 remote_target::remote_interrupt_ns ()
6826 struct remote_state
*rs
= get_remote_state ();
6827 char *p
= rs
->buf
.data ();
6828 char *endp
= p
+ get_remote_packet_size ();
6830 xsnprintf (p
, endp
- p
, "vCtrlC");
6832 /* In non-stop, we get an immediate OK reply. The stop reply will
6833 come in asynchronously by notification. */
6835 getpkt (&rs
->buf
, 0);
6837 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vCtrlC
]))
6841 case PACKET_UNKNOWN
:
6842 error (_("No support for interrupting the remote target."));
6844 error (_("Interrupting target failed: %s"), rs
->buf
.data ());
6848 /* Implement the to_stop function for the remote targets. */
6851 remote_target::stop (ptid_t ptid
)
6854 fprintf_unfiltered (gdb_stdlog
, "remote_stop called\n");
6856 if (target_is_non_stop_p ())
6857 remote_stop_ns (ptid
);
6860 /* We don't currently have a way to transparently pause the
6861 remote target in all-stop mode. Interrupt it instead. */
6862 remote_interrupt_as ();
6866 /* Implement the to_interrupt function for the remote targets. */
6869 remote_target::interrupt ()
6872 fprintf_unfiltered (gdb_stdlog
, "remote_interrupt called\n");
6874 if (target_is_non_stop_p ())
6875 remote_interrupt_ns ();
6877 remote_interrupt_as ();
6880 /* Implement the to_pass_ctrlc function for the remote targets. */
6883 remote_target::pass_ctrlc ()
6885 struct remote_state
*rs
= get_remote_state ();
6888 fprintf_unfiltered (gdb_stdlog
, "remote_pass_ctrlc called\n");
6890 /* If we're starting up, we're not fully synced yet. Quit
6892 if (rs
->starting_up
)
6894 /* If ^C has already been sent once, offer to disconnect. */
6895 else if (rs
->ctrlc_pending_p
)
6898 target_interrupt ();
6901 /* Ask the user what to do when an interrupt is received. */
6904 remote_target::interrupt_query ()
6906 struct remote_state
*rs
= get_remote_state ();
6908 if (rs
->waiting_for_stop_reply
&& rs
->ctrlc_pending_p
)
6910 if (query (_("The target is not responding to interrupt requests.\n"
6911 "Stop debugging it? ")))
6913 remote_unpush_target (this);
6914 throw_error (TARGET_CLOSE_ERROR
, _("Disconnected from target."));
6919 if (query (_("Interrupted while waiting for the program.\n"
6920 "Give up waiting? ")))
6925 /* Enable/disable target terminal ownership. Most targets can use
6926 terminal groups to control terminal ownership. Remote targets are
6927 different in that explicit transfer of ownership to/from GDB/target
6931 remote_target::terminal_inferior ()
6933 /* NOTE: At this point we could also register our selves as the
6934 recipient of all input. Any characters typed could then be
6935 passed on down to the target. */
6939 remote_target::terminal_ours ()
6944 remote_console_output (const char *msg
)
6948 for (p
= msg
; p
[0] && p
[1]; p
+= 2)
6951 char c
= fromhex (p
[0]) * 16 + fromhex (p
[1]);
6955 gdb_stdtarg
->puts (tb
);
6957 gdb_stdtarg
->flush ();
6960 struct stop_reply
: public notif_event
6964 /* The identifier of the thread about this event */
6967 /* The remote state this event is associated with. When the remote
6968 connection, represented by a remote_state object, is closed,
6969 all the associated stop_reply events should be released. */
6970 struct remote_state
*rs
;
6972 struct target_waitstatus ws
;
6974 /* The architecture associated with the expedited registers. */
6977 /* Expedited registers. This makes remote debugging a bit more
6978 efficient for those targets that provide critical registers as
6979 part of their normal status mechanism (as another roundtrip to
6980 fetch them is avoided). */
6981 std::vector
<cached_reg_t
> regcache
;
6983 enum target_stop_reason stop_reason
;
6985 CORE_ADDR watch_data_address
;
6990 /* Return the length of the stop reply queue. */
6993 remote_target::stop_reply_queue_length ()
6995 remote_state
*rs
= get_remote_state ();
6996 return rs
->stop_reply_queue
.size ();
7000 remote_notif_stop_parse (remote_target
*remote
,
7001 struct notif_client
*self
, const char *buf
,
7002 struct notif_event
*event
)
7004 remote
->remote_parse_stop_reply (buf
, (struct stop_reply
*) event
);
7008 remote_notif_stop_ack (remote_target
*remote
,
7009 struct notif_client
*self
, const char *buf
,
7010 struct notif_event
*event
)
7012 struct stop_reply
*stop_reply
= (struct stop_reply
*) event
;
7015 putpkt (remote
, self
->ack_command
);
7017 if (stop_reply
->ws
.kind
== TARGET_WAITKIND_IGNORE
)
7019 /* We got an unknown stop reply. */
7020 error (_("Unknown stop reply"));
7023 remote
->push_stop_reply (stop_reply
);
7027 remote_notif_stop_can_get_pending_events (remote_target
*remote
,
7028 struct notif_client
*self
)
7030 /* We can't get pending events in remote_notif_process for
7031 notification stop, and we have to do this in remote_wait_ns
7032 instead. If we fetch all queued events from stub, remote stub
7033 may exit and we have no chance to process them back in
7035 remote_state
*rs
= remote
->get_remote_state ();
7036 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7040 stop_reply::~stop_reply ()
7042 for (cached_reg_t
®
: regcache
)
7046 static notif_event_up
7047 remote_notif_stop_alloc_reply ()
7049 return notif_event_up (new struct stop_reply ());
7052 /* A client of notification Stop. */
7054 struct notif_client notif_client_stop
=
7058 remote_notif_stop_parse
,
7059 remote_notif_stop_ack
,
7060 remote_notif_stop_can_get_pending_events
,
7061 remote_notif_stop_alloc_reply
,
7065 /* Determine if THREAD_PTID is a pending fork parent thread. ARG contains
7066 the pid of the process that owns the threads we want to check, or
7067 -1 if we want to check all threads. */
7070 is_pending_fork_parent (struct target_waitstatus
*ws
, int event_pid
,
7073 if (ws
->kind
== TARGET_WAITKIND_FORKED
7074 || ws
->kind
== TARGET_WAITKIND_VFORKED
)
7076 if (event_pid
== -1 || event_pid
== thread_ptid
.pid ())
7083 /* Return the thread's pending status used to determine whether the
7084 thread is a fork parent stopped at a fork event. */
7086 static struct target_waitstatus
*
7087 thread_pending_fork_status (struct thread_info
*thread
)
7089 if (thread
->suspend
.waitstatus_pending_p
)
7090 return &thread
->suspend
.waitstatus
;
7092 return &thread
->pending_follow
;
7095 /* Determine if THREAD is a pending fork parent thread. */
7098 is_pending_fork_parent_thread (struct thread_info
*thread
)
7100 struct target_waitstatus
*ws
= thread_pending_fork_status (thread
);
7103 return is_pending_fork_parent (ws
, pid
, thread
->ptid
);
7106 /* If CONTEXT contains any fork child threads that have not been
7107 reported yet, remove them from the CONTEXT list. If such a
7108 thread exists it is because we are stopped at a fork catchpoint
7109 and have not yet called follow_fork, which will set up the
7110 host-side data structures for the new process. */
7113 remote_target::remove_new_fork_children (threads_listing_context
*context
)
7116 struct notif_client
*notif
= ¬if_client_stop
;
7118 /* For any threads stopped at a fork event, remove the corresponding
7119 fork child threads from the CONTEXT list. */
7120 for (thread_info
*thread
: all_non_exited_threads (this))
7122 struct target_waitstatus
*ws
= thread_pending_fork_status (thread
);
7124 if (is_pending_fork_parent (ws
, pid
, thread
->ptid
))
7125 context
->remove_thread (ws
->value
.related_pid
);
7128 /* Check for any pending fork events (not reported or processed yet)
7129 in process PID and remove those fork child threads from the
7130 CONTEXT list as well. */
7131 remote_notif_get_pending_events (notif
);
7132 for (auto &event
: get_remote_state ()->stop_reply_queue
)
7133 if (event
->ws
.kind
== TARGET_WAITKIND_FORKED
7134 || event
->ws
.kind
== TARGET_WAITKIND_VFORKED
7135 || event
->ws
.kind
== TARGET_WAITKIND_THREAD_EXITED
)
7136 context
->remove_thread (event
->ws
.value
.related_pid
);
7139 /* Check whether any event pending in the vStopped queue would prevent
7140 a global or process wildcard vCont action. Clear
7141 *may_global_wildcard if we can't do a global wildcard (vCont;c),
7142 and clear the event inferior's may_wildcard_vcont flag if we can't
7143 do a process-wide wildcard resume (vCont;c:pPID.-1). */
7146 remote_target::check_pending_events_prevent_wildcard_vcont
7147 (int *may_global_wildcard
)
7149 struct notif_client
*notif
= ¬if_client_stop
;
7151 remote_notif_get_pending_events (notif
);
7152 for (auto &event
: get_remote_state ()->stop_reply_queue
)
7154 if (event
->ws
.kind
== TARGET_WAITKIND_NO_RESUMED
7155 || event
->ws
.kind
== TARGET_WAITKIND_NO_HISTORY
)
7158 if (event
->ws
.kind
== TARGET_WAITKIND_FORKED
7159 || event
->ws
.kind
== TARGET_WAITKIND_VFORKED
)
7160 *may_global_wildcard
= 0;
7162 struct inferior
*inf
= find_inferior_ptid (this, event
->ptid
);
7164 /* This may be the first time we heard about this process.
7165 Regardless, we must not do a global wildcard resume, otherwise
7166 we'd resume this process too. */
7167 *may_global_wildcard
= 0;
7169 get_remote_inferior (inf
)->may_wildcard_vcont
= false;
7173 /* Discard all pending stop replies of inferior INF. */
7176 remote_target::discard_pending_stop_replies (struct inferior
*inf
)
7178 struct stop_reply
*reply
;
7179 struct remote_state
*rs
= get_remote_state ();
7180 struct remote_notif_state
*rns
= rs
->notif_state
;
7182 /* This function can be notified when an inferior exists. When the
7183 target is not remote, the notification state is NULL. */
7184 if (rs
->remote_desc
== NULL
)
7187 reply
= (struct stop_reply
*) rns
->pending_event
[notif_client_stop
.id
];
7189 /* Discard the in-flight notification. */
7190 if (reply
!= NULL
&& reply
->ptid
.pid () == inf
->pid
)
7193 rns
->pending_event
[notif_client_stop
.id
] = NULL
;
7196 /* Discard the stop replies we have already pulled with
7198 auto iter
= std::remove_if (rs
->stop_reply_queue
.begin (),
7199 rs
->stop_reply_queue
.end (),
7200 [=] (const stop_reply_up
&event
)
7202 return event
->ptid
.pid () == inf
->pid
;
7204 rs
->stop_reply_queue
.erase (iter
, rs
->stop_reply_queue
.end ());
7207 /* Discard the stop replies for RS in stop_reply_queue. */
7210 remote_target::discard_pending_stop_replies_in_queue ()
7212 remote_state
*rs
= get_remote_state ();
7214 /* Discard the stop replies we have already pulled with
7216 auto iter
= std::remove_if (rs
->stop_reply_queue
.begin (),
7217 rs
->stop_reply_queue
.end (),
7218 [=] (const stop_reply_up
&event
)
7220 return event
->rs
== rs
;
7222 rs
->stop_reply_queue
.erase (iter
, rs
->stop_reply_queue
.end ());
7225 /* Remove the first reply in 'stop_reply_queue' which matches
7229 remote_target::remote_notif_remove_queued_reply (ptid_t ptid
)
7231 remote_state
*rs
= get_remote_state ();
7233 auto iter
= std::find_if (rs
->stop_reply_queue
.begin (),
7234 rs
->stop_reply_queue
.end (),
7235 [=] (const stop_reply_up
&event
)
7237 return event
->ptid
.matches (ptid
);
7239 struct stop_reply
*result
;
7240 if (iter
== rs
->stop_reply_queue
.end ())
7244 result
= iter
->release ();
7245 rs
->stop_reply_queue
.erase (iter
);
7249 fprintf_unfiltered (gdb_stdlog
,
7250 "notif: discard queued event: 'Stop' in %s\n",
7251 target_pid_to_str (ptid
).c_str ());
7256 /* Look for a queued stop reply belonging to PTID. If one is found,
7257 remove it from the queue, and return it. Returns NULL if none is
7258 found. If there are still queued events left to process, tell the
7259 event loop to get back to target_wait soon. */
7262 remote_target::queued_stop_reply (ptid_t ptid
)
7264 remote_state
*rs
= get_remote_state ();
7265 struct stop_reply
*r
= remote_notif_remove_queued_reply (ptid
);
7267 if (!rs
->stop_reply_queue
.empty ())
7269 /* There's still at least an event left. */
7270 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7276 /* Push a fully parsed stop reply in the stop reply queue. Since we
7277 know that we now have at least one queued event left to pass to the
7278 core side, tell the event loop to get back to target_wait soon. */
7281 remote_target::push_stop_reply (struct stop_reply
*new_event
)
7283 remote_state
*rs
= get_remote_state ();
7284 rs
->stop_reply_queue
.push_back (stop_reply_up (new_event
));
7287 fprintf_unfiltered (gdb_stdlog
,
7288 "notif: push 'Stop' %s to queue %d\n",
7289 target_pid_to_str (new_event
->ptid
).c_str (),
7290 int (rs
->stop_reply_queue
.size ()));
7292 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7295 /* Returns true if we have a stop reply for PTID. */
7298 remote_target::peek_stop_reply (ptid_t ptid
)
7300 remote_state
*rs
= get_remote_state ();
7301 for (auto &event
: rs
->stop_reply_queue
)
7302 if (ptid
== event
->ptid
7303 && event
->ws
.kind
== TARGET_WAITKIND_STOPPED
)
7308 /* Helper for remote_parse_stop_reply. Return nonzero if the substring
7309 starting with P and ending with PEND matches PREFIX. */
7312 strprefix (const char *p
, const char *pend
, const char *prefix
)
7314 for ( ; p
< pend
; p
++, prefix
++)
7317 return *prefix
== '\0';
7320 /* Parse the stop reply in BUF. Either the function succeeds, and the
7321 result is stored in EVENT, or throws an error. */
7324 remote_target::remote_parse_stop_reply (const char *buf
, stop_reply
*event
)
7326 remote_arch_state
*rsa
= NULL
;
7331 event
->ptid
= null_ptid
;
7332 event
->rs
= get_remote_state ();
7333 event
->ws
.kind
= TARGET_WAITKIND_IGNORE
;
7334 event
->ws
.value
.integer
= 0;
7335 event
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
7336 event
->regcache
.clear ();
7341 case 'T': /* Status with PC, SP, FP, ... */
7342 /* Expedited reply, containing Signal, {regno, reg} repeat. */
7343 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
7345 n... = register number
7346 r... = register contents
7349 p
= &buf
[3]; /* after Txx */
7355 p1
= strchr (p
, ':');
7357 error (_("Malformed packet(a) (missing colon): %s\n\
7361 error (_("Malformed packet(a) (missing register number): %s\n\
7365 /* Some "registers" are actually extended stop information.
7366 Note if you're adding a new entry here: GDB 7.9 and
7367 earlier assume that all register "numbers" that start
7368 with an hex digit are real register numbers. Make sure
7369 the server only sends such a packet if it knows the
7370 client understands it. */
7372 if (strprefix (p
, p1
, "thread"))
7373 event
->ptid
= read_ptid (++p1
, &p
);
7374 else if (strprefix (p
, p1
, "syscall_entry"))
7378 event
->ws
.kind
= TARGET_WAITKIND_SYSCALL_ENTRY
;
7379 p
= unpack_varlen_hex (++p1
, &sysno
);
7380 event
->ws
.value
.syscall_number
= (int) sysno
;
7382 else if (strprefix (p
, p1
, "syscall_return"))
7386 event
->ws
.kind
= TARGET_WAITKIND_SYSCALL_RETURN
;
7387 p
= unpack_varlen_hex (++p1
, &sysno
);
7388 event
->ws
.value
.syscall_number
= (int) sysno
;
7390 else if (strprefix (p
, p1
, "watch")
7391 || strprefix (p
, p1
, "rwatch")
7392 || strprefix (p
, p1
, "awatch"))
7394 event
->stop_reason
= TARGET_STOPPED_BY_WATCHPOINT
;
7395 p
= unpack_varlen_hex (++p1
, &addr
);
7396 event
->watch_data_address
= (CORE_ADDR
) addr
;
7398 else if (strprefix (p
, p1
, "swbreak"))
7400 event
->stop_reason
= TARGET_STOPPED_BY_SW_BREAKPOINT
;
7402 /* Make sure the stub doesn't forget to indicate support
7404 if (packet_support (PACKET_swbreak_feature
) != PACKET_ENABLE
)
7405 error (_("Unexpected swbreak stop reason"));
7407 /* The value part is documented as "must be empty",
7408 though we ignore it, in case we ever decide to make
7409 use of it in a backward compatible way. */
7410 p
= strchrnul (p1
+ 1, ';');
7412 else if (strprefix (p
, p1
, "hwbreak"))
7414 event
->stop_reason
= TARGET_STOPPED_BY_HW_BREAKPOINT
;
7416 /* Make sure the stub doesn't forget to indicate support
7418 if (packet_support (PACKET_hwbreak_feature
) != PACKET_ENABLE
)
7419 error (_("Unexpected hwbreak stop reason"));
7422 p
= strchrnul (p1
+ 1, ';');
7424 else if (strprefix (p
, p1
, "library"))
7426 event
->ws
.kind
= TARGET_WAITKIND_LOADED
;
7427 p
= strchrnul (p1
+ 1, ';');
7429 else if (strprefix (p
, p1
, "replaylog"))
7431 event
->ws
.kind
= TARGET_WAITKIND_NO_HISTORY
;
7432 /* p1 will indicate "begin" or "end", but it makes
7433 no difference for now, so ignore it. */
7434 p
= strchrnul (p1
+ 1, ';');
7436 else if (strprefix (p
, p1
, "core"))
7440 p
= unpack_varlen_hex (++p1
, &c
);
7443 else if (strprefix (p
, p1
, "fork"))
7445 event
->ws
.value
.related_pid
= read_ptid (++p1
, &p
);
7446 event
->ws
.kind
= TARGET_WAITKIND_FORKED
;
7448 else if (strprefix (p
, p1
, "vfork"))
7450 event
->ws
.value
.related_pid
= read_ptid (++p1
, &p
);
7451 event
->ws
.kind
= TARGET_WAITKIND_VFORKED
;
7453 else if (strprefix (p
, p1
, "vforkdone"))
7455 event
->ws
.kind
= TARGET_WAITKIND_VFORK_DONE
;
7456 p
= strchrnul (p1
+ 1, ';');
7458 else if (strprefix (p
, p1
, "exec"))
7463 /* Determine the length of the execd pathname. */
7464 p
= unpack_varlen_hex (++p1
, &ignored
);
7465 pathlen
= (p
- p1
) / 2;
7467 /* Save the pathname for event reporting and for
7468 the next run command. */
7469 gdb::unique_xmalloc_ptr
<char[]> pathname
7470 ((char *) xmalloc (pathlen
+ 1));
7471 hex2bin (p1
, (gdb_byte
*) pathname
.get (), pathlen
);
7472 pathname
[pathlen
] = '\0';
7474 /* This is freed during event handling. */
7475 event
->ws
.value
.execd_pathname
= pathname
.release ();
7476 event
->ws
.kind
= TARGET_WAITKIND_EXECD
;
7478 /* Skip the registers included in this packet, since
7479 they may be for an architecture different from the
7480 one used by the original program. */
7483 else if (strprefix (p
, p1
, "create"))
7485 event
->ws
.kind
= TARGET_WAITKIND_THREAD_CREATED
;
7486 p
= strchrnul (p1
+ 1, ';');
7495 p
= strchrnul (p1
+ 1, ';');
7500 /* Maybe a real ``P'' register number. */
7501 p_temp
= unpack_varlen_hex (p
, &pnum
);
7502 /* If the first invalid character is the colon, we got a
7503 register number. Otherwise, it's an unknown stop
7507 /* If we haven't parsed the event's thread yet, find
7508 it now, in order to find the architecture of the
7509 reported expedited registers. */
7510 if (event
->ptid
== null_ptid
)
7512 /* If there is no thread-id information then leave
7513 the event->ptid as null_ptid. Later in
7514 process_stop_reply we will pick a suitable
7516 const char *thr
= strstr (p1
+ 1, ";thread:");
7518 event
->ptid
= read_ptid (thr
+ strlen (";thread:"),
7525 = (event
->ptid
== null_ptid
7527 : find_inferior_ptid (this, event
->ptid
));
7528 /* If this is the first time we learn anything
7529 about this process, skip the registers
7530 included in this packet, since we don't yet
7531 know which architecture to use to parse them.
7532 We'll determine the architecture later when
7533 we process the stop reply and retrieve the
7534 target description, via
7535 remote_notice_new_inferior ->
7536 post_create_inferior. */
7539 p
= strchrnul (p1
+ 1, ';');
7544 event
->arch
= inf
->gdbarch
;
7545 rsa
= event
->rs
->get_remote_arch_state (event
->arch
);
7549 = packet_reg_from_pnum (event
->arch
, rsa
, pnum
);
7550 cached_reg_t cached_reg
;
7553 error (_("Remote sent bad register number %s: %s\n\
7555 hex_string (pnum
), p
, buf
);
7557 cached_reg
.num
= reg
->regnum
;
7558 cached_reg
.data
= (gdb_byte
*)
7559 xmalloc (register_size (event
->arch
, reg
->regnum
));
7562 fieldsize
= hex2bin (p
, cached_reg
.data
,
7563 register_size (event
->arch
, reg
->regnum
));
7565 if (fieldsize
< register_size (event
->arch
, reg
->regnum
))
7566 warning (_("Remote reply is too short: %s"), buf
);
7568 event
->regcache
.push_back (cached_reg
);
7572 /* Not a number. Silently skip unknown optional
7574 p
= strchrnul (p1
+ 1, ';');
7579 error (_("Remote register badly formatted: %s\nhere: %s"),
7584 if (event
->ws
.kind
!= TARGET_WAITKIND_IGNORE
)
7588 case 'S': /* Old style status, just signal only. */
7592 event
->ws
.kind
= TARGET_WAITKIND_STOPPED
;
7593 sig
= (fromhex (buf
[1]) << 4) + fromhex (buf
[2]);
7594 if (GDB_SIGNAL_FIRST
<= sig
&& sig
< GDB_SIGNAL_LAST
)
7595 event
->ws
.value
.sig
= (enum gdb_signal
) sig
;
7597 event
->ws
.value
.sig
= GDB_SIGNAL_UNKNOWN
;
7600 case 'w': /* Thread exited. */
7604 event
->ws
.kind
= TARGET_WAITKIND_THREAD_EXITED
;
7605 p
= unpack_varlen_hex (&buf
[1], &value
);
7606 event
->ws
.value
.integer
= value
;
7608 error (_("stop reply packet badly formatted: %s"), buf
);
7609 event
->ptid
= read_ptid (++p
, NULL
);
7612 case 'W': /* Target exited. */
7617 /* GDB used to accept only 2 hex chars here. Stubs should
7618 only send more if they detect GDB supports multi-process
7620 p
= unpack_varlen_hex (&buf
[1], &value
);
7624 /* The remote process exited. */
7625 event
->ws
.kind
= TARGET_WAITKIND_EXITED
;
7626 event
->ws
.value
.integer
= value
;
7630 /* The remote process exited with a signal. */
7631 event
->ws
.kind
= TARGET_WAITKIND_SIGNALLED
;
7632 if (GDB_SIGNAL_FIRST
<= value
&& value
< GDB_SIGNAL_LAST
)
7633 event
->ws
.value
.sig
= (enum gdb_signal
) value
;
7635 event
->ws
.value
.sig
= GDB_SIGNAL_UNKNOWN
;
7638 /* If no process is specified, return null_ptid, and let the
7639 caller figure out the right process to use. */
7649 else if (startswith (p
, "process:"))
7653 p
+= sizeof ("process:") - 1;
7654 unpack_varlen_hex (p
, &upid
);
7658 error (_("unknown stop reply packet: %s"), buf
);
7661 error (_("unknown stop reply packet: %s"), buf
);
7662 event
->ptid
= ptid_t (pid
);
7666 event
->ws
.kind
= TARGET_WAITKIND_NO_RESUMED
;
7667 event
->ptid
= minus_one_ptid
;
7672 /* When the stub wants to tell GDB about a new notification reply, it
7673 sends a notification (%Stop, for example). Those can come it at
7674 any time, hence, we have to make sure that any pending
7675 putpkt/getpkt sequence we're making is finished, before querying
7676 the stub for more events with the corresponding ack command
7677 (vStopped, for example). E.g., if we started a vStopped sequence
7678 immediately upon receiving the notification, something like this
7686 1.6) <-- (registers reply to step #1.3)
7688 Obviously, the reply in step #1.6 would be unexpected to a vStopped
7691 To solve this, whenever we parse a %Stop notification successfully,
7692 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
7693 doing whatever we were doing:
7699 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
7700 2.5) <-- (registers reply to step #2.3)
7702 Eventually after step #2.5, we return to the event loop, which
7703 notices there's an event on the
7704 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
7705 associated callback --- the function below. At this point, we're
7706 always safe to start a vStopped sequence. :
7709 2.7) <-- T05 thread:2
7715 remote_target::remote_notif_get_pending_events (notif_client
*nc
)
7717 struct remote_state
*rs
= get_remote_state ();
7719 if (rs
->notif_state
->pending_event
[nc
->id
] != NULL
)
7722 fprintf_unfiltered (gdb_stdlog
,
7723 "notif: process: '%s' ack pending event\n",
7727 nc
->ack (this, nc
, rs
->buf
.data (),
7728 rs
->notif_state
->pending_event
[nc
->id
]);
7729 rs
->notif_state
->pending_event
[nc
->id
] = NULL
;
7733 getpkt (&rs
->buf
, 0);
7734 if (strcmp (rs
->buf
.data (), "OK") == 0)
7737 remote_notif_ack (this, nc
, rs
->buf
.data ());
7743 fprintf_unfiltered (gdb_stdlog
,
7744 "notif: process: '%s' no pending reply\n",
7749 /* Wrapper around remote_target::remote_notif_get_pending_events to
7750 avoid having to export the whole remote_target class. */
7753 remote_notif_get_pending_events (remote_target
*remote
, notif_client
*nc
)
7755 remote
->remote_notif_get_pending_events (nc
);
7758 /* Called from process_stop_reply when the stop packet we are responding
7759 to didn't include a process-id or thread-id. STATUS is the stop event
7760 we are responding to.
7762 It is the task of this function to select a suitable thread (or process)
7763 and return its ptid, this is the thread (or process) we will assume the
7764 stop event came from.
7766 In some cases there isn't really any choice about which thread (or
7767 process) is selected, a basic remote with a single process containing a
7768 single thread might choose not to send any process-id or thread-id in
7769 its stop packets, this function will select and return the one and only
7772 However, if a target supports multiple threads (or processes) and still
7773 doesn't include a thread-id (or process-id) in its stop packet then
7774 first, this is a badly behaving target, and second, we're going to have
7775 to select a thread (or process) at random and use that. This function
7776 will print a warning to the user if it detects that there is the
7777 possibility that GDB is guessing which thread (or process) to
7780 Note that this is called before GDB fetches the updated thread list from the
7781 target. So it's possible for the stop reply to be ambiguous and for GDB to
7782 not realize it. For example, if there's initially one thread, the target
7783 spawns a second thread, and then sends a stop reply without an id that
7784 concerns the first thread. GDB will assume the stop reply is about the
7785 first thread - the only thread it knows about - without printing a warning.
7786 Anyway, if the remote meant for the stop reply to be about the second thread,
7787 then it would be really broken, because GDB doesn't know about that thread
7791 remote_target::select_thread_for_ambiguous_stop_reply
7792 (const struct target_waitstatus
*status
)
7794 /* Some stop events apply to all threads in an inferior, while others
7795 only apply to a single thread. */
7796 bool process_wide_stop
7797 = (status
->kind
== TARGET_WAITKIND_EXITED
7798 || status
->kind
== TARGET_WAITKIND_SIGNALLED
);
7800 thread_info
*first_resumed_thread
= nullptr;
7801 bool ambiguous
= false;
7803 /* Consider all non-exited threads of the target, find the first resumed
7805 for (thread_info
*thr
: all_non_exited_threads (this))
7807 remote_thread_info
*remote_thr
= get_remote_thread_info (thr
);
7809 if (remote_thr
->resume_state () != resume_state::RESUMED
)
7812 if (first_resumed_thread
== nullptr)
7813 first_resumed_thread
= thr
;
7814 else if (!process_wide_stop
7815 || first_resumed_thread
->ptid
.pid () != thr
->ptid
.pid ())
7819 gdb_assert (first_resumed_thread
!= nullptr);
7821 /* Warn if the remote target is sending ambiguous stop replies. */
7824 static bool warned
= false;
7828 /* If you are seeing this warning then the remote target has
7829 stopped without specifying a thread-id, but the target
7830 does have multiple threads (or inferiors), and so GDB is
7831 having to guess which thread stopped.
7833 Examples of what might cause this are the target sending
7834 and 'S' stop packet, or a 'T' stop packet and not
7835 including a thread-id.
7837 Additionally, the target might send a 'W' or 'X packet
7838 without including a process-id, when the target has
7839 multiple running inferiors. */
7840 if (process_wide_stop
)
7841 warning (_("multi-inferior target stopped without "
7842 "sending a process-id, using first "
7843 "non-exited inferior"));
7845 warning (_("multi-threaded target stopped without "
7846 "sending a thread-id, using first "
7847 "non-exited thread"));
7852 /* If this is a stop for all threads then don't use a particular threads
7853 ptid, instead create a new ptid where only the pid field is set. */
7854 if (process_wide_stop
)
7855 return ptid_t (first_resumed_thread
->ptid
.pid ());
7857 return first_resumed_thread
->ptid
;
7860 /* Called when it is decided that STOP_REPLY holds the info of the
7861 event that is to be returned to the core. This function always
7862 destroys STOP_REPLY. */
7865 remote_target::process_stop_reply (struct stop_reply
*stop_reply
,
7866 struct target_waitstatus
*status
)
7868 *status
= stop_reply
->ws
;
7869 ptid_t ptid
= stop_reply
->ptid
;
7871 /* If no thread/process was reported by the stub then select a suitable
7873 if (ptid
== null_ptid
)
7874 ptid
= select_thread_for_ambiguous_stop_reply (status
);
7875 gdb_assert (ptid
!= null_ptid
);
7877 if (status
->kind
!= TARGET_WAITKIND_EXITED
7878 && status
->kind
!= TARGET_WAITKIND_SIGNALLED
7879 && status
->kind
!= TARGET_WAITKIND_NO_RESUMED
)
7881 /* Expedited registers. */
7882 if (!stop_reply
->regcache
.empty ())
7884 struct regcache
*regcache
7885 = get_thread_arch_regcache (this, ptid
, stop_reply
->arch
);
7887 for (cached_reg_t
®
: stop_reply
->regcache
)
7889 regcache
->raw_supply (reg
.num
, reg
.data
);
7893 stop_reply
->regcache
.clear ();
7896 remote_notice_new_inferior (ptid
, 0);
7897 remote_thread_info
*remote_thr
= get_remote_thread_info (this, ptid
);
7898 remote_thr
->core
= stop_reply
->core
;
7899 remote_thr
->stop_reason
= stop_reply
->stop_reason
;
7900 remote_thr
->watch_data_address
= stop_reply
->watch_data_address
;
7902 if (target_is_non_stop_p ())
7904 /* If the target works in non-stop mode, a stop-reply indicates that
7905 only this thread stopped. */
7906 remote_thr
->set_not_resumed ();
7910 /* If the target works in all-stop mode, a stop-reply indicates that
7911 all the target's threads stopped. */
7912 for (thread_info
*tp
: all_non_exited_threads (this))
7913 get_remote_thread_info (tp
)->set_not_resumed ();
7921 /* The non-stop mode version of target_wait. */
7924 remote_target::wait_ns (ptid_t ptid
, struct target_waitstatus
*status
,
7925 target_wait_flags options
)
7927 struct remote_state
*rs
= get_remote_state ();
7928 struct stop_reply
*stop_reply
;
7932 /* If in non-stop mode, get out of getpkt even if a
7933 notification is received. */
7935 ret
= getpkt_or_notif_sane (&rs
->buf
, 0 /* forever */, &is_notif
);
7938 if (ret
!= -1 && !is_notif
)
7941 case 'E': /* Error of some sort. */
7942 /* We're out of sync with the target now. Did it continue
7943 or not? We can't tell which thread it was in non-stop,
7944 so just ignore this. */
7945 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
7947 case 'O': /* Console output. */
7948 remote_console_output (&rs
->buf
[1]);
7951 warning (_("Invalid remote reply: %s"), rs
->buf
.data ());
7955 /* Acknowledge a pending stop reply that may have arrived in the
7957 if (rs
->notif_state
->pending_event
[notif_client_stop
.id
] != NULL
)
7958 remote_notif_get_pending_events (¬if_client_stop
);
7960 /* If indeed we noticed a stop reply, we're done. */
7961 stop_reply
= queued_stop_reply (ptid
);
7962 if (stop_reply
!= NULL
)
7963 return process_stop_reply (stop_reply
, status
);
7965 /* Still no event. If we're just polling for an event, then
7966 return to the event loop. */
7967 if (options
& TARGET_WNOHANG
)
7969 status
->kind
= TARGET_WAITKIND_IGNORE
;
7970 return minus_one_ptid
;
7973 /* Otherwise do a blocking wait. */
7974 ret
= getpkt_or_notif_sane (&rs
->buf
, 1 /* forever */, &is_notif
);
7978 /* Return the first resumed thread. */
7981 first_remote_resumed_thread (remote_target
*target
)
7983 for (thread_info
*tp
: all_non_exited_threads (target
, minus_one_ptid
))
7989 /* Wait until the remote machine stops, then return, storing status in
7990 STATUS just as `wait' would. */
7993 remote_target::wait_as (ptid_t ptid
, target_waitstatus
*status
,
7994 target_wait_flags options
)
7996 struct remote_state
*rs
= get_remote_state ();
7997 ptid_t event_ptid
= null_ptid
;
7999 struct stop_reply
*stop_reply
;
8003 status
->kind
= TARGET_WAITKIND_IGNORE
;
8004 status
->value
.integer
= 0;
8006 stop_reply
= queued_stop_reply (ptid
);
8007 if (stop_reply
!= NULL
)
8008 return process_stop_reply (stop_reply
, status
);
8010 if (rs
->cached_wait_status
)
8011 /* Use the cached wait status, but only once. */
8012 rs
->cached_wait_status
= 0;
8017 int forever
= ((options
& TARGET_WNOHANG
) == 0
8018 && rs
->wait_forever_enabled_p
);
8020 if (!rs
->waiting_for_stop_reply
)
8022 status
->kind
= TARGET_WAITKIND_NO_RESUMED
;
8023 return minus_one_ptid
;
8026 /* FIXME: cagney/1999-09-27: If we're in async mode we should
8027 _never_ wait for ever -> test on target_is_async_p().
8028 However, before we do that we need to ensure that the caller
8029 knows how to take the target into/out of async mode. */
8030 ret
= getpkt_or_notif_sane (&rs
->buf
, forever
, &is_notif
);
8032 /* GDB gets a notification. Return to core as this event is
8034 if (ret
!= -1 && is_notif
)
8035 return minus_one_ptid
;
8037 if (ret
== -1 && (options
& TARGET_WNOHANG
) != 0)
8038 return minus_one_ptid
;
8041 buf
= rs
->buf
.data ();
8043 /* Assume that the target has acknowledged Ctrl-C unless we receive
8044 an 'F' or 'O' packet. */
8045 if (buf
[0] != 'F' && buf
[0] != 'O')
8046 rs
->ctrlc_pending_p
= 0;
8050 case 'E': /* Error of some sort. */
8051 /* We're out of sync with the target now. Did it continue or
8052 not? Not is more likely, so report a stop. */
8053 rs
->waiting_for_stop_reply
= 0;
8055 warning (_("Remote failure reply: %s"), buf
);
8056 status
->kind
= TARGET_WAITKIND_STOPPED
;
8057 status
->value
.sig
= GDB_SIGNAL_0
;
8059 case 'F': /* File-I/O request. */
8060 /* GDB may access the inferior memory while handling the File-I/O
8061 request, but we don't want GDB accessing memory while waiting
8062 for a stop reply. See the comments in putpkt_binary. Set
8063 waiting_for_stop_reply to 0 temporarily. */
8064 rs
->waiting_for_stop_reply
= 0;
8065 remote_fileio_request (this, buf
, rs
->ctrlc_pending_p
);
8066 rs
->ctrlc_pending_p
= 0;
8067 /* GDB handled the File-I/O request, and the target is running
8068 again. Keep waiting for events. */
8069 rs
->waiting_for_stop_reply
= 1;
8071 case 'N': case 'T': case 'S': case 'X': case 'W':
8073 /* There is a stop reply to handle. */
8074 rs
->waiting_for_stop_reply
= 0;
8077 = (struct stop_reply
*) remote_notif_parse (this,
8081 event_ptid
= process_stop_reply (stop_reply
, status
);
8084 case 'O': /* Console output. */
8085 remote_console_output (buf
+ 1);
8088 if (rs
->last_sent_signal
!= GDB_SIGNAL_0
)
8090 /* Zero length reply means that we tried 'S' or 'C' and the
8091 remote system doesn't support it. */
8092 target_terminal::ours_for_output ();
8094 ("Can't send signals to this remote system. %s not sent.\n",
8095 gdb_signal_to_name (rs
->last_sent_signal
));
8096 rs
->last_sent_signal
= GDB_SIGNAL_0
;
8097 target_terminal::inferior ();
8099 strcpy (buf
, rs
->last_sent_step
? "s" : "c");
8105 warning (_("Invalid remote reply: %s"), buf
);
8109 if (status
->kind
== TARGET_WAITKIND_NO_RESUMED
)
8110 return minus_one_ptid
;
8111 else if (status
->kind
== TARGET_WAITKIND_IGNORE
)
8113 /* Nothing interesting happened. If we're doing a non-blocking
8114 poll, we're done. Otherwise, go back to waiting. */
8115 if (options
& TARGET_WNOHANG
)
8116 return minus_one_ptid
;
8120 else if (status
->kind
!= TARGET_WAITKIND_EXITED
8121 && status
->kind
!= TARGET_WAITKIND_SIGNALLED
)
8123 if (event_ptid
!= null_ptid
)
8124 record_currthread (rs
, event_ptid
);
8126 event_ptid
= first_remote_resumed_thread (this);
8130 /* A process exit. Invalidate our notion of current thread. */
8131 record_currthread (rs
, minus_one_ptid
);
8132 /* It's possible that the packet did not include a pid. */
8133 if (event_ptid
== null_ptid
)
8134 event_ptid
= first_remote_resumed_thread (this);
8135 /* EVENT_PTID could still be NULL_PTID. Double-check. */
8136 if (event_ptid
== null_ptid
)
8137 event_ptid
= magic_null_ptid
;
8143 /* Wait until the remote machine stops, then return, storing status in
8144 STATUS just as `wait' would. */
8147 remote_target::wait (ptid_t ptid
, struct target_waitstatus
*status
,
8148 target_wait_flags options
)
8152 if (target_is_non_stop_p ())
8153 event_ptid
= wait_ns (ptid
, status
, options
);
8155 event_ptid
= wait_as (ptid
, status
, options
);
8157 if (target_is_async_p ())
8159 remote_state
*rs
= get_remote_state ();
8161 /* If there are are events left in the queue tell the event loop
8163 if (!rs
->stop_reply_queue
.empty ())
8164 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
8170 /* Fetch a single register using a 'p' packet. */
8173 remote_target::fetch_register_using_p (struct regcache
*regcache
,
8176 struct gdbarch
*gdbarch
= regcache
->arch ();
8177 struct remote_state
*rs
= get_remote_state ();
8179 gdb_byte
*regp
= (gdb_byte
*) alloca (register_size (gdbarch
, reg
->regnum
));
8182 if (packet_support (PACKET_p
) == PACKET_DISABLE
)
8185 if (reg
->pnum
== -1)
8188 p
= rs
->buf
.data ();
8190 p
+= hexnumstr (p
, reg
->pnum
);
8193 getpkt (&rs
->buf
, 0);
8195 buf
= rs
->buf
.data ();
8197 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_p
]))
8201 case PACKET_UNKNOWN
:
8204 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
8205 gdbarch_register_name (regcache
->arch (),
8210 /* If this register is unfetchable, tell the regcache. */
8213 regcache
->raw_supply (reg
->regnum
, NULL
);
8217 /* Otherwise, parse and supply the value. */
8223 error (_("fetch_register_using_p: early buf termination"));
8225 regp
[i
++] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
8228 regcache
->raw_supply (reg
->regnum
, regp
);
8232 /* Fetch the registers included in the target's 'g' packet. */
8235 remote_target::send_g_packet ()
8237 struct remote_state
*rs
= get_remote_state ();
8240 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "g");
8242 getpkt (&rs
->buf
, 0);
8243 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
8244 error (_("Could not read registers; remote failure reply '%s'"),
8247 /* We can get out of synch in various cases. If the first character
8248 in the buffer is not a hex character, assume that has happened
8249 and try to fetch another packet to read. */
8250 while ((rs
->buf
[0] < '0' || rs
->buf
[0] > '9')
8251 && (rs
->buf
[0] < 'A' || rs
->buf
[0] > 'F')
8252 && (rs
->buf
[0] < 'a' || rs
->buf
[0] > 'f')
8253 && rs
->buf
[0] != 'x') /* New: unavailable register value. */
8256 fprintf_unfiltered (gdb_stdlog
,
8257 "Bad register packet; fetching a new packet\n");
8258 getpkt (&rs
->buf
, 0);
8261 buf_len
= strlen (rs
->buf
.data ());
8263 /* Sanity check the received packet. */
8264 if (buf_len
% 2 != 0)
8265 error (_("Remote 'g' packet reply is of odd length: %s"), rs
->buf
.data ());
8271 remote_target::process_g_packet (struct regcache
*regcache
)
8273 struct gdbarch
*gdbarch
= regcache
->arch ();
8274 struct remote_state
*rs
= get_remote_state ();
8275 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8280 buf_len
= strlen (rs
->buf
.data ());
8282 /* Further sanity checks, with knowledge of the architecture. */
8283 if (buf_len
> 2 * rsa
->sizeof_g_packet
)
8284 error (_("Remote 'g' packet reply is too long (expected %ld bytes, got %d "
8286 rsa
->sizeof_g_packet
, buf_len
/ 2,
8289 /* Save the size of the packet sent to us by the target. It is used
8290 as a heuristic when determining the max size of packets that the
8291 target can safely receive. */
8292 if (rsa
->actual_register_packet_size
== 0)
8293 rsa
->actual_register_packet_size
= buf_len
;
8295 /* If this is smaller than we guessed the 'g' packet would be,
8296 update our records. A 'g' reply that doesn't include a register's
8297 value implies either that the register is not available, or that
8298 the 'p' packet must be used. */
8299 if (buf_len
< 2 * rsa
->sizeof_g_packet
)
8301 long sizeof_g_packet
= buf_len
/ 2;
8303 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8305 long offset
= rsa
->regs
[i
].offset
;
8306 long reg_size
= register_size (gdbarch
, i
);
8308 if (rsa
->regs
[i
].pnum
== -1)
8311 if (offset
>= sizeof_g_packet
)
8312 rsa
->regs
[i
].in_g_packet
= 0;
8313 else if (offset
+ reg_size
> sizeof_g_packet
)
8314 error (_("Truncated register %d in remote 'g' packet"), i
);
8316 rsa
->regs
[i
].in_g_packet
= 1;
8319 /* Looks valid enough, we can assume this is the correct length
8320 for a 'g' packet. It's important not to adjust
8321 rsa->sizeof_g_packet if we have truncated registers otherwise
8322 this "if" won't be run the next time the method is called
8323 with a packet of the same size and one of the internal errors
8324 below will trigger instead. */
8325 rsa
->sizeof_g_packet
= sizeof_g_packet
;
8328 regs
= (char *) alloca (rsa
->sizeof_g_packet
);
8330 /* Unimplemented registers read as all bits zero. */
8331 memset (regs
, 0, rsa
->sizeof_g_packet
);
8333 /* Reply describes registers byte by byte, each byte encoded as two
8334 hex characters. Suck them all up, then supply them to the
8335 register cacheing/storage mechanism. */
8337 p
= rs
->buf
.data ();
8338 for (i
= 0; i
< rsa
->sizeof_g_packet
; i
++)
8340 if (p
[0] == 0 || p
[1] == 0)
8341 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
8342 internal_error (__FILE__
, __LINE__
,
8343 _("unexpected end of 'g' packet reply"));
8345 if (p
[0] == 'x' && p
[1] == 'x')
8346 regs
[i
] = 0; /* 'x' */
8348 regs
[i
] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
8352 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8354 struct packet_reg
*r
= &rsa
->regs
[i
];
8355 long reg_size
= register_size (gdbarch
, i
);
8359 if ((r
->offset
+ reg_size
) * 2 > strlen (rs
->buf
.data ()))
8360 /* This shouldn't happen - we adjusted in_g_packet above. */
8361 internal_error (__FILE__
, __LINE__
,
8362 _("unexpected end of 'g' packet reply"));
8363 else if (rs
->buf
[r
->offset
* 2] == 'x')
8365 gdb_assert (r
->offset
* 2 < strlen (rs
->buf
.data ()));
8366 /* The register isn't available, mark it as such (at
8367 the same time setting the value to zero). */
8368 regcache
->raw_supply (r
->regnum
, NULL
);
8371 regcache
->raw_supply (r
->regnum
, regs
+ r
->offset
);
8377 remote_target::fetch_registers_using_g (struct regcache
*regcache
)
8380 process_g_packet (regcache
);
8383 /* Make the remote selected traceframe match GDB's selected
8387 remote_target::set_remote_traceframe ()
8390 struct remote_state
*rs
= get_remote_state ();
8392 if (rs
->remote_traceframe_number
== get_traceframe_number ())
8395 /* Avoid recursion, remote_trace_find calls us again. */
8396 rs
->remote_traceframe_number
= get_traceframe_number ();
8398 newnum
= target_trace_find (tfind_number
,
8399 get_traceframe_number (), 0, 0, NULL
);
8401 /* Should not happen. If it does, all bets are off. */
8402 if (newnum
!= get_traceframe_number ())
8403 warning (_("could not set remote traceframe"));
8407 remote_target::fetch_registers (struct regcache
*regcache
, int regnum
)
8409 struct gdbarch
*gdbarch
= regcache
->arch ();
8410 struct remote_state
*rs
= get_remote_state ();
8411 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8414 set_remote_traceframe ();
8415 set_general_thread (regcache
->ptid ());
8419 packet_reg
*reg
= packet_reg_from_regnum (gdbarch
, rsa
, regnum
);
8421 gdb_assert (reg
!= NULL
);
8423 /* If this register might be in the 'g' packet, try that first -
8424 we are likely to read more than one register. If this is the
8425 first 'g' packet, we might be overly optimistic about its
8426 contents, so fall back to 'p'. */
8427 if (reg
->in_g_packet
)
8429 fetch_registers_using_g (regcache
);
8430 if (reg
->in_g_packet
)
8434 if (fetch_register_using_p (regcache
, reg
))
8437 /* This register is not available. */
8438 regcache
->raw_supply (reg
->regnum
, NULL
);
8443 fetch_registers_using_g (regcache
);
8445 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8446 if (!rsa
->regs
[i
].in_g_packet
)
8447 if (!fetch_register_using_p (regcache
, &rsa
->regs
[i
]))
8449 /* This register is not available. */
8450 regcache
->raw_supply (i
, NULL
);
8454 /* Prepare to store registers. Since we may send them all (using a
8455 'G' request), we have to read out the ones we don't want to change
8459 remote_target::prepare_to_store (struct regcache
*regcache
)
8461 struct remote_state
*rs
= get_remote_state ();
8462 remote_arch_state
*rsa
= rs
->get_remote_arch_state (regcache
->arch ());
8465 /* Make sure the entire registers array is valid. */
8466 switch (packet_support (PACKET_P
))
8468 case PACKET_DISABLE
:
8469 case PACKET_SUPPORT_UNKNOWN
:
8470 /* Make sure all the necessary registers are cached. */
8471 for (i
= 0; i
< gdbarch_num_regs (regcache
->arch ()); i
++)
8472 if (rsa
->regs
[i
].in_g_packet
)
8473 regcache
->raw_update (rsa
->regs
[i
].regnum
);
8480 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
8481 packet was not recognized. */
8484 remote_target::store_register_using_P (const struct regcache
*regcache
,
8487 struct gdbarch
*gdbarch
= regcache
->arch ();
8488 struct remote_state
*rs
= get_remote_state ();
8489 /* Try storing a single register. */
8490 char *buf
= rs
->buf
.data ();
8491 gdb_byte
*regp
= (gdb_byte
*) alloca (register_size (gdbarch
, reg
->regnum
));
8494 if (packet_support (PACKET_P
) == PACKET_DISABLE
)
8497 if (reg
->pnum
== -1)
8500 xsnprintf (buf
, get_remote_packet_size (), "P%s=", phex_nz (reg
->pnum
, 0));
8501 p
= buf
+ strlen (buf
);
8502 regcache
->raw_collect (reg
->regnum
, regp
);
8503 bin2hex (regp
, p
, register_size (gdbarch
, reg
->regnum
));
8505 getpkt (&rs
->buf
, 0);
8507 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_P
]))
8512 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
8513 gdbarch_register_name (gdbarch
, reg
->regnum
), rs
->buf
.data ());
8514 case PACKET_UNKNOWN
:
8517 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
8521 /* Store register REGNUM, or all registers if REGNUM == -1, from the
8522 contents of the register cache buffer. FIXME: ignores errors. */
8525 remote_target::store_registers_using_G (const struct regcache
*regcache
)
8527 struct remote_state
*rs
= get_remote_state ();
8528 remote_arch_state
*rsa
= rs
->get_remote_arch_state (regcache
->arch ());
8532 /* Extract all the registers in the regcache copying them into a
8537 regs
= (gdb_byte
*) alloca (rsa
->sizeof_g_packet
);
8538 memset (regs
, 0, rsa
->sizeof_g_packet
);
8539 for (i
= 0; i
< gdbarch_num_regs (regcache
->arch ()); i
++)
8541 struct packet_reg
*r
= &rsa
->regs
[i
];
8544 regcache
->raw_collect (r
->regnum
, regs
+ r
->offset
);
8548 /* Command describes registers byte by byte,
8549 each byte encoded as two hex characters. */
8550 p
= rs
->buf
.data ();
8552 bin2hex (regs
, p
, rsa
->sizeof_g_packet
);
8554 getpkt (&rs
->buf
, 0);
8555 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
8556 error (_("Could not write registers; remote failure reply '%s'"),
8560 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
8561 of the register cache buffer. FIXME: ignores errors. */
8564 remote_target::store_registers (struct regcache
*regcache
, int regnum
)
8566 struct gdbarch
*gdbarch
= regcache
->arch ();
8567 struct remote_state
*rs
= get_remote_state ();
8568 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8571 set_remote_traceframe ();
8572 set_general_thread (regcache
->ptid ());
8576 packet_reg
*reg
= packet_reg_from_regnum (gdbarch
, rsa
, regnum
);
8578 gdb_assert (reg
!= NULL
);
8580 /* Always prefer to store registers using the 'P' packet if
8581 possible; we often change only a small number of registers.
8582 Sometimes we change a larger number; we'd need help from a
8583 higher layer to know to use 'G'. */
8584 if (store_register_using_P (regcache
, reg
))
8587 /* For now, don't complain if we have no way to write the
8588 register. GDB loses track of unavailable registers too
8589 easily. Some day, this may be an error. We don't have
8590 any way to read the register, either... */
8591 if (!reg
->in_g_packet
)
8594 store_registers_using_G (regcache
);
8598 store_registers_using_G (regcache
);
8600 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8601 if (!rsa
->regs
[i
].in_g_packet
)
8602 if (!store_register_using_P (regcache
, &rsa
->regs
[i
]))
8603 /* See above for why we do not issue an error here. */
8608 /* Return the number of hex digits in num. */
8611 hexnumlen (ULONGEST num
)
8615 for (i
= 0; num
!= 0; i
++)
8618 return std::max (i
, 1);
8621 /* Set BUF to the minimum number of hex digits representing NUM. */
8624 hexnumstr (char *buf
, ULONGEST num
)
8626 int len
= hexnumlen (num
);
8628 return hexnumnstr (buf
, num
, len
);
8632 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
8635 hexnumnstr (char *buf
, ULONGEST num
, int width
)
8641 for (i
= width
- 1; i
>= 0; i
--)
8643 buf
[i
] = "0123456789abcdef"[(num
& 0xf)];
8650 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
8653 remote_address_masked (CORE_ADDR addr
)
8655 unsigned int address_size
= remote_address_size
;
8657 /* If "remoteaddresssize" was not set, default to target address size. */
8659 address_size
= gdbarch_addr_bit (target_gdbarch ());
8661 if (address_size
> 0
8662 && address_size
< (sizeof (ULONGEST
) * 8))
8664 /* Only create a mask when that mask can safely be constructed
8665 in a ULONGEST variable. */
8668 mask
= (mask
<< address_size
) - 1;
8674 /* Determine whether the remote target supports binary downloading.
8675 This is accomplished by sending a no-op memory write of zero length
8676 to the target at the specified address. It does not suffice to send
8677 the whole packet, since many stubs strip the eighth bit and
8678 subsequently compute a wrong checksum, which causes real havoc with
8681 NOTE: This can still lose if the serial line is not eight-bit
8682 clean. In cases like this, the user should clear "remote
8686 remote_target::check_binary_download (CORE_ADDR addr
)
8688 struct remote_state
*rs
= get_remote_state ();
8690 switch (packet_support (PACKET_X
))
8692 case PACKET_DISABLE
:
8696 case PACKET_SUPPORT_UNKNOWN
:
8700 p
= rs
->buf
.data ();
8702 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8704 p
+= hexnumstr (p
, (ULONGEST
) 0);
8708 putpkt_binary (rs
->buf
.data (), (int) (p
- rs
->buf
.data ()));
8709 getpkt (&rs
->buf
, 0);
8711 if (rs
->buf
[0] == '\0')
8714 fprintf_unfiltered (gdb_stdlog
,
8715 "binary downloading NOT "
8716 "supported by target\n");
8717 remote_protocol_packets
[PACKET_X
].support
= PACKET_DISABLE
;
8722 fprintf_unfiltered (gdb_stdlog
,
8723 "binary downloading supported by target\n");
8724 remote_protocol_packets
[PACKET_X
].support
= PACKET_ENABLE
;
8731 /* Helper function to resize the payload in order to try to get a good
8732 alignment. We try to write an amount of data such that the next write will
8733 start on an address aligned on REMOTE_ALIGN_WRITES. */
8736 align_for_efficient_write (int todo
, CORE_ADDR memaddr
)
8738 return ((memaddr
+ todo
) & ~(REMOTE_ALIGN_WRITES
- 1)) - memaddr
;
8741 /* Write memory data directly to the remote machine.
8742 This does not inform the data cache; the data cache uses this.
8743 HEADER is the starting part of the packet.
8744 MEMADDR is the address in the remote memory space.
8745 MYADDR is the address of the buffer in our space.
8746 LEN_UNITS is the number of addressable units to write.
8747 UNIT_SIZE is the length in bytes of an addressable unit.
8748 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
8749 should send data as binary ('X'), or hex-encoded ('M').
8751 The function creates packet of the form
8752 <HEADER><ADDRESS>,<LENGTH>:<DATA>
8754 where encoding of <DATA> is terminated by PACKET_FORMAT.
8756 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
8759 Return the transferred status, error or OK (an
8760 'enum target_xfer_status' value). Save the number of addressable units
8761 transferred in *XFERED_LEN_UNITS. Only transfer a single packet.
8763 On a platform with an addressable memory size of 2 bytes (UNIT_SIZE == 2), an
8764 exchange between gdb and the stub could look like (?? in place of the
8770 -> $M1000,3:eeeeffffeeee#??
8774 <- eeeeffffeeeedddd */
8777 remote_target::remote_write_bytes_aux (const char *header
, CORE_ADDR memaddr
,
8778 const gdb_byte
*myaddr
,
8781 ULONGEST
*xfered_len_units
,
8782 char packet_format
, int use_length
)
8784 struct remote_state
*rs
= get_remote_state ();
8790 int payload_capacity_bytes
;
8791 int payload_length_bytes
;
8793 if (packet_format
!= 'X' && packet_format
!= 'M')
8794 internal_error (__FILE__
, __LINE__
,
8795 _("remote_write_bytes_aux: bad packet format"));
8798 return TARGET_XFER_EOF
;
8800 payload_capacity_bytes
= get_memory_write_packet_size ();
8802 /* The packet buffer will be large enough for the payload;
8803 get_memory_packet_size ensures this. */
8806 /* Compute the size of the actual payload by subtracting out the
8807 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
8809 payload_capacity_bytes
-= strlen ("$,:#NN");
8811 /* The comma won't be used. */
8812 payload_capacity_bytes
+= 1;
8813 payload_capacity_bytes
-= strlen (header
);
8814 payload_capacity_bytes
-= hexnumlen (memaddr
);
8816 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
8818 strcat (rs
->buf
.data (), header
);
8819 p
= rs
->buf
.data () + strlen (header
);
8821 /* Compute a best guess of the number of bytes actually transfered. */
8822 if (packet_format
== 'X')
8824 /* Best guess at number of bytes that will fit. */
8825 todo_units
= std::min (len_units
,
8826 (ULONGEST
) payload_capacity_bytes
/ unit_size
);
8828 payload_capacity_bytes
-= hexnumlen (todo_units
);
8829 todo_units
= std::min (todo_units
, payload_capacity_bytes
/ unit_size
);
8833 /* Number of bytes that will fit. */
8835 = std::min (len_units
,
8836 (ULONGEST
) (payload_capacity_bytes
/ unit_size
) / 2);
8838 payload_capacity_bytes
-= hexnumlen (todo_units
);
8839 todo_units
= std::min (todo_units
,
8840 (payload_capacity_bytes
/ unit_size
) / 2);
8843 if (todo_units
<= 0)
8844 internal_error (__FILE__
, __LINE__
,
8845 _("minimum packet size too small to write data"));
8847 /* If we already need another packet, then try to align the end
8848 of this packet to a useful boundary. */
8849 if (todo_units
> 2 * REMOTE_ALIGN_WRITES
&& todo_units
< len_units
)
8850 todo_units
= align_for_efficient_write (todo_units
, memaddr
);
8852 /* Append "<memaddr>". */
8853 memaddr
= remote_address_masked (memaddr
);
8854 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
8861 /* Append the length and retain its location and size. It may need to be
8862 adjusted once the packet body has been created. */
8864 plenlen
= hexnumstr (p
, (ULONGEST
) todo_units
);
8872 /* Append the packet body. */
8873 if (packet_format
== 'X')
8875 /* Binary mode. Send target system values byte by byte, in
8876 increasing byte addresses. Only escape certain critical
8878 payload_length_bytes
=
8879 remote_escape_output (myaddr
, todo_units
, unit_size
, (gdb_byte
*) p
,
8880 &units_written
, payload_capacity_bytes
);
8882 /* If not all TODO units fit, then we'll need another packet. Make
8883 a second try to keep the end of the packet aligned. Don't do
8884 this if the packet is tiny. */
8885 if (units_written
< todo_units
&& units_written
> 2 * REMOTE_ALIGN_WRITES
)
8889 new_todo_units
= align_for_efficient_write (units_written
, memaddr
);
8891 if (new_todo_units
!= units_written
)
8892 payload_length_bytes
=
8893 remote_escape_output (myaddr
, new_todo_units
, unit_size
,
8894 (gdb_byte
*) p
, &units_written
,
8895 payload_capacity_bytes
);
8898 p
+= payload_length_bytes
;
8899 if (use_length
&& units_written
< todo_units
)
8901 /* Escape chars have filled up the buffer prematurely,
8902 and we have actually sent fewer units than planned.
8903 Fix-up the length field of the packet. Use the same
8904 number of characters as before. */
8905 plen
+= hexnumnstr (plen
, (ULONGEST
) units_written
,
8907 *plen
= ':'; /* overwrite \0 from hexnumnstr() */
8912 /* Normal mode: Send target system values byte by byte, in
8913 increasing byte addresses. Each byte is encoded as a two hex
8915 p
+= 2 * bin2hex (myaddr
, p
, todo_units
* unit_size
);
8916 units_written
= todo_units
;
8919 putpkt_binary (rs
->buf
.data (), (int) (p
- rs
->buf
.data ()));
8920 getpkt (&rs
->buf
, 0);
8922 if (rs
->buf
[0] == 'E')
8923 return TARGET_XFER_E_IO
;
8925 /* Return UNITS_WRITTEN, not TODO_UNITS, in case escape chars caused us to
8926 send fewer units than we'd planned. */
8927 *xfered_len_units
= (ULONGEST
) units_written
;
8928 return (*xfered_len_units
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
8931 /* Write memory data directly to the remote machine.
8932 This does not inform the data cache; the data cache uses this.
8933 MEMADDR is the address in the remote memory space.
8934 MYADDR is the address of the buffer in our space.
8935 LEN is the number of bytes.
8937 Return the transferred status, error or OK (an
8938 'enum target_xfer_status' value). Save the number of bytes
8939 transferred in *XFERED_LEN. Only transfer a single packet. */
8942 remote_target::remote_write_bytes (CORE_ADDR memaddr
, const gdb_byte
*myaddr
,
8943 ULONGEST len
, int unit_size
,
8944 ULONGEST
*xfered_len
)
8946 const char *packet_format
= NULL
;
8948 /* Check whether the target supports binary download. */
8949 check_binary_download (memaddr
);
8951 switch (packet_support (PACKET_X
))
8954 packet_format
= "X";
8956 case PACKET_DISABLE
:
8957 packet_format
= "M";
8959 case PACKET_SUPPORT_UNKNOWN
:
8960 internal_error (__FILE__
, __LINE__
,
8961 _("remote_write_bytes: bad internal state"));
8963 internal_error (__FILE__
, __LINE__
, _("bad switch"));
8966 return remote_write_bytes_aux (packet_format
,
8967 memaddr
, myaddr
, len
, unit_size
, xfered_len
,
8968 packet_format
[0], 1);
8971 /* Read memory data directly from the remote machine.
8972 This does not use the data cache; the data cache uses this.
8973 MEMADDR is the address in the remote memory space.
8974 MYADDR is the address of the buffer in our space.
8975 LEN_UNITS is the number of addressable memory units to read..
8976 UNIT_SIZE is the length in bytes of an addressable unit.
8978 Return the transferred status, error or OK (an
8979 'enum target_xfer_status' value). Save the number of bytes
8980 transferred in *XFERED_LEN_UNITS.
8982 See the comment of remote_write_bytes_aux for an example of
8983 memory read/write exchange between gdb and the stub. */
8986 remote_target::remote_read_bytes_1 (CORE_ADDR memaddr
, gdb_byte
*myaddr
,
8988 int unit_size
, ULONGEST
*xfered_len_units
)
8990 struct remote_state
*rs
= get_remote_state ();
8991 int buf_size_bytes
; /* Max size of packet output buffer. */
8996 buf_size_bytes
= get_memory_read_packet_size ();
8997 /* The packet buffer will be large enough for the payload;
8998 get_memory_packet_size ensures this. */
9000 /* Number of units that will fit. */
9001 todo_units
= std::min (len_units
,
9002 (ULONGEST
) (buf_size_bytes
/ unit_size
) / 2);
9004 /* Construct "m"<memaddr>","<len>". */
9005 memaddr
= remote_address_masked (memaddr
);
9006 p
= rs
->buf
.data ();
9008 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
9010 p
+= hexnumstr (p
, (ULONGEST
) todo_units
);
9013 getpkt (&rs
->buf
, 0);
9014 if (rs
->buf
[0] == 'E'
9015 && isxdigit (rs
->buf
[1]) && isxdigit (rs
->buf
[2])
9016 && rs
->buf
[3] == '\0')
9017 return TARGET_XFER_E_IO
;
9018 /* Reply describes memory byte by byte, each byte encoded as two hex
9020 p
= rs
->buf
.data ();
9021 decoded_bytes
= hex2bin (p
, myaddr
, todo_units
* unit_size
);
9022 /* Return what we have. Let higher layers handle partial reads. */
9023 *xfered_len_units
= (ULONGEST
) (decoded_bytes
/ unit_size
);
9024 return (*xfered_len_units
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
9027 /* Using the set of read-only target sections of remote, read live
9030 For interface/parameters/return description see target.h,
9034 remote_target::remote_xfer_live_readonly_partial (gdb_byte
*readbuf
,
9038 ULONGEST
*xfered_len
)
9040 struct target_section
*secp
;
9042 secp
= target_section_by_addr (this, memaddr
);
9044 && (bfd_section_flags (secp
->the_bfd_section
) & SEC_READONLY
))
9046 ULONGEST memend
= memaddr
+ len
;
9048 target_section_table
*table
= target_get_section_table (this);
9049 for (target_section
&p
: *table
)
9051 if (memaddr
>= p
.addr
)
9053 if (memend
<= p
.endaddr
)
9055 /* Entire transfer is within this section. */
9056 return remote_read_bytes_1 (memaddr
, readbuf
, len
, unit_size
,
9059 else if (memaddr
>= p
.endaddr
)
9061 /* This section ends before the transfer starts. */
9066 /* This section overlaps the transfer. Just do half. */
9067 len
= p
.endaddr
- memaddr
;
9068 return remote_read_bytes_1 (memaddr
, readbuf
, len
, unit_size
,
9075 return TARGET_XFER_EOF
;
9078 /* Similar to remote_read_bytes_1, but it reads from the remote stub
9079 first if the requested memory is unavailable in traceframe.
9080 Otherwise, fall back to remote_read_bytes_1. */
9083 remote_target::remote_read_bytes (CORE_ADDR memaddr
,
9084 gdb_byte
*myaddr
, ULONGEST len
, int unit_size
,
9085 ULONGEST
*xfered_len
)
9088 return TARGET_XFER_EOF
;
9090 if (get_traceframe_number () != -1)
9092 std::vector
<mem_range
> available
;
9094 /* If we fail to get the set of available memory, then the
9095 target does not support querying traceframe info, and so we
9096 attempt reading from the traceframe anyway (assuming the
9097 target implements the old QTro packet then). */
9098 if (traceframe_available_memory (&available
, memaddr
, len
))
9100 if (available
.empty () || available
[0].start
!= memaddr
)
9102 enum target_xfer_status res
;
9104 /* Don't read into the traceframe's available
9106 if (!available
.empty ())
9108 LONGEST oldlen
= len
;
9110 len
= available
[0].start
- memaddr
;
9111 gdb_assert (len
<= oldlen
);
9114 /* This goes through the topmost target again. */
9115 res
= remote_xfer_live_readonly_partial (myaddr
, memaddr
,
9116 len
, unit_size
, xfered_len
);
9117 if (res
== TARGET_XFER_OK
)
9118 return TARGET_XFER_OK
;
9121 /* No use trying further, we know some memory starting
9122 at MEMADDR isn't available. */
9124 return (*xfered_len
!= 0) ?
9125 TARGET_XFER_UNAVAILABLE
: TARGET_XFER_EOF
;
9129 /* Don't try to read more than how much is available, in
9130 case the target implements the deprecated QTro packet to
9131 cater for older GDBs (the target's knowledge of read-only
9132 sections may be outdated by now). */
9133 len
= available
[0].length
;
9137 return remote_read_bytes_1 (memaddr
, myaddr
, len
, unit_size
, xfered_len
);
9142 /* Sends a packet with content determined by the printf format string
9143 FORMAT and the remaining arguments, then gets the reply. Returns
9144 whether the packet was a success, a failure, or unknown. */
9147 remote_target::remote_send_printf (const char *format
, ...)
9149 struct remote_state
*rs
= get_remote_state ();
9150 int max_size
= get_remote_packet_size ();
9153 va_start (ap
, format
);
9156 int size
= vsnprintf (rs
->buf
.data (), max_size
, format
, ap
);
9160 if (size
>= max_size
)
9161 internal_error (__FILE__
, __LINE__
, _("Too long remote packet."));
9163 if (putpkt (rs
->buf
) < 0)
9164 error (_("Communication problem with target."));
9167 getpkt (&rs
->buf
, 0);
9169 return packet_check_result (rs
->buf
);
9172 /* Flash writing can take quite some time. We'll set
9173 effectively infinite timeout for flash operations.
9174 In future, we'll need to decide on a better approach. */
9175 static const int remote_flash_timeout
= 1000;
9178 remote_target::flash_erase (ULONGEST address
, LONGEST length
)
9180 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
9181 enum packet_result ret
;
9182 scoped_restore restore_timeout
9183 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9185 ret
= remote_send_printf ("vFlashErase:%s,%s",
9186 phex (address
, addr_size
),
9190 case PACKET_UNKNOWN
:
9191 error (_("Remote target does not support flash erase"));
9193 error (_("Error erasing flash with vFlashErase packet"));
9200 remote_target::remote_flash_write (ULONGEST address
,
9201 ULONGEST length
, ULONGEST
*xfered_len
,
9202 const gdb_byte
*data
)
9204 scoped_restore restore_timeout
9205 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9206 return remote_write_bytes_aux ("vFlashWrite:", address
, data
, length
, 1,
9211 remote_target::flash_done ()
9215 scoped_restore restore_timeout
9216 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9218 ret
= remote_send_printf ("vFlashDone");
9222 case PACKET_UNKNOWN
:
9223 error (_("Remote target does not support vFlashDone"));
9225 error (_("Error finishing flash operation"));
9232 remote_target::files_info ()
9234 puts_filtered ("Debugging a target over a serial line.\n");
9237 /* Stuff for dealing with the packets which are part of this protocol.
9238 See comment at top of file for details. */
9240 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
9241 error to higher layers. Called when a serial error is detected.
9242 The exception message is STRING, followed by a colon and a blank,
9243 the system error message for errno at function entry and final dot
9244 for output compatibility with throw_perror_with_name. */
9247 unpush_and_perror (remote_target
*target
, const char *string
)
9249 int saved_errno
= errno
;
9251 remote_unpush_target (target
);
9252 throw_error (TARGET_CLOSE_ERROR
, "%s: %s.", string
,
9253 safe_strerror (saved_errno
));
9256 /* Read a single character from the remote end. The current quit
9257 handler is overridden to avoid quitting in the middle of packet
9258 sequence, as that would break communication with the remote server.
9259 See remote_serial_quit_handler for more detail. */
9262 remote_target::readchar (int timeout
)
9265 struct remote_state
*rs
= get_remote_state ();
9268 scoped_restore restore_quit_target
9269 = make_scoped_restore (&curr_quit_handler_target
, this);
9270 scoped_restore restore_quit
9271 = make_scoped_restore (&quit_handler
, ::remote_serial_quit_handler
);
9273 rs
->got_ctrlc_during_io
= 0;
9275 ch
= serial_readchar (rs
->remote_desc
, timeout
);
9277 if (rs
->got_ctrlc_during_io
)
9284 switch ((enum serial_rc
) ch
)
9287 remote_unpush_target (this);
9288 throw_error (TARGET_CLOSE_ERROR
, _("Remote connection closed"));
9291 unpush_and_perror (this, _("Remote communication error. "
9292 "Target disconnected."));
9294 case SERIAL_TIMEOUT
:
9300 /* Wrapper for serial_write that closes the target and throws if
9301 writing fails. The current quit handler is overridden to avoid
9302 quitting in the middle of packet sequence, as that would break
9303 communication with the remote server. See
9304 remote_serial_quit_handler for more detail. */
9307 remote_target::remote_serial_write (const char *str
, int len
)
9309 struct remote_state
*rs
= get_remote_state ();
9311 scoped_restore restore_quit_target
9312 = make_scoped_restore (&curr_quit_handler_target
, this);
9313 scoped_restore restore_quit
9314 = make_scoped_restore (&quit_handler
, ::remote_serial_quit_handler
);
9316 rs
->got_ctrlc_during_io
= 0;
9318 if (serial_write (rs
->remote_desc
, str
, len
))
9320 unpush_and_perror (this, _("Remote communication error. "
9321 "Target disconnected."));
9324 if (rs
->got_ctrlc_during_io
)
9328 /* Return a string representing an escaped version of BUF, of len N.
9329 E.g. \n is converted to \\n, \t to \\t, etc. */
9332 escape_buffer (const char *buf
, int n
)
9336 stb
.putstrn (buf
, n
, '\\');
9337 return std::move (stb
.string ());
9340 /* Display a null-terminated packet on stdout, for debugging, using C
9344 print_packet (const char *buf
)
9346 puts_filtered ("\"");
9347 fputstr_filtered (buf
, '"', gdb_stdout
);
9348 puts_filtered ("\"");
9352 remote_target::putpkt (const char *buf
)
9354 return putpkt_binary (buf
, strlen (buf
));
9357 /* Wrapper around remote_target::putpkt to avoid exporting
9361 putpkt (remote_target
*remote
, const char *buf
)
9363 return remote
->putpkt (buf
);
9366 /* Send a packet to the remote machine, with error checking. The data
9367 of the packet is in BUF. The string in BUF can be at most
9368 get_remote_packet_size () - 5 to account for the $, # and checksum,
9369 and for a possible /0 if we are debugging (remote_debug) and want
9370 to print the sent packet as a string. */
9373 remote_target::putpkt_binary (const char *buf
, int cnt
)
9375 struct remote_state
*rs
= get_remote_state ();
9377 unsigned char csum
= 0;
9378 gdb::def_vector
<char> data (cnt
+ 6);
9379 char *buf2
= data
.data ();
9385 /* Catch cases like trying to read memory or listing threads while
9386 we're waiting for a stop reply. The remote server wouldn't be
9387 ready to handle this request, so we'd hang and timeout. We don't
9388 have to worry about this in synchronous mode, because in that
9389 case it's not possible to issue a command while the target is
9390 running. This is not a problem in non-stop mode, because in that
9391 case, the stub is always ready to process serial input. */
9392 if (!target_is_non_stop_p ()
9393 && target_is_async_p ()
9394 && rs
->waiting_for_stop_reply
)
9396 error (_("Cannot execute this command while the target is running.\n"
9397 "Use the \"interrupt\" command to stop the target\n"
9398 "and then try again."));
9401 /* We're sending out a new packet. Make sure we don't look at a
9402 stale cached response. */
9403 rs
->cached_wait_status
= 0;
9405 /* Copy the packet into buffer BUF2, encapsulating it
9406 and giving it a checksum. */
9411 for (i
= 0; i
< cnt
; i
++)
9417 *p
++ = tohex ((csum
>> 4) & 0xf);
9418 *p
++ = tohex (csum
& 0xf);
9420 /* Send it over and over until we get a positive ack. */
9424 int started_error_output
= 0;
9430 int len
= (int) (p
- buf2
);
9433 if (remote_packet_max_chars
< 0)
9436 max_chars
= remote_packet_max_chars
;
9439 = escape_buffer (buf2
, std::min (len
, max_chars
));
9441 fprintf_unfiltered (gdb_stdlog
, "Sending packet: %s", str
.c_str ());
9443 if (len
> max_chars
)
9444 fprintf_unfiltered (gdb_stdlog
, "[%d bytes omitted]",
9447 fprintf_unfiltered (gdb_stdlog
, "...");
9449 gdb_flush (gdb_stdlog
);
9451 remote_serial_write (buf2
, p
- buf2
);
9453 /* If this is a no acks version of the remote protocol, send the
9454 packet and move on. */
9458 /* Read until either a timeout occurs (-2) or '+' is read.
9459 Handle any notification that arrives in the mean time. */
9462 ch
= readchar (remote_timeout
);
9470 case SERIAL_TIMEOUT
:
9473 if (started_error_output
)
9475 putchar_unfiltered ('\n');
9476 started_error_output
= 0;
9485 fprintf_unfiltered (gdb_stdlog
, "Ack\n");
9489 fprintf_unfiltered (gdb_stdlog
, "Nak\n");
9491 case SERIAL_TIMEOUT
:
9495 break; /* Retransmit buffer. */
9499 fprintf_unfiltered (gdb_stdlog
,
9500 "Packet instead of Ack, ignoring it\n");
9501 /* It's probably an old response sent because an ACK
9502 was lost. Gobble up the packet and ack it so it
9503 doesn't get retransmitted when we resend this
9506 remote_serial_write ("+", 1);
9507 continue; /* Now, go look for +. */
9514 /* If we got a notification, handle it, and go back to looking
9516 /* We've found the start of a notification. Now
9517 collect the data. */
9518 val
= read_frame (&rs
->buf
);
9523 std::string str
= escape_buffer (rs
->buf
.data (), val
);
9525 fprintf_unfiltered (gdb_stdlog
,
9526 " Notification received: %s\n",
9529 handle_notification (rs
->notif_state
, rs
->buf
.data ());
9530 /* We're in sync now, rewait for the ack. */
9537 if (!started_error_output
)
9539 started_error_output
= 1;
9540 fprintf_unfiltered (gdb_stdlog
, "putpkt: Junk: ");
9542 fputc_unfiltered (ch
& 0177, gdb_stdlog
);
9543 fprintf_unfiltered (gdb_stdlog
, "%s", rs
->buf
.data ());
9552 if (!started_error_output
)
9554 started_error_output
= 1;
9555 fprintf_unfiltered (gdb_stdlog
, "putpkt: Junk: ");
9557 fputc_unfiltered (ch
& 0177, gdb_stdlog
);
9561 break; /* Here to retransmit. */
9565 /* This is wrong. If doing a long backtrace, the user should be
9566 able to get out next time we call QUIT, without anything as
9567 violent as interrupt_query. If we want to provide a way out of
9568 here without getting to the next QUIT, it should be based on
9569 hitting ^C twice as in remote_wait. */
9581 /* Come here after finding the start of a frame when we expected an
9582 ack. Do our best to discard the rest of this packet. */
9585 remote_target::skip_frame ()
9591 c
= readchar (remote_timeout
);
9594 case SERIAL_TIMEOUT
:
9595 /* Nothing we can do. */
9598 /* Discard the two bytes of checksum and stop. */
9599 c
= readchar (remote_timeout
);
9601 c
= readchar (remote_timeout
);
9604 case '*': /* Run length encoding. */
9605 /* Discard the repeat count. */
9606 c
= readchar (remote_timeout
);
9611 /* A regular character. */
9617 /* Come here after finding the start of the frame. Collect the rest
9618 into *BUF, verifying the checksum, length, and handling run-length
9619 compression. NUL terminate the buffer. If there is not enough room,
9622 Returns -1 on error, number of characters in buffer (ignoring the
9623 trailing NULL) on success. (could be extended to return one of the
9624 SERIAL status indications). */
9627 remote_target::read_frame (gdb::char_vector
*buf_p
)
9632 char *buf
= buf_p
->data ();
9633 struct remote_state
*rs
= get_remote_state ();
9640 c
= readchar (remote_timeout
);
9643 case SERIAL_TIMEOUT
:
9645 fputs_filtered ("Timeout in mid-packet, retrying\n", gdb_stdlog
);
9649 fputs_filtered ("Saw new packet start in middle of old one\n",
9651 return -1; /* Start a new packet, count retries. */
9654 unsigned char pktcsum
;
9660 check_0
= readchar (remote_timeout
);
9662 check_1
= readchar (remote_timeout
);
9664 if (check_0
== SERIAL_TIMEOUT
|| check_1
== SERIAL_TIMEOUT
)
9667 fputs_filtered ("Timeout in checksum, retrying\n",
9671 else if (check_0
< 0 || check_1
< 0)
9674 fputs_filtered ("Communication error in checksum\n",
9679 /* Don't recompute the checksum; with no ack packets we
9680 don't have any way to indicate a packet retransmission
9685 pktcsum
= (fromhex (check_0
) << 4) | fromhex (check_1
);
9686 if (csum
== pktcsum
)
9691 std::string str
= escape_buffer (buf
, bc
);
9693 fprintf_unfiltered (gdb_stdlog
,
9694 "Bad checksum, sentsum=0x%x, "
9695 "csum=0x%x, buf=%s\n",
9696 pktcsum
, csum
, str
.c_str ());
9698 /* Number of characters in buffer ignoring trailing
9702 case '*': /* Run length encoding. */
9707 c
= readchar (remote_timeout
);
9709 repeat
= c
- ' ' + 3; /* Compute repeat count. */
9711 /* The character before ``*'' is repeated. */
9713 if (repeat
> 0 && repeat
<= 255 && bc
> 0)
9715 if (bc
+ repeat
- 1 >= buf_p
->size () - 1)
9717 /* Make some more room in the buffer. */
9718 buf_p
->resize (buf_p
->size () + repeat
);
9719 buf
= buf_p
->data ();
9722 memset (&buf
[bc
], buf
[bc
- 1], repeat
);
9728 printf_filtered (_("Invalid run length encoding: %s\n"), buf
);
9732 if (bc
>= buf_p
->size () - 1)
9734 /* Make some more room in the buffer. */
9735 buf_p
->resize (buf_p
->size () * 2);
9736 buf
= buf_p
->data ();
9746 /* Set this to the maximum number of seconds to wait instead of waiting forever
9747 in target_wait(). If this timer times out, then it generates an error and
9748 the command is aborted. This replaces most of the need for timeouts in the
9749 GDB test suite, and makes it possible to distinguish between a hung target
9750 and one with slow communications. */
9752 static int watchdog
= 0;
9754 show_watchdog (struct ui_file
*file
, int from_tty
,
9755 struct cmd_list_element
*c
, const char *value
)
9757 fprintf_filtered (file
, _("Watchdog timer is %s.\n"), value
);
9760 /* Read a packet from the remote machine, with error checking, and
9761 store it in *BUF. Resize *BUF if necessary to hold the result. If
9762 FOREVER, wait forever rather than timing out; this is used (in
9763 synchronous mode) to wait for a target that is is executing user
9765 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
9766 don't have to change all the calls to getpkt to deal with the
9767 return value, because at the moment I don't know what the right
9768 thing to do it for those. */
9771 remote_target::getpkt (gdb::char_vector
*buf
, int forever
)
9773 getpkt_sane (buf
, forever
);
9777 /* Read a packet from the remote machine, with error checking, and
9778 store it in *BUF. Resize *BUF if necessary to hold the result. If
9779 FOREVER, wait forever rather than timing out; this is used (in
9780 synchronous mode) to wait for a target that is is executing user
9781 code to stop. If FOREVER == 0, this function is allowed to time
9782 out gracefully and return an indication of this to the caller.
9783 Otherwise return the number of bytes read. If EXPECTING_NOTIF,
9784 consider receiving a notification enough reason to return to the
9785 caller. *IS_NOTIF is an output boolean that indicates whether *BUF
9786 holds a notification or not (a regular packet). */
9789 remote_target::getpkt_or_notif_sane_1 (gdb::char_vector
*buf
,
9790 int forever
, int expecting_notif
,
9793 struct remote_state
*rs
= get_remote_state ();
9799 /* We're reading a new response. Make sure we don't look at a
9800 previously cached response. */
9801 rs
->cached_wait_status
= 0;
9803 strcpy (buf
->data (), "timeout");
9806 timeout
= watchdog
> 0 ? watchdog
: -1;
9807 else if (expecting_notif
)
9808 timeout
= 0; /* There should already be a char in the buffer. If
9811 timeout
= remote_timeout
;
9815 /* Process any number of notifications, and then return when
9819 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
9821 for (tries
= 1; tries
<= MAX_TRIES
; tries
++)
9823 /* This can loop forever if the remote side sends us
9824 characters continuously, but if it pauses, we'll get
9825 SERIAL_TIMEOUT from readchar because of timeout. Then
9826 we'll count that as a retry.
9828 Note that even when forever is set, we will only wait
9829 forever prior to the start of a packet. After that, we
9830 expect characters to arrive at a brisk pace. They should
9831 show up within remote_timeout intervals. */
9833 c
= readchar (timeout
);
9834 while (c
!= SERIAL_TIMEOUT
&& c
!= '$' && c
!= '%');
9836 if (c
== SERIAL_TIMEOUT
)
9838 if (expecting_notif
)
9839 return -1; /* Don't complain, it's normal to not get
9840 anything in this case. */
9842 if (forever
) /* Watchdog went off? Kill the target. */
9844 remote_unpush_target (this);
9845 throw_error (TARGET_CLOSE_ERROR
,
9846 _("Watchdog timeout has expired. "
9847 "Target detached."));
9850 fputs_filtered ("Timed out.\n", gdb_stdlog
);
9854 /* We've found the start of a packet or notification.
9855 Now collect the data. */
9856 val
= read_frame (buf
);
9861 remote_serial_write ("-", 1);
9864 if (tries
> MAX_TRIES
)
9866 /* We have tried hard enough, and just can't receive the
9867 packet/notification. Give up. */
9868 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
9870 /* Skip the ack char if we're in no-ack mode. */
9871 if (!rs
->noack_mode
)
9872 remote_serial_write ("+", 1);
9876 /* If we got an ordinary packet, return that to our caller. */
9883 if (remote_packet_max_chars
< 0)
9886 max_chars
= remote_packet_max_chars
;
9889 = escape_buffer (buf
->data (),
9890 std::min (val
, max_chars
));
9892 fprintf_unfiltered (gdb_stdlog
, "Packet received: %s",
9895 if (val
> max_chars
)
9896 fprintf_unfiltered (gdb_stdlog
, "[%d bytes omitted]",
9899 fprintf_unfiltered (gdb_stdlog
, "\n");
9902 /* Skip the ack char if we're in no-ack mode. */
9903 if (!rs
->noack_mode
)
9904 remote_serial_write ("+", 1);
9905 if (is_notif
!= NULL
)
9910 /* If we got a notification, handle it, and go back to looking
9914 gdb_assert (c
== '%');
9918 std::string str
= escape_buffer (buf
->data (), val
);
9920 fprintf_unfiltered (gdb_stdlog
,
9921 " Notification received: %s\n",
9924 if (is_notif
!= NULL
)
9927 handle_notification (rs
->notif_state
, buf
->data ());
9929 /* Notifications require no acknowledgement. */
9931 if (expecting_notif
)
9938 remote_target::getpkt_sane (gdb::char_vector
*buf
, int forever
)
9940 return getpkt_or_notif_sane_1 (buf
, forever
, 0, NULL
);
9944 remote_target::getpkt_or_notif_sane (gdb::char_vector
*buf
, int forever
,
9947 return getpkt_or_notif_sane_1 (buf
, forever
, 1, is_notif
);
9950 /* Kill any new fork children of process PID that haven't been
9951 processed by follow_fork. */
9954 remote_target::kill_new_fork_children (int pid
)
9956 remote_state
*rs
= get_remote_state ();
9957 struct notif_client
*notif
= ¬if_client_stop
;
9959 /* Kill the fork child threads of any threads in process PID
9960 that are stopped at a fork event. */
9961 for (thread_info
*thread
: all_non_exited_threads (this))
9963 struct target_waitstatus
*ws
= &thread
->pending_follow
;
9965 if (is_pending_fork_parent (ws
, pid
, thread
->ptid
))
9967 int child_pid
= ws
->value
.related_pid
.pid ();
9970 res
= remote_vkill (child_pid
);
9972 error (_("Can't kill fork child process %d"), child_pid
);
9976 /* Check for any pending fork events (not reported or processed yet)
9977 in process PID and kill those fork child threads as well. */
9978 remote_notif_get_pending_events (notif
);
9979 for (auto &event
: rs
->stop_reply_queue
)
9980 if (is_pending_fork_parent (&event
->ws
, pid
, event
->ptid
))
9982 int child_pid
= event
->ws
.value
.related_pid
.pid ();
9985 res
= remote_vkill (child_pid
);
9987 error (_("Can't kill fork child process %d"), child_pid
);
9992 /* Target hook to kill the current inferior. */
9995 remote_target::kill ()
9998 int pid
= inferior_ptid
.pid ();
9999 struct remote_state
*rs
= get_remote_state ();
10001 if (packet_support (PACKET_vKill
) != PACKET_DISABLE
)
10003 /* If we're stopped while forking and we haven't followed yet,
10004 kill the child task. We need to do this before killing the
10005 parent task because if this is a vfork then the parent will
10007 kill_new_fork_children (pid
);
10009 res
= remote_vkill (pid
);
10012 target_mourn_inferior (inferior_ptid
);
10017 /* If we are in 'target remote' mode and we are killing the only
10018 inferior, then we will tell gdbserver to exit and unpush the
10020 if (res
== -1 && !remote_multi_process_p (rs
)
10021 && number_of_live_inferiors (this) == 1)
10025 /* We've killed the remote end, we get to mourn it. If we are
10026 not in extended mode, mourning the inferior also unpushes
10027 remote_ops from the target stack, which closes the remote
10029 target_mourn_inferior (inferior_ptid
);
10034 error (_("Can't kill process"));
10037 /* Send a kill request to the target using the 'vKill' packet. */
10040 remote_target::remote_vkill (int pid
)
10042 if (packet_support (PACKET_vKill
) == PACKET_DISABLE
)
10045 remote_state
*rs
= get_remote_state ();
10047 /* Tell the remote target to detach. */
10048 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "vKill;%x", pid
);
10050 getpkt (&rs
->buf
, 0);
10052 switch (packet_ok (rs
->buf
,
10053 &remote_protocol_packets
[PACKET_vKill
]))
10059 case PACKET_UNKNOWN
:
10062 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
10066 /* Send a kill request to the target using the 'k' packet. */
10069 remote_target::remote_kill_k ()
10071 /* Catch errors so the user can quit from gdb even when we
10072 aren't on speaking terms with the remote system. */
10077 catch (const gdb_exception_error
&ex
)
10079 if (ex
.error
== TARGET_CLOSE_ERROR
)
10081 /* If we got an (EOF) error that caused the target
10082 to go away, then we're done, that's what we wanted.
10083 "k" is susceptible to cause a premature EOF, given
10084 that the remote server isn't actually required to
10085 reply to "k", and it can happen that it doesn't
10086 even get to reply ACK to the "k". */
10090 /* Otherwise, something went wrong. We didn't actually kill
10091 the target. Just propagate the exception, and let the
10092 user or higher layers decide what to do. */
10098 remote_target::mourn_inferior ()
10100 struct remote_state
*rs
= get_remote_state ();
10102 /* We're no longer interested in notification events of an inferior
10103 that exited or was killed/detached. */
10104 discard_pending_stop_replies (current_inferior ());
10106 /* In 'target remote' mode with one inferior, we close the connection. */
10107 if (!rs
->extended
&& number_of_live_inferiors (this) <= 1)
10109 remote_unpush_target (this);
10113 /* In case we got here due to an error, but we're going to stay
10115 rs
->waiting_for_stop_reply
= 0;
10117 /* If the current general thread belonged to the process we just
10118 detached from or has exited, the remote side current general
10119 thread becomes undefined. Considering a case like this:
10121 - We just got here due to a detach.
10122 - The process that we're detaching from happens to immediately
10123 report a global breakpoint being hit in non-stop mode, in the
10124 same thread we had selected before.
10125 - GDB attaches to this process again.
10126 - This event happens to be the next event we handle.
10128 GDB would consider that the current general thread didn't need to
10129 be set on the stub side (with Hg), since for all it knew,
10130 GENERAL_THREAD hadn't changed.
10132 Notice that although in all-stop mode, the remote server always
10133 sets the current thread to the thread reporting the stop event,
10134 that doesn't happen in non-stop mode; in non-stop, the stub *must
10135 not* change the current thread when reporting a breakpoint hit,
10136 due to the decoupling of event reporting and event handling.
10138 To keep things simple, we always invalidate our notion of the
10140 record_currthread (rs
, minus_one_ptid
);
10142 /* Call common code to mark the inferior as not running. */
10143 generic_mourn_inferior ();
10147 extended_remote_target::supports_disable_randomization ()
10149 return packet_support (PACKET_QDisableRandomization
) == PACKET_ENABLE
;
10153 remote_target::extended_remote_disable_randomization (int val
)
10155 struct remote_state
*rs
= get_remote_state ();
10158 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10159 "QDisableRandomization:%x", val
);
10161 reply
= remote_get_noisy_reply ();
10162 if (*reply
== '\0')
10163 error (_("Target does not support QDisableRandomization."));
10164 if (strcmp (reply
, "OK") != 0)
10165 error (_("Bogus QDisableRandomization reply from target: %s"), reply
);
10169 remote_target::extended_remote_run (const std::string
&args
)
10171 struct remote_state
*rs
= get_remote_state ();
10173 const char *remote_exec_file
= get_remote_exec_file ();
10175 /* If the user has disabled vRun support, or we have detected that
10176 support is not available, do not try it. */
10177 if (packet_support (PACKET_vRun
) == PACKET_DISABLE
)
10180 strcpy (rs
->buf
.data (), "vRun;");
10181 len
= strlen (rs
->buf
.data ());
10183 if (strlen (remote_exec_file
) * 2 + len
>= get_remote_packet_size ())
10184 error (_("Remote file name too long for run packet"));
10185 len
+= 2 * bin2hex ((gdb_byte
*) remote_exec_file
, rs
->buf
.data () + len
,
10186 strlen (remote_exec_file
));
10188 if (!args
.empty ())
10192 gdb_argv
argv (args
.c_str ());
10193 for (i
= 0; argv
[i
] != NULL
; i
++)
10195 if (strlen (argv
[i
]) * 2 + 1 + len
>= get_remote_packet_size ())
10196 error (_("Argument list too long for run packet"));
10197 rs
->buf
[len
++] = ';';
10198 len
+= 2 * bin2hex ((gdb_byte
*) argv
[i
], rs
->buf
.data () + len
,
10203 rs
->buf
[len
++] = '\0';
10206 getpkt (&rs
->buf
, 0);
10208 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vRun
]))
10211 /* We have a wait response. All is well. */
10213 case PACKET_UNKNOWN
:
10216 if (remote_exec_file
[0] == '\0')
10217 error (_("Running the default executable on the remote target failed; "
10218 "try \"set remote exec-file\"?"));
10220 error (_("Running \"%s\" on the remote target failed"),
10223 gdb_assert_not_reached (_("bad switch"));
10227 /* Helper function to send set/unset environment packets. ACTION is
10228 either "set" or "unset". PACKET is either "QEnvironmentHexEncoded"
10229 or "QEnvironmentUnsetVariable". VALUE is the variable to be
10233 remote_target::send_environment_packet (const char *action
,
10234 const char *packet
,
10237 remote_state
*rs
= get_remote_state ();
10239 /* Convert the environment variable to an hex string, which
10240 is the best format to be transmitted over the wire. */
10241 std::string encoded_value
= bin2hex ((const gdb_byte
*) value
,
10244 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10245 "%s:%s", packet
, encoded_value
.c_str ());
10248 getpkt (&rs
->buf
, 0);
10249 if (strcmp (rs
->buf
.data (), "OK") != 0)
10250 warning (_("Unable to %s environment variable '%s' on remote."),
10254 /* Helper function to handle the QEnvironment* packets. */
10257 remote_target::extended_remote_environment_support ()
10259 remote_state
*rs
= get_remote_state ();
10261 if (packet_support (PACKET_QEnvironmentReset
) != PACKET_DISABLE
)
10263 putpkt ("QEnvironmentReset");
10264 getpkt (&rs
->buf
, 0);
10265 if (strcmp (rs
->buf
.data (), "OK") != 0)
10266 warning (_("Unable to reset environment on remote."));
10269 gdb_environ
*e
= ¤t_inferior ()->environment
;
10271 if (packet_support (PACKET_QEnvironmentHexEncoded
) != PACKET_DISABLE
)
10272 for (const std::string
&el
: e
->user_set_env ())
10273 send_environment_packet ("set", "QEnvironmentHexEncoded",
10276 if (packet_support (PACKET_QEnvironmentUnset
) != PACKET_DISABLE
)
10277 for (const std::string
&el
: e
->user_unset_env ())
10278 send_environment_packet ("unset", "QEnvironmentUnset", el
.c_str ());
10281 /* Helper function to set the current working directory for the
10282 inferior in the remote target. */
10285 remote_target::extended_remote_set_inferior_cwd ()
10287 if (packet_support (PACKET_QSetWorkingDir
) != PACKET_DISABLE
)
10289 const char *inferior_cwd
= get_inferior_cwd ();
10290 remote_state
*rs
= get_remote_state ();
10292 if (inferior_cwd
!= NULL
)
10294 std::string hexpath
= bin2hex ((const gdb_byte
*) inferior_cwd
,
10295 strlen (inferior_cwd
));
10297 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10298 "QSetWorkingDir:%s", hexpath
.c_str ());
10302 /* An empty inferior_cwd means that the user wants us to
10303 reset the remote server's inferior's cwd. */
10304 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10305 "QSetWorkingDir:");
10309 getpkt (&rs
->buf
, 0);
10310 if (packet_ok (rs
->buf
,
10311 &remote_protocol_packets
[PACKET_QSetWorkingDir
])
10314 Remote replied unexpectedly while setting the inferior's working\n\
10321 /* In the extended protocol we want to be able to do things like
10322 "run" and have them basically work as expected. So we need
10323 a special create_inferior function. We support changing the
10324 executable file and the command line arguments, but not the
10328 extended_remote_target::create_inferior (const char *exec_file
,
10329 const std::string
&args
,
10330 char **env
, int from_tty
)
10334 struct remote_state
*rs
= get_remote_state ();
10335 const char *remote_exec_file
= get_remote_exec_file ();
10337 /* If running asynchronously, register the target file descriptor
10338 with the event loop. */
10339 if (target_can_async_p ())
10342 /* Disable address space randomization if requested (and supported). */
10343 if (supports_disable_randomization ())
10344 extended_remote_disable_randomization (disable_randomization
);
10346 /* If startup-with-shell is on, we inform gdbserver to start the
10347 remote inferior using a shell. */
10348 if (packet_support (PACKET_QStartupWithShell
) != PACKET_DISABLE
)
10350 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10351 "QStartupWithShell:%d", startup_with_shell
? 1 : 0);
10353 getpkt (&rs
->buf
, 0);
10354 if (strcmp (rs
->buf
.data (), "OK") != 0)
10356 Remote replied unexpectedly while setting startup-with-shell: %s"),
10360 extended_remote_environment_support ();
10362 extended_remote_set_inferior_cwd ();
10364 /* Now restart the remote server. */
10365 run_worked
= extended_remote_run (args
) != -1;
10368 /* vRun was not supported. Fail if we need it to do what the
10370 if (remote_exec_file
[0])
10371 error (_("Remote target does not support \"set remote exec-file\""));
10372 if (!args
.empty ())
10373 error (_("Remote target does not support \"set args\" or run ARGS"));
10375 /* Fall back to "R". */
10376 extended_remote_restart ();
10379 /* vRun's success return is a stop reply. */
10380 stop_reply
= run_worked
? rs
->buf
.data () : NULL
;
10381 add_current_inferior_and_thread (stop_reply
);
10383 /* Get updated offsets, if the stub uses qOffsets. */
10388 /* Given a location's target info BP_TGT and the packet buffer BUF, output
10389 the list of conditions (in agent expression bytecode format), if any, the
10390 target needs to evaluate. The output is placed into the packet buffer
10391 started from BUF and ended at BUF_END. */
10394 remote_add_target_side_condition (struct gdbarch
*gdbarch
,
10395 struct bp_target_info
*bp_tgt
, char *buf
,
10398 if (bp_tgt
->conditions
.empty ())
10401 buf
+= strlen (buf
);
10402 xsnprintf (buf
, buf_end
- buf
, "%s", ";");
10405 /* Send conditions to the target. */
10406 for (agent_expr
*aexpr
: bp_tgt
->conditions
)
10408 xsnprintf (buf
, buf_end
- buf
, "X%x,", aexpr
->len
);
10409 buf
+= strlen (buf
);
10410 for (int i
= 0; i
< aexpr
->len
; ++i
)
10411 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
10418 remote_add_target_side_commands (struct gdbarch
*gdbarch
,
10419 struct bp_target_info
*bp_tgt
, char *buf
)
10421 if (bp_tgt
->tcommands
.empty ())
10424 buf
+= strlen (buf
);
10426 sprintf (buf
, ";cmds:%x,", bp_tgt
->persist
);
10427 buf
+= strlen (buf
);
10429 /* Concatenate all the agent expressions that are commands into the
10431 for (agent_expr
*aexpr
: bp_tgt
->tcommands
)
10433 sprintf (buf
, "X%x,", aexpr
->len
);
10434 buf
+= strlen (buf
);
10435 for (int i
= 0; i
< aexpr
->len
; ++i
)
10436 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
10441 /* Insert a breakpoint. On targets that have software breakpoint
10442 support, we ask the remote target to do the work; on targets
10443 which don't, we insert a traditional memory breakpoint. */
10446 remote_target::insert_breakpoint (struct gdbarch
*gdbarch
,
10447 struct bp_target_info
*bp_tgt
)
10449 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
10450 If it succeeds, then set the support to PACKET_ENABLE. If it
10451 fails, and the user has explicitly requested the Z support then
10452 report an error, otherwise, mark it disabled and go on. */
10454 if (packet_support (PACKET_Z0
) != PACKET_DISABLE
)
10456 CORE_ADDR addr
= bp_tgt
->reqstd_address
;
10457 struct remote_state
*rs
;
10460 /* Make sure the remote is pointing at the right process, if
10462 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10463 set_general_process ();
10465 rs
= get_remote_state ();
10466 p
= rs
->buf
.data ();
10467 endbuf
= p
+ get_remote_packet_size ();
10472 addr
= (ULONGEST
) remote_address_masked (addr
);
10473 p
+= hexnumstr (p
, addr
);
10474 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->kind
);
10476 if (supports_evaluation_of_breakpoint_conditions ())
10477 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
10479 if (can_run_breakpoint_commands ())
10480 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
10483 getpkt (&rs
->buf
, 0);
10485 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
]))
10491 case PACKET_UNKNOWN
:
10496 /* If this breakpoint has target-side commands but this stub doesn't
10497 support Z0 packets, throw error. */
10498 if (!bp_tgt
->tcommands
.empty ())
10499 throw_error (NOT_SUPPORTED_ERROR
, _("\
10500 Target doesn't support breakpoints that have target side commands."));
10502 return memory_insert_breakpoint (this, gdbarch
, bp_tgt
);
10506 remote_target::remove_breakpoint (struct gdbarch
*gdbarch
,
10507 struct bp_target_info
*bp_tgt
,
10508 enum remove_bp_reason reason
)
10510 CORE_ADDR addr
= bp_tgt
->placed_address
;
10511 struct remote_state
*rs
= get_remote_state ();
10513 if (packet_support (PACKET_Z0
) != PACKET_DISABLE
)
10515 char *p
= rs
->buf
.data ();
10516 char *endbuf
= p
+ get_remote_packet_size ();
10518 /* Make sure the remote is pointing at the right process, if
10520 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10521 set_general_process ();
10527 addr
= (ULONGEST
) remote_address_masked (bp_tgt
->placed_address
);
10528 p
+= hexnumstr (p
, addr
);
10529 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->kind
);
10532 getpkt (&rs
->buf
, 0);
10534 return (rs
->buf
[0] == 'E');
10537 return memory_remove_breakpoint (this, gdbarch
, bp_tgt
, reason
);
10540 static enum Z_packet_type
10541 watchpoint_to_Z_packet (int type
)
10546 return Z_PACKET_WRITE_WP
;
10549 return Z_PACKET_READ_WP
;
10552 return Z_PACKET_ACCESS_WP
;
10555 internal_error (__FILE__
, __LINE__
,
10556 _("hw_bp_to_z: bad watchpoint type %d"), type
);
10561 remote_target::insert_watchpoint (CORE_ADDR addr
, int len
,
10562 enum target_hw_bp_type type
, struct expression
*cond
)
10564 struct remote_state
*rs
= get_remote_state ();
10565 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
10567 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
10569 if (packet_support (PACKET_Z0
+ packet
) == PACKET_DISABLE
)
10572 /* Make sure the remote is pointing at the right process, if
10574 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10575 set_general_process ();
10577 xsnprintf (rs
->buf
.data (), endbuf
- rs
->buf
.data (), "Z%x,", packet
);
10578 p
= strchr (rs
->buf
.data (), '\0');
10579 addr
= remote_address_masked (addr
);
10580 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10581 xsnprintf (p
, endbuf
- p
, ",%x", len
);
10584 getpkt (&rs
->buf
, 0);
10586 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
10590 case PACKET_UNKNOWN
:
10595 internal_error (__FILE__
, __LINE__
,
10596 _("remote_insert_watchpoint: reached end of function"));
10600 remote_target::watchpoint_addr_within_range (CORE_ADDR addr
,
10601 CORE_ADDR start
, int length
)
10603 CORE_ADDR diff
= remote_address_masked (addr
- start
);
10605 return diff
< length
;
10610 remote_target::remove_watchpoint (CORE_ADDR addr
, int len
,
10611 enum target_hw_bp_type type
, struct expression
*cond
)
10613 struct remote_state
*rs
= get_remote_state ();
10614 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
10616 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
10618 if (packet_support (PACKET_Z0
+ packet
) == PACKET_DISABLE
)
10621 /* Make sure the remote is pointing at the right process, if
10623 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10624 set_general_process ();
10626 xsnprintf (rs
->buf
.data (), endbuf
- rs
->buf
.data (), "z%x,", packet
);
10627 p
= strchr (rs
->buf
.data (), '\0');
10628 addr
= remote_address_masked (addr
);
10629 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10630 xsnprintf (p
, endbuf
- p
, ",%x", len
);
10632 getpkt (&rs
->buf
, 0);
10634 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
10637 case PACKET_UNKNOWN
:
10642 internal_error (__FILE__
, __LINE__
,
10643 _("remote_remove_watchpoint: reached end of function"));
10647 static int remote_hw_watchpoint_limit
= -1;
10648 static int remote_hw_watchpoint_length_limit
= -1;
10649 static int remote_hw_breakpoint_limit
= -1;
10652 remote_target::region_ok_for_hw_watchpoint (CORE_ADDR addr
, int len
)
10654 if (remote_hw_watchpoint_length_limit
== 0)
10656 else if (remote_hw_watchpoint_length_limit
< 0)
10658 else if (len
<= remote_hw_watchpoint_length_limit
)
10665 remote_target::can_use_hw_breakpoint (enum bptype type
, int cnt
, int ot
)
10667 if (type
== bp_hardware_breakpoint
)
10669 if (remote_hw_breakpoint_limit
== 0)
10671 else if (remote_hw_breakpoint_limit
< 0)
10673 else if (cnt
<= remote_hw_breakpoint_limit
)
10678 if (remote_hw_watchpoint_limit
== 0)
10680 else if (remote_hw_watchpoint_limit
< 0)
10684 else if (cnt
<= remote_hw_watchpoint_limit
)
10690 /* The to_stopped_by_sw_breakpoint method of target remote. */
10693 remote_target::stopped_by_sw_breakpoint ()
10695 struct thread_info
*thread
= inferior_thread ();
10697 return (thread
->priv
!= NULL
10698 && (get_remote_thread_info (thread
)->stop_reason
10699 == TARGET_STOPPED_BY_SW_BREAKPOINT
));
10702 /* The to_supports_stopped_by_sw_breakpoint method of target
10706 remote_target::supports_stopped_by_sw_breakpoint ()
10708 return (packet_support (PACKET_swbreak_feature
) == PACKET_ENABLE
);
10711 /* The to_stopped_by_hw_breakpoint method of target remote. */
10714 remote_target::stopped_by_hw_breakpoint ()
10716 struct thread_info
*thread
= inferior_thread ();
10718 return (thread
->priv
!= NULL
10719 && (get_remote_thread_info (thread
)->stop_reason
10720 == TARGET_STOPPED_BY_HW_BREAKPOINT
));
10723 /* The to_supports_stopped_by_hw_breakpoint method of target
10727 remote_target::supports_stopped_by_hw_breakpoint ()
10729 return (packet_support (PACKET_hwbreak_feature
) == PACKET_ENABLE
);
10733 remote_target::stopped_by_watchpoint ()
10735 struct thread_info
*thread
= inferior_thread ();
10737 return (thread
->priv
!= NULL
10738 && (get_remote_thread_info (thread
)->stop_reason
10739 == TARGET_STOPPED_BY_WATCHPOINT
));
10743 remote_target::stopped_data_address (CORE_ADDR
*addr_p
)
10745 struct thread_info
*thread
= inferior_thread ();
10747 if (thread
->priv
!= NULL
10748 && (get_remote_thread_info (thread
)->stop_reason
10749 == TARGET_STOPPED_BY_WATCHPOINT
))
10751 *addr_p
= get_remote_thread_info (thread
)->watch_data_address
;
10760 remote_target::insert_hw_breakpoint (struct gdbarch
*gdbarch
,
10761 struct bp_target_info
*bp_tgt
)
10763 CORE_ADDR addr
= bp_tgt
->reqstd_address
;
10764 struct remote_state
*rs
;
10768 if (packet_support (PACKET_Z1
) == PACKET_DISABLE
)
10771 /* Make sure the remote is pointing at the right process, if
10773 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10774 set_general_process ();
10776 rs
= get_remote_state ();
10777 p
= rs
->buf
.data ();
10778 endbuf
= p
+ get_remote_packet_size ();
10784 addr
= remote_address_masked (addr
);
10785 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10786 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->kind
);
10788 if (supports_evaluation_of_breakpoint_conditions ())
10789 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
10791 if (can_run_breakpoint_commands ())
10792 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
10795 getpkt (&rs
->buf
, 0);
10797 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
10800 if (rs
->buf
[1] == '.')
10802 message
= strchr (&rs
->buf
[2], '.');
10804 error (_("Remote failure reply: %s"), message
+ 1);
10807 case PACKET_UNKNOWN
:
10812 internal_error (__FILE__
, __LINE__
,
10813 _("remote_insert_hw_breakpoint: reached end of function"));
10818 remote_target::remove_hw_breakpoint (struct gdbarch
*gdbarch
,
10819 struct bp_target_info
*bp_tgt
)
10822 struct remote_state
*rs
= get_remote_state ();
10823 char *p
= rs
->buf
.data ();
10824 char *endbuf
= p
+ get_remote_packet_size ();
10826 if (packet_support (PACKET_Z1
) == PACKET_DISABLE
)
10829 /* Make sure the remote is pointing at the right process, if
10831 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10832 set_general_process ();
10838 addr
= remote_address_masked (bp_tgt
->placed_address
);
10839 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10840 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->kind
);
10843 getpkt (&rs
->buf
, 0);
10845 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
10848 case PACKET_UNKNOWN
:
10853 internal_error (__FILE__
, __LINE__
,
10854 _("remote_remove_hw_breakpoint: reached end of function"));
10857 /* Verify memory using the "qCRC:" request. */
10860 remote_target::verify_memory (const gdb_byte
*data
, CORE_ADDR lma
, ULONGEST size
)
10862 struct remote_state
*rs
= get_remote_state ();
10863 unsigned long host_crc
, target_crc
;
10866 /* It doesn't make sense to use qCRC if the remote target is
10867 connected but not running. */
10868 if (target_has_execution ()
10869 && packet_support (PACKET_qCRC
) != PACKET_DISABLE
)
10871 enum packet_result result
;
10873 /* Make sure the remote is pointing at the right process. */
10874 set_general_process ();
10876 /* FIXME: assumes lma can fit into long. */
10877 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qCRC:%lx,%lx",
10878 (long) lma
, (long) size
);
10881 /* Be clever; compute the host_crc before waiting for target
10883 host_crc
= xcrc32 (data
, size
, 0xffffffff);
10885 getpkt (&rs
->buf
, 0);
10887 result
= packet_ok (rs
->buf
,
10888 &remote_protocol_packets
[PACKET_qCRC
]);
10889 if (result
== PACKET_ERROR
)
10891 else if (result
== PACKET_OK
)
10893 for (target_crc
= 0, tmp
= &rs
->buf
[1]; *tmp
; tmp
++)
10894 target_crc
= target_crc
* 16 + fromhex (*tmp
);
10896 return (host_crc
== target_crc
);
10900 return simple_verify_memory (this, data
, lma
, size
);
10903 /* compare-sections command
10905 With no arguments, compares each loadable section in the exec bfd
10906 with the same memory range on the target, and reports mismatches.
10907 Useful for verifying the image on the target against the exec file. */
10910 compare_sections_command (const char *args
, int from_tty
)
10913 const char *sectname
;
10914 bfd_size_type size
;
10917 int mismatched
= 0;
10921 if (!current_program_space
->exec_bfd ())
10922 error (_("command cannot be used without an exec file"));
10924 if (args
!= NULL
&& strcmp (args
, "-r") == 0)
10930 for (s
= current_program_space
->exec_bfd ()->sections
; s
; s
= s
->next
)
10932 if (!(s
->flags
& SEC_LOAD
))
10933 continue; /* Skip non-loadable section. */
10935 if (read_only
&& (s
->flags
& SEC_READONLY
) == 0)
10936 continue; /* Skip writeable sections */
10938 size
= bfd_section_size (s
);
10940 continue; /* Skip zero-length section. */
10942 sectname
= bfd_section_name (s
);
10943 if (args
&& strcmp (args
, sectname
) != 0)
10944 continue; /* Not the section selected by user. */
10946 matched
= 1; /* Do this section. */
10949 gdb::byte_vector
sectdata (size
);
10950 bfd_get_section_contents (current_program_space
->exec_bfd (), s
,
10951 sectdata
.data (), 0, size
);
10953 res
= target_verify_memory (sectdata
.data (), lma
, size
);
10956 error (_("target memory fault, section %s, range %s -- %s"), sectname
,
10957 paddress (target_gdbarch (), lma
),
10958 paddress (target_gdbarch (), lma
+ size
));
10960 printf_filtered ("Section %s, range %s -- %s: ", sectname
,
10961 paddress (target_gdbarch (), lma
),
10962 paddress (target_gdbarch (), lma
+ size
));
10964 printf_filtered ("matched.\n");
10967 printf_filtered ("MIS-MATCHED!\n");
10971 if (mismatched
> 0)
10972 warning (_("One or more sections of the target image does not match\n\
10973 the loaded file\n"));
10974 if (args
&& !matched
)
10975 printf_filtered (_("No loaded section named '%s'.\n"), args
);
10978 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
10979 into remote target. The number of bytes written to the remote
10980 target is returned, or -1 for error. */
10983 remote_target::remote_write_qxfer (const char *object_name
,
10984 const char *annex
, const gdb_byte
*writebuf
,
10985 ULONGEST offset
, LONGEST len
,
10986 ULONGEST
*xfered_len
,
10987 struct packet_config
*packet
)
10991 struct remote_state
*rs
= get_remote_state ();
10992 int max_size
= get_memory_write_packet_size ();
10994 if (packet_config_support (packet
) == PACKET_DISABLE
)
10995 return TARGET_XFER_E_IO
;
10997 /* Insert header. */
10998 i
= snprintf (rs
->buf
.data (), max_size
,
10999 "qXfer:%s:write:%s:%s:",
11000 object_name
, annex
? annex
: "",
11001 phex_nz (offset
, sizeof offset
));
11002 max_size
-= (i
+ 1);
11004 /* Escape as much data as fits into rs->buf. */
11005 buf_len
= remote_escape_output
11006 (writebuf
, len
, 1, (gdb_byte
*) rs
->buf
.data () + i
, &max_size
, max_size
);
11008 if (putpkt_binary (rs
->buf
.data (), i
+ buf_len
) < 0
11009 || getpkt_sane (&rs
->buf
, 0) < 0
11010 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11011 return TARGET_XFER_E_IO
;
11013 unpack_varlen_hex (rs
->buf
.data (), &n
);
11016 return (*xfered_len
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
11019 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
11020 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
11021 number of bytes read is returned, or 0 for EOF, or -1 for error.
11022 The number of bytes read may be less than LEN without indicating an
11023 EOF. PACKET is checked and updated to indicate whether the remote
11024 target supports this object. */
11027 remote_target::remote_read_qxfer (const char *object_name
,
11029 gdb_byte
*readbuf
, ULONGEST offset
,
11031 ULONGEST
*xfered_len
,
11032 struct packet_config
*packet
)
11034 struct remote_state
*rs
= get_remote_state ();
11035 LONGEST i
, n
, packet_len
;
11037 if (packet_config_support (packet
) == PACKET_DISABLE
)
11038 return TARGET_XFER_E_IO
;
11040 /* Check whether we've cached an end-of-object packet that matches
11042 if (rs
->finished_object
)
11044 if (strcmp (object_name
, rs
->finished_object
) == 0
11045 && strcmp (annex
? annex
: "", rs
->finished_annex
) == 0
11046 && offset
== rs
->finished_offset
)
11047 return TARGET_XFER_EOF
;
11050 /* Otherwise, we're now reading something different. Discard
11052 xfree (rs
->finished_object
);
11053 xfree (rs
->finished_annex
);
11054 rs
->finished_object
= NULL
;
11055 rs
->finished_annex
= NULL
;
11058 /* Request only enough to fit in a single packet. The actual data
11059 may not, since we don't know how much of it will need to be escaped;
11060 the target is free to respond with slightly less data. We subtract
11061 five to account for the response type and the protocol frame. */
11062 n
= std::min
<LONGEST
> (get_remote_packet_size () - 5, len
);
11063 snprintf (rs
->buf
.data (), get_remote_packet_size () - 4,
11064 "qXfer:%s:read:%s:%s,%s",
11065 object_name
, annex
? annex
: "",
11066 phex_nz (offset
, sizeof offset
),
11067 phex_nz (n
, sizeof n
));
11068 i
= putpkt (rs
->buf
);
11070 return TARGET_XFER_E_IO
;
11073 packet_len
= getpkt_sane (&rs
->buf
, 0);
11074 if (packet_len
< 0 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11075 return TARGET_XFER_E_IO
;
11077 if (rs
->buf
[0] != 'l' && rs
->buf
[0] != 'm')
11078 error (_("Unknown remote qXfer reply: %s"), rs
->buf
.data ());
11080 /* 'm' means there is (or at least might be) more data after this
11081 batch. That does not make sense unless there's at least one byte
11082 of data in this reply. */
11083 if (rs
->buf
[0] == 'm' && packet_len
== 1)
11084 error (_("Remote qXfer reply contained no data."));
11086 /* Got some data. */
11087 i
= remote_unescape_input ((gdb_byte
*) rs
->buf
.data () + 1,
11088 packet_len
- 1, readbuf
, n
);
11090 /* 'l' is an EOF marker, possibly including a final block of data,
11091 or possibly empty. If we have the final block of a non-empty
11092 object, record this fact to bypass a subsequent partial read. */
11093 if (rs
->buf
[0] == 'l' && offset
+ i
> 0)
11095 rs
->finished_object
= xstrdup (object_name
);
11096 rs
->finished_annex
= xstrdup (annex
? annex
: "");
11097 rs
->finished_offset
= offset
+ i
;
11101 return TARGET_XFER_EOF
;
11105 return TARGET_XFER_OK
;
11109 enum target_xfer_status
11110 remote_target::xfer_partial (enum target_object object
,
11111 const char *annex
, gdb_byte
*readbuf
,
11112 const gdb_byte
*writebuf
, ULONGEST offset
, ULONGEST len
,
11113 ULONGEST
*xfered_len
)
11115 struct remote_state
*rs
;
11119 int unit_size
= gdbarch_addressable_memory_unit_size (target_gdbarch ());
11121 set_remote_traceframe ();
11122 set_general_thread (inferior_ptid
);
11124 rs
= get_remote_state ();
11126 /* Handle memory using the standard memory routines. */
11127 if (object
== TARGET_OBJECT_MEMORY
)
11129 /* If the remote target is connected but not running, we should
11130 pass this request down to a lower stratum (e.g. the executable
11132 if (!target_has_execution ())
11133 return TARGET_XFER_EOF
;
11135 if (writebuf
!= NULL
)
11136 return remote_write_bytes (offset
, writebuf
, len
, unit_size
,
11139 return remote_read_bytes (offset
, readbuf
, len
, unit_size
,
11143 /* Handle extra signal info using qxfer packets. */
11144 if (object
== TARGET_OBJECT_SIGNAL_INFO
)
11147 return remote_read_qxfer ("siginfo", annex
, readbuf
, offset
, len
,
11148 xfered_len
, &remote_protocol_packets
11149 [PACKET_qXfer_siginfo_read
]);
11151 return remote_write_qxfer ("siginfo", annex
,
11152 writebuf
, offset
, len
, xfered_len
,
11153 &remote_protocol_packets
11154 [PACKET_qXfer_siginfo_write
]);
11157 if (object
== TARGET_OBJECT_STATIC_TRACE_DATA
)
11160 return remote_read_qxfer ("statictrace", annex
,
11161 readbuf
, offset
, len
, xfered_len
,
11162 &remote_protocol_packets
11163 [PACKET_qXfer_statictrace_read
]);
11165 return TARGET_XFER_E_IO
;
11168 /* Only handle flash writes. */
11169 if (writebuf
!= NULL
)
11173 case TARGET_OBJECT_FLASH
:
11174 return remote_flash_write (offset
, len
, xfered_len
,
11178 return TARGET_XFER_E_IO
;
11182 /* Map pre-existing objects onto letters. DO NOT do this for new
11183 objects!!! Instead specify new query packets. */
11186 case TARGET_OBJECT_AVR
:
11190 case TARGET_OBJECT_AUXV
:
11191 gdb_assert (annex
== NULL
);
11192 return remote_read_qxfer ("auxv", annex
, readbuf
, offset
, len
,
11194 &remote_protocol_packets
[PACKET_qXfer_auxv
]);
11196 case TARGET_OBJECT_AVAILABLE_FEATURES
:
11197 return remote_read_qxfer
11198 ("features", annex
, readbuf
, offset
, len
, xfered_len
,
11199 &remote_protocol_packets
[PACKET_qXfer_features
]);
11201 case TARGET_OBJECT_LIBRARIES
:
11202 return remote_read_qxfer
11203 ("libraries", annex
, readbuf
, offset
, len
, xfered_len
,
11204 &remote_protocol_packets
[PACKET_qXfer_libraries
]);
11206 case TARGET_OBJECT_LIBRARIES_SVR4
:
11207 return remote_read_qxfer
11208 ("libraries-svr4", annex
, readbuf
, offset
, len
, xfered_len
,
11209 &remote_protocol_packets
[PACKET_qXfer_libraries_svr4
]);
11211 case TARGET_OBJECT_MEMORY_MAP
:
11212 gdb_assert (annex
== NULL
);
11213 return remote_read_qxfer ("memory-map", annex
, readbuf
, offset
, len
,
11215 &remote_protocol_packets
[PACKET_qXfer_memory_map
]);
11217 case TARGET_OBJECT_OSDATA
:
11218 /* Should only get here if we're connected. */
11219 gdb_assert (rs
->remote_desc
);
11220 return remote_read_qxfer
11221 ("osdata", annex
, readbuf
, offset
, len
, xfered_len
,
11222 &remote_protocol_packets
[PACKET_qXfer_osdata
]);
11224 case TARGET_OBJECT_THREADS
:
11225 gdb_assert (annex
== NULL
);
11226 return remote_read_qxfer ("threads", annex
, readbuf
, offset
, len
,
11228 &remote_protocol_packets
[PACKET_qXfer_threads
]);
11230 case TARGET_OBJECT_TRACEFRAME_INFO
:
11231 gdb_assert (annex
== NULL
);
11232 return remote_read_qxfer
11233 ("traceframe-info", annex
, readbuf
, offset
, len
, xfered_len
,
11234 &remote_protocol_packets
[PACKET_qXfer_traceframe_info
]);
11236 case TARGET_OBJECT_FDPIC
:
11237 return remote_read_qxfer ("fdpic", annex
, readbuf
, offset
, len
,
11239 &remote_protocol_packets
[PACKET_qXfer_fdpic
]);
11241 case TARGET_OBJECT_OPENVMS_UIB
:
11242 return remote_read_qxfer ("uib", annex
, readbuf
, offset
, len
,
11244 &remote_protocol_packets
[PACKET_qXfer_uib
]);
11246 case TARGET_OBJECT_BTRACE
:
11247 return remote_read_qxfer ("btrace", annex
, readbuf
, offset
, len
,
11249 &remote_protocol_packets
[PACKET_qXfer_btrace
]);
11251 case TARGET_OBJECT_BTRACE_CONF
:
11252 return remote_read_qxfer ("btrace-conf", annex
, readbuf
, offset
,
11254 &remote_protocol_packets
[PACKET_qXfer_btrace_conf
]);
11256 case TARGET_OBJECT_EXEC_FILE
:
11257 return remote_read_qxfer ("exec-file", annex
, readbuf
, offset
,
11259 &remote_protocol_packets
[PACKET_qXfer_exec_file
]);
11262 return TARGET_XFER_E_IO
;
11265 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
11266 large enough let the caller deal with it. */
11267 if (len
< get_remote_packet_size ())
11268 return TARGET_XFER_E_IO
;
11269 len
= get_remote_packet_size ();
11271 /* Except for querying the minimum buffer size, target must be open. */
11272 if (!rs
->remote_desc
)
11273 error (_("remote query is only available after target open"));
11275 gdb_assert (annex
!= NULL
);
11276 gdb_assert (readbuf
!= NULL
);
11278 p2
= rs
->buf
.data ();
11280 *p2
++ = query_type
;
11282 /* We used one buffer char for the remote protocol q command and
11283 another for the query type. As the remote protocol encapsulation
11284 uses 4 chars plus one extra in case we are debugging
11285 (remote_debug), we have PBUFZIZ - 7 left to pack the query
11288 while (annex
[i
] && (i
< (get_remote_packet_size () - 8)))
11290 /* Bad caller may have sent forbidden characters. */
11291 gdb_assert (isprint (annex
[i
]) && annex
[i
] != '$' && annex
[i
] != '#');
11296 gdb_assert (annex
[i
] == '\0');
11298 i
= putpkt (rs
->buf
);
11300 return TARGET_XFER_E_IO
;
11302 getpkt (&rs
->buf
, 0);
11303 strcpy ((char *) readbuf
, rs
->buf
.data ());
11305 *xfered_len
= strlen ((char *) readbuf
);
11306 return (*xfered_len
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
11309 /* Implementation of to_get_memory_xfer_limit. */
11312 remote_target::get_memory_xfer_limit ()
11314 return get_memory_write_packet_size ();
11318 remote_target::search_memory (CORE_ADDR start_addr
, ULONGEST search_space_len
,
11319 const gdb_byte
*pattern
, ULONGEST pattern_len
,
11320 CORE_ADDR
*found_addrp
)
11322 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
11323 struct remote_state
*rs
= get_remote_state ();
11324 int max_size
= get_memory_write_packet_size ();
11325 struct packet_config
*packet
=
11326 &remote_protocol_packets
[PACKET_qSearch_memory
];
11327 /* Number of packet bytes used to encode the pattern;
11328 this could be more than PATTERN_LEN due to escape characters. */
11329 int escaped_pattern_len
;
11330 /* Amount of pattern that was encodable in the packet. */
11331 int used_pattern_len
;
11334 ULONGEST found_addr
;
11336 auto read_memory
= [=] (CORE_ADDR addr
, gdb_byte
*result
, size_t len
)
11338 return (target_read (this, TARGET_OBJECT_MEMORY
, NULL
, result
, addr
, len
)
11342 /* Don't go to the target if we don't have to. This is done before
11343 checking packet_config_support to avoid the possibility that a
11344 success for this edge case means the facility works in
11346 if (pattern_len
> search_space_len
)
11348 if (pattern_len
== 0)
11350 *found_addrp
= start_addr
;
11354 /* If we already know the packet isn't supported, fall back to the simple
11355 way of searching memory. */
11357 if (packet_config_support (packet
) == PACKET_DISABLE
)
11359 /* Target doesn't provided special support, fall back and use the
11360 standard support (copy memory and do the search here). */
11361 return simple_search_memory (read_memory
, start_addr
, search_space_len
,
11362 pattern
, pattern_len
, found_addrp
);
11365 /* Make sure the remote is pointing at the right process. */
11366 set_general_process ();
11368 /* Insert header. */
11369 i
= snprintf (rs
->buf
.data (), max_size
,
11370 "qSearch:memory:%s;%s;",
11371 phex_nz (start_addr
, addr_size
),
11372 phex_nz (search_space_len
, sizeof (search_space_len
)));
11373 max_size
-= (i
+ 1);
11375 /* Escape as much data as fits into rs->buf. */
11376 escaped_pattern_len
=
11377 remote_escape_output (pattern
, pattern_len
, 1,
11378 (gdb_byte
*) rs
->buf
.data () + i
,
11379 &used_pattern_len
, max_size
);
11381 /* Bail if the pattern is too large. */
11382 if (used_pattern_len
!= pattern_len
)
11383 error (_("Pattern is too large to transmit to remote target."));
11385 if (putpkt_binary (rs
->buf
.data (), i
+ escaped_pattern_len
) < 0
11386 || getpkt_sane (&rs
->buf
, 0) < 0
11387 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11389 /* The request may not have worked because the command is not
11390 supported. If so, fall back to the simple way. */
11391 if (packet_config_support (packet
) == PACKET_DISABLE
)
11393 return simple_search_memory (read_memory
, start_addr
, search_space_len
,
11394 pattern
, pattern_len
, found_addrp
);
11399 if (rs
->buf
[0] == '0')
11401 else if (rs
->buf
[0] == '1')
11404 if (rs
->buf
[1] != ',')
11405 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
.data ());
11406 unpack_varlen_hex (&rs
->buf
[2], &found_addr
);
11407 *found_addrp
= found_addr
;
11410 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
.data ());
11416 remote_target::rcmd (const char *command
, struct ui_file
*outbuf
)
11418 struct remote_state
*rs
= get_remote_state ();
11419 char *p
= rs
->buf
.data ();
11421 if (!rs
->remote_desc
)
11422 error (_("remote rcmd is only available after target open"));
11424 /* Send a NULL command across as an empty command. */
11425 if (command
== NULL
)
11428 /* The query prefix. */
11429 strcpy (rs
->buf
.data (), "qRcmd,");
11430 p
= strchr (rs
->buf
.data (), '\0');
11432 if ((strlen (rs
->buf
.data ()) + strlen (command
) * 2 + 8/*misc*/)
11433 > get_remote_packet_size ())
11434 error (_("\"monitor\" command ``%s'' is too long."), command
);
11436 /* Encode the actual command. */
11437 bin2hex ((const gdb_byte
*) command
, p
, strlen (command
));
11439 if (putpkt (rs
->buf
) < 0)
11440 error (_("Communication problem with target."));
11442 /* get/display the response */
11447 /* XXX - see also remote_get_noisy_reply(). */
11448 QUIT
; /* Allow user to bail out with ^C. */
11450 if (getpkt_sane (&rs
->buf
, 0) == -1)
11452 /* Timeout. Continue to (try to) read responses.
11453 This is better than stopping with an error, assuming the stub
11454 is still executing the (long) monitor command.
11455 If needed, the user can interrupt gdb using C-c, obtaining
11456 an effect similar to stop on timeout. */
11459 buf
= rs
->buf
.data ();
11460 if (buf
[0] == '\0')
11461 error (_("Target does not support this command."));
11462 if (buf
[0] == 'O' && buf
[1] != 'K')
11464 remote_console_output (buf
+ 1); /* 'O' message from stub. */
11467 if (strcmp (buf
, "OK") == 0)
11469 if (strlen (buf
) == 3 && buf
[0] == 'E'
11470 && isdigit (buf
[1]) && isdigit (buf
[2]))
11472 error (_("Protocol error with Rcmd"));
11474 for (p
= buf
; p
[0] != '\0' && p
[1] != '\0'; p
+= 2)
11476 char c
= (fromhex (p
[0]) << 4) + fromhex (p
[1]);
11478 fputc_unfiltered (c
, outbuf
);
11484 std::vector
<mem_region
>
11485 remote_target::memory_map ()
11487 std::vector
<mem_region
> result
;
11488 gdb::optional
<gdb::char_vector
> text
11489 = target_read_stralloc (current_top_target (), TARGET_OBJECT_MEMORY_MAP
, NULL
);
11492 result
= parse_memory_map (text
->data ());
11498 packet_command (const char *args
, int from_tty
)
11500 remote_target
*remote
= get_current_remote_target ();
11502 if (remote
== nullptr)
11503 error (_("command can only be used with remote target"));
11505 remote
->packet_command (args
, from_tty
);
11509 remote_target::packet_command (const char *args
, int from_tty
)
11512 error (_("remote-packet command requires packet text as argument"));
11514 puts_filtered ("sending: ");
11515 print_packet (args
);
11516 puts_filtered ("\n");
11519 remote_state
*rs
= get_remote_state ();
11521 getpkt (&rs
->buf
, 0);
11522 puts_filtered ("received: ");
11523 print_packet (rs
->buf
.data ());
11524 puts_filtered ("\n");
11528 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
11530 static void display_thread_info (struct gdb_ext_thread_info
*info
);
11532 static void threadset_test_cmd (char *cmd
, int tty
);
11534 static void threadalive_test (char *cmd
, int tty
);
11536 static void threadlist_test_cmd (char *cmd
, int tty
);
11538 int get_and_display_threadinfo (threadref
*ref
);
11540 static void threadinfo_test_cmd (char *cmd
, int tty
);
11542 static int thread_display_step (threadref
*ref
, void *context
);
11544 static void threadlist_update_test_cmd (char *cmd
, int tty
);
11546 static void init_remote_threadtests (void);
11548 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
11551 threadset_test_cmd (const char *cmd
, int tty
)
11553 int sample_thread
= SAMPLE_THREAD
;
11555 printf_filtered (_("Remote threadset test\n"));
11556 set_general_thread (sample_thread
);
11561 threadalive_test (const char *cmd
, int tty
)
11563 int sample_thread
= SAMPLE_THREAD
;
11564 int pid
= inferior_ptid
.pid ();
11565 ptid_t ptid
= ptid_t (pid
, sample_thread
, 0);
11567 if (remote_thread_alive (ptid
))
11568 printf_filtered ("PASS: Thread alive test\n");
11570 printf_filtered ("FAIL: Thread alive test\n");
11573 void output_threadid (char *title
, threadref
*ref
);
11576 output_threadid (char *title
, threadref
*ref
)
11580 pack_threadid (&hexid
[0], ref
); /* Convert thread id into hex. */
11582 printf_filtered ("%s %s\n", title
, (&hexid
[0]));
11586 threadlist_test_cmd (const char *cmd
, int tty
)
11589 threadref nextthread
;
11590 int done
, result_count
;
11591 threadref threadlist
[3];
11593 printf_filtered ("Remote Threadlist test\n");
11594 if (!remote_get_threadlist (startflag
, &nextthread
, 3, &done
,
11595 &result_count
, &threadlist
[0]))
11596 printf_filtered ("FAIL: threadlist test\n");
11599 threadref
*scan
= threadlist
;
11600 threadref
*limit
= scan
+ result_count
;
11602 while (scan
< limit
)
11603 output_threadid (" thread ", scan
++);
11608 display_thread_info (struct gdb_ext_thread_info
*info
)
11610 output_threadid ("Threadid: ", &info
->threadid
);
11611 printf_filtered ("Name: %s\n ", info
->shortname
);
11612 printf_filtered ("State: %s\n", info
->display
);
11613 printf_filtered ("other: %s\n\n", info
->more_display
);
11617 get_and_display_threadinfo (threadref
*ref
)
11621 struct gdb_ext_thread_info threadinfo
;
11623 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
11624 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
11625 if (0 != (result
= remote_get_threadinfo (ref
, set
, &threadinfo
)))
11626 display_thread_info (&threadinfo
);
11631 threadinfo_test_cmd (const char *cmd
, int tty
)
11633 int athread
= SAMPLE_THREAD
;
11637 int_to_threadref (&thread
, athread
);
11638 printf_filtered ("Remote Threadinfo test\n");
11639 if (!get_and_display_threadinfo (&thread
))
11640 printf_filtered ("FAIL cannot get thread info\n");
11644 thread_display_step (threadref
*ref
, void *context
)
11646 /* output_threadid(" threadstep ",ref); *//* simple test */
11647 return get_and_display_threadinfo (ref
);
11651 threadlist_update_test_cmd (const char *cmd
, int tty
)
11653 printf_filtered ("Remote Threadlist update test\n");
11654 remote_threadlist_iterator (thread_display_step
, 0, CRAZY_MAX_THREADS
);
11658 init_remote_threadtests (void)
11660 add_com ("tlist", class_obscure
, threadlist_test_cmd
,
11661 _("Fetch and print the remote list of "
11662 "thread identifiers, one pkt only."));
11663 add_com ("tinfo", class_obscure
, threadinfo_test_cmd
,
11664 _("Fetch and display info about one thread."));
11665 add_com ("tset", class_obscure
, threadset_test_cmd
,
11666 _("Test setting to a different thread."));
11667 add_com ("tupd", class_obscure
, threadlist_update_test_cmd
,
11668 _("Iterate through updating all remote thread info."));
11669 add_com ("talive", class_obscure
, threadalive_test
,
11670 _("Remote thread alive test."));
11675 /* Convert a thread ID to a string. */
11678 remote_target::pid_to_str (ptid_t ptid
)
11680 struct remote_state
*rs
= get_remote_state ();
11682 if (ptid
== null_ptid
)
11683 return normal_pid_to_str (ptid
);
11684 else if (ptid
.is_pid ())
11686 /* Printing an inferior target id. */
11688 /* When multi-process extensions are off, there's no way in the
11689 remote protocol to know the remote process id, if there's any
11690 at all. There's one exception --- when we're connected with
11691 target extended-remote, and we manually attached to a process
11692 with "attach PID". We don't record anywhere a flag that
11693 allows us to distinguish that case from the case of
11694 connecting with extended-remote and the stub already being
11695 attached to a process, and reporting yes to qAttached, hence
11696 no smart special casing here. */
11697 if (!remote_multi_process_p (rs
))
11698 return "Remote target";
11700 return normal_pid_to_str (ptid
);
11704 if (magic_null_ptid
== ptid
)
11705 return "Thread <main>";
11706 else if (remote_multi_process_p (rs
))
11707 if (ptid
.lwp () == 0)
11708 return normal_pid_to_str (ptid
);
11710 return string_printf ("Thread %d.%ld",
11711 ptid
.pid (), ptid
.lwp ());
11713 return string_printf ("Thread %ld", ptid
.lwp ());
11717 /* Get the address of the thread local variable in OBJFILE which is
11718 stored at OFFSET within the thread local storage for thread PTID. */
11721 remote_target::get_thread_local_address (ptid_t ptid
, CORE_ADDR lm
,
11724 if (packet_support (PACKET_qGetTLSAddr
) != PACKET_DISABLE
)
11726 struct remote_state
*rs
= get_remote_state ();
11727 char *p
= rs
->buf
.data ();
11728 char *endp
= p
+ get_remote_packet_size ();
11729 enum packet_result result
;
11731 strcpy (p
, "qGetTLSAddr:");
11733 p
= write_ptid (p
, endp
, ptid
);
11735 p
+= hexnumstr (p
, offset
);
11737 p
+= hexnumstr (p
, lm
);
11741 getpkt (&rs
->buf
, 0);
11742 result
= packet_ok (rs
->buf
,
11743 &remote_protocol_packets
[PACKET_qGetTLSAddr
]);
11744 if (result
== PACKET_OK
)
11748 unpack_varlen_hex (rs
->buf
.data (), &addr
);
11751 else if (result
== PACKET_UNKNOWN
)
11752 throw_error (TLS_GENERIC_ERROR
,
11753 _("Remote target doesn't support qGetTLSAddr packet"));
11755 throw_error (TLS_GENERIC_ERROR
,
11756 _("Remote target failed to process qGetTLSAddr request"));
11759 throw_error (TLS_GENERIC_ERROR
,
11760 _("TLS not supported or disabled on this target"));
11765 /* Provide thread local base, i.e. Thread Information Block address.
11766 Returns 1 if ptid is found and thread_local_base is non zero. */
11769 remote_target::get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
)
11771 if (packet_support (PACKET_qGetTIBAddr
) != PACKET_DISABLE
)
11773 struct remote_state
*rs
= get_remote_state ();
11774 char *p
= rs
->buf
.data ();
11775 char *endp
= p
+ get_remote_packet_size ();
11776 enum packet_result result
;
11778 strcpy (p
, "qGetTIBAddr:");
11780 p
= write_ptid (p
, endp
, ptid
);
11784 getpkt (&rs
->buf
, 0);
11785 result
= packet_ok (rs
->buf
,
11786 &remote_protocol_packets
[PACKET_qGetTIBAddr
]);
11787 if (result
== PACKET_OK
)
11790 unpack_varlen_hex (rs
->buf
.data (), &val
);
11792 *addr
= (CORE_ADDR
) val
;
11795 else if (result
== PACKET_UNKNOWN
)
11796 error (_("Remote target doesn't support qGetTIBAddr packet"));
11798 error (_("Remote target failed to process qGetTIBAddr request"));
11801 error (_("qGetTIBAddr not supported or disabled on this target"));
11806 /* Support for inferring a target description based on the current
11807 architecture and the size of a 'g' packet. While the 'g' packet
11808 can have any size (since optional registers can be left off the
11809 end), some sizes are easily recognizable given knowledge of the
11810 approximate architecture. */
11812 struct remote_g_packet_guess
11814 remote_g_packet_guess (int bytes_
, const struct target_desc
*tdesc_
)
11821 const struct target_desc
*tdesc
;
11824 struct remote_g_packet_data
: public allocate_on_obstack
11826 std::vector
<remote_g_packet_guess
> guesses
;
11829 static struct gdbarch_data
*remote_g_packet_data_handle
;
11832 remote_g_packet_data_init (struct obstack
*obstack
)
11834 return new (obstack
) remote_g_packet_data
;
11838 register_remote_g_packet_guess (struct gdbarch
*gdbarch
, int bytes
,
11839 const struct target_desc
*tdesc
)
11841 struct remote_g_packet_data
*data
11842 = ((struct remote_g_packet_data
*)
11843 gdbarch_data (gdbarch
, remote_g_packet_data_handle
));
11845 gdb_assert (tdesc
!= NULL
);
11847 for (const remote_g_packet_guess
&guess
: data
->guesses
)
11848 if (guess
.bytes
== bytes
)
11849 internal_error (__FILE__
, __LINE__
,
11850 _("Duplicate g packet description added for size %d"),
11853 data
->guesses
.emplace_back (bytes
, tdesc
);
11856 /* Return true if remote_read_description would do anything on this target
11857 and architecture, false otherwise. */
11860 remote_read_description_p (struct target_ops
*target
)
11862 struct remote_g_packet_data
*data
11863 = ((struct remote_g_packet_data
*)
11864 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
));
11866 return !data
->guesses
.empty ();
11869 const struct target_desc
*
11870 remote_target::read_description ()
11872 struct remote_g_packet_data
*data
11873 = ((struct remote_g_packet_data
*)
11874 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
));
11876 /* Do not try this during initial connection, when we do not know
11877 whether there is a running but stopped thread. */
11878 if (!target_has_execution () || inferior_ptid
== null_ptid
)
11879 return beneath ()->read_description ();
11881 if (!data
->guesses
.empty ())
11883 int bytes
= send_g_packet ();
11885 for (const remote_g_packet_guess
&guess
: data
->guesses
)
11886 if (guess
.bytes
== bytes
)
11887 return guess
.tdesc
;
11889 /* We discard the g packet. A minor optimization would be to
11890 hold on to it, and fill the register cache once we have selected
11891 an architecture, but it's too tricky to do safely. */
11894 return beneath ()->read_description ();
11897 /* Remote file transfer support. This is host-initiated I/O, not
11898 target-initiated; for target-initiated, see remote-fileio.c. */
11900 /* If *LEFT is at least the length of STRING, copy STRING to
11901 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11902 decrease *LEFT. Otherwise raise an error. */
11905 remote_buffer_add_string (char **buffer
, int *left
, const char *string
)
11907 int len
= strlen (string
);
11910 error (_("Packet too long for target."));
11912 memcpy (*buffer
, string
, len
);
11916 /* NUL-terminate the buffer as a convenience, if there is
11922 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
11923 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11924 decrease *LEFT. Otherwise raise an error. */
11927 remote_buffer_add_bytes (char **buffer
, int *left
, const gdb_byte
*bytes
,
11930 if (2 * len
> *left
)
11931 error (_("Packet too long for target."));
11933 bin2hex (bytes
, *buffer
, len
);
11934 *buffer
+= 2 * len
;
11937 /* NUL-terminate the buffer as a convenience, if there is
11943 /* If *LEFT is large enough, convert VALUE to hex and add it to
11944 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11945 decrease *LEFT. Otherwise raise an error. */
11948 remote_buffer_add_int (char **buffer
, int *left
, ULONGEST value
)
11950 int len
= hexnumlen (value
);
11953 error (_("Packet too long for target."));
11955 hexnumstr (*buffer
, value
);
11959 /* NUL-terminate the buffer as a convenience, if there is
11965 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
11966 value, *REMOTE_ERRNO to the remote error number or zero if none
11967 was included, and *ATTACHMENT to point to the start of the annex
11968 if any. The length of the packet isn't needed here; there may
11969 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
11971 Return 0 if the packet could be parsed, -1 if it could not. If
11972 -1 is returned, the other variables may not be initialized. */
11975 remote_hostio_parse_result (char *buffer
, int *retcode
,
11976 int *remote_errno
, char **attachment
)
11981 *attachment
= NULL
;
11983 if (buffer
[0] != 'F')
11987 *retcode
= strtol (&buffer
[1], &p
, 16);
11988 if (errno
!= 0 || p
== &buffer
[1])
11991 /* Check for ",errno". */
11995 *remote_errno
= strtol (p
+ 1, &p2
, 16);
11996 if (errno
!= 0 || p
+ 1 == p2
)
12001 /* Check for ";attachment". If there is no attachment, the
12002 packet should end here. */
12005 *attachment
= p
+ 1;
12008 else if (*p
== '\0')
12014 /* Send a prepared I/O packet to the target and read its response.
12015 The prepared packet is in the global RS->BUF before this function
12016 is called, and the answer is there when we return.
12018 COMMAND_BYTES is the length of the request to send, which may include
12019 binary data. WHICH_PACKET is the packet configuration to check
12020 before attempting a packet. If an error occurs, *REMOTE_ERRNO
12021 is set to the error number and -1 is returned. Otherwise the value
12022 returned by the function is returned.
12024 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
12025 attachment is expected; an error will be reported if there's a
12026 mismatch. If one is found, *ATTACHMENT will be set to point into
12027 the packet buffer and *ATTACHMENT_LEN will be set to the
12028 attachment's length. */
12031 remote_target::remote_hostio_send_command (int command_bytes
, int which_packet
,
12032 int *remote_errno
, char **attachment
,
12033 int *attachment_len
)
12035 struct remote_state
*rs
= get_remote_state ();
12036 int ret
, bytes_read
;
12037 char *attachment_tmp
;
12039 if (packet_support (which_packet
) == PACKET_DISABLE
)
12041 *remote_errno
= FILEIO_ENOSYS
;
12045 putpkt_binary (rs
->buf
.data (), command_bytes
);
12046 bytes_read
= getpkt_sane (&rs
->buf
, 0);
12048 /* If it timed out, something is wrong. Don't try to parse the
12050 if (bytes_read
< 0)
12052 *remote_errno
= FILEIO_EINVAL
;
12056 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[which_packet
]))
12059 *remote_errno
= FILEIO_EINVAL
;
12061 case PACKET_UNKNOWN
:
12062 *remote_errno
= FILEIO_ENOSYS
;
12068 if (remote_hostio_parse_result (rs
->buf
.data (), &ret
, remote_errno
,
12071 *remote_errno
= FILEIO_EINVAL
;
12075 /* Make sure we saw an attachment if and only if we expected one. */
12076 if ((attachment_tmp
== NULL
&& attachment
!= NULL
)
12077 || (attachment_tmp
!= NULL
&& attachment
== NULL
))
12079 *remote_errno
= FILEIO_EINVAL
;
12083 /* If an attachment was found, it must point into the packet buffer;
12084 work out how many bytes there were. */
12085 if (attachment_tmp
!= NULL
)
12087 *attachment
= attachment_tmp
;
12088 *attachment_len
= bytes_read
- (*attachment
- rs
->buf
.data ());
12094 /* See declaration.h. */
12097 readahead_cache::invalidate ()
12102 /* See declaration.h. */
12105 readahead_cache::invalidate_fd (int fd
)
12107 if (this->fd
== fd
)
12111 /* Set the filesystem remote_hostio functions that take FILENAME
12112 arguments will use. Return 0 on success, or -1 if an error
12113 occurs (and set *REMOTE_ERRNO). */
12116 remote_target::remote_hostio_set_filesystem (struct inferior
*inf
,
12119 struct remote_state
*rs
= get_remote_state ();
12120 int required_pid
= (inf
== NULL
|| inf
->fake_pid_p
) ? 0 : inf
->pid
;
12121 char *p
= rs
->buf
.data ();
12122 int left
= get_remote_packet_size () - 1;
12126 if (packet_support (PACKET_vFile_setfs
) == PACKET_DISABLE
)
12129 if (rs
->fs_pid
!= -1 && required_pid
== rs
->fs_pid
)
12132 remote_buffer_add_string (&p
, &left
, "vFile:setfs:");
12134 xsnprintf (arg
, sizeof (arg
), "%x", required_pid
);
12135 remote_buffer_add_string (&p
, &left
, arg
);
12137 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_setfs
,
12138 remote_errno
, NULL
, NULL
);
12140 if (packet_support (PACKET_vFile_setfs
) == PACKET_DISABLE
)
12144 rs
->fs_pid
= required_pid
;
12149 /* Implementation of to_fileio_open. */
12152 remote_target::remote_hostio_open (inferior
*inf
, const char *filename
,
12153 int flags
, int mode
, int warn_if_slow
,
12156 struct remote_state
*rs
= get_remote_state ();
12157 char *p
= rs
->buf
.data ();
12158 int left
= get_remote_packet_size () - 1;
12162 static int warning_issued
= 0;
12164 printf_unfiltered (_("Reading %s from remote target...\n"),
12167 if (!warning_issued
)
12169 warning (_("File transfers from remote targets can be slow."
12170 " Use \"set sysroot\" to access files locally"
12172 warning_issued
= 1;
12176 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12179 remote_buffer_add_string (&p
, &left
, "vFile:open:");
12181 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12182 strlen (filename
));
12183 remote_buffer_add_string (&p
, &left
, ",");
12185 remote_buffer_add_int (&p
, &left
, flags
);
12186 remote_buffer_add_string (&p
, &left
, ",");
12188 remote_buffer_add_int (&p
, &left
, mode
);
12190 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_open
,
12191 remote_errno
, NULL
, NULL
);
12195 remote_target::fileio_open (struct inferior
*inf
, const char *filename
,
12196 int flags
, int mode
, int warn_if_slow
,
12199 return remote_hostio_open (inf
, filename
, flags
, mode
, warn_if_slow
,
12203 /* Implementation of to_fileio_pwrite. */
12206 remote_target::remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
12207 ULONGEST offset
, int *remote_errno
)
12209 struct remote_state
*rs
= get_remote_state ();
12210 char *p
= rs
->buf
.data ();
12211 int left
= get_remote_packet_size ();
12214 rs
->readahead_cache
.invalidate_fd (fd
);
12216 remote_buffer_add_string (&p
, &left
, "vFile:pwrite:");
12218 remote_buffer_add_int (&p
, &left
, fd
);
12219 remote_buffer_add_string (&p
, &left
, ",");
12221 remote_buffer_add_int (&p
, &left
, offset
);
12222 remote_buffer_add_string (&p
, &left
, ",");
12224 p
+= remote_escape_output (write_buf
, len
, 1, (gdb_byte
*) p
, &out_len
,
12225 (get_remote_packet_size ()
12226 - (p
- rs
->buf
.data ())));
12228 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_pwrite
,
12229 remote_errno
, NULL
, NULL
);
12233 remote_target::fileio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
12234 ULONGEST offset
, int *remote_errno
)
12236 return remote_hostio_pwrite (fd
, write_buf
, len
, offset
, remote_errno
);
12239 /* Helper for the implementation of to_fileio_pread. Read the file
12240 from the remote side with vFile:pread. */
12243 remote_target::remote_hostio_pread_vFile (int fd
, gdb_byte
*read_buf
, int len
,
12244 ULONGEST offset
, int *remote_errno
)
12246 struct remote_state
*rs
= get_remote_state ();
12247 char *p
= rs
->buf
.data ();
12249 int left
= get_remote_packet_size ();
12250 int ret
, attachment_len
;
12253 remote_buffer_add_string (&p
, &left
, "vFile:pread:");
12255 remote_buffer_add_int (&p
, &left
, fd
);
12256 remote_buffer_add_string (&p
, &left
, ",");
12258 remote_buffer_add_int (&p
, &left
, len
);
12259 remote_buffer_add_string (&p
, &left
, ",");
12261 remote_buffer_add_int (&p
, &left
, offset
);
12263 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_pread
,
12264 remote_errno
, &attachment
,
12270 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12272 if (read_len
!= ret
)
12273 error (_("Read returned %d, but %d bytes."), ret
, (int) read_len
);
12278 /* See declaration.h. */
12281 readahead_cache::pread (int fd
, gdb_byte
*read_buf
, size_t len
,
12285 && this->offset
<= offset
12286 && offset
< this->offset
+ this->bufsize
)
12288 ULONGEST max
= this->offset
+ this->bufsize
;
12290 if (offset
+ len
> max
)
12291 len
= max
- offset
;
12293 memcpy (read_buf
, this->buf
+ offset
- this->offset
, len
);
12300 /* Implementation of to_fileio_pread. */
12303 remote_target::remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
12304 ULONGEST offset
, int *remote_errno
)
12307 struct remote_state
*rs
= get_remote_state ();
12308 readahead_cache
*cache
= &rs
->readahead_cache
;
12310 ret
= cache
->pread (fd
, read_buf
, len
, offset
);
12313 cache
->hit_count
++;
12316 fprintf_unfiltered (gdb_stdlog
, "readahead cache hit %s\n",
12317 pulongest (cache
->hit_count
));
12321 cache
->miss_count
++;
12323 fprintf_unfiltered (gdb_stdlog
, "readahead cache miss %s\n",
12324 pulongest (cache
->miss_count
));
12327 cache
->offset
= offset
;
12328 cache
->bufsize
= get_remote_packet_size ();
12329 cache
->buf
= (gdb_byte
*) xrealloc (cache
->buf
, cache
->bufsize
);
12331 ret
= remote_hostio_pread_vFile (cache
->fd
, cache
->buf
, cache
->bufsize
,
12332 cache
->offset
, remote_errno
);
12335 cache
->invalidate_fd (fd
);
12339 cache
->bufsize
= ret
;
12340 return cache
->pread (fd
, read_buf
, len
, offset
);
12344 remote_target::fileio_pread (int fd
, gdb_byte
*read_buf
, int len
,
12345 ULONGEST offset
, int *remote_errno
)
12347 return remote_hostio_pread (fd
, read_buf
, len
, offset
, remote_errno
);
12350 /* Implementation of to_fileio_close. */
12353 remote_target::remote_hostio_close (int fd
, int *remote_errno
)
12355 struct remote_state
*rs
= get_remote_state ();
12356 char *p
= rs
->buf
.data ();
12357 int left
= get_remote_packet_size () - 1;
12359 rs
->readahead_cache
.invalidate_fd (fd
);
12361 remote_buffer_add_string (&p
, &left
, "vFile:close:");
12363 remote_buffer_add_int (&p
, &left
, fd
);
12365 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_close
,
12366 remote_errno
, NULL
, NULL
);
12370 remote_target::fileio_close (int fd
, int *remote_errno
)
12372 return remote_hostio_close (fd
, remote_errno
);
12375 /* Implementation of to_fileio_unlink. */
12378 remote_target::remote_hostio_unlink (inferior
*inf
, const char *filename
,
12381 struct remote_state
*rs
= get_remote_state ();
12382 char *p
= rs
->buf
.data ();
12383 int left
= get_remote_packet_size () - 1;
12385 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12388 remote_buffer_add_string (&p
, &left
, "vFile:unlink:");
12390 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12391 strlen (filename
));
12393 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_unlink
,
12394 remote_errno
, NULL
, NULL
);
12398 remote_target::fileio_unlink (struct inferior
*inf
, const char *filename
,
12401 return remote_hostio_unlink (inf
, filename
, remote_errno
);
12404 /* Implementation of to_fileio_readlink. */
12406 gdb::optional
<std::string
>
12407 remote_target::fileio_readlink (struct inferior
*inf
, const char *filename
,
12410 struct remote_state
*rs
= get_remote_state ();
12411 char *p
= rs
->buf
.data ();
12413 int left
= get_remote_packet_size ();
12414 int len
, attachment_len
;
12417 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12420 remote_buffer_add_string (&p
, &left
, "vFile:readlink:");
12422 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12423 strlen (filename
));
12425 len
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_readlink
,
12426 remote_errno
, &attachment
,
12432 std::string
ret (len
, '\0');
12434 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12435 (gdb_byte
*) &ret
[0], len
);
12436 if (read_len
!= len
)
12437 error (_("Readlink returned %d, but %d bytes."), len
, read_len
);
12442 /* Implementation of to_fileio_fstat. */
12445 remote_target::fileio_fstat (int fd
, struct stat
*st
, int *remote_errno
)
12447 struct remote_state
*rs
= get_remote_state ();
12448 char *p
= rs
->buf
.data ();
12449 int left
= get_remote_packet_size ();
12450 int attachment_len
, ret
;
12452 struct fio_stat fst
;
12455 remote_buffer_add_string (&p
, &left
, "vFile:fstat:");
12457 remote_buffer_add_int (&p
, &left
, fd
);
12459 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_fstat
,
12460 remote_errno
, &attachment
,
12464 if (*remote_errno
!= FILEIO_ENOSYS
)
12467 /* Strictly we should return -1, ENOSYS here, but when
12468 "set sysroot remote:" was implemented in August 2008
12469 BFD's need for a stat function was sidestepped with
12470 this hack. This was not remedied until March 2015
12471 so we retain the previous behavior to avoid breaking
12474 Note that the memset is a March 2015 addition; older
12475 GDBs set st_size *and nothing else* so the structure
12476 would have garbage in all other fields. This might
12477 break something but retaining the previous behavior
12478 here would be just too wrong. */
12480 memset (st
, 0, sizeof (struct stat
));
12481 st
->st_size
= INT_MAX
;
12485 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12486 (gdb_byte
*) &fst
, sizeof (fst
));
12488 if (read_len
!= ret
)
12489 error (_("vFile:fstat returned %d, but %d bytes."), ret
, read_len
);
12491 if (read_len
!= sizeof (fst
))
12492 error (_("vFile:fstat returned %d bytes, but expecting %d."),
12493 read_len
, (int) sizeof (fst
));
12495 remote_fileio_to_host_stat (&fst
, st
);
12500 /* Implementation of to_filesystem_is_local. */
12503 remote_target::filesystem_is_local ()
12505 /* Valgrind GDB presents itself as a remote target but works
12506 on the local filesystem: it does not implement remote get
12507 and users are not expected to set a sysroot. To handle
12508 this case we treat the remote filesystem as local if the
12509 sysroot is exactly TARGET_SYSROOT_PREFIX and if the stub
12510 does not support vFile:open. */
12511 if (strcmp (gdb_sysroot
, TARGET_SYSROOT_PREFIX
) == 0)
12513 enum packet_support ps
= packet_support (PACKET_vFile_open
);
12515 if (ps
== PACKET_SUPPORT_UNKNOWN
)
12517 int fd
, remote_errno
;
12519 /* Try opening a file to probe support. The supplied
12520 filename is irrelevant, we only care about whether
12521 the stub recognizes the packet or not. */
12522 fd
= remote_hostio_open (NULL
, "just probing",
12523 FILEIO_O_RDONLY
, 0700, 0,
12527 remote_hostio_close (fd
, &remote_errno
);
12529 ps
= packet_support (PACKET_vFile_open
);
12532 if (ps
== PACKET_DISABLE
)
12534 static int warning_issued
= 0;
12536 if (!warning_issued
)
12538 warning (_("remote target does not support file"
12539 " transfer, attempting to access files"
12540 " from local filesystem."));
12541 warning_issued
= 1;
12552 remote_fileio_errno_to_host (int errnum
)
12558 case FILEIO_ENOENT
:
12566 case FILEIO_EACCES
:
12568 case FILEIO_EFAULT
:
12572 case FILEIO_EEXIST
:
12574 case FILEIO_ENODEV
:
12576 case FILEIO_ENOTDIR
:
12578 case FILEIO_EISDIR
:
12580 case FILEIO_EINVAL
:
12582 case FILEIO_ENFILE
:
12584 case FILEIO_EMFILE
:
12588 case FILEIO_ENOSPC
:
12590 case FILEIO_ESPIPE
:
12594 case FILEIO_ENOSYS
:
12596 case FILEIO_ENAMETOOLONG
:
12597 return ENAMETOOLONG
;
12603 remote_hostio_error (int errnum
)
12605 int host_error
= remote_fileio_errno_to_host (errnum
);
12607 if (host_error
== -1)
12608 error (_("Unknown remote I/O error %d"), errnum
);
12610 error (_("Remote I/O error: %s"), safe_strerror (host_error
));
12613 /* A RAII wrapper around a remote file descriptor. */
12615 class scoped_remote_fd
12618 scoped_remote_fd (remote_target
*remote
, int fd
)
12619 : m_remote (remote
), m_fd (fd
)
12623 ~scoped_remote_fd ()
12630 m_remote
->remote_hostio_close (m_fd
, &remote_errno
);
12634 /* Swallow exception before it escapes the dtor. If
12635 something goes wrong, likely the connection is gone,
12636 and there's nothing else that can be done. */
12641 DISABLE_COPY_AND_ASSIGN (scoped_remote_fd
);
12643 /* Release ownership of the file descriptor, and return it. */
12644 ATTRIBUTE_UNUSED_RESULT
int release () noexcept
12651 /* Return the owned file descriptor. */
12652 int get () const noexcept
12658 /* The remote target. */
12659 remote_target
*m_remote
;
12661 /* The owned remote I/O file descriptor. */
12666 remote_file_put (const char *local_file
, const char *remote_file
, int from_tty
)
12668 remote_target
*remote
= get_current_remote_target ();
12670 if (remote
== nullptr)
12671 error (_("command can only be used with remote target"));
12673 remote
->remote_file_put (local_file
, remote_file
, from_tty
);
12677 remote_target::remote_file_put (const char *local_file
, const char *remote_file
,
12680 int retcode
, remote_errno
, bytes
, io_size
;
12681 int bytes_in_buffer
;
12685 gdb_file_up file
= gdb_fopen_cloexec (local_file
, "rb");
12687 perror_with_name (local_file
);
12689 scoped_remote_fd fd
12690 (this, remote_hostio_open (NULL
,
12691 remote_file
, (FILEIO_O_WRONLY
| FILEIO_O_CREAT
12693 0700, 0, &remote_errno
));
12694 if (fd
.get () == -1)
12695 remote_hostio_error (remote_errno
);
12697 /* Send up to this many bytes at once. They won't all fit in the
12698 remote packet limit, so we'll transfer slightly fewer. */
12699 io_size
= get_remote_packet_size ();
12700 gdb::byte_vector
buffer (io_size
);
12702 bytes_in_buffer
= 0;
12705 while (bytes_in_buffer
|| !saw_eof
)
12709 bytes
= fread (buffer
.data () + bytes_in_buffer
, 1,
12710 io_size
- bytes_in_buffer
,
12714 if (ferror (file
.get ()))
12715 error (_("Error reading %s."), local_file
);
12718 /* EOF. Unless there is something still in the
12719 buffer from the last iteration, we are done. */
12721 if (bytes_in_buffer
== 0)
12729 bytes
+= bytes_in_buffer
;
12730 bytes_in_buffer
= 0;
12732 retcode
= remote_hostio_pwrite (fd
.get (), buffer
.data (), bytes
,
12733 offset
, &remote_errno
);
12736 remote_hostio_error (remote_errno
);
12737 else if (retcode
== 0)
12738 error (_("Remote write of %d bytes returned 0!"), bytes
);
12739 else if (retcode
< bytes
)
12741 /* Short write. Save the rest of the read data for the next
12743 bytes_in_buffer
= bytes
- retcode
;
12744 memmove (buffer
.data (), buffer
.data () + retcode
, bytes_in_buffer
);
12750 if (remote_hostio_close (fd
.release (), &remote_errno
))
12751 remote_hostio_error (remote_errno
);
12754 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file
);
12758 remote_file_get (const char *remote_file
, const char *local_file
, int from_tty
)
12760 remote_target
*remote
= get_current_remote_target ();
12762 if (remote
== nullptr)
12763 error (_("command can only be used with remote target"));
12765 remote
->remote_file_get (remote_file
, local_file
, from_tty
);
12769 remote_target::remote_file_get (const char *remote_file
, const char *local_file
,
12772 int remote_errno
, bytes
, io_size
;
12775 scoped_remote_fd fd
12776 (this, remote_hostio_open (NULL
,
12777 remote_file
, FILEIO_O_RDONLY
, 0, 0,
12779 if (fd
.get () == -1)
12780 remote_hostio_error (remote_errno
);
12782 gdb_file_up file
= gdb_fopen_cloexec (local_file
, "wb");
12784 perror_with_name (local_file
);
12786 /* Send up to this many bytes at once. They won't all fit in the
12787 remote packet limit, so we'll transfer slightly fewer. */
12788 io_size
= get_remote_packet_size ();
12789 gdb::byte_vector
buffer (io_size
);
12794 bytes
= remote_hostio_pread (fd
.get (), buffer
.data (), io_size
, offset
,
12797 /* Success, but no bytes, means end-of-file. */
12800 remote_hostio_error (remote_errno
);
12804 bytes
= fwrite (buffer
.data (), 1, bytes
, file
.get ());
12806 perror_with_name (local_file
);
12809 if (remote_hostio_close (fd
.release (), &remote_errno
))
12810 remote_hostio_error (remote_errno
);
12813 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file
);
12817 remote_file_delete (const char *remote_file
, int from_tty
)
12819 remote_target
*remote
= get_current_remote_target ();
12821 if (remote
== nullptr)
12822 error (_("command can only be used with remote target"));
12824 remote
->remote_file_delete (remote_file
, from_tty
);
12828 remote_target::remote_file_delete (const char *remote_file
, int from_tty
)
12830 int retcode
, remote_errno
;
12832 retcode
= remote_hostio_unlink (NULL
, remote_file
, &remote_errno
);
12834 remote_hostio_error (remote_errno
);
12837 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file
);
12841 remote_put_command (const char *args
, int from_tty
)
12844 error_no_arg (_("file to put"));
12846 gdb_argv
argv (args
);
12847 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
12848 error (_("Invalid parameters to remote put"));
12850 remote_file_put (argv
[0], argv
[1], from_tty
);
12854 remote_get_command (const char *args
, int from_tty
)
12857 error_no_arg (_("file to get"));
12859 gdb_argv
argv (args
);
12860 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
12861 error (_("Invalid parameters to remote get"));
12863 remote_file_get (argv
[0], argv
[1], from_tty
);
12867 remote_delete_command (const char *args
, int from_tty
)
12870 error_no_arg (_("file to delete"));
12872 gdb_argv
argv (args
);
12873 if (argv
[0] == NULL
|| argv
[1] != NULL
)
12874 error (_("Invalid parameters to remote delete"));
12876 remote_file_delete (argv
[0], from_tty
);
12880 remote_target::can_execute_reverse ()
12882 if (packet_support (PACKET_bs
) == PACKET_ENABLE
12883 || packet_support (PACKET_bc
) == PACKET_ENABLE
)
12890 remote_target::supports_non_stop ()
12896 remote_target::supports_disable_randomization ()
12898 /* Only supported in extended mode. */
12903 remote_target::supports_multi_process ()
12905 struct remote_state
*rs
= get_remote_state ();
12907 return remote_multi_process_p (rs
);
12911 remote_supports_cond_tracepoints ()
12913 return packet_support (PACKET_ConditionalTracepoints
) == PACKET_ENABLE
;
12917 remote_target::supports_evaluation_of_breakpoint_conditions ()
12919 return packet_support (PACKET_ConditionalBreakpoints
) == PACKET_ENABLE
;
12923 remote_supports_fast_tracepoints ()
12925 return packet_support (PACKET_FastTracepoints
) == PACKET_ENABLE
;
12929 remote_supports_static_tracepoints ()
12931 return packet_support (PACKET_StaticTracepoints
) == PACKET_ENABLE
;
12935 remote_supports_install_in_trace ()
12937 return packet_support (PACKET_InstallInTrace
) == PACKET_ENABLE
;
12941 remote_target::supports_enable_disable_tracepoint ()
12943 return (packet_support (PACKET_EnableDisableTracepoints_feature
)
12948 remote_target::supports_string_tracing ()
12950 return packet_support (PACKET_tracenz_feature
) == PACKET_ENABLE
;
12954 remote_target::can_run_breakpoint_commands ()
12956 return packet_support (PACKET_BreakpointCommands
) == PACKET_ENABLE
;
12960 remote_target::trace_init ()
12962 struct remote_state
*rs
= get_remote_state ();
12965 remote_get_noisy_reply ();
12966 if (strcmp (rs
->buf
.data (), "OK") != 0)
12967 error (_("Target does not support this command."));
12970 /* Recursive routine to walk through command list including loops, and
12971 download packets for each command. */
12974 remote_target::remote_download_command_source (int num
, ULONGEST addr
,
12975 struct command_line
*cmds
)
12977 struct remote_state
*rs
= get_remote_state ();
12978 struct command_line
*cmd
;
12980 for (cmd
= cmds
; cmd
; cmd
= cmd
->next
)
12982 QUIT
; /* Allow user to bail out with ^C. */
12983 strcpy (rs
->buf
.data (), "QTDPsrc:");
12984 encode_source_string (num
, addr
, "cmd", cmd
->line
,
12985 rs
->buf
.data () + strlen (rs
->buf
.data ()),
12986 rs
->buf
.size () - strlen (rs
->buf
.data ()));
12988 remote_get_noisy_reply ();
12989 if (strcmp (rs
->buf
.data (), "OK"))
12990 warning (_("Target does not support source download."));
12992 if (cmd
->control_type
== while_control
12993 || cmd
->control_type
== while_stepping_control
)
12995 remote_download_command_source (num
, addr
, cmd
->body_list_0
.get ());
12997 QUIT
; /* Allow user to bail out with ^C. */
12998 strcpy (rs
->buf
.data (), "QTDPsrc:");
12999 encode_source_string (num
, addr
, "cmd", "end",
13000 rs
->buf
.data () + strlen (rs
->buf
.data ()),
13001 rs
->buf
.size () - strlen (rs
->buf
.data ()));
13003 remote_get_noisy_reply ();
13004 if (strcmp (rs
->buf
.data (), "OK"))
13005 warning (_("Target does not support source download."));
13011 remote_target::download_tracepoint (struct bp_location
*loc
)
13015 std::vector
<std::string
> tdp_actions
;
13016 std::vector
<std::string
> stepping_actions
;
13018 struct breakpoint
*b
= loc
->owner
;
13019 struct tracepoint
*t
= (struct tracepoint
*) b
;
13020 struct remote_state
*rs
= get_remote_state ();
13022 const char *err_msg
= _("Tracepoint packet too large for target.");
13025 /* We use a buffer other than rs->buf because we'll build strings
13026 across multiple statements, and other statements in between could
13028 gdb::char_vector
buf (get_remote_packet_size ());
13030 encode_actions_rsp (loc
, &tdp_actions
, &stepping_actions
);
13032 tpaddr
= loc
->address
;
13033 strcpy (addrbuf
, phex (tpaddr
, sizeof (CORE_ADDR
)));
13034 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:%x:%s:%c:%lx:%x",
13035 b
->number
, addrbuf
, /* address */
13036 (b
->enable_state
== bp_enabled
? 'E' : 'D'),
13037 t
->step_count
, t
->pass_count
);
13039 if (ret
< 0 || ret
>= buf
.size ())
13040 error ("%s", err_msg
);
13042 /* Fast tracepoints are mostly handled by the target, but we can
13043 tell the target how big of an instruction block should be moved
13045 if (b
->type
== bp_fast_tracepoint
)
13047 /* Only test for support at download time; we may not know
13048 target capabilities at definition time. */
13049 if (remote_supports_fast_tracepoints ())
13051 if (gdbarch_fast_tracepoint_valid_at (loc
->gdbarch
, tpaddr
,
13054 size_left
= buf
.size () - strlen (buf
.data ());
13055 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13057 gdb_insn_length (loc
->gdbarch
, tpaddr
));
13059 if (ret
< 0 || ret
>= size_left
)
13060 error ("%s", err_msg
);
13063 /* If it passed validation at definition but fails now,
13064 something is very wrong. */
13065 internal_error (__FILE__
, __LINE__
,
13066 _("Fast tracepoint not "
13067 "valid during download"));
13070 /* Fast tracepoints are functionally identical to regular
13071 tracepoints, so don't take lack of support as a reason to
13072 give up on the trace run. */
13073 warning (_("Target does not support fast tracepoints, "
13074 "downloading %d as regular tracepoint"), b
->number
);
13076 else if (b
->type
== bp_static_tracepoint
)
13078 /* Only test for support at download time; we may not know
13079 target capabilities at definition time. */
13080 if (remote_supports_static_tracepoints ())
13082 struct static_tracepoint_marker marker
;
13084 if (target_static_tracepoint_marker_at (tpaddr
, &marker
))
13086 size_left
= buf
.size () - strlen (buf
.data ());
13087 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13090 if (ret
< 0 || ret
>= size_left
)
13091 error ("%s", err_msg
);
13094 error (_("Static tracepoint not valid during download"));
13097 /* Fast tracepoints are functionally identical to regular
13098 tracepoints, so don't take lack of support as a reason
13099 to give up on the trace run. */
13100 error (_("Target does not support static tracepoints"));
13102 /* If the tracepoint has a conditional, make it into an agent
13103 expression and append to the definition. */
13106 /* Only test support at download time, we may not know target
13107 capabilities at definition time. */
13108 if (remote_supports_cond_tracepoints ())
13110 agent_expr_up aexpr
= gen_eval_for_expr (tpaddr
,
13113 size_left
= buf
.size () - strlen (buf
.data ());
13115 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13116 size_left
, ":X%x,", aexpr
->len
);
13118 if (ret
< 0 || ret
>= size_left
)
13119 error ("%s", err_msg
);
13121 size_left
= buf
.size () - strlen (buf
.data ());
13123 /* Two bytes to encode each aexpr byte, plus the terminating
13125 if (aexpr
->len
* 2 + 1 > size_left
)
13126 error ("%s", err_msg
);
13128 pkt
= buf
.data () + strlen (buf
.data ());
13130 for (int ndx
= 0; ndx
< aexpr
->len
; ++ndx
)
13131 pkt
= pack_hex_byte (pkt
, aexpr
->buf
[ndx
]);
13135 warning (_("Target does not support conditional tracepoints, "
13136 "ignoring tp %d cond"), b
->number
);
13139 if (b
->commands
|| *default_collect
)
13141 size_left
= buf
.size () - strlen (buf
.data ());
13143 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13146 if (ret
< 0 || ret
>= size_left
)
13147 error ("%s", err_msg
);
13150 putpkt (buf
.data ());
13151 remote_get_noisy_reply ();
13152 if (strcmp (rs
->buf
.data (), "OK"))
13153 error (_("Target does not support tracepoints."));
13155 /* do_single_steps (t); */
13156 for (auto action_it
= tdp_actions
.begin ();
13157 action_it
!= tdp_actions
.end (); action_it
++)
13159 QUIT
; /* Allow user to bail out with ^C. */
13161 bool has_more
= ((action_it
+ 1) != tdp_actions
.end ()
13162 || !stepping_actions
.empty ());
13164 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:-%x:%s:%s%c",
13165 b
->number
, addrbuf
, /* address */
13166 action_it
->c_str (),
13167 has_more
? '-' : 0);
13169 if (ret
< 0 || ret
>= buf
.size ())
13170 error ("%s", err_msg
);
13172 putpkt (buf
.data ());
13173 remote_get_noisy_reply ();
13174 if (strcmp (rs
->buf
.data (), "OK"))
13175 error (_("Error on target while setting tracepoints."));
13178 for (auto action_it
= stepping_actions
.begin ();
13179 action_it
!= stepping_actions
.end (); action_it
++)
13181 QUIT
; /* Allow user to bail out with ^C. */
13183 bool is_first
= action_it
== stepping_actions
.begin ();
13184 bool has_more
= (action_it
+ 1) != stepping_actions
.end ();
13186 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:-%x:%s:%s%s%s",
13187 b
->number
, addrbuf
, /* address */
13188 is_first
? "S" : "",
13189 action_it
->c_str (),
13190 has_more
? "-" : "");
13192 if (ret
< 0 || ret
>= buf
.size ())
13193 error ("%s", err_msg
);
13195 putpkt (buf
.data ());
13196 remote_get_noisy_reply ();
13197 if (strcmp (rs
->buf
.data (), "OK"))
13198 error (_("Error on target while setting tracepoints."));
13201 if (packet_support (PACKET_TracepointSource
) == PACKET_ENABLE
)
13203 if (b
->location
!= NULL
)
13205 ret
= snprintf (buf
.data (), buf
.size (), "QTDPsrc:");
13207 if (ret
< 0 || ret
>= buf
.size ())
13208 error ("%s", err_msg
);
13210 encode_source_string (b
->number
, loc
->address
, "at",
13211 event_location_to_string (b
->location
.get ()),
13212 buf
.data () + strlen (buf
.data ()),
13213 buf
.size () - strlen (buf
.data ()));
13214 putpkt (buf
.data ());
13215 remote_get_noisy_reply ();
13216 if (strcmp (rs
->buf
.data (), "OK"))
13217 warning (_("Target does not support source download."));
13219 if (b
->cond_string
)
13221 ret
= snprintf (buf
.data (), buf
.size (), "QTDPsrc:");
13223 if (ret
< 0 || ret
>= buf
.size ())
13224 error ("%s", err_msg
);
13226 encode_source_string (b
->number
, loc
->address
,
13227 "cond", b
->cond_string
,
13228 buf
.data () + strlen (buf
.data ()),
13229 buf
.size () - strlen (buf
.data ()));
13230 putpkt (buf
.data ());
13231 remote_get_noisy_reply ();
13232 if (strcmp (rs
->buf
.data (), "OK"))
13233 warning (_("Target does not support source download."));
13235 remote_download_command_source (b
->number
, loc
->address
,
13236 breakpoint_commands (b
));
13241 remote_target::can_download_tracepoint ()
13243 struct remote_state
*rs
= get_remote_state ();
13244 struct trace_status
*ts
;
13247 /* Don't try to install tracepoints until we've relocated our
13248 symbols, and fetched and merged the target's tracepoint list with
13250 if (rs
->starting_up
)
13253 ts
= current_trace_status ();
13254 status
= get_trace_status (ts
);
13256 if (status
== -1 || !ts
->running_known
|| !ts
->running
)
13259 /* If we are in a tracing experiment, but remote stub doesn't support
13260 installing tracepoint in trace, we have to return. */
13261 if (!remote_supports_install_in_trace ())
13269 remote_target::download_trace_state_variable (const trace_state_variable
&tsv
)
13271 struct remote_state
*rs
= get_remote_state ();
13274 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTDV:%x:%s:%x:",
13275 tsv
.number
, phex ((ULONGEST
) tsv
.initial_value
, 8),
13277 p
= rs
->buf
.data () + strlen (rs
->buf
.data ());
13278 if ((p
- rs
->buf
.data ()) + tsv
.name
.length () * 2
13279 >= get_remote_packet_size ())
13280 error (_("Trace state variable name too long for tsv definition packet"));
13281 p
+= 2 * bin2hex ((gdb_byte
*) (tsv
.name
.data ()), p
, tsv
.name
.length ());
13284 remote_get_noisy_reply ();
13285 if (rs
->buf
[0] == '\0')
13286 error (_("Target does not support this command."));
13287 if (strcmp (rs
->buf
.data (), "OK") != 0)
13288 error (_("Error on target while downloading trace state variable."));
13292 remote_target::enable_tracepoint (struct bp_location
*location
)
13294 struct remote_state
*rs
= get_remote_state ();
13296 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTEnable:%x:%s",
13297 location
->owner
->number
,
13298 phex (location
->address
, sizeof (CORE_ADDR
)));
13300 remote_get_noisy_reply ();
13301 if (rs
->buf
[0] == '\0')
13302 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
13303 if (strcmp (rs
->buf
.data (), "OK") != 0)
13304 error (_("Error on target while enabling tracepoint."));
13308 remote_target::disable_tracepoint (struct bp_location
*location
)
13310 struct remote_state
*rs
= get_remote_state ();
13312 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTDisable:%x:%s",
13313 location
->owner
->number
,
13314 phex (location
->address
, sizeof (CORE_ADDR
)));
13316 remote_get_noisy_reply ();
13317 if (rs
->buf
[0] == '\0')
13318 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
13319 if (strcmp (rs
->buf
.data (), "OK") != 0)
13320 error (_("Error on target while disabling tracepoint."));
13324 remote_target::trace_set_readonly_regions ()
13327 bfd_size_type size
;
13332 if (!current_program_space
->exec_bfd ())
13333 return; /* No information to give. */
13335 struct remote_state
*rs
= get_remote_state ();
13337 strcpy (rs
->buf
.data (), "QTro");
13338 offset
= strlen (rs
->buf
.data ());
13339 for (s
= current_program_space
->exec_bfd ()->sections
; s
; s
= s
->next
)
13341 char tmp1
[40], tmp2
[40];
13344 if ((s
->flags
& SEC_LOAD
) == 0 ||
13345 /* (s->flags & SEC_CODE) == 0 || */
13346 (s
->flags
& SEC_READONLY
) == 0)
13350 vma
= bfd_section_vma (s
);
13351 size
= bfd_section_size (s
);
13352 sprintf_vma (tmp1
, vma
);
13353 sprintf_vma (tmp2
, vma
+ size
);
13354 sec_length
= 1 + strlen (tmp1
) + 1 + strlen (tmp2
);
13355 if (offset
+ sec_length
+ 1 > rs
->buf
.size ())
13357 if (packet_support (PACKET_qXfer_traceframe_info
) != PACKET_ENABLE
)
13359 Too many sections for read-only sections definition packet."));
13362 xsnprintf (rs
->buf
.data () + offset
, rs
->buf
.size () - offset
, ":%s,%s",
13364 offset
+= sec_length
;
13369 getpkt (&rs
->buf
, 0);
13374 remote_target::trace_start ()
13376 struct remote_state
*rs
= get_remote_state ();
13378 putpkt ("QTStart");
13379 remote_get_noisy_reply ();
13380 if (rs
->buf
[0] == '\0')
13381 error (_("Target does not support this command."));
13382 if (strcmp (rs
->buf
.data (), "OK") != 0)
13383 error (_("Bogus reply from target: %s"), rs
->buf
.data ());
13387 remote_target::get_trace_status (struct trace_status
*ts
)
13389 /* Initialize it just to avoid a GCC false warning. */
13391 enum packet_result result
;
13392 struct remote_state
*rs
= get_remote_state ();
13394 if (packet_support (PACKET_qTStatus
) == PACKET_DISABLE
)
13397 /* FIXME we need to get register block size some other way. */
13398 trace_regblock_size
13399 = rs
->get_remote_arch_state (target_gdbarch ())->sizeof_g_packet
;
13401 putpkt ("qTStatus");
13405 p
= remote_get_noisy_reply ();
13407 catch (const gdb_exception_error
&ex
)
13409 if (ex
.error
!= TARGET_CLOSE_ERROR
)
13411 exception_fprintf (gdb_stderr
, ex
, "qTStatus: ");
13417 result
= packet_ok (p
, &remote_protocol_packets
[PACKET_qTStatus
]);
13419 /* If the remote target doesn't do tracing, flag it. */
13420 if (result
== PACKET_UNKNOWN
)
13423 /* We're working with a live target. */
13424 ts
->filename
= NULL
;
13427 error (_("Bogus trace status reply from target: %s"), rs
->buf
.data ());
13429 /* Function 'parse_trace_status' sets default value of each field of
13430 'ts' at first, so we don't have to do it here. */
13431 parse_trace_status (p
, ts
);
13433 return ts
->running
;
13437 remote_target::get_tracepoint_status (struct breakpoint
*bp
,
13438 struct uploaded_tp
*utp
)
13440 struct remote_state
*rs
= get_remote_state ();
13442 struct bp_location
*loc
;
13443 struct tracepoint
*tp
= (struct tracepoint
*) bp
;
13444 size_t size
= get_remote_packet_size ();
13449 tp
->traceframe_usage
= 0;
13450 for (loc
= tp
->loc
; loc
; loc
= loc
->next
)
13452 /* If the tracepoint was never downloaded, don't go asking for
13454 if (tp
->number_on_target
== 0)
13456 xsnprintf (rs
->buf
.data (), size
, "qTP:%x:%s", tp
->number_on_target
,
13457 phex_nz (loc
->address
, 0));
13459 reply
= remote_get_noisy_reply ();
13460 if (reply
&& *reply
)
13463 parse_tracepoint_status (reply
+ 1, bp
, utp
);
13469 utp
->hit_count
= 0;
13470 utp
->traceframe_usage
= 0;
13471 xsnprintf (rs
->buf
.data (), size
, "qTP:%x:%s", utp
->number
,
13472 phex_nz (utp
->addr
, 0));
13474 reply
= remote_get_noisy_reply ();
13475 if (reply
&& *reply
)
13478 parse_tracepoint_status (reply
+ 1, bp
, utp
);
13484 remote_target::trace_stop ()
13486 struct remote_state
*rs
= get_remote_state ();
13489 remote_get_noisy_reply ();
13490 if (rs
->buf
[0] == '\0')
13491 error (_("Target does not support this command."));
13492 if (strcmp (rs
->buf
.data (), "OK") != 0)
13493 error (_("Bogus reply from target: %s"), rs
->buf
.data ());
13497 remote_target::trace_find (enum trace_find_type type
, int num
,
13498 CORE_ADDR addr1
, CORE_ADDR addr2
,
13501 struct remote_state
*rs
= get_remote_state ();
13502 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
13504 int target_frameno
= -1, target_tracept
= -1;
13506 /* Lookups other than by absolute frame number depend on the current
13507 trace selected, so make sure it is correct on the remote end
13509 if (type
!= tfind_number
)
13510 set_remote_traceframe ();
13512 p
= rs
->buf
.data ();
13513 strcpy (p
, "QTFrame:");
13514 p
= strchr (p
, '\0');
13518 xsnprintf (p
, endbuf
- p
, "%x", num
);
13521 xsnprintf (p
, endbuf
- p
, "pc:%s", phex_nz (addr1
, 0));
13524 xsnprintf (p
, endbuf
- p
, "tdp:%x", num
);
13527 xsnprintf (p
, endbuf
- p
, "range:%s:%s", phex_nz (addr1
, 0),
13528 phex_nz (addr2
, 0));
13530 case tfind_outside
:
13531 xsnprintf (p
, endbuf
- p
, "outside:%s:%s", phex_nz (addr1
, 0),
13532 phex_nz (addr2
, 0));
13535 error (_("Unknown trace find type %d"), type
);
13539 reply
= remote_get_noisy_reply ();
13540 if (*reply
== '\0')
13541 error (_("Target does not support this command."));
13543 while (reply
&& *reply
)
13548 target_frameno
= (int) strtol (p
, &reply
, 16);
13550 error (_("Unable to parse trace frame number"));
13551 /* Don't update our remote traceframe number cache on failure
13552 to select a remote traceframe. */
13553 if (target_frameno
== -1)
13558 target_tracept
= (int) strtol (p
, &reply
, 16);
13560 error (_("Unable to parse tracepoint number"));
13562 case 'O': /* "OK"? */
13563 if (reply
[1] == 'K' && reply
[2] == '\0')
13566 error (_("Bogus reply from target: %s"), reply
);
13569 error (_("Bogus reply from target: %s"), reply
);
13572 *tpp
= target_tracept
;
13574 rs
->remote_traceframe_number
= target_frameno
;
13575 return target_frameno
;
13579 remote_target::get_trace_state_variable_value (int tsvnum
, LONGEST
*val
)
13581 struct remote_state
*rs
= get_remote_state ();
13585 set_remote_traceframe ();
13587 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qTV:%x", tsvnum
);
13589 reply
= remote_get_noisy_reply ();
13590 if (reply
&& *reply
)
13594 unpack_varlen_hex (reply
+ 1, &uval
);
13595 *val
= (LONGEST
) uval
;
13603 remote_target::save_trace_data (const char *filename
)
13605 struct remote_state
*rs
= get_remote_state ();
13608 p
= rs
->buf
.data ();
13609 strcpy (p
, "QTSave:");
13611 if ((p
- rs
->buf
.data ()) + strlen (filename
) * 2
13612 >= get_remote_packet_size ())
13613 error (_("Remote file name too long for trace save packet"));
13614 p
+= 2 * bin2hex ((gdb_byte
*) filename
, p
, strlen (filename
));
13617 reply
= remote_get_noisy_reply ();
13618 if (*reply
== '\0')
13619 error (_("Target does not support this command."));
13620 if (strcmp (reply
, "OK") != 0)
13621 error (_("Bogus reply from target: %s"), reply
);
13625 /* This is basically a memory transfer, but needs to be its own packet
13626 because we don't know how the target actually organizes its trace
13627 memory, plus we want to be able to ask for as much as possible, but
13628 not be unhappy if we don't get as much as we ask for. */
13631 remote_target::get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
)
13633 struct remote_state
*rs
= get_remote_state ();
13638 p
= rs
->buf
.data ();
13639 strcpy (p
, "qTBuffer:");
13641 p
+= hexnumstr (p
, offset
);
13643 p
+= hexnumstr (p
, len
);
13647 reply
= remote_get_noisy_reply ();
13648 if (reply
&& *reply
)
13650 /* 'l' by itself means we're at the end of the buffer and
13651 there is nothing more to get. */
13655 /* Convert the reply into binary. Limit the number of bytes to
13656 convert according to our passed-in buffer size, rather than
13657 what was returned in the packet; if the target is
13658 unexpectedly generous and gives us a bigger reply than we
13659 asked for, we don't want to crash. */
13660 rslt
= hex2bin (reply
, buf
, len
);
13664 /* Something went wrong, flag as an error. */
13669 remote_target::set_disconnected_tracing (int val
)
13671 struct remote_state
*rs
= get_remote_state ();
13673 if (packet_support (PACKET_DisconnectedTracing_feature
) == PACKET_ENABLE
)
13677 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
13678 "QTDisconnected:%x", val
);
13680 reply
= remote_get_noisy_reply ();
13681 if (*reply
== '\0')
13682 error (_("Target does not support this command."));
13683 if (strcmp (reply
, "OK") != 0)
13684 error (_("Bogus reply from target: %s"), reply
);
13687 warning (_("Target does not support disconnected tracing."));
13691 remote_target::core_of_thread (ptid_t ptid
)
13693 thread_info
*info
= find_thread_ptid (this, ptid
);
13695 if (info
!= NULL
&& info
->priv
!= NULL
)
13696 return get_remote_thread_info (info
)->core
;
13702 remote_target::set_circular_trace_buffer (int val
)
13704 struct remote_state
*rs
= get_remote_state ();
13707 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
13708 "QTBuffer:circular:%x", val
);
13710 reply
= remote_get_noisy_reply ();
13711 if (*reply
== '\0')
13712 error (_("Target does not support this command."));
13713 if (strcmp (reply
, "OK") != 0)
13714 error (_("Bogus reply from target: %s"), reply
);
13718 remote_target::traceframe_info ()
13720 gdb::optional
<gdb::char_vector
> text
13721 = target_read_stralloc (current_top_target (), TARGET_OBJECT_TRACEFRAME_INFO
,
13724 return parse_traceframe_info (text
->data ());
13729 /* Handle the qTMinFTPILen packet. Returns the minimum length of
13730 instruction on which a fast tracepoint may be placed. Returns -1
13731 if the packet is not supported, and 0 if the minimum instruction
13732 length is unknown. */
13735 remote_target::get_min_fast_tracepoint_insn_len ()
13737 struct remote_state
*rs
= get_remote_state ();
13740 /* If we're not debugging a process yet, the IPA can't be
13742 if (!target_has_execution ())
13745 /* Make sure the remote is pointing at the right process. */
13746 set_general_process ();
13748 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qTMinFTPILen");
13750 reply
= remote_get_noisy_reply ();
13751 if (*reply
== '\0')
13755 ULONGEST min_insn_len
;
13757 unpack_varlen_hex (reply
, &min_insn_len
);
13759 return (int) min_insn_len
;
13764 remote_target::set_trace_buffer_size (LONGEST val
)
13766 if (packet_support (PACKET_QTBuffer_size
) != PACKET_DISABLE
)
13768 struct remote_state
*rs
= get_remote_state ();
13769 char *buf
= rs
->buf
.data ();
13770 char *endbuf
= buf
+ get_remote_packet_size ();
13771 enum packet_result result
;
13773 gdb_assert (val
>= 0 || val
== -1);
13774 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTBuffer:size:");
13775 /* Send -1 as literal "-1" to avoid host size dependency. */
13779 buf
+= hexnumstr (buf
, (ULONGEST
) -val
);
13782 buf
+= hexnumstr (buf
, (ULONGEST
) val
);
13785 remote_get_noisy_reply ();
13786 result
= packet_ok (rs
->buf
,
13787 &remote_protocol_packets
[PACKET_QTBuffer_size
]);
13789 if (result
!= PACKET_OK
)
13790 warning (_("Bogus reply from target: %s"), rs
->buf
.data ());
13795 remote_target::set_trace_notes (const char *user
, const char *notes
,
13796 const char *stop_notes
)
13798 struct remote_state
*rs
= get_remote_state ();
13800 char *buf
= rs
->buf
.data ();
13801 char *endbuf
= buf
+ get_remote_packet_size ();
13804 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTNotes:");
13807 buf
+= xsnprintf (buf
, endbuf
- buf
, "user:");
13808 nbytes
= bin2hex ((gdb_byte
*) user
, buf
, strlen (user
));
13814 buf
+= xsnprintf (buf
, endbuf
- buf
, "notes:");
13815 nbytes
= bin2hex ((gdb_byte
*) notes
, buf
, strlen (notes
));
13821 buf
+= xsnprintf (buf
, endbuf
- buf
, "tstop:");
13822 nbytes
= bin2hex ((gdb_byte
*) stop_notes
, buf
, strlen (stop_notes
));
13826 /* Ensure the buffer is terminated. */
13830 reply
= remote_get_noisy_reply ();
13831 if (*reply
== '\0')
13834 if (strcmp (reply
, "OK") != 0)
13835 error (_("Bogus reply from target: %s"), reply
);
13841 remote_target::use_agent (bool use
)
13843 if (packet_support (PACKET_QAgent
) != PACKET_DISABLE
)
13845 struct remote_state
*rs
= get_remote_state ();
13847 /* If the stub supports QAgent. */
13848 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QAgent:%d", use
);
13850 getpkt (&rs
->buf
, 0);
13852 if (strcmp (rs
->buf
.data (), "OK") == 0)
13863 remote_target::can_use_agent ()
13865 return (packet_support (PACKET_QAgent
) != PACKET_DISABLE
);
13868 struct btrace_target_info
13870 /* The ptid of the traced thread. */
13873 /* The obtained branch trace configuration. */
13874 struct btrace_config conf
;
13877 /* Reset our idea of our target's btrace configuration. */
13880 remote_btrace_reset (remote_state
*rs
)
13882 memset (&rs
->btrace_config
, 0, sizeof (rs
->btrace_config
));
13885 /* Synchronize the configuration with the target. */
13888 remote_target::btrace_sync_conf (const btrace_config
*conf
)
13890 struct packet_config
*packet
;
13891 struct remote_state
*rs
;
13892 char *buf
, *pos
, *endbuf
;
13894 rs
= get_remote_state ();
13895 buf
= rs
->buf
.data ();
13896 endbuf
= buf
+ get_remote_packet_size ();
13898 packet
= &remote_protocol_packets
[PACKET_Qbtrace_conf_bts_size
];
13899 if (packet_config_support (packet
) == PACKET_ENABLE
13900 && conf
->bts
.size
!= rs
->btrace_config
.bts
.size
)
13903 pos
+= xsnprintf (pos
, endbuf
- pos
, "%s=0x%x", packet
->name
,
13907 getpkt (&rs
->buf
, 0);
13909 if (packet_ok (buf
, packet
) == PACKET_ERROR
)
13911 if (buf
[0] == 'E' && buf
[1] == '.')
13912 error (_("Failed to configure the BTS buffer size: %s"), buf
+ 2);
13914 error (_("Failed to configure the BTS buffer size."));
13917 rs
->btrace_config
.bts
.size
= conf
->bts
.size
;
13920 packet
= &remote_protocol_packets
[PACKET_Qbtrace_conf_pt_size
];
13921 if (packet_config_support (packet
) == PACKET_ENABLE
13922 && conf
->pt
.size
!= rs
->btrace_config
.pt
.size
)
13925 pos
+= xsnprintf (pos
, endbuf
- pos
, "%s=0x%x", packet
->name
,
13929 getpkt (&rs
->buf
, 0);
13931 if (packet_ok (buf
, packet
) == PACKET_ERROR
)
13933 if (buf
[0] == 'E' && buf
[1] == '.')
13934 error (_("Failed to configure the trace buffer size: %s"), buf
+ 2);
13936 error (_("Failed to configure the trace buffer size."));
13939 rs
->btrace_config
.pt
.size
= conf
->pt
.size
;
13943 /* Read the current thread's btrace configuration from the target and
13944 store it into CONF. */
13947 btrace_read_config (struct btrace_config
*conf
)
13949 gdb::optional
<gdb::char_vector
> xml
13950 = target_read_stralloc (current_top_target (), TARGET_OBJECT_BTRACE_CONF
, "");
13952 parse_xml_btrace_conf (conf
, xml
->data ());
13955 /* Maybe reopen target btrace. */
13958 remote_target::remote_btrace_maybe_reopen ()
13960 struct remote_state
*rs
= get_remote_state ();
13961 int btrace_target_pushed
= 0;
13962 #if !defined (HAVE_LIBIPT)
13966 /* Don't bother walking the entirety of the remote thread list when
13967 we know the feature isn't supported by the remote. */
13968 if (packet_support (PACKET_qXfer_btrace_conf
) != PACKET_ENABLE
)
13971 scoped_restore_current_thread restore_thread
;
13973 for (thread_info
*tp
: all_non_exited_threads (this))
13975 set_general_thread (tp
->ptid
);
13977 memset (&rs
->btrace_config
, 0x00, sizeof (struct btrace_config
));
13978 btrace_read_config (&rs
->btrace_config
);
13980 if (rs
->btrace_config
.format
== BTRACE_FORMAT_NONE
)
13983 #if !defined (HAVE_LIBIPT)
13984 if (rs
->btrace_config
.format
== BTRACE_FORMAT_PT
)
13989 warning (_("Target is recording using Intel Processor Trace "
13990 "but support was disabled at compile time."));
13995 #endif /* !defined (HAVE_LIBIPT) */
13997 /* Push target, once, but before anything else happens. This way our
13998 changes to the threads will be cleaned up by unpushing the target
13999 in case btrace_read_config () throws. */
14000 if (!btrace_target_pushed
)
14002 btrace_target_pushed
= 1;
14003 record_btrace_push_target ();
14004 printf_filtered (_("Target is recording using %s.\n"),
14005 btrace_format_string (rs
->btrace_config
.format
));
14008 tp
->btrace
.target
= XCNEW (struct btrace_target_info
);
14009 tp
->btrace
.target
->ptid
= tp
->ptid
;
14010 tp
->btrace
.target
->conf
= rs
->btrace_config
;
14014 /* Enable branch tracing. */
14016 struct btrace_target_info
*
14017 remote_target::enable_btrace (ptid_t ptid
, const struct btrace_config
*conf
)
14019 struct btrace_target_info
*tinfo
= NULL
;
14020 struct packet_config
*packet
= NULL
;
14021 struct remote_state
*rs
= get_remote_state ();
14022 char *buf
= rs
->buf
.data ();
14023 char *endbuf
= buf
+ get_remote_packet_size ();
14025 switch (conf
->format
)
14027 case BTRACE_FORMAT_BTS
:
14028 packet
= &remote_protocol_packets
[PACKET_Qbtrace_bts
];
14031 case BTRACE_FORMAT_PT
:
14032 packet
= &remote_protocol_packets
[PACKET_Qbtrace_pt
];
14036 if (packet
== NULL
|| packet_config_support (packet
) != PACKET_ENABLE
)
14037 error (_("Target does not support branch tracing."));
14039 btrace_sync_conf (conf
);
14041 set_general_thread (ptid
);
14043 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
14045 getpkt (&rs
->buf
, 0);
14047 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
14049 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
14050 error (_("Could not enable branch tracing for %s: %s"),
14051 target_pid_to_str (ptid
).c_str (), &rs
->buf
[2]);
14053 error (_("Could not enable branch tracing for %s."),
14054 target_pid_to_str (ptid
).c_str ());
14057 tinfo
= XCNEW (struct btrace_target_info
);
14058 tinfo
->ptid
= ptid
;
14060 /* If we fail to read the configuration, we lose some information, but the
14061 tracing itself is not impacted. */
14064 btrace_read_config (&tinfo
->conf
);
14066 catch (const gdb_exception_error
&err
)
14068 if (err
.message
!= NULL
)
14069 warning ("%s", err
.what ());
14075 /* Disable branch tracing. */
14078 remote_target::disable_btrace (struct btrace_target_info
*tinfo
)
14080 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_Qbtrace_off
];
14081 struct remote_state
*rs
= get_remote_state ();
14082 char *buf
= rs
->buf
.data ();
14083 char *endbuf
= buf
+ get_remote_packet_size ();
14085 if (packet_config_support (packet
) != PACKET_ENABLE
)
14086 error (_("Target does not support branch tracing."));
14088 set_general_thread (tinfo
->ptid
);
14090 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
14092 getpkt (&rs
->buf
, 0);
14094 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
14096 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
14097 error (_("Could not disable branch tracing for %s: %s"),
14098 target_pid_to_str (tinfo
->ptid
).c_str (), &rs
->buf
[2]);
14100 error (_("Could not disable branch tracing for %s."),
14101 target_pid_to_str (tinfo
->ptid
).c_str ());
14107 /* Teardown branch tracing. */
14110 remote_target::teardown_btrace (struct btrace_target_info
*tinfo
)
14112 /* We must not talk to the target during teardown. */
14116 /* Read the branch trace. */
14119 remote_target::read_btrace (struct btrace_data
*btrace
,
14120 struct btrace_target_info
*tinfo
,
14121 enum btrace_read_type type
)
14123 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_qXfer_btrace
];
14126 if (packet_config_support (packet
) != PACKET_ENABLE
)
14127 error (_("Target does not support branch tracing."));
14129 #if !defined(HAVE_LIBEXPAT)
14130 error (_("Cannot process branch tracing result. XML parsing not supported."));
14135 case BTRACE_READ_ALL
:
14138 case BTRACE_READ_NEW
:
14141 case BTRACE_READ_DELTA
:
14145 internal_error (__FILE__
, __LINE__
,
14146 _("Bad branch tracing read type: %u."),
14147 (unsigned int) type
);
14150 gdb::optional
<gdb::char_vector
> xml
14151 = target_read_stralloc (current_top_target (), TARGET_OBJECT_BTRACE
, annex
);
14153 return BTRACE_ERR_UNKNOWN
;
14155 parse_xml_btrace (btrace
, xml
->data ());
14157 return BTRACE_ERR_NONE
;
14160 const struct btrace_config
*
14161 remote_target::btrace_conf (const struct btrace_target_info
*tinfo
)
14163 return &tinfo
->conf
;
14167 remote_target::augmented_libraries_svr4_read ()
14169 return (packet_support (PACKET_augmented_libraries_svr4_read_feature
)
14173 /* Implementation of to_load. */
14176 remote_target::load (const char *name
, int from_tty
)
14178 generic_load (name
, from_tty
);
14181 /* Accepts an integer PID; returns a string representing a file that
14182 can be opened on the remote side to get the symbols for the child
14183 process. Returns NULL if the operation is not supported. */
14186 remote_target::pid_to_exec_file (int pid
)
14188 static gdb::optional
<gdb::char_vector
> filename
;
14189 char *annex
= NULL
;
14191 if (packet_support (PACKET_qXfer_exec_file
) != PACKET_ENABLE
)
14194 inferior
*inf
= find_inferior_pid (this, pid
);
14196 internal_error (__FILE__
, __LINE__
,
14197 _("not currently attached to process %d"), pid
);
14199 if (!inf
->fake_pid_p
)
14201 const int annex_size
= 9;
14203 annex
= (char *) alloca (annex_size
);
14204 xsnprintf (annex
, annex_size
, "%x", pid
);
14207 filename
= target_read_stralloc (current_top_target (),
14208 TARGET_OBJECT_EXEC_FILE
, annex
);
14210 return filename
? filename
->data () : nullptr;
14213 /* Implement the to_can_do_single_step target_ops method. */
14216 remote_target::can_do_single_step ()
14218 /* We can only tell whether target supports single step or not by
14219 supported s and S vCont actions if the stub supports vContSupported
14220 feature. If the stub doesn't support vContSupported feature,
14221 we have conservatively to think target doesn't supports single
14223 if (packet_support (PACKET_vContSupported
) == PACKET_ENABLE
)
14225 struct remote_state
*rs
= get_remote_state ();
14227 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
14228 remote_vcont_probe ();
14230 return rs
->supports_vCont
.s
&& rs
->supports_vCont
.S
;
14236 /* Implementation of the to_execution_direction method for the remote
14239 enum exec_direction_kind
14240 remote_target::execution_direction ()
14242 struct remote_state
*rs
= get_remote_state ();
14244 return rs
->last_resume_exec_dir
;
14247 /* Return pointer to the thread_info struct which corresponds to
14248 THREAD_HANDLE (having length HANDLE_LEN). */
14251 remote_target::thread_handle_to_thread_info (const gdb_byte
*thread_handle
,
14255 for (thread_info
*tp
: all_non_exited_threads (this))
14257 remote_thread_info
*priv
= get_remote_thread_info (tp
);
14259 if (tp
->inf
== inf
&& priv
!= NULL
)
14261 if (handle_len
!= priv
->thread_handle
.size ())
14262 error (_("Thread handle size mismatch: %d vs %zu (from remote)"),
14263 handle_len
, priv
->thread_handle
.size ());
14264 if (memcmp (thread_handle
, priv
->thread_handle
.data (),
14274 remote_target::thread_info_to_thread_handle (struct thread_info
*tp
)
14276 remote_thread_info
*priv
= get_remote_thread_info (tp
);
14277 return priv
->thread_handle
;
14281 remote_target::can_async_p ()
14283 struct remote_state
*rs
= get_remote_state ();
14285 /* We don't go async if the user has explicitly prevented it with the
14286 "maint set target-async" command. */
14287 if (!target_async_permitted
)
14290 /* We're async whenever the serial device is. */
14291 return serial_can_async_p (rs
->remote_desc
);
14295 remote_target::is_async_p ()
14297 struct remote_state
*rs
= get_remote_state ();
14299 if (!target_async_permitted
)
14300 /* We only enable async when the user specifically asks for it. */
14303 /* We're async whenever the serial device is. */
14304 return serial_is_async_p (rs
->remote_desc
);
14307 /* Pass the SERIAL event on and up to the client. One day this code
14308 will be able to delay notifying the client of an event until the
14309 point where an entire packet has been received. */
14311 static serial_event_ftype remote_async_serial_handler
;
14314 remote_async_serial_handler (struct serial
*scb
, void *context
)
14316 /* Don't propogate error information up to the client. Instead let
14317 the client find out about the error by querying the target. */
14318 inferior_event_handler (INF_REG_EVENT
);
14322 remote_async_inferior_event_handler (gdb_client_data data
)
14324 inferior_event_handler (INF_REG_EVENT
);
14326 remote_target
*remote
= (remote_target
*) data
;
14327 remote_state
*rs
= remote
->get_remote_state ();
14329 /* inferior_event_handler may have consumed an event pending on the
14330 infrun side without calling target_wait on the REMOTE target, or
14331 may have pulled an event out of a different target. Keep trying
14332 for this remote target as long it still has either pending events
14333 or unacknowledged notifications. */
14335 if (rs
->notif_state
->pending_event
[notif_client_stop
.id
] != NULL
14336 || !rs
->stop_reply_queue
.empty ())
14337 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
14341 remote_target::async_wait_fd ()
14343 struct remote_state
*rs
= get_remote_state ();
14344 return rs
->remote_desc
->fd
;
14348 remote_target::async (int enable
)
14350 struct remote_state
*rs
= get_remote_state ();
14354 serial_async (rs
->remote_desc
, remote_async_serial_handler
, rs
);
14356 /* If there are pending events in the stop reply queue tell the
14357 event loop to process them. */
14358 if (!rs
->stop_reply_queue
.empty ())
14359 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
14360 /* For simplicity, below we clear the pending events token
14361 without remembering whether it is marked, so here we always
14362 mark it. If there's actually no pending notification to
14363 process, this ends up being a no-op (other than a spurious
14364 event-loop wakeup). */
14365 if (target_is_non_stop_p ())
14366 mark_async_event_handler (rs
->notif_state
->get_pending_events_token
);
14370 serial_async (rs
->remote_desc
, NULL
, NULL
);
14371 /* If the core is disabling async, it doesn't want to be
14372 disturbed with target events. Clear all async event sources
14374 clear_async_event_handler (rs
->remote_async_inferior_event_token
);
14375 if (target_is_non_stop_p ())
14376 clear_async_event_handler (rs
->notif_state
->get_pending_events_token
);
14380 /* Implementation of the to_thread_events method. */
14383 remote_target::thread_events (int enable
)
14385 struct remote_state
*rs
= get_remote_state ();
14386 size_t size
= get_remote_packet_size ();
14388 if (packet_support (PACKET_QThreadEvents
) == PACKET_DISABLE
)
14391 xsnprintf (rs
->buf
.data (), size
, "QThreadEvents:%x", enable
? 1 : 0);
14393 getpkt (&rs
->buf
, 0);
14395 switch (packet_ok (rs
->buf
,
14396 &remote_protocol_packets
[PACKET_QThreadEvents
]))
14399 if (strcmp (rs
->buf
.data (), "OK") != 0)
14400 error (_("Remote refused setting thread events: %s"), rs
->buf
.data ());
14403 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
14405 case PACKET_UNKNOWN
:
14411 show_remote_cmd (const char *args
, int from_tty
)
14413 /* We can't just use cmd_show_list here, because we want to skip
14414 the redundant "show remote Z-packet" and the legacy aliases. */
14415 struct cmd_list_element
*list
= remote_show_cmdlist
;
14416 struct ui_out
*uiout
= current_uiout
;
14418 ui_out_emit_tuple
tuple_emitter (uiout
, "showlist");
14419 for (; list
!= NULL
; list
= list
->next
)
14420 if (strcmp (list
->name
, "Z-packet") == 0)
14422 else if (list
->type
== not_set_cmd
)
14423 /* Alias commands are exactly like the original, except they
14424 don't have the normal type. */
14428 ui_out_emit_tuple
option_emitter (uiout
, "option");
14430 uiout
->field_string ("name", list
->name
);
14431 uiout
->text (": ");
14432 if (list
->type
== show_cmd
)
14433 do_show_command (NULL
, from_tty
, list
);
14435 cmd_func (list
, NULL
, from_tty
);
14440 /* Function to be called whenever a new objfile (shlib) is detected. */
14442 remote_new_objfile (struct objfile
*objfile
)
14444 remote_target
*remote
= get_current_remote_target ();
14446 if (remote
!= NULL
) /* Have a remote connection. */
14447 remote
->remote_check_symbols ();
14450 /* Pull all the tracepoints defined on the target and create local
14451 data structures representing them. We don't want to create real
14452 tracepoints yet, we don't want to mess up the user's existing
14456 remote_target::upload_tracepoints (struct uploaded_tp
**utpp
)
14458 struct remote_state
*rs
= get_remote_state ();
14461 /* Ask for a first packet of tracepoint definition. */
14463 getpkt (&rs
->buf
, 0);
14464 p
= rs
->buf
.data ();
14465 while (*p
&& *p
!= 'l')
14467 parse_tracepoint_definition (p
, utpp
);
14468 /* Ask for another packet of tracepoint definition. */
14470 getpkt (&rs
->buf
, 0);
14471 p
= rs
->buf
.data ();
14477 remote_target::upload_trace_state_variables (struct uploaded_tsv
**utsvp
)
14479 struct remote_state
*rs
= get_remote_state ();
14482 /* Ask for a first packet of variable definition. */
14484 getpkt (&rs
->buf
, 0);
14485 p
= rs
->buf
.data ();
14486 while (*p
&& *p
!= 'l')
14488 parse_tsv_definition (p
, utsvp
);
14489 /* Ask for another packet of variable definition. */
14491 getpkt (&rs
->buf
, 0);
14492 p
= rs
->buf
.data ();
14497 /* The "set/show range-stepping" show hook. */
14500 show_range_stepping (struct ui_file
*file
, int from_tty
,
14501 struct cmd_list_element
*c
,
14504 fprintf_filtered (file
,
14505 _("Debugger's willingness to use range stepping "
14506 "is %s.\n"), value
);
14509 /* Return true if the vCont;r action is supported by the remote
14513 remote_target::vcont_r_supported ()
14515 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
14516 remote_vcont_probe ();
14518 return (packet_support (PACKET_vCont
) == PACKET_ENABLE
14519 && get_remote_state ()->supports_vCont
.r
);
14522 /* The "set/show range-stepping" set hook. */
14525 set_range_stepping (const char *ignore_args
, int from_tty
,
14526 struct cmd_list_element
*c
)
14528 /* When enabling, check whether range stepping is actually supported
14529 by the target, and warn if not. */
14530 if (use_range_stepping
)
14532 remote_target
*remote
= get_current_remote_target ();
14534 || !remote
->vcont_r_supported ())
14535 warning (_("Range stepping is not supported by the current target"));
14539 void _initialize_remote ();
14541 _initialize_remote ()
14543 struct cmd_list_element
*cmd
;
14544 const char *cmd_name
;
14546 /* architecture specific data */
14547 remote_g_packet_data_handle
=
14548 gdbarch_data_register_pre_init (remote_g_packet_data_init
);
14550 add_target (remote_target_info
, remote_target::open
);
14551 add_target (extended_remote_target_info
, extended_remote_target::open
);
14553 /* Hook into new objfile notification. */
14554 gdb::observers::new_objfile
.attach (remote_new_objfile
);
14557 init_remote_threadtests ();
14560 /* set/show remote ... */
14562 add_basic_prefix_cmd ("remote", class_maintenance
, _("\
14563 Remote protocol specific variables.\n\
14564 Configure various remote-protocol specific variables such as\n\
14565 the packets being used."),
14566 &remote_set_cmdlist
, "set remote ",
14567 0 /* allow-unknown */, &setlist
);
14568 add_prefix_cmd ("remote", class_maintenance
, show_remote_cmd
, _("\
14569 Remote protocol specific variables.\n\
14570 Configure various remote-protocol specific variables such as\n\
14571 the packets being used."),
14572 &remote_show_cmdlist
, "show remote ",
14573 0 /* allow-unknown */, &showlist
);
14575 add_cmd ("compare-sections", class_obscure
, compare_sections_command
, _("\
14576 Compare section data on target to the exec file.\n\
14577 Argument is a single section name (default: all loaded sections).\n\
14578 To compare only read-only loaded sections, specify the -r option."),
14581 add_cmd ("packet", class_maintenance
, packet_command
, _("\
14582 Send an arbitrary packet to a remote target.\n\
14583 maintenance packet TEXT\n\
14584 If GDB is talking to an inferior via the GDB serial protocol, then\n\
14585 this command sends the string TEXT to the inferior, and displays the\n\
14586 response packet. GDB supplies the initial `$' character, and the\n\
14587 terminating `#' character and checksum."),
14590 add_setshow_boolean_cmd ("remotebreak", no_class
, &remote_break
, _("\
14591 Set whether to send break if interrupted."), _("\
14592 Show whether to send break if interrupted."), _("\
14593 If set, a break, instead of a cntrl-c, is sent to the remote target."),
14594 set_remotebreak
, show_remotebreak
,
14595 &setlist
, &showlist
);
14596 cmd_name
= "remotebreak";
14597 cmd
= lookup_cmd (&cmd_name
, setlist
, "", NULL
, -1, 1);
14598 deprecate_cmd (cmd
, "set remote interrupt-sequence");
14599 cmd_name
= "remotebreak"; /* needed because lookup_cmd updates the pointer */
14600 cmd
= lookup_cmd (&cmd_name
, showlist
, "", NULL
, -1, 1);
14601 deprecate_cmd (cmd
, "show remote interrupt-sequence");
14603 add_setshow_enum_cmd ("interrupt-sequence", class_support
,
14604 interrupt_sequence_modes
, &interrupt_sequence_mode
,
14606 Set interrupt sequence to remote target."), _("\
14607 Show interrupt sequence to remote target."), _("\
14608 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
14609 NULL
, show_interrupt_sequence
,
14610 &remote_set_cmdlist
,
14611 &remote_show_cmdlist
);
14613 add_setshow_boolean_cmd ("interrupt-on-connect", class_support
,
14614 &interrupt_on_connect
, _("\
14615 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _("\
14616 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _("\
14617 If set, interrupt sequence is sent to remote target."),
14619 &remote_set_cmdlist
, &remote_show_cmdlist
);
14621 /* Install commands for configuring memory read/write packets. */
14623 add_cmd ("remotewritesize", no_class
, set_memory_write_packet_size
, _("\
14624 Set the maximum number of bytes per memory write packet (deprecated)."),
14626 add_cmd ("remotewritesize", no_class
, show_memory_write_packet_size
, _("\
14627 Show the maximum number of bytes per memory write packet (deprecated)."),
14629 add_cmd ("memory-write-packet-size", no_class
,
14630 set_memory_write_packet_size
, _("\
14631 Set the maximum number of bytes per memory-write packet.\n\
14632 Specify the number of bytes in a packet or 0 (zero) for the\n\
14633 default packet size. The actual limit is further reduced\n\
14634 dependent on the target. Specify ``fixed'' to disable the\n\
14635 further restriction and ``limit'' to enable that restriction."),
14636 &remote_set_cmdlist
);
14637 add_cmd ("memory-read-packet-size", no_class
,
14638 set_memory_read_packet_size
, _("\
14639 Set the maximum number of bytes per memory-read packet.\n\
14640 Specify the number of bytes in a packet or 0 (zero) for the\n\
14641 default packet size. The actual limit is further reduced\n\
14642 dependent on the target. Specify ``fixed'' to disable the\n\
14643 further restriction and ``limit'' to enable that restriction."),
14644 &remote_set_cmdlist
);
14645 add_cmd ("memory-write-packet-size", no_class
,
14646 show_memory_write_packet_size
,
14647 _("Show the maximum number of bytes per memory-write packet."),
14648 &remote_show_cmdlist
);
14649 add_cmd ("memory-read-packet-size", no_class
,
14650 show_memory_read_packet_size
,
14651 _("Show the maximum number of bytes per memory-read packet."),
14652 &remote_show_cmdlist
);
14654 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-limit", no_class
,
14655 &remote_hw_watchpoint_limit
, _("\
14656 Set the maximum number of target hardware watchpoints."), _("\
14657 Show the maximum number of target hardware watchpoints."), _("\
14658 Specify \"unlimited\" for unlimited hardware watchpoints."),
14659 NULL
, show_hardware_watchpoint_limit
,
14660 &remote_set_cmdlist
,
14661 &remote_show_cmdlist
);
14662 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-length-limit",
14664 &remote_hw_watchpoint_length_limit
, _("\
14665 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
14666 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
14667 Specify \"unlimited\" to allow watchpoints of unlimited size."),
14668 NULL
, show_hardware_watchpoint_length_limit
,
14669 &remote_set_cmdlist
, &remote_show_cmdlist
);
14670 add_setshow_zuinteger_unlimited_cmd ("hardware-breakpoint-limit", no_class
,
14671 &remote_hw_breakpoint_limit
, _("\
14672 Set the maximum number of target hardware breakpoints."), _("\
14673 Show the maximum number of target hardware breakpoints."), _("\
14674 Specify \"unlimited\" for unlimited hardware breakpoints."),
14675 NULL
, show_hardware_breakpoint_limit
,
14676 &remote_set_cmdlist
, &remote_show_cmdlist
);
14678 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure
,
14679 &remote_address_size
, _("\
14680 Set the maximum size of the address (in bits) in a memory packet."), _("\
14681 Show the maximum size of the address (in bits) in a memory packet."), NULL
,
14683 NULL
, /* FIXME: i18n: */
14684 &setlist
, &showlist
);
14686 init_all_packet_configs ();
14688 add_packet_config_cmd (&remote_protocol_packets
[PACKET_X
],
14689 "X", "binary-download", 1);
14691 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCont
],
14692 "vCont", "verbose-resume", 0);
14694 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QPassSignals
],
14695 "QPassSignals", "pass-signals", 0);
14697 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QCatchSyscalls
],
14698 "QCatchSyscalls", "catch-syscalls", 0);
14700 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QProgramSignals
],
14701 "QProgramSignals", "program-signals", 0);
14703 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QSetWorkingDir
],
14704 "QSetWorkingDir", "set-working-dir", 0);
14706 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartupWithShell
],
14707 "QStartupWithShell", "startup-with-shell", 0);
14709 add_packet_config_cmd (&remote_protocol_packets
14710 [PACKET_QEnvironmentHexEncoded
],
14711 "QEnvironmentHexEncoded", "environment-hex-encoded",
14714 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QEnvironmentReset
],
14715 "QEnvironmentReset", "environment-reset",
14718 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QEnvironmentUnset
],
14719 "QEnvironmentUnset", "environment-unset",
14722 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSymbol
],
14723 "qSymbol", "symbol-lookup", 0);
14725 add_packet_config_cmd (&remote_protocol_packets
[PACKET_P
],
14726 "P", "set-register", 1);
14728 add_packet_config_cmd (&remote_protocol_packets
[PACKET_p
],
14729 "p", "fetch-register", 1);
14731 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
],
14732 "Z0", "software-breakpoint", 0);
14734 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z1
],
14735 "Z1", "hardware-breakpoint", 0);
14737 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z2
],
14738 "Z2", "write-watchpoint", 0);
14740 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z3
],
14741 "Z3", "read-watchpoint", 0);
14743 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z4
],
14744 "Z4", "access-watchpoint", 0);
14746 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_auxv
],
14747 "qXfer:auxv:read", "read-aux-vector", 0);
14749 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_exec_file
],
14750 "qXfer:exec-file:read", "pid-to-exec-file", 0);
14752 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_features
],
14753 "qXfer:features:read", "target-features", 0);
14755 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries
],
14756 "qXfer:libraries:read", "library-info", 0);
14758 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries_svr4
],
14759 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
14761 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_memory_map
],
14762 "qXfer:memory-map:read", "memory-map", 0);
14764 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_osdata
],
14765 "qXfer:osdata:read", "osdata", 0);
14767 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_threads
],
14768 "qXfer:threads:read", "threads", 0);
14770 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_read
],
14771 "qXfer:siginfo:read", "read-siginfo-object", 0);
14773 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_write
],
14774 "qXfer:siginfo:write", "write-siginfo-object", 0);
14776 add_packet_config_cmd
14777 (&remote_protocol_packets
[PACKET_qXfer_traceframe_info
],
14778 "qXfer:traceframe-info:read", "traceframe-info", 0);
14780 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_uib
],
14781 "qXfer:uib:read", "unwind-info-block", 0);
14783 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTLSAddr
],
14784 "qGetTLSAddr", "get-thread-local-storage-address",
14787 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTIBAddr
],
14788 "qGetTIBAddr", "get-thread-information-block-address",
14791 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bc
],
14792 "bc", "reverse-continue", 0);
14794 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bs
],
14795 "bs", "reverse-step", 0);
14797 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSupported
],
14798 "qSupported", "supported-packets", 0);
14800 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSearch_memory
],
14801 "qSearch:memory", "search-memory", 0);
14803 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qTStatus
],
14804 "qTStatus", "trace-status", 0);
14806 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_setfs
],
14807 "vFile:setfs", "hostio-setfs", 0);
14809 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_open
],
14810 "vFile:open", "hostio-open", 0);
14812 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pread
],
14813 "vFile:pread", "hostio-pread", 0);
14815 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pwrite
],
14816 "vFile:pwrite", "hostio-pwrite", 0);
14818 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_close
],
14819 "vFile:close", "hostio-close", 0);
14821 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_unlink
],
14822 "vFile:unlink", "hostio-unlink", 0);
14824 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_readlink
],
14825 "vFile:readlink", "hostio-readlink", 0);
14827 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_fstat
],
14828 "vFile:fstat", "hostio-fstat", 0);
14830 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vAttach
],
14831 "vAttach", "attach", 0);
14833 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vRun
],
14836 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartNoAckMode
],
14837 "QStartNoAckMode", "noack", 0);
14839 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vKill
],
14840 "vKill", "kill", 0);
14842 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qAttached
],
14843 "qAttached", "query-attached", 0);
14845 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalTracepoints
],
14846 "ConditionalTracepoints",
14847 "conditional-tracepoints", 0);
14849 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalBreakpoints
],
14850 "ConditionalBreakpoints",
14851 "conditional-breakpoints", 0);
14853 add_packet_config_cmd (&remote_protocol_packets
[PACKET_BreakpointCommands
],
14854 "BreakpointCommands",
14855 "breakpoint-commands", 0);
14857 add_packet_config_cmd (&remote_protocol_packets
[PACKET_FastTracepoints
],
14858 "FastTracepoints", "fast-tracepoints", 0);
14860 add_packet_config_cmd (&remote_protocol_packets
[PACKET_TracepointSource
],
14861 "TracepointSource", "TracepointSource", 0);
14863 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAllow
],
14864 "QAllow", "allow", 0);
14866 add_packet_config_cmd (&remote_protocol_packets
[PACKET_StaticTracepoints
],
14867 "StaticTracepoints", "static-tracepoints", 0);
14869 add_packet_config_cmd (&remote_protocol_packets
[PACKET_InstallInTrace
],
14870 "InstallInTrace", "install-in-trace", 0);
14872 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_statictrace_read
],
14873 "qXfer:statictrace:read", "read-sdata-object", 0);
14875 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_fdpic
],
14876 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
14878 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QDisableRandomization
],
14879 "QDisableRandomization", "disable-randomization", 0);
14881 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAgent
],
14882 "QAgent", "agent", 0);
14884 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QTBuffer_size
],
14885 "QTBuffer:size", "trace-buffer-size", 0);
14887 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_off
],
14888 "Qbtrace:off", "disable-btrace", 0);
14890 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_bts
],
14891 "Qbtrace:bts", "enable-btrace-bts", 0);
14893 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_pt
],
14894 "Qbtrace:pt", "enable-btrace-pt", 0);
14896 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace
],
14897 "qXfer:btrace", "read-btrace", 0);
14899 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace_conf
],
14900 "qXfer:btrace-conf", "read-btrace-conf", 0);
14902 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_conf_bts_size
],
14903 "Qbtrace-conf:bts:size", "btrace-conf-bts-size", 0);
14905 add_packet_config_cmd (&remote_protocol_packets
[PACKET_multiprocess_feature
],
14906 "multiprocess-feature", "multiprocess-feature", 0);
14908 add_packet_config_cmd (&remote_protocol_packets
[PACKET_swbreak_feature
],
14909 "swbreak-feature", "swbreak-feature", 0);
14911 add_packet_config_cmd (&remote_protocol_packets
[PACKET_hwbreak_feature
],
14912 "hwbreak-feature", "hwbreak-feature", 0);
14914 add_packet_config_cmd (&remote_protocol_packets
[PACKET_fork_event_feature
],
14915 "fork-event-feature", "fork-event-feature", 0);
14917 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vfork_event_feature
],
14918 "vfork-event-feature", "vfork-event-feature", 0);
14920 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_conf_pt_size
],
14921 "Qbtrace-conf:pt:size", "btrace-conf-pt-size", 0);
14923 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vContSupported
],
14924 "vContSupported", "verbose-resume-supported", 0);
14926 add_packet_config_cmd (&remote_protocol_packets
[PACKET_exec_event_feature
],
14927 "exec-event-feature", "exec-event-feature", 0);
14929 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCtrlC
],
14930 "vCtrlC", "ctrl-c", 0);
14932 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QThreadEvents
],
14933 "QThreadEvents", "thread-events", 0);
14935 add_packet_config_cmd (&remote_protocol_packets
[PACKET_no_resumed
],
14936 "N stop reply", "no-resumed-stop-reply", 0);
14938 /* Assert that we've registered "set remote foo-packet" commands
14939 for all packet configs. */
14943 for (i
= 0; i
< PACKET_MAX
; i
++)
14945 /* Ideally all configs would have a command associated. Some
14946 still don't though. */
14951 case PACKET_QNonStop
:
14952 case PACKET_EnableDisableTracepoints_feature
:
14953 case PACKET_tracenz_feature
:
14954 case PACKET_DisconnectedTracing_feature
:
14955 case PACKET_augmented_libraries_svr4_read_feature
:
14957 /* Additions to this list need to be well justified:
14958 pre-existing packets are OK; new packets are not. */
14966 /* This catches both forgetting to add a config command, and
14967 forgetting to remove a packet from the exception list. */
14968 gdb_assert (excepted
== (remote_protocol_packets
[i
].name
== NULL
));
14972 /* Keep the old ``set remote Z-packet ...'' working. Each individual
14973 Z sub-packet has its own set and show commands, but users may
14974 have sets to this variable in their .gdbinit files (or in their
14976 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure
,
14977 &remote_Z_packet_detect
, _("\
14978 Set use of remote protocol `Z' packets."), _("\
14979 Show use of remote protocol `Z' packets."), _("\
14980 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
14982 set_remote_protocol_Z_packet_cmd
,
14983 show_remote_protocol_Z_packet_cmd
,
14984 /* FIXME: i18n: Use of remote protocol
14985 `Z' packets is %s. */
14986 &remote_set_cmdlist
, &remote_show_cmdlist
);
14988 add_basic_prefix_cmd ("remote", class_files
, _("\
14989 Manipulate files on the remote system.\n\
14990 Transfer files to and from the remote target system."),
14991 &remote_cmdlist
, "remote ",
14992 0 /* allow-unknown */, &cmdlist
);
14994 add_cmd ("put", class_files
, remote_put_command
,
14995 _("Copy a local file to the remote system."),
14998 add_cmd ("get", class_files
, remote_get_command
,
14999 _("Copy a remote file to the local system."),
15002 add_cmd ("delete", class_files
, remote_delete_command
,
15003 _("Delete a remote file."),
15006 add_setshow_string_noescape_cmd ("exec-file", class_files
,
15007 &remote_exec_file_var
, _("\
15008 Set the remote pathname for \"run\"."), _("\
15009 Show the remote pathname for \"run\"."), NULL
,
15010 set_remote_exec_file
,
15011 show_remote_exec_file
,
15012 &remote_set_cmdlist
,
15013 &remote_show_cmdlist
);
15015 add_setshow_boolean_cmd ("range-stepping", class_run
,
15016 &use_range_stepping
, _("\
15017 Enable or disable range stepping."), _("\
15018 Show whether target-assisted range stepping is enabled."), _("\
15019 If on, and the target supports it, when stepping a source line, GDB\n\
15020 tells the target to step the corresponding range of addresses itself instead\n\
15021 of issuing multiple single-steps. This speeds up source level\n\
15022 stepping. If off, GDB always issues single-steps, even if range\n\
15023 stepping is supported by the target. The default is on."),
15024 set_range_stepping
,
15025 show_range_stepping
,
15029 add_setshow_zinteger_cmd ("watchdog", class_maintenance
, &watchdog
, _("\
15030 Set watchdog timer."), _("\
15031 Show watchdog timer."), _("\
15032 When non-zero, this timeout is used instead of waiting forever for a target\n\
15033 to finish a low-level step or continue operation. If the specified amount\n\
15034 of time passes without a response from the target, an error occurs."),
15037 &setlist
, &showlist
);
15039 add_setshow_zuinteger_unlimited_cmd ("remote-packet-max-chars", no_class
,
15040 &remote_packet_max_chars
, _("\
15041 Set the maximum number of characters to display for each remote packet."), _("\
15042 Show the maximum number of characters to display for each remote packet."), _("\
15043 Specify \"unlimited\" to display all the characters."),
15044 NULL
, show_remote_packet_max_chars
,
15045 &setdebuglist
, &showdebuglist
);
15047 /* Eventually initialize fileio. See fileio.c */
15048 initialize_remote_fileio (&remote_set_cmdlist
, &remote_show_cmdlist
);