1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2020 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"
59 #include "gdbcore.h" /* for exec_bfd */
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"
79 #include <unordered_map>
80 #include "async-event.h"
82 /* The remote target. */
84 static const char remote_doc
[] = N_("\
85 Use a remote computer via a serial line, using a gdb-specific protocol.\n\
86 Specify the serial device it is connected to\n\
87 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).");
89 #define OPAQUETHREADBYTES 8
91 /* a 64 bit opaque identifier */
92 typedef unsigned char threadref
[OPAQUETHREADBYTES
];
94 struct gdb_ext_thread_info
;
95 struct threads_listing_context
;
96 typedef int (*rmt_thread_action
) (threadref
*ref
, void *context
);
97 struct protocol_feature
;
101 typedef std::unique_ptr
<stop_reply
> stop_reply_up
;
103 /* Generic configuration support for packets the stub optionally
104 supports. Allows the user to specify the use of the packet as well
105 as allowing GDB to auto-detect support in the remote stub. */
109 PACKET_SUPPORT_UNKNOWN
= 0,
114 /* Analyze a packet's return value and update the packet config
124 struct threads_listing_context
;
126 /* Stub vCont actions support.
128 Each field is a boolean flag indicating whether the stub reports
129 support for the corresponding action. */
131 struct vCont_action_support
146 /* About this many threadids fit in a packet. */
148 #define MAXTHREADLISTRESULTS 32
150 /* Data for the vFile:pread readahead cache. */
152 struct readahead_cache
154 /* Invalidate the readahead cache. */
157 /* Invalidate the readahead cache if it is holding data for FD. */
158 void invalidate_fd (int fd
);
160 /* Serve pread from the readahead cache. Returns number of bytes
161 read, or 0 if the request can't be served from the cache. */
162 int pread (int fd
, gdb_byte
*read_buf
, size_t len
, ULONGEST offset
);
164 /* The file descriptor for the file that is being cached. -1 if the
168 /* The offset into the file that the cache buffer corresponds
172 /* The buffer holding the cache contents. */
173 gdb_byte
*buf
= nullptr;
174 /* The buffer's size. We try to read as much as fits into a packet
178 /* Cache hit and miss counters. */
179 ULONGEST hit_count
= 0;
180 ULONGEST miss_count
= 0;
183 /* Description of the remote protocol for a given architecture. */
187 long offset
; /* Offset into G packet. */
188 long regnum
; /* GDB's internal register number. */
189 LONGEST pnum
; /* Remote protocol register number. */
190 int in_g_packet
; /* Always part of G packet. */
191 /* long size in bytes; == register_size (target_gdbarch (), regnum);
193 /* char *name; == gdbarch_register_name (target_gdbarch (), regnum);
197 struct remote_arch_state
199 explicit remote_arch_state (struct gdbarch
*gdbarch
);
201 /* Description of the remote protocol registers. */
202 long sizeof_g_packet
;
204 /* Description of the remote protocol registers indexed by REGNUM
205 (making an array gdbarch_num_regs in size). */
206 std::unique_ptr
<packet_reg
[]> regs
;
208 /* This is the size (in chars) of the first response to the ``g''
209 packet. It is used as a heuristic when determining the maximum
210 size of memory-read and memory-write packets. A target will
211 typically only reserve a buffer large enough to hold the ``g''
212 packet. The size does not include packet overhead (headers and
214 long actual_register_packet_size
;
216 /* This is the maximum size (in chars) of a non read/write packet.
217 It is also used as a cap on the size of read/write packets. */
218 long remote_packet_size
;
221 /* Description of the remote protocol state for the currently
222 connected target. This is per-target state, and independent of the
223 selected architecture. */
232 /* Get the remote arch state for GDBARCH. */
233 struct remote_arch_state
*get_remote_arch_state (struct gdbarch
*gdbarch
);
237 /* A buffer to use for incoming packets, and its current size. The
238 buffer is grown dynamically for larger incoming packets.
239 Outgoing packets may also be constructed in this buffer.
240 The size of the buffer is always at least REMOTE_PACKET_SIZE;
241 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
243 gdb::char_vector buf
;
245 /* True if we're going through initial connection setup (finding out
246 about the remote side's threads, relocating symbols, etc.). */
247 bool starting_up
= false;
249 /* If we negotiated packet size explicitly (and thus can bypass
250 heuristics for the largest packet size that will not overflow
251 a buffer in the stub), this will be set to that packet size.
252 Otherwise zero, meaning to use the guessed size. */
253 long explicit_packet_size
= 0;
255 /* remote_wait is normally called when the target is running and
256 waits for a stop reply packet. But sometimes we need to call it
257 when the target is already stopped. We can send a "?" packet
258 and have remote_wait read the response. Or, if we already have
259 the response, we can stash it in BUF and tell remote_wait to
260 skip calling getpkt. This flag is set when BUF contains a
261 stop reply packet and the target is not waiting. */
262 int cached_wait_status
= 0;
264 /* True, if in no ack mode. That is, neither GDB nor the stub will
265 expect acks from each other. The connection is assumed to be
267 bool noack_mode
= false;
269 /* True if we're connected in extended remote mode. */
270 bool extended
= false;
272 /* True if we resumed the target and we're waiting for the target to
273 stop. In the mean time, we can't start another command/query.
274 The remote server wouldn't be ready to process it, so we'd
275 timeout waiting for a reply that would never come and eventually
276 we'd close the connection. This can happen in asynchronous mode
277 because we allow GDB commands while the target is running. */
278 bool waiting_for_stop_reply
= false;
280 /* The status of the stub support for the various vCont actions. */
281 vCont_action_support supports_vCont
;
282 /* Whether vCont support was probed already. This is a workaround
283 until packet_support is per-connection. */
284 bool supports_vCont_probed
;
286 /* True if the user has pressed Ctrl-C, but the target hasn't
287 responded to that. */
288 bool ctrlc_pending_p
= false;
290 /* True if we saw a Ctrl-C while reading or writing from/to the
291 remote descriptor. At that point it is not safe to send a remote
292 interrupt packet, so we instead remember we saw the Ctrl-C and
293 process it once we're done with sending/receiving the current
294 packet, which should be shortly. If however that takes too long,
295 and the user presses Ctrl-C again, we offer to disconnect. */
296 bool got_ctrlc_during_io
= false;
298 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
299 remote_open knows that we don't have a file open when the program
301 struct serial
*remote_desc
= nullptr;
303 /* These are the threads which we last sent to the remote system. The
304 TID member will be -1 for all or -2 for not sent yet. */
305 ptid_t general_thread
= null_ptid
;
306 ptid_t continue_thread
= null_ptid
;
308 /* This is the traceframe which we last selected on the remote system.
309 It will be -1 if no traceframe is selected. */
310 int remote_traceframe_number
= -1;
312 char *last_pass_packet
= nullptr;
314 /* The last QProgramSignals packet sent to the target. We bypass
315 sending a new program signals list down to the target if the new
316 packet is exactly the same as the last we sent. IOW, we only let
317 the target know about program signals list changes. */
318 char *last_program_signals_packet
= nullptr;
320 gdb_signal last_sent_signal
= GDB_SIGNAL_0
;
322 bool last_sent_step
= false;
324 /* The execution direction of the last resume we got. */
325 exec_direction_kind last_resume_exec_dir
= EXEC_FORWARD
;
327 char *finished_object
= nullptr;
328 char *finished_annex
= nullptr;
329 ULONGEST finished_offset
= 0;
331 /* Should we try the 'ThreadInfo' query packet?
333 This variable (NOT available to the user: auto-detect only!)
334 determines whether GDB will use the new, simpler "ThreadInfo"
335 query or the older, more complex syntax for thread queries.
336 This is an auto-detect variable (set to true at each connect,
337 and set to false when the target fails to recognize it). */
338 bool use_threadinfo_query
= false;
339 bool use_threadextra_query
= false;
341 threadref echo_nextthread
{};
342 threadref nextthread
{};
343 threadref resultthreadlist
[MAXTHREADLISTRESULTS
] {};
345 /* The state of remote notification. */
346 struct remote_notif_state
*notif_state
= nullptr;
348 /* The branch trace configuration. */
349 struct btrace_config btrace_config
{};
351 /* The argument to the last "vFile:setfs:" packet we sent, used
352 to avoid sending repeated unnecessary "vFile:setfs:" packets.
353 Initialized to -1 to indicate that no "vFile:setfs:" packet
354 has yet been sent. */
357 /* A readahead cache for vFile:pread. Often, reading a binary
358 involves a sequence of small reads. E.g., when parsing an ELF
359 file. A readahead cache helps mostly the case of remote
360 debugging on a connection with higher latency, due to the
361 request/reply nature of the RSP. We only cache data for a single
362 file descriptor at a time. */
363 struct readahead_cache readahead_cache
;
365 /* The list of already fetched and acknowledged stop events. This
366 queue is used for notification Stop, and other notifications
367 don't need queue for their events, because the notification
368 events of Stop can't be consumed immediately, so that events
369 should be queued first, and be consumed by remote_wait_{ns,as}
370 one per time. Other notifications can consume their events
371 immediately, so queue is not needed for them. */
372 std::vector
<stop_reply_up
> stop_reply_queue
;
374 /* Asynchronous signal handle registered as event loop source for
375 when we have pending events ready to be passed to the core. */
376 struct async_event_handler
*remote_async_inferior_event_token
= nullptr;
378 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
379 ``forever'' still use the normal timeout mechanism. This is
380 currently used by the ASYNC code to guarentee that target reads
381 during the initial connect always time-out. Once getpkt has been
382 modified to return a timeout indication and, in turn
383 remote_wait()/wait_for_inferior() have gained a timeout parameter
385 int wait_forever_enabled_p
= 1;
388 /* Mapping of remote protocol data for each gdbarch. Usually there
389 is only one entry here, though we may see more with stubs that
390 support multi-process. */
391 std::unordered_map
<struct gdbarch
*, remote_arch_state
>
395 static const target_info remote_target_info
= {
397 N_("Remote serial target in gdb-specific protocol"),
401 class remote_target
: public process_stratum_target
404 remote_target () = default;
405 ~remote_target () override
;
407 const target_info
&info () const override
408 { return remote_target_info
; }
410 const char *connection_string () override
;
412 thread_control_capabilities
get_thread_control_capabilities () override
413 { return tc_schedlock
; }
415 /* Open a remote connection. */
416 static void open (const char *, int);
418 void close () override
;
420 void detach (inferior
*, int) override
;
421 void disconnect (const char *, int) override
;
423 void commit_resume () override
;
424 void resume (ptid_t
, int, enum gdb_signal
) override
;
425 ptid_t
wait (ptid_t
, struct target_waitstatus
*, target_wait_flags
) override
;
427 void fetch_registers (struct regcache
*, int) override
;
428 void store_registers (struct regcache
*, int) override
;
429 void prepare_to_store (struct regcache
*) override
;
431 void files_info () override
;
433 int insert_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
435 int remove_breakpoint (struct gdbarch
*, struct bp_target_info
*,
436 enum remove_bp_reason
) override
;
439 bool stopped_by_sw_breakpoint () override
;
440 bool supports_stopped_by_sw_breakpoint () override
;
442 bool stopped_by_hw_breakpoint () override
;
444 bool supports_stopped_by_hw_breakpoint () override
;
446 bool stopped_by_watchpoint () override
;
448 bool stopped_data_address (CORE_ADDR
*) override
;
450 bool watchpoint_addr_within_range (CORE_ADDR
, CORE_ADDR
, int) override
;
452 int can_use_hw_breakpoint (enum bptype
, int, int) override
;
454 int insert_hw_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
456 int remove_hw_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
458 int region_ok_for_hw_watchpoint (CORE_ADDR
, int) override
;
460 int insert_watchpoint (CORE_ADDR
, int, enum target_hw_bp_type
,
461 struct expression
*) override
;
463 int remove_watchpoint (CORE_ADDR
, int, enum target_hw_bp_type
,
464 struct expression
*) override
;
466 void kill () override
;
468 void load (const char *, int) override
;
470 void mourn_inferior () override
;
472 void pass_signals (gdb::array_view
<const unsigned char>) override
;
474 int set_syscall_catchpoint (int, bool, int,
475 gdb::array_view
<const int>) override
;
477 void program_signals (gdb::array_view
<const unsigned char>) override
;
479 bool thread_alive (ptid_t ptid
) override
;
481 const char *thread_name (struct thread_info
*) override
;
483 void update_thread_list () override
;
485 std::string
pid_to_str (ptid_t
) override
;
487 const char *extra_thread_info (struct thread_info
*) override
;
489 ptid_t
get_ada_task_ptid (long lwp
, long thread
) override
;
491 thread_info
*thread_handle_to_thread_info (const gdb_byte
*thread_handle
,
493 inferior
*inf
) override
;
495 gdb::byte_vector
thread_info_to_thread_handle (struct thread_info
*tp
)
498 void stop (ptid_t
) override
;
500 void interrupt () override
;
502 void pass_ctrlc () override
;
504 enum target_xfer_status
xfer_partial (enum target_object object
,
507 const gdb_byte
*writebuf
,
508 ULONGEST offset
, ULONGEST len
,
509 ULONGEST
*xfered_len
) override
;
511 ULONGEST
get_memory_xfer_limit () override
;
513 void rcmd (const char *command
, struct ui_file
*output
) override
;
515 char *pid_to_exec_file (int pid
) override
;
517 void log_command (const char *cmd
) override
519 serial_log_command (this, cmd
);
522 CORE_ADDR
get_thread_local_address (ptid_t ptid
,
523 CORE_ADDR load_module_addr
,
524 CORE_ADDR offset
) override
;
526 bool can_execute_reverse () override
;
528 std::vector
<mem_region
> memory_map () override
;
530 void flash_erase (ULONGEST address
, LONGEST length
) override
;
532 void flash_done () override
;
534 const struct target_desc
*read_description () override
;
536 int search_memory (CORE_ADDR start_addr
, ULONGEST search_space_len
,
537 const gdb_byte
*pattern
, ULONGEST pattern_len
,
538 CORE_ADDR
*found_addrp
) override
;
540 bool can_async_p () override
;
542 bool is_async_p () override
;
544 void async (int) override
;
546 int async_wait_fd () override
;
548 void thread_events (int) override
;
550 int can_do_single_step () override
;
552 void terminal_inferior () override
;
554 void terminal_ours () override
;
556 bool supports_non_stop () override
;
558 bool supports_multi_process () override
;
560 bool supports_disable_randomization () override
;
562 bool filesystem_is_local () override
;
565 int fileio_open (struct inferior
*inf
, const char *filename
,
566 int flags
, int mode
, int warn_if_slow
,
567 int *target_errno
) override
;
569 int fileio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
570 ULONGEST offset
, int *target_errno
) override
;
572 int fileio_pread (int fd
, gdb_byte
*read_buf
, int len
,
573 ULONGEST offset
, int *target_errno
) override
;
575 int fileio_fstat (int fd
, struct stat
*sb
, int *target_errno
) override
;
577 int fileio_close (int fd
, int *target_errno
) override
;
579 int fileio_unlink (struct inferior
*inf
,
580 const char *filename
,
581 int *target_errno
) override
;
583 gdb::optional
<std::string
>
584 fileio_readlink (struct inferior
*inf
,
585 const char *filename
,
586 int *target_errno
) override
;
588 bool supports_enable_disable_tracepoint () override
;
590 bool supports_string_tracing () override
;
592 bool supports_evaluation_of_breakpoint_conditions () override
;
594 bool can_run_breakpoint_commands () override
;
596 void trace_init () override
;
598 void download_tracepoint (struct bp_location
*location
) override
;
600 bool can_download_tracepoint () override
;
602 void download_trace_state_variable (const trace_state_variable
&tsv
) override
;
604 void enable_tracepoint (struct bp_location
*location
) override
;
606 void disable_tracepoint (struct bp_location
*location
) override
;
608 void trace_set_readonly_regions () override
;
610 void trace_start () override
;
612 int get_trace_status (struct trace_status
*ts
) override
;
614 void get_tracepoint_status (struct breakpoint
*tp
, struct uploaded_tp
*utp
)
617 void trace_stop () override
;
619 int trace_find (enum trace_find_type type
, int num
,
620 CORE_ADDR addr1
, CORE_ADDR addr2
, int *tpp
) override
;
622 bool get_trace_state_variable_value (int tsv
, LONGEST
*val
) override
;
624 int save_trace_data (const char *filename
) override
;
626 int upload_tracepoints (struct uploaded_tp
**utpp
) override
;
628 int upload_trace_state_variables (struct uploaded_tsv
**utsvp
) override
;
630 LONGEST
get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
) override
;
632 int get_min_fast_tracepoint_insn_len () override
;
634 void set_disconnected_tracing (int val
) override
;
636 void set_circular_trace_buffer (int val
) override
;
638 void set_trace_buffer_size (LONGEST val
) override
;
640 bool set_trace_notes (const char *user
, const char *notes
,
641 const char *stopnotes
) override
;
643 int core_of_thread (ptid_t ptid
) override
;
645 int verify_memory (const gdb_byte
*data
,
646 CORE_ADDR memaddr
, ULONGEST size
) override
;
649 bool get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
) override
;
651 void set_permissions () override
;
653 bool static_tracepoint_marker_at (CORE_ADDR
,
654 struct static_tracepoint_marker
*marker
)
657 std::vector
<static_tracepoint_marker
>
658 static_tracepoint_markers_by_strid (const char *id
) override
;
660 traceframe_info_up
traceframe_info () override
;
662 bool use_agent (bool use
) override
;
663 bool can_use_agent () override
;
665 struct btrace_target_info
*enable_btrace (ptid_t ptid
,
666 const struct btrace_config
*conf
) override
;
668 void disable_btrace (struct btrace_target_info
*tinfo
) override
;
670 void teardown_btrace (struct btrace_target_info
*tinfo
) override
;
672 enum btrace_error
read_btrace (struct btrace_data
*data
,
673 struct btrace_target_info
*btinfo
,
674 enum btrace_read_type type
) override
;
676 const struct btrace_config
*btrace_conf (const struct btrace_target_info
*) override
;
677 bool augmented_libraries_svr4_read () override
;
678 bool follow_fork (bool, bool) override
;
679 void follow_exec (struct inferior
*, const char *) override
;
680 int insert_fork_catchpoint (int) override
;
681 int remove_fork_catchpoint (int) override
;
682 int insert_vfork_catchpoint (int) override
;
683 int remove_vfork_catchpoint (int) override
;
684 int insert_exec_catchpoint (int) override
;
685 int remove_exec_catchpoint (int) override
;
686 enum exec_direction_kind
execution_direction () override
;
688 public: /* Remote specific methods. */
690 void remote_download_command_source (int num
, ULONGEST addr
,
691 struct command_line
*cmds
);
693 void remote_file_put (const char *local_file
, const char *remote_file
,
695 void remote_file_get (const char *remote_file
, const char *local_file
,
697 void remote_file_delete (const char *remote_file
, int from_tty
);
699 int remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
700 ULONGEST offset
, int *remote_errno
);
701 int remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
702 ULONGEST offset
, int *remote_errno
);
703 int remote_hostio_pread_vFile (int fd
, gdb_byte
*read_buf
, int len
,
704 ULONGEST offset
, int *remote_errno
);
706 int remote_hostio_send_command (int command_bytes
, int which_packet
,
707 int *remote_errno
, char **attachment
,
708 int *attachment_len
);
709 int remote_hostio_set_filesystem (struct inferior
*inf
,
711 /* We should get rid of this and use fileio_open directly. */
712 int remote_hostio_open (struct inferior
*inf
, const char *filename
,
713 int flags
, int mode
, int warn_if_slow
,
715 int remote_hostio_close (int fd
, int *remote_errno
);
717 int remote_hostio_unlink (inferior
*inf
, const char *filename
,
720 struct remote_state
*get_remote_state ();
722 long get_remote_packet_size (void);
723 long get_memory_packet_size (struct memory_packet_config
*config
);
725 long get_memory_write_packet_size ();
726 long get_memory_read_packet_size ();
728 char *append_pending_thread_resumptions (char *p
, char *endp
,
730 static void open_1 (const char *name
, int from_tty
, int extended_p
);
731 void start_remote (int from_tty
, int extended_p
);
732 void remote_detach_1 (struct inferior
*inf
, int from_tty
);
734 char *append_resumption (char *p
, char *endp
,
735 ptid_t ptid
, int step
, gdb_signal siggnal
);
736 int remote_resume_with_vcont (ptid_t ptid
, int step
,
739 void add_current_inferior_and_thread (char *wait_status
);
741 ptid_t
wait_ns (ptid_t ptid
, struct target_waitstatus
*status
,
742 target_wait_flags options
);
743 ptid_t
wait_as (ptid_t ptid
, target_waitstatus
*status
,
744 target_wait_flags options
);
746 ptid_t
process_stop_reply (struct stop_reply
*stop_reply
,
747 target_waitstatus
*status
);
749 void remote_notice_new_inferior (ptid_t currthread
, int executing
);
751 void process_initial_stop_replies (int from_tty
);
753 thread_info
*remote_add_thread (ptid_t ptid
, bool running
, bool executing
);
755 void btrace_sync_conf (const btrace_config
*conf
);
757 void remote_btrace_maybe_reopen ();
759 void remove_new_fork_children (threads_listing_context
*context
);
760 void kill_new_fork_children (int pid
);
761 void discard_pending_stop_replies (struct inferior
*inf
);
762 int stop_reply_queue_length ();
764 void check_pending_events_prevent_wildcard_vcont
765 (int *may_global_wildcard_vcont
);
767 void discard_pending_stop_replies_in_queue ();
768 struct stop_reply
*remote_notif_remove_queued_reply (ptid_t ptid
);
769 struct stop_reply
*queued_stop_reply (ptid_t ptid
);
770 int peek_stop_reply (ptid_t ptid
);
771 void remote_parse_stop_reply (const char *buf
, stop_reply
*event
);
773 void remote_stop_ns (ptid_t ptid
);
774 void remote_interrupt_as ();
775 void remote_interrupt_ns ();
777 char *remote_get_noisy_reply ();
778 int remote_query_attached (int pid
);
779 inferior
*remote_add_inferior (bool fake_pid_p
, int pid
, int attached
,
782 ptid_t
remote_current_thread (ptid_t oldpid
);
783 ptid_t
get_current_thread (char *wait_status
);
785 void set_thread (ptid_t ptid
, int gen
);
786 void set_general_thread (ptid_t ptid
);
787 void set_continue_thread (ptid_t ptid
);
788 void set_general_process ();
790 char *write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
);
792 int remote_unpack_thread_info_response (char *pkt
, threadref
*expectedref
,
793 gdb_ext_thread_info
*info
);
794 int remote_get_threadinfo (threadref
*threadid
, int fieldset
,
795 gdb_ext_thread_info
*info
);
797 int parse_threadlist_response (char *pkt
, int result_limit
,
798 threadref
*original_echo
,
799 threadref
*resultlist
,
801 int remote_get_threadlist (int startflag
, threadref
*nextthread
,
802 int result_limit
, int *done
, int *result_count
,
803 threadref
*threadlist
);
805 int remote_threadlist_iterator (rmt_thread_action stepfunction
,
806 void *context
, int looplimit
);
808 int remote_get_threads_with_ql (threads_listing_context
*context
);
809 int remote_get_threads_with_qxfer (threads_listing_context
*context
);
810 int remote_get_threads_with_qthreadinfo (threads_listing_context
*context
);
812 void extended_remote_restart ();
816 void remote_check_symbols ();
818 void remote_supported_packet (const struct protocol_feature
*feature
,
819 enum packet_support support
,
820 const char *argument
);
822 void remote_query_supported ();
824 void remote_packet_size (const protocol_feature
*feature
,
825 packet_support support
, const char *value
);
827 void remote_serial_quit_handler ();
829 void remote_detach_pid (int pid
);
831 void remote_vcont_probe ();
833 void remote_resume_with_hc (ptid_t ptid
, int step
,
836 void send_interrupt_sequence ();
837 void interrupt_query ();
839 void remote_notif_get_pending_events (notif_client
*nc
);
841 int fetch_register_using_p (struct regcache
*regcache
,
843 int send_g_packet ();
844 void process_g_packet (struct regcache
*regcache
);
845 void fetch_registers_using_g (struct regcache
*regcache
);
846 int store_register_using_P (const struct regcache
*regcache
,
848 void store_registers_using_G (const struct regcache
*regcache
);
850 void set_remote_traceframe ();
852 void check_binary_download (CORE_ADDR addr
);
854 target_xfer_status
remote_write_bytes_aux (const char *header
,
856 const gdb_byte
*myaddr
,
859 ULONGEST
*xfered_len_units
,
863 target_xfer_status
remote_write_bytes (CORE_ADDR memaddr
,
864 const gdb_byte
*myaddr
, ULONGEST len
,
865 int unit_size
, ULONGEST
*xfered_len
);
867 target_xfer_status
remote_read_bytes_1 (CORE_ADDR memaddr
, gdb_byte
*myaddr
,
869 int unit_size
, ULONGEST
*xfered_len_units
);
871 target_xfer_status
remote_xfer_live_readonly_partial (gdb_byte
*readbuf
,
875 ULONGEST
*xfered_len
);
877 target_xfer_status
remote_read_bytes (CORE_ADDR memaddr
,
878 gdb_byte
*myaddr
, ULONGEST len
,
880 ULONGEST
*xfered_len
);
882 packet_result
remote_send_printf (const char *format
, ...)
883 ATTRIBUTE_PRINTF (2, 3);
885 target_xfer_status
remote_flash_write (ULONGEST address
,
886 ULONGEST length
, ULONGEST
*xfered_len
,
887 const gdb_byte
*data
);
889 int readchar (int timeout
);
891 void remote_serial_write (const char *str
, int len
);
893 int putpkt (const char *buf
);
894 int putpkt_binary (const char *buf
, int cnt
);
896 int putpkt (const gdb::char_vector
&buf
)
898 return putpkt (buf
.data ());
902 long read_frame (gdb::char_vector
*buf_p
);
903 void getpkt (gdb::char_vector
*buf
, int forever
);
904 int getpkt_or_notif_sane_1 (gdb::char_vector
*buf
, int forever
,
905 int expecting_notif
, int *is_notif
);
906 int getpkt_sane (gdb::char_vector
*buf
, int forever
);
907 int getpkt_or_notif_sane (gdb::char_vector
*buf
, int forever
,
909 int remote_vkill (int pid
);
910 void remote_kill_k ();
912 void extended_remote_disable_randomization (int val
);
913 int extended_remote_run (const std::string
&args
);
915 void send_environment_packet (const char *action
,
919 void extended_remote_environment_support ();
920 void extended_remote_set_inferior_cwd ();
922 target_xfer_status
remote_write_qxfer (const char *object_name
,
924 const gdb_byte
*writebuf
,
925 ULONGEST offset
, LONGEST len
,
926 ULONGEST
*xfered_len
,
927 struct packet_config
*packet
);
929 target_xfer_status
remote_read_qxfer (const char *object_name
,
931 gdb_byte
*readbuf
, ULONGEST offset
,
933 ULONGEST
*xfered_len
,
934 struct packet_config
*packet
);
936 void push_stop_reply (struct stop_reply
*new_event
);
938 bool vcont_r_supported ();
940 void packet_command (const char *args
, int from_tty
);
942 private: /* data fields */
944 /* The remote state. Don't reference this directly. Use the
945 get_remote_state method instead. */
946 remote_state m_remote_state
;
949 static const target_info extended_remote_target_info
= {
951 N_("Extended remote serial target in gdb-specific protocol"),
955 /* Set up the extended remote target by extending the standard remote
956 target and adding to it. */
958 class extended_remote_target final
: public remote_target
961 const target_info
&info () const override
962 { return extended_remote_target_info
; }
964 /* Open an extended-remote connection. */
965 static void open (const char *, int);
967 bool can_create_inferior () override
{ return true; }
968 void create_inferior (const char *, const std::string
&,
969 char **, int) override
;
971 void detach (inferior
*, int) override
;
973 bool can_attach () override
{ return true; }
974 void attach (const char *, int) override
;
976 void post_attach (int) override
;
977 bool supports_disable_randomization () override
;
980 /* Per-program-space data key. */
981 static const struct program_space_key
<char, gdb::xfree_deleter
<char>>
984 /* The variable registered as the control variable used by the
985 remote exec-file commands. While the remote exec-file setting is
986 per-program-space, the set/show machinery uses this as the
987 location of the remote exec-file value. */
988 static char *remote_exec_file_var
;
990 /* The size to align memory write packets, when practical. The protocol
991 does not guarantee any alignment, and gdb will generate short
992 writes and unaligned writes, but even as a best-effort attempt this
993 can improve bulk transfers. For instance, if a write is misaligned
994 relative to the target's data bus, the stub may need to make an extra
995 round trip fetching data from the target. This doesn't make a
996 huge difference, but it's easy to do, so we try to be helpful.
998 The alignment chosen is arbitrary; usually data bus width is
999 important here, not the possibly larger cache line size. */
1000 enum { REMOTE_ALIGN_WRITES
= 16 };
1002 /* Prototypes for local functions. */
1004 static int hexnumlen (ULONGEST num
);
1006 static int stubhex (int ch
);
1008 static int hexnumstr (char *, ULONGEST
);
1010 static int hexnumnstr (char *, ULONGEST
, int);
1012 static CORE_ADDR
remote_address_masked (CORE_ADDR
);
1014 static void print_packet (const char *);
1016 static int stub_unpack_int (char *buff
, int fieldlength
);
1018 struct packet_config
;
1020 static void show_packet_config_cmd (struct packet_config
*config
);
1022 static void show_remote_protocol_packet_cmd (struct ui_file
*file
,
1024 struct cmd_list_element
*c
,
1027 static ptid_t
read_ptid (const char *buf
, const char **obuf
);
1029 static void remote_async_inferior_event_handler (gdb_client_data
);
1031 static bool remote_read_description_p (struct target_ops
*target
);
1033 static void remote_console_output (const char *msg
);
1035 static void remote_btrace_reset (remote_state
*rs
);
1037 static void remote_unpush_and_throw (remote_target
*target
);
1041 static struct cmd_list_element
*remote_cmdlist
;
1043 /* For "set remote" and "show remote". */
1045 static struct cmd_list_element
*remote_set_cmdlist
;
1046 static struct cmd_list_element
*remote_show_cmdlist
;
1048 /* Controls whether GDB is willing to use range stepping. */
1050 static bool use_range_stepping
= true;
1052 /* Private data that we'll store in (struct thread_info)->priv. */
1053 struct remote_thread_info
: public private_thread_info
1059 /* Thread handle, perhaps a pthread_t or thread_t value, stored as a
1060 sequence of bytes. */
1061 gdb::byte_vector thread_handle
;
1063 /* Whether the target stopped for a breakpoint/watchpoint. */
1064 enum target_stop_reason stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
1066 /* This is set to the data address of the access causing the target
1067 to stop for a watchpoint. */
1068 CORE_ADDR watch_data_address
= 0;
1070 /* Fields used by the vCont action coalescing implemented in
1071 remote_resume / remote_commit_resume. remote_resume stores each
1072 thread's last resume request in these fields, so that a later
1073 remote_commit_resume knows which is the proper action for this
1074 thread to include in the vCont packet. */
1076 /* True if the last target_resume call for this thread was a step
1077 request, false if a continue request. */
1078 int last_resume_step
= 0;
1080 /* The signal specified in the last target_resume call for this
1082 gdb_signal last_resume_sig
= GDB_SIGNAL_0
;
1084 /* Whether this thread was already vCont-resumed on the remote
1086 int vcont_resumed
= 0;
1089 remote_state::remote_state ()
1094 remote_state::~remote_state ()
1096 xfree (this->last_pass_packet
);
1097 xfree (this->last_program_signals_packet
);
1098 xfree (this->finished_object
);
1099 xfree (this->finished_annex
);
1102 /* Utility: generate error from an incoming stub packet. */
1104 trace_error (char *buf
)
1107 return; /* not an error msg */
1110 case '1': /* malformed packet error */
1111 if (*++buf
== '0') /* general case: */
1112 error (_("remote.c: error in outgoing packet."));
1114 error (_("remote.c: error in outgoing packet at field #%ld."),
1115 strtol (buf
, NULL
, 16));
1117 error (_("Target returns error code '%s'."), buf
);
1121 /* Utility: wait for reply from stub, while accepting "O" packets. */
1124 remote_target::remote_get_noisy_reply ()
1126 struct remote_state
*rs
= get_remote_state ();
1128 do /* Loop on reply from remote stub. */
1132 QUIT
; /* Allow user to bail out with ^C. */
1133 getpkt (&rs
->buf
, 0);
1134 buf
= rs
->buf
.data ();
1137 else if (startswith (buf
, "qRelocInsn:"))
1140 CORE_ADDR from
, to
, org_to
;
1142 int adjusted_size
= 0;
1145 p
= buf
+ strlen ("qRelocInsn:");
1146 pp
= unpack_varlen_hex (p
, &ul
);
1148 error (_("invalid qRelocInsn packet: %s"), buf
);
1152 unpack_varlen_hex (p
, &ul
);
1159 gdbarch_relocate_instruction (target_gdbarch (), &to
, from
);
1162 catch (const gdb_exception
&ex
)
1164 if (ex
.error
== MEMORY_ERROR
)
1166 /* Propagate memory errors silently back to the
1167 target. The stub may have limited the range of
1168 addresses we can write to, for example. */
1172 /* Something unexpectedly bad happened. Be verbose
1173 so we can tell what, and propagate the error back
1174 to the stub, so it doesn't get stuck waiting for
1176 exception_fprintf (gdb_stderr
, ex
,
1177 _("warning: relocating instruction: "));
1184 adjusted_size
= to
- org_to
;
1186 xsnprintf (buf
, rs
->buf
.size (), "qRelocInsn:%x", adjusted_size
);
1190 else if (buf
[0] == 'O' && buf
[1] != 'K')
1191 remote_console_output (buf
+ 1); /* 'O' message from stub */
1193 return buf
; /* Here's the actual reply. */
1198 struct remote_arch_state
*
1199 remote_state::get_remote_arch_state (struct gdbarch
*gdbarch
)
1201 remote_arch_state
*rsa
;
1203 auto it
= this->m_arch_states
.find (gdbarch
);
1204 if (it
== this->m_arch_states
.end ())
1206 auto p
= this->m_arch_states
.emplace (std::piecewise_construct
,
1207 std::forward_as_tuple (gdbarch
),
1208 std::forward_as_tuple (gdbarch
));
1209 rsa
= &p
.first
->second
;
1211 /* Make sure that the packet buffer is plenty big enough for
1212 this architecture. */
1213 if (this->buf
.size () < rsa
->remote_packet_size
)
1214 this->buf
.resize (2 * rsa
->remote_packet_size
);
1222 /* Fetch the global remote target state. */
1225 remote_target::get_remote_state ()
1227 /* Make sure that the remote architecture state has been
1228 initialized, because doing so might reallocate rs->buf. Any
1229 function which calls getpkt also needs to be mindful of changes
1230 to rs->buf, but this call limits the number of places which run
1232 m_remote_state
.get_remote_arch_state (target_gdbarch ());
1234 return &m_remote_state
;
1237 /* Fetch the remote exec-file from the current program space. */
1240 get_remote_exec_file (void)
1242 char *remote_exec_file
;
1244 remote_exec_file
= remote_pspace_data
.get (current_program_space
);
1245 if (remote_exec_file
== NULL
)
1248 return remote_exec_file
;
1251 /* Set the remote exec file for PSPACE. */
1254 set_pspace_remote_exec_file (struct program_space
*pspace
,
1255 const char *remote_exec_file
)
1257 char *old_file
= remote_pspace_data
.get (pspace
);
1260 remote_pspace_data
.set (pspace
, xstrdup (remote_exec_file
));
1263 /* The "set/show remote exec-file" set command hook. */
1266 set_remote_exec_file (const char *ignored
, int from_tty
,
1267 struct cmd_list_element
*c
)
1269 gdb_assert (remote_exec_file_var
!= NULL
);
1270 set_pspace_remote_exec_file (current_program_space
, remote_exec_file_var
);
1273 /* The "set/show remote exec-file" show command hook. */
1276 show_remote_exec_file (struct ui_file
*file
, int from_tty
,
1277 struct cmd_list_element
*cmd
, const char *value
)
1279 fprintf_filtered (file
, "%s\n", get_remote_exec_file ());
1283 map_regcache_remote_table (struct gdbarch
*gdbarch
, struct packet_reg
*regs
)
1285 int regnum
, num_remote_regs
, offset
;
1286 struct packet_reg
**remote_regs
;
1288 for (regnum
= 0; regnum
< gdbarch_num_regs (gdbarch
); regnum
++)
1290 struct packet_reg
*r
= ®s
[regnum
];
1292 if (register_size (gdbarch
, regnum
) == 0)
1293 /* Do not try to fetch zero-sized (placeholder) registers. */
1296 r
->pnum
= gdbarch_remote_register_number (gdbarch
, regnum
);
1301 /* Define the g/G packet format as the contents of each register
1302 with a remote protocol number, in order of ascending protocol
1305 remote_regs
= XALLOCAVEC (struct packet_reg
*, gdbarch_num_regs (gdbarch
));
1306 for (num_remote_regs
= 0, regnum
= 0;
1307 regnum
< gdbarch_num_regs (gdbarch
);
1309 if (regs
[regnum
].pnum
!= -1)
1310 remote_regs
[num_remote_regs
++] = ®s
[regnum
];
1312 std::sort (remote_regs
, remote_regs
+ num_remote_regs
,
1313 [] (const packet_reg
*a
, const packet_reg
*b
)
1314 { return a
->pnum
< b
->pnum
; });
1316 for (regnum
= 0, offset
= 0; regnum
< num_remote_regs
; regnum
++)
1318 remote_regs
[regnum
]->in_g_packet
= 1;
1319 remote_regs
[regnum
]->offset
= offset
;
1320 offset
+= register_size (gdbarch
, remote_regs
[regnum
]->regnum
);
1326 /* Given the architecture described by GDBARCH, return the remote
1327 protocol register's number and the register's offset in the g/G
1328 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
1329 If the target does not have a mapping for REGNUM, return false,
1330 otherwise, return true. */
1333 remote_register_number_and_offset (struct gdbarch
*gdbarch
, int regnum
,
1334 int *pnum
, int *poffset
)
1336 gdb_assert (regnum
< gdbarch_num_regs (gdbarch
));
1338 std::vector
<packet_reg
> regs (gdbarch_num_regs (gdbarch
));
1340 map_regcache_remote_table (gdbarch
, regs
.data ());
1342 *pnum
= regs
[regnum
].pnum
;
1343 *poffset
= regs
[regnum
].offset
;
1348 remote_arch_state::remote_arch_state (struct gdbarch
*gdbarch
)
1350 /* Use the architecture to build a regnum<->pnum table, which will be
1351 1:1 unless a feature set specifies otherwise. */
1352 this->regs
.reset (new packet_reg
[gdbarch_num_regs (gdbarch
)] ());
1354 /* Record the maximum possible size of the g packet - it may turn out
1356 this->sizeof_g_packet
1357 = map_regcache_remote_table (gdbarch
, this->regs
.get ());
1359 /* Default maximum number of characters in a packet body. Many
1360 remote stubs have a hardwired buffer size of 400 bytes
1361 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
1362 as the maximum packet-size to ensure that the packet and an extra
1363 NUL character can always fit in the buffer. This stops GDB
1364 trashing stubs that try to squeeze an extra NUL into what is
1365 already a full buffer (As of 1999-12-04 that was most stubs). */
1366 this->remote_packet_size
= 400 - 1;
1368 /* This one is filled in when a ``g'' packet is received. */
1369 this->actual_register_packet_size
= 0;
1371 /* Should rsa->sizeof_g_packet needs more space than the
1372 default, adjust the size accordingly. Remember that each byte is
1373 encoded as two characters. 32 is the overhead for the packet
1374 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
1375 (``$NN:G...#NN'') is a better guess, the below has been padded a
1377 if (this->sizeof_g_packet
> ((this->remote_packet_size
- 32) / 2))
1378 this->remote_packet_size
= (this->sizeof_g_packet
* 2 + 32);
1381 /* Get a pointer to the current remote target. If not connected to a
1382 remote target, return NULL. */
1384 static remote_target
*
1385 get_current_remote_target ()
1387 target_ops
*proc_target
= current_inferior ()->process_target ();
1388 return dynamic_cast<remote_target
*> (proc_target
);
1391 /* Return the current allowed size of a remote packet. This is
1392 inferred from the current architecture, and should be used to
1393 limit the length of outgoing packets. */
1395 remote_target::get_remote_packet_size ()
1397 struct remote_state
*rs
= get_remote_state ();
1398 remote_arch_state
*rsa
= rs
->get_remote_arch_state (target_gdbarch ());
1400 if (rs
->explicit_packet_size
)
1401 return rs
->explicit_packet_size
;
1403 return rsa
->remote_packet_size
;
1406 static struct packet_reg
*
1407 packet_reg_from_regnum (struct gdbarch
*gdbarch
, struct remote_arch_state
*rsa
,
1410 if (regnum
< 0 && regnum
>= gdbarch_num_regs (gdbarch
))
1414 struct packet_reg
*r
= &rsa
->regs
[regnum
];
1416 gdb_assert (r
->regnum
== regnum
);
1421 static struct packet_reg
*
1422 packet_reg_from_pnum (struct gdbarch
*gdbarch
, struct remote_arch_state
*rsa
,
1427 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
1429 struct packet_reg
*r
= &rsa
->regs
[i
];
1431 if (r
->pnum
== pnum
)
1437 /* Allow the user to specify what sequence to send to the remote
1438 when he requests a program interruption: Although ^C is usually
1439 what remote systems expect (this is the default, here), it is
1440 sometimes preferable to send a break. On other systems such
1441 as the Linux kernel, a break followed by g, which is Magic SysRq g
1442 is required in order to interrupt the execution. */
1443 const char interrupt_sequence_control_c
[] = "Ctrl-C";
1444 const char interrupt_sequence_break
[] = "BREAK";
1445 const char interrupt_sequence_break_g
[] = "BREAK-g";
1446 static const char *const interrupt_sequence_modes
[] =
1448 interrupt_sequence_control_c
,
1449 interrupt_sequence_break
,
1450 interrupt_sequence_break_g
,
1453 static const char *interrupt_sequence_mode
= interrupt_sequence_control_c
;
1456 show_interrupt_sequence (struct ui_file
*file
, int from_tty
,
1457 struct cmd_list_element
*c
,
1460 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
1461 fprintf_filtered (file
,
1462 _("Send the ASCII ETX character (Ctrl-c) "
1463 "to the remote target to interrupt the "
1464 "execution of the program.\n"));
1465 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
1466 fprintf_filtered (file
,
1467 _("send a break signal to the remote target "
1468 "to interrupt the execution of the program.\n"));
1469 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
1470 fprintf_filtered (file
,
1471 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
1472 "the remote target to interrupt the execution "
1473 "of Linux kernel.\n"));
1475 internal_error (__FILE__
, __LINE__
,
1476 _("Invalid value for interrupt_sequence_mode: %s."),
1477 interrupt_sequence_mode
);
1480 /* This boolean variable specifies whether interrupt_sequence is sent
1481 to the remote target when gdb connects to it.
1482 This is mostly needed when you debug the Linux kernel: The Linux kernel
1483 expects BREAK g which is Magic SysRq g for connecting gdb. */
1484 static bool interrupt_on_connect
= false;
1486 /* This variable is used to implement the "set/show remotebreak" commands.
1487 Since these commands are now deprecated in favor of "set/show remote
1488 interrupt-sequence", it no longer has any effect on the code. */
1489 static bool remote_break
;
1492 set_remotebreak (const char *args
, int from_tty
, struct cmd_list_element
*c
)
1495 interrupt_sequence_mode
= interrupt_sequence_break
;
1497 interrupt_sequence_mode
= interrupt_sequence_control_c
;
1501 show_remotebreak (struct ui_file
*file
, int from_tty
,
1502 struct cmd_list_element
*c
,
1507 /* This variable sets the number of bits in an address that are to be
1508 sent in a memory ("M" or "m") packet. Normally, after stripping
1509 leading zeros, the entire address would be sent. This variable
1510 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
1511 initial implementation of remote.c restricted the address sent in
1512 memory packets to ``host::sizeof long'' bytes - (typically 32
1513 bits). Consequently, for 64 bit targets, the upper 32 bits of an
1514 address was never sent. Since fixing this bug may cause a break in
1515 some remote targets this variable is principally provided to
1516 facilitate backward compatibility. */
1518 static unsigned int remote_address_size
;
1521 /* User configurable variables for the number of characters in a
1522 memory read/write packet. MIN (rsa->remote_packet_size,
1523 rsa->sizeof_g_packet) is the default. Some targets need smaller
1524 values (fifo overruns, et.al.) and some users need larger values
1525 (speed up transfers). The variables ``preferred_*'' (the user
1526 request), ``current_*'' (what was actually set) and ``forced_*''
1527 (Positive - a soft limit, negative - a hard limit). */
1529 struct memory_packet_config
1536 /* The default max memory-write-packet-size, when the setting is
1537 "fixed". The 16k is historical. (It came from older GDB's using
1538 alloca for buffers and the knowledge (folklore?) that some hosts
1539 don't cope very well with large alloca calls.) */
1540 #define DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED 16384
1542 /* The minimum remote packet size for memory transfers. Ensures we
1543 can write at least one byte. */
1544 #define MIN_MEMORY_PACKET_SIZE 20
1546 /* Get the memory packet size, assuming it is fixed. */
1549 get_fixed_memory_packet_size (struct memory_packet_config
*config
)
1551 gdb_assert (config
->fixed_p
);
1553 if (config
->size
<= 0)
1554 return DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
;
1556 return config
->size
;
1559 /* Compute the current size of a read/write packet. Since this makes
1560 use of ``actual_register_packet_size'' the computation is dynamic. */
1563 remote_target::get_memory_packet_size (struct memory_packet_config
*config
)
1565 struct remote_state
*rs
= get_remote_state ();
1566 remote_arch_state
*rsa
= rs
->get_remote_arch_state (target_gdbarch ());
1569 if (config
->fixed_p
)
1570 what_they_get
= get_fixed_memory_packet_size (config
);
1573 what_they_get
= get_remote_packet_size ();
1574 /* Limit the packet to the size specified by the user. */
1575 if (config
->size
> 0
1576 && what_they_get
> config
->size
)
1577 what_they_get
= config
->size
;
1579 /* Limit it to the size of the targets ``g'' response unless we have
1580 permission from the stub to use a larger packet size. */
1581 if (rs
->explicit_packet_size
== 0
1582 && rsa
->actual_register_packet_size
> 0
1583 && what_they_get
> rsa
->actual_register_packet_size
)
1584 what_they_get
= rsa
->actual_register_packet_size
;
1586 if (what_they_get
< MIN_MEMORY_PACKET_SIZE
)
1587 what_they_get
= MIN_MEMORY_PACKET_SIZE
;
1589 /* Make sure there is room in the global buffer for this packet
1590 (including its trailing NUL byte). */
1591 if (rs
->buf
.size () < what_they_get
+ 1)
1592 rs
->buf
.resize (2 * what_they_get
);
1594 return what_they_get
;
1597 /* Update the size of a read/write packet. If they user wants
1598 something really big then do a sanity check. */
1601 set_memory_packet_size (const char *args
, struct memory_packet_config
*config
)
1603 int fixed_p
= config
->fixed_p
;
1604 long size
= config
->size
;
1607 error (_("Argument required (integer, `fixed' or `limited')."));
1608 else if (strcmp (args
, "hard") == 0
1609 || strcmp (args
, "fixed") == 0)
1611 else if (strcmp (args
, "soft") == 0
1612 || strcmp (args
, "limit") == 0)
1618 size
= strtoul (args
, &end
, 0);
1620 error (_("Invalid %s (bad syntax)."), config
->name
);
1622 /* Instead of explicitly capping the size of a packet to or
1623 disallowing it, the user is allowed to set the size to
1624 something arbitrarily large. */
1628 if (fixed_p
&& !config
->fixed_p
)
1630 /* So that the query shows the correct value. */
1631 long query_size
= (size
<= 0
1632 ? DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
1635 if (! query (_("The target may not be able to correctly handle a %s\n"
1636 "of %ld bytes. Change the packet size? "),
1637 config
->name
, query_size
))
1638 error (_("Packet size not changed."));
1640 /* Update the config. */
1641 config
->fixed_p
= fixed_p
;
1642 config
->size
= size
;
1646 show_memory_packet_size (struct memory_packet_config
*config
)
1648 if (config
->size
== 0)
1649 printf_filtered (_("The %s is 0 (default). "), config
->name
);
1651 printf_filtered (_("The %s is %ld. "), config
->name
, config
->size
);
1652 if (config
->fixed_p
)
1653 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
1654 get_fixed_memory_packet_size (config
));
1657 remote_target
*remote
= get_current_remote_target ();
1660 printf_filtered (_("Packets are limited to %ld bytes.\n"),
1661 remote
->get_memory_packet_size (config
));
1663 puts_filtered ("The actual limit will be further reduced "
1664 "dependent on the target.\n");
1668 /* FIXME: needs to be per-remote-target. */
1669 static struct memory_packet_config memory_write_packet_config
=
1671 "memory-write-packet-size",
1675 set_memory_write_packet_size (const char *args
, int from_tty
)
1677 set_memory_packet_size (args
, &memory_write_packet_config
);
1681 show_memory_write_packet_size (const char *args
, int from_tty
)
1683 show_memory_packet_size (&memory_write_packet_config
);
1686 /* Show the number of hardware watchpoints that can be used. */
1689 show_hardware_watchpoint_limit (struct ui_file
*file
, int from_tty
,
1690 struct cmd_list_element
*c
,
1693 fprintf_filtered (file
, _("The maximum number of target hardware "
1694 "watchpoints is %s.\n"), value
);
1697 /* Show the length limit (in bytes) for hardware watchpoints. */
1700 show_hardware_watchpoint_length_limit (struct ui_file
*file
, int from_tty
,
1701 struct cmd_list_element
*c
,
1704 fprintf_filtered (file
, _("The maximum length (in bytes) of a target "
1705 "hardware watchpoint is %s.\n"), value
);
1708 /* Show the number of hardware breakpoints that can be used. */
1711 show_hardware_breakpoint_limit (struct ui_file
*file
, int from_tty
,
1712 struct cmd_list_element
*c
,
1715 fprintf_filtered (file
, _("The maximum number of target hardware "
1716 "breakpoints is %s.\n"), value
);
1719 /* Controls the maximum number of characters to display in the debug output
1720 for each remote packet. The remaining characters are omitted. */
1722 static int remote_packet_max_chars
= 512;
1724 /* Show the maximum number of characters to display for each remote packet
1725 when remote debugging is enabled. */
1728 show_remote_packet_max_chars (struct ui_file
*file
, int from_tty
,
1729 struct cmd_list_element
*c
,
1732 fprintf_filtered (file
, _("Number of remote packet characters to "
1733 "display is %s.\n"), value
);
1737 remote_target::get_memory_write_packet_size ()
1739 return get_memory_packet_size (&memory_write_packet_config
);
1742 /* FIXME: needs to be per-remote-target. */
1743 static struct memory_packet_config memory_read_packet_config
=
1745 "memory-read-packet-size",
1749 set_memory_read_packet_size (const char *args
, int from_tty
)
1751 set_memory_packet_size (args
, &memory_read_packet_config
);
1755 show_memory_read_packet_size (const char *args
, int from_tty
)
1757 show_memory_packet_size (&memory_read_packet_config
);
1761 remote_target::get_memory_read_packet_size ()
1763 long size
= get_memory_packet_size (&memory_read_packet_config
);
1765 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1766 extra buffer size argument before the memory read size can be
1767 increased beyond this. */
1768 if (size
> get_remote_packet_size ())
1769 size
= get_remote_packet_size ();
1775 struct packet_config
1780 /* If auto, GDB auto-detects support for this packet or feature,
1781 either through qSupported, or by trying the packet and looking
1782 at the response. If true, GDB assumes the target supports this
1783 packet. If false, the packet is disabled. Configs that don't
1784 have an associated command always have this set to auto. */
1785 enum auto_boolean detect
;
1787 /* Does the target support this packet? */
1788 enum packet_support support
;
1791 static enum packet_support
packet_config_support (struct packet_config
*config
);
1792 static enum packet_support
packet_support (int packet
);
1795 show_packet_config_cmd (struct packet_config
*config
)
1797 const char *support
= "internal-error";
1799 switch (packet_config_support (config
))
1802 support
= "enabled";
1804 case PACKET_DISABLE
:
1805 support
= "disabled";
1807 case PACKET_SUPPORT_UNKNOWN
:
1808 support
= "unknown";
1811 switch (config
->detect
)
1813 case AUTO_BOOLEAN_AUTO
:
1814 printf_filtered (_("Support for the `%s' packet "
1815 "is auto-detected, currently %s.\n"),
1816 config
->name
, support
);
1818 case AUTO_BOOLEAN_TRUE
:
1819 case AUTO_BOOLEAN_FALSE
:
1820 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1821 config
->name
, support
);
1827 add_packet_config_cmd (struct packet_config
*config
, const char *name
,
1828 const char *title
, int legacy
)
1834 config
->name
= name
;
1835 config
->title
= title
;
1836 set_doc
= xstrprintf ("Set use of remote protocol `%s' (%s) packet.",
1838 show_doc
= xstrprintf ("Show current use of remote "
1839 "protocol `%s' (%s) packet.",
1841 /* set/show TITLE-packet {auto,on,off} */
1842 cmd_name
= xstrprintf ("%s-packet", title
);
1843 add_setshow_auto_boolean_cmd (cmd_name
, class_obscure
,
1844 &config
->detect
, set_doc
,
1845 show_doc
, NULL
, /* help_doc */
1847 show_remote_protocol_packet_cmd
,
1848 &remote_set_cmdlist
, &remote_show_cmdlist
);
1849 /* The command code copies the documentation strings. */
1852 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1857 legacy_name
= xstrprintf ("%s-packet", name
);
1858 add_alias_cmd (legacy_name
, cmd_name
, class_obscure
, 0,
1859 &remote_set_cmdlist
);
1860 add_alias_cmd (legacy_name
, cmd_name
, class_obscure
, 0,
1861 &remote_show_cmdlist
);
1865 static enum packet_result
1866 packet_check_result (const char *buf
)
1870 /* The stub recognized the packet request. Check that the
1871 operation succeeded. */
1873 && isxdigit (buf
[1]) && isxdigit (buf
[2])
1875 /* "Enn" - definitely an error. */
1876 return PACKET_ERROR
;
1878 /* Always treat "E." as an error. This will be used for
1879 more verbose error messages, such as E.memtypes. */
1880 if (buf
[0] == 'E' && buf
[1] == '.')
1881 return PACKET_ERROR
;
1883 /* The packet may or may not be OK. Just assume it is. */
1887 /* The stub does not support the packet. */
1888 return PACKET_UNKNOWN
;
1891 static enum packet_result
1892 packet_check_result (const gdb::char_vector
&buf
)
1894 return packet_check_result (buf
.data ());
1897 static enum packet_result
1898 packet_ok (const char *buf
, struct packet_config
*config
)
1900 enum packet_result result
;
1902 if (config
->detect
!= AUTO_BOOLEAN_TRUE
1903 && config
->support
== PACKET_DISABLE
)
1904 internal_error (__FILE__
, __LINE__
,
1905 _("packet_ok: attempt to use a disabled packet"));
1907 result
= packet_check_result (buf
);
1912 /* The stub recognized the packet request. */
1913 if (config
->support
== PACKET_SUPPORT_UNKNOWN
)
1916 fprintf_unfiltered (gdb_stdlog
,
1917 "Packet %s (%s) is supported\n",
1918 config
->name
, config
->title
);
1919 config
->support
= PACKET_ENABLE
;
1922 case PACKET_UNKNOWN
:
1923 /* The stub does not support the packet. */
1924 if (config
->detect
== AUTO_BOOLEAN_AUTO
1925 && config
->support
== PACKET_ENABLE
)
1927 /* If the stub previously indicated that the packet was
1928 supported then there is a protocol error. */
1929 error (_("Protocol error: %s (%s) conflicting enabled responses."),
1930 config
->name
, config
->title
);
1932 else if (config
->detect
== AUTO_BOOLEAN_TRUE
)
1934 /* The user set it wrong. */
1935 error (_("Enabled packet %s (%s) not recognized by stub"),
1936 config
->name
, config
->title
);
1940 fprintf_unfiltered (gdb_stdlog
,
1941 "Packet %s (%s) is NOT supported\n",
1942 config
->name
, config
->title
);
1943 config
->support
= PACKET_DISABLE
;
1950 static enum packet_result
1951 packet_ok (const gdb::char_vector
&buf
, struct packet_config
*config
)
1953 return packet_ok (buf
.data (), config
);
1970 PACKET_vFile_pwrite
,
1972 PACKET_vFile_unlink
,
1973 PACKET_vFile_readlink
,
1976 PACKET_qXfer_features
,
1977 PACKET_qXfer_exec_file
,
1978 PACKET_qXfer_libraries
,
1979 PACKET_qXfer_libraries_svr4
,
1980 PACKET_qXfer_memory_map
,
1981 PACKET_qXfer_osdata
,
1982 PACKET_qXfer_threads
,
1983 PACKET_qXfer_statictrace_read
,
1984 PACKET_qXfer_traceframe_info
,
1990 PACKET_QPassSignals
,
1991 PACKET_QCatchSyscalls
,
1992 PACKET_QProgramSignals
,
1993 PACKET_QSetWorkingDir
,
1994 PACKET_QStartupWithShell
,
1995 PACKET_QEnvironmentHexEncoded
,
1996 PACKET_QEnvironmentReset
,
1997 PACKET_QEnvironmentUnset
,
1999 PACKET_qSearch_memory
,
2002 PACKET_QStartNoAckMode
,
2004 PACKET_qXfer_siginfo_read
,
2005 PACKET_qXfer_siginfo_write
,
2008 /* Support for conditional tracepoints. */
2009 PACKET_ConditionalTracepoints
,
2011 /* Support for target-side breakpoint conditions. */
2012 PACKET_ConditionalBreakpoints
,
2014 /* Support for target-side breakpoint commands. */
2015 PACKET_BreakpointCommands
,
2017 /* Support for fast tracepoints. */
2018 PACKET_FastTracepoints
,
2020 /* Support for static tracepoints. */
2021 PACKET_StaticTracepoints
,
2023 /* Support for installing tracepoints while a trace experiment is
2025 PACKET_InstallInTrace
,
2029 PACKET_TracepointSource
,
2032 PACKET_QDisableRandomization
,
2034 PACKET_QTBuffer_size
,
2038 PACKET_qXfer_btrace
,
2040 /* Support for the QNonStop packet. */
2043 /* Support for the QThreadEvents packet. */
2044 PACKET_QThreadEvents
,
2046 /* Support for multi-process extensions. */
2047 PACKET_multiprocess_feature
,
2049 /* Support for enabling and disabling tracepoints while a trace
2050 experiment is running. */
2051 PACKET_EnableDisableTracepoints_feature
,
2053 /* Support for collecting strings using the tracenz bytecode. */
2054 PACKET_tracenz_feature
,
2056 /* Support for continuing to run a trace experiment while GDB is
2058 PACKET_DisconnectedTracing_feature
,
2060 /* Support for qXfer:libraries-svr4:read with a non-empty annex. */
2061 PACKET_augmented_libraries_svr4_read_feature
,
2063 /* Support for the qXfer:btrace-conf:read packet. */
2064 PACKET_qXfer_btrace_conf
,
2066 /* Support for the Qbtrace-conf:bts:size packet. */
2067 PACKET_Qbtrace_conf_bts_size
,
2069 /* Support for swbreak+ feature. */
2070 PACKET_swbreak_feature
,
2072 /* Support for hwbreak+ feature. */
2073 PACKET_hwbreak_feature
,
2075 /* Support for fork events. */
2076 PACKET_fork_event_feature
,
2078 /* Support for vfork events. */
2079 PACKET_vfork_event_feature
,
2081 /* Support for the Qbtrace-conf:pt:size packet. */
2082 PACKET_Qbtrace_conf_pt_size
,
2084 /* Support for exec events. */
2085 PACKET_exec_event_feature
,
2087 /* Support for query supported vCont actions. */
2088 PACKET_vContSupported
,
2090 /* Support remote CTRL-C. */
2093 /* Support TARGET_WAITKIND_NO_RESUMED. */
2099 /* FIXME: needs to be per-remote-target. Ignoring this for now,
2100 assuming all remote targets are the same server (thus all support
2101 the same packets). */
2102 static struct packet_config remote_protocol_packets
[PACKET_MAX
];
2104 /* Returns the packet's corresponding "set remote foo-packet" command
2105 state. See struct packet_config for more details. */
2107 static enum auto_boolean
2108 packet_set_cmd_state (int packet
)
2110 return remote_protocol_packets
[packet
].detect
;
2113 /* Returns whether a given packet or feature is supported. This takes
2114 into account the state of the corresponding "set remote foo-packet"
2115 command, which may be used to bypass auto-detection. */
2117 static enum packet_support
2118 packet_config_support (struct packet_config
*config
)
2120 switch (config
->detect
)
2122 case AUTO_BOOLEAN_TRUE
:
2123 return PACKET_ENABLE
;
2124 case AUTO_BOOLEAN_FALSE
:
2125 return PACKET_DISABLE
;
2126 case AUTO_BOOLEAN_AUTO
:
2127 return config
->support
;
2129 gdb_assert_not_reached (_("bad switch"));
2133 /* Same as packet_config_support, but takes the packet's enum value as
2136 static enum packet_support
2137 packet_support (int packet
)
2139 struct packet_config
*config
= &remote_protocol_packets
[packet
];
2141 return packet_config_support (config
);
2145 show_remote_protocol_packet_cmd (struct ui_file
*file
, int from_tty
,
2146 struct cmd_list_element
*c
,
2149 struct packet_config
*packet
;
2151 for (packet
= remote_protocol_packets
;
2152 packet
< &remote_protocol_packets
[PACKET_MAX
];
2155 if (&packet
->detect
== c
->var
)
2157 show_packet_config_cmd (packet
);
2161 internal_error (__FILE__
, __LINE__
, _("Could not find config for %s"),
2165 /* Should we try one of the 'Z' requests? */
2169 Z_PACKET_SOFTWARE_BP
,
2170 Z_PACKET_HARDWARE_BP
,
2177 /* For compatibility with older distributions. Provide a ``set remote
2178 Z-packet ...'' command that updates all the Z packet types. */
2180 static enum auto_boolean remote_Z_packet_detect
;
2183 set_remote_protocol_Z_packet_cmd (const char *args
, int from_tty
,
2184 struct cmd_list_element
*c
)
2188 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
2189 remote_protocol_packets
[PACKET_Z0
+ i
].detect
= remote_Z_packet_detect
;
2193 show_remote_protocol_Z_packet_cmd (struct ui_file
*file
, int from_tty
,
2194 struct cmd_list_element
*c
,
2199 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
2201 show_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
+ i
]);
2205 /* Returns true if the multi-process extensions are in effect. */
2208 remote_multi_process_p (struct remote_state
*rs
)
2210 return packet_support (PACKET_multiprocess_feature
) == PACKET_ENABLE
;
2213 /* Returns true if fork events are supported. */
2216 remote_fork_event_p (struct remote_state
*rs
)
2218 return packet_support (PACKET_fork_event_feature
) == PACKET_ENABLE
;
2221 /* Returns true if vfork events are supported. */
2224 remote_vfork_event_p (struct remote_state
*rs
)
2226 return packet_support (PACKET_vfork_event_feature
) == PACKET_ENABLE
;
2229 /* Returns true if exec events are supported. */
2232 remote_exec_event_p (struct remote_state
*rs
)
2234 return packet_support (PACKET_exec_event_feature
) == PACKET_ENABLE
;
2237 /* Insert fork catchpoint target routine. If fork events are enabled
2238 then return success, nothing more to do. */
2241 remote_target::insert_fork_catchpoint (int pid
)
2243 struct remote_state
*rs
= get_remote_state ();
2245 return !remote_fork_event_p (rs
);
2248 /* Remove fork catchpoint target routine. Nothing to do, just
2252 remote_target::remove_fork_catchpoint (int pid
)
2257 /* Insert vfork catchpoint target routine. If vfork events are enabled
2258 then return success, nothing more to do. */
2261 remote_target::insert_vfork_catchpoint (int pid
)
2263 struct remote_state
*rs
= get_remote_state ();
2265 return !remote_vfork_event_p (rs
);
2268 /* Remove vfork catchpoint target routine. Nothing to do, just
2272 remote_target::remove_vfork_catchpoint (int pid
)
2277 /* Insert exec catchpoint target routine. If exec events are
2278 enabled, just return success. */
2281 remote_target::insert_exec_catchpoint (int pid
)
2283 struct remote_state
*rs
= get_remote_state ();
2285 return !remote_exec_event_p (rs
);
2288 /* Remove exec catchpoint target routine. Nothing to do, just
2292 remote_target::remove_exec_catchpoint (int pid
)
2299 /* Take advantage of the fact that the TID field is not used, to tag
2300 special ptids with it set to != 0. */
2301 static const ptid_t
magic_null_ptid (42000, -1, 1);
2302 static const ptid_t
not_sent_ptid (42000, -2, 1);
2303 static const ptid_t
any_thread_ptid (42000, 0, 1);
2305 /* Find out if the stub attached to PID (and hence GDB should offer to
2306 detach instead of killing it when bailing out). */
2309 remote_target::remote_query_attached (int pid
)
2311 struct remote_state
*rs
= get_remote_state ();
2312 size_t size
= get_remote_packet_size ();
2314 if (packet_support (PACKET_qAttached
) == PACKET_DISABLE
)
2317 if (remote_multi_process_p (rs
))
2318 xsnprintf (rs
->buf
.data (), size
, "qAttached:%x", pid
);
2320 xsnprintf (rs
->buf
.data (), size
, "qAttached");
2323 getpkt (&rs
->buf
, 0);
2325 switch (packet_ok (rs
->buf
,
2326 &remote_protocol_packets
[PACKET_qAttached
]))
2329 if (strcmp (rs
->buf
.data (), "1") == 0)
2333 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
2335 case PACKET_UNKNOWN
:
2342 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
2343 has been invented by GDB, instead of reported by the target. Since
2344 we can be connected to a remote system before before knowing about
2345 any inferior, mark the target with execution when we find the first
2346 inferior. If ATTACHED is 1, then we had just attached to this
2347 inferior. If it is 0, then we just created this inferior. If it
2348 is -1, then try querying the remote stub to find out if it had
2349 attached to the inferior or not. If TRY_OPEN_EXEC is true then
2350 attempt to open this inferior's executable as the main executable
2351 if no main executable is open already. */
2354 remote_target::remote_add_inferior (bool fake_pid_p
, int pid
, int attached
,
2357 struct inferior
*inf
;
2359 /* Check whether this process we're learning about is to be
2360 considered attached, or if is to be considered to have been
2361 spawned by the stub. */
2363 attached
= remote_query_attached (pid
);
2365 if (gdbarch_has_global_solist (target_gdbarch ()))
2367 /* If the target shares code across all inferiors, then every
2368 attach adds a new inferior. */
2369 inf
= add_inferior (pid
);
2371 /* ... and every inferior is bound to the same program space.
2372 However, each inferior may still have its own address
2374 inf
->aspace
= maybe_new_address_space ();
2375 inf
->pspace
= current_program_space
;
2379 /* In the traditional debugging scenario, there's a 1-1 match
2380 between program/address spaces. We simply bind the inferior
2381 to the program space's address space. */
2382 inf
= current_inferior ();
2384 /* However, if the current inferior is already bound to a
2385 process, find some other empty inferior. */
2389 for (inferior
*it
: all_inferiors ())
2398 /* Since all inferiors were already bound to a process, add
2400 inf
= add_inferior_with_spaces ();
2402 switch_to_inferior_no_thread (inf
);
2404 inferior_appeared (inf
, pid
);
2407 inf
->attach_flag
= attached
;
2408 inf
->fake_pid_p
= fake_pid_p
;
2410 /* If no main executable is currently open then attempt to
2411 open the file that was executed to create this inferior. */
2412 if (try_open_exec
&& get_exec_file (0) == NULL
)
2413 exec_file_locate_attach (pid
, 0, 1);
2415 /* Check for exec file mismatch, and let the user solve it. */
2416 validate_exec_file (1);
2421 static remote_thread_info
*get_remote_thread_info (thread_info
*thread
);
2422 static remote_thread_info
*get_remote_thread_info (remote_target
*target
,
2425 /* Add thread PTID to GDB's thread list. Tag it as executing/running
2426 according to RUNNING. */
2429 remote_target::remote_add_thread (ptid_t ptid
, bool running
, bool executing
)
2431 struct remote_state
*rs
= get_remote_state ();
2432 struct thread_info
*thread
;
2434 /* GDB historically didn't pull threads in the initial connection
2435 setup. If the remote target doesn't even have a concept of
2436 threads (e.g., a bare-metal target), even if internally we
2437 consider that a single-threaded target, mentioning a new thread
2438 might be confusing to the user. Be silent then, preserving the
2439 age old behavior. */
2440 if (rs
->starting_up
)
2441 thread
= add_thread_silent (this, ptid
);
2443 thread
= add_thread (this, ptid
);
2445 get_remote_thread_info (thread
)->vcont_resumed
= executing
;
2446 set_executing (this, ptid
, executing
);
2447 set_running (this, ptid
, running
);
2452 /* Come here when we learn about a thread id from the remote target.
2453 It may be the first time we hear about such thread, so take the
2454 opportunity to add it to GDB's thread list. In case this is the
2455 first time we're noticing its corresponding inferior, add it to
2456 GDB's inferior list as well. EXECUTING indicates whether the
2457 thread is (internally) executing or stopped. */
2460 remote_target::remote_notice_new_inferior (ptid_t currthread
, int executing
)
2462 /* In non-stop mode, we assume new found threads are (externally)
2463 running until proven otherwise with a stop reply. In all-stop,
2464 we can only get here if all threads are stopped. */
2465 int running
= target_is_non_stop_p () ? 1 : 0;
2467 /* If this is a new thread, add it to GDB's thread list.
2468 If we leave it up to WFI to do this, bad things will happen. */
2470 thread_info
*tp
= find_thread_ptid (this, currthread
);
2471 if (tp
!= NULL
&& tp
->state
== THREAD_EXITED
)
2473 /* We're seeing an event on a thread id we knew had exited.
2474 This has to be a new thread reusing the old id. Add it. */
2475 remote_add_thread (currthread
, running
, executing
);
2479 if (!in_thread_list (this, currthread
))
2481 struct inferior
*inf
= NULL
;
2482 int pid
= currthread
.pid ();
2484 if (inferior_ptid
.is_pid ()
2485 && pid
== inferior_ptid
.pid ())
2487 /* inferior_ptid has no thread member yet. This can happen
2488 with the vAttach -> remote_wait,"TAAthread:" path if the
2489 stub doesn't support qC. This is the first stop reported
2490 after an attach, so this is the main thread. Update the
2491 ptid in the thread list. */
2492 if (in_thread_list (this, ptid_t (pid
)))
2493 thread_change_ptid (this, inferior_ptid
, currthread
);
2497 = remote_add_thread (currthread
, running
, executing
);
2498 switch_to_thread (thr
);
2503 if (magic_null_ptid
== inferior_ptid
)
2505 /* inferior_ptid is not set yet. This can happen with the
2506 vRun -> remote_wait,"TAAthread:" path if the stub
2507 doesn't support qC. This is the first stop reported
2508 after an attach, so this is the main thread. Update the
2509 ptid in the thread list. */
2510 thread_change_ptid (this, inferior_ptid
, currthread
);
2514 /* When connecting to a target remote, or to a target
2515 extended-remote which already was debugging an inferior, we
2516 may not know about it yet. Add it before adding its child
2517 thread, so notifications are emitted in a sensible order. */
2518 if (find_inferior_pid (this, currthread
.pid ()) == NULL
)
2520 struct remote_state
*rs
= get_remote_state ();
2521 bool fake_pid_p
= !remote_multi_process_p (rs
);
2523 inf
= remote_add_inferior (fake_pid_p
,
2524 currthread
.pid (), -1, 1);
2527 /* This is really a new thread. Add it. */
2528 thread_info
*new_thr
2529 = remote_add_thread (currthread
, running
, executing
);
2531 /* If we found a new inferior, let the common code do whatever
2532 it needs to with it (e.g., read shared libraries, insert
2533 breakpoints), unless we're just setting up an all-stop
2537 struct remote_state
*rs
= get_remote_state ();
2539 if (!rs
->starting_up
)
2540 notice_new_inferior (new_thr
, executing
, 0);
2545 /* Return THREAD's private thread data, creating it if necessary. */
2547 static remote_thread_info
*
2548 get_remote_thread_info (thread_info
*thread
)
2550 gdb_assert (thread
!= NULL
);
2552 if (thread
->priv
== NULL
)
2553 thread
->priv
.reset (new remote_thread_info
);
2555 return static_cast<remote_thread_info
*> (thread
->priv
.get ());
2558 /* Return PTID's private thread data, creating it if necessary. */
2560 static remote_thread_info
*
2561 get_remote_thread_info (remote_target
*target
, ptid_t ptid
)
2563 thread_info
*thr
= find_thread_ptid (target
, ptid
);
2564 return get_remote_thread_info (thr
);
2567 /* Call this function as a result of
2568 1) A halt indication (T packet) containing a thread id
2569 2) A direct query of currthread
2570 3) Successful execution of set thread */
2573 record_currthread (struct remote_state
*rs
, ptid_t currthread
)
2575 rs
->general_thread
= currthread
;
2578 /* If 'QPassSignals' is supported, tell the remote stub what signals
2579 it can simply pass through to the inferior without reporting. */
2582 remote_target::pass_signals (gdb::array_view
<const unsigned char> pass_signals
)
2584 if (packet_support (PACKET_QPassSignals
) != PACKET_DISABLE
)
2586 char *pass_packet
, *p
;
2588 struct remote_state
*rs
= get_remote_state ();
2590 gdb_assert (pass_signals
.size () < 256);
2591 for (size_t i
= 0; i
< pass_signals
.size (); i
++)
2593 if (pass_signals
[i
])
2596 pass_packet
= (char *) xmalloc (count
* 3 + strlen ("QPassSignals:") + 1);
2597 strcpy (pass_packet
, "QPassSignals:");
2598 p
= pass_packet
+ strlen (pass_packet
);
2599 for (size_t i
= 0; i
< pass_signals
.size (); i
++)
2601 if (pass_signals
[i
])
2604 *p
++ = tohex (i
>> 4);
2605 *p
++ = tohex (i
& 15);
2614 if (!rs
->last_pass_packet
|| strcmp (rs
->last_pass_packet
, pass_packet
))
2616 putpkt (pass_packet
);
2617 getpkt (&rs
->buf
, 0);
2618 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QPassSignals
]);
2619 xfree (rs
->last_pass_packet
);
2620 rs
->last_pass_packet
= pass_packet
;
2623 xfree (pass_packet
);
2627 /* If 'QCatchSyscalls' is supported, tell the remote stub
2628 to report syscalls to GDB. */
2631 remote_target::set_syscall_catchpoint (int pid
, bool needed
, int any_count
,
2632 gdb::array_view
<const int> syscall_counts
)
2634 const char *catch_packet
;
2635 enum packet_result result
;
2638 if (packet_support (PACKET_QCatchSyscalls
) == PACKET_DISABLE
)
2640 /* Not supported. */
2644 if (needed
&& any_count
== 0)
2646 /* Count how many syscalls are to be caught. */
2647 for (size_t i
= 0; i
< syscall_counts
.size (); i
++)
2649 if (syscall_counts
[i
] != 0)
2656 fprintf_unfiltered (gdb_stdlog
,
2657 "remote_set_syscall_catchpoint "
2658 "pid %d needed %d any_count %d n_sysno %d\n",
2659 pid
, needed
, any_count
, n_sysno
);
2662 std::string built_packet
;
2665 /* Prepare a packet with the sysno list, assuming max 8+1
2666 characters for a sysno. If the resulting packet size is too
2667 big, fallback on the non-selective packet. */
2668 const int maxpktsz
= strlen ("QCatchSyscalls:1") + n_sysno
* 9 + 1;
2669 built_packet
.reserve (maxpktsz
);
2670 built_packet
= "QCatchSyscalls:1";
2673 /* Add in each syscall to be caught. */
2674 for (size_t i
= 0; i
< syscall_counts
.size (); i
++)
2676 if (syscall_counts
[i
] != 0)
2677 string_appendf (built_packet
, ";%zx", i
);
2680 if (built_packet
.size () > get_remote_packet_size ())
2682 /* catch_packet too big. Fallback to less efficient
2683 non selective mode, with GDB doing the filtering. */
2684 catch_packet
= "QCatchSyscalls:1";
2687 catch_packet
= built_packet
.c_str ();
2690 catch_packet
= "QCatchSyscalls:0";
2692 struct remote_state
*rs
= get_remote_state ();
2694 putpkt (catch_packet
);
2695 getpkt (&rs
->buf
, 0);
2696 result
= packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QCatchSyscalls
]);
2697 if (result
== PACKET_OK
)
2703 /* If 'QProgramSignals' is supported, tell the remote stub what
2704 signals it should pass through to the inferior when detaching. */
2707 remote_target::program_signals (gdb::array_view
<const unsigned char> signals
)
2709 if (packet_support (PACKET_QProgramSignals
) != PACKET_DISABLE
)
2713 struct remote_state
*rs
= get_remote_state ();
2715 gdb_assert (signals
.size () < 256);
2716 for (size_t i
= 0; i
< signals
.size (); i
++)
2721 packet
= (char *) xmalloc (count
* 3 + strlen ("QProgramSignals:") + 1);
2722 strcpy (packet
, "QProgramSignals:");
2723 p
= packet
+ strlen (packet
);
2724 for (size_t i
= 0; i
< signals
.size (); i
++)
2726 if (signal_pass_state (i
))
2729 *p
++ = tohex (i
>> 4);
2730 *p
++ = tohex (i
& 15);
2739 if (!rs
->last_program_signals_packet
2740 || strcmp (rs
->last_program_signals_packet
, packet
) != 0)
2743 getpkt (&rs
->buf
, 0);
2744 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QProgramSignals
]);
2745 xfree (rs
->last_program_signals_packet
);
2746 rs
->last_program_signals_packet
= packet
;
2753 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
2754 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
2755 thread. If GEN is set, set the general thread, if not, then set
2756 the step/continue thread. */
2758 remote_target::set_thread (ptid_t ptid
, int gen
)
2760 struct remote_state
*rs
= get_remote_state ();
2761 ptid_t state
= gen
? rs
->general_thread
: rs
->continue_thread
;
2762 char *buf
= rs
->buf
.data ();
2763 char *endbuf
= buf
+ get_remote_packet_size ();
2769 *buf
++ = gen
? 'g' : 'c';
2770 if (ptid
== magic_null_ptid
)
2771 xsnprintf (buf
, endbuf
- buf
, "0");
2772 else if (ptid
== any_thread_ptid
)
2773 xsnprintf (buf
, endbuf
- buf
, "0");
2774 else if (ptid
== minus_one_ptid
)
2775 xsnprintf (buf
, endbuf
- buf
, "-1");
2777 write_ptid (buf
, endbuf
, ptid
);
2779 getpkt (&rs
->buf
, 0);
2781 rs
->general_thread
= ptid
;
2783 rs
->continue_thread
= ptid
;
2787 remote_target::set_general_thread (ptid_t ptid
)
2789 set_thread (ptid
, 1);
2793 remote_target::set_continue_thread (ptid_t ptid
)
2795 set_thread (ptid
, 0);
2798 /* Change the remote current process. Which thread within the process
2799 ends up selected isn't important, as long as it is the same process
2800 as what INFERIOR_PTID points to.
2802 This comes from that fact that there is no explicit notion of
2803 "selected process" in the protocol. The selected process for
2804 general operations is the process the selected general thread
2808 remote_target::set_general_process ()
2810 struct remote_state
*rs
= get_remote_state ();
2812 /* If the remote can't handle multiple processes, don't bother. */
2813 if (!remote_multi_process_p (rs
))
2816 /* We only need to change the remote current thread if it's pointing
2817 at some other process. */
2818 if (rs
->general_thread
.pid () != inferior_ptid
.pid ())
2819 set_general_thread (inferior_ptid
);
2823 /* Return nonzero if this is the main thread that we made up ourselves
2824 to model non-threaded targets as single-threaded. */
2827 remote_thread_always_alive (ptid_t ptid
)
2829 if (ptid
== magic_null_ptid
)
2830 /* The main thread is always alive. */
2833 if (ptid
.pid () != 0 && ptid
.lwp () == 0)
2834 /* The main thread is always alive. This can happen after a
2835 vAttach, if the remote side doesn't support
2842 /* Return nonzero if the thread PTID is still alive on the remote
2846 remote_target::thread_alive (ptid_t ptid
)
2848 struct remote_state
*rs
= get_remote_state ();
2851 /* Check if this is a thread that we made up ourselves to model
2852 non-threaded targets as single-threaded. */
2853 if (remote_thread_always_alive (ptid
))
2856 p
= rs
->buf
.data ();
2857 endp
= p
+ get_remote_packet_size ();
2860 write_ptid (p
, endp
, ptid
);
2863 getpkt (&rs
->buf
, 0);
2864 return (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K');
2867 /* Return a pointer to a thread name if we know it and NULL otherwise.
2868 The thread_info object owns the memory for the name. */
2871 remote_target::thread_name (struct thread_info
*info
)
2873 if (info
->priv
!= NULL
)
2875 const std::string
&name
= get_remote_thread_info (info
)->name
;
2876 return !name
.empty () ? name
.c_str () : NULL
;
2882 /* About these extended threadlist and threadinfo packets. They are
2883 variable length packets but, the fields within them are often fixed
2884 length. They are redundant enough to send over UDP as is the
2885 remote protocol in general. There is a matching unit test module
2888 /* WARNING: This threadref data structure comes from the remote O.S.,
2889 libstub protocol encoding, and remote.c. It is not particularly
2892 /* Right now, the internal structure is int. We want it to be bigger.
2893 Plan to fix this. */
2895 typedef int gdb_threadref
; /* Internal GDB thread reference. */
2897 /* gdb_ext_thread_info is an internal GDB data structure which is
2898 equivalent to the reply of the remote threadinfo packet. */
2900 struct gdb_ext_thread_info
2902 threadref threadid
; /* External form of thread reference. */
2903 int active
; /* Has state interesting to GDB?
2905 char display
[256]; /* Brief state display, name,
2906 blocked/suspended. */
2907 char shortname
[32]; /* To be used to name threads. */
2908 char more_display
[256]; /* Long info, statistics, queue depth,
2912 /* The volume of remote transfers can be limited by submitting
2913 a mask containing bits specifying the desired information.
2914 Use a union of these values as the 'selection' parameter to
2915 get_thread_info. FIXME: Make these TAG names more thread specific. */
2917 #define TAG_THREADID 1
2918 #define TAG_EXISTS 2
2919 #define TAG_DISPLAY 4
2920 #define TAG_THREADNAME 8
2921 #define TAG_MOREDISPLAY 16
2923 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
2925 static char *unpack_nibble (char *buf
, int *val
);
2927 static char *unpack_byte (char *buf
, int *value
);
2929 static char *pack_int (char *buf
, int value
);
2931 static char *unpack_int (char *buf
, int *value
);
2933 static char *unpack_string (char *src
, char *dest
, int length
);
2935 static char *pack_threadid (char *pkt
, threadref
*id
);
2937 static char *unpack_threadid (char *inbuf
, threadref
*id
);
2939 void int_to_threadref (threadref
*id
, int value
);
2941 static int threadref_to_int (threadref
*ref
);
2943 static void copy_threadref (threadref
*dest
, threadref
*src
);
2945 static int threadmatch (threadref
*dest
, threadref
*src
);
2947 static char *pack_threadinfo_request (char *pkt
, int mode
,
2950 static char *pack_threadlist_request (char *pkt
, int startflag
,
2952 threadref
*nextthread
);
2954 static int remote_newthread_step (threadref
*ref
, void *context
);
2957 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
2958 buffer we're allowed to write to. Returns
2959 BUF+CHARACTERS_WRITTEN. */
2962 remote_target::write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
)
2965 struct remote_state
*rs
= get_remote_state ();
2967 if (remote_multi_process_p (rs
))
2971 buf
+= xsnprintf (buf
, endbuf
- buf
, "p-%x.", -pid
);
2973 buf
+= xsnprintf (buf
, endbuf
- buf
, "p%x.", pid
);
2977 buf
+= xsnprintf (buf
, endbuf
- buf
, "-%x", -tid
);
2979 buf
+= xsnprintf (buf
, endbuf
- buf
, "%x", tid
);
2984 /* Extract a PTID from BUF. If non-null, OBUF is set to one past the
2985 last parsed char. Returns null_ptid if no thread id is found, and
2986 throws an error if the thread id has an invalid format. */
2989 read_ptid (const char *buf
, const char **obuf
)
2991 const char *p
= buf
;
2993 ULONGEST pid
= 0, tid
= 0;
2997 /* Multi-process ptid. */
2998 pp
= unpack_varlen_hex (p
+ 1, &pid
);
3000 error (_("invalid remote ptid: %s"), p
);
3003 pp
= unpack_varlen_hex (p
+ 1, &tid
);
3006 return ptid_t (pid
, tid
, 0);
3009 /* No multi-process. Just a tid. */
3010 pp
= unpack_varlen_hex (p
, &tid
);
3012 /* Return null_ptid when no thread id is found. */
3020 /* Since the stub is not sending a process id, then default to
3021 what's in inferior_ptid, unless it's null at this point. If so,
3022 then since there's no way to know the pid of the reported
3023 threads, use the magic number. */
3024 if (inferior_ptid
== null_ptid
)
3025 pid
= magic_null_ptid
.pid ();
3027 pid
= inferior_ptid
.pid ();
3031 return ptid_t (pid
, tid
, 0);
3037 if (ch
>= 'a' && ch
<= 'f')
3038 return ch
- 'a' + 10;
3039 if (ch
>= '0' && ch
<= '9')
3041 if (ch
>= 'A' && ch
<= 'F')
3042 return ch
- 'A' + 10;
3047 stub_unpack_int (char *buff
, int fieldlength
)
3054 nibble
= stubhex (*buff
++);
3058 retval
= retval
<< 4;
3064 unpack_nibble (char *buf
, int *val
)
3066 *val
= fromhex (*buf
++);
3071 unpack_byte (char *buf
, int *value
)
3073 *value
= stub_unpack_int (buf
, 2);
3078 pack_int (char *buf
, int value
)
3080 buf
= pack_hex_byte (buf
, (value
>> 24) & 0xff);
3081 buf
= pack_hex_byte (buf
, (value
>> 16) & 0xff);
3082 buf
= pack_hex_byte (buf
, (value
>> 8) & 0x0ff);
3083 buf
= pack_hex_byte (buf
, (value
& 0xff));
3088 unpack_int (char *buf
, int *value
)
3090 *value
= stub_unpack_int (buf
, 8);
3094 #if 0 /* Currently unused, uncomment when needed. */
3095 static char *pack_string (char *pkt
, char *string
);
3098 pack_string (char *pkt
, char *string
)
3103 len
= strlen (string
);
3105 len
= 200; /* Bigger than most GDB packets, junk??? */
3106 pkt
= pack_hex_byte (pkt
, len
);
3110 if ((ch
== '\0') || (ch
== '#'))
3111 ch
= '*'; /* Protect encapsulation. */
3116 #endif /* 0 (unused) */
3119 unpack_string (char *src
, char *dest
, int length
)
3128 pack_threadid (char *pkt
, threadref
*id
)
3131 unsigned char *altid
;
3133 altid
= (unsigned char *) id
;
3134 limit
= pkt
+ BUF_THREAD_ID_SIZE
;
3136 pkt
= pack_hex_byte (pkt
, *altid
++);
3142 unpack_threadid (char *inbuf
, threadref
*id
)
3145 char *limit
= inbuf
+ BUF_THREAD_ID_SIZE
;
3148 altref
= (char *) id
;
3150 while (inbuf
< limit
)
3152 x
= stubhex (*inbuf
++);
3153 y
= stubhex (*inbuf
++);
3154 *altref
++ = (x
<< 4) | y
;
3159 /* Externally, threadrefs are 64 bits but internally, they are still
3160 ints. This is due to a mismatch of specifications. We would like
3161 to use 64bit thread references internally. This is an adapter
3165 int_to_threadref (threadref
*id
, int value
)
3167 unsigned char *scan
;
3169 scan
= (unsigned char *) id
;
3175 *scan
++ = (value
>> 24) & 0xff;
3176 *scan
++ = (value
>> 16) & 0xff;
3177 *scan
++ = (value
>> 8) & 0xff;
3178 *scan
++ = (value
& 0xff);
3182 threadref_to_int (threadref
*ref
)
3185 unsigned char *scan
;
3191 value
= (value
<< 8) | ((*scan
++) & 0xff);
3196 copy_threadref (threadref
*dest
, threadref
*src
)
3199 unsigned char *csrc
, *cdest
;
3201 csrc
= (unsigned char *) src
;
3202 cdest
= (unsigned char *) dest
;
3209 threadmatch (threadref
*dest
, threadref
*src
)
3211 /* Things are broken right now, so just assume we got a match. */
3213 unsigned char *srcp
, *destp
;
3215 srcp
= (char *) src
;
3216 destp
= (char *) dest
;
3220 result
&= (*srcp
++ == *destp
++) ? 1 : 0;
3227 threadid:1, # always request threadid
3234 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
3237 pack_threadinfo_request (char *pkt
, int mode
, threadref
*id
)
3239 *pkt
++ = 'q'; /* Info Query */
3240 *pkt
++ = 'P'; /* process or thread info */
3241 pkt
= pack_int (pkt
, mode
); /* mode */
3242 pkt
= pack_threadid (pkt
, id
); /* threadid */
3243 *pkt
= '\0'; /* terminate */
3247 /* These values tag the fields in a thread info response packet. */
3248 /* Tagging the fields allows us to request specific fields and to
3249 add more fields as time goes by. */
3251 #define TAG_THREADID 1 /* Echo the thread identifier. */
3252 #define TAG_EXISTS 2 /* Is this process defined enough to
3253 fetch registers and its stack? */
3254 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
3255 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
3256 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
3260 remote_target::remote_unpack_thread_info_response (char *pkt
,
3261 threadref
*expectedref
,
3262 gdb_ext_thread_info
*info
)
3264 struct remote_state
*rs
= get_remote_state ();
3268 char *limit
= pkt
+ rs
->buf
.size (); /* Plausible parsing limit. */
3271 /* info->threadid = 0; FIXME: implement zero_threadref. */
3273 info
->display
[0] = '\0';
3274 info
->shortname
[0] = '\0';
3275 info
->more_display
[0] = '\0';
3277 /* Assume the characters indicating the packet type have been
3279 pkt
= unpack_int (pkt
, &mask
); /* arg mask */
3280 pkt
= unpack_threadid (pkt
, &ref
);
3283 warning (_("Incomplete response to threadinfo request."));
3284 if (!threadmatch (&ref
, expectedref
))
3285 { /* This is an answer to a different request. */
3286 warning (_("ERROR RMT Thread info mismatch."));
3289 copy_threadref (&info
->threadid
, &ref
);
3291 /* Loop on tagged fields , try to bail if something goes wrong. */
3293 /* Packets are terminated with nulls. */
3294 while ((pkt
< limit
) && mask
&& *pkt
)
3296 pkt
= unpack_int (pkt
, &tag
); /* tag */
3297 pkt
= unpack_byte (pkt
, &length
); /* length */
3298 if (!(tag
& mask
)) /* Tags out of synch with mask. */
3300 warning (_("ERROR RMT: threadinfo tag mismatch."));
3304 if (tag
== TAG_THREADID
)
3308 warning (_("ERROR RMT: length of threadid is not 16."));
3312 pkt
= unpack_threadid (pkt
, &ref
);
3313 mask
= mask
& ~TAG_THREADID
;
3316 if (tag
== TAG_EXISTS
)
3318 info
->active
= stub_unpack_int (pkt
, length
);
3320 mask
= mask
& ~(TAG_EXISTS
);
3323 warning (_("ERROR RMT: 'exists' length too long."));
3329 if (tag
== TAG_THREADNAME
)
3331 pkt
= unpack_string (pkt
, &info
->shortname
[0], length
);
3332 mask
= mask
& ~TAG_THREADNAME
;
3335 if (tag
== TAG_DISPLAY
)
3337 pkt
= unpack_string (pkt
, &info
->display
[0], length
);
3338 mask
= mask
& ~TAG_DISPLAY
;
3341 if (tag
== TAG_MOREDISPLAY
)
3343 pkt
= unpack_string (pkt
, &info
->more_display
[0], length
);
3344 mask
= mask
& ~TAG_MOREDISPLAY
;
3347 warning (_("ERROR RMT: unknown thread info tag."));
3348 break; /* Not a tag we know about. */
3354 remote_target::remote_get_threadinfo (threadref
*threadid
,
3356 gdb_ext_thread_info
*info
)
3358 struct remote_state
*rs
= get_remote_state ();
3361 pack_threadinfo_request (rs
->buf
.data (), fieldset
, threadid
);
3363 getpkt (&rs
->buf
, 0);
3365 if (rs
->buf
[0] == '\0')
3368 result
= remote_unpack_thread_info_response (&rs
->buf
[2],
3373 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
3376 pack_threadlist_request (char *pkt
, int startflag
, int threadcount
,
3377 threadref
*nextthread
)
3379 *pkt
++ = 'q'; /* info query packet */
3380 *pkt
++ = 'L'; /* Process LIST or threadLIST request */
3381 pkt
= pack_nibble (pkt
, startflag
); /* initflag 1 bytes */
3382 pkt
= pack_hex_byte (pkt
, threadcount
); /* threadcount 2 bytes */
3383 pkt
= pack_threadid (pkt
, nextthread
); /* 64 bit thread identifier */
3388 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
3391 remote_target::parse_threadlist_response (char *pkt
, int result_limit
,
3392 threadref
*original_echo
,
3393 threadref
*resultlist
,
3396 struct remote_state
*rs
= get_remote_state ();
3398 int count
, resultcount
, done
;
3401 /* Assume the 'q' and 'M chars have been stripped. */
3402 limit
= pkt
+ (rs
->buf
.size () - BUF_THREAD_ID_SIZE
);
3403 /* done parse past here */
3404 pkt
= unpack_byte (pkt
, &count
); /* count field */
3405 pkt
= unpack_nibble (pkt
, &done
);
3406 /* The first threadid is the argument threadid. */
3407 pkt
= unpack_threadid (pkt
, original_echo
); /* should match query packet */
3408 while ((count
-- > 0) && (pkt
< limit
))
3410 pkt
= unpack_threadid (pkt
, resultlist
++);
3411 if (resultcount
++ >= result_limit
)
3419 /* Fetch the next batch of threads from the remote. Returns -1 if the
3420 qL packet is not supported, 0 on error and 1 on success. */
3423 remote_target::remote_get_threadlist (int startflag
, threadref
*nextthread
,
3424 int result_limit
, int *done
, int *result_count
,
3425 threadref
*threadlist
)
3427 struct remote_state
*rs
= get_remote_state ();
3430 /* Truncate result limit to be smaller than the packet size. */
3431 if ((((result_limit
+ 1) * BUF_THREAD_ID_SIZE
) + 10)
3432 >= get_remote_packet_size ())
3433 result_limit
= (get_remote_packet_size () / BUF_THREAD_ID_SIZE
) - 2;
3435 pack_threadlist_request (rs
->buf
.data (), startflag
, result_limit
,
3438 getpkt (&rs
->buf
, 0);
3439 if (rs
->buf
[0] == '\0')
3441 /* Packet not supported. */
3446 parse_threadlist_response (&rs
->buf
[2], result_limit
,
3447 &rs
->echo_nextthread
, threadlist
, done
);
3449 if (!threadmatch (&rs
->echo_nextthread
, nextthread
))
3451 /* FIXME: This is a good reason to drop the packet. */
3452 /* Possibly, there is a duplicate response. */
3454 retransmit immediatly - race conditions
3455 retransmit after timeout - yes
3457 wait for packet, then exit
3459 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
3460 return 0; /* I choose simply exiting. */
3462 if (*result_count
<= 0)
3466 warning (_("RMT ERROR : failed to get remote thread list."));
3469 return result
; /* break; */
3471 if (*result_count
> result_limit
)
3474 warning (_("RMT ERROR: threadlist response longer than requested."));
3480 /* Fetch the list of remote threads, with the qL packet, and call
3481 STEPFUNCTION for each thread found. Stops iterating and returns 1
3482 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
3483 STEPFUNCTION returns false. If the packet is not supported,
3487 remote_target::remote_threadlist_iterator (rmt_thread_action stepfunction
,
3488 void *context
, int looplimit
)
3490 struct remote_state
*rs
= get_remote_state ();
3491 int done
, i
, result_count
;
3499 if (loopcount
++ > looplimit
)
3502 warning (_("Remote fetch threadlist -infinite loop-."));
3505 result
= remote_get_threadlist (startflag
, &rs
->nextthread
,
3506 MAXTHREADLISTRESULTS
,
3507 &done
, &result_count
,
3508 rs
->resultthreadlist
);
3511 /* Clear for later iterations. */
3513 /* Setup to resume next batch of thread references, set nextthread. */
3514 if (result_count
>= 1)
3515 copy_threadref (&rs
->nextthread
,
3516 &rs
->resultthreadlist
[result_count
- 1]);
3518 while (result_count
--)
3520 if (!(*stepfunction
) (&rs
->resultthreadlist
[i
++], context
))
3530 /* A thread found on the remote target. */
3534 explicit thread_item (ptid_t ptid_
)
3538 thread_item (thread_item
&&other
) = default;
3539 thread_item
&operator= (thread_item
&&other
) = default;
3541 DISABLE_COPY_AND_ASSIGN (thread_item
);
3543 /* The thread's PTID. */
3546 /* The thread's extra info. */
3549 /* The thread's name. */
3552 /* The core the thread was running on. -1 if not known. */
3555 /* The thread handle associated with the thread. */
3556 gdb::byte_vector thread_handle
;
3559 /* Context passed around to the various methods listing remote
3560 threads. As new threads are found, they're added to the ITEMS
3563 struct threads_listing_context
3565 /* Return true if this object contains an entry for a thread with ptid
3568 bool contains_thread (ptid_t ptid
) const
3570 auto match_ptid
= [&] (const thread_item
&item
)
3572 return item
.ptid
== ptid
;
3575 auto it
= std::find_if (this->items
.begin (),
3579 return it
!= this->items
.end ();
3582 /* Remove the thread with ptid PTID. */
3584 void remove_thread (ptid_t ptid
)
3586 auto match_ptid
= [&] (const thread_item
&item
)
3588 return item
.ptid
== ptid
;
3591 auto it
= std::remove_if (this->items
.begin (),
3595 if (it
!= this->items
.end ())
3596 this->items
.erase (it
);
3599 /* The threads found on the remote target. */
3600 std::vector
<thread_item
> items
;
3604 remote_newthread_step (threadref
*ref
, void *data
)
3606 struct threads_listing_context
*context
3607 = (struct threads_listing_context
*) data
;
3608 int pid
= inferior_ptid
.pid ();
3609 int lwp
= threadref_to_int (ref
);
3610 ptid_t
ptid (pid
, lwp
);
3612 context
->items
.emplace_back (ptid
);
3614 return 1; /* continue iterator */
3617 #define CRAZY_MAX_THREADS 1000
3620 remote_target::remote_current_thread (ptid_t oldpid
)
3622 struct remote_state
*rs
= get_remote_state ();
3625 getpkt (&rs
->buf
, 0);
3626 if (rs
->buf
[0] == 'Q' && rs
->buf
[1] == 'C')
3631 result
= read_ptid (&rs
->buf
[2], &obuf
);
3632 if (*obuf
!= '\0' && remote_debug
)
3633 fprintf_unfiltered (gdb_stdlog
,
3634 "warning: garbage in qC reply\n");
3642 /* List remote threads using the deprecated qL packet. */
3645 remote_target::remote_get_threads_with_ql (threads_listing_context
*context
)
3647 if (remote_threadlist_iterator (remote_newthread_step
, context
,
3648 CRAZY_MAX_THREADS
) >= 0)
3654 #if defined(HAVE_LIBEXPAT)
3657 start_thread (struct gdb_xml_parser
*parser
,
3658 const struct gdb_xml_element
*element
,
3660 std::vector
<gdb_xml_value
> &attributes
)
3662 struct threads_listing_context
*data
3663 = (struct threads_listing_context
*) user_data
;
3664 struct gdb_xml_value
*attr
;
3666 char *id
= (char *) xml_find_attribute (attributes
, "id")->value
.get ();
3667 ptid_t ptid
= read_ptid (id
, NULL
);
3669 data
->items
.emplace_back (ptid
);
3670 thread_item
&item
= data
->items
.back ();
3672 attr
= xml_find_attribute (attributes
, "core");
3674 item
.core
= *(ULONGEST
*) attr
->value
.get ();
3676 attr
= xml_find_attribute (attributes
, "name");
3678 item
.name
= (const char *) attr
->value
.get ();
3680 attr
= xml_find_attribute (attributes
, "handle");
3682 item
.thread_handle
= hex2bin ((const char *) attr
->value
.get ());
3686 end_thread (struct gdb_xml_parser
*parser
,
3687 const struct gdb_xml_element
*element
,
3688 void *user_data
, const char *body_text
)
3690 struct threads_listing_context
*data
3691 = (struct threads_listing_context
*) user_data
;
3693 if (body_text
!= NULL
&& *body_text
!= '\0')
3694 data
->items
.back ().extra
= body_text
;
3697 const struct gdb_xml_attribute thread_attributes
[] = {
3698 { "id", GDB_XML_AF_NONE
, NULL
, NULL
},
3699 { "core", GDB_XML_AF_OPTIONAL
, gdb_xml_parse_attr_ulongest
, NULL
},
3700 { "name", GDB_XML_AF_OPTIONAL
, NULL
, NULL
},
3701 { "handle", GDB_XML_AF_OPTIONAL
, NULL
, NULL
},
3702 { NULL
, GDB_XML_AF_NONE
, NULL
, NULL
}
3705 const struct gdb_xml_element thread_children
[] = {
3706 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3709 const struct gdb_xml_element threads_children
[] = {
3710 { "thread", thread_attributes
, thread_children
,
3711 GDB_XML_EF_REPEATABLE
| GDB_XML_EF_OPTIONAL
,
3712 start_thread
, end_thread
},
3713 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3716 const struct gdb_xml_element threads_elements
[] = {
3717 { "threads", NULL
, threads_children
,
3718 GDB_XML_EF_NONE
, NULL
, NULL
},
3719 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3724 /* List remote threads using qXfer:threads:read. */
3727 remote_target::remote_get_threads_with_qxfer (threads_listing_context
*context
)
3729 #if defined(HAVE_LIBEXPAT)
3730 if (packet_support (PACKET_qXfer_threads
) == PACKET_ENABLE
)
3732 gdb::optional
<gdb::char_vector
> xml
3733 = target_read_stralloc (this, TARGET_OBJECT_THREADS
, NULL
);
3735 if (xml
&& (*xml
)[0] != '\0')
3737 gdb_xml_parse_quick (_("threads"), "threads.dtd",
3738 threads_elements
, xml
->data (), context
);
3748 /* List remote threads using qfThreadInfo/qsThreadInfo. */
3751 remote_target::remote_get_threads_with_qthreadinfo (threads_listing_context
*context
)
3753 struct remote_state
*rs
= get_remote_state ();
3755 if (rs
->use_threadinfo_query
)
3759 putpkt ("qfThreadInfo");
3760 getpkt (&rs
->buf
, 0);
3761 bufp
= rs
->buf
.data ();
3762 if (bufp
[0] != '\0') /* q packet recognized */
3764 while (*bufp
++ == 'm') /* reply contains one or more TID */
3768 ptid_t ptid
= read_ptid (bufp
, &bufp
);
3769 context
->items
.emplace_back (ptid
);
3771 while (*bufp
++ == ','); /* comma-separated list */
3772 putpkt ("qsThreadInfo");
3773 getpkt (&rs
->buf
, 0);
3774 bufp
= rs
->buf
.data ();
3780 /* Packet not recognized. */
3781 rs
->use_threadinfo_query
= 0;
3788 /* Return true if INF only has one non-exited thread. */
3791 has_single_non_exited_thread (inferior
*inf
)
3794 for (thread_info
*tp ATTRIBUTE_UNUSED
: inf
->non_exited_threads ())
3800 /* Implement the to_update_thread_list function for the remote
3804 remote_target::update_thread_list ()
3806 struct threads_listing_context context
;
3809 /* We have a few different mechanisms to fetch the thread list. Try
3810 them all, starting with the most preferred one first, falling
3811 back to older methods. */
3812 if (remote_get_threads_with_qxfer (&context
)
3813 || remote_get_threads_with_qthreadinfo (&context
)
3814 || remote_get_threads_with_ql (&context
))
3818 if (context
.items
.empty ()
3819 && remote_thread_always_alive (inferior_ptid
))
3821 /* Some targets don't really support threads, but still
3822 reply an (empty) thread list in response to the thread
3823 listing packets, instead of replying "packet not
3824 supported". Exit early so we don't delete the main
3829 /* CONTEXT now holds the current thread list on the remote
3830 target end. Delete GDB-side threads no longer found on the
3832 for (thread_info
*tp
: all_threads_safe ())
3834 if (tp
->inf
->process_target () != this)
3837 if (!context
.contains_thread (tp
->ptid
))
3839 /* Do not remove the thread if it is the last thread in
3840 the inferior. This situation happens when we have a
3841 pending exit process status to process. Otherwise we
3842 may end up with a seemingly live inferior (i.e. pid
3843 != 0) that has no threads. */
3844 if (has_single_non_exited_thread (tp
->inf
))
3852 /* Remove any unreported fork child threads from CONTEXT so
3853 that we don't interfere with follow fork, which is where
3854 creation of such threads is handled. */
3855 remove_new_fork_children (&context
);
3857 /* And now add threads we don't know about yet to our list. */
3858 for (thread_item
&item
: context
.items
)
3860 if (item
.ptid
!= null_ptid
)
3862 /* In non-stop mode, we assume new found threads are
3863 executing until proven otherwise with a stop reply.
3864 In all-stop, we can only get here if all threads are
3866 int executing
= target_is_non_stop_p () ? 1 : 0;
3868 remote_notice_new_inferior (item
.ptid
, executing
);
3870 thread_info
*tp
= find_thread_ptid (this, item
.ptid
);
3871 remote_thread_info
*info
= get_remote_thread_info (tp
);
3872 info
->core
= item
.core
;
3873 info
->extra
= std::move (item
.extra
);
3874 info
->name
= std::move (item
.name
);
3875 info
->thread_handle
= std::move (item
.thread_handle
);
3882 /* If no thread listing method is supported, then query whether
3883 each known thread is alive, one by one, with the T packet.
3884 If the target doesn't support threads at all, then this is a
3885 no-op. See remote_thread_alive. */
3891 * Collect a descriptive string about the given thread.
3892 * The target may say anything it wants to about the thread
3893 * (typically info about its blocked / runnable state, name, etc.).
3894 * This string will appear in the info threads display.
3896 * Optional: targets are not required to implement this function.
3900 remote_target::extra_thread_info (thread_info
*tp
)
3902 struct remote_state
*rs
= get_remote_state ();
3905 struct gdb_ext_thread_info threadinfo
;
3907 if (rs
->remote_desc
== 0) /* paranoia */
3908 internal_error (__FILE__
, __LINE__
,
3909 _("remote_threads_extra_info"));
3911 if (tp
->ptid
== magic_null_ptid
3912 || (tp
->ptid
.pid () != 0 && tp
->ptid
.lwp () == 0))
3913 /* This is the main thread which was added by GDB. The remote
3914 server doesn't know about it. */
3917 std::string
&extra
= get_remote_thread_info (tp
)->extra
;
3919 /* If already have cached info, use it. */
3920 if (!extra
.empty ())
3921 return extra
.c_str ();
3923 if (packet_support (PACKET_qXfer_threads
) == PACKET_ENABLE
)
3925 /* If we're using qXfer:threads:read, then the extra info is
3926 included in the XML. So if we didn't have anything cached,
3927 it's because there's really no extra info. */
3931 if (rs
->use_threadextra_query
)
3933 char *b
= rs
->buf
.data ();
3934 char *endb
= b
+ get_remote_packet_size ();
3936 xsnprintf (b
, endb
- b
, "qThreadExtraInfo,");
3938 write_ptid (b
, endb
, tp
->ptid
);
3941 getpkt (&rs
->buf
, 0);
3942 if (rs
->buf
[0] != 0)
3944 extra
.resize (strlen (rs
->buf
.data ()) / 2);
3945 hex2bin (rs
->buf
.data (), (gdb_byte
*) &extra
[0], extra
.size ());
3946 return extra
.c_str ();
3950 /* If the above query fails, fall back to the old method. */
3951 rs
->use_threadextra_query
= 0;
3952 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
3953 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
3954 int_to_threadref (&id
, tp
->ptid
.lwp ());
3955 if (remote_get_threadinfo (&id
, set
, &threadinfo
))
3956 if (threadinfo
.active
)
3958 if (*threadinfo
.shortname
)
3959 string_appendf (extra
, " Name: %s", threadinfo
.shortname
);
3960 if (*threadinfo
.display
)
3962 if (!extra
.empty ())
3964 string_appendf (extra
, " State: %s", threadinfo
.display
);
3966 if (*threadinfo
.more_display
)
3968 if (!extra
.empty ())
3970 string_appendf (extra
, " Priority: %s", threadinfo
.more_display
);
3972 return extra
.c_str ();
3979 remote_target::static_tracepoint_marker_at (CORE_ADDR addr
,
3980 struct static_tracepoint_marker
*marker
)
3982 struct remote_state
*rs
= get_remote_state ();
3983 char *p
= rs
->buf
.data ();
3985 xsnprintf (p
, get_remote_packet_size (), "qTSTMat:");
3987 p
+= hexnumstr (p
, addr
);
3989 getpkt (&rs
->buf
, 0);
3990 p
= rs
->buf
.data ();
3993 error (_("Remote failure reply: %s"), p
);
3997 parse_static_tracepoint_marker_definition (p
, NULL
, marker
);
4004 std::vector
<static_tracepoint_marker
>
4005 remote_target::static_tracepoint_markers_by_strid (const char *strid
)
4007 struct remote_state
*rs
= get_remote_state ();
4008 std::vector
<static_tracepoint_marker
> markers
;
4010 static_tracepoint_marker marker
;
4012 /* Ask for a first packet of static tracepoint marker
4015 getpkt (&rs
->buf
, 0);
4016 p
= rs
->buf
.data ();
4018 error (_("Remote failure reply: %s"), p
);
4024 parse_static_tracepoint_marker_definition (p
, &p
, &marker
);
4026 if (strid
== NULL
|| marker
.str_id
== strid
)
4027 markers
.push_back (std::move (marker
));
4029 while (*p
++ == ','); /* comma-separated list */
4030 /* Ask for another packet of static tracepoint definition. */
4032 getpkt (&rs
->buf
, 0);
4033 p
= rs
->buf
.data ();
4040 /* Implement the to_get_ada_task_ptid function for the remote targets. */
4043 remote_target::get_ada_task_ptid (long lwp
, long thread
)
4045 return ptid_t (inferior_ptid
.pid (), lwp
, 0);
4049 /* Restart the remote side; this is an extended protocol operation. */
4052 remote_target::extended_remote_restart ()
4054 struct remote_state
*rs
= get_remote_state ();
4056 /* Send the restart command; for reasons I don't understand the
4057 remote side really expects a number after the "R". */
4058 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "R%x", 0);
4061 remote_fileio_reset ();
4064 /* Clean up connection to a remote debugger. */
4067 remote_target::close ()
4069 /* Make sure we leave stdin registered in the event loop. */
4072 trace_reset_local_state ();
4077 remote_target::~remote_target ()
4079 struct remote_state
*rs
= get_remote_state ();
4081 /* Check for NULL because we may get here with a partially
4082 constructed target/connection. */
4083 if (rs
->remote_desc
== nullptr)
4086 serial_close (rs
->remote_desc
);
4088 /* We are destroying the remote target, so we should discard
4089 everything of this target. */
4090 discard_pending_stop_replies_in_queue ();
4092 if (rs
->remote_async_inferior_event_token
)
4093 delete_async_event_handler (&rs
->remote_async_inferior_event_token
);
4095 delete rs
->notif_state
;
4098 /* Query the remote side for the text, data and bss offsets. */
4101 remote_target::get_offsets ()
4103 struct remote_state
*rs
= get_remote_state ();
4106 int lose
, num_segments
= 0, do_sections
, do_segments
;
4107 CORE_ADDR text_addr
, data_addr
, bss_addr
, segments
[2];
4109 if (symfile_objfile
== NULL
)
4112 putpkt ("qOffsets");
4113 getpkt (&rs
->buf
, 0);
4114 buf
= rs
->buf
.data ();
4116 if (buf
[0] == '\000')
4117 return; /* Return silently. Stub doesn't support
4121 warning (_("Remote failure reply: %s"), buf
);
4125 /* Pick up each field in turn. This used to be done with scanf, but
4126 scanf will make trouble if CORE_ADDR size doesn't match
4127 conversion directives correctly. The following code will work
4128 with any size of CORE_ADDR. */
4129 text_addr
= data_addr
= bss_addr
= 0;
4133 if (startswith (ptr
, "Text="))
4136 /* Don't use strtol, could lose on big values. */
4137 while (*ptr
&& *ptr
!= ';')
4138 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
4140 if (startswith (ptr
, ";Data="))
4143 while (*ptr
&& *ptr
!= ';')
4144 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
4149 if (!lose
&& startswith (ptr
, ";Bss="))
4152 while (*ptr
&& *ptr
!= ';')
4153 bss_addr
= (bss_addr
<< 4) + fromhex (*ptr
++);
4155 if (bss_addr
!= data_addr
)
4156 warning (_("Target reported unsupported offsets: %s"), buf
);
4161 else if (startswith (ptr
, "TextSeg="))
4164 /* Don't use strtol, could lose on big values. */
4165 while (*ptr
&& *ptr
!= ';')
4166 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
4169 if (startswith (ptr
, ";DataSeg="))
4172 while (*ptr
&& *ptr
!= ';')
4173 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
4181 error (_("Malformed response to offset query, %s"), buf
);
4182 else if (*ptr
!= '\0')
4183 warning (_("Target reported unsupported offsets: %s"), buf
);
4185 section_offsets offs
= symfile_objfile
->section_offsets
;
4187 symfile_segment_data_up data
4188 = get_symfile_segment_data (symfile_objfile
->obfd
);
4189 do_segments
= (data
!= NULL
);
4190 do_sections
= num_segments
== 0;
4192 if (num_segments
> 0)
4194 segments
[0] = text_addr
;
4195 segments
[1] = data_addr
;
4197 /* If we have two segments, we can still try to relocate everything
4198 by assuming that the .text and .data offsets apply to the whole
4199 text and data segments. Convert the offsets given in the packet
4200 to base addresses for symfile_map_offsets_to_segments. */
4201 else if (data
!= nullptr && data
->segments
.size () == 2)
4203 segments
[0] = data
->segments
[0].base
+ text_addr
;
4204 segments
[1] = data
->segments
[1].base
+ data_addr
;
4207 /* If the object file has only one segment, assume that it is text
4208 rather than data; main programs with no writable data are rare,
4209 but programs with no code are useless. Of course the code might
4210 have ended up in the data segment... to detect that we would need
4211 the permissions here. */
4212 else if (data
&& data
->segments
.size () == 1)
4214 segments
[0] = data
->segments
[0].base
+ text_addr
;
4217 /* There's no way to relocate by segment. */
4223 int ret
= symfile_map_offsets_to_segments (symfile_objfile
->obfd
,
4225 num_segments
, segments
);
4227 if (ret
== 0 && !do_sections
)
4228 error (_("Can not handle qOffsets TextSeg "
4229 "response with this symbol file"));
4237 offs
[SECT_OFF_TEXT (symfile_objfile
)] = text_addr
;
4239 /* This is a temporary kludge to force data and bss to use the
4240 same offsets because that's what nlmconv does now. The real
4241 solution requires changes to the stub and remote.c that I
4242 don't have time to do right now. */
4244 offs
[SECT_OFF_DATA (symfile_objfile
)] = data_addr
;
4245 offs
[SECT_OFF_BSS (symfile_objfile
)] = data_addr
;
4248 objfile_relocate (symfile_objfile
, offs
);
4251 /* Send interrupt_sequence to remote target. */
4254 remote_target::send_interrupt_sequence ()
4256 struct remote_state
*rs
= get_remote_state ();
4258 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
4259 remote_serial_write ("\x03", 1);
4260 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
4261 serial_send_break (rs
->remote_desc
);
4262 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
4264 serial_send_break (rs
->remote_desc
);
4265 remote_serial_write ("g", 1);
4268 internal_error (__FILE__
, __LINE__
,
4269 _("Invalid value for interrupt_sequence_mode: %s."),
4270 interrupt_sequence_mode
);
4274 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
4275 and extract the PTID. Returns NULL_PTID if not found. */
4278 stop_reply_extract_thread (char *stop_reply
)
4280 if (stop_reply
[0] == 'T' && strlen (stop_reply
) > 3)
4284 /* Txx r:val ; r:val (...) */
4287 /* Look for "register" named "thread". */
4292 p1
= strchr (p
, ':');
4296 if (strncmp (p
, "thread", p1
- p
) == 0)
4297 return read_ptid (++p1
, &p
);
4299 p1
= strchr (p
, ';');
4311 /* Determine the remote side's current thread. If we have a stop
4312 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
4313 "thread" register we can extract the current thread from. If not,
4314 ask the remote which is the current thread with qC. The former
4315 method avoids a roundtrip. */
4318 remote_target::get_current_thread (char *wait_status
)
4320 ptid_t ptid
= null_ptid
;
4322 /* Note we don't use remote_parse_stop_reply as that makes use of
4323 the target architecture, which we haven't yet fully determined at
4325 if (wait_status
!= NULL
)
4326 ptid
= stop_reply_extract_thread (wait_status
);
4327 if (ptid
== null_ptid
)
4328 ptid
= remote_current_thread (inferior_ptid
);
4333 /* Query the remote target for which is the current thread/process,
4334 add it to our tables, and update INFERIOR_PTID. The caller is
4335 responsible for setting the state such that the remote end is ready
4336 to return the current thread.
4338 This function is called after handling the '?' or 'vRun' packets,
4339 whose response is a stop reply from which we can also try
4340 extracting the thread. If the target doesn't support the explicit
4341 qC query, we infer the current thread from that stop reply, passed
4342 in in WAIT_STATUS, which may be NULL. */
4345 remote_target::add_current_inferior_and_thread (char *wait_status
)
4347 struct remote_state
*rs
= get_remote_state ();
4348 bool fake_pid_p
= false;
4350 switch_to_no_thread ();
4352 /* Now, if we have thread information, update the current thread's
4354 ptid_t curr_ptid
= get_current_thread (wait_status
);
4356 if (curr_ptid
!= null_ptid
)
4358 if (!remote_multi_process_p (rs
))
4363 /* Without this, some commands which require an active target
4364 (such as kill) won't work. This variable serves (at least)
4365 double duty as both the pid of the target process (if it has
4366 such), and as a flag indicating that a target is active. */
4367 curr_ptid
= magic_null_ptid
;
4371 remote_add_inferior (fake_pid_p
, curr_ptid
.pid (), -1, 1);
4373 /* Add the main thread and switch to it. Don't try reading
4374 registers yet, since we haven't fetched the target description
4376 thread_info
*tp
= add_thread_silent (this, curr_ptid
);
4377 switch_to_thread_no_regs (tp
);
4380 /* Print info about a thread that was found already stopped on
4384 print_one_stopped_thread (struct thread_info
*thread
)
4386 struct target_waitstatus
*ws
= &thread
->suspend
.waitstatus
;
4388 switch_to_thread (thread
);
4389 thread
->suspend
.stop_pc
= get_frame_pc (get_current_frame ());
4390 set_current_sal_from_frame (get_current_frame ());
4392 thread
->suspend
.waitstatus_pending_p
= 0;
4394 if (ws
->kind
== TARGET_WAITKIND_STOPPED
)
4396 enum gdb_signal sig
= ws
->value
.sig
;
4398 if (signal_print_state (sig
))
4399 gdb::observers::signal_received
.notify (sig
);
4401 gdb::observers::normal_stop
.notify (NULL
, 1);
4404 /* Process all initial stop replies the remote side sent in response
4405 to the ? packet. These indicate threads that were already stopped
4406 on initial connection. We mark these threads as stopped and print
4407 their current frame before giving the user the prompt. */
4410 remote_target::process_initial_stop_replies (int from_tty
)
4412 int pending_stop_replies
= stop_reply_queue_length ();
4413 struct thread_info
*selected
= NULL
;
4414 struct thread_info
*lowest_stopped
= NULL
;
4415 struct thread_info
*first
= NULL
;
4417 /* Consume the initial pending events. */
4418 while (pending_stop_replies
-- > 0)
4420 ptid_t waiton_ptid
= minus_one_ptid
;
4422 struct target_waitstatus ws
;
4423 int ignore_event
= 0;
4425 memset (&ws
, 0, sizeof (ws
));
4426 event_ptid
= target_wait (waiton_ptid
, &ws
, TARGET_WNOHANG
);
4428 print_target_wait_results (waiton_ptid
, event_ptid
, &ws
);
4432 case TARGET_WAITKIND_IGNORE
:
4433 case TARGET_WAITKIND_NO_RESUMED
:
4434 case TARGET_WAITKIND_SIGNALLED
:
4435 case TARGET_WAITKIND_EXITED
:
4436 /* We shouldn't see these, but if we do, just ignore. */
4438 fprintf_unfiltered (gdb_stdlog
, "remote: event ignored\n");
4442 case TARGET_WAITKIND_EXECD
:
4443 xfree (ws
.value
.execd_pathname
);
4452 thread_info
*evthread
= find_thread_ptid (this, event_ptid
);
4454 if (ws
.kind
== TARGET_WAITKIND_STOPPED
)
4456 enum gdb_signal sig
= ws
.value
.sig
;
4458 /* Stubs traditionally report SIGTRAP as initial signal,
4459 instead of signal 0. Suppress it. */
4460 if (sig
== GDB_SIGNAL_TRAP
)
4462 evthread
->suspend
.stop_signal
= sig
;
4466 evthread
->suspend
.waitstatus
= ws
;
4468 if (ws
.kind
!= TARGET_WAITKIND_STOPPED
4469 || ws
.value
.sig
!= GDB_SIGNAL_0
)
4470 evthread
->suspend
.waitstatus_pending_p
= 1;
4472 set_executing (this, event_ptid
, false);
4473 set_running (this, event_ptid
, false);
4474 get_remote_thread_info (evthread
)->vcont_resumed
= 0;
4477 /* "Notice" the new inferiors before anything related to
4478 registers/memory. */
4479 for (inferior
*inf
: all_non_exited_inferiors (this))
4481 inf
->needs_setup
= 1;
4485 thread_info
*thread
= any_live_thread_of_inferior (inf
);
4486 notice_new_inferior (thread
, thread
->state
== THREAD_RUNNING
,
4491 /* If all-stop on top of non-stop, pause all threads. Note this
4492 records the threads' stop pc, so must be done after "noticing"
4496 stop_all_threads ();
4498 /* If all threads of an inferior were already stopped, we
4499 haven't setup the inferior yet. */
4500 for (inferior
*inf
: all_non_exited_inferiors (this))
4502 if (inf
->needs_setup
)
4504 thread_info
*thread
= any_live_thread_of_inferior (inf
);
4505 switch_to_thread_no_regs (thread
);
4511 /* Now go over all threads that are stopped, and print their current
4512 frame. If all-stop, then if there's a signalled thread, pick
4514 for (thread_info
*thread
: all_non_exited_threads (this))
4520 thread
->set_running (false);
4521 else if (thread
->state
!= THREAD_STOPPED
)
4524 if (selected
== NULL
4525 && thread
->suspend
.waitstatus_pending_p
)
4528 if (lowest_stopped
== NULL
4529 || thread
->inf
->num
< lowest_stopped
->inf
->num
4530 || thread
->per_inf_num
< lowest_stopped
->per_inf_num
)
4531 lowest_stopped
= thread
;
4534 print_one_stopped_thread (thread
);
4537 /* In all-stop, we only print the status of one thread, and leave
4538 others with their status pending. */
4541 thread_info
*thread
= selected
;
4543 thread
= lowest_stopped
;
4547 print_one_stopped_thread (thread
);
4550 /* For "info program". */
4551 thread_info
*thread
= inferior_thread ();
4552 if (thread
->state
== THREAD_STOPPED
)
4553 set_last_target_status (this, inferior_ptid
, thread
->suspend
.waitstatus
);
4556 /* Start the remote connection and sync state. */
4559 remote_target::start_remote (int from_tty
, int extended_p
)
4561 struct remote_state
*rs
= get_remote_state ();
4562 struct packet_config
*noack_config
;
4563 char *wait_status
= NULL
;
4565 /* Signal other parts that we're going through the initial setup,
4566 and so things may not be stable yet. E.g., we don't try to
4567 install tracepoints until we've relocated symbols. Also, a
4568 Ctrl-C before we're connected and synced up can't interrupt the
4569 target. Instead, it offers to drop the (potentially wedged)
4571 rs
->starting_up
= 1;
4575 if (interrupt_on_connect
)
4576 send_interrupt_sequence ();
4578 /* Ack any packet which the remote side has already sent. */
4579 remote_serial_write ("+", 1);
4581 /* The first packet we send to the target is the optional "supported
4582 packets" request. If the target can answer this, it will tell us
4583 which later probes to skip. */
4584 remote_query_supported ();
4586 /* If the stub wants to get a QAllow, compose one and send it. */
4587 if (packet_support (PACKET_QAllow
) != PACKET_DISABLE
)
4590 /* gdbserver < 7.7 (before its fix from 2013-12-11) did reply to any
4591 unknown 'v' packet with string "OK". "OK" gets interpreted by GDB
4592 as a reply to known packet. For packet "vFile:setfs:" it is an
4593 invalid reply and GDB would return error in
4594 remote_hostio_set_filesystem, making remote files access impossible.
4595 Disable "vFile:setfs:" in such case. Do not disable other 'v' packets as
4596 other "vFile" packets get correctly detected even on gdbserver < 7.7. */
4598 const char v_mustreplyempty
[] = "vMustReplyEmpty";
4600 putpkt (v_mustreplyempty
);
4601 getpkt (&rs
->buf
, 0);
4602 if (strcmp (rs
->buf
.data (), "OK") == 0)
4603 remote_protocol_packets
[PACKET_vFile_setfs
].support
= PACKET_DISABLE
;
4604 else if (strcmp (rs
->buf
.data (), "") != 0)
4605 error (_("Remote replied unexpectedly to '%s': %s"), v_mustreplyempty
,
4609 /* Next, we possibly activate noack mode.
4611 If the QStartNoAckMode packet configuration is set to AUTO,
4612 enable noack mode if the stub reported a wish for it with
4615 If set to TRUE, then enable noack mode even if the stub didn't
4616 report it in qSupported. If the stub doesn't reply OK, the
4617 session ends with an error.
4619 If FALSE, then don't activate noack mode, regardless of what the
4620 stub claimed should be the default with qSupported. */
4622 noack_config
= &remote_protocol_packets
[PACKET_QStartNoAckMode
];
4623 if (packet_config_support (noack_config
) != PACKET_DISABLE
)
4625 putpkt ("QStartNoAckMode");
4626 getpkt (&rs
->buf
, 0);
4627 if (packet_ok (rs
->buf
, noack_config
) == PACKET_OK
)
4633 /* Tell the remote that we are using the extended protocol. */
4635 getpkt (&rs
->buf
, 0);
4638 /* Let the target know which signals it is allowed to pass down to
4640 update_signals_program_target ();
4642 /* Next, if the target can specify a description, read it. We do
4643 this before anything involving memory or registers. */
4644 target_find_description ();
4646 /* Next, now that we know something about the target, update the
4647 address spaces in the program spaces. */
4648 update_address_spaces ();
4650 /* On OSs where the list of libraries is global to all
4651 processes, we fetch them early. */
4652 if (gdbarch_has_global_solist (target_gdbarch ()))
4653 solib_add (NULL
, from_tty
, auto_solib_add
);
4655 if (target_is_non_stop_p ())
4657 if (packet_support (PACKET_QNonStop
) != PACKET_ENABLE
)
4658 error (_("Non-stop mode requested, but remote "
4659 "does not support non-stop"));
4661 putpkt ("QNonStop:1");
4662 getpkt (&rs
->buf
, 0);
4664 if (strcmp (rs
->buf
.data (), "OK") != 0)
4665 error (_("Remote refused setting non-stop mode with: %s"),
4668 /* Find about threads and processes the stub is already
4669 controlling. We default to adding them in the running state.
4670 The '?' query below will then tell us about which threads are
4672 this->update_thread_list ();
4674 else if (packet_support (PACKET_QNonStop
) == PACKET_ENABLE
)
4676 /* Don't assume that the stub can operate in all-stop mode.
4677 Request it explicitly. */
4678 putpkt ("QNonStop:0");
4679 getpkt (&rs
->buf
, 0);
4681 if (strcmp (rs
->buf
.data (), "OK") != 0)
4682 error (_("Remote refused setting all-stop mode with: %s"),
4686 /* Upload TSVs regardless of whether the target is running or not. The
4687 remote stub, such as GDBserver, may have some predefined or builtin
4688 TSVs, even if the target is not running. */
4689 if (get_trace_status (current_trace_status ()) != -1)
4691 struct uploaded_tsv
*uploaded_tsvs
= NULL
;
4693 upload_trace_state_variables (&uploaded_tsvs
);
4694 merge_uploaded_trace_state_variables (&uploaded_tsvs
);
4697 /* Check whether the target is running now. */
4699 getpkt (&rs
->buf
, 0);
4701 if (!target_is_non_stop_p ())
4703 if (rs
->buf
[0] == 'W' || rs
->buf
[0] == 'X')
4706 error (_("The target is not running (try extended-remote?)"));
4708 /* We're connected, but not running. Drop out before we
4709 call start_remote. */
4710 rs
->starting_up
= 0;
4715 /* Save the reply for later. */
4716 wait_status
= (char *) alloca (strlen (rs
->buf
.data ()) + 1);
4717 strcpy (wait_status
, rs
->buf
.data ());
4720 /* Fetch thread list. */
4721 target_update_thread_list ();
4723 /* Let the stub know that we want it to return the thread. */
4724 set_continue_thread (minus_one_ptid
);
4726 if (thread_count (this) == 0)
4728 /* Target has no concept of threads at all. GDB treats
4729 non-threaded target as single-threaded; add a main
4731 add_current_inferior_and_thread (wait_status
);
4735 /* We have thread information; select the thread the target
4736 says should be current. If we're reconnecting to a
4737 multi-threaded program, this will ideally be the thread
4738 that last reported an event before GDB disconnected. */
4739 ptid_t curr_thread
= get_current_thread (wait_status
);
4740 if (curr_thread
== null_ptid
)
4742 /* Odd... The target was able to list threads, but not
4743 tell us which thread was current (no "thread"
4744 register in T stop reply?). Just pick the first
4745 thread in the thread list then. */
4748 fprintf_unfiltered (gdb_stdlog
,
4749 "warning: couldn't determine remote "
4750 "current thread; picking first in list.\n");
4752 for (thread_info
*tp
: all_non_exited_threads (this,
4755 switch_to_thread (tp
);
4760 switch_to_thread (find_thread_ptid (this, curr_thread
));
4763 /* init_wait_for_inferior should be called before get_offsets in order
4764 to manage `inserted' flag in bp loc in a correct state.
4765 breakpoint_init_inferior, called from init_wait_for_inferior, set
4766 `inserted' flag to 0, while before breakpoint_re_set, called from
4767 start_remote, set `inserted' flag to 1. In the initialization of
4768 inferior, breakpoint_init_inferior should be called first, and then
4769 breakpoint_re_set can be called. If this order is broken, state of
4770 `inserted' flag is wrong, and cause some problems on breakpoint
4772 init_wait_for_inferior ();
4774 get_offsets (); /* Get text, data & bss offsets. */
4776 /* If we could not find a description using qXfer, and we know
4777 how to do it some other way, try again. This is not
4778 supported for non-stop; it could be, but it is tricky if
4779 there are no stopped threads when we connect. */
4780 if (remote_read_description_p (this)
4781 && gdbarch_target_desc (target_gdbarch ()) == NULL
)
4783 target_clear_description ();
4784 target_find_description ();
4787 /* Use the previously fetched status. */
4788 gdb_assert (wait_status
!= NULL
);
4789 strcpy (rs
->buf
.data (), wait_status
);
4790 rs
->cached_wait_status
= 1;
4792 ::start_remote (from_tty
); /* Initialize gdb process mechanisms. */
4796 /* Clear WFI global state. Do this before finding about new
4797 threads and inferiors, and setting the current inferior.
4798 Otherwise we would clear the proceed status of the current
4799 inferior when we want its stop_soon state to be preserved
4800 (see notice_new_inferior). */
4801 init_wait_for_inferior ();
4803 /* In non-stop, we will either get an "OK", meaning that there
4804 are no stopped threads at this time; or, a regular stop
4805 reply. In the latter case, there may be more than one thread
4806 stopped --- we pull them all out using the vStopped
4808 if (strcmp (rs
->buf
.data (), "OK") != 0)
4810 struct notif_client
*notif
= ¬if_client_stop
;
4812 /* remote_notif_get_pending_replies acks this one, and gets
4814 rs
->notif_state
->pending_event
[notif_client_stop
.id
]
4815 = remote_notif_parse (this, notif
, rs
->buf
.data ());
4816 remote_notif_get_pending_events (notif
);
4819 if (thread_count (this) == 0)
4822 error (_("The target is not running (try extended-remote?)"));
4824 /* We're connected, but not running. Drop out before we
4825 call start_remote. */
4826 rs
->starting_up
= 0;
4830 /* In non-stop mode, any cached wait status will be stored in
4831 the stop reply queue. */
4832 gdb_assert (wait_status
== NULL
);
4834 /* Report all signals during attach/startup. */
4837 /* If there are already stopped threads, mark them stopped and
4838 report their stops before giving the prompt to the user. */
4839 process_initial_stop_replies (from_tty
);
4841 if (target_can_async_p ())
4845 /* If we connected to a live target, do some additional setup. */
4846 if (target_has_execution ())
4848 if (symfile_objfile
) /* No use without a symbol-file. */
4849 remote_check_symbols ();
4852 /* Possibly the target has been engaged in a trace run started
4853 previously; find out where things are at. */
4854 if (get_trace_status (current_trace_status ()) != -1)
4856 struct uploaded_tp
*uploaded_tps
= NULL
;
4858 if (current_trace_status ()->running
)
4859 printf_filtered (_("Trace is already running on the target.\n"));
4861 upload_tracepoints (&uploaded_tps
);
4863 merge_uploaded_tracepoints (&uploaded_tps
);
4866 /* Possibly the target has been engaged in a btrace record started
4867 previously; find out where things are at. */
4868 remote_btrace_maybe_reopen ();
4870 /* The thread and inferior lists are now synchronized with the
4871 target, our symbols have been relocated, and we're merged the
4872 target's tracepoints with ours. We're done with basic start
4874 rs
->starting_up
= 0;
4876 /* Maybe breakpoints are global and need to be inserted now. */
4877 if (breakpoints_should_be_inserted_now ())
4878 insert_breakpoints ();
4882 remote_target::connection_string ()
4884 remote_state
*rs
= get_remote_state ();
4886 if (rs
->remote_desc
->name
!= NULL
)
4887 return rs
->remote_desc
->name
;
4892 /* Open a connection to a remote debugger.
4893 NAME is the filename used for communication. */
4896 remote_target::open (const char *name
, int from_tty
)
4898 open_1 (name
, from_tty
, 0);
4901 /* Open a connection to a remote debugger using the extended
4902 remote gdb protocol. NAME is the filename used for communication. */
4905 extended_remote_target::open (const char *name
, int from_tty
)
4907 open_1 (name
, from_tty
, 1 /*extended_p */);
4910 /* Reset all packets back to "unknown support". Called when opening a
4911 new connection to a remote target. */
4914 reset_all_packet_configs_support (void)
4918 for (i
= 0; i
< PACKET_MAX
; i
++)
4919 remote_protocol_packets
[i
].support
= PACKET_SUPPORT_UNKNOWN
;
4922 /* Initialize all packet configs. */
4925 init_all_packet_configs (void)
4929 for (i
= 0; i
< PACKET_MAX
; i
++)
4931 remote_protocol_packets
[i
].detect
= AUTO_BOOLEAN_AUTO
;
4932 remote_protocol_packets
[i
].support
= PACKET_SUPPORT_UNKNOWN
;
4936 /* Symbol look-up. */
4939 remote_target::remote_check_symbols ()
4944 /* The remote side has no concept of inferiors that aren't running
4945 yet, it only knows about running processes. If we're connected
4946 but our current inferior is not running, we should not invite the
4947 remote target to request symbol lookups related to its
4948 (unrelated) current process. */
4949 if (!target_has_execution ())
4952 if (packet_support (PACKET_qSymbol
) == PACKET_DISABLE
)
4955 /* Make sure the remote is pointing at the right process. Note
4956 there's no way to select "no process". */
4957 set_general_process ();
4959 /* Allocate a message buffer. We can't reuse the input buffer in RS,
4960 because we need both at the same time. */
4961 gdb::char_vector
msg (get_remote_packet_size ());
4962 gdb::char_vector
reply (get_remote_packet_size ());
4964 /* Invite target to request symbol lookups. */
4966 putpkt ("qSymbol::");
4968 packet_ok (reply
, &remote_protocol_packets
[PACKET_qSymbol
]);
4970 while (startswith (reply
.data (), "qSymbol:"))
4972 struct bound_minimal_symbol sym
;
4975 end
= hex2bin (tmp
, reinterpret_cast <gdb_byte
*> (msg
.data ()),
4978 sym
= lookup_minimal_symbol (msg
.data (), NULL
, NULL
);
4979 if (sym
.minsym
== NULL
)
4980 xsnprintf (msg
.data (), get_remote_packet_size (), "qSymbol::%s",
4984 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
4985 CORE_ADDR sym_addr
= BMSYMBOL_VALUE_ADDRESS (sym
);
4987 /* If this is a function address, return the start of code
4988 instead of any data function descriptor. */
4989 sym_addr
= gdbarch_convert_from_func_ptr_addr (target_gdbarch (),
4991 current_top_target ());
4993 xsnprintf (msg
.data (), get_remote_packet_size (), "qSymbol:%s:%s",
4994 phex_nz (sym_addr
, addr_size
), &reply
[8]);
4997 putpkt (msg
.data ());
5002 static struct serial
*
5003 remote_serial_open (const char *name
)
5005 static int udp_warning
= 0;
5007 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
5008 of in ser-tcp.c, because it is the remote protocol assuming that the
5009 serial connection is reliable and not the serial connection promising
5011 if (!udp_warning
&& startswith (name
, "udp:"))
5013 warning (_("The remote protocol may be unreliable over UDP.\n"
5014 "Some events may be lost, rendering further debugging "
5019 return serial_open (name
);
5022 /* Inform the target of our permission settings. The permission flags
5023 work without this, but if the target knows the settings, it can do
5024 a couple things. First, it can add its own check, to catch cases
5025 that somehow manage to get by the permissions checks in target
5026 methods. Second, if the target is wired to disallow particular
5027 settings (for instance, a system in the field that is not set up to
5028 be able to stop at a breakpoint), it can object to any unavailable
5032 remote_target::set_permissions ()
5034 struct remote_state
*rs
= get_remote_state ();
5036 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QAllow:"
5037 "WriteReg:%x;WriteMem:%x;"
5038 "InsertBreak:%x;InsertTrace:%x;"
5039 "InsertFastTrace:%x;Stop:%x",
5040 may_write_registers
, may_write_memory
,
5041 may_insert_breakpoints
, may_insert_tracepoints
,
5042 may_insert_fast_tracepoints
, may_stop
);
5044 getpkt (&rs
->buf
, 0);
5046 /* If the target didn't like the packet, warn the user. Do not try
5047 to undo the user's settings, that would just be maddening. */
5048 if (strcmp (rs
->buf
.data (), "OK") != 0)
5049 warning (_("Remote refused setting permissions with: %s"),
5053 /* This type describes each known response to the qSupported
5055 struct protocol_feature
5057 /* The name of this protocol feature. */
5060 /* The default for this protocol feature. */
5061 enum packet_support default_support
;
5063 /* The function to call when this feature is reported, or after
5064 qSupported processing if the feature is not supported.
5065 The first argument points to this structure. The second
5066 argument indicates whether the packet requested support be
5067 enabled, disabled, or probed (or the default, if this function
5068 is being called at the end of processing and this feature was
5069 not reported). The third argument may be NULL; if not NULL, it
5070 is a NUL-terminated string taken from the packet following
5071 this feature's name and an equals sign. */
5072 void (*func
) (remote_target
*remote
, const struct protocol_feature
*,
5073 enum packet_support
, const char *);
5075 /* The corresponding packet for this feature. Only used if
5076 FUNC is remote_supported_packet. */
5081 remote_supported_packet (remote_target
*remote
,
5082 const struct protocol_feature
*feature
,
5083 enum packet_support support
,
5084 const char *argument
)
5088 warning (_("Remote qSupported response supplied an unexpected value for"
5089 " \"%s\"."), feature
->name
);
5093 remote_protocol_packets
[feature
->packet
].support
= support
;
5097 remote_target::remote_packet_size (const protocol_feature
*feature
,
5098 enum packet_support support
, const char *value
)
5100 struct remote_state
*rs
= get_remote_state ();
5105 if (support
!= PACKET_ENABLE
)
5108 if (value
== NULL
|| *value
== '\0')
5110 warning (_("Remote target reported \"%s\" without a size."),
5116 packet_size
= strtol (value
, &value_end
, 16);
5117 if (errno
!= 0 || *value_end
!= '\0' || packet_size
< 0)
5119 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
5120 feature
->name
, value
);
5124 /* Record the new maximum packet size. */
5125 rs
->explicit_packet_size
= packet_size
;
5129 remote_packet_size (remote_target
*remote
, const protocol_feature
*feature
,
5130 enum packet_support support
, const char *value
)
5132 remote
->remote_packet_size (feature
, support
, value
);
5135 static const struct protocol_feature remote_protocol_features
[] = {
5136 { "PacketSize", PACKET_DISABLE
, remote_packet_size
, -1 },
5137 { "qXfer:auxv:read", PACKET_DISABLE
, remote_supported_packet
,
5138 PACKET_qXfer_auxv
},
5139 { "qXfer:exec-file:read", PACKET_DISABLE
, remote_supported_packet
,
5140 PACKET_qXfer_exec_file
},
5141 { "qXfer:features:read", PACKET_DISABLE
, remote_supported_packet
,
5142 PACKET_qXfer_features
},
5143 { "qXfer:libraries:read", PACKET_DISABLE
, remote_supported_packet
,
5144 PACKET_qXfer_libraries
},
5145 { "qXfer:libraries-svr4:read", PACKET_DISABLE
, remote_supported_packet
,
5146 PACKET_qXfer_libraries_svr4
},
5147 { "augmented-libraries-svr4-read", PACKET_DISABLE
,
5148 remote_supported_packet
, PACKET_augmented_libraries_svr4_read_feature
},
5149 { "qXfer:memory-map:read", PACKET_DISABLE
, remote_supported_packet
,
5150 PACKET_qXfer_memory_map
},
5151 { "qXfer:osdata:read", PACKET_DISABLE
, remote_supported_packet
,
5152 PACKET_qXfer_osdata
},
5153 { "qXfer:threads:read", PACKET_DISABLE
, remote_supported_packet
,
5154 PACKET_qXfer_threads
},
5155 { "qXfer:traceframe-info:read", PACKET_DISABLE
, remote_supported_packet
,
5156 PACKET_qXfer_traceframe_info
},
5157 { "QPassSignals", PACKET_DISABLE
, remote_supported_packet
,
5158 PACKET_QPassSignals
},
5159 { "QCatchSyscalls", PACKET_DISABLE
, remote_supported_packet
,
5160 PACKET_QCatchSyscalls
},
5161 { "QProgramSignals", PACKET_DISABLE
, remote_supported_packet
,
5162 PACKET_QProgramSignals
},
5163 { "QSetWorkingDir", PACKET_DISABLE
, remote_supported_packet
,
5164 PACKET_QSetWorkingDir
},
5165 { "QStartupWithShell", PACKET_DISABLE
, remote_supported_packet
,
5166 PACKET_QStartupWithShell
},
5167 { "QEnvironmentHexEncoded", PACKET_DISABLE
, remote_supported_packet
,
5168 PACKET_QEnvironmentHexEncoded
},
5169 { "QEnvironmentReset", PACKET_DISABLE
, remote_supported_packet
,
5170 PACKET_QEnvironmentReset
},
5171 { "QEnvironmentUnset", PACKET_DISABLE
, remote_supported_packet
,
5172 PACKET_QEnvironmentUnset
},
5173 { "QStartNoAckMode", PACKET_DISABLE
, remote_supported_packet
,
5174 PACKET_QStartNoAckMode
},
5175 { "multiprocess", PACKET_DISABLE
, remote_supported_packet
,
5176 PACKET_multiprocess_feature
},
5177 { "QNonStop", PACKET_DISABLE
, remote_supported_packet
, PACKET_QNonStop
},
5178 { "qXfer:siginfo:read", PACKET_DISABLE
, remote_supported_packet
,
5179 PACKET_qXfer_siginfo_read
},
5180 { "qXfer:siginfo:write", PACKET_DISABLE
, remote_supported_packet
,
5181 PACKET_qXfer_siginfo_write
},
5182 { "ConditionalTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5183 PACKET_ConditionalTracepoints
},
5184 { "ConditionalBreakpoints", PACKET_DISABLE
, remote_supported_packet
,
5185 PACKET_ConditionalBreakpoints
},
5186 { "BreakpointCommands", PACKET_DISABLE
, remote_supported_packet
,
5187 PACKET_BreakpointCommands
},
5188 { "FastTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5189 PACKET_FastTracepoints
},
5190 { "StaticTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5191 PACKET_StaticTracepoints
},
5192 {"InstallInTrace", PACKET_DISABLE
, remote_supported_packet
,
5193 PACKET_InstallInTrace
},
5194 { "DisconnectedTracing", PACKET_DISABLE
, remote_supported_packet
,
5195 PACKET_DisconnectedTracing_feature
},
5196 { "ReverseContinue", PACKET_DISABLE
, remote_supported_packet
,
5198 { "ReverseStep", PACKET_DISABLE
, remote_supported_packet
,
5200 { "TracepointSource", PACKET_DISABLE
, remote_supported_packet
,
5201 PACKET_TracepointSource
},
5202 { "QAllow", PACKET_DISABLE
, remote_supported_packet
,
5204 { "EnableDisableTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5205 PACKET_EnableDisableTracepoints_feature
},
5206 { "qXfer:fdpic:read", PACKET_DISABLE
, remote_supported_packet
,
5207 PACKET_qXfer_fdpic
},
5208 { "qXfer:uib:read", PACKET_DISABLE
, remote_supported_packet
,
5210 { "QDisableRandomization", PACKET_DISABLE
, remote_supported_packet
,
5211 PACKET_QDisableRandomization
},
5212 { "QAgent", PACKET_DISABLE
, remote_supported_packet
, PACKET_QAgent
},
5213 { "QTBuffer:size", PACKET_DISABLE
,
5214 remote_supported_packet
, PACKET_QTBuffer_size
},
5215 { "tracenz", PACKET_DISABLE
, remote_supported_packet
, PACKET_tracenz_feature
},
5216 { "Qbtrace:off", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_off
},
5217 { "Qbtrace:bts", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_bts
},
5218 { "Qbtrace:pt", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_pt
},
5219 { "qXfer:btrace:read", PACKET_DISABLE
, remote_supported_packet
,
5220 PACKET_qXfer_btrace
},
5221 { "qXfer:btrace-conf:read", PACKET_DISABLE
, remote_supported_packet
,
5222 PACKET_qXfer_btrace_conf
},
5223 { "Qbtrace-conf:bts:size", PACKET_DISABLE
, remote_supported_packet
,
5224 PACKET_Qbtrace_conf_bts_size
},
5225 { "swbreak", PACKET_DISABLE
, remote_supported_packet
, PACKET_swbreak_feature
},
5226 { "hwbreak", PACKET_DISABLE
, remote_supported_packet
, PACKET_hwbreak_feature
},
5227 { "fork-events", PACKET_DISABLE
, remote_supported_packet
,
5228 PACKET_fork_event_feature
},
5229 { "vfork-events", PACKET_DISABLE
, remote_supported_packet
,
5230 PACKET_vfork_event_feature
},
5231 { "exec-events", PACKET_DISABLE
, remote_supported_packet
,
5232 PACKET_exec_event_feature
},
5233 { "Qbtrace-conf:pt:size", PACKET_DISABLE
, remote_supported_packet
,
5234 PACKET_Qbtrace_conf_pt_size
},
5235 { "vContSupported", PACKET_DISABLE
, remote_supported_packet
, PACKET_vContSupported
},
5236 { "QThreadEvents", PACKET_DISABLE
, remote_supported_packet
, PACKET_QThreadEvents
},
5237 { "no-resumed", PACKET_DISABLE
, remote_supported_packet
, PACKET_no_resumed
},
5240 static char *remote_support_xml
;
5242 /* Register string appended to "xmlRegisters=" in qSupported query. */
5245 register_remote_support_xml (const char *xml
)
5247 #if defined(HAVE_LIBEXPAT)
5248 if (remote_support_xml
== NULL
)
5249 remote_support_xml
= concat ("xmlRegisters=", xml
, (char *) NULL
);
5252 char *copy
= xstrdup (remote_support_xml
+ 13);
5254 char *p
= strtok_r (copy
, ",", &saveptr
);
5258 if (strcmp (p
, xml
) == 0)
5265 while ((p
= strtok_r (NULL
, ",", &saveptr
)) != NULL
);
5268 remote_support_xml
= reconcat (remote_support_xml
,
5269 remote_support_xml
, ",", xml
,
5276 remote_query_supported_append (std::string
*msg
, const char *append
)
5280 msg
->append (append
);
5284 remote_target::remote_query_supported ()
5286 struct remote_state
*rs
= get_remote_state ();
5289 unsigned char seen
[ARRAY_SIZE (remote_protocol_features
)];
5291 /* The packet support flags are handled differently for this packet
5292 than for most others. We treat an error, a disabled packet, and
5293 an empty response identically: any features which must be reported
5294 to be used will be automatically disabled. An empty buffer
5295 accomplishes this, since that is also the representation for a list
5296 containing no features. */
5299 if (packet_support (PACKET_qSupported
) != PACKET_DISABLE
)
5303 if (packet_set_cmd_state (PACKET_multiprocess_feature
) != AUTO_BOOLEAN_FALSE
)
5304 remote_query_supported_append (&q
, "multiprocess+");
5306 if (packet_set_cmd_state (PACKET_swbreak_feature
) != AUTO_BOOLEAN_FALSE
)
5307 remote_query_supported_append (&q
, "swbreak+");
5308 if (packet_set_cmd_state (PACKET_hwbreak_feature
) != AUTO_BOOLEAN_FALSE
)
5309 remote_query_supported_append (&q
, "hwbreak+");
5311 remote_query_supported_append (&q
, "qRelocInsn+");
5313 if (packet_set_cmd_state (PACKET_fork_event_feature
)
5314 != AUTO_BOOLEAN_FALSE
)
5315 remote_query_supported_append (&q
, "fork-events+");
5316 if (packet_set_cmd_state (PACKET_vfork_event_feature
)
5317 != AUTO_BOOLEAN_FALSE
)
5318 remote_query_supported_append (&q
, "vfork-events+");
5319 if (packet_set_cmd_state (PACKET_exec_event_feature
)
5320 != AUTO_BOOLEAN_FALSE
)
5321 remote_query_supported_append (&q
, "exec-events+");
5323 if (packet_set_cmd_state (PACKET_vContSupported
) != AUTO_BOOLEAN_FALSE
)
5324 remote_query_supported_append (&q
, "vContSupported+");
5326 if (packet_set_cmd_state (PACKET_QThreadEvents
) != AUTO_BOOLEAN_FALSE
)
5327 remote_query_supported_append (&q
, "QThreadEvents+");
5329 if (packet_set_cmd_state (PACKET_no_resumed
) != AUTO_BOOLEAN_FALSE
)
5330 remote_query_supported_append (&q
, "no-resumed+");
5332 /* Keep this one last to work around a gdbserver <= 7.10 bug in
5333 the qSupported:xmlRegisters=i386 handling. */
5334 if (remote_support_xml
!= NULL
5335 && packet_support (PACKET_qXfer_features
) != PACKET_DISABLE
)
5336 remote_query_supported_append (&q
, remote_support_xml
);
5338 q
= "qSupported:" + q
;
5339 putpkt (q
.c_str ());
5341 getpkt (&rs
->buf
, 0);
5343 /* If an error occured, warn, but do not return - just reset the
5344 buffer to empty and go on to disable features. */
5345 if (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_qSupported
])
5348 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
5353 memset (seen
, 0, sizeof (seen
));
5355 next
= rs
->buf
.data ();
5358 enum packet_support is_supported
;
5359 char *p
, *end
, *name_end
, *value
;
5361 /* First separate out this item from the rest of the packet. If
5362 there's another item after this, we overwrite the separator
5363 (terminated strings are much easier to work with). */
5365 end
= strchr (p
, ';');
5368 end
= p
+ strlen (p
);
5378 warning (_("empty item in \"qSupported\" response"));
5383 name_end
= strchr (p
, '=');
5386 /* This is a name=value entry. */
5387 is_supported
= PACKET_ENABLE
;
5388 value
= name_end
+ 1;
5397 is_supported
= PACKET_ENABLE
;
5401 is_supported
= PACKET_DISABLE
;
5405 is_supported
= PACKET_SUPPORT_UNKNOWN
;
5409 warning (_("unrecognized item \"%s\" "
5410 "in \"qSupported\" response"), p
);
5416 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
5417 if (strcmp (remote_protocol_features
[i
].name
, p
) == 0)
5419 const struct protocol_feature
*feature
;
5422 feature
= &remote_protocol_features
[i
];
5423 feature
->func (this, feature
, is_supported
, value
);
5428 /* If we increased the packet size, make sure to increase the global
5429 buffer size also. We delay this until after parsing the entire
5430 qSupported packet, because this is the same buffer we were
5432 if (rs
->buf
.size () < rs
->explicit_packet_size
)
5433 rs
->buf
.resize (rs
->explicit_packet_size
);
5435 /* Handle the defaults for unmentioned features. */
5436 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
5439 const struct protocol_feature
*feature
;
5441 feature
= &remote_protocol_features
[i
];
5442 feature
->func (this, feature
, feature
->default_support
, NULL
);
5446 /* Serial QUIT handler for the remote serial descriptor.
5448 Defers handling a Ctrl-C until we're done with the current
5449 command/response packet sequence, unless:
5451 - We're setting up the connection. Don't send a remote interrupt
5452 request, as we're not fully synced yet. Quit immediately
5455 - The target has been resumed in the foreground
5456 (target_terminal::is_ours is false) with a synchronous resume
5457 packet, and we're blocked waiting for the stop reply, thus a
5458 Ctrl-C should be immediately sent to the target.
5460 - We get a second Ctrl-C while still within the same serial read or
5461 write. In that case the serial is seemingly wedged --- offer to
5464 - We see a second Ctrl-C without target response, after having
5465 previously interrupted the target. In that case the target/stub
5466 is probably wedged --- offer to quit/disconnect.
5470 remote_target::remote_serial_quit_handler ()
5472 struct remote_state
*rs
= get_remote_state ();
5474 if (check_quit_flag ())
5476 /* If we're starting up, we're not fully synced yet. Quit
5478 if (rs
->starting_up
)
5480 else if (rs
->got_ctrlc_during_io
)
5482 if (query (_("The target is not responding to GDB commands.\n"
5483 "Stop debugging it? ")))
5484 remote_unpush_and_throw (this);
5486 /* If ^C has already been sent once, offer to disconnect. */
5487 else if (!target_terminal::is_ours () && rs
->ctrlc_pending_p
)
5489 /* All-stop protocol, and blocked waiting for stop reply. Send
5490 an interrupt request. */
5491 else if (!target_terminal::is_ours () && rs
->waiting_for_stop_reply
)
5492 target_interrupt ();
5494 rs
->got_ctrlc_during_io
= 1;
5498 /* The remote_target that is current while the quit handler is
5499 overridden with remote_serial_quit_handler. */
5500 static remote_target
*curr_quit_handler_target
;
5503 remote_serial_quit_handler ()
5505 curr_quit_handler_target
->remote_serial_quit_handler ();
5508 /* Remove the remote target from the target stack of each inferior
5509 that is using it. Upper targets depend on it so remove them
5513 remote_unpush_target (remote_target
*target
)
5515 /* We have to unpush the target from all inferiors, even those that
5517 scoped_restore_current_inferior restore_current_inferior
;
5519 for (inferior
*inf
: all_inferiors (target
))
5521 switch_to_inferior_no_thread (inf
);
5522 pop_all_targets_at_and_above (process_stratum
);
5523 generic_mourn_inferior ();
5528 remote_unpush_and_throw (remote_target
*target
)
5530 remote_unpush_target (target
);
5531 throw_error (TARGET_CLOSE_ERROR
, _("Disconnected from target."));
5535 remote_target::open_1 (const char *name
, int from_tty
, int extended_p
)
5537 remote_target
*curr_remote
= get_current_remote_target ();
5540 error (_("To open a remote debug connection, you need to specify what\n"
5541 "serial device is attached to the remote system\n"
5542 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
5544 /* If we're connected to a running target, target_preopen will kill it.
5545 Ask this question first, before target_preopen has a chance to kill
5547 if (curr_remote
!= NULL
&& !target_has_execution ())
5550 && !query (_("Already connected to a remote target. Disconnect? ")))
5551 error (_("Still connected."));
5554 /* Here the possibly existing remote target gets unpushed. */
5555 target_preopen (from_tty
);
5557 remote_fileio_reset ();
5558 reopen_exec_file ();
5561 remote_target
*remote
5562 = (extended_p
? new extended_remote_target () : new remote_target ());
5563 target_ops_up
target_holder (remote
);
5565 remote_state
*rs
= remote
->get_remote_state ();
5567 /* See FIXME above. */
5568 if (!target_async_permitted
)
5569 rs
->wait_forever_enabled_p
= 1;
5571 rs
->remote_desc
= remote_serial_open (name
);
5572 if (!rs
->remote_desc
)
5573 perror_with_name (name
);
5575 if (baud_rate
!= -1)
5577 if (serial_setbaudrate (rs
->remote_desc
, baud_rate
))
5579 /* The requested speed could not be set. Error out to
5580 top level after closing remote_desc. Take care to
5581 set remote_desc to NULL to avoid closing remote_desc
5583 serial_close (rs
->remote_desc
);
5584 rs
->remote_desc
= NULL
;
5585 perror_with_name (name
);
5589 serial_setparity (rs
->remote_desc
, serial_parity
);
5590 serial_raw (rs
->remote_desc
);
5592 /* If there is something sitting in the buffer we might take it as a
5593 response to a command, which would be bad. */
5594 serial_flush_input (rs
->remote_desc
);
5598 puts_filtered ("Remote debugging using ");
5599 puts_filtered (name
);
5600 puts_filtered ("\n");
5603 /* Switch to using the remote target now. */
5604 push_target (std::move (target_holder
));
5606 /* Register extra event sources in the event loop. */
5607 rs
->remote_async_inferior_event_token
5608 = create_async_event_handler (remote_async_inferior_event_handler
, remote
,
5610 rs
->notif_state
= remote_notif_state_allocate (remote
);
5612 /* Reset the target state; these things will be queried either by
5613 remote_query_supported or as they are needed. */
5614 reset_all_packet_configs_support ();
5615 rs
->cached_wait_status
= 0;
5616 rs
->explicit_packet_size
= 0;
5618 rs
->extended
= extended_p
;
5619 rs
->waiting_for_stop_reply
= 0;
5620 rs
->ctrlc_pending_p
= 0;
5621 rs
->got_ctrlc_during_io
= 0;
5623 rs
->general_thread
= not_sent_ptid
;
5624 rs
->continue_thread
= not_sent_ptid
;
5625 rs
->remote_traceframe_number
= -1;
5627 rs
->last_resume_exec_dir
= EXEC_FORWARD
;
5629 /* Probe for ability to use "ThreadInfo" query, as required. */
5630 rs
->use_threadinfo_query
= 1;
5631 rs
->use_threadextra_query
= 1;
5633 rs
->readahead_cache
.invalidate ();
5635 if (target_async_permitted
)
5637 /* FIXME: cagney/1999-09-23: During the initial connection it is
5638 assumed that the target is already ready and able to respond to
5639 requests. Unfortunately remote_start_remote() eventually calls
5640 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
5641 around this. Eventually a mechanism that allows
5642 wait_for_inferior() to expect/get timeouts will be
5644 rs
->wait_forever_enabled_p
= 0;
5647 /* First delete any symbols previously loaded from shared libraries. */
5648 no_shared_libraries (NULL
, 0);
5650 /* Start the remote connection. If error() or QUIT, discard this
5651 target (we'd otherwise be in an inconsistent state) and then
5652 propogate the error on up the exception chain. This ensures that
5653 the caller doesn't stumble along blindly assuming that the
5654 function succeeded. The CLI doesn't have this problem but other
5655 UI's, such as MI do.
5657 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
5658 this function should return an error indication letting the
5659 caller restore the previous state. Unfortunately the command
5660 ``target remote'' is directly wired to this function making that
5661 impossible. On a positive note, the CLI side of this problem has
5662 been fixed - the function set_cmd_context() makes it possible for
5663 all the ``target ....'' commands to share a common callback
5664 function. See cli-dump.c. */
5669 remote
->start_remote (from_tty
, extended_p
);
5671 catch (const gdb_exception
&ex
)
5673 /* Pop the partially set up target - unless something else did
5674 already before throwing the exception. */
5675 if (ex
.error
!= TARGET_CLOSE_ERROR
)
5676 remote_unpush_target (remote
);
5681 remote_btrace_reset (rs
);
5683 if (target_async_permitted
)
5684 rs
->wait_forever_enabled_p
= 1;
5687 /* Detach the specified process. */
5690 remote_target::remote_detach_pid (int pid
)
5692 struct remote_state
*rs
= get_remote_state ();
5694 /* This should not be necessary, but the handling for D;PID in
5695 GDBserver versions prior to 8.2 incorrectly assumes that the
5696 selected process points to the same process we're detaching,
5697 leading to misbehavior (and possibly GDBserver crashing) when it
5698 does not. Since it's easy and cheap, work around it by forcing
5699 GDBserver to select GDB's current process. */
5700 set_general_process ();
5702 if (remote_multi_process_p (rs
))
5703 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "D;%x", pid
);
5705 strcpy (rs
->buf
.data (), "D");
5708 getpkt (&rs
->buf
, 0);
5710 if (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K')
5712 else if (rs
->buf
[0] == '\0')
5713 error (_("Remote doesn't know how to detach"));
5715 error (_("Can't detach process."));
5718 /* This detaches a program to which we previously attached, using
5719 inferior_ptid to identify the process. After this is done, GDB
5720 can be used to debug some other program. We better not have left
5721 any breakpoints in the target program or it'll die when it hits
5725 remote_target::remote_detach_1 (inferior
*inf
, int from_tty
)
5727 int pid
= inferior_ptid
.pid ();
5728 struct remote_state
*rs
= get_remote_state ();
5731 if (!target_has_execution ())
5732 error (_("No process to detach from."));
5734 target_announce_detach (from_tty
);
5736 /* Tell the remote target to detach. */
5737 remote_detach_pid (pid
);
5739 /* Exit only if this is the only active inferior. */
5740 if (from_tty
&& !rs
->extended
&& number_of_live_inferiors (this) == 1)
5741 puts_filtered (_("Ending remote debugging.\n"));
5743 thread_info
*tp
= find_thread_ptid (this, inferior_ptid
);
5745 /* Check to see if we are detaching a fork parent. Note that if we
5746 are detaching a fork child, tp == NULL. */
5747 is_fork_parent
= (tp
!= NULL
5748 && tp
->pending_follow
.kind
== TARGET_WAITKIND_FORKED
);
5750 /* If doing detach-on-fork, we don't mourn, because that will delete
5751 breakpoints that should be available for the followed inferior. */
5752 if (!is_fork_parent
)
5754 /* Save the pid as a string before mourning, since that will
5755 unpush the remote target, and we need the string after. */
5756 std::string infpid
= target_pid_to_str (ptid_t (pid
));
5758 target_mourn_inferior (inferior_ptid
);
5759 if (print_inferior_events
)
5760 printf_unfiltered (_("[Inferior %d (%s) detached]\n"),
5761 inf
->num
, infpid
.c_str ());
5765 switch_to_no_thread ();
5766 detach_inferior (current_inferior ());
5771 remote_target::detach (inferior
*inf
, int from_tty
)
5773 remote_detach_1 (inf
, from_tty
);
5777 extended_remote_target::detach (inferior
*inf
, int from_tty
)
5779 remote_detach_1 (inf
, from_tty
);
5782 /* Target follow-fork function for remote targets. On entry, and
5783 at return, the current inferior is the fork parent.
5785 Note that although this is currently only used for extended-remote,
5786 it is named remote_follow_fork in anticipation of using it for the
5787 remote target as well. */
5790 remote_target::follow_fork (bool follow_child
, bool detach_fork
)
5792 struct remote_state
*rs
= get_remote_state ();
5793 enum target_waitkind kind
= inferior_thread ()->pending_follow
.kind
;
5795 if ((kind
== TARGET_WAITKIND_FORKED
&& remote_fork_event_p (rs
))
5796 || (kind
== TARGET_WAITKIND_VFORKED
&& remote_vfork_event_p (rs
)))
5798 /* When following the parent and detaching the child, we detach
5799 the child here. For the case of following the child and
5800 detaching the parent, the detach is done in the target-
5801 independent follow fork code in infrun.c. We can't use
5802 target_detach when detaching an unfollowed child because
5803 the client side doesn't know anything about the child. */
5804 if (detach_fork
&& !follow_child
)
5806 /* Detach the fork child. */
5810 child_ptid
= inferior_thread ()->pending_follow
.value
.related_pid
;
5811 child_pid
= child_ptid
.pid ();
5813 remote_detach_pid (child_pid
);
5820 /* Target follow-exec function for remote targets. Save EXECD_PATHNAME
5821 in the program space of the new inferior. On entry and at return the
5822 current inferior is the exec'ing inferior. INF is the new exec'd
5823 inferior, which may be the same as the exec'ing inferior unless
5824 follow-exec-mode is "new". */
5827 remote_target::follow_exec (struct inferior
*inf
, const char *execd_pathname
)
5829 /* We know that this is a target file name, so if it has the "target:"
5830 prefix we strip it off before saving it in the program space. */
5831 if (is_target_filename (execd_pathname
))
5832 execd_pathname
+= strlen (TARGET_SYSROOT_PREFIX
);
5834 set_pspace_remote_exec_file (inf
->pspace
, execd_pathname
);
5837 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
5840 remote_target::disconnect (const char *args
, int from_tty
)
5843 error (_("Argument given to \"disconnect\" when remotely debugging."));
5845 /* Make sure we unpush even the extended remote targets. Calling
5846 target_mourn_inferior won't unpush, and
5847 remote_target::mourn_inferior won't unpush if there is more than
5848 one inferior left. */
5849 remote_unpush_target (this);
5852 puts_filtered ("Ending remote debugging.\n");
5855 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
5856 be chatty about it. */
5859 extended_remote_target::attach (const char *args
, int from_tty
)
5861 struct remote_state
*rs
= get_remote_state ();
5863 char *wait_status
= NULL
;
5865 pid
= parse_pid_to_attach (args
);
5867 /* Remote PID can be freely equal to getpid, do not check it here the same
5868 way as in other targets. */
5870 if (packet_support (PACKET_vAttach
) == PACKET_DISABLE
)
5871 error (_("This target does not support attaching to a process"));
5875 const char *exec_file
= get_exec_file (0);
5878 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file
,
5879 target_pid_to_str (ptid_t (pid
)).c_str ());
5881 printf_unfiltered (_("Attaching to %s\n"),
5882 target_pid_to_str (ptid_t (pid
)).c_str ());
5885 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "vAttach;%x", pid
);
5887 getpkt (&rs
->buf
, 0);
5889 switch (packet_ok (rs
->buf
,
5890 &remote_protocol_packets
[PACKET_vAttach
]))
5893 if (!target_is_non_stop_p ())
5895 /* Save the reply for later. */
5896 wait_status
= (char *) alloca (strlen (rs
->buf
.data ()) + 1);
5897 strcpy (wait_status
, rs
->buf
.data ());
5899 else if (strcmp (rs
->buf
.data (), "OK") != 0)
5900 error (_("Attaching to %s failed with: %s"),
5901 target_pid_to_str (ptid_t (pid
)).c_str (),
5904 case PACKET_UNKNOWN
:
5905 error (_("This target does not support attaching to a process"));
5907 error (_("Attaching to %s failed"),
5908 target_pid_to_str (ptid_t (pid
)).c_str ());
5911 switch_to_inferior_no_thread (remote_add_inferior (false, pid
, 1, 0));
5913 inferior_ptid
= ptid_t (pid
);
5915 if (target_is_non_stop_p ())
5917 /* Get list of threads. */
5918 update_thread_list ();
5920 thread_info
*thread
= first_thread_of_inferior (current_inferior ());
5921 if (thread
!= nullptr)
5922 switch_to_thread (thread
);
5924 /* Invalidate our notion of the remote current thread. */
5925 record_currthread (rs
, minus_one_ptid
);
5929 /* Now, if we have thread information, update the main thread's
5931 ptid_t curr_ptid
= remote_current_thread (ptid_t (pid
));
5933 /* Add the main thread to the thread list. */
5934 thread_info
*thr
= add_thread_silent (this, curr_ptid
);
5936 switch_to_thread (thr
);
5938 /* Don't consider the thread stopped until we've processed the
5939 saved stop reply. */
5940 set_executing (this, thr
->ptid
, true);
5943 /* Next, if the target can specify a description, read it. We do
5944 this before anything involving memory or registers. */
5945 target_find_description ();
5947 if (!target_is_non_stop_p ())
5949 /* Use the previously fetched status. */
5950 gdb_assert (wait_status
!= NULL
);
5952 if (target_can_async_p ())
5954 struct notif_event
*reply
5955 = remote_notif_parse (this, ¬if_client_stop
, wait_status
);
5957 push_stop_reply ((struct stop_reply
*) reply
);
5963 gdb_assert (wait_status
!= NULL
);
5964 strcpy (rs
->buf
.data (), wait_status
);
5965 rs
->cached_wait_status
= 1;
5969 gdb_assert (wait_status
== NULL
);
5972 /* Implementation of the to_post_attach method. */
5975 extended_remote_target::post_attach (int pid
)
5977 /* Get text, data & bss offsets. */
5980 /* In certain cases GDB might not have had the chance to start
5981 symbol lookup up until now. This could happen if the debugged
5982 binary is not using shared libraries, the vsyscall page is not
5983 present (on Linux) and the binary itself hadn't changed since the
5984 debugging process was started. */
5985 if (symfile_objfile
!= NULL
)
5986 remote_check_symbols();
5990 /* Check for the availability of vCont. This function should also check
5994 remote_target::remote_vcont_probe ()
5996 remote_state
*rs
= get_remote_state ();
5999 strcpy (rs
->buf
.data (), "vCont?");
6001 getpkt (&rs
->buf
, 0);
6002 buf
= rs
->buf
.data ();
6004 /* Make sure that the features we assume are supported. */
6005 if (startswith (buf
, "vCont"))
6008 int support_c
, support_C
;
6010 rs
->supports_vCont
.s
= 0;
6011 rs
->supports_vCont
.S
= 0;
6014 rs
->supports_vCont
.t
= 0;
6015 rs
->supports_vCont
.r
= 0;
6016 while (p
&& *p
== ';')
6019 if (*p
== 's' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6020 rs
->supports_vCont
.s
= 1;
6021 else if (*p
== 'S' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6022 rs
->supports_vCont
.S
= 1;
6023 else if (*p
== 'c' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6025 else if (*p
== 'C' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6027 else if (*p
== 't' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6028 rs
->supports_vCont
.t
= 1;
6029 else if (*p
== 'r' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6030 rs
->supports_vCont
.r
= 1;
6032 p
= strchr (p
, ';');
6035 /* If c, and C are not all supported, we can't use vCont. Clearing
6036 BUF will make packet_ok disable the packet. */
6037 if (!support_c
|| !support_C
)
6041 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vCont
]);
6042 rs
->supports_vCont_probed
= true;
6045 /* Helper function for building "vCont" resumptions. Write a
6046 resumption to P. ENDP points to one-passed-the-end of the buffer
6047 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
6048 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
6049 resumed thread should be single-stepped and/or signalled. If PTID
6050 equals minus_one_ptid, then all threads are resumed; if PTID
6051 represents a process, then all threads of the process are resumed;
6052 the thread to be stepped and/or signalled is given in the global
6056 remote_target::append_resumption (char *p
, char *endp
,
6057 ptid_t ptid
, int step
, gdb_signal siggnal
)
6059 struct remote_state
*rs
= get_remote_state ();
6061 if (step
&& siggnal
!= GDB_SIGNAL_0
)
6062 p
+= xsnprintf (p
, endp
- p
, ";S%02x", siggnal
);
6064 /* GDB is willing to range step. */
6065 && use_range_stepping
6066 /* Target supports range stepping. */
6067 && rs
->supports_vCont
.r
6068 /* We don't currently support range stepping multiple
6069 threads with a wildcard (though the protocol allows it,
6070 so stubs shouldn't make an active effort to forbid
6072 && !(remote_multi_process_p (rs
) && ptid
.is_pid ()))
6074 struct thread_info
*tp
;
6076 if (ptid
== minus_one_ptid
)
6078 /* If we don't know about the target thread's tid, then
6079 we're resuming magic_null_ptid (see caller). */
6080 tp
= find_thread_ptid (this, magic_null_ptid
);
6083 tp
= find_thread_ptid (this, ptid
);
6084 gdb_assert (tp
!= NULL
);
6086 if (tp
->control
.may_range_step
)
6088 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
6090 p
+= xsnprintf (p
, endp
- p
, ";r%s,%s",
6091 phex_nz (tp
->control
.step_range_start
,
6093 phex_nz (tp
->control
.step_range_end
,
6097 p
+= xsnprintf (p
, endp
- p
, ";s");
6100 p
+= xsnprintf (p
, endp
- p
, ";s");
6101 else if (siggnal
!= GDB_SIGNAL_0
)
6102 p
+= xsnprintf (p
, endp
- p
, ";C%02x", siggnal
);
6104 p
+= xsnprintf (p
, endp
- p
, ";c");
6106 if (remote_multi_process_p (rs
) && ptid
.is_pid ())
6110 /* All (-1) threads of process. */
6111 nptid
= ptid_t (ptid
.pid (), -1, 0);
6113 p
+= xsnprintf (p
, endp
- p
, ":");
6114 p
= write_ptid (p
, endp
, nptid
);
6116 else if (ptid
!= minus_one_ptid
)
6118 p
+= xsnprintf (p
, endp
- p
, ":");
6119 p
= write_ptid (p
, endp
, ptid
);
6125 /* Clear the thread's private info on resume. */
6128 resume_clear_thread_private_info (struct thread_info
*thread
)
6130 if (thread
->priv
!= NULL
)
6132 remote_thread_info
*priv
= get_remote_thread_info (thread
);
6134 priv
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
6135 priv
->watch_data_address
= 0;
6139 /* Append a vCont continue-with-signal action for threads that have a
6140 non-zero stop signal. */
6143 remote_target::append_pending_thread_resumptions (char *p
, char *endp
,
6146 for (thread_info
*thread
: all_non_exited_threads (this, ptid
))
6147 if (inferior_ptid
!= thread
->ptid
6148 && thread
->suspend
.stop_signal
!= GDB_SIGNAL_0
)
6150 p
= append_resumption (p
, endp
, thread
->ptid
,
6151 0, thread
->suspend
.stop_signal
);
6152 thread
->suspend
.stop_signal
= GDB_SIGNAL_0
;
6153 resume_clear_thread_private_info (thread
);
6159 /* Set the target running, using the packets that use Hc
6163 remote_target::remote_resume_with_hc (ptid_t ptid
, int step
,
6166 struct remote_state
*rs
= get_remote_state ();
6169 rs
->last_sent_signal
= siggnal
;
6170 rs
->last_sent_step
= step
;
6172 /* The c/s/C/S resume packets use Hc, so set the continue
6174 if (ptid
== minus_one_ptid
)
6175 set_continue_thread (any_thread_ptid
);
6177 set_continue_thread (ptid
);
6179 for (thread_info
*thread
: all_non_exited_threads (this))
6180 resume_clear_thread_private_info (thread
);
6182 buf
= rs
->buf
.data ();
6183 if (::execution_direction
== EXEC_REVERSE
)
6185 /* We don't pass signals to the target in reverse exec mode. */
6186 if (info_verbose
&& siggnal
!= GDB_SIGNAL_0
)
6187 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
6190 if (step
&& packet_support (PACKET_bs
) == PACKET_DISABLE
)
6191 error (_("Remote reverse-step not supported."));
6192 if (!step
&& packet_support (PACKET_bc
) == PACKET_DISABLE
)
6193 error (_("Remote reverse-continue not supported."));
6195 strcpy (buf
, step
? "bs" : "bc");
6197 else if (siggnal
!= GDB_SIGNAL_0
)
6199 buf
[0] = step
? 'S' : 'C';
6200 buf
[1] = tohex (((int) siggnal
>> 4) & 0xf);
6201 buf
[2] = tohex (((int) siggnal
) & 0xf);
6205 strcpy (buf
, step
? "s" : "c");
6210 /* Resume the remote inferior by using a "vCont" packet. The thread
6211 to be resumed is PTID; STEP and SIGGNAL indicate whether the
6212 resumed thread should be single-stepped and/or signalled. If PTID
6213 equals minus_one_ptid, then all threads are resumed; the thread to
6214 be stepped and/or signalled is given in the global INFERIOR_PTID.
6215 This function returns non-zero iff it resumes the inferior.
6217 This function issues a strict subset of all possible vCont commands
6221 remote_target::remote_resume_with_vcont (ptid_t ptid
, int step
,
6222 enum gdb_signal siggnal
)
6224 struct remote_state
*rs
= get_remote_state ();
6228 /* No reverse execution actions defined for vCont. */
6229 if (::execution_direction
== EXEC_REVERSE
)
6232 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
6233 remote_vcont_probe ();
6235 if (packet_support (PACKET_vCont
) == PACKET_DISABLE
)
6238 p
= rs
->buf
.data ();
6239 endp
= p
+ get_remote_packet_size ();
6241 /* If we could generate a wider range of packets, we'd have to worry
6242 about overflowing BUF. Should there be a generic
6243 "multi-part-packet" packet? */
6245 p
+= xsnprintf (p
, endp
- p
, "vCont");
6247 if (ptid
== magic_null_ptid
)
6249 /* MAGIC_NULL_PTID means that we don't have any active threads,
6250 so we don't have any TID numbers the inferior will
6251 understand. Make sure to only send forms that do not specify
6253 append_resumption (p
, endp
, minus_one_ptid
, step
, siggnal
);
6255 else if (ptid
== minus_one_ptid
|| ptid
.is_pid ())
6257 /* Resume all threads (of all processes, or of a single
6258 process), with preference for INFERIOR_PTID. This assumes
6259 inferior_ptid belongs to the set of all threads we are about
6261 if (step
|| siggnal
!= GDB_SIGNAL_0
)
6263 /* Step inferior_ptid, with or without signal. */
6264 p
= append_resumption (p
, endp
, inferior_ptid
, step
, siggnal
);
6267 /* Also pass down any pending signaled resumption for other
6268 threads not the current. */
6269 p
= append_pending_thread_resumptions (p
, endp
, ptid
);
6271 /* And continue others without a signal. */
6272 append_resumption (p
, endp
, ptid
, /*step=*/ 0, GDB_SIGNAL_0
);
6276 /* Scheduler locking; resume only PTID. */
6277 append_resumption (p
, endp
, ptid
, step
, siggnal
);
6280 gdb_assert (strlen (rs
->buf
.data ()) < get_remote_packet_size ());
6283 if (target_is_non_stop_p ())
6285 /* In non-stop, the stub replies to vCont with "OK". The stop
6286 reply will be reported asynchronously by means of a `%Stop'
6288 getpkt (&rs
->buf
, 0);
6289 if (strcmp (rs
->buf
.data (), "OK") != 0)
6290 error (_("Unexpected vCont reply in non-stop mode: %s"),
6297 /* Tell the remote machine to resume. */
6300 remote_target::resume (ptid_t ptid
, int step
, enum gdb_signal siggnal
)
6302 struct remote_state
*rs
= get_remote_state ();
6304 /* When connected in non-stop mode, the core resumes threads
6305 individually. Resuming remote threads directly in target_resume
6306 would thus result in sending one packet per thread. Instead, to
6307 minimize roundtrip latency, here we just store the resume
6308 request; the actual remote resumption will be done in
6309 target_commit_resume / remote_commit_resume, where we'll be able
6310 to do vCont action coalescing. */
6311 if (target_is_non_stop_p () && ::execution_direction
!= EXEC_REVERSE
)
6313 remote_thread_info
*remote_thr
;
6315 if (minus_one_ptid
== ptid
|| ptid
.is_pid ())
6316 remote_thr
= get_remote_thread_info (this, inferior_ptid
);
6318 remote_thr
= get_remote_thread_info (this, ptid
);
6320 remote_thr
->last_resume_step
= step
;
6321 remote_thr
->last_resume_sig
= siggnal
;
6325 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
6326 (explained in remote-notif.c:handle_notification) so
6327 remote_notif_process is not called. We need find a place where
6328 it is safe to start a 'vNotif' sequence. It is good to do it
6329 before resuming inferior, because inferior was stopped and no RSP
6330 traffic at that moment. */
6331 if (!target_is_non_stop_p ())
6332 remote_notif_process (rs
->notif_state
, ¬if_client_stop
);
6334 rs
->last_resume_exec_dir
= ::execution_direction
;
6336 /* Prefer vCont, and fallback to s/c/S/C, which use Hc. */
6337 if (!remote_resume_with_vcont (ptid
, step
, siggnal
))
6338 remote_resume_with_hc (ptid
, step
, siggnal
);
6340 /* We are about to start executing the inferior, let's register it
6341 with the event loop. NOTE: this is the one place where all the
6342 execution commands end up. We could alternatively do this in each
6343 of the execution commands in infcmd.c. */
6344 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
6345 into infcmd.c in order to allow inferior function calls to work
6346 NOT asynchronously. */
6347 if (target_can_async_p ())
6350 /* We've just told the target to resume. The remote server will
6351 wait for the inferior to stop, and then send a stop reply. In
6352 the mean time, we can't start another command/query ourselves
6353 because the stub wouldn't be ready to process it. This applies
6354 only to the base all-stop protocol, however. In non-stop (which
6355 only supports vCont), the stub replies with an "OK", and is
6356 immediate able to process further serial input. */
6357 if (!target_is_non_stop_p ())
6358 rs
->waiting_for_stop_reply
= 1;
6361 static int is_pending_fork_parent_thread (struct thread_info
*thread
);
6363 /* Private per-inferior info for target remote processes. */
6365 struct remote_inferior
: public private_inferior
6367 /* Whether we can send a wildcard vCont for this process. */
6368 bool may_wildcard_vcont
= true;
6371 /* Get the remote private inferior data associated to INF. */
6373 static remote_inferior
*
6374 get_remote_inferior (inferior
*inf
)
6376 if (inf
->priv
== NULL
)
6377 inf
->priv
.reset (new remote_inferior
);
6379 return static_cast<remote_inferior
*> (inf
->priv
.get ());
6382 /* Class used to track the construction of a vCont packet in the
6383 outgoing packet buffer. This is used to send multiple vCont
6384 packets if we have more actions than would fit a single packet. */
6389 explicit vcont_builder (remote_target
*remote
)
6396 void push_action (ptid_t ptid
, bool step
, gdb_signal siggnal
);
6401 /* The remote target. */
6402 remote_target
*m_remote
;
6404 /* Pointer to the first action. P points here if no action has been
6406 char *m_first_action
;
6408 /* Where the next action will be appended. */
6411 /* The end of the buffer. Must never write past this. */
6415 /* Prepare the outgoing buffer for a new vCont packet. */
6418 vcont_builder::restart ()
6420 struct remote_state
*rs
= m_remote
->get_remote_state ();
6422 m_p
= rs
->buf
.data ();
6423 m_endp
= m_p
+ m_remote
->get_remote_packet_size ();
6424 m_p
+= xsnprintf (m_p
, m_endp
- m_p
, "vCont");
6425 m_first_action
= m_p
;
6428 /* If the vCont packet being built has any action, send it to the
6432 vcont_builder::flush ()
6434 struct remote_state
*rs
;
6436 if (m_p
== m_first_action
)
6439 rs
= m_remote
->get_remote_state ();
6440 m_remote
->putpkt (rs
->buf
);
6441 m_remote
->getpkt (&rs
->buf
, 0);
6442 if (strcmp (rs
->buf
.data (), "OK") != 0)
6443 error (_("Unexpected vCont reply in non-stop mode: %s"), rs
->buf
.data ());
6446 /* The largest action is range-stepping, with its two addresses. This
6447 is more than sufficient. If a new, bigger action is created, it'll
6448 quickly trigger a failed assertion in append_resumption (and we'll
6450 #define MAX_ACTION_SIZE 200
6452 /* Append a new vCont action in the outgoing packet being built. If
6453 the action doesn't fit the packet along with previous actions, push
6454 what we've got so far to the remote end and start over a new vCont
6455 packet (with the new action). */
6458 vcont_builder::push_action (ptid_t ptid
, bool step
, gdb_signal siggnal
)
6460 char buf
[MAX_ACTION_SIZE
+ 1];
6462 char *endp
= m_remote
->append_resumption (buf
, buf
+ sizeof (buf
),
6463 ptid
, step
, siggnal
);
6465 /* Check whether this new action would fit in the vCont packet along
6466 with previous actions. If not, send what we've got so far and
6467 start a new vCont packet. */
6468 size_t rsize
= endp
- buf
;
6469 if (rsize
> m_endp
- m_p
)
6474 /* Should now fit. */
6475 gdb_assert (rsize
<= m_endp
- m_p
);
6478 memcpy (m_p
, buf
, rsize
);
6483 /* to_commit_resume implementation. */
6486 remote_target::commit_resume ()
6488 int any_process_wildcard
;
6489 int may_global_wildcard_vcont
;
6491 /* If connected in all-stop mode, we'd send the remote resume
6492 request directly from remote_resume. Likewise if
6493 reverse-debugging, as there are no defined vCont actions for
6494 reverse execution. */
6495 if (!target_is_non_stop_p () || ::execution_direction
== EXEC_REVERSE
)
6498 /* Try to send wildcard actions ("vCont;c" or "vCont;c:pPID.-1")
6499 instead of resuming all threads of each process individually.
6500 However, if any thread of a process must remain halted, we can't
6501 send wildcard resumes and must send one action per thread.
6503 Care must be taken to not resume threads/processes the server
6504 side already told us are stopped, but the core doesn't know about
6505 yet, because the events are still in the vStopped notification
6508 #1 => vCont s:p1.1;c
6510 #3 <= %Stopped T05 p1.1
6515 #8 (infrun handles the stop for p1.1 and continues stepping)
6516 #9 => vCont s:p1.1;c
6518 The last vCont above would resume thread p1.2 by mistake, because
6519 the server has no idea that the event for p1.2 had not been
6522 The server side must similarly ignore resume actions for the
6523 thread that has a pending %Stopped notification (and any other
6524 threads with events pending), until GDB acks the notification
6525 with vStopped. Otherwise, e.g., the following case is
6528 #1 => g (or any other packet)
6530 #3 <= %Stopped T05 p1.2
6531 #4 => vCont s:p1.1;c
6534 Above, the server must not resume thread p1.2. GDB can't know
6535 that p1.2 stopped until it acks the %Stopped notification, and
6536 since from GDB's perspective all threads should be running, it
6539 Finally, special care must also be given to handling fork/vfork
6540 events. A (v)fork event actually tells us that two processes
6541 stopped -- the parent and the child. Until we follow the fork,
6542 we must not resume the child. Therefore, if we have a pending
6543 fork follow, we must not send a global wildcard resume action
6544 (vCont;c). We can still send process-wide wildcards though. */
6546 /* Start by assuming a global wildcard (vCont;c) is possible. */
6547 may_global_wildcard_vcont
= 1;
6549 /* And assume every process is individually wildcard-able too. */
6550 for (inferior
*inf
: all_non_exited_inferiors (this))
6552 remote_inferior
*priv
= get_remote_inferior (inf
);
6554 priv
->may_wildcard_vcont
= true;
6557 /* Check for any pending events (not reported or processed yet) and
6558 disable process and global wildcard resumes appropriately. */
6559 check_pending_events_prevent_wildcard_vcont (&may_global_wildcard_vcont
);
6561 for (thread_info
*tp
: all_non_exited_threads (this))
6563 /* If a thread of a process is not meant to be resumed, then we
6564 can't wildcard that process. */
6567 get_remote_inferior (tp
->inf
)->may_wildcard_vcont
= false;
6569 /* And if we can't wildcard a process, we can't wildcard
6570 everything either. */
6571 may_global_wildcard_vcont
= 0;
6575 /* If a thread is the parent of an unfollowed fork, then we
6576 can't do a global wildcard, as that would resume the fork
6578 if (is_pending_fork_parent_thread (tp
))
6579 may_global_wildcard_vcont
= 0;
6582 /* Now let's build the vCont packet(s). Actions must be appended
6583 from narrower to wider scopes (thread -> process -> global). If
6584 we end up with too many actions for a single packet vcont_builder
6585 flushes the current vCont packet to the remote side and starts a
6587 struct vcont_builder
vcont_builder (this);
6589 /* Threads first. */
6590 for (thread_info
*tp
: all_non_exited_threads (this))
6592 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6594 if (!tp
->executing
|| remote_thr
->vcont_resumed
)
6597 gdb_assert (!thread_is_in_step_over_chain (tp
));
6599 if (!remote_thr
->last_resume_step
6600 && remote_thr
->last_resume_sig
== GDB_SIGNAL_0
6601 && get_remote_inferior (tp
->inf
)->may_wildcard_vcont
)
6603 /* We'll send a wildcard resume instead. */
6604 remote_thr
->vcont_resumed
= 1;
6608 vcont_builder
.push_action (tp
->ptid
,
6609 remote_thr
->last_resume_step
,
6610 remote_thr
->last_resume_sig
);
6611 remote_thr
->vcont_resumed
= 1;
6614 /* Now check whether we can send any process-wide wildcard. This is
6615 to avoid sending a global wildcard in the case nothing is
6616 supposed to be resumed. */
6617 any_process_wildcard
= 0;
6619 for (inferior
*inf
: all_non_exited_inferiors (this))
6621 if (get_remote_inferior (inf
)->may_wildcard_vcont
)
6623 any_process_wildcard
= 1;
6628 if (any_process_wildcard
)
6630 /* If all processes are wildcard-able, then send a single "c"
6631 action, otherwise, send an "all (-1) threads of process"
6632 continue action for each running process, if any. */
6633 if (may_global_wildcard_vcont
)
6635 vcont_builder
.push_action (minus_one_ptid
,
6636 false, GDB_SIGNAL_0
);
6640 for (inferior
*inf
: all_non_exited_inferiors (this))
6642 if (get_remote_inferior (inf
)->may_wildcard_vcont
)
6644 vcont_builder
.push_action (ptid_t (inf
->pid
),
6645 false, GDB_SIGNAL_0
);
6651 vcont_builder
.flush ();
6656 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
6657 thread, all threads of a remote process, or all threads of all
6661 remote_target::remote_stop_ns (ptid_t ptid
)
6663 struct remote_state
*rs
= get_remote_state ();
6664 char *p
= rs
->buf
.data ();
6665 char *endp
= p
+ get_remote_packet_size ();
6667 /* FIXME: This supports_vCont_probed check is a workaround until
6668 packet_support is per-connection. */
6669 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
6670 || !rs
->supports_vCont_probed
)
6671 remote_vcont_probe ();
6673 if (!rs
->supports_vCont
.t
)
6674 error (_("Remote server does not support stopping threads"));
6676 if (ptid
== minus_one_ptid
6677 || (!remote_multi_process_p (rs
) && ptid
.is_pid ()))
6678 p
+= xsnprintf (p
, endp
- p
, "vCont;t");
6683 p
+= xsnprintf (p
, endp
- p
, "vCont;t:");
6686 /* All (-1) threads of process. */
6687 nptid
= ptid_t (ptid
.pid (), -1, 0);
6690 /* Small optimization: if we already have a stop reply for
6691 this thread, no use in telling the stub we want this
6693 if (peek_stop_reply (ptid
))
6699 write_ptid (p
, endp
, nptid
);
6702 /* In non-stop, we get an immediate OK reply. The stop reply will
6703 come in asynchronously by notification. */
6705 getpkt (&rs
->buf
, 0);
6706 if (strcmp (rs
->buf
.data (), "OK") != 0)
6707 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid
).c_str (),
6711 /* All-stop version of target_interrupt. Sends a break or a ^C to
6712 interrupt the remote target. It is undefined which thread of which
6713 process reports the interrupt. */
6716 remote_target::remote_interrupt_as ()
6718 struct remote_state
*rs
= get_remote_state ();
6720 rs
->ctrlc_pending_p
= 1;
6722 /* If the inferior is stopped already, but the core didn't know
6723 about it yet, just ignore the request. The cached wait status
6724 will be collected in remote_wait. */
6725 if (rs
->cached_wait_status
)
6728 /* Send interrupt_sequence to remote target. */
6729 send_interrupt_sequence ();
6732 /* Non-stop version of target_interrupt. Uses `vCtrlC' to interrupt
6733 the remote target. It is undefined which thread of which process
6734 reports the interrupt. Throws an error if the packet is not
6735 supported by the server. */
6738 remote_target::remote_interrupt_ns ()
6740 struct remote_state
*rs
= get_remote_state ();
6741 char *p
= rs
->buf
.data ();
6742 char *endp
= p
+ get_remote_packet_size ();
6744 xsnprintf (p
, endp
- p
, "vCtrlC");
6746 /* In non-stop, we get an immediate OK reply. The stop reply will
6747 come in asynchronously by notification. */
6749 getpkt (&rs
->buf
, 0);
6751 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vCtrlC
]))
6755 case PACKET_UNKNOWN
:
6756 error (_("No support for interrupting the remote target."));
6758 error (_("Interrupting target failed: %s"), rs
->buf
.data ());
6762 /* Implement the to_stop function for the remote targets. */
6765 remote_target::stop (ptid_t ptid
)
6768 fprintf_unfiltered (gdb_stdlog
, "remote_stop called\n");
6770 if (target_is_non_stop_p ())
6771 remote_stop_ns (ptid
);
6774 /* We don't currently have a way to transparently pause the
6775 remote target in all-stop mode. Interrupt it instead. */
6776 remote_interrupt_as ();
6780 /* Implement the to_interrupt function for the remote targets. */
6783 remote_target::interrupt ()
6786 fprintf_unfiltered (gdb_stdlog
, "remote_interrupt called\n");
6788 if (target_is_non_stop_p ())
6789 remote_interrupt_ns ();
6791 remote_interrupt_as ();
6794 /* Implement the to_pass_ctrlc function for the remote targets. */
6797 remote_target::pass_ctrlc ()
6799 struct remote_state
*rs
= get_remote_state ();
6802 fprintf_unfiltered (gdb_stdlog
, "remote_pass_ctrlc called\n");
6804 /* If we're starting up, we're not fully synced yet. Quit
6806 if (rs
->starting_up
)
6808 /* If ^C has already been sent once, offer to disconnect. */
6809 else if (rs
->ctrlc_pending_p
)
6812 target_interrupt ();
6815 /* Ask the user what to do when an interrupt is received. */
6818 remote_target::interrupt_query ()
6820 struct remote_state
*rs
= get_remote_state ();
6822 if (rs
->waiting_for_stop_reply
&& rs
->ctrlc_pending_p
)
6824 if (query (_("The target is not responding to interrupt requests.\n"
6825 "Stop debugging it? ")))
6827 remote_unpush_target (this);
6828 throw_error (TARGET_CLOSE_ERROR
, _("Disconnected from target."));
6833 if (query (_("Interrupted while waiting for the program.\n"
6834 "Give up waiting? ")))
6839 /* Enable/disable target terminal ownership. Most targets can use
6840 terminal groups to control terminal ownership. Remote targets are
6841 different in that explicit transfer of ownership to/from GDB/target
6845 remote_target::terminal_inferior ()
6847 /* NOTE: At this point we could also register our selves as the
6848 recipient of all input. Any characters typed could then be
6849 passed on down to the target. */
6853 remote_target::terminal_ours ()
6858 remote_console_output (const char *msg
)
6862 for (p
= msg
; p
[0] && p
[1]; p
+= 2)
6865 char c
= fromhex (p
[0]) * 16 + fromhex (p
[1]);
6869 gdb_stdtarg
->puts (tb
);
6871 gdb_stdtarg
->flush ();
6874 struct stop_reply
: public notif_event
6878 /* The identifier of the thread about this event */
6881 /* The remote state this event is associated with. When the remote
6882 connection, represented by a remote_state object, is closed,
6883 all the associated stop_reply events should be released. */
6884 struct remote_state
*rs
;
6886 struct target_waitstatus ws
;
6888 /* The architecture associated with the expedited registers. */
6891 /* Expedited registers. This makes remote debugging a bit more
6892 efficient for those targets that provide critical registers as
6893 part of their normal status mechanism (as another roundtrip to
6894 fetch them is avoided). */
6895 std::vector
<cached_reg_t
> regcache
;
6897 enum target_stop_reason stop_reason
;
6899 CORE_ADDR watch_data_address
;
6904 /* Return the length of the stop reply queue. */
6907 remote_target::stop_reply_queue_length ()
6909 remote_state
*rs
= get_remote_state ();
6910 return rs
->stop_reply_queue
.size ();
6914 remote_notif_stop_parse (remote_target
*remote
,
6915 struct notif_client
*self
, const char *buf
,
6916 struct notif_event
*event
)
6918 remote
->remote_parse_stop_reply (buf
, (struct stop_reply
*) event
);
6922 remote_notif_stop_ack (remote_target
*remote
,
6923 struct notif_client
*self
, const char *buf
,
6924 struct notif_event
*event
)
6926 struct stop_reply
*stop_reply
= (struct stop_reply
*) event
;
6929 putpkt (remote
, self
->ack_command
);
6931 if (stop_reply
->ws
.kind
== TARGET_WAITKIND_IGNORE
)
6933 /* We got an unknown stop reply. */
6934 error (_("Unknown stop reply"));
6937 remote
->push_stop_reply (stop_reply
);
6941 remote_notif_stop_can_get_pending_events (remote_target
*remote
,
6942 struct notif_client
*self
)
6944 /* We can't get pending events in remote_notif_process for
6945 notification stop, and we have to do this in remote_wait_ns
6946 instead. If we fetch all queued events from stub, remote stub
6947 may exit and we have no chance to process them back in
6949 remote_state
*rs
= remote
->get_remote_state ();
6950 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
6954 stop_reply::~stop_reply ()
6956 for (cached_reg_t
®
: regcache
)
6960 static notif_event_up
6961 remote_notif_stop_alloc_reply ()
6963 return notif_event_up (new struct stop_reply ());
6966 /* A client of notification Stop. */
6968 struct notif_client notif_client_stop
=
6972 remote_notif_stop_parse
,
6973 remote_notif_stop_ack
,
6974 remote_notif_stop_can_get_pending_events
,
6975 remote_notif_stop_alloc_reply
,
6979 /* Determine if THREAD_PTID is a pending fork parent thread. ARG contains
6980 the pid of the process that owns the threads we want to check, or
6981 -1 if we want to check all threads. */
6984 is_pending_fork_parent (struct target_waitstatus
*ws
, int event_pid
,
6987 if (ws
->kind
== TARGET_WAITKIND_FORKED
6988 || ws
->kind
== TARGET_WAITKIND_VFORKED
)
6990 if (event_pid
== -1 || event_pid
== thread_ptid
.pid ())
6997 /* Return the thread's pending status used to determine whether the
6998 thread is a fork parent stopped at a fork event. */
7000 static struct target_waitstatus
*
7001 thread_pending_fork_status (struct thread_info
*thread
)
7003 if (thread
->suspend
.waitstatus_pending_p
)
7004 return &thread
->suspend
.waitstatus
;
7006 return &thread
->pending_follow
;
7009 /* Determine if THREAD is a pending fork parent thread. */
7012 is_pending_fork_parent_thread (struct thread_info
*thread
)
7014 struct target_waitstatus
*ws
= thread_pending_fork_status (thread
);
7017 return is_pending_fork_parent (ws
, pid
, thread
->ptid
);
7020 /* If CONTEXT contains any fork child threads that have not been
7021 reported yet, remove them from the CONTEXT list. If such a
7022 thread exists it is because we are stopped at a fork catchpoint
7023 and have not yet called follow_fork, which will set up the
7024 host-side data structures for the new process. */
7027 remote_target::remove_new_fork_children (threads_listing_context
*context
)
7030 struct notif_client
*notif
= ¬if_client_stop
;
7032 /* For any threads stopped at a fork event, remove the corresponding
7033 fork child threads from the CONTEXT list. */
7034 for (thread_info
*thread
: all_non_exited_threads (this))
7036 struct target_waitstatus
*ws
= thread_pending_fork_status (thread
);
7038 if (is_pending_fork_parent (ws
, pid
, thread
->ptid
))
7039 context
->remove_thread (ws
->value
.related_pid
);
7042 /* Check for any pending fork events (not reported or processed yet)
7043 in process PID and remove those fork child threads from the
7044 CONTEXT list as well. */
7045 remote_notif_get_pending_events (notif
);
7046 for (auto &event
: get_remote_state ()->stop_reply_queue
)
7047 if (event
->ws
.kind
== TARGET_WAITKIND_FORKED
7048 || event
->ws
.kind
== TARGET_WAITKIND_VFORKED
7049 || event
->ws
.kind
== TARGET_WAITKIND_THREAD_EXITED
)
7050 context
->remove_thread (event
->ws
.value
.related_pid
);
7053 /* Check whether any event pending in the vStopped queue would prevent
7054 a global or process wildcard vCont action. Clear
7055 *may_global_wildcard if we can't do a global wildcard (vCont;c),
7056 and clear the event inferior's may_wildcard_vcont flag if we can't
7057 do a process-wide wildcard resume (vCont;c:pPID.-1). */
7060 remote_target::check_pending_events_prevent_wildcard_vcont
7061 (int *may_global_wildcard
)
7063 struct notif_client
*notif
= ¬if_client_stop
;
7065 remote_notif_get_pending_events (notif
);
7066 for (auto &event
: get_remote_state ()->stop_reply_queue
)
7068 if (event
->ws
.kind
== TARGET_WAITKIND_NO_RESUMED
7069 || event
->ws
.kind
== TARGET_WAITKIND_NO_HISTORY
)
7072 if (event
->ws
.kind
== TARGET_WAITKIND_FORKED
7073 || event
->ws
.kind
== TARGET_WAITKIND_VFORKED
)
7074 *may_global_wildcard
= 0;
7076 struct inferior
*inf
= find_inferior_ptid (this, event
->ptid
);
7078 /* This may be the first time we heard about this process.
7079 Regardless, we must not do a global wildcard resume, otherwise
7080 we'd resume this process too. */
7081 *may_global_wildcard
= 0;
7083 get_remote_inferior (inf
)->may_wildcard_vcont
= false;
7087 /* Discard all pending stop replies of inferior INF. */
7090 remote_target::discard_pending_stop_replies (struct inferior
*inf
)
7092 struct stop_reply
*reply
;
7093 struct remote_state
*rs
= get_remote_state ();
7094 struct remote_notif_state
*rns
= rs
->notif_state
;
7096 /* This function can be notified when an inferior exists. When the
7097 target is not remote, the notification state is NULL. */
7098 if (rs
->remote_desc
== NULL
)
7101 reply
= (struct stop_reply
*) rns
->pending_event
[notif_client_stop
.id
];
7103 /* Discard the in-flight notification. */
7104 if (reply
!= NULL
&& reply
->ptid
.pid () == inf
->pid
)
7107 rns
->pending_event
[notif_client_stop
.id
] = NULL
;
7110 /* Discard the stop replies we have already pulled with
7112 auto iter
= std::remove_if (rs
->stop_reply_queue
.begin (),
7113 rs
->stop_reply_queue
.end (),
7114 [=] (const stop_reply_up
&event
)
7116 return event
->ptid
.pid () == inf
->pid
;
7118 rs
->stop_reply_queue
.erase (iter
, rs
->stop_reply_queue
.end ());
7121 /* Discard the stop replies for RS in stop_reply_queue. */
7124 remote_target::discard_pending_stop_replies_in_queue ()
7126 remote_state
*rs
= get_remote_state ();
7128 /* Discard the stop replies we have already pulled with
7130 auto iter
= std::remove_if (rs
->stop_reply_queue
.begin (),
7131 rs
->stop_reply_queue
.end (),
7132 [=] (const stop_reply_up
&event
)
7134 return event
->rs
== rs
;
7136 rs
->stop_reply_queue
.erase (iter
, rs
->stop_reply_queue
.end ());
7139 /* Remove the first reply in 'stop_reply_queue' which matches
7143 remote_target::remote_notif_remove_queued_reply (ptid_t ptid
)
7145 remote_state
*rs
= get_remote_state ();
7147 auto iter
= std::find_if (rs
->stop_reply_queue
.begin (),
7148 rs
->stop_reply_queue
.end (),
7149 [=] (const stop_reply_up
&event
)
7151 return event
->ptid
.matches (ptid
);
7153 struct stop_reply
*result
;
7154 if (iter
== rs
->stop_reply_queue
.end ())
7158 result
= iter
->release ();
7159 rs
->stop_reply_queue
.erase (iter
);
7163 fprintf_unfiltered (gdb_stdlog
,
7164 "notif: discard queued event: 'Stop' in %s\n",
7165 target_pid_to_str (ptid
).c_str ());
7170 /* Look for a queued stop reply belonging to PTID. If one is found,
7171 remove it from the queue, and return it. Returns NULL if none is
7172 found. If there are still queued events left to process, tell the
7173 event loop to get back to target_wait soon. */
7176 remote_target::queued_stop_reply (ptid_t ptid
)
7178 remote_state
*rs
= get_remote_state ();
7179 struct stop_reply
*r
= remote_notif_remove_queued_reply (ptid
);
7181 if (!rs
->stop_reply_queue
.empty ())
7183 /* There's still at least an event left. */
7184 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7190 /* Push a fully parsed stop reply in the stop reply queue. Since we
7191 know that we now have at least one queued event left to pass to the
7192 core side, tell the event loop to get back to target_wait soon. */
7195 remote_target::push_stop_reply (struct stop_reply
*new_event
)
7197 remote_state
*rs
= get_remote_state ();
7198 rs
->stop_reply_queue
.push_back (stop_reply_up (new_event
));
7201 fprintf_unfiltered (gdb_stdlog
,
7202 "notif: push 'Stop' %s to queue %d\n",
7203 target_pid_to_str (new_event
->ptid
).c_str (),
7204 int (rs
->stop_reply_queue
.size ()));
7206 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7209 /* Returns true if we have a stop reply for PTID. */
7212 remote_target::peek_stop_reply (ptid_t ptid
)
7214 remote_state
*rs
= get_remote_state ();
7215 for (auto &event
: rs
->stop_reply_queue
)
7216 if (ptid
== event
->ptid
7217 && event
->ws
.kind
== TARGET_WAITKIND_STOPPED
)
7222 /* Helper for remote_parse_stop_reply. Return nonzero if the substring
7223 starting with P and ending with PEND matches PREFIX. */
7226 strprefix (const char *p
, const char *pend
, const char *prefix
)
7228 for ( ; p
< pend
; p
++, prefix
++)
7231 return *prefix
== '\0';
7234 /* Parse the stop reply in BUF. Either the function succeeds, and the
7235 result is stored in EVENT, or throws an error. */
7238 remote_target::remote_parse_stop_reply (const char *buf
, stop_reply
*event
)
7240 remote_arch_state
*rsa
= NULL
;
7245 event
->ptid
= null_ptid
;
7246 event
->rs
= get_remote_state ();
7247 event
->ws
.kind
= TARGET_WAITKIND_IGNORE
;
7248 event
->ws
.value
.integer
= 0;
7249 event
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
7250 event
->regcache
.clear ();
7255 case 'T': /* Status with PC, SP, FP, ... */
7256 /* Expedited reply, containing Signal, {regno, reg} repeat. */
7257 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
7259 n... = register number
7260 r... = register contents
7263 p
= &buf
[3]; /* after Txx */
7269 p1
= strchr (p
, ':');
7271 error (_("Malformed packet(a) (missing colon): %s\n\
7275 error (_("Malformed packet(a) (missing register number): %s\n\
7279 /* Some "registers" are actually extended stop information.
7280 Note if you're adding a new entry here: GDB 7.9 and
7281 earlier assume that all register "numbers" that start
7282 with an hex digit are real register numbers. Make sure
7283 the server only sends such a packet if it knows the
7284 client understands it. */
7286 if (strprefix (p
, p1
, "thread"))
7287 event
->ptid
= read_ptid (++p1
, &p
);
7288 else if (strprefix (p
, p1
, "syscall_entry"))
7292 event
->ws
.kind
= TARGET_WAITKIND_SYSCALL_ENTRY
;
7293 p
= unpack_varlen_hex (++p1
, &sysno
);
7294 event
->ws
.value
.syscall_number
= (int) sysno
;
7296 else if (strprefix (p
, p1
, "syscall_return"))
7300 event
->ws
.kind
= TARGET_WAITKIND_SYSCALL_RETURN
;
7301 p
= unpack_varlen_hex (++p1
, &sysno
);
7302 event
->ws
.value
.syscall_number
= (int) sysno
;
7304 else if (strprefix (p
, p1
, "watch")
7305 || strprefix (p
, p1
, "rwatch")
7306 || strprefix (p
, p1
, "awatch"))
7308 event
->stop_reason
= TARGET_STOPPED_BY_WATCHPOINT
;
7309 p
= unpack_varlen_hex (++p1
, &addr
);
7310 event
->watch_data_address
= (CORE_ADDR
) addr
;
7312 else if (strprefix (p
, p1
, "swbreak"))
7314 event
->stop_reason
= TARGET_STOPPED_BY_SW_BREAKPOINT
;
7316 /* Make sure the stub doesn't forget to indicate support
7318 if (packet_support (PACKET_swbreak_feature
) != PACKET_ENABLE
)
7319 error (_("Unexpected swbreak stop reason"));
7321 /* The value part is documented as "must be empty",
7322 though we ignore it, in case we ever decide to make
7323 use of it in a backward compatible way. */
7324 p
= strchrnul (p1
+ 1, ';');
7326 else if (strprefix (p
, p1
, "hwbreak"))
7328 event
->stop_reason
= TARGET_STOPPED_BY_HW_BREAKPOINT
;
7330 /* Make sure the stub doesn't forget to indicate support
7332 if (packet_support (PACKET_hwbreak_feature
) != PACKET_ENABLE
)
7333 error (_("Unexpected hwbreak stop reason"));
7336 p
= strchrnul (p1
+ 1, ';');
7338 else if (strprefix (p
, p1
, "library"))
7340 event
->ws
.kind
= TARGET_WAITKIND_LOADED
;
7341 p
= strchrnul (p1
+ 1, ';');
7343 else if (strprefix (p
, p1
, "replaylog"))
7345 event
->ws
.kind
= TARGET_WAITKIND_NO_HISTORY
;
7346 /* p1 will indicate "begin" or "end", but it makes
7347 no difference for now, so ignore it. */
7348 p
= strchrnul (p1
+ 1, ';');
7350 else if (strprefix (p
, p1
, "core"))
7354 p
= unpack_varlen_hex (++p1
, &c
);
7357 else if (strprefix (p
, p1
, "fork"))
7359 event
->ws
.value
.related_pid
= read_ptid (++p1
, &p
);
7360 event
->ws
.kind
= TARGET_WAITKIND_FORKED
;
7362 else if (strprefix (p
, p1
, "vfork"))
7364 event
->ws
.value
.related_pid
= read_ptid (++p1
, &p
);
7365 event
->ws
.kind
= TARGET_WAITKIND_VFORKED
;
7367 else if (strprefix (p
, p1
, "vforkdone"))
7369 event
->ws
.kind
= TARGET_WAITKIND_VFORK_DONE
;
7370 p
= strchrnul (p1
+ 1, ';');
7372 else if (strprefix (p
, p1
, "exec"))
7377 /* Determine the length of the execd pathname. */
7378 p
= unpack_varlen_hex (++p1
, &ignored
);
7379 pathlen
= (p
- p1
) / 2;
7381 /* Save the pathname for event reporting and for
7382 the next run command. */
7383 gdb::unique_xmalloc_ptr
<char[]> pathname
7384 ((char *) xmalloc (pathlen
+ 1));
7385 hex2bin (p1
, (gdb_byte
*) pathname
.get (), pathlen
);
7386 pathname
[pathlen
] = '\0';
7388 /* This is freed during event handling. */
7389 event
->ws
.value
.execd_pathname
= pathname
.release ();
7390 event
->ws
.kind
= TARGET_WAITKIND_EXECD
;
7392 /* Skip the registers included in this packet, since
7393 they may be for an architecture different from the
7394 one used by the original program. */
7397 else if (strprefix (p
, p1
, "create"))
7399 event
->ws
.kind
= TARGET_WAITKIND_THREAD_CREATED
;
7400 p
= strchrnul (p1
+ 1, ';');
7409 p
= strchrnul (p1
+ 1, ';');
7414 /* Maybe a real ``P'' register number. */
7415 p_temp
= unpack_varlen_hex (p
, &pnum
);
7416 /* If the first invalid character is the colon, we got a
7417 register number. Otherwise, it's an unknown stop
7421 /* If we haven't parsed the event's thread yet, find
7422 it now, in order to find the architecture of the
7423 reported expedited registers. */
7424 if (event
->ptid
== null_ptid
)
7426 /* If there is no thread-id information then leave
7427 the event->ptid as null_ptid. Later in
7428 process_stop_reply we will pick a suitable
7430 const char *thr
= strstr (p1
+ 1, ";thread:");
7432 event
->ptid
= read_ptid (thr
+ strlen (";thread:"),
7439 = (event
->ptid
== null_ptid
7441 : find_inferior_ptid (this, event
->ptid
));
7442 /* If this is the first time we learn anything
7443 about this process, skip the registers
7444 included in this packet, since we don't yet
7445 know which architecture to use to parse them.
7446 We'll determine the architecture later when
7447 we process the stop reply and retrieve the
7448 target description, via
7449 remote_notice_new_inferior ->
7450 post_create_inferior. */
7453 p
= strchrnul (p1
+ 1, ';');
7458 event
->arch
= inf
->gdbarch
;
7459 rsa
= event
->rs
->get_remote_arch_state (event
->arch
);
7463 = packet_reg_from_pnum (event
->arch
, rsa
, pnum
);
7464 cached_reg_t cached_reg
;
7467 error (_("Remote sent bad register number %s: %s\n\
7469 hex_string (pnum
), p
, buf
);
7471 cached_reg
.num
= reg
->regnum
;
7472 cached_reg
.data
= (gdb_byte
*)
7473 xmalloc (register_size (event
->arch
, reg
->regnum
));
7476 fieldsize
= hex2bin (p
, cached_reg
.data
,
7477 register_size (event
->arch
, reg
->regnum
));
7479 if (fieldsize
< register_size (event
->arch
, reg
->regnum
))
7480 warning (_("Remote reply is too short: %s"), buf
);
7482 event
->regcache
.push_back (cached_reg
);
7486 /* Not a number. Silently skip unknown optional
7488 p
= strchrnul (p1
+ 1, ';');
7493 error (_("Remote register badly formatted: %s\nhere: %s"),
7498 if (event
->ws
.kind
!= TARGET_WAITKIND_IGNORE
)
7502 case 'S': /* Old style status, just signal only. */
7506 event
->ws
.kind
= TARGET_WAITKIND_STOPPED
;
7507 sig
= (fromhex (buf
[1]) << 4) + fromhex (buf
[2]);
7508 if (GDB_SIGNAL_FIRST
<= sig
&& sig
< GDB_SIGNAL_LAST
)
7509 event
->ws
.value
.sig
= (enum gdb_signal
) sig
;
7511 event
->ws
.value
.sig
= GDB_SIGNAL_UNKNOWN
;
7514 case 'w': /* Thread exited. */
7518 event
->ws
.kind
= TARGET_WAITKIND_THREAD_EXITED
;
7519 p
= unpack_varlen_hex (&buf
[1], &value
);
7520 event
->ws
.value
.integer
= value
;
7522 error (_("stop reply packet badly formatted: %s"), buf
);
7523 event
->ptid
= read_ptid (++p
, NULL
);
7526 case 'W': /* Target exited. */
7531 /* GDB used to accept only 2 hex chars here. Stubs should
7532 only send more if they detect GDB supports multi-process
7534 p
= unpack_varlen_hex (&buf
[1], &value
);
7538 /* The remote process exited. */
7539 event
->ws
.kind
= TARGET_WAITKIND_EXITED
;
7540 event
->ws
.value
.integer
= value
;
7544 /* The remote process exited with a signal. */
7545 event
->ws
.kind
= TARGET_WAITKIND_SIGNALLED
;
7546 if (GDB_SIGNAL_FIRST
<= value
&& value
< GDB_SIGNAL_LAST
)
7547 event
->ws
.value
.sig
= (enum gdb_signal
) value
;
7549 event
->ws
.value
.sig
= GDB_SIGNAL_UNKNOWN
;
7552 /* If no process is specified, return null_ptid, and let the
7553 caller figure out the right process to use. */
7563 else if (startswith (p
, "process:"))
7567 p
+= sizeof ("process:") - 1;
7568 unpack_varlen_hex (p
, &upid
);
7572 error (_("unknown stop reply packet: %s"), buf
);
7575 error (_("unknown stop reply packet: %s"), buf
);
7576 event
->ptid
= ptid_t (pid
);
7580 event
->ws
.kind
= TARGET_WAITKIND_NO_RESUMED
;
7581 event
->ptid
= minus_one_ptid
;
7586 /* When the stub wants to tell GDB about a new notification reply, it
7587 sends a notification (%Stop, for example). Those can come it at
7588 any time, hence, we have to make sure that any pending
7589 putpkt/getpkt sequence we're making is finished, before querying
7590 the stub for more events with the corresponding ack command
7591 (vStopped, for example). E.g., if we started a vStopped sequence
7592 immediately upon receiving the notification, something like this
7600 1.6) <-- (registers reply to step #1.3)
7602 Obviously, the reply in step #1.6 would be unexpected to a vStopped
7605 To solve this, whenever we parse a %Stop notification successfully,
7606 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
7607 doing whatever we were doing:
7613 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
7614 2.5) <-- (registers reply to step #2.3)
7616 Eventually after step #2.5, we return to the event loop, which
7617 notices there's an event on the
7618 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
7619 associated callback --- the function below. At this point, we're
7620 always safe to start a vStopped sequence. :
7623 2.7) <-- T05 thread:2
7629 remote_target::remote_notif_get_pending_events (notif_client
*nc
)
7631 struct remote_state
*rs
= get_remote_state ();
7633 if (rs
->notif_state
->pending_event
[nc
->id
] != NULL
)
7636 fprintf_unfiltered (gdb_stdlog
,
7637 "notif: process: '%s' ack pending event\n",
7641 nc
->ack (this, nc
, rs
->buf
.data (),
7642 rs
->notif_state
->pending_event
[nc
->id
]);
7643 rs
->notif_state
->pending_event
[nc
->id
] = NULL
;
7647 getpkt (&rs
->buf
, 0);
7648 if (strcmp (rs
->buf
.data (), "OK") == 0)
7651 remote_notif_ack (this, nc
, rs
->buf
.data ());
7657 fprintf_unfiltered (gdb_stdlog
,
7658 "notif: process: '%s' no pending reply\n",
7663 /* Wrapper around remote_target::remote_notif_get_pending_events to
7664 avoid having to export the whole remote_target class. */
7667 remote_notif_get_pending_events (remote_target
*remote
, notif_client
*nc
)
7669 remote
->remote_notif_get_pending_events (nc
);
7672 /* Called when it is decided that STOP_REPLY holds the info of the
7673 event that is to be returned to the core. This function always
7674 destroys STOP_REPLY. */
7677 remote_target::process_stop_reply (struct stop_reply
*stop_reply
,
7678 struct target_waitstatus
*status
)
7682 *status
= stop_reply
->ws
;
7683 ptid
= stop_reply
->ptid
;
7685 /* If no thread/process was reported by the stub then use the first
7686 non-exited thread in the current target. */
7687 if (ptid
== null_ptid
)
7689 /* Some stop events apply to all threads in an inferior, while others
7690 only apply to a single thread. */
7691 bool is_stop_for_all_threads
7692 = (status
->kind
== TARGET_WAITKIND_EXITED
7693 || status
->kind
== TARGET_WAITKIND_SIGNALLED
);
7695 for (thread_info
*thr
: all_non_exited_threads (this))
7697 if (ptid
!= null_ptid
7698 && (!is_stop_for_all_threads
7699 || ptid
.pid () != thr
->ptid
.pid ()))
7701 static bool warned
= false;
7705 /* If you are seeing this warning then the remote target
7706 has stopped without specifying a thread-id, but the
7707 target does have multiple threads (or inferiors), and
7708 so GDB is having to guess which thread stopped.
7710 Examples of what might cause this are the target
7711 sending and 'S' stop packet, or a 'T' stop packet and
7712 not including a thread-id.
7714 Additionally, the target might send a 'W' or 'X
7715 packet without including a process-id, when the target
7716 has multiple running inferiors. */
7717 if (is_stop_for_all_threads
)
7718 warning (_("multi-inferior target stopped without "
7719 "sending a process-id, using first "
7720 "non-exited inferior"));
7722 warning (_("multi-threaded target stopped without "
7723 "sending a thread-id, using first "
7724 "non-exited thread"));
7730 /* If this is a stop for all threads then don't use a particular
7731 threads ptid, instead create a new ptid where only the pid
7733 if (is_stop_for_all_threads
)
7734 ptid
= ptid_t (thr
->ptid
.pid ());
7738 gdb_assert (ptid
!= null_ptid
);
7741 if (status
->kind
!= TARGET_WAITKIND_EXITED
7742 && status
->kind
!= TARGET_WAITKIND_SIGNALLED
7743 && status
->kind
!= TARGET_WAITKIND_NO_RESUMED
)
7745 /* Expedited registers. */
7746 if (!stop_reply
->regcache
.empty ())
7748 struct regcache
*regcache
7749 = get_thread_arch_regcache (this, ptid
, stop_reply
->arch
);
7751 for (cached_reg_t
®
: stop_reply
->regcache
)
7753 regcache
->raw_supply (reg
.num
, reg
.data
);
7757 stop_reply
->regcache
.clear ();
7760 remote_notice_new_inferior (ptid
, 0);
7761 remote_thread_info
*remote_thr
= get_remote_thread_info (this, ptid
);
7762 remote_thr
->core
= stop_reply
->core
;
7763 remote_thr
->stop_reason
= stop_reply
->stop_reason
;
7764 remote_thr
->watch_data_address
= stop_reply
->watch_data_address
;
7765 remote_thr
->vcont_resumed
= 0;
7772 /* The non-stop mode version of target_wait. */
7775 remote_target::wait_ns (ptid_t ptid
, struct target_waitstatus
*status
,
7776 target_wait_flags options
)
7778 struct remote_state
*rs
= get_remote_state ();
7779 struct stop_reply
*stop_reply
;
7783 /* If in non-stop mode, get out of getpkt even if a
7784 notification is received. */
7786 ret
= getpkt_or_notif_sane (&rs
->buf
, 0 /* forever */, &is_notif
);
7789 if (ret
!= -1 && !is_notif
)
7792 case 'E': /* Error of some sort. */
7793 /* We're out of sync with the target now. Did it continue
7794 or not? We can't tell which thread it was in non-stop,
7795 so just ignore this. */
7796 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
7798 case 'O': /* Console output. */
7799 remote_console_output (&rs
->buf
[1]);
7802 warning (_("Invalid remote reply: %s"), rs
->buf
.data ());
7806 /* Acknowledge a pending stop reply that may have arrived in the
7808 if (rs
->notif_state
->pending_event
[notif_client_stop
.id
] != NULL
)
7809 remote_notif_get_pending_events (¬if_client_stop
);
7811 /* If indeed we noticed a stop reply, we're done. */
7812 stop_reply
= queued_stop_reply (ptid
);
7813 if (stop_reply
!= NULL
)
7814 return process_stop_reply (stop_reply
, status
);
7816 /* Still no event. If we're just polling for an event, then
7817 return to the event loop. */
7818 if (options
& TARGET_WNOHANG
)
7820 status
->kind
= TARGET_WAITKIND_IGNORE
;
7821 return minus_one_ptid
;
7824 /* Otherwise do a blocking wait. */
7825 ret
= getpkt_or_notif_sane (&rs
->buf
, 1 /* forever */, &is_notif
);
7829 /* Return the first resumed thread. */
7832 first_remote_resumed_thread (remote_target
*target
)
7834 for (thread_info
*tp
: all_non_exited_threads (target
, minus_one_ptid
))
7840 /* Wait until the remote machine stops, then return, storing status in
7841 STATUS just as `wait' would. */
7844 remote_target::wait_as (ptid_t ptid
, target_waitstatus
*status
,
7845 target_wait_flags options
)
7847 struct remote_state
*rs
= get_remote_state ();
7848 ptid_t event_ptid
= null_ptid
;
7850 struct stop_reply
*stop_reply
;
7854 status
->kind
= TARGET_WAITKIND_IGNORE
;
7855 status
->value
.integer
= 0;
7857 stop_reply
= queued_stop_reply (ptid
);
7858 if (stop_reply
!= NULL
)
7859 return process_stop_reply (stop_reply
, status
);
7861 if (rs
->cached_wait_status
)
7862 /* Use the cached wait status, but only once. */
7863 rs
->cached_wait_status
= 0;
7868 int forever
= ((options
& TARGET_WNOHANG
) == 0
7869 && rs
->wait_forever_enabled_p
);
7871 if (!rs
->waiting_for_stop_reply
)
7873 status
->kind
= TARGET_WAITKIND_NO_RESUMED
;
7874 return minus_one_ptid
;
7877 /* FIXME: cagney/1999-09-27: If we're in async mode we should
7878 _never_ wait for ever -> test on target_is_async_p().
7879 However, before we do that we need to ensure that the caller
7880 knows how to take the target into/out of async mode. */
7881 ret
= getpkt_or_notif_sane (&rs
->buf
, forever
, &is_notif
);
7883 /* GDB gets a notification. Return to core as this event is
7885 if (ret
!= -1 && is_notif
)
7886 return minus_one_ptid
;
7888 if (ret
== -1 && (options
& TARGET_WNOHANG
) != 0)
7889 return minus_one_ptid
;
7892 buf
= rs
->buf
.data ();
7894 /* Assume that the target has acknowledged Ctrl-C unless we receive
7895 an 'F' or 'O' packet. */
7896 if (buf
[0] != 'F' && buf
[0] != 'O')
7897 rs
->ctrlc_pending_p
= 0;
7901 case 'E': /* Error of some sort. */
7902 /* We're out of sync with the target now. Did it continue or
7903 not? Not is more likely, so report a stop. */
7904 rs
->waiting_for_stop_reply
= 0;
7906 warning (_("Remote failure reply: %s"), buf
);
7907 status
->kind
= TARGET_WAITKIND_STOPPED
;
7908 status
->value
.sig
= GDB_SIGNAL_0
;
7910 case 'F': /* File-I/O request. */
7911 /* GDB may access the inferior memory while handling the File-I/O
7912 request, but we don't want GDB accessing memory while waiting
7913 for a stop reply. See the comments in putpkt_binary. Set
7914 waiting_for_stop_reply to 0 temporarily. */
7915 rs
->waiting_for_stop_reply
= 0;
7916 remote_fileio_request (this, buf
, rs
->ctrlc_pending_p
);
7917 rs
->ctrlc_pending_p
= 0;
7918 /* GDB handled the File-I/O request, and the target is running
7919 again. Keep waiting for events. */
7920 rs
->waiting_for_stop_reply
= 1;
7922 case 'N': case 'T': case 'S': case 'X': case 'W':
7924 /* There is a stop reply to handle. */
7925 rs
->waiting_for_stop_reply
= 0;
7928 = (struct stop_reply
*) remote_notif_parse (this,
7932 event_ptid
= process_stop_reply (stop_reply
, status
);
7935 case 'O': /* Console output. */
7936 remote_console_output (buf
+ 1);
7939 if (rs
->last_sent_signal
!= GDB_SIGNAL_0
)
7941 /* Zero length reply means that we tried 'S' or 'C' and the
7942 remote system doesn't support it. */
7943 target_terminal::ours_for_output ();
7945 ("Can't send signals to this remote system. %s not sent.\n",
7946 gdb_signal_to_name (rs
->last_sent_signal
));
7947 rs
->last_sent_signal
= GDB_SIGNAL_0
;
7948 target_terminal::inferior ();
7950 strcpy (buf
, rs
->last_sent_step
? "s" : "c");
7956 warning (_("Invalid remote reply: %s"), buf
);
7960 if (status
->kind
== TARGET_WAITKIND_NO_RESUMED
)
7961 return minus_one_ptid
;
7962 else if (status
->kind
== TARGET_WAITKIND_IGNORE
)
7964 /* Nothing interesting happened. If we're doing a non-blocking
7965 poll, we're done. Otherwise, go back to waiting. */
7966 if (options
& TARGET_WNOHANG
)
7967 return minus_one_ptid
;
7971 else if (status
->kind
!= TARGET_WAITKIND_EXITED
7972 && status
->kind
!= TARGET_WAITKIND_SIGNALLED
)
7974 if (event_ptid
!= null_ptid
)
7975 record_currthread (rs
, event_ptid
);
7977 event_ptid
= first_remote_resumed_thread (this);
7981 /* A process exit. Invalidate our notion of current thread. */
7982 record_currthread (rs
, minus_one_ptid
);
7983 /* It's possible that the packet did not include a pid. */
7984 if (event_ptid
== null_ptid
)
7985 event_ptid
= first_remote_resumed_thread (this);
7986 /* EVENT_PTID could still be NULL_PTID. Double-check. */
7987 if (event_ptid
== null_ptid
)
7988 event_ptid
= magic_null_ptid
;
7994 /* Wait until the remote machine stops, then return, storing status in
7995 STATUS just as `wait' would. */
7998 remote_target::wait (ptid_t ptid
, struct target_waitstatus
*status
,
7999 target_wait_flags options
)
8003 if (target_is_non_stop_p ())
8004 event_ptid
= wait_ns (ptid
, status
, options
);
8006 event_ptid
= wait_as (ptid
, status
, options
);
8008 if (target_is_async_p ())
8010 remote_state
*rs
= get_remote_state ();
8012 /* If there are are events left in the queue tell the event loop
8014 if (!rs
->stop_reply_queue
.empty ())
8015 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
8021 /* Fetch a single register using a 'p' packet. */
8024 remote_target::fetch_register_using_p (struct regcache
*regcache
,
8027 struct gdbarch
*gdbarch
= regcache
->arch ();
8028 struct remote_state
*rs
= get_remote_state ();
8030 gdb_byte
*regp
= (gdb_byte
*) alloca (register_size (gdbarch
, reg
->regnum
));
8033 if (packet_support (PACKET_p
) == PACKET_DISABLE
)
8036 if (reg
->pnum
== -1)
8039 p
= rs
->buf
.data ();
8041 p
+= hexnumstr (p
, reg
->pnum
);
8044 getpkt (&rs
->buf
, 0);
8046 buf
= rs
->buf
.data ();
8048 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_p
]))
8052 case PACKET_UNKNOWN
:
8055 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
8056 gdbarch_register_name (regcache
->arch (),
8061 /* If this register is unfetchable, tell the regcache. */
8064 regcache
->raw_supply (reg
->regnum
, NULL
);
8068 /* Otherwise, parse and supply the value. */
8074 error (_("fetch_register_using_p: early buf termination"));
8076 regp
[i
++] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
8079 regcache
->raw_supply (reg
->regnum
, regp
);
8083 /* Fetch the registers included in the target's 'g' packet. */
8086 remote_target::send_g_packet ()
8088 struct remote_state
*rs
= get_remote_state ();
8091 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "g");
8093 getpkt (&rs
->buf
, 0);
8094 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
8095 error (_("Could not read registers; remote failure reply '%s'"),
8098 /* We can get out of synch in various cases. If the first character
8099 in the buffer is not a hex character, assume that has happened
8100 and try to fetch another packet to read. */
8101 while ((rs
->buf
[0] < '0' || rs
->buf
[0] > '9')
8102 && (rs
->buf
[0] < 'A' || rs
->buf
[0] > 'F')
8103 && (rs
->buf
[0] < 'a' || rs
->buf
[0] > 'f')
8104 && rs
->buf
[0] != 'x') /* New: unavailable register value. */
8107 fprintf_unfiltered (gdb_stdlog
,
8108 "Bad register packet; fetching a new packet\n");
8109 getpkt (&rs
->buf
, 0);
8112 buf_len
= strlen (rs
->buf
.data ());
8114 /* Sanity check the received packet. */
8115 if (buf_len
% 2 != 0)
8116 error (_("Remote 'g' packet reply is of odd length: %s"), rs
->buf
.data ());
8122 remote_target::process_g_packet (struct regcache
*regcache
)
8124 struct gdbarch
*gdbarch
= regcache
->arch ();
8125 struct remote_state
*rs
= get_remote_state ();
8126 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8131 buf_len
= strlen (rs
->buf
.data ());
8133 /* Further sanity checks, with knowledge of the architecture. */
8134 if (buf_len
> 2 * rsa
->sizeof_g_packet
)
8135 error (_("Remote 'g' packet reply is too long (expected %ld bytes, got %d "
8137 rsa
->sizeof_g_packet
, buf_len
/ 2,
8140 /* Save the size of the packet sent to us by the target. It is used
8141 as a heuristic when determining the max size of packets that the
8142 target can safely receive. */
8143 if (rsa
->actual_register_packet_size
== 0)
8144 rsa
->actual_register_packet_size
= buf_len
;
8146 /* If this is smaller than we guessed the 'g' packet would be,
8147 update our records. A 'g' reply that doesn't include a register's
8148 value implies either that the register is not available, or that
8149 the 'p' packet must be used. */
8150 if (buf_len
< 2 * rsa
->sizeof_g_packet
)
8152 long sizeof_g_packet
= buf_len
/ 2;
8154 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8156 long offset
= rsa
->regs
[i
].offset
;
8157 long reg_size
= register_size (gdbarch
, i
);
8159 if (rsa
->regs
[i
].pnum
== -1)
8162 if (offset
>= sizeof_g_packet
)
8163 rsa
->regs
[i
].in_g_packet
= 0;
8164 else if (offset
+ reg_size
> sizeof_g_packet
)
8165 error (_("Truncated register %d in remote 'g' packet"), i
);
8167 rsa
->regs
[i
].in_g_packet
= 1;
8170 /* Looks valid enough, we can assume this is the correct length
8171 for a 'g' packet. It's important not to adjust
8172 rsa->sizeof_g_packet if we have truncated registers otherwise
8173 this "if" won't be run the next time the method is called
8174 with a packet of the same size and one of the internal errors
8175 below will trigger instead. */
8176 rsa
->sizeof_g_packet
= sizeof_g_packet
;
8179 regs
= (char *) alloca (rsa
->sizeof_g_packet
);
8181 /* Unimplemented registers read as all bits zero. */
8182 memset (regs
, 0, rsa
->sizeof_g_packet
);
8184 /* Reply describes registers byte by byte, each byte encoded as two
8185 hex characters. Suck them all up, then supply them to the
8186 register cacheing/storage mechanism. */
8188 p
= rs
->buf
.data ();
8189 for (i
= 0; i
< rsa
->sizeof_g_packet
; i
++)
8191 if (p
[0] == 0 || p
[1] == 0)
8192 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
8193 internal_error (__FILE__
, __LINE__
,
8194 _("unexpected end of 'g' packet reply"));
8196 if (p
[0] == 'x' && p
[1] == 'x')
8197 regs
[i
] = 0; /* 'x' */
8199 regs
[i
] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
8203 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8205 struct packet_reg
*r
= &rsa
->regs
[i
];
8206 long reg_size
= register_size (gdbarch
, i
);
8210 if ((r
->offset
+ reg_size
) * 2 > strlen (rs
->buf
.data ()))
8211 /* This shouldn't happen - we adjusted in_g_packet above. */
8212 internal_error (__FILE__
, __LINE__
,
8213 _("unexpected end of 'g' packet reply"));
8214 else if (rs
->buf
[r
->offset
* 2] == 'x')
8216 gdb_assert (r
->offset
* 2 < strlen (rs
->buf
.data ()));
8217 /* The register isn't available, mark it as such (at
8218 the same time setting the value to zero). */
8219 regcache
->raw_supply (r
->regnum
, NULL
);
8222 regcache
->raw_supply (r
->regnum
, regs
+ r
->offset
);
8228 remote_target::fetch_registers_using_g (struct regcache
*regcache
)
8231 process_g_packet (regcache
);
8234 /* Make the remote selected traceframe match GDB's selected
8238 remote_target::set_remote_traceframe ()
8241 struct remote_state
*rs
= get_remote_state ();
8243 if (rs
->remote_traceframe_number
== get_traceframe_number ())
8246 /* Avoid recursion, remote_trace_find calls us again. */
8247 rs
->remote_traceframe_number
= get_traceframe_number ();
8249 newnum
= target_trace_find (tfind_number
,
8250 get_traceframe_number (), 0, 0, NULL
);
8252 /* Should not happen. If it does, all bets are off. */
8253 if (newnum
!= get_traceframe_number ())
8254 warning (_("could not set remote traceframe"));
8258 remote_target::fetch_registers (struct regcache
*regcache
, int regnum
)
8260 struct gdbarch
*gdbarch
= regcache
->arch ();
8261 struct remote_state
*rs
= get_remote_state ();
8262 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8265 set_remote_traceframe ();
8266 set_general_thread (regcache
->ptid ());
8270 packet_reg
*reg
= packet_reg_from_regnum (gdbarch
, rsa
, regnum
);
8272 gdb_assert (reg
!= NULL
);
8274 /* If this register might be in the 'g' packet, try that first -
8275 we are likely to read more than one register. If this is the
8276 first 'g' packet, we might be overly optimistic about its
8277 contents, so fall back to 'p'. */
8278 if (reg
->in_g_packet
)
8280 fetch_registers_using_g (regcache
);
8281 if (reg
->in_g_packet
)
8285 if (fetch_register_using_p (regcache
, reg
))
8288 /* This register is not available. */
8289 regcache
->raw_supply (reg
->regnum
, NULL
);
8294 fetch_registers_using_g (regcache
);
8296 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8297 if (!rsa
->regs
[i
].in_g_packet
)
8298 if (!fetch_register_using_p (regcache
, &rsa
->regs
[i
]))
8300 /* This register is not available. */
8301 regcache
->raw_supply (i
, NULL
);
8305 /* Prepare to store registers. Since we may send them all (using a
8306 'G' request), we have to read out the ones we don't want to change
8310 remote_target::prepare_to_store (struct regcache
*regcache
)
8312 struct remote_state
*rs
= get_remote_state ();
8313 remote_arch_state
*rsa
= rs
->get_remote_arch_state (regcache
->arch ());
8316 /* Make sure the entire registers array is valid. */
8317 switch (packet_support (PACKET_P
))
8319 case PACKET_DISABLE
:
8320 case PACKET_SUPPORT_UNKNOWN
:
8321 /* Make sure all the necessary registers are cached. */
8322 for (i
= 0; i
< gdbarch_num_regs (regcache
->arch ()); i
++)
8323 if (rsa
->regs
[i
].in_g_packet
)
8324 regcache
->raw_update (rsa
->regs
[i
].regnum
);
8331 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
8332 packet was not recognized. */
8335 remote_target::store_register_using_P (const struct regcache
*regcache
,
8338 struct gdbarch
*gdbarch
= regcache
->arch ();
8339 struct remote_state
*rs
= get_remote_state ();
8340 /* Try storing a single register. */
8341 char *buf
= rs
->buf
.data ();
8342 gdb_byte
*regp
= (gdb_byte
*) alloca (register_size (gdbarch
, reg
->regnum
));
8345 if (packet_support (PACKET_P
) == PACKET_DISABLE
)
8348 if (reg
->pnum
== -1)
8351 xsnprintf (buf
, get_remote_packet_size (), "P%s=", phex_nz (reg
->pnum
, 0));
8352 p
= buf
+ strlen (buf
);
8353 regcache
->raw_collect (reg
->regnum
, regp
);
8354 bin2hex (regp
, p
, register_size (gdbarch
, reg
->regnum
));
8356 getpkt (&rs
->buf
, 0);
8358 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_P
]))
8363 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
8364 gdbarch_register_name (gdbarch
, reg
->regnum
), rs
->buf
.data ());
8365 case PACKET_UNKNOWN
:
8368 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
8372 /* Store register REGNUM, or all registers if REGNUM == -1, from the
8373 contents of the register cache buffer. FIXME: ignores errors. */
8376 remote_target::store_registers_using_G (const struct regcache
*regcache
)
8378 struct remote_state
*rs
= get_remote_state ();
8379 remote_arch_state
*rsa
= rs
->get_remote_arch_state (regcache
->arch ());
8383 /* Extract all the registers in the regcache copying them into a
8388 regs
= (gdb_byte
*) alloca (rsa
->sizeof_g_packet
);
8389 memset (regs
, 0, rsa
->sizeof_g_packet
);
8390 for (i
= 0; i
< gdbarch_num_regs (regcache
->arch ()); i
++)
8392 struct packet_reg
*r
= &rsa
->regs
[i
];
8395 regcache
->raw_collect (r
->regnum
, regs
+ r
->offset
);
8399 /* Command describes registers byte by byte,
8400 each byte encoded as two hex characters. */
8401 p
= rs
->buf
.data ();
8403 bin2hex (regs
, p
, rsa
->sizeof_g_packet
);
8405 getpkt (&rs
->buf
, 0);
8406 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
8407 error (_("Could not write registers; remote failure reply '%s'"),
8411 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
8412 of the register cache buffer. FIXME: ignores errors. */
8415 remote_target::store_registers (struct regcache
*regcache
, int regnum
)
8417 struct gdbarch
*gdbarch
= regcache
->arch ();
8418 struct remote_state
*rs
= get_remote_state ();
8419 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8422 set_remote_traceframe ();
8423 set_general_thread (regcache
->ptid ());
8427 packet_reg
*reg
= packet_reg_from_regnum (gdbarch
, rsa
, regnum
);
8429 gdb_assert (reg
!= NULL
);
8431 /* Always prefer to store registers using the 'P' packet if
8432 possible; we often change only a small number of registers.
8433 Sometimes we change a larger number; we'd need help from a
8434 higher layer to know to use 'G'. */
8435 if (store_register_using_P (regcache
, reg
))
8438 /* For now, don't complain if we have no way to write the
8439 register. GDB loses track of unavailable registers too
8440 easily. Some day, this may be an error. We don't have
8441 any way to read the register, either... */
8442 if (!reg
->in_g_packet
)
8445 store_registers_using_G (regcache
);
8449 store_registers_using_G (regcache
);
8451 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8452 if (!rsa
->regs
[i
].in_g_packet
)
8453 if (!store_register_using_P (regcache
, &rsa
->regs
[i
]))
8454 /* See above for why we do not issue an error here. */
8459 /* Return the number of hex digits in num. */
8462 hexnumlen (ULONGEST num
)
8466 for (i
= 0; num
!= 0; i
++)
8469 return std::max (i
, 1);
8472 /* Set BUF to the minimum number of hex digits representing NUM. */
8475 hexnumstr (char *buf
, ULONGEST num
)
8477 int len
= hexnumlen (num
);
8479 return hexnumnstr (buf
, num
, len
);
8483 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
8486 hexnumnstr (char *buf
, ULONGEST num
, int width
)
8492 for (i
= width
- 1; i
>= 0; i
--)
8494 buf
[i
] = "0123456789abcdef"[(num
& 0xf)];
8501 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
8504 remote_address_masked (CORE_ADDR addr
)
8506 unsigned int address_size
= remote_address_size
;
8508 /* If "remoteaddresssize" was not set, default to target address size. */
8510 address_size
= gdbarch_addr_bit (target_gdbarch ());
8512 if (address_size
> 0
8513 && address_size
< (sizeof (ULONGEST
) * 8))
8515 /* Only create a mask when that mask can safely be constructed
8516 in a ULONGEST variable. */
8519 mask
= (mask
<< address_size
) - 1;
8525 /* Determine whether the remote target supports binary downloading.
8526 This is accomplished by sending a no-op memory write of zero length
8527 to the target at the specified address. It does not suffice to send
8528 the whole packet, since many stubs strip the eighth bit and
8529 subsequently compute a wrong checksum, which causes real havoc with
8532 NOTE: This can still lose if the serial line is not eight-bit
8533 clean. In cases like this, the user should clear "remote
8537 remote_target::check_binary_download (CORE_ADDR addr
)
8539 struct remote_state
*rs
= get_remote_state ();
8541 switch (packet_support (PACKET_X
))
8543 case PACKET_DISABLE
:
8547 case PACKET_SUPPORT_UNKNOWN
:
8551 p
= rs
->buf
.data ();
8553 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8555 p
+= hexnumstr (p
, (ULONGEST
) 0);
8559 putpkt_binary (rs
->buf
.data (), (int) (p
- rs
->buf
.data ()));
8560 getpkt (&rs
->buf
, 0);
8562 if (rs
->buf
[0] == '\0')
8565 fprintf_unfiltered (gdb_stdlog
,
8566 "binary downloading NOT "
8567 "supported by target\n");
8568 remote_protocol_packets
[PACKET_X
].support
= PACKET_DISABLE
;
8573 fprintf_unfiltered (gdb_stdlog
,
8574 "binary downloading supported by target\n");
8575 remote_protocol_packets
[PACKET_X
].support
= PACKET_ENABLE
;
8582 /* Helper function to resize the payload in order to try to get a good
8583 alignment. We try to write an amount of data such that the next write will
8584 start on an address aligned on REMOTE_ALIGN_WRITES. */
8587 align_for_efficient_write (int todo
, CORE_ADDR memaddr
)
8589 return ((memaddr
+ todo
) & ~(REMOTE_ALIGN_WRITES
- 1)) - memaddr
;
8592 /* Write memory data directly to the remote machine.
8593 This does not inform the data cache; the data cache uses this.
8594 HEADER is the starting part of the packet.
8595 MEMADDR is the address in the remote memory space.
8596 MYADDR is the address of the buffer in our space.
8597 LEN_UNITS is the number of addressable units to write.
8598 UNIT_SIZE is the length in bytes of an addressable unit.
8599 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
8600 should send data as binary ('X'), or hex-encoded ('M').
8602 The function creates packet of the form
8603 <HEADER><ADDRESS>,<LENGTH>:<DATA>
8605 where encoding of <DATA> is terminated by PACKET_FORMAT.
8607 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
8610 Return the transferred status, error or OK (an
8611 'enum target_xfer_status' value). Save the number of addressable units
8612 transferred in *XFERED_LEN_UNITS. Only transfer a single packet.
8614 On a platform with an addressable memory size of 2 bytes (UNIT_SIZE == 2), an
8615 exchange between gdb and the stub could look like (?? in place of the
8621 -> $M1000,3:eeeeffffeeee#??
8625 <- eeeeffffeeeedddd */
8628 remote_target::remote_write_bytes_aux (const char *header
, CORE_ADDR memaddr
,
8629 const gdb_byte
*myaddr
,
8632 ULONGEST
*xfered_len_units
,
8633 char packet_format
, int use_length
)
8635 struct remote_state
*rs
= get_remote_state ();
8641 int payload_capacity_bytes
;
8642 int payload_length_bytes
;
8644 if (packet_format
!= 'X' && packet_format
!= 'M')
8645 internal_error (__FILE__
, __LINE__
,
8646 _("remote_write_bytes_aux: bad packet format"));
8649 return TARGET_XFER_EOF
;
8651 payload_capacity_bytes
= get_memory_write_packet_size ();
8653 /* The packet buffer will be large enough for the payload;
8654 get_memory_packet_size ensures this. */
8657 /* Compute the size of the actual payload by subtracting out the
8658 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
8660 payload_capacity_bytes
-= strlen ("$,:#NN");
8662 /* The comma won't be used. */
8663 payload_capacity_bytes
+= 1;
8664 payload_capacity_bytes
-= strlen (header
);
8665 payload_capacity_bytes
-= hexnumlen (memaddr
);
8667 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
8669 strcat (rs
->buf
.data (), header
);
8670 p
= rs
->buf
.data () + strlen (header
);
8672 /* Compute a best guess of the number of bytes actually transfered. */
8673 if (packet_format
== 'X')
8675 /* Best guess at number of bytes that will fit. */
8676 todo_units
= std::min (len_units
,
8677 (ULONGEST
) payload_capacity_bytes
/ unit_size
);
8679 payload_capacity_bytes
-= hexnumlen (todo_units
);
8680 todo_units
= std::min (todo_units
, payload_capacity_bytes
/ unit_size
);
8684 /* Number of bytes that will fit. */
8686 = std::min (len_units
,
8687 (ULONGEST
) (payload_capacity_bytes
/ unit_size
) / 2);
8689 payload_capacity_bytes
-= hexnumlen (todo_units
);
8690 todo_units
= std::min (todo_units
,
8691 (payload_capacity_bytes
/ unit_size
) / 2);
8694 if (todo_units
<= 0)
8695 internal_error (__FILE__
, __LINE__
,
8696 _("minimum packet size too small to write data"));
8698 /* If we already need another packet, then try to align the end
8699 of this packet to a useful boundary. */
8700 if (todo_units
> 2 * REMOTE_ALIGN_WRITES
&& todo_units
< len_units
)
8701 todo_units
= align_for_efficient_write (todo_units
, memaddr
);
8703 /* Append "<memaddr>". */
8704 memaddr
= remote_address_masked (memaddr
);
8705 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
8712 /* Append the length and retain its location and size. It may need to be
8713 adjusted once the packet body has been created. */
8715 plenlen
= hexnumstr (p
, (ULONGEST
) todo_units
);
8723 /* Append the packet body. */
8724 if (packet_format
== 'X')
8726 /* Binary mode. Send target system values byte by byte, in
8727 increasing byte addresses. Only escape certain critical
8729 payload_length_bytes
=
8730 remote_escape_output (myaddr
, todo_units
, unit_size
, (gdb_byte
*) p
,
8731 &units_written
, payload_capacity_bytes
);
8733 /* If not all TODO units fit, then we'll need another packet. Make
8734 a second try to keep the end of the packet aligned. Don't do
8735 this if the packet is tiny. */
8736 if (units_written
< todo_units
&& units_written
> 2 * REMOTE_ALIGN_WRITES
)
8740 new_todo_units
= align_for_efficient_write (units_written
, memaddr
);
8742 if (new_todo_units
!= units_written
)
8743 payload_length_bytes
=
8744 remote_escape_output (myaddr
, new_todo_units
, unit_size
,
8745 (gdb_byte
*) p
, &units_written
,
8746 payload_capacity_bytes
);
8749 p
+= payload_length_bytes
;
8750 if (use_length
&& units_written
< todo_units
)
8752 /* Escape chars have filled up the buffer prematurely,
8753 and we have actually sent fewer units than planned.
8754 Fix-up the length field of the packet. Use the same
8755 number of characters as before. */
8756 plen
+= hexnumnstr (plen
, (ULONGEST
) units_written
,
8758 *plen
= ':'; /* overwrite \0 from hexnumnstr() */
8763 /* Normal mode: Send target system values byte by byte, in
8764 increasing byte addresses. Each byte is encoded as a two hex
8766 p
+= 2 * bin2hex (myaddr
, p
, todo_units
* unit_size
);
8767 units_written
= todo_units
;
8770 putpkt_binary (rs
->buf
.data (), (int) (p
- rs
->buf
.data ()));
8771 getpkt (&rs
->buf
, 0);
8773 if (rs
->buf
[0] == 'E')
8774 return TARGET_XFER_E_IO
;
8776 /* Return UNITS_WRITTEN, not TODO_UNITS, in case escape chars caused us to
8777 send fewer units than we'd planned. */
8778 *xfered_len_units
= (ULONGEST
) units_written
;
8779 return (*xfered_len_units
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
8782 /* Write memory data directly to the remote machine.
8783 This does not inform the data cache; the data cache uses this.
8784 MEMADDR is the address in the remote memory space.
8785 MYADDR is the address of the buffer in our space.
8786 LEN is the number of bytes.
8788 Return the transferred status, error or OK (an
8789 'enum target_xfer_status' value). Save the number of bytes
8790 transferred in *XFERED_LEN. Only transfer a single packet. */
8793 remote_target::remote_write_bytes (CORE_ADDR memaddr
, const gdb_byte
*myaddr
,
8794 ULONGEST len
, int unit_size
,
8795 ULONGEST
*xfered_len
)
8797 const char *packet_format
= NULL
;
8799 /* Check whether the target supports binary download. */
8800 check_binary_download (memaddr
);
8802 switch (packet_support (PACKET_X
))
8805 packet_format
= "X";
8807 case PACKET_DISABLE
:
8808 packet_format
= "M";
8810 case PACKET_SUPPORT_UNKNOWN
:
8811 internal_error (__FILE__
, __LINE__
,
8812 _("remote_write_bytes: bad internal state"));
8814 internal_error (__FILE__
, __LINE__
, _("bad switch"));
8817 return remote_write_bytes_aux (packet_format
,
8818 memaddr
, myaddr
, len
, unit_size
, xfered_len
,
8819 packet_format
[0], 1);
8822 /* Read memory data directly from the remote machine.
8823 This does not use the data cache; the data cache uses this.
8824 MEMADDR is the address in the remote memory space.
8825 MYADDR is the address of the buffer in our space.
8826 LEN_UNITS is the number of addressable memory units to read..
8827 UNIT_SIZE is the length in bytes of an addressable unit.
8829 Return the transferred status, error or OK (an
8830 'enum target_xfer_status' value). Save the number of bytes
8831 transferred in *XFERED_LEN_UNITS.
8833 See the comment of remote_write_bytes_aux for an example of
8834 memory read/write exchange between gdb and the stub. */
8837 remote_target::remote_read_bytes_1 (CORE_ADDR memaddr
, gdb_byte
*myaddr
,
8839 int unit_size
, ULONGEST
*xfered_len_units
)
8841 struct remote_state
*rs
= get_remote_state ();
8842 int buf_size_bytes
; /* Max size of packet output buffer. */
8847 buf_size_bytes
= get_memory_read_packet_size ();
8848 /* The packet buffer will be large enough for the payload;
8849 get_memory_packet_size ensures this. */
8851 /* Number of units that will fit. */
8852 todo_units
= std::min (len_units
,
8853 (ULONGEST
) (buf_size_bytes
/ unit_size
) / 2);
8855 /* Construct "m"<memaddr>","<len>". */
8856 memaddr
= remote_address_masked (memaddr
);
8857 p
= rs
->buf
.data ();
8859 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
8861 p
+= hexnumstr (p
, (ULONGEST
) todo_units
);
8864 getpkt (&rs
->buf
, 0);
8865 if (rs
->buf
[0] == 'E'
8866 && isxdigit (rs
->buf
[1]) && isxdigit (rs
->buf
[2])
8867 && rs
->buf
[3] == '\0')
8868 return TARGET_XFER_E_IO
;
8869 /* Reply describes memory byte by byte, each byte encoded as two hex
8871 p
= rs
->buf
.data ();
8872 decoded_bytes
= hex2bin (p
, myaddr
, todo_units
* unit_size
);
8873 /* Return what we have. Let higher layers handle partial reads. */
8874 *xfered_len_units
= (ULONGEST
) (decoded_bytes
/ unit_size
);
8875 return (*xfered_len_units
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
8878 /* Using the set of read-only target sections of remote, read live
8881 For interface/parameters/return description see target.h,
8885 remote_target::remote_xfer_live_readonly_partial (gdb_byte
*readbuf
,
8889 ULONGEST
*xfered_len
)
8891 struct target_section
*secp
;
8892 struct target_section_table
*table
;
8894 secp
= target_section_by_addr (this, memaddr
);
8896 && (bfd_section_flags (secp
->the_bfd_section
) & SEC_READONLY
))
8898 struct target_section
*p
;
8899 ULONGEST memend
= memaddr
+ len
;
8901 table
= target_get_section_table (this);
8903 for (p
= table
->sections
; p
< table
->sections_end
; p
++)
8905 if (memaddr
>= p
->addr
)
8907 if (memend
<= p
->endaddr
)
8909 /* Entire transfer is within this section. */
8910 return remote_read_bytes_1 (memaddr
, readbuf
, len
, unit_size
,
8913 else if (memaddr
>= p
->endaddr
)
8915 /* This section ends before the transfer starts. */
8920 /* This section overlaps the transfer. Just do half. */
8921 len
= p
->endaddr
- memaddr
;
8922 return remote_read_bytes_1 (memaddr
, readbuf
, len
, unit_size
,
8929 return TARGET_XFER_EOF
;
8932 /* Similar to remote_read_bytes_1, but it reads from the remote stub
8933 first if the requested memory is unavailable in traceframe.
8934 Otherwise, fall back to remote_read_bytes_1. */
8937 remote_target::remote_read_bytes (CORE_ADDR memaddr
,
8938 gdb_byte
*myaddr
, ULONGEST len
, int unit_size
,
8939 ULONGEST
*xfered_len
)
8942 return TARGET_XFER_EOF
;
8944 if (get_traceframe_number () != -1)
8946 std::vector
<mem_range
> available
;
8948 /* If we fail to get the set of available memory, then the
8949 target does not support querying traceframe info, and so we
8950 attempt reading from the traceframe anyway (assuming the
8951 target implements the old QTro packet then). */
8952 if (traceframe_available_memory (&available
, memaddr
, len
))
8954 if (available
.empty () || available
[0].start
!= memaddr
)
8956 enum target_xfer_status res
;
8958 /* Don't read into the traceframe's available
8960 if (!available
.empty ())
8962 LONGEST oldlen
= len
;
8964 len
= available
[0].start
- memaddr
;
8965 gdb_assert (len
<= oldlen
);
8968 /* This goes through the topmost target again. */
8969 res
= remote_xfer_live_readonly_partial (myaddr
, memaddr
,
8970 len
, unit_size
, xfered_len
);
8971 if (res
== TARGET_XFER_OK
)
8972 return TARGET_XFER_OK
;
8975 /* No use trying further, we know some memory starting
8976 at MEMADDR isn't available. */
8978 return (*xfered_len
!= 0) ?
8979 TARGET_XFER_UNAVAILABLE
: TARGET_XFER_EOF
;
8983 /* Don't try to read more than how much is available, in
8984 case the target implements the deprecated QTro packet to
8985 cater for older GDBs (the target's knowledge of read-only
8986 sections may be outdated by now). */
8987 len
= available
[0].length
;
8991 return remote_read_bytes_1 (memaddr
, myaddr
, len
, unit_size
, xfered_len
);
8996 /* Sends a packet with content determined by the printf format string
8997 FORMAT and the remaining arguments, then gets the reply. Returns
8998 whether the packet was a success, a failure, or unknown. */
9001 remote_target::remote_send_printf (const char *format
, ...)
9003 struct remote_state
*rs
= get_remote_state ();
9004 int max_size
= get_remote_packet_size ();
9007 va_start (ap
, format
);
9010 int size
= vsnprintf (rs
->buf
.data (), max_size
, format
, ap
);
9014 if (size
>= max_size
)
9015 internal_error (__FILE__
, __LINE__
, _("Too long remote packet."));
9017 if (putpkt (rs
->buf
) < 0)
9018 error (_("Communication problem with target."));
9021 getpkt (&rs
->buf
, 0);
9023 return packet_check_result (rs
->buf
);
9026 /* Flash writing can take quite some time. We'll set
9027 effectively infinite timeout for flash operations.
9028 In future, we'll need to decide on a better approach. */
9029 static const int remote_flash_timeout
= 1000;
9032 remote_target::flash_erase (ULONGEST address
, LONGEST length
)
9034 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
9035 enum packet_result ret
;
9036 scoped_restore restore_timeout
9037 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9039 ret
= remote_send_printf ("vFlashErase:%s,%s",
9040 phex (address
, addr_size
),
9044 case PACKET_UNKNOWN
:
9045 error (_("Remote target does not support flash erase"));
9047 error (_("Error erasing flash with vFlashErase packet"));
9054 remote_target::remote_flash_write (ULONGEST address
,
9055 ULONGEST length
, ULONGEST
*xfered_len
,
9056 const gdb_byte
*data
)
9058 scoped_restore restore_timeout
9059 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9060 return remote_write_bytes_aux ("vFlashWrite:", address
, data
, length
, 1,
9065 remote_target::flash_done ()
9069 scoped_restore restore_timeout
9070 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9072 ret
= remote_send_printf ("vFlashDone");
9076 case PACKET_UNKNOWN
:
9077 error (_("Remote target does not support vFlashDone"));
9079 error (_("Error finishing flash operation"));
9086 remote_target::files_info ()
9088 puts_filtered ("Debugging a target over a serial line.\n");
9091 /* Stuff for dealing with the packets which are part of this protocol.
9092 See comment at top of file for details. */
9094 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
9095 error to higher layers. Called when a serial error is detected.
9096 The exception message is STRING, followed by a colon and a blank,
9097 the system error message for errno at function entry and final dot
9098 for output compatibility with throw_perror_with_name. */
9101 unpush_and_perror (remote_target
*target
, const char *string
)
9103 int saved_errno
= errno
;
9105 remote_unpush_target (target
);
9106 throw_error (TARGET_CLOSE_ERROR
, "%s: %s.", string
,
9107 safe_strerror (saved_errno
));
9110 /* Read a single character from the remote end. The current quit
9111 handler is overridden to avoid quitting in the middle of packet
9112 sequence, as that would break communication with the remote server.
9113 See remote_serial_quit_handler for more detail. */
9116 remote_target::readchar (int timeout
)
9119 struct remote_state
*rs
= get_remote_state ();
9122 scoped_restore restore_quit_target
9123 = make_scoped_restore (&curr_quit_handler_target
, this);
9124 scoped_restore restore_quit
9125 = make_scoped_restore (&quit_handler
, ::remote_serial_quit_handler
);
9127 rs
->got_ctrlc_during_io
= 0;
9129 ch
= serial_readchar (rs
->remote_desc
, timeout
);
9131 if (rs
->got_ctrlc_during_io
)
9138 switch ((enum serial_rc
) ch
)
9141 remote_unpush_target (this);
9142 throw_error (TARGET_CLOSE_ERROR
, _("Remote connection closed"));
9145 unpush_and_perror (this, _("Remote communication error. "
9146 "Target disconnected."));
9148 case SERIAL_TIMEOUT
:
9154 /* Wrapper for serial_write that closes the target and throws if
9155 writing fails. The current quit handler is overridden to avoid
9156 quitting in the middle of packet sequence, as that would break
9157 communication with the remote server. See
9158 remote_serial_quit_handler for more detail. */
9161 remote_target::remote_serial_write (const char *str
, int len
)
9163 struct remote_state
*rs
= get_remote_state ();
9165 scoped_restore restore_quit_target
9166 = make_scoped_restore (&curr_quit_handler_target
, this);
9167 scoped_restore restore_quit
9168 = make_scoped_restore (&quit_handler
, ::remote_serial_quit_handler
);
9170 rs
->got_ctrlc_during_io
= 0;
9172 if (serial_write (rs
->remote_desc
, str
, len
))
9174 unpush_and_perror (this, _("Remote communication error. "
9175 "Target disconnected."));
9178 if (rs
->got_ctrlc_during_io
)
9182 /* Return a string representing an escaped version of BUF, of len N.
9183 E.g. \n is converted to \\n, \t to \\t, etc. */
9186 escape_buffer (const char *buf
, int n
)
9190 stb
.putstrn (buf
, n
, '\\');
9191 return std::move (stb
.string ());
9194 /* Display a null-terminated packet on stdout, for debugging, using C
9198 print_packet (const char *buf
)
9200 puts_filtered ("\"");
9201 fputstr_filtered (buf
, '"', gdb_stdout
);
9202 puts_filtered ("\"");
9206 remote_target::putpkt (const char *buf
)
9208 return putpkt_binary (buf
, strlen (buf
));
9211 /* Wrapper around remote_target::putpkt to avoid exporting
9215 putpkt (remote_target
*remote
, const char *buf
)
9217 return remote
->putpkt (buf
);
9220 /* Send a packet to the remote machine, with error checking. The data
9221 of the packet is in BUF. The string in BUF can be at most
9222 get_remote_packet_size () - 5 to account for the $, # and checksum,
9223 and for a possible /0 if we are debugging (remote_debug) and want
9224 to print the sent packet as a string. */
9227 remote_target::putpkt_binary (const char *buf
, int cnt
)
9229 struct remote_state
*rs
= get_remote_state ();
9231 unsigned char csum
= 0;
9232 gdb::def_vector
<char> data (cnt
+ 6);
9233 char *buf2
= data
.data ();
9239 /* Catch cases like trying to read memory or listing threads while
9240 we're waiting for a stop reply. The remote server wouldn't be
9241 ready to handle this request, so we'd hang and timeout. We don't
9242 have to worry about this in synchronous mode, because in that
9243 case it's not possible to issue a command while the target is
9244 running. This is not a problem in non-stop mode, because in that
9245 case, the stub is always ready to process serial input. */
9246 if (!target_is_non_stop_p ()
9247 && target_is_async_p ()
9248 && rs
->waiting_for_stop_reply
)
9250 error (_("Cannot execute this command while the target is running.\n"
9251 "Use the \"interrupt\" command to stop the target\n"
9252 "and then try again."));
9255 /* We're sending out a new packet. Make sure we don't look at a
9256 stale cached response. */
9257 rs
->cached_wait_status
= 0;
9259 /* Copy the packet into buffer BUF2, encapsulating it
9260 and giving it a checksum. */
9265 for (i
= 0; i
< cnt
; i
++)
9271 *p
++ = tohex ((csum
>> 4) & 0xf);
9272 *p
++ = tohex (csum
& 0xf);
9274 /* Send it over and over until we get a positive ack. */
9278 int started_error_output
= 0;
9284 int len
= (int) (p
- buf2
);
9287 if (remote_packet_max_chars
< 0)
9290 max_chars
= remote_packet_max_chars
;
9293 = escape_buffer (buf2
, std::min (len
, max_chars
));
9295 fprintf_unfiltered (gdb_stdlog
, "Sending packet: %s", str
.c_str ());
9297 if (len
> max_chars
)
9298 fprintf_unfiltered (gdb_stdlog
, "[%d bytes omitted]",
9301 fprintf_unfiltered (gdb_stdlog
, "...");
9303 gdb_flush (gdb_stdlog
);
9305 remote_serial_write (buf2
, p
- buf2
);
9307 /* If this is a no acks version of the remote protocol, send the
9308 packet and move on. */
9312 /* Read until either a timeout occurs (-2) or '+' is read.
9313 Handle any notification that arrives in the mean time. */
9316 ch
= readchar (remote_timeout
);
9324 case SERIAL_TIMEOUT
:
9327 if (started_error_output
)
9329 putchar_unfiltered ('\n');
9330 started_error_output
= 0;
9339 fprintf_unfiltered (gdb_stdlog
, "Ack\n");
9343 fprintf_unfiltered (gdb_stdlog
, "Nak\n");
9345 case SERIAL_TIMEOUT
:
9349 break; /* Retransmit buffer. */
9353 fprintf_unfiltered (gdb_stdlog
,
9354 "Packet instead of Ack, ignoring it\n");
9355 /* It's probably an old response sent because an ACK
9356 was lost. Gobble up the packet and ack it so it
9357 doesn't get retransmitted when we resend this
9360 remote_serial_write ("+", 1);
9361 continue; /* Now, go look for +. */
9368 /* If we got a notification, handle it, and go back to looking
9370 /* We've found the start of a notification. Now
9371 collect the data. */
9372 val
= read_frame (&rs
->buf
);
9377 std::string str
= escape_buffer (rs
->buf
.data (), val
);
9379 fprintf_unfiltered (gdb_stdlog
,
9380 " Notification received: %s\n",
9383 handle_notification (rs
->notif_state
, rs
->buf
.data ());
9384 /* We're in sync now, rewait for the ack. */
9391 if (!started_error_output
)
9393 started_error_output
= 1;
9394 fprintf_unfiltered (gdb_stdlog
, "putpkt: Junk: ");
9396 fputc_unfiltered (ch
& 0177, gdb_stdlog
);
9397 fprintf_unfiltered (gdb_stdlog
, "%s", rs
->buf
.data ());
9406 if (!started_error_output
)
9408 started_error_output
= 1;
9409 fprintf_unfiltered (gdb_stdlog
, "putpkt: Junk: ");
9411 fputc_unfiltered (ch
& 0177, gdb_stdlog
);
9415 break; /* Here to retransmit. */
9419 /* This is wrong. If doing a long backtrace, the user should be
9420 able to get out next time we call QUIT, without anything as
9421 violent as interrupt_query. If we want to provide a way out of
9422 here without getting to the next QUIT, it should be based on
9423 hitting ^C twice as in remote_wait. */
9435 /* Come here after finding the start of a frame when we expected an
9436 ack. Do our best to discard the rest of this packet. */
9439 remote_target::skip_frame ()
9445 c
= readchar (remote_timeout
);
9448 case SERIAL_TIMEOUT
:
9449 /* Nothing we can do. */
9452 /* Discard the two bytes of checksum and stop. */
9453 c
= readchar (remote_timeout
);
9455 c
= readchar (remote_timeout
);
9458 case '*': /* Run length encoding. */
9459 /* Discard the repeat count. */
9460 c
= readchar (remote_timeout
);
9465 /* A regular character. */
9471 /* Come here after finding the start of the frame. Collect the rest
9472 into *BUF, verifying the checksum, length, and handling run-length
9473 compression. NUL terminate the buffer. If there is not enough room,
9476 Returns -1 on error, number of characters in buffer (ignoring the
9477 trailing NULL) on success. (could be extended to return one of the
9478 SERIAL status indications). */
9481 remote_target::read_frame (gdb::char_vector
*buf_p
)
9486 char *buf
= buf_p
->data ();
9487 struct remote_state
*rs
= get_remote_state ();
9494 c
= readchar (remote_timeout
);
9497 case SERIAL_TIMEOUT
:
9499 fputs_filtered ("Timeout in mid-packet, retrying\n", gdb_stdlog
);
9503 fputs_filtered ("Saw new packet start in middle of old one\n",
9505 return -1; /* Start a new packet, count retries. */
9508 unsigned char pktcsum
;
9514 check_0
= readchar (remote_timeout
);
9516 check_1
= readchar (remote_timeout
);
9518 if (check_0
== SERIAL_TIMEOUT
|| check_1
== SERIAL_TIMEOUT
)
9521 fputs_filtered ("Timeout in checksum, retrying\n",
9525 else if (check_0
< 0 || check_1
< 0)
9528 fputs_filtered ("Communication error in checksum\n",
9533 /* Don't recompute the checksum; with no ack packets we
9534 don't have any way to indicate a packet retransmission
9539 pktcsum
= (fromhex (check_0
) << 4) | fromhex (check_1
);
9540 if (csum
== pktcsum
)
9545 std::string str
= escape_buffer (buf
, bc
);
9547 fprintf_unfiltered (gdb_stdlog
,
9548 "Bad checksum, sentsum=0x%x, "
9549 "csum=0x%x, buf=%s\n",
9550 pktcsum
, csum
, str
.c_str ());
9552 /* Number of characters in buffer ignoring trailing
9556 case '*': /* Run length encoding. */
9561 c
= readchar (remote_timeout
);
9563 repeat
= c
- ' ' + 3; /* Compute repeat count. */
9565 /* The character before ``*'' is repeated. */
9567 if (repeat
> 0 && repeat
<= 255 && bc
> 0)
9569 if (bc
+ repeat
- 1 >= buf_p
->size () - 1)
9571 /* Make some more room in the buffer. */
9572 buf_p
->resize (buf_p
->size () + repeat
);
9573 buf
= buf_p
->data ();
9576 memset (&buf
[bc
], buf
[bc
- 1], repeat
);
9582 printf_filtered (_("Invalid run length encoding: %s\n"), buf
);
9586 if (bc
>= buf_p
->size () - 1)
9588 /* Make some more room in the buffer. */
9589 buf_p
->resize (buf_p
->size () * 2);
9590 buf
= buf_p
->data ();
9600 /* Set this to the maximum number of seconds to wait instead of waiting forever
9601 in target_wait(). If this timer times out, then it generates an error and
9602 the command is aborted. This replaces most of the need for timeouts in the
9603 GDB test suite, and makes it possible to distinguish between a hung target
9604 and one with slow communications. */
9606 static int watchdog
= 0;
9608 show_watchdog (struct ui_file
*file
, int from_tty
,
9609 struct cmd_list_element
*c
, const char *value
)
9611 fprintf_filtered (file
, _("Watchdog timer is %s.\n"), value
);
9614 /* Read a packet from the remote machine, with error checking, and
9615 store it in *BUF. Resize *BUF if necessary to hold the result. If
9616 FOREVER, wait forever rather than timing out; this is used (in
9617 synchronous mode) to wait for a target that is is executing user
9619 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
9620 don't have to change all the calls to getpkt to deal with the
9621 return value, because at the moment I don't know what the right
9622 thing to do it for those. */
9625 remote_target::getpkt (gdb::char_vector
*buf
, int forever
)
9627 getpkt_sane (buf
, forever
);
9631 /* Read a packet from the remote machine, with error checking, and
9632 store it in *BUF. Resize *BUF if necessary to hold the result. If
9633 FOREVER, wait forever rather than timing out; this is used (in
9634 synchronous mode) to wait for a target that is is executing user
9635 code to stop. If FOREVER == 0, this function is allowed to time
9636 out gracefully and return an indication of this to the caller.
9637 Otherwise return the number of bytes read. If EXPECTING_NOTIF,
9638 consider receiving a notification enough reason to return to the
9639 caller. *IS_NOTIF is an output boolean that indicates whether *BUF
9640 holds a notification or not (a regular packet). */
9643 remote_target::getpkt_or_notif_sane_1 (gdb::char_vector
*buf
,
9644 int forever
, int expecting_notif
,
9647 struct remote_state
*rs
= get_remote_state ();
9653 /* We're reading a new response. Make sure we don't look at a
9654 previously cached response. */
9655 rs
->cached_wait_status
= 0;
9657 strcpy (buf
->data (), "timeout");
9660 timeout
= watchdog
> 0 ? watchdog
: -1;
9661 else if (expecting_notif
)
9662 timeout
= 0; /* There should already be a char in the buffer. If
9665 timeout
= remote_timeout
;
9669 /* Process any number of notifications, and then return when
9673 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
9675 for (tries
= 1; tries
<= MAX_TRIES
; tries
++)
9677 /* This can loop forever if the remote side sends us
9678 characters continuously, but if it pauses, we'll get
9679 SERIAL_TIMEOUT from readchar because of timeout. Then
9680 we'll count that as a retry.
9682 Note that even when forever is set, we will only wait
9683 forever prior to the start of a packet. After that, we
9684 expect characters to arrive at a brisk pace. They should
9685 show up within remote_timeout intervals. */
9687 c
= readchar (timeout
);
9688 while (c
!= SERIAL_TIMEOUT
&& c
!= '$' && c
!= '%');
9690 if (c
== SERIAL_TIMEOUT
)
9692 if (expecting_notif
)
9693 return -1; /* Don't complain, it's normal to not get
9694 anything in this case. */
9696 if (forever
) /* Watchdog went off? Kill the target. */
9698 remote_unpush_target (this);
9699 throw_error (TARGET_CLOSE_ERROR
,
9700 _("Watchdog timeout has expired. "
9701 "Target detached."));
9704 fputs_filtered ("Timed out.\n", gdb_stdlog
);
9708 /* We've found the start of a packet or notification.
9709 Now collect the data. */
9710 val
= read_frame (buf
);
9715 remote_serial_write ("-", 1);
9718 if (tries
> MAX_TRIES
)
9720 /* We have tried hard enough, and just can't receive the
9721 packet/notification. Give up. */
9722 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
9724 /* Skip the ack char if we're in no-ack mode. */
9725 if (!rs
->noack_mode
)
9726 remote_serial_write ("+", 1);
9730 /* If we got an ordinary packet, return that to our caller. */
9737 if (remote_packet_max_chars
< 0)
9740 max_chars
= remote_packet_max_chars
;
9743 = escape_buffer (buf
->data (),
9744 std::min (val
, max_chars
));
9746 fprintf_unfiltered (gdb_stdlog
, "Packet received: %s",
9749 if (val
> max_chars
)
9750 fprintf_unfiltered (gdb_stdlog
, "[%d bytes omitted]",
9753 fprintf_unfiltered (gdb_stdlog
, "\n");
9756 /* Skip the ack char if we're in no-ack mode. */
9757 if (!rs
->noack_mode
)
9758 remote_serial_write ("+", 1);
9759 if (is_notif
!= NULL
)
9764 /* If we got a notification, handle it, and go back to looking
9768 gdb_assert (c
== '%');
9772 std::string str
= escape_buffer (buf
->data (), val
);
9774 fprintf_unfiltered (gdb_stdlog
,
9775 " Notification received: %s\n",
9778 if (is_notif
!= NULL
)
9781 handle_notification (rs
->notif_state
, buf
->data ());
9783 /* Notifications require no acknowledgement. */
9785 if (expecting_notif
)
9792 remote_target::getpkt_sane (gdb::char_vector
*buf
, int forever
)
9794 return getpkt_or_notif_sane_1 (buf
, forever
, 0, NULL
);
9798 remote_target::getpkt_or_notif_sane (gdb::char_vector
*buf
, int forever
,
9801 return getpkt_or_notif_sane_1 (buf
, forever
, 1, is_notif
);
9804 /* Kill any new fork children of process PID that haven't been
9805 processed by follow_fork. */
9808 remote_target::kill_new_fork_children (int pid
)
9810 remote_state
*rs
= get_remote_state ();
9811 struct notif_client
*notif
= ¬if_client_stop
;
9813 /* Kill the fork child threads of any threads in process PID
9814 that are stopped at a fork event. */
9815 for (thread_info
*thread
: all_non_exited_threads (this))
9817 struct target_waitstatus
*ws
= &thread
->pending_follow
;
9819 if (is_pending_fork_parent (ws
, pid
, thread
->ptid
))
9821 int child_pid
= ws
->value
.related_pid
.pid ();
9824 res
= remote_vkill (child_pid
);
9826 error (_("Can't kill fork child process %d"), child_pid
);
9830 /* Check for any pending fork events (not reported or processed yet)
9831 in process PID and kill those fork child threads as well. */
9832 remote_notif_get_pending_events (notif
);
9833 for (auto &event
: rs
->stop_reply_queue
)
9834 if (is_pending_fork_parent (&event
->ws
, pid
, event
->ptid
))
9836 int child_pid
= event
->ws
.value
.related_pid
.pid ();
9839 res
= remote_vkill (child_pid
);
9841 error (_("Can't kill fork child process %d"), child_pid
);
9846 /* Target hook to kill the current inferior. */
9849 remote_target::kill ()
9852 int pid
= inferior_ptid
.pid ();
9853 struct remote_state
*rs
= get_remote_state ();
9855 if (packet_support (PACKET_vKill
) != PACKET_DISABLE
)
9857 /* If we're stopped while forking and we haven't followed yet,
9858 kill the child task. We need to do this before killing the
9859 parent task because if this is a vfork then the parent will
9861 kill_new_fork_children (pid
);
9863 res
= remote_vkill (pid
);
9866 target_mourn_inferior (inferior_ptid
);
9871 /* If we are in 'target remote' mode and we are killing the only
9872 inferior, then we will tell gdbserver to exit and unpush the
9874 if (res
== -1 && !remote_multi_process_p (rs
)
9875 && number_of_live_inferiors (this) == 1)
9879 /* We've killed the remote end, we get to mourn it. If we are
9880 not in extended mode, mourning the inferior also unpushes
9881 remote_ops from the target stack, which closes the remote
9883 target_mourn_inferior (inferior_ptid
);
9888 error (_("Can't kill process"));
9891 /* Send a kill request to the target using the 'vKill' packet. */
9894 remote_target::remote_vkill (int pid
)
9896 if (packet_support (PACKET_vKill
) == PACKET_DISABLE
)
9899 remote_state
*rs
= get_remote_state ();
9901 /* Tell the remote target to detach. */
9902 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "vKill;%x", pid
);
9904 getpkt (&rs
->buf
, 0);
9906 switch (packet_ok (rs
->buf
,
9907 &remote_protocol_packets
[PACKET_vKill
]))
9913 case PACKET_UNKNOWN
:
9916 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
9920 /* Send a kill request to the target using the 'k' packet. */
9923 remote_target::remote_kill_k ()
9925 /* Catch errors so the user can quit from gdb even when we
9926 aren't on speaking terms with the remote system. */
9931 catch (const gdb_exception_error
&ex
)
9933 if (ex
.error
== TARGET_CLOSE_ERROR
)
9935 /* If we got an (EOF) error that caused the target
9936 to go away, then we're done, that's what we wanted.
9937 "k" is susceptible to cause a premature EOF, given
9938 that the remote server isn't actually required to
9939 reply to "k", and it can happen that it doesn't
9940 even get to reply ACK to the "k". */
9944 /* Otherwise, something went wrong. We didn't actually kill
9945 the target. Just propagate the exception, and let the
9946 user or higher layers decide what to do. */
9952 remote_target::mourn_inferior ()
9954 struct remote_state
*rs
= get_remote_state ();
9956 /* We're no longer interested in notification events of an inferior
9957 that exited or was killed/detached. */
9958 discard_pending_stop_replies (current_inferior ());
9960 /* In 'target remote' mode with one inferior, we close the connection. */
9961 if (!rs
->extended
&& number_of_live_inferiors (this) <= 1)
9963 remote_unpush_target (this);
9967 /* In case we got here due to an error, but we're going to stay
9969 rs
->waiting_for_stop_reply
= 0;
9971 /* If the current general thread belonged to the process we just
9972 detached from or has exited, the remote side current general
9973 thread becomes undefined. Considering a case like this:
9975 - We just got here due to a detach.
9976 - The process that we're detaching from happens to immediately
9977 report a global breakpoint being hit in non-stop mode, in the
9978 same thread we had selected before.
9979 - GDB attaches to this process again.
9980 - This event happens to be the next event we handle.
9982 GDB would consider that the current general thread didn't need to
9983 be set on the stub side (with Hg), since for all it knew,
9984 GENERAL_THREAD hadn't changed.
9986 Notice that although in all-stop mode, the remote server always
9987 sets the current thread to the thread reporting the stop event,
9988 that doesn't happen in non-stop mode; in non-stop, the stub *must
9989 not* change the current thread when reporting a breakpoint hit,
9990 due to the decoupling of event reporting and event handling.
9992 To keep things simple, we always invalidate our notion of the
9994 record_currthread (rs
, minus_one_ptid
);
9996 /* Call common code to mark the inferior as not running. */
9997 generic_mourn_inferior ();
10001 extended_remote_target::supports_disable_randomization ()
10003 return packet_support (PACKET_QDisableRandomization
) == PACKET_ENABLE
;
10007 remote_target::extended_remote_disable_randomization (int val
)
10009 struct remote_state
*rs
= get_remote_state ();
10012 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10013 "QDisableRandomization:%x", val
);
10015 reply
= remote_get_noisy_reply ();
10016 if (*reply
== '\0')
10017 error (_("Target does not support QDisableRandomization."));
10018 if (strcmp (reply
, "OK") != 0)
10019 error (_("Bogus QDisableRandomization reply from target: %s"), reply
);
10023 remote_target::extended_remote_run (const std::string
&args
)
10025 struct remote_state
*rs
= get_remote_state ();
10027 const char *remote_exec_file
= get_remote_exec_file ();
10029 /* If the user has disabled vRun support, or we have detected that
10030 support is not available, do not try it. */
10031 if (packet_support (PACKET_vRun
) == PACKET_DISABLE
)
10034 strcpy (rs
->buf
.data (), "vRun;");
10035 len
= strlen (rs
->buf
.data ());
10037 if (strlen (remote_exec_file
) * 2 + len
>= get_remote_packet_size ())
10038 error (_("Remote file name too long for run packet"));
10039 len
+= 2 * bin2hex ((gdb_byte
*) remote_exec_file
, rs
->buf
.data () + len
,
10040 strlen (remote_exec_file
));
10042 if (!args
.empty ())
10046 gdb_argv
argv (args
.c_str ());
10047 for (i
= 0; argv
[i
] != NULL
; i
++)
10049 if (strlen (argv
[i
]) * 2 + 1 + len
>= get_remote_packet_size ())
10050 error (_("Argument list too long for run packet"));
10051 rs
->buf
[len
++] = ';';
10052 len
+= 2 * bin2hex ((gdb_byte
*) argv
[i
], rs
->buf
.data () + len
,
10057 rs
->buf
[len
++] = '\0';
10060 getpkt (&rs
->buf
, 0);
10062 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vRun
]))
10065 /* We have a wait response. All is well. */
10067 case PACKET_UNKNOWN
:
10070 if (remote_exec_file
[0] == '\0')
10071 error (_("Running the default executable on the remote target failed; "
10072 "try \"set remote exec-file\"?"));
10074 error (_("Running \"%s\" on the remote target failed"),
10077 gdb_assert_not_reached (_("bad switch"));
10081 /* Helper function to send set/unset environment packets. ACTION is
10082 either "set" or "unset". PACKET is either "QEnvironmentHexEncoded"
10083 or "QEnvironmentUnsetVariable". VALUE is the variable to be
10087 remote_target::send_environment_packet (const char *action
,
10088 const char *packet
,
10091 remote_state
*rs
= get_remote_state ();
10093 /* Convert the environment variable to an hex string, which
10094 is the best format to be transmitted over the wire. */
10095 std::string encoded_value
= bin2hex ((const gdb_byte
*) value
,
10098 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10099 "%s:%s", packet
, encoded_value
.c_str ());
10102 getpkt (&rs
->buf
, 0);
10103 if (strcmp (rs
->buf
.data (), "OK") != 0)
10104 warning (_("Unable to %s environment variable '%s' on remote."),
10108 /* Helper function to handle the QEnvironment* packets. */
10111 remote_target::extended_remote_environment_support ()
10113 remote_state
*rs
= get_remote_state ();
10115 if (packet_support (PACKET_QEnvironmentReset
) != PACKET_DISABLE
)
10117 putpkt ("QEnvironmentReset");
10118 getpkt (&rs
->buf
, 0);
10119 if (strcmp (rs
->buf
.data (), "OK") != 0)
10120 warning (_("Unable to reset environment on remote."));
10123 gdb_environ
*e
= ¤t_inferior ()->environment
;
10125 if (packet_support (PACKET_QEnvironmentHexEncoded
) != PACKET_DISABLE
)
10126 for (const std::string
&el
: e
->user_set_env ())
10127 send_environment_packet ("set", "QEnvironmentHexEncoded",
10130 if (packet_support (PACKET_QEnvironmentUnset
) != PACKET_DISABLE
)
10131 for (const std::string
&el
: e
->user_unset_env ())
10132 send_environment_packet ("unset", "QEnvironmentUnset", el
.c_str ());
10135 /* Helper function to set the current working directory for the
10136 inferior in the remote target. */
10139 remote_target::extended_remote_set_inferior_cwd ()
10141 if (packet_support (PACKET_QSetWorkingDir
) != PACKET_DISABLE
)
10143 const char *inferior_cwd
= get_inferior_cwd ();
10144 remote_state
*rs
= get_remote_state ();
10146 if (inferior_cwd
!= NULL
)
10148 std::string hexpath
= bin2hex ((const gdb_byte
*) inferior_cwd
,
10149 strlen (inferior_cwd
));
10151 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10152 "QSetWorkingDir:%s", hexpath
.c_str ());
10156 /* An empty inferior_cwd means that the user wants us to
10157 reset the remote server's inferior's cwd. */
10158 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10159 "QSetWorkingDir:");
10163 getpkt (&rs
->buf
, 0);
10164 if (packet_ok (rs
->buf
,
10165 &remote_protocol_packets
[PACKET_QSetWorkingDir
])
10168 Remote replied unexpectedly while setting the inferior's working\n\
10175 /* In the extended protocol we want to be able to do things like
10176 "run" and have them basically work as expected. So we need
10177 a special create_inferior function. We support changing the
10178 executable file and the command line arguments, but not the
10182 extended_remote_target::create_inferior (const char *exec_file
,
10183 const std::string
&args
,
10184 char **env
, int from_tty
)
10188 struct remote_state
*rs
= get_remote_state ();
10189 const char *remote_exec_file
= get_remote_exec_file ();
10191 /* If running asynchronously, register the target file descriptor
10192 with the event loop. */
10193 if (target_can_async_p ())
10196 /* Disable address space randomization if requested (and supported). */
10197 if (supports_disable_randomization ())
10198 extended_remote_disable_randomization (disable_randomization
);
10200 /* If startup-with-shell is on, we inform gdbserver to start the
10201 remote inferior using a shell. */
10202 if (packet_support (PACKET_QStartupWithShell
) != PACKET_DISABLE
)
10204 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10205 "QStartupWithShell:%d", startup_with_shell
? 1 : 0);
10207 getpkt (&rs
->buf
, 0);
10208 if (strcmp (rs
->buf
.data (), "OK") != 0)
10210 Remote replied unexpectedly while setting startup-with-shell: %s"),
10214 extended_remote_environment_support ();
10216 extended_remote_set_inferior_cwd ();
10218 /* Now restart the remote server. */
10219 run_worked
= extended_remote_run (args
) != -1;
10222 /* vRun was not supported. Fail if we need it to do what the
10224 if (remote_exec_file
[0])
10225 error (_("Remote target does not support \"set remote exec-file\""));
10226 if (!args
.empty ())
10227 error (_("Remote target does not support \"set args\" or run ARGS"));
10229 /* Fall back to "R". */
10230 extended_remote_restart ();
10233 /* vRun's success return is a stop reply. */
10234 stop_reply
= run_worked
? rs
->buf
.data () : NULL
;
10235 add_current_inferior_and_thread (stop_reply
);
10237 /* Get updated offsets, if the stub uses qOffsets. */
10242 /* Given a location's target info BP_TGT and the packet buffer BUF, output
10243 the list of conditions (in agent expression bytecode format), if any, the
10244 target needs to evaluate. The output is placed into the packet buffer
10245 started from BUF and ended at BUF_END. */
10248 remote_add_target_side_condition (struct gdbarch
*gdbarch
,
10249 struct bp_target_info
*bp_tgt
, char *buf
,
10252 if (bp_tgt
->conditions
.empty ())
10255 buf
+= strlen (buf
);
10256 xsnprintf (buf
, buf_end
- buf
, "%s", ";");
10259 /* Send conditions to the target. */
10260 for (agent_expr
*aexpr
: bp_tgt
->conditions
)
10262 xsnprintf (buf
, buf_end
- buf
, "X%x,", aexpr
->len
);
10263 buf
+= strlen (buf
);
10264 for (int i
= 0; i
< aexpr
->len
; ++i
)
10265 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
10272 remote_add_target_side_commands (struct gdbarch
*gdbarch
,
10273 struct bp_target_info
*bp_tgt
, char *buf
)
10275 if (bp_tgt
->tcommands
.empty ())
10278 buf
+= strlen (buf
);
10280 sprintf (buf
, ";cmds:%x,", bp_tgt
->persist
);
10281 buf
+= strlen (buf
);
10283 /* Concatenate all the agent expressions that are commands into the
10285 for (agent_expr
*aexpr
: bp_tgt
->tcommands
)
10287 sprintf (buf
, "X%x,", aexpr
->len
);
10288 buf
+= strlen (buf
);
10289 for (int i
= 0; i
< aexpr
->len
; ++i
)
10290 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
10295 /* Insert a breakpoint. On targets that have software breakpoint
10296 support, we ask the remote target to do the work; on targets
10297 which don't, we insert a traditional memory breakpoint. */
10300 remote_target::insert_breakpoint (struct gdbarch
*gdbarch
,
10301 struct bp_target_info
*bp_tgt
)
10303 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
10304 If it succeeds, then set the support to PACKET_ENABLE. If it
10305 fails, and the user has explicitly requested the Z support then
10306 report an error, otherwise, mark it disabled and go on. */
10308 if (packet_support (PACKET_Z0
) != PACKET_DISABLE
)
10310 CORE_ADDR addr
= bp_tgt
->reqstd_address
;
10311 struct remote_state
*rs
;
10314 /* Make sure the remote is pointing at the right process, if
10316 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10317 set_general_process ();
10319 rs
= get_remote_state ();
10320 p
= rs
->buf
.data ();
10321 endbuf
= p
+ get_remote_packet_size ();
10326 addr
= (ULONGEST
) remote_address_masked (addr
);
10327 p
+= hexnumstr (p
, addr
);
10328 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->kind
);
10330 if (supports_evaluation_of_breakpoint_conditions ())
10331 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
10333 if (can_run_breakpoint_commands ())
10334 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
10337 getpkt (&rs
->buf
, 0);
10339 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
]))
10345 case PACKET_UNKNOWN
:
10350 /* If this breakpoint has target-side commands but this stub doesn't
10351 support Z0 packets, throw error. */
10352 if (!bp_tgt
->tcommands
.empty ())
10353 throw_error (NOT_SUPPORTED_ERROR
, _("\
10354 Target doesn't support breakpoints that have target side commands."));
10356 return memory_insert_breakpoint (this, gdbarch
, bp_tgt
);
10360 remote_target::remove_breakpoint (struct gdbarch
*gdbarch
,
10361 struct bp_target_info
*bp_tgt
,
10362 enum remove_bp_reason reason
)
10364 CORE_ADDR addr
= bp_tgt
->placed_address
;
10365 struct remote_state
*rs
= get_remote_state ();
10367 if (packet_support (PACKET_Z0
) != PACKET_DISABLE
)
10369 char *p
= rs
->buf
.data ();
10370 char *endbuf
= p
+ get_remote_packet_size ();
10372 /* Make sure the remote is pointing at the right process, if
10374 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10375 set_general_process ();
10381 addr
= (ULONGEST
) remote_address_masked (bp_tgt
->placed_address
);
10382 p
+= hexnumstr (p
, addr
);
10383 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->kind
);
10386 getpkt (&rs
->buf
, 0);
10388 return (rs
->buf
[0] == 'E');
10391 return memory_remove_breakpoint (this, gdbarch
, bp_tgt
, reason
);
10394 static enum Z_packet_type
10395 watchpoint_to_Z_packet (int type
)
10400 return Z_PACKET_WRITE_WP
;
10403 return Z_PACKET_READ_WP
;
10406 return Z_PACKET_ACCESS_WP
;
10409 internal_error (__FILE__
, __LINE__
,
10410 _("hw_bp_to_z: bad watchpoint type %d"), type
);
10415 remote_target::insert_watchpoint (CORE_ADDR addr
, int len
,
10416 enum target_hw_bp_type type
, struct expression
*cond
)
10418 struct remote_state
*rs
= get_remote_state ();
10419 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
10421 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
10423 if (packet_support (PACKET_Z0
+ packet
) == PACKET_DISABLE
)
10426 /* Make sure the remote is pointing at the right process, if
10428 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10429 set_general_process ();
10431 xsnprintf (rs
->buf
.data (), endbuf
- rs
->buf
.data (), "Z%x,", packet
);
10432 p
= strchr (rs
->buf
.data (), '\0');
10433 addr
= remote_address_masked (addr
);
10434 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10435 xsnprintf (p
, endbuf
- p
, ",%x", len
);
10438 getpkt (&rs
->buf
, 0);
10440 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
10444 case PACKET_UNKNOWN
:
10449 internal_error (__FILE__
, __LINE__
,
10450 _("remote_insert_watchpoint: reached end of function"));
10454 remote_target::watchpoint_addr_within_range (CORE_ADDR addr
,
10455 CORE_ADDR start
, int length
)
10457 CORE_ADDR diff
= remote_address_masked (addr
- start
);
10459 return diff
< length
;
10464 remote_target::remove_watchpoint (CORE_ADDR addr
, int len
,
10465 enum target_hw_bp_type type
, struct expression
*cond
)
10467 struct remote_state
*rs
= get_remote_state ();
10468 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
10470 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
10472 if (packet_support (PACKET_Z0
+ packet
) == PACKET_DISABLE
)
10475 /* Make sure the remote is pointing at the right process, if
10477 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10478 set_general_process ();
10480 xsnprintf (rs
->buf
.data (), endbuf
- rs
->buf
.data (), "z%x,", packet
);
10481 p
= strchr (rs
->buf
.data (), '\0');
10482 addr
= remote_address_masked (addr
);
10483 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10484 xsnprintf (p
, endbuf
- p
, ",%x", len
);
10486 getpkt (&rs
->buf
, 0);
10488 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
10491 case PACKET_UNKNOWN
:
10496 internal_error (__FILE__
, __LINE__
,
10497 _("remote_remove_watchpoint: reached end of function"));
10501 static int remote_hw_watchpoint_limit
= -1;
10502 static int remote_hw_watchpoint_length_limit
= -1;
10503 static int remote_hw_breakpoint_limit
= -1;
10506 remote_target::region_ok_for_hw_watchpoint (CORE_ADDR addr
, int len
)
10508 if (remote_hw_watchpoint_length_limit
== 0)
10510 else if (remote_hw_watchpoint_length_limit
< 0)
10512 else if (len
<= remote_hw_watchpoint_length_limit
)
10519 remote_target::can_use_hw_breakpoint (enum bptype type
, int cnt
, int ot
)
10521 if (type
== bp_hardware_breakpoint
)
10523 if (remote_hw_breakpoint_limit
== 0)
10525 else if (remote_hw_breakpoint_limit
< 0)
10527 else if (cnt
<= remote_hw_breakpoint_limit
)
10532 if (remote_hw_watchpoint_limit
== 0)
10534 else if (remote_hw_watchpoint_limit
< 0)
10538 else if (cnt
<= remote_hw_watchpoint_limit
)
10544 /* The to_stopped_by_sw_breakpoint method of target remote. */
10547 remote_target::stopped_by_sw_breakpoint ()
10549 struct thread_info
*thread
= inferior_thread ();
10551 return (thread
->priv
!= NULL
10552 && (get_remote_thread_info (thread
)->stop_reason
10553 == TARGET_STOPPED_BY_SW_BREAKPOINT
));
10556 /* The to_supports_stopped_by_sw_breakpoint method of target
10560 remote_target::supports_stopped_by_sw_breakpoint ()
10562 return (packet_support (PACKET_swbreak_feature
) == PACKET_ENABLE
);
10565 /* The to_stopped_by_hw_breakpoint method of target remote. */
10568 remote_target::stopped_by_hw_breakpoint ()
10570 struct thread_info
*thread
= inferior_thread ();
10572 return (thread
->priv
!= NULL
10573 && (get_remote_thread_info (thread
)->stop_reason
10574 == TARGET_STOPPED_BY_HW_BREAKPOINT
));
10577 /* The to_supports_stopped_by_hw_breakpoint method of target
10581 remote_target::supports_stopped_by_hw_breakpoint ()
10583 return (packet_support (PACKET_hwbreak_feature
) == PACKET_ENABLE
);
10587 remote_target::stopped_by_watchpoint ()
10589 struct thread_info
*thread
= inferior_thread ();
10591 return (thread
->priv
!= NULL
10592 && (get_remote_thread_info (thread
)->stop_reason
10593 == TARGET_STOPPED_BY_WATCHPOINT
));
10597 remote_target::stopped_data_address (CORE_ADDR
*addr_p
)
10599 struct thread_info
*thread
= inferior_thread ();
10601 if (thread
->priv
!= NULL
10602 && (get_remote_thread_info (thread
)->stop_reason
10603 == TARGET_STOPPED_BY_WATCHPOINT
))
10605 *addr_p
= get_remote_thread_info (thread
)->watch_data_address
;
10614 remote_target::insert_hw_breakpoint (struct gdbarch
*gdbarch
,
10615 struct bp_target_info
*bp_tgt
)
10617 CORE_ADDR addr
= bp_tgt
->reqstd_address
;
10618 struct remote_state
*rs
;
10622 if (packet_support (PACKET_Z1
) == PACKET_DISABLE
)
10625 /* Make sure the remote is pointing at the right process, if
10627 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10628 set_general_process ();
10630 rs
= get_remote_state ();
10631 p
= rs
->buf
.data ();
10632 endbuf
= p
+ get_remote_packet_size ();
10638 addr
= remote_address_masked (addr
);
10639 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10640 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->kind
);
10642 if (supports_evaluation_of_breakpoint_conditions ())
10643 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
10645 if (can_run_breakpoint_commands ())
10646 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
10649 getpkt (&rs
->buf
, 0);
10651 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
10654 if (rs
->buf
[1] == '.')
10656 message
= strchr (&rs
->buf
[2], '.');
10658 error (_("Remote failure reply: %s"), message
+ 1);
10661 case PACKET_UNKNOWN
:
10666 internal_error (__FILE__
, __LINE__
,
10667 _("remote_insert_hw_breakpoint: reached end of function"));
10672 remote_target::remove_hw_breakpoint (struct gdbarch
*gdbarch
,
10673 struct bp_target_info
*bp_tgt
)
10676 struct remote_state
*rs
= get_remote_state ();
10677 char *p
= rs
->buf
.data ();
10678 char *endbuf
= p
+ get_remote_packet_size ();
10680 if (packet_support (PACKET_Z1
) == PACKET_DISABLE
)
10683 /* Make sure the remote is pointing at the right process, if
10685 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10686 set_general_process ();
10692 addr
= remote_address_masked (bp_tgt
->placed_address
);
10693 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10694 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->kind
);
10697 getpkt (&rs
->buf
, 0);
10699 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
10702 case PACKET_UNKNOWN
:
10707 internal_error (__FILE__
, __LINE__
,
10708 _("remote_remove_hw_breakpoint: reached end of function"));
10711 /* Verify memory using the "qCRC:" request. */
10714 remote_target::verify_memory (const gdb_byte
*data
, CORE_ADDR lma
, ULONGEST size
)
10716 struct remote_state
*rs
= get_remote_state ();
10717 unsigned long host_crc
, target_crc
;
10720 /* It doesn't make sense to use qCRC if the remote target is
10721 connected but not running. */
10722 if (target_has_execution ()
10723 && packet_support (PACKET_qCRC
) != PACKET_DISABLE
)
10725 enum packet_result result
;
10727 /* Make sure the remote is pointing at the right process. */
10728 set_general_process ();
10730 /* FIXME: assumes lma can fit into long. */
10731 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qCRC:%lx,%lx",
10732 (long) lma
, (long) size
);
10735 /* Be clever; compute the host_crc before waiting for target
10737 host_crc
= xcrc32 (data
, size
, 0xffffffff);
10739 getpkt (&rs
->buf
, 0);
10741 result
= packet_ok (rs
->buf
,
10742 &remote_protocol_packets
[PACKET_qCRC
]);
10743 if (result
== PACKET_ERROR
)
10745 else if (result
== PACKET_OK
)
10747 for (target_crc
= 0, tmp
= &rs
->buf
[1]; *tmp
; tmp
++)
10748 target_crc
= target_crc
* 16 + fromhex (*tmp
);
10750 return (host_crc
== target_crc
);
10754 return simple_verify_memory (this, data
, lma
, size
);
10757 /* compare-sections command
10759 With no arguments, compares each loadable section in the exec bfd
10760 with the same memory range on the target, and reports mismatches.
10761 Useful for verifying the image on the target against the exec file. */
10764 compare_sections_command (const char *args
, int from_tty
)
10767 const char *sectname
;
10768 bfd_size_type size
;
10771 int mismatched
= 0;
10776 error (_("command cannot be used without an exec file"));
10778 if (args
!= NULL
&& strcmp (args
, "-r") == 0)
10784 for (s
= exec_bfd
->sections
; s
; s
= s
->next
)
10786 if (!(s
->flags
& SEC_LOAD
))
10787 continue; /* Skip non-loadable section. */
10789 if (read_only
&& (s
->flags
& SEC_READONLY
) == 0)
10790 continue; /* Skip writeable sections */
10792 size
= bfd_section_size (s
);
10794 continue; /* Skip zero-length section. */
10796 sectname
= bfd_section_name (s
);
10797 if (args
&& strcmp (args
, sectname
) != 0)
10798 continue; /* Not the section selected by user. */
10800 matched
= 1; /* Do this section. */
10803 gdb::byte_vector
sectdata (size
);
10804 bfd_get_section_contents (exec_bfd
, s
, sectdata
.data (), 0, size
);
10806 res
= target_verify_memory (sectdata
.data (), lma
, size
);
10809 error (_("target memory fault, section %s, range %s -- %s"), sectname
,
10810 paddress (target_gdbarch (), lma
),
10811 paddress (target_gdbarch (), lma
+ size
));
10813 printf_filtered ("Section %s, range %s -- %s: ", sectname
,
10814 paddress (target_gdbarch (), lma
),
10815 paddress (target_gdbarch (), lma
+ size
));
10817 printf_filtered ("matched.\n");
10820 printf_filtered ("MIS-MATCHED!\n");
10824 if (mismatched
> 0)
10825 warning (_("One or more sections of the target image does not match\n\
10826 the loaded file\n"));
10827 if (args
&& !matched
)
10828 printf_filtered (_("No loaded section named '%s'.\n"), args
);
10831 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
10832 into remote target. The number of bytes written to the remote
10833 target is returned, or -1 for error. */
10836 remote_target::remote_write_qxfer (const char *object_name
,
10837 const char *annex
, const gdb_byte
*writebuf
,
10838 ULONGEST offset
, LONGEST len
,
10839 ULONGEST
*xfered_len
,
10840 struct packet_config
*packet
)
10844 struct remote_state
*rs
= get_remote_state ();
10845 int max_size
= get_memory_write_packet_size ();
10847 if (packet_config_support (packet
) == PACKET_DISABLE
)
10848 return TARGET_XFER_E_IO
;
10850 /* Insert header. */
10851 i
= snprintf (rs
->buf
.data (), max_size
,
10852 "qXfer:%s:write:%s:%s:",
10853 object_name
, annex
? annex
: "",
10854 phex_nz (offset
, sizeof offset
));
10855 max_size
-= (i
+ 1);
10857 /* Escape as much data as fits into rs->buf. */
10858 buf_len
= remote_escape_output
10859 (writebuf
, len
, 1, (gdb_byte
*) rs
->buf
.data () + i
, &max_size
, max_size
);
10861 if (putpkt_binary (rs
->buf
.data (), i
+ buf_len
) < 0
10862 || getpkt_sane (&rs
->buf
, 0) < 0
10863 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
10864 return TARGET_XFER_E_IO
;
10866 unpack_varlen_hex (rs
->buf
.data (), &n
);
10869 return (*xfered_len
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
10872 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
10873 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
10874 number of bytes read is returned, or 0 for EOF, or -1 for error.
10875 The number of bytes read may be less than LEN without indicating an
10876 EOF. PACKET is checked and updated to indicate whether the remote
10877 target supports this object. */
10880 remote_target::remote_read_qxfer (const char *object_name
,
10882 gdb_byte
*readbuf
, ULONGEST offset
,
10884 ULONGEST
*xfered_len
,
10885 struct packet_config
*packet
)
10887 struct remote_state
*rs
= get_remote_state ();
10888 LONGEST i
, n
, packet_len
;
10890 if (packet_config_support (packet
) == PACKET_DISABLE
)
10891 return TARGET_XFER_E_IO
;
10893 /* Check whether we've cached an end-of-object packet that matches
10895 if (rs
->finished_object
)
10897 if (strcmp (object_name
, rs
->finished_object
) == 0
10898 && strcmp (annex
? annex
: "", rs
->finished_annex
) == 0
10899 && offset
== rs
->finished_offset
)
10900 return TARGET_XFER_EOF
;
10903 /* Otherwise, we're now reading something different. Discard
10905 xfree (rs
->finished_object
);
10906 xfree (rs
->finished_annex
);
10907 rs
->finished_object
= NULL
;
10908 rs
->finished_annex
= NULL
;
10911 /* Request only enough to fit in a single packet. The actual data
10912 may not, since we don't know how much of it will need to be escaped;
10913 the target is free to respond with slightly less data. We subtract
10914 five to account for the response type and the protocol frame. */
10915 n
= std::min
<LONGEST
> (get_remote_packet_size () - 5, len
);
10916 snprintf (rs
->buf
.data (), get_remote_packet_size () - 4,
10917 "qXfer:%s:read:%s:%s,%s",
10918 object_name
, annex
? annex
: "",
10919 phex_nz (offset
, sizeof offset
),
10920 phex_nz (n
, sizeof n
));
10921 i
= putpkt (rs
->buf
);
10923 return TARGET_XFER_E_IO
;
10926 packet_len
= getpkt_sane (&rs
->buf
, 0);
10927 if (packet_len
< 0 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
10928 return TARGET_XFER_E_IO
;
10930 if (rs
->buf
[0] != 'l' && rs
->buf
[0] != 'm')
10931 error (_("Unknown remote qXfer reply: %s"), rs
->buf
.data ());
10933 /* 'm' means there is (or at least might be) more data after this
10934 batch. That does not make sense unless there's at least one byte
10935 of data in this reply. */
10936 if (rs
->buf
[0] == 'm' && packet_len
== 1)
10937 error (_("Remote qXfer reply contained no data."));
10939 /* Got some data. */
10940 i
= remote_unescape_input ((gdb_byte
*) rs
->buf
.data () + 1,
10941 packet_len
- 1, readbuf
, n
);
10943 /* 'l' is an EOF marker, possibly including a final block of data,
10944 or possibly empty. If we have the final block of a non-empty
10945 object, record this fact to bypass a subsequent partial read. */
10946 if (rs
->buf
[0] == 'l' && offset
+ i
> 0)
10948 rs
->finished_object
= xstrdup (object_name
);
10949 rs
->finished_annex
= xstrdup (annex
? annex
: "");
10950 rs
->finished_offset
= offset
+ i
;
10954 return TARGET_XFER_EOF
;
10958 return TARGET_XFER_OK
;
10962 enum target_xfer_status
10963 remote_target::xfer_partial (enum target_object object
,
10964 const char *annex
, gdb_byte
*readbuf
,
10965 const gdb_byte
*writebuf
, ULONGEST offset
, ULONGEST len
,
10966 ULONGEST
*xfered_len
)
10968 struct remote_state
*rs
;
10972 int unit_size
= gdbarch_addressable_memory_unit_size (target_gdbarch ());
10974 set_remote_traceframe ();
10975 set_general_thread (inferior_ptid
);
10977 rs
= get_remote_state ();
10979 /* Handle memory using the standard memory routines. */
10980 if (object
== TARGET_OBJECT_MEMORY
)
10982 /* If the remote target is connected but not running, we should
10983 pass this request down to a lower stratum (e.g. the executable
10985 if (!target_has_execution ())
10986 return TARGET_XFER_EOF
;
10988 if (writebuf
!= NULL
)
10989 return remote_write_bytes (offset
, writebuf
, len
, unit_size
,
10992 return remote_read_bytes (offset
, readbuf
, len
, unit_size
,
10996 /* Handle extra signal info using qxfer packets. */
10997 if (object
== TARGET_OBJECT_SIGNAL_INFO
)
11000 return remote_read_qxfer ("siginfo", annex
, readbuf
, offset
, len
,
11001 xfered_len
, &remote_protocol_packets
11002 [PACKET_qXfer_siginfo_read
]);
11004 return remote_write_qxfer ("siginfo", annex
,
11005 writebuf
, offset
, len
, xfered_len
,
11006 &remote_protocol_packets
11007 [PACKET_qXfer_siginfo_write
]);
11010 if (object
== TARGET_OBJECT_STATIC_TRACE_DATA
)
11013 return remote_read_qxfer ("statictrace", annex
,
11014 readbuf
, offset
, len
, xfered_len
,
11015 &remote_protocol_packets
11016 [PACKET_qXfer_statictrace_read
]);
11018 return TARGET_XFER_E_IO
;
11021 /* Only handle flash writes. */
11022 if (writebuf
!= NULL
)
11026 case TARGET_OBJECT_FLASH
:
11027 return remote_flash_write (offset
, len
, xfered_len
,
11031 return TARGET_XFER_E_IO
;
11035 /* Map pre-existing objects onto letters. DO NOT do this for new
11036 objects!!! Instead specify new query packets. */
11039 case TARGET_OBJECT_AVR
:
11043 case TARGET_OBJECT_AUXV
:
11044 gdb_assert (annex
== NULL
);
11045 return remote_read_qxfer ("auxv", annex
, readbuf
, offset
, len
,
11047 &remote_protocol_packets
[PACKET_qXfer_auxv
]);
11049 case TARGET_OBJECT_AVAILABLE_FEATURES
:
11050 return remote_read_qxfer
11051 ("features", annex
, readbuf
, offset
, len
, xfered_len
,
11052 &remote_protocol_packets
[PACKET_qXfer_features
]);
11054 case TARGET_OBJECT_LIBRARIES
:
11055 return remote_read_qxfer
11056 ("libraries", annex
, readbuf
, offset
, len
, xfered_len
,
11057 &remote_protocol_packets
[PACKET_qXfer_libraries
]);
11059 case TARGET_OBJECT_LIBRARIES_SVR4
:
11060 return remote_read_qxfer
11061 ("libraries-svr4", annex
, readbuf
, offset
, len
, xfered_len
,
11062 &remote_protocol_packets
[PACKET_qXfer_libraries_svr4
]);
11064 case TARGET_OBJECT_MEMORY_MAP
:
11065 gdb_assert (annex
== NULL
);
11066 return remote_read_qxfer ("memory-map", annex
, readbuf
, offset
, len
,
11068 &remote_protocol_packets
[PACKET_qXfer_memory_map
]);
11070 case TARGET_OBJECT_OSDATA
:
11071 /* Should only get here if we're connected. */
11072 gdb_assert (rs
->remote_desc
);
11073 return remote_read_qxfer
11074 ("osdata", annex
, readbuf
, offset
, len
, xfered_len
,
11075 &remote_protocol_packets
[PACKET_qXfer_osdata
]);
11077 case TARGET_OBJECT_THREADS
:
11078 gdb_assert (annex
== NULL
);
11079 return remote_read_qxfer ("threads", annex
, readbuf
, offset
, len
,
11081 &remote_protocol_packets
[PACKET_qXfer_threads
]);
11083 case TARGET_OBJECT_TRACEFRAME_INFO
:
11084 gdb_assert (annex
== NULL
);
11085 return remote_read_qxfer
11086 ("traceframe-info", annex
, readbuf
, offset
, len
, xfered_len
,
11087 &remote_protocol_packets
[PACKET_qXfer_traceframe_info
]);
11089 case TARGET_OBJECT_FDPIC
:
11090 return remote_read_qxfer ("fdpic", annex
, readbuf
, offset
, len
,
11092 &remote_protocol_packets
[PACKET_qXfer_fdpic
]);
11094 case TARGET_OBJECT_OPENVMS_UIB
:
11095 return remote_read_qxfer ("uib", annex
, readbuf
, offset
, len
,
11097 &remote_protocol_packets
[PACKET_qXfer_uib
]);
11099 case TARGET_OBJECT_BTRACE
:
11100 return remote_read_qxfer ("btrace", annex
, readbuf
, offset
, len
,
11102 &remote_protocol_packets
[PACKET_qXfer_btrace
]);
11104 case TARGET_OBJECT_BTRACE_CONF
:
11105 return remote_read_qxfer ("btrace-conf", annex
, readbuf
, offset
,
11107 &remote_protocol_packets
[PACKET_qXfer_btrace_conf
]);
11109 case TARGET_OBJECT_EXEC_FILE
:
11110 return remote_read_qxfer ("exec-file", annex
, readbuf
, offset
,
11112 &remote_protocol_packets
[PACKET_qXfer_exec_file
]);
11115 return TARGET_XFER_E_IO
;
11118 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
11119 large enough let the caller deal with it. */
11120 if (len
< get_remote_packet_size ())
11121 return TARGET_XFER_E_IO
;
11122 len
= get_remote_packet_size ();
11124 /* Except for querying the minimum buffer size, target must be open. */
11125 if (!rs
->remote_desc
)
11126 error (_("remote query is only available after target open"));
11128 gdb_assert (annex
!= NULL
);
11129 gdb_assert (readbuf
!= NULL
);
11131 p2
= rs
->buf
.data ();
11133 *p2
++ = query_type
;
11135 /* We used one buffer char for the remote protocol q command and
11136 another for the query type. As the remote protocol encapsulation
11137 uses 4 chars plus one extra in case we are debugging
11138 (remote_debug), we have PBUFZIZ - 7 left to pack the query
11141 while (annex
[i
] && (i
< (get_remote_packet_size () - 8)))
11143 /* Bad caller may have sent forbidden characters. */
11144 gdb_assert (isprint (annex
[i
]) && annex
[i
] != '$' && annex
[i
] != '#');
11149 gdb_assert (annex
[i
] == '\0');
11151 i
= putpkt (rs
->buf
);
11153 return TARGET_XFER_E_IO
;
11155 getpkt (&rs
->buf
, 0);
11156 strcpy ((char *) readbuf
, rs
->buf
.data ());
11158 *xfered_len
= strlen ((char *) readbuf
);
11159 return (*xfered_len
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
11162 /* Implementation of to_get_memory_xfer_limit. */
11165 remote_target::get_memory_xfer_limit ()
11167 return get_memory_write_packet_size ();
11171 remote_target::search_memory (CORE_ADDR start_addr
, ULONGEST search_space_len
,
11172 const gdb_byte
*pattern
, ULONGEST pattern_len
,
11173 CORE_ADDR
*found_addrp
)
11175 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
11176 struct remote_state
*rs
= get_remote_state ();
11177 int max_size
= get_memory_write_packet_size ();
11178 struct packet_config
*packet
=
11179 &remote_protocol_packets
[PACKET_qSearch_memory
];
11180 /* Number of packet bytes used to encode the pattern;
11181 this could be more than PATTERN_LEN due to escape characters. */
11182 int escaped_pattern_len
;
11183 /* Amount of pattern that was encodable in the packet. */
11184 int used_pattern_len
;
11187 ULONGEST found_addr
;
11189 /* Don't go to the target if we don't have to. This is done before
11190 checking packet_config_support to avoid the possibility that a
11191 success for this edge case means the facility works in
11193 if (pattern_len
> search_space_len
)
11195 if (pattern_len
== 0)
11197 *found_addrp
= start_addr
;
11201 /* If we already know the packet isn't supported, fall back to the simple
11202 way of searching memory. */
11204 if (packet_config_support (packet
) == PACKET_DISABLE
)
11206 /* Target doesn't provided special support, fall back and use the
11207 standard support (copy memory and do the search here). */
11208 return simple_search_memory (this, start_addr
, search_space_len
,
11209 pattern
, pattern_len
, found_addrp
);
11212 /* Make sure the remote is pointing at the right process. */
11213 set_general_process ();
11215 /* Insert header. */
11216 i
= snprintf (rs
->buf
.data (), max_size
,
11217 "qSearch:memory:%s;%s;",
11218 phex_nz (start_addr
, addr_size
),
11219 phex_nz (search_space_len
, sizeof (search_space_len
)));
11220 max_size
-= (i
+ 1);
11222 /* Escape as much data as fits into rs->buf. */
11223 escaped_pattern_len
=
11224 remote_escape_output (pattern
, pattern_len
, 1,
11225 (gdb_byte
*) rs
->buf
.data () + i
,
11226 &used_pattern_len
, max_size
);
11228 /* Bail if the pattern is too large. */
11229 if (used_pattern_len
!= pattern_len
)
11230 error (_("Pattern is too large to transmit to remote target."));
11232 if (putpkt_binary (rs
->buf
.data (), i
+ escaped_pattern_len
) < 0
11233 || getpkt_sane (&rs
->buf
, 0) < 0
11234 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11236 /* The request may not have worked because the command is not
11237 supported. If so, fall back to the simple way. */
11238 if (packet_config_support (packet
) == PACKET_DISABLE
)
11240 return simple_search_memory (this, start_addr
, search_space_len
,
11241 pattern
, pattern_len
, found_addrp
);
11246 if (rs
->buf
[0] == '0')
11248 else if (rs
->buf
[0] == '1')
11251 if (rs
->buf
[1] != ',')
11252 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
.data ());
11253 unpack_varlen_hex (&rs
->buf
[2], &found_addr
);
11254 *found_addrp
= found_addr
;
11257 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
.data ());
11263 remote_target::rcmd (const char *command
, struct ui_file
*outbuf
)
11265 struct remote_state
*rs
= get_remote_state ();
11266 char *p
= rs
->buf
.data ();
11268 if (!rs
->remote_desc
)
11269 error (_("remote rcmd is only available after target open"));
11271 /* Send a NULL command across as an empty command. */
11272 if (command
== NULL
)
11275 /* The query prefix. */
11276 strcpy (rs
->buf
.data (), "qRcmd,");
11277 p
= strchr (rs
->buf
.data (), '\0');
11279 if ((strlen (rs
->buf
.data ()) + strlen (command
) * 2 + 8/*misc*/)
11280 > get_remote_packet_size ())
11281 error (_("\"monitor\" command ``%s'' is too long."), command
);
11283 /* Encode the actual command. */
11284 bin2hex ((const gdb_byte
*) command
, p
, strlen (command
));
11286 if (putpkt (rs
->buf
) < 0)
11287 error (_("Communication problem with target."));
11289 /* get/display the response */
11294 /* XXX - see also remote_get_noisy_reply(). */
11295 QUIT
; /* Allow user to bail out with ^C. */
11297 if (getpkt_sane (&rs
->buf
, 0) == -1)
11299 /* Timeout. Continue to (try to) read responses.
11300 This is better than stopping with an error, assuming the stub
11301 is still executing the (long) monitor command.
11302 If needed, the user can interrupt gdb using C-c, obtaining
11303 an effect similar to stop on timeout. */
11306 buf
= rs
->buf
.data ();
11307 if (buf
[0] == '\0')
11308 error (_("Target does not support this command."));
11309 if (buf
[0] == 'O' && buf
[1] != 'K')
11311 remote_console_output (buf
+ 1); /* 'O' message from stub. */
11314 if (strcmp (buf
, "OK") == 0)
11316 if (strlen (buf
) == 3 && buf
[0] == 'E'
11317 && isdigit (buf
[1]) && isdigit (buf
[2]))
11319 error (_("Protocol error with Rcmd"));
11321 for (p
= buf
; p
[0] != '\0' && p
[1] != '\0'; p
+= 2)
11323 char c
= (fromhex (p
[0]) << 4) + fromhex (p
[1]);
11325 fputc_unfiltered (c
, outbuf
);
11331 std::vector
<mem_region
>
11332 remote_target::memory_map ()
11334 std::vector
<mem_region
> result
;
11335 gdb::optional
<gdb::char_vector
> text
11336 = target_read_stralloc (current_top_target (), TARGET_OBJECT_MEMORY_MAP
, NULL
);
11339 result
= parse_memory_map (text
->data ());
11345 packet_command (const char *args
, int from_tty
)
11347 remote_target
*remote
= get_current_remote_target ();
11349 if (remote
== nullptr)
11350 error (_("command can only be used with remote target"));
11352 remote
->packet_command (args
, from_tty
);
11356 remote_target::packet_command (const char *args
, int from_tty
)
11359 error (_("remote-packet command requires packet text as argument"));
11361 puts_filtered ("sending: ");
11362 print_packet (args
);
11363 puts_filtered ("\n");
11366 remote_state
*rs
= get_remote_state ();
11368 getpkt (&rs
->buf
, 0);
11369 puts_filtered ("received: ");
11370 print_packet (rs
->buf
.data ());
11371 puts_filtered ("\n");
11375 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
11377 static void display_thread_info (struct gdb_ext_thread_info
*info
);
11379 static void threadset_test_cmd (char *cmd
, int tty
);
11381 static void threadalive_test (char *cmd
, int tty
);
11383 static void threadlist_test_cmd (char *cmd
, int tty
);
11385 int get_and_display_threadinfo (threadref
*ref
);
11387 static void threadinfo_test_cmd (char *cmd
, int tty
);
11389 static int thread_display_step (threadref
*ref
, void *context
);
11391 static void threadlist_update_test_cmd (char *cmd
, int tty
);
11393 static void init_remote_threadtests (void);
11395 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
11398 threadset_test_cmd (const char *cmd
, int tty
)
11400 int sample_thread
= SAMPLE_THREAD
;
11402 printf_filtered (_("Remote threadset test\n"));
11403 set_general_thread (sample_thread
);
11408 threadalive_test (const char *cmd
, int tty
)
11410 int sample_thread
= SAMPLE_THREAD
;
11411 int pid
= inferior_ptid
.pid ();
11412 ptid_t ptid
= ptid_t (pid
, sample_thread
, 0);
11414 if (remote_thread_alive (ptid
))
11415 printf_filtered ("PASS: Thread alive test\n");
11417 printf_filtered ("FAIL: Thread alive test\n");
11420 void output_threadid (char *title
, threadref
*ref
);
11423 output_threadid (char *title
, threadref
*ref
)
11427 pack_threadid (&hexid
[0], ref
); /* Convert thread id into hex. */
11429 printf_filtered ("%s %s\n", title
, (&hexid
[0]));
11433 threadlist_test_cmd (const char *cmd
, int tty
)
11436 threadref nextthread
;
11437 int done
, result_count
;
11438 threadref threadlist
[3];
11440 printf_filtered ("Remote Threadlist test\n");
11441 if (!remote_get_threadlist (startflag
, &nextthread
, 3, &done
,
11442 &result_count
, &threadlist
[0]))
11443 printf_filtered ("FAIL: threadlist test\n");
11446 threadref
*scan
= threadlist
;
11447 threadref
*limit
= scan
+ result_count
;
11449 while (scan
< limit
)
11450 output_threadid (" thread ", scan
++);
11455 display_thread_info (struct gdb_ext_thread_info
*info
)
11457 output_threadid ("Threadid: ", &info
->threadid
);
11458 printf_filtered ("Name: %s\n ", info
->shortname
);
11459 printf_filtered ("State: %s\n", info
->display
);
11460 printf_filtered ("other: %s\n\n", info
->more_display
);
11464 get_and_display_threadinfo (threadref
*ref
)
11468 struct gdb_ext_thread_info threadinfo
;
11470 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
11471 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
11472 if (0 != (result
= remote_get_threadinfo (ref
, set
, &threadinfo
)))
11473 display_thread_info (&threadinfo
);
11478 threadinfo_test_cmd (const char *cmd
, int tty
)
11480 int athread
= SAMPLE_THREAD
;
11484 int_to_threadref (&thread
, athread
);
11485 printf_filtered ("Remote Threadinfo test\n");
11486 if (!get_and_display_threadinfo (&thread
))
11487 printf_filtered ("FAIL cannot get thread info\n");
11491 thread_display_step (threadref
*ref
, void *context
)
11493 /* output_threadid(" threadstep ",ref); *//* simple test */
11494 return get_and_display_threadinfo (ref
);
11498 threadlist_update_test_cmd (const char *cmd
, int tty
)
11500 printf_filtered ("Remote Threadlist update test\n");
11501 remote_threadlist_iterator (thread_display_step
, 0, CRAZY_MAX_THREADS
);
11505 init_remote_threadtests (void)
11507 add_com ("tlist", class_obscure
, threadlist_test_cmd
,
11508 _("Fetch and print the remote list of "
11509 "thread identifiers, one pkt only."));
11510 add_com ("tinfo", class_obscure
, threadinfo_test_cmd
,
11511 _("Fetch and display info about one thread."));
11512 add_com ("tset", class_obscure
, threadset_test_cmd
,
11513 _("Test setting to a different thread."));
11514 add_com ("tupd", class_obscure
, threadlist_update_test_cmd
,
11515 _("Iterate through updating all remote thread info."));
11516 add_com ("talive", class_obscure
, threadalive_test
,
11517 _("Remote thread alive test."));
11522 /* Convert a thread ID to a string. */
11525 remote_target::pid_to_str (ptid_t ptid
)
11527 struct remote_state
*rs
= get_remote_state ();
11529 if (ptid
== null_ptid
)
11530 return normal_pid_to_str (ptid
);
11531 else if (ptid
.is_pid ())
11533 /* Printing an inferior target id. */
11535 /* When multi-process extensions are off, there's no way in the
11536 remote protocol to know the remote process id, if there's any
11537 at all. There's one exception --- when we're connected with
11538 target extended-remote, and we manually attached to a process
11539 with "attach PID". We don't record anywhere a flag that
11540 allows us to distinguish that case from the case of
11541 connecting with extended-remote and the stub already being
11542 attached to a process, and reporting yes to qAttached, hence
11543 no smart special casing here. */
11544 if (!remote_multi_process_p (rs
))
11545 return "Remote target";
11547 return normal_pid_to_str (ptid
);
11551 if (magic_null_ptid
== ptid
)
11552 return "Thread <main>";
11553 else if (remote_multi_process_p (rs
))
11554 if (ptid
.lwp () == 0)
11555 return normal_pid_to_str (ptid
);
11557 return string_printf ("Thread %d.%ld",
11558 ptid
.pid (), ptid
.lwp ());
11560 return string_printf ("Thread %ld", ptid
.lwp ());
11564 /* Get the address of the thread local variable in OBJFILE which is
11565 stored at OFFSET within the thread local storage for thread PTID. */
11568 remote_target::get_thread_local_address (ptid_t ptid
, CORE_ADDR lm
,
11571 if (packet_support (PACKET_qGetTLSAddr
) != PACKET_DISABLE
)
11573 struct remote_state
*rs
= get_remote_state ();
11574 char *p
= rs
->buf
.data ();
11575 char *endp
= p
+ get_remote_packet_size ();
11576 enum packet_result result
;
11578 strcpy (p
, "qGetTLSAddr:");
11580 p
= write_ptid (p
, endp
, ptid
);
11582 p
+= hexnumstr (p
, offset
);
11584 p
+= hexnumstr (p
, lm
);
11588 getpkt (&rs
->buf
, 0);
11589 result
= packet_ok (rs
->buf
,
11590 &remote_protocol_packets
[PACKET_qGetTLSAddr
]);
11591 if (result
== PACKET_OK
)
11595 unpack_varlen_hex (rs
->buf
.data (), &addr
);
11598 else if (result
== PACKET_UNKNOWN
)
11599 throw_error (TLS_GENERIC_ERROR
,
11600 _("Remote target doesn't support qGetTLSAddr packet"));
11602 throw_error (TLS_GENERIC_ERROR
,
11603 _("Remote target failed to process qGetTLSAddr request"));
11606 throw_error (TLS_GENERIC_ERROR
,
11607 _("TLS not supported or disabled on this target"));
11612 /* Provide thread local base, i.e. Thread Information Block address.
11613 Returns 1 if ptid is found and thread_local_base is non zero. */
11616 remote_target::get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
)
11618 if (packet_support (PACKET_qGetTIBAddr
) != PACKET_DISABLE
)
11620 struct remote_state
*rs
= get_remote_state ();
11621 char *p
= rs
->buf
.data ();
11622 char *endp
= p
+ get_remote_packet_size ();
11623 enum packet_result result
;
11625 strcpy (p
, "qGetTIBAddr:");
11627 p
= write_ptid (p
, endp
, ptid
);
11631 getpkt (&rs
->buf
, 0);
11632 result
= packet_ok (rs
->buf
,
11633 &remote_protocol_packets
[PACKET_qGetTIBAddr
]);
11634 if (result
== PACKET_OK
)
11637 unpack_varlen_hex (rs
->buf
.data (), &val
);
11639 *addr
= (CORE_ADDR
) val
;
11642 else if (result
== PACKET_UNKNOWN
)
11643 error (_("Remote target doesn't support qGetTIBAddr packet"));
11645 error (_("Remote target failed to process qGetTIBAddr request"));
11648 error (_("qGetTIBAddr not supported or disabled on this target"));
11653 /* Support for inferring a target description based on the current
11654 architecture and the size of a 'g' packet. While the 'g' packet
11655 can have any size (since optional registers can be left off the
11656 end), some sizes are easily recognizable given knowledge of the
11657 approximate architecture. */
11659 struct remote_g_packet_guess
11661 remote_g_packet_guess (int bytes_
, const struct target_desc
*tdesc_
)
11668 const struct target_desc
*tdesc
;
11671 struct remote_g_packet_data
: public allocate_on_obstack
11673 std::vector
<remote_g_packet_guess
> guesses
;
11676 static struct gdbarch_data
*remote_g_packet_data_handle
;
11679 remote_g_packet_data_init (struct obstack
*obstack
)
11681 return new (obstack
) remote_g_packet_data
;
11685 register_remote_g_packet_guess (struct gdbarch
*gdbarch
, int bytes
,
11686 const struct target_desc
*tdesc
)
11688 struct remote_g_packet_data
*data
11689 = ((struct remote_g_packet_data
*)
11690 gdbarch_data (gdbarch
, remote_g_packet_data_handle
));
11692 gdb_assert (tdesc
!= NULL
);
11694 for (const remote_g_packet_guess
&guess
: data
->guesses
)
11695 if (guess
.bytes
== bytes
)
11696 internal_error (__FILE__
, __LINE__
,
11697 _("Duplicate g packet description added for size %d"),
11700 data
->guesses
.emplace_back (bytes
, tdesc
);
11703 /* Return true if remote_read_description would do anything on this target
11704 and architecture, false otherwise. */
11707 remote_read_description_p (struct target_ops
*target
)
11709 struct remote_g_packet_data
*data
11710 = ((struct remote_g_packet_data
*)
11711 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
));
11713 return !data
->guesses
.empty ();
11716 const struct target_desc
*
11717 remote_target::read_description ()
11719 struct remote_g_packet_data
*data
11720 = ((struct remote_g_packet_data
*)
11721 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
));
11723 /* Do not try this during initial connection, when we do not know
11724 whether there is a running but stopped thread. */
11725 if (!target_has_execution () || inferior_ptid
== null_ptid
)
11726 return beneath ()->read_description ();
11728 if (!data
->guesses
.empty ())
11730 int bytes
= send_g_packet ();
11732 for (const remote_g_packet_guess
&guess
: data
->guesses
)
11733 if (guess
.bytes
== bytes
)
11734 return guess
.tdesc
;
11736 /* We discard the g packet. A minor optimization would be to
11737 hold on to it, and fill the register cache once we have selected
11738 an architecture, but it's too tricky to do safely. */
11741 return beneath ()->read_description ();
11744 /* Remote file transfer support. This is host-initiated I/O, not
11745 target-initiated; for target-initiated, see remote-fileio.c. */
11747 /* If *LEFT is at least the length of STRING, copy STRING to
11748 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11749 decrease *LEFT. Otherwise raise an error. */
11752 remote_buffer_add_string (char **buffer
, int *left
, const char *string
)
11754 int len
= strlen (string
);
11757 error (_("Packet too long for target."));
11759 memcpy (*buffer
, string
, len
);
11763 /* NUL-terminate the buffer as a convenience, if there is
11769 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
11770 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11771 decrease *LEFT. Otherwise raise an error. */
11774 remote_buffer_add_bytes (char **buffer
, int *left
, const gdb_byte
*bytes
,
11777 if (2 * len
> *left
)
11778 error (_("Packet too long for target."));
11780 bin2hex (bytes
, *buffer
, len
);
11781 *buffer
+= 2 * len
;
11784 /* NUL-terminate the buffer as a convenience, if there is
11790 /* If *LEFT is large enough, convert VALUE to hex and add it to
11791 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11792 decrease *LEFT. Otherwise raise an error. */
11795 remote_buffer_add_int (char **buffer
, int *left
, ULONGEST value
)
11797 int len
= hexnumlen (value
);
11800 error (_("Packet too long for target."));
11802 hexnumstr (*buffer
, value
);
11806 /* NUL-terminate the buffer as a convenience, if there is
11812 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
11813 value, *REMOTE_ERRNO to the remote error number or zero if none
11814 was included, and *ATTACHMENT to point to the start of the annex
11815 if any. The length of the packet isn't needed here; there may
11816 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
11818 Return 0 if the packet could be parsed, -1 if it could not. If
11819 -1 is returned, the other variables may not be initialized. */
11822 remote_hostio_parse_result (char *buffer
, int *retcode
,
11823 int *remote_errno
, char **attachment
)
11828 *attachment
= NULL
;
11830 if (buffer
[0] != 'F')
11834 *retcode
= strtol (&buffer
[1], &p
, 16);
11835 if (errno
!= 0 || p
== &buffer
[1])
11838 /* Check for ",errno". */
11842 *remote_errno
= strtol (p
+ 1, &p2
, 16);
11843 if (errno
!= 0 || p
+ 1 == p2
)
11848 /* Check for ";attachment". If there is no attachment, the
11849 packet should end here. */
11852 *attachment
= p
+ 1;
11855 else if (*p
== '\0')
11861 /* Send a prepared I/O packet to the target and read its response.
11862 The prepared packet is in the global RS->BUF before this function
11863 is called, and the answer is there when we return.
11865 COMMAND_BYTES is the length of the request to send, which may include
11866 binary data. WHICH_PACKET is the packet configuration to check
11867 before attempting a packet. If an error occurs, *REMOTE_ERRNO
11868 is set to the error number and -1 is returned. Otherwise the value
11869 returned by the function is returned.
11871 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
11872 attachment is expected; an error will be reported if there's a
11873 mismatch. If one is found, *ATTACHMENT will be set to point into
11874 the packet buffer and *ATTACHMENT_LEN will be set to the
11875 attachment's length. */
11878 remote_target::remote_hostio_send_command (int command_bytes
, int which_packet
,
11879 int *remote_errno
, char **attachment
,
11880 int *attachment_len
)
11882 struct remote_state
*rs
= get_remote_state ();
11883 int ret
, bytes_read
;
11884 char *attachment_tmp
;
11886 if (packet_support (which_packet
) == PACKET_DISABLE
)
11888 *remote_errno
= FILEIO_ENOSYS
;
11892 putpkt_binary (rs
->buf
.data (), command_bytes
);
11893 bytes_read
= getpkt_sane (&rs
->buf
, 0);
11895 /* If it timed out, something is wrong. Don't try to parse the
11897 if (bytes_read
< 0)
11899 *remote_errno
= FILEIO_EINVAL
;
11903 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[which_packet
]))
11906 *remote_errno
= FILEIO_EINVAL
;
11908 case PACKET_UNKNOWN
:
11909 *remote_errno
= FILEIO_ENOSYS
;
11915 if (remote_hostio_parse_result (rs
->buf
.data (), &ret
, remote_errno
,
11918 *remote_errno
= FILEIO_EINVAL
;
11922 /* Make sure we saw an attachment if and only if we expected one. */
11923 if ((attachment_tmp
== NULL
&& attachment
!= NULL
)
11924 || (attachment_tmp
!= NULL
&& attachment
== NULL
))
11926 *remote_errno
= FILEIO_EINVAL
;
11930 /* If an attachment was found, it must point into the packet buffer;
11931 work out how many bytes there were. */
11932 if (attachment_tmp
!= NULL
)
11934 *attachment
= attachment_tmp
;
11935 *attachment_len
= bytes_read
- (*attachment
- rs
->buf
.data ());
11941 /* See declaration.h. */
11944 readahead_cache::invalidate ()
11949 /* See declaration.h. */
11952 readahead_cache::invalidate_fd (int fd
)
11954 if (this->fd
== fd
)
11958 /* Set the filesystem remote_hostio functions that take FILENAME
11959 arguments will use. Return 0 on success, or -1 if an error
11960 occurs (and set *REMOTE_ERRNO). */
11963 remote_target::remote_hostio_set_filesystem (struct inferior
*inf
,
11966 struct remote_state
*rs
= get_remote_state ();
11967 int required_pid
= (inf
== NULL
|| inf
->fake_pid_p
) ? 0 : inf
->pid
;
11968 char *p
= rs
->buf
.data ();
11969 int left
= get_remote_packet_size () - 1;
11973 if (packet_support (PACKET_vFile_setfs
) == PACKET_DISABLE
)
11976 if (rs
->fs_pid
!= -1 && required_pid
== rs
->fs_pid
)
11979 remote_buffer_add_string (&p
, &left
, "vFile:setfs:");
11981 xsnprintf (arg
, sizeof (arg
), "%x", required_pid
);
11982 remote_buffer_add_string (&p
, &left
, arg
);
11984 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_setfs
,
11985 remote_errno
, NULL
, NULL
);
11987 if (packet_support (PACKET_vFile_setfs
) == PACKET_DISABLE
)
11991 rs
->fs_pid
= required_pid
;
11996 /* Implementation of to_fileio_open. */
11999 remote_target::remote_hostio_open (inferior
*inf
, const char *filename
,
12000 int flags
, int mode
, int warn_if_slow
,
12003 struct remote_state
*rs
= get_remote_state ();
12004 char *p
= rs
->buf
.data ();
12005 int left
= get_remote_packet_size () - 1;
12009 static int warning_issued
= 0;
12011 printf_unfiltered (_("Reading %s from remote target...\n"),
12014 if (!warning_issued
)
12016 warning (_("File transfers from remote targets can be slow."
12017 " Use \"set sysroot\" to access files locally"
12019 warning_issued
= 1;
12023 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12026 remote_buffer_add_string (&p
, &left
, "vFile:open:");
12028 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12029 strlen (filename
));
12030 remote_buffer_add_string (&p
, &left
, ",");
12032 remote_buffer_add_int (&p
, &left
, flags
);
12033 remote_buffer_add_string (&p
, &left
, ",");
12035 remote_buffer_add_int (&p
, &left
, mode
);
12037 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_open
,
12038 remote_errno
, NULL
, NULL
);
12042 remote_target::fileio_open (struct inferior
*inf
, const char *filename
,
12043 int flags
, int mode
, int warn_if_slow
,
12046 return remote_hostio_open (inf
, filename
, flags
, mode
, warn_if_slow
,
12050 /* Implementation of to_fileio_pwrite. */
12053 remote_target::remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
12054 ULONGEST offset
, int *remote_errno
)
12056 struct remote_state
*rs
= get_remote_state ();
12057 char *p
= rs
->buf
.data ();
12058 int left
= get_remote_packet_size ();
12061 rs
->readahead_cache
.invalidate_fd (fd
);
12063 remote_buffer_add_string (&p
, &left
, "vFile:pwrite:");
12065 remote_buffer_add_int (&p
, &left
, fd
);
12066 remote_buffer_add_string (&p
, &left
, ",");
12068 remote_buffer_add_int (&p
, &left
, offset
);
12069 remote_buffer_add_string (&p
, &left
, ",");
12071 p
+= remote_escape_output (write_buf
, len
, 1, (gdb_byte
*) p
, &out_len
,
12072 (get_remote_packet_size ()
12073 - (p
- rs
->buf
.data ())));
12075 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_pwrite
,
12076 remote_errno
, NULL
, NULL
);
12080 remote_target::fileio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
12081 ULONGEST offset
, int *remote_errno
)
12083 return remote_hostio_pwrite (fd
, write_buf
, len
, offset
, remote_errno
);
12086 /* Helper for the implementation of to_fileio_pread. Read the file
12087 from the remote side with vFile:pread. */
12090 remote_target::remote_hostio_pread_vFile (int fd
, gdb_byte
*read_buf
, int len
,
12091 ULONGEST offset
, int *remote_errno
)
12093 struct remote_state
*rs
= get_remote_state ();
12094 char *p
= rs
->buf
.data ();
12096 int left
= get_remote_packet_size ();
12097 int ret
, attachment_len
;
12100 remote_buffer_add_string (&p
, &left
, "vFile:pread:");
12102 remote_buffer_add_int (&p
, &left
, fd
);
12103 remote_buffer_add_string (&p
, &left
, ",");
12105 remote_buffer_add_int (&p
, &left
, len
);
12106 remote_buffer_add_string (&p
, &left
, ",");
12108 remote_buffer_add_int (&p
, &left
, offset
);
12110 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_pread
,
12111 remote_errno
, &attachment
,
12117 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12119 if (read_len
!= ret
)
12120 error (_("Read returned %d, but %d bytes."), ret
, (int) read_len
);
12125 /* See declaration.h. */
12128 readahead_cache::pread (int fd
, gdb_byte
*read_buf
, size_t len
,
12132 && this->offset
<= offset
12133 && offset
< this->offset
+ this->bufsize
)
12135 ULONGEST max
= this->offset
+ this->bufsize
;
12137 if (offset
+ len
> max
)
12138 len
= max
- offset
;
12140 memcpy (read_buf
, this->buf
+ offset
- this->offset
, len
);
12147 /* Implementation of to_fileio_pread. */
12150 remote_target::remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
12151 ULONGEST offset
, int *remote_errno
)
12154 struct remote_state
*rs
= get_remote_state ();
12155 readahead_cache
*cache
= &rs
->readahead_cache
;
12157 ret
= cache
->pread (fd
, read_buf
, len
, offset
);
12160 cache
->hit_count
++;
12163 fprintf_unfiltered (gdb_stdlog
, "readahead cache hit %s\n",
12164 pulongest (cache
->hit_count
));
12168 cache
->miss_count
++;
12170 fprintf_unfiltered (gdb_stdlog
, "readahead cache miss %s\n",
12171 pulongest (cache
->miss_count
));
12174 cache
->offset
= offset
;
12175 cache
->bufsize
= get_remote_packet_size ();
12176 cache
->buf
= (gdb_byte
*) xrealloc (cache
->buf
, cache
->bufsize
);
12178 ret
= remote_hostio_pread_vFile (cache
->fd
, cache
->buf
, cache
->bufsize
,
12179 cache
->offset
, remote_errno
);
12182 cache
->invalidate_fd (fd
);
12186 cache
->bufsize
= ret
;
12187 return cache
->pread (fd
, read_buf
, len
, offset
);
12191 remote_target::fileio_pread (int fd
, gdb_byte
*read_buf
, int len
,
12192 ULONGEST offset
, int *remote_errno
)
12194 return remote_hostio_pread (fd
, read_buf
, len
, offset
, remote_errno
);
12197 /* Implementation of to_fileio_close. */
12200 remote_target::remote_hostio_close (int fd
, int *remote_errno
)
12202 struct remote_state
*rs
= get_remote_state ();
12203 char *p
= rs
->buf
.data ();
12204 int left
= get_remote_packet_size () - 1;
12206 rs
->readahead_cache
.invalidate_fd (fd
);
12208 remote_buffer_add_string (&p
, &left
, "vFile:close:");
12210 remote_buffer_add_int (&p
, &left
, fd
);
12212 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_close
,
12213 remote_errno
, NULL
, NULL
);
12217 remote_target::fileio_close (int fd
, int *remote_errno
)
12219 return remote_hostio_close (fd
, remote_errno
);
12222 /* Implementation of to_fileio_unlink. */
12225 remote_target::remote_hostio_unlink (inferior
*inf
, const char *filename
,
12228 struct remote_state
*rs
= get_remote_state ();
12229 char *p
= rs
->buf
.data ();
12230 int left
= get_remote_packet_size () - 1;
12232 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12235 remote_buffer_add_string (&p
, &left
, "vFile:unlink:");
12237 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12238 strlen (filename
));
12240 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_unlink
,
12241 remote_errno
, NULL
, NULL
);
12245 remote_target::fileio_unlink (struct inferior
*inf
, const char *filename
,
12248 return remote_hostio_unlink (inf
, filename
, remote_errno
);
12251 /* Implementation of to_fileio_readlink. */
12253 gdb::optional
<std::string
>
12254 remote_target::fileio_readlink (struct inferior
*inf
, const char *filename
,
12257 struct remote_state
*rs
= get_remote_state ();
12258 char *p
= rs
->buf
.data ();
12260 int left
= get_remote_packet_size ();
12261 int len
, attachment_len
;
12264 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12267 remote_buffer_add_string (&p
, &left
, "vFile:readlink:");
12269 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12270 strlen (filename
));
12272 len
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_readlink
,
12273 remote_errno
, &attachment
,
12279 std::string
ret (len
, '\0');
12281 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12282 (gdb_byte
*) &ret
[0], len
);
12283 if (read_len
!= len
)
12284 error (_("Readlink returned %d, but %d bytes."), len
, read_len
);
12289 /* Implementation of to_fileio_fstat. */
12292 remote_target::fileio_fstat (int fd
, struct stat
*st
, int *remote_errno
)
12294 struct remote_state
*rs
= get_remote_state ();
12295 char *p
= rs
->buf
.data ();
12296 int left
= get_remote_packet_size ();
12297 int attachment_len
, ret
;
12299 struct fio_stat fst
;
12302 remote_buffer_add_string (&p
, &left
, "vFile:fstat:");
12304 remote_buffer_add_int (&p
, &left
, fd
);
12306 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_fstat
,
12307 remote_errno
, &attachment
,
12311 if (*remote_errno
!= FILEIO_ENOSYS
)
12314 /* Strictly we should return -1, ENOSYS here, but when
12315 "set sysroot remote:" was implemented in August 2008
12316 BFD's need for a stat function was sidestepped with
12317 this hack. This was not remedied until March 2015
12318 so we retain the previous behavior to avoid breaking
12321 Note that the memset is a March 2015 addition; older
12322 GDBs set st_size *and nothing else* so the structure
12323 would have garbage in all other fields. This might
12324 break something but retaining the previous behavior
12325 here would be just too wrong. */
12327 memset (st
, 0, sizeof (struct stat
));
12328 st
->st_size
= INT_MAX
;
12332 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12333 (gdb_byte
*) &fst
, sizeof (fst
));
12335 if (read_len
!= ret
)
12336 error (_("vFile:fstat returned %d, but %d bytes."), ret
, read_len
);
12338 if (read_len
!= sizeof (fst
))
12339 error (_("vFile:fstat returned %d bytes, but expecting %d."),
12340 read_len
, (int) sizeof (fst
));
12342 remote_fileio_to_host_stat (&fst
, st
);
12347 /* Implementation of to_filesystem_is_local. */
12350 remote_target::filesystem_is_local ()
12352 /* Valgrind GDB presents itself as a remote target but works
12353 on the local filesystem: it does not implement remote get
12354 and users are not expected to set a sysroot. To handle
12355 this case we treat the remote filesystem as local if the
12356 sysroot is exactly TARGET_SYSROOT_PREFIX and if the stub
12357 does not support vFile:open. */
12358 if (strcmp (gdb_sysroot
, TARGET_SYSROOT_PREFIX
) == 0)
12360 enum packet_support ps
= packet_support (PACKET_vFile_open
);
12362 if (ps
== PACKET_SUPPORT_UNKNOWN
)
12364 int fd
, remote_errno
;
12366 /* Try opening a file to probe support. The supplied
12367 filename is irrelevant, we only care about whether
12368 the stub recognizes the packet or not. */
12369 fd
= remote_hostio_open (NULL
, "just probing",
12370 FILEIO_O_RDONLY
, 0700, 0,
12374 remote_hostio_close (fd
, &remote_errno
);
12376 ps
= packet_support (PACKET_vFile_open
);
12379 if (ps
== PACKET_DISABLE
)
12381 static int warning_issued
= 0;
12383 if (!warning_issued
)
12385 warning (_("remote target does not support file"
12386 " transfer, attempting to access files"
12387 " from local filesystem."));
12388 warning_issued
= 1;
12399 remote_fileio_errno_to_host (int errnum
)
12405 case FILEIO_ENOENT
:
12413 case FILEIO_EACCES
:
12415 case FILEIO_EFAULT
:
12419 case FILEIO_EEXIST
:
12421 case FILEIO_ENODEV
:
12423 case FILEIO_ENOTDIR
:
12425 case FILEIO_EISDIR
:
12427 case FILEIO_EINVAL
:
12429 case FILEIO_ENFILE
:
12431 case FILEIO_EMFILE
:
12435 case FILEIO_ENOSPC
:
12437 case FILEIO_ESPIPE
:
12441 case FILEIO_ENOSYS
:
12443 case FILEIO_ENAMETOOLONG
:
12444 return ENAMETOOLONG
;
12450 remote_hostio_error (int errnum
)
12452 int host_error
= remote_fileio_errno_to_host (errnum
);
12454 if (host_error
== -1)
12455 error (_("Unknown remote I/O error %d"), errnum
);
12457 error (_("Remote I/O error: %s"), safe_strerror (host_error
));
12460 /* A RAII wrapper around a remote file descriptor. */
12462 class scoped_remote_fd
12465 scoped_remote_fd (remote_target
*remote
, int fd
)
12466 : m_remote (remote
), m_fd (fd
)
12470 ~scoped_remote_fd ()
12477 m_remote
->remote_hostio_close (m_fd
, &remote_errno
);
12481 /* Swallow exception before it escapes the dtor. If
12482 something goes wrong, likely the connection is gone,
12483 and there's nothing else that can be done. */
12488 DISABLE_COPY_AND_ASSIGN (scoped_remote_fd
);
12490 /* Release ownership of the file descriptor, and return it. */
12491 ATTRIBUTE_UNUSED_RESULT
int release () noexcept
12498 /* Return the owned file descriptor. */
12499 int get () const noexcept
12505 /* The remote target. */
12506 remote_target
*m_remote
;
12508 /* The owned remote I/O file descriptor. */
12513 remote_file_put (const char *local_file
, const char *remote_file
, int from_tty
)
12515 remote_target
*remote
= get_current_remote_target ();
12517 if (remote
== nullptr)
12518 error (_("command can only be used with remote target"));
12520 remote
->remote_file_put (local_file
, remote_file
, from_tty
);
12524 remote_target::remote_file_put (const char *local_file
, const char *remote_file
,
12527 int retcode
, remote_errno
, bytes
, io_size
;
12528 int bytes_in_buffer
;
12532 gdb_file_up file
= gdb_fopen_cloexec (local_file
, "rb");
12534 perror_with_name (local_file
);
12536 scoped_remote_fd fd
12537 (this, remote_hostio_open (NULL
,
12538 remote_file
, (FILEIO_O_WRONLY
| FILEIO_O_CREAT
12540 0700, 0, &remote_errno
));
12541 if (fd
.get () == -1)
12542 remote_hostio_error (remote_errno
);
12544 /* Send up to this many bytes at once. They won't all fit in the
12545 remote packet limit, so we'll transfer slightly fewer. */
12546 io_size
= get_remote_packet_size ();
12547 gdb::byte_vector
buffer (io_size
);
12549 bytes_in_buffer
= 0;
12552 while (bytes_in_buffer
|| !saw_eof
)
12556 bytes
= fread (buffer
.data () + bytes_in_buffer
, 1,
12557 io_size
- bytes_in_buffer
,
12561 if (ferror (file
.get ()))
12562 error (_("Error reading %s."), local_file
);
12565 /* EOF. Unless there is something still in the
12566 buffer from the last iteration, we are done. */
12568 if (bytes_in_buffer
== 0)
12576 bytes
+= bytes_in_buffer
;
12577 bytes_in_buffer
= 0;
12579 retcode
= remote_hostio_pwrite (fd
.get (), buffer
.data (), bytes
,
12580 offset
, &remote_errno
);
12583 remote_hostio_error (remote_errno
);
12584 else if (retcode
== 0)
12585 error (_("Remote write of %d bytes returned 0!"), bytes
);
12586 else if (retcode
< bytes
)
12588 /* Short write. Save the rest of the read data for the next
12590 bytes_in_buffer
= bytes
- retcode
;
12591 memmove (buffer
.data (), buffer
.data () + retcode
, bytes_in_buffer
);
12597 if (remote_hostio_close (fd
.release (), &remote_errno
))
12598 remote_hostio_error (remote_errno
);
12601 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file
);
12605 remote_file_get (const char *remote_file
, const char *local_file
, int from_tty
)
12607 remote_target
*remote
= get_current_remote_target ();
12609 if (remote
== nullptr)
12610 error (_("command can only be used with remote target"));
12612 remote
->remote_file_get (remote_file
, local_file
, from_tty
);
12616 remote_target::remote_file_get (const char *remote_file
, const char *local_file
,
12619 int remote_errno
, bytes
, io_size
;
12622 scoped_remote_fd fd
12623 (this, remote_hostio_open (NULL
,
12624 remote_file
, FILEIO_O_RDONLY
, 0, 0,
12626 if (fd
.get () == -1)
12627 remote_hostio_error (remote_errno
);
12629 gdb_file_up file
= gdb_fopen_cloexec (local_file
, "wb");
12631 perror_with_name (local_file
);
12633 /* Send up to this many bytes at once. They won't all fit in the
12634 remote packet limit, so we'll transfer slightly fewer. */
12635 io_size
= get_remote_packet_size ();
12636 gdb::byte_vector
buffer (io_size
);
12641 bytes
= remote_hostio_pread (fd
.get (), buffer
.data (), io_size
, offset
,
12644 /* Success, but no bytes, means end-of-file. */
12647 remote_hostio_error (remote_errno
);
12651 bytes
= fwrite (buffer
.data (), 1, bytes
, file
.get ());
12653 perror_with_name (local_file
);
12656 if (remote_hostio_close (fd
.release (), &remote_errno
))
12657 remote_hostio_error (remote_errno
);
12660 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file
);
12664 remote_file_delete (const char *remote_file
, int from_tty
)
12666 remote_target
*remote
= get_current_remote_target ();
12668 if (remote
== nullptr)
12669 error (_("command can only be used with remote target"));
12671 remote
->remote_file_delete (remote_file
, from_tty
);
12675 remote_target::remote_file_delete (const char *remote_file
, int from_tty
)
12677 int retcode
, remote_errno
;
12679 retcode
= remote_hostio_unlink (NULL
, remote_file
, &remote_errno
);
12681 remote_hostio_error (remote_errno
);
12684 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file
);
12688 remote_put_command (const char *args
, int from_tty
)
12691 error_no_arg (_("file to put"));
12693 gdb_argv
argv (args
);
12694 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
12695 error (_("Invalid parameters to remote put"));
12697 remote_file_put (argv
[0], argv
[1], from_tty
);
12701 remote_get_command (const char *args
, int from_tty
)
12704 error_no_arg (_("file to get"));
12706 gdb_argv
argv (args
);
12707 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
12708 error (_("Invalid parameters to remote get"));
12710 remote_file_get (argv
[0], argv
[1], from_tty
);
12714 remote_delete_command (const char *args
, int from_tty
)
12717 error_no_arg (_("file to delete"));
12719 gdb_argv
argv (args
);
12720 if (argv
[0] == NULL
|| argv
[1] != NULL
)
12721 error (_("Invalid parameters to remote delete"));
12723 remote_file_delete (argv
[0], from_tty
);
12727 remote_target::can_execute_reverse ()
12729 if (packet_support (PACKET_bs
) == PACKET_ENABLE
12730 || packet_support (PACKET_bc
) == PACKET_ENABLE
)
12737 remote_target::supports_non_stop ()
12743 remote_target::supports_disable_randomization ()
12745 /* Only supported in extended mode. */
12750 remote_target::supports_multi_process ()
12752 struct remote_state
*rs
= get_remote_state ();
12754 return remote_multi_process_p (rs
);
12758 remote_supports_cond_tracepoints ()
12760 return packet_support (PACKET_ConditionalTracepoints
) == PACKET_ENABLE
;
12764 remote_target::supports_evaluation_of_breakpoint_conditions ()
12766 return packet_support (PACKET_ConditionalBreakpoints
) == PACKET_ENABLE
;
12770 remote_supports_fast_tracepoints ()
12772 return packet_support (PACKET_FastTracepoints
) == PACKET_ENABLE
;
12776 remote_supports_static_tracepoints ()
12778 return packet_support (PACKET_StaticTracepoints
) == PACKET_ENABLE
;
12782 remote_supports_install_in_trace ()
12784 return packet_support (PACKET_InstallInTrace
) == PACKET_ENABLE
;
12788 remote_target::supports_enable_disable_tracepoint ()
12790 return (packet_support (PACKET_EnableDisableTracepoints_feature
)
12795 remote_target::supports_string_tracing ()
12797 return packet_support (PACKET_tracenz_feature
) == PACKET_ENABLE
;
12801 remote_target::can_run_breakpoint_commands ()
12803 return packet_support (PACKET_BreakpointCommands
) == PACKET_ENABLE
;
12807 remote_target::trace_init ()
12809 struct remote_state
*rs
= get_remote_state ();
12812 remote_get_noisy_reply ();
12813 if (strcmp (rs
->buf
.data (), "OK") != 0)
12814 error (_("Target does not support this command."));
12817 /* Recursive routine to walk through command list including loops, and
12818 download packets for each command. */
12821 remote_target::remote_download_command_source (int num
, ULONGEST addr
,
12822 struct command_line
*cmds
)
12824 struct remote_state
*rs
= get_remote_state ();
12825 struct command_line
*cmd
;
12827 for (cmd
= cmds
; cmd
; cmd
= cmd
->next
)
12829 QUIT
; /* Allow user to bail out with ^C. */
12830 strcpy (rs
->buf
.data (), "QTDPsrc:");
12831 encode_source_string (num
, addr
, "cmd", cmd
->line
,
12832 rs
->buf
.data () + strlen (rs
->buf
.data ()),
12833 rs
->buf
.size () - strlen (rs
->buf
.data ()));
12835 remote_get_noisy_reply ();
12836 if (strcmp (rs
->buf
.data (), "OK"))
12837 warning (_("Target does not support source download."));
12839 if (cmd
->control_type
== while_control
12840 || cmd
->control_type
== while_stepping_control
)
12842 remote_download_command_source (num
, addr
, cmd
->body_list_0
.get ());
12844 QUIT
; /* Allow user to bail out with ^C. */
12845 strcpy (rs
->buf
.data (), "QTDPsrc:");
12846 encode_source_string (num
, addr
, "cmd", "end",
12847 rs
->buf
.data () + strlen (rs
->buf
.data ()),
12848 rs
->buf
.size () - strlen (rs
->buf
.data ()));
12850 remote_get_noisy_reply ();
12851 if (strcmp (rs
->buf
.data (), "OK"))
12852 warning (_("Target does not support source download."));
12858 remote_target::download_tracepoint (struct bp_location
*loc
)
12862 std::vector
<std::string
> tdp_actions
;
12863 std::vector
<std::string
> stepping_actions
;
12865 struct breakpoint
*b
= loc
->owner
;
12866 struct tracepoint
*t
= (struct tracepoint
*) b
;
12867 struct remote_state
*rs
= get_remote_state ();
12869 const char *err_msg
= _("Tracepoint packet too large for target.");
12872 /* We use a buffer other than rs->buf because we'll build strings
12873 across multiple statements, and other statements in between could
12875 gdb::char_vector
buf (get_remote_packet_size ());
12877 encode_actions_rsp (loc
, &tdp_actions
, &stepping_actions
);
12879 tpaddr
= loc
->address
;
12880 strcpy (addrbuf
, phex (tpaddr
, sizeof (CORE_ADDR
)));
12881 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:%x:%s:%c:%lx:%x",
12882 b
->number
, addrbuf
, /* address */
12883 (b
->enable_state
== bp_enabled
? 'E' : 'D'),
12884 t
->step_count
, t
->pass_count
);
12886 if (ret
< 0 || ret
>= buf
.size ())
12887 error ("%s", err_msg
);
12889 /* Fast tracepoints are mostly handled by the target, but we can
12890 tell the target how big of an instruction block should be moved
12892 if (b
->type
== bp_fast_tracepoint
)
12894 /* Only test for support at download time; we may not know
12895 target capabilities at definition time. */
12896 if (remote_supports_fast_tracepoints ())
12898 if (gdbarch_fast_tracepoint_valid_at (loc
->gdbarch
, tpaddr
,
12901 size_left
= buf
.size () - strlen (buf
.data ());
12902 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
12904 gdb_insn_length (loc
->gdbarch
, tpaddr
));
12906 if (ret
< 0 || ret
>= size_left
)
12907 error ("%s", err_msg
);
12910 /* If it passed validation at definition but fails now,
12911 something is very wrong. */
12912 internal_error (__FILE__
, __LINE__
,
12913 _("Fast tracepoint not "
12914 "valid during download"));
12917 /* Fast tracepoints are functionally identical to regular
12918 tracepoints, so don't take lack of support as a reason to
12919 give up on the trace run. */
12920 warning (_("Target does not support fast tracepoints, "
12921 "downloading %d as regular tracepoint"), b
->number
);
12923 else if (b
->type
== bp_static_tracepoint
)
12925 /* Only test for support at download time; we may not know
12926 target capabilities at definition time. */
12927 if (remote_supports_static_tracepoints ())
12929 struct static_tracepoint_marker marker
;
12931 if (target_static_tracepoint_marker_at (tpaddr
, &marker
))
12933 size_left
= buf
.size () - strlen (buf
.data ());
12934 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
12937 if (ret
< 0 || ret
>= size_left
)
12938 error ("%s", err_msg
);
12941 error (_("Static tracepoint not valid during download"));
12944 /* Fast tracepoints are functionally identical to regular
12945 tracepoints, so don't take lack of support as a reason
12946 to give up on the trace run. */
12947 error (_("Target does not support static tracepoints"));
12949 /* If the tracepoint has a conditional, make it into an agent
12950 expression and append to the definition. */
12953 /* Only test support at download time, we may not know target
12954 capabilities at definition time. */
12955 if (remote_supports_cond_tracepoints ())
12957 agent_expr_up aexpr
= gen_eval_for_expr (tpaddr
,
12960 size_left
= buf
.size () - strlen (buf
.data ());
12962 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
12963 size_left
, ":X%x,", aexpr
->len
);
12965 if (ret
< 0 || ret
>= size_left
)
12966 error ("%s", err_msg
);
12968 size_left
= buf
.size () - strlen (buf
.data ());
12970 /* Two bytes to encode each aexpr byte, plus the terminating
12972 if (aexpr
->len
* 2 + 1 > size_left
)
12973 error ("%s", err_msg
);
12975 pkt
= buf
.data () + strlen (buf
.data ());
12977 for (int ndx
= 0; ndx
< aexpr
->len
; ++ndx
)
12978 pkt
= pack_hex_byte (pkt
, aexpr
->buf
[ndx
]);
12982 warning (_("Target does not support conditional tracepoints, "
12983 "ignoring tp %d cond"), b
->number
);
12986 if (b
->commands
|| *default_collect
)
12988 size_left
= buf
.size () - strlen (buf
.data ());
12990 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
12993 if (ret
< 0 || ret
>= size_left
)
12994 error ("%s", err_msg
);
12997 putpkt (buf
.data ());
12998 remote_get_noisy_reply ();
12999 if (strcmp (rs
->buf
.data (), "OK"))
13000 error (_("Target does not support tracepoints."));
13002 /* do_single_steps (t); */
13003 for (auto action_it
= tdp_actions
.begin ();
13004 action_it
!= tdp_actions
.end (); action_it
++)
13006 QUIT
; /* Allow user to bail out with ^C. */
13008 bool has_more
= ((action_it
+ 1) != tdp_actions
.end ()
13009 || !stepping_actions
.empty ());
13011 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:-%x:%s:%s%c",
13012 b
->number
, addrbuf
, /* address */
13013 action_it
->c_str (),
13014 has_more
? '-' : 0);
13016 if (ret
< 0 || ret
>= buf
.size ())
13017 error ("%s", err_msg
);
13019 putpkt (buf
.data ());
13020 remote_get_noisy_reply ();
13021 if (strcmp (rs
->buf
.data (), "OK"))
13022 error (_("Error on target while setting tracepoints."));
13025 for (auto action_it
= stepping_actions
.begin ();
13026 action_it
!= stepping_actions
.end (); action_it
++)
13028 QUIT
; /* Allow user to bail out with ^C. */
13030 bool is_first
= action_it
== stepping_actions
.begin ();
13031 bool has_more
= (action_it
+ 1) != stepping_actions
.end ();
13033 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:-%x:%s:%s%s%s",
13034 b
->number
, addrbuf
, /* address */
13035 is_first
? "S" : "",
13036 action_it
->c_str (),
13037 has_more
? "-" : "");
13039 if (ret
< 0 || ret
>= buf
.size ())
13040 error ("%s", err_msg
);
13042 putpkt (buf
.data ());
13043 remote_get_noisy_reply ();
13044 if (strcmp (rs
->buf
.data (), "OK"))
13045 error (_("Error on target while setting tracepoints."));
13048 if (packet_support (PACKET_TracepointSource
) == PACKET_ENABLE
)
13050 if (b
->location
!= NULL
)
13052 ret
= snprintf (buf
.data (), buf
.size (), "QTDPsrc:");
13054 if (ret
< 0 || ret
>= buf
.size ())
13055 error ("%s", err_msg
);
13057 encode_source_string (b
->number
, loc
->address
, "at",
13058 event_location_to_string (b
->location
.get ()),
13059 buf
.data () + strlen (buf
.data ()),
13060 buf
.size () - strlen (buf
.data ()));
13061 putpkt (buf
.data ());
13062 remote_get_noisy_reply ();
13063 if (strcmp (rs
->buf
.data (), "OK"))
13064 warning (_("Target does not support source download."));
13066 if (b
->cond_string
)
13068 ret
= snprintf (buf
.data (), buf
.size (), "QTDPsrc:");
13070 if (ret
< 0 || ret
>= buf
.size ())
13071 error ("%s", err_msg
);
13073 encode_source_string (b
->number
, loc
->address
,
13074 "cond", b
->cond_string
,
13075 buf
.data () + strlen (buf
.data ()),
13076 buf
.size () - strlen (buf
.data ()));
13077 putpkt (buf
.data ());
13078 remote_get_noisy_reply ();
13079 if (strcmp (rs
->buf
.data (), "OK"))
13080 warning (_("Target does not support source download."));
13082 remote_download_command_source (b
->number
, loc
->address
,
13083 breakpoint_commands (b
));
13088 remote_target::can_download_tracepoint ()
13090 struct remote_state
*rs
= get_remote_state ();
13091 struct trace_status
*ts
;
13094 /* Don't try to install tracepoints until we've relocated our
13095 symbols, and fetched and merged the target's tracepoint list with
13097 if (rs
->starting_up
)
13100 ts
= current_trace_status ();
13101 status
= get_trace_status (ts
);
13103 if (status
== -1 || !ts
->running_known
|| !ts
->running
)
13106 /* If we are in a tracing experiment, but remote stub doesn't support
13107 installing tracepoint in trace, we have to return. */
13108 if (!remote_supports_install_in_trace ())
13116 remote_target::download_trace_state_variable (const trace_state_variable
&tsv
)
13118 struct remote_state
*rs
= get_remote_state ();
13121 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTDV:%x:%s:%x:",
13122 tsv
.number
, phex ((ULONGEST
) tsv
.initial_value
, 8),
13124 p
= rs
->buf
.data () + strlen (rs
->buf
.data ());
13125 if ((p
- rs
->buf
.data ()) + tsv
.name
.length () * 2
13126 >= get_remote_packet_size ())
13127 error (_("Trace state variable name too long for tsv definition packet"));
13128 p
+= 2 * bin2hex ((gdb_byte
*) (tsv
.name
.data ()), p
, tsv
.name
.length ());
13131 remote_get_noisy_reply ();
13132 if (rs
->buf
[0] == '\0')
13133 error (_("Target does not support this command."));
13134 if (strcmp (rs
->buf
.data (), "OK") != 0)
13135 error (_("Error on target while downloading trace state variable."));
13139 remote_target::enable_tracepoint (struct bp_location
*location
)
13141 struct remote_state
*rs
= get_remote_state ();
13143 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTEnable:%x:%s",
13144 location
->owner
->number
,
13145 phex (location
->address
, sizeof (CORE_ADDR
)));
13147 remote_get_noisy_reply ();
13148 if (rs
->buf
[0] == '\0')
13149 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
13150 if (strcmp (rs
->buf
.data (), "OK") != 0)
13151 error (_("Error on target while enabling tracepoint."));
13155 remote_target::disable_tracepoint (struct bp_location
*location
)
13157 struct remote_state
*rs
= get_remote_state ();
13159 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTDisable:%x:%s",
13160 location
->owner
->number
,
13161 phex (location
->address
, sizeof (CORE_ADDR
)));
13163 remote_get_noisy_reply ();
13164 if (rs
->buf
[0] == '\0')
13165 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
13166 if (strcmp (rs
->buf
.data (), "OK") != 0)
13167 error (_("Error on target while disabling tracepoint."));
13171 remote_target::trace_set_readonly_regions ()
13174 bfd_size_type size
;
13180 return; /* No information to give. */
13182 struct remote_state
*rs
= get_remote_state ();
13184 strcpy (rs
->buf
.data (), "QTro");
13185 offset
= strlen (rs
->buf
.data ());
13186 for (s
= exec_bfd
->sections
; s
; s
= s
->next
)
13188 char tmp1
[40], tmp2
[40];
13191 if ((s
->flags
& SEC_LOAD
) == 0 ||
13192 /* (s->flags & SEC_CODE) == 0 || */
13193 (s
->flags
& SEC_READONLY
) == 0)
13197 vma
= bfd_section_vma (s
);
13198 size
= bfd_section_size (s
);
13199 sprintf_vma (tmp1
, vma
);
13200 sprintf_vma (tmp2
, vma
+ size
);
13201 sec_length
= 1 + strlen (tmp1
) + 1 + strlen (tmp2
);
13202 if (offset
+ sec_length
+ 1 > rs
->buf
.size ())
13204 if (packet_support (PACKET_qXfer_traceframe_info
) != PACKET_ENABLE
)
13206 Too many sections for read-only sections definition packet."));
13209 xsnprintf (rs
->buf
.data () + offset
, rs
->buf
.size () - offset
, ":%s,%s",
13211 offset
+= sec_length
;
13216 getpkt (&rs
->buf
, 0);
13221 remote_target::trace_start ()
13223 struct remote_state
*rs
= get_remote_state ();
13225 putpkt ("QTStart");
13226 remote_get_noisy_reply ();
13227 if (rs
->buf
[0] == '\0')
13228 error (_("Target does not support this command."));
13229 if (strcmp (rs
->buf
.data (), "OK") != 0)
13230 error (_("Bogus reply from target: %s"), rs
->buf
.data ());
13234 remote_target::get_trace_status (struct trace_status
*ts
)
13236 /* Initialize it just to avoid a GCC false warning. */
13238 enum packet_result result
;
13239 struct remote_state
*rs
= get_remote_state ();
13241 if (packet_support (PACKET_qTStatus
) == PACKET_DISABLE
)
13244 /* FIXME we need to get register block size some other way. */
13245 trace_regblock_size
13246 = rs
->get_remote_arch_state (target_gdbarch ())->sizeof_g_packet
;
13248 putpkt ("qTStatus");
13252 p
= remote_get_noisy_reply ();
13254 catch (const gdb_exception_error
&ex
)
13256 if (ex
.error
!= TARGET_CLOSE_ERROR
)
13258 exception_fprintf (gdb_stderr
, ex
, "qTStatus: ");
13264 result
= packet_ok (p
, &remote_protocol_packets
[PACKET_qTStatus
]);
13266 /* If the remote target doesn't do tracing, flag it. */
13267 if (result
== PACKET_UNKNOWN
)
13270 /* We're working with a live target. */
13271 ts
->filename
= NULL
;
13274 error (_("Bogus trace status reply from target: %s"), rs
->buf
.data ());
13276 /* Function 'parse_trace_status' sets default value of each field of
13277 'ts' at first, so we don't have to do it here. */
13278 parse_trace_status (p
, ts
);
13280 return ts
->running
;
13284 remote_target::get_tracepoint_status (struct breakpoint
*bp
,
13285 struct uploaded_tp
*utp
)
13287 struct remote_state
*rs
= get_remote_state ();
13289 struct bp_location
*loc
;
13290 struct tracepoint
*tp
= (struct tracepoint
*) bp
;
13291 size_t size
= get_remote_packet_size ();
13296 tp
->traceframe_usage
= 0;
13297 for (loc
= tp
->loc
; loc
; loc
= loc
->next
)
13299 /* If the tracepoint was never downloaded, don't go asking for
13301 if (tp
->number_on_target
== 0)
13303 xsnprintf (rs
->buf
.data (), size
, "qTP:%x:%s", tp
->number_on_target
,
13304 phex_nz (loc
->address
, 0));
13306 reply
= remote_get_noisy_reply ();
13307 if (reply
&& *reply
)
13310 parse_tracepoint_status (reply
+ 1, bp
, utp
);
13316 utp
->hit_count
= 0;
13317 utp
->traceframe_usage
= 0;
13318 xsnprintf (rs
->buf
.data (), size
, "qTP:%x:%s", utp
->number
,
13319 phex_nz (utp
->addr
, 0));
13321 reply
= remote_get_noisy_reply ();
13322 if (reply
&& *reply
)
13325 parse_tracepoint_status (reply
+ 1, bp
, utp
);
13331 remote_target::trace_stop ()
13333 struct remote_state
*rs
= get_remote_state ();
13336 remote_get_noisy_reply ();
13337 if (rs
->buf
[0] == '\0')
13338 error (_("Target does not support this command."));
13339 if (strcmp (rs
->buf
.data (), "OK") != 0)
13340 error (_("Bogus reply from target: %s"), rs
->buf
.data ());
13344 remote_target::trace_find (enum trace_find_type type
, int num
,
13345 CORE_ADDR addr1
, CORE_ADDR addr2
,
13348 struct remote_state
*rs
= get_remote_state ();
13349 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
13351 int target_frameno
= -1, target_tracept
= -1;
13353 /* Lookups other than by absolute frame number depend on the current
13354 trace selected, so make sure it is correct on the remote end
13356 if (type
!= tfind_number
)
13357 set_remote_traceframe ();
13359 p
= rs
->buf
.data ();
13360 strcpy (p
, "QTFrame:");
13361 p
= strchr (p
, '\0');
13365 xsnprintf (p
, endbuf
- p
, "%x", num
);
13368 xsnprintf (p
, endbuf
- p
, "pc:%s", phex_nz (addr1
, 0));
13371 xsnprintf (p
, endbuf
- p
, "tdp:%x", num
);
13374 xsnprintf (p
, endbuf
- p
, "range:%s:%s", phex_nz (addr1
, 0),
13375 phex_nz (addr2
, 0));
13377 case tfind_outside
:
13378 xsnprintf (p
, endbuf
- p
, "outside:%s:%s", phex_nz (addr1
, 0),
13379 phex_nz (addr2
, 0));
13382 error (_("Unknown trace find type %d"), type
);
13386 reply
= remote_get_noisy_reply ();
13387 if (*reply
== '\0')
13388 error (_("Target does not support this command."));
13390 while (reply
&& *reply
)
13395 target_frameno
= (int) strtol (p
, &reply
, 16);
13397 error (_("Unable to parse trace frame number"));
13398 /* Don't update our remote traceframe number cache on failure
13399 to select a remote traceframe. */
13400 if (target_frameno
== -1)
13405 target_tracept
= (int) strtol (p
, &reply
, 16);
13407 error (_("Unable to parse tracepoint number"));
13409 case 'O': /* "OK"? */
13410 if (reply
[1] == 'K' && reply
[2] == '\0')
13413 error (_("Bogus reply from target: %s"), reply
);
13416 error (_("Bogus reply from target: %s"), reply
);
13419 *tpp
= target_tracept
;
13421 rs
->remote_traceframe_number
= target_frameno
;
13422 return target_frameno
;
13426 remote_target::get_trace_state_variable_value (int tsvnum
, LONGEST
*val
)
13428 struct remote_state
*rs
= get_remote_state ();
13432 set_remote_traceframe ();
13434 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qTV:%x", tsvnum
);
13436 reply
= remote_get_noisy_reply ();
13437 if (reply
&& *reply
)
13441 unpack_varlen_hex (reply
+ 1, &uval
);
13442 *val
= (LONGEST
) uval
;
13450 remote_target::save_trace_data (const char *filename
)
13452 struct remote_state
*rs
= get_remote_state ();
13455 p
= rs
->buf
.data ();
13456 strcpy (p
, "QTSave:");
13458 if ((p
- rs
->buf
.data ()) + strlen (filename
) * 2
13459 >= get_remote_packet_size ())
13460 error (_("Remote file name too long for trace save packet"));
13461 p
+= 2 * bin2hex ((gdb_byte
*) filename
, p
, strlen (filename
));
13464 reply
= remote_get_noisy_reply ();
13465 if (*reply
== '\0')
13466 error (_("Target does not support this command."));
13467 if (strcmp (reply
, "OK") != 0)
13468 error (_("Bogus reply from target: %s"), reply
);
13472 /* This is basically a memory transfer, but needs to be its own packet
13473 because we don't know how the target actually organizes its trace
13474 memory, plus we want to be able to ask for as much as possible, but
13475 not be unhappy if we don't get as much as we ask for. */
13478 remote_target::get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
)
13480 struct remote_state
*rs
= get_remote_state ();
13485 p
= rs
->buf
.data ();
13486 strcpy (p
, "qTBuffer:");
13488 p
+= hexnumstr (p
, offset
);
13490 p
+= hexnumstr (p
, len
);
13494 reply
= remote_get_noisy_reply ();
13495 if (reply
&& *reply
)
13497 /* 'l' by itself means we're at the end of the buffer and
13498 there is nothing more to get. */
13502 /* Convert the reply into binary. Limit the number of bytes to
13503 convert according to our passed-in buffer size, rather than
13504 what was returned in the packet; if the target is
13505 unexpectedly generous and gives us a bigger reply than we
13506 asked for, we don't want to crash. */
13507 rslt
= hex2bin (reply
, buf
, len
);
13511 /* Something went wrong, flag as an error. */
13516 remote_target::set_disconnected_tracing (int val
)
13518 struct remote_state
*rs
= get_remote_state ();
13520 if (packet_support (PACKET_DisconnectedTracing_feature
) == PACKET_ENABLE
)
13524 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
13525 "QTDisconnected:%x", val
);
13527 reply
= remote_get_noisy_reply ();
13528 if (*reply
== '\0')
13529 error (_("Target does not support this command."));
13530 if (strcmp (reply
, "OK") != 0)
13531 error (_("Bogus reply from target: %s"), reply
);
13534 warning (_("Target does not support disconnected tracing."));
13538 remote_target::core_of_thread (ptid_t ptid
)
13540 thread_info
*info
= find_thread_ptid (this, ptid
);
13542 if (info
!= NULL
&& info
->priv
!= NULL
)
13543 return get_remote_thread_info (info
)->core
;
13549 remote_target::set_circular_trace_buffer (int val
)
13551 struct remote_state
*rs
= get_remote_state ();
13554 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
13555 "QTBuffer:circular:%x", val
);
13557 reply
= remote_get_noisy_reply ();
13558 if (*reply
== '\0')
13559 error (_("Target does not support this command."));
13560 if (strcmp (reply
, "OK") != 0)
13561 error (_("Bogus reply from target: %s"), reply
);
13565 remote_target::traceframe_info ()
13567 gdb::optional
<gdb::char_vector
> text
13568 = target_read_stralloc (current_top_target (), TARGET_OBJECT_TRACEFRAME_INFO
,
13571 return parse_traceframe_info (text
->data ());
13576 /* Handle the qTMinFTPILen packet. Returns the minimum length of
13577 instruction on which a fast tracepoint may be placed. Returns -1
13578 if the packet is not supported, and 0 if the minimum instruction
13579 length is unknown. */
13582 remote_target::get_min_fast_tracepoint_insn_len ()
13584 struct remote_state
*rs
= get_remote_state ();
13587 /* If we're not debugging a process yet, the IPA can't be
13589 if (!target_has_execution ())
13592 /* Make sure the remote is pointing at the right process. */
13593 set_general_process ();
13595 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qTMinFTPILen");
13597 reply
= remote_get_noisy_reply ();
13598 if (*reply
== '\0')
13602 ULONGEST min_insn_len
;
13604 unpack_varlen_hex (reply
, &min_insn_len
);
13606 return (int) min_insn_len
;
13611 remote_target::set_trace_buffer_size (LONGEST val
)
13613 if (packet_support (PACKET_QTBuffer_size
) != PACKET_DISABLE
)
13615 struct remote_state
*rs
= get_remote_state ();
13616 char *buf
= rs
->buf
.data ();
13617 char *endbuf
= buf
+ get_remote_packet_size ();
13618 enum packet_result result
;
13620 gdb_assert (val
>= 0 || val
== -1);
13621 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTBuffer:size:");
13622 /* Send -1 as literal "-1" to avoid host size dependency. */
13626 buf
+= hexnumstr (buf
, (ULONGEST
) -val
);
13629 buf
+= hexnumstr (buf
, (ULONGEST
) val
);
13632 remote_get_noisy_reply ();
13633 result
= packet_ok (rs
->buf
,
13634 &remote_protocol_packets
[PACKET_QTBuffer_size
]);
13636 if (result
!= PACKET_OK
)
13637 warning (_("Bogus reply from target: %s"), rs
->buf
.data ());
13642 remote_target::set_trace_notes (const char *user
, const char *notes
,
13643 const char *stop_notes
)
13645 struct remote_state
*rs
= get_remote_state ();
13647 char *buf
= rs
->buf
.data ();
13648 char *endbuf
= buf
+ get_remote_packet_size ();
13651 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTNotes:");
13654 buf
+= xsnprintf (buf
, endbuf
- buf
, "user:");
13655 nbytes
= bin2hex ((gdb_byte
*) user
, buf
, strlen (user
));
13661 buf
+= xsnprintf (buf
, endbuf
- buf
, "notes:");
13662 nbytes
= bin2hex ((gdb_byte
*) notes
, buf
, strlen (notes
));
13668 buf
+= xsnprintf (buf
, endbuf
- buf
, "tstop:");
13669 nbytes
= bin2hex ((gdb_byte
*) stop_notes
, buf
, strlen (stop_notes
));
13673 /* Ensure the buffer is terminated. */
13677 reply
= remote_get_noisy_reply ();
13678 if (*reply
== '\0')
13681 if (strcmp (reply
, "OK") != 0)
13682 error (_("Bogus reply from target: %s"), reply
);
13688 remote_target::use_agent (bool use
)
13690 if (packet_support (PACKET_QAgent
) != PACKET_DISABLE
)
13692 struct remote_state
*rs
= get_remote_state ();
13694 /* If the stub supports QAgent. */
13695 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QAgent:%d", use
);
13697 getpkt (&rs
->buf
, 0);
13699 if (strcmp (rs
->buf
.data (), "OK") == 0)
13710 remote_target::can_use_agent ()
13712 return (packet_support (PACKET_QAgent
) != PACKET_DISABLE
);
13715 struct btrace_target_info
13717 /* The ptid of the traced thread. */
13720 /* The obtained branch trace configuration. */
13721 struct btrace_config conf
;
13724 /* Reset our idea of our target's btrace configuration. */
13727 remote_btrace_reset (remote_state
*rs
)
13729 memset (&rs
->btrace_config
, 0, sizeof (rs
->btrace_config
));
13732 /* Synchronize the configuration with the target. */
13735 remote_target::btrace_sync_conf (const btrace_config
*conf
)
13737 struct packet_config
*packet
;
13738 struct remote_state
*rs
;
13739 char *buf
, *pos
, *endbuf
;
13741 rs
= get_remote_state ();
13742 buf
= rs
->buf
.data ();
13743 endbuf
= buf
+ get_remote_packet_size ();
13745 packet
= &remote_protocol_packets
[PACKET_Qbtrace_conf_bts_size
];
13746 if (packet_config_support (packet
) == PACKET_ENABLE
13747 && conf
->bts
.size
!= rs
->btrace_config
.bts
.size
)
13750 pos
+= xsnprintf (pos
, endbuf
- pos
, "%s=0x%x", packet
->name
,
13754 getpkt (&rs
->buf
, 0);
13756 if (packet_ok (buf
, packet
) == PACKET_ERROR
)
13758 if (buf
[0] == 'E' && buf
[1] == '.')
13759 error (_("Failed to configure the BTS buffer size: %s"), buf
+ 2);
13761 error (_("Failed to configure the BTS buffer size."));
13764 rs
->btrace_config
.bts
.size
= conf
->bts
.size
;
13767 packet
= &remote_protocol_packets
[PACKET_Qbtrace_conf_pt_size
];
13768 if (packet_config_support (packet
) == PACKET_ENABLE
13769 && conf
->pt
.size
!= rs
->btrace_config
.pt
.size
)
13772 pos
+= xsnprintf (pos
, endbuf
- pos
, "%s=0x%x", packet
->name
,
13776 getpkt (&rs
->buf
, 0);
13778 if (packet_ok (buf
, packet
) == PACKET_ERROR
)
13780 if (buf
[0] == 'E' && buf
[1] == '.')
13781 error (_("Failed to configure the trace buffer size: %s"), buf
+ 2);
13783 error (_("Failed to configure the trace buffer size."));
13786 rs
->btrace_config
.pt
.size
= conf
->pt
.size
;
13790 /* Read the current thread's btrace configuration from the target and
13791 store it into CONF. */
13794 btrace_read_config (struct btrace_config
*conf
)
13796 gdb::optional
<gdb::char_vector
> xml
13797 = target_read_stralloc (current_top_target (), TARGET_OBJECT_BTRACE_CONF
, "");
13799 parse_xml_btrace_conf (conf
, xml
->data ());
13802 /* Maybe reopen target btrace. */
13805 remote_target::remote_btrace_maybe_reopen ()
13807 struct remote_state
*rs
= get_remote_state ();
13808 int btrace_target_pushed
= 0;
13809 #if !defined (HAVE_LIBIPT)
13813 /* Don't bother walking the entirety of the remote thread list when
13814 we know the feature isn't supported by the remote. */
13815 if (packet_support (PACKET_qXfer_btrace_conf
) != PACKET_ENABLE
)
13818 scoped_restore_current_thread restore_thread
;
13820 for (thread_info
*tp
: all_non_exited_threads (this))
13822 set_general_thread (tp
->ptid
);
13824 memset (&rs
->btrace_config
, 0x00, sizeof (struct btrace_config
));
13825 btrace_read_config (&rs
->btrace_config
);
13827 if (rs
->btrace_config
.format
== BTRACE_FORMAT_NONE
)
13830 #if !defined (HAVE_LIBIPT)
13831 if (rs
->btrace_config
.format
== BTRACE_FORMAT_PT
)
13836 warning (_("Target is recording using Intel Processor Trace "
13837 "but support was disabled at compile time."));
13842 #endif /* !defined (HAVE_LIBIPT) */
13844 /* Push target, once, but before anything else happens. This way our
13845 changes to the threads will be cleaned up by unpushing the target
13846 in case btrace_read_config () throws. */
13847 if (!btrace_target_pushed
)
13849 btrace_target_pushed
= 1;
13850 record_btrace_push_target ();
13851 printf_filtered (_("Target is recording using %s.\n"),
13852 btrace_format_string (rs
->btrace_config
.format
));
13855 tp
->btrace
.target
= XCNEW (struct btrace_target_info
);
13856 tp
->btrace
.target
->ptid
= tp
->ptid
;
13857 tp
->btrace
.target
->conf
= rs
->btrace_config
;
13861 /* Enable branch tracing. */
13863 struct btrace_target_info
*
13864 remote_target::enable_btrace (ptid_t ptid
, const struct btrace_config
*conf
)
13866 struct btrace_target_info
*tinfo
= NULL
;
13867 struct packet_config
*packet
= NULL
;
13868 struct remote_state
*rs
= get_remote_state ();
13869 char *buf
= rs
->buf
.data ();
13870 char *endbuf
= buf
+ get_remote_packet_size ();
13872 switch (conf
->format
)
13874 case BTRACE_FORMAT_BTS
:
13875 packet
= &remote_protocol_packets
[PACKET_Qbtrace_bts
];
13878 case BTRACE_FORMAT_PT
:
13879 packet
= &remote_protocol_packets
[PACKET_Qbtrace_pt
];
13883 if (packet
== NULL
|| packet_config_support (packet
) != PACKET_ENABLE
)
13884 error (_("Target does not support branch tracing."));
13886 btrace_sync_conf (conf
);
13888 set_general_thread (ptid
);
13890 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
13892 getpkt (&rs
->buf
, 0);
13894 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
13896 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
13897 error (_("Could not enable branch tracing for %s: %s"),
13898 target_pid_to_str (ptid
).c_str (), &rs
->buf
[2]);
13900 error (_("Could not enable branch tracing for %s."),
13901 target_pid_to_str (ptid
).c_str ());
13904 tinfo
= XCNEW (struct btrace_target_info
);
13905 tinfo
->ptid
= ptid
;
13907 /* If we fail to read the configuration, we lose some information, but the
13908 tracing itself is not impacted. */
13911 btrace_read_config (&tinfo
->conf
);
13913 catch (const gdb_exception_error
&err
)
13915 if (err
.message
!= NULL
)
13916 warning ("%s", err
.what ());
13922 /* Disable branch tracing. */
13925 remote_target::disable_btrace (struct btrace_target_info
*tinfo
)
13927 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_Qbtrace_off
];
13928 struct remote_state
*rs
= get_remote_state ();
13929 char *buf
= rs
->buf
.data ();
13930 char *endbuf
= buf
+ get_remote_packet_size ();
13932 if (packet_config_support (packet
) != PACKET_ENABLE
)
13933 error (_("Target does not support branch tracing."));
13935 set_general_thread (tinfo
->ptid
);
13937 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
13939 getpkt (&rs
->buf
, 0);
13941 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
13943 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
13944 error (_("Could not disable branch tracing for %s: %s"),
13945 target_pid_to_str (tinfo
->ptid
).c_str (), &rs
->buf
[2]);
13947 error (_("Could not disable branch tracing for %s."),
13948 target_pid_to_str (tinfo
->ptid
).c_str ());
13954 /* Teardown branch tracing. */
13957 remote_target::teardown_btrace (struct btrace_target_info
*tinfo
)
13959 /* We must not talk to the target during teardown. */
13963 /* Read the branch trace. */
13966 remote_target::read_btrace (struct btrace_data
*btrace
,
13967 struct btrace_target_info
*tinfo
,
13968 enum btrace_read_type type
)
13970 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_qXfer_btrace
];
13973 if (packet_config_support (packet
) != PACKET_ENABLE
)
13974 error (_("Target does not support branch tracing."));
13976 #if !defined(HAVE_LIBEXPAT)
13977 error (_("Cannot process branch tracing result. XML parsing not supported."));
13982 case BTRACE_READ_ALL
:
13985 case BTRACE_READ_NEW
:
13988 case BTRACE_READ_DELTA
:
13992 internal_error (__FILE__
, __LINE__
,
13993 _("Bad branch tracing read type: %u."),
13994 (unsigned int) type
);
13997 gdb::optional
<gdb::char_vector
> xml
13998 = target_read_stralloc (current_top_target (), TARGET_OBJECT_BTRACE
, annex
);
14000 return BTRACE_ERR_UNKNOWN
;
14002 parse_xml_btrace (btrace
, xml
->data ());
14004 return BTRACE_ERR_NONE
;
14007 const struct btrace_config
*
14008 remote_target::btrace_conf (const struct btrace_target_info
*tinfo
)
14010 return &tinfo
->conf
;
14014 remote_target::augmented_libraries_svr4_read ()
14016 return (packet_support (PACKET_augmented_libraries_svr4_read_feature
)
14020 /* Implementation of to_load. */
14023 remote_target::load (const char *name
, int from_tty
)
14025 generic_load (name
, from_tty
);
14028 /* Accepts an integer PID; returns a string representing a file that
14029 can be opened on the remote side to get the symbols for the child
14030 process. Returns NULL if the operation is not supported. */
14033 remote_target::pid_to_exec_file (int pid
)
14035 static gdb::optional
<gdb::char_vector
> filename
;
14036 char *annex
= NULL
;
14038 if (packet_support (PACKET_qXfer_exec_file
) != PACKET_ENABLE
)
14041 inferior
*inf
= find_inferior_pid (this, pid
);
14043 internal_error (__FILE__
, __LINE__
,
14044 _("not currently attached to process %d"), pid
);
14046 if (!inf
->fake_pid_p
)
14048 const int annex_size
= 9;
14050 annex
= (char *) alloca (annex_size
);
14051 xsnprintf (annex
, annex_size
, "%x", pid
);
14054 filename
= target_read_stralloc (current_top_target (),
14055 TARGET_OBJECT_EXEC_FILE
, annex
);
14057 return filename
? filename
->data () : nullptr;
14060 /* Implement the to_can_do_single_step target_ops method. */
14063 remote_target::can_do_single_step ()
14065 /* We can only tell whether target supports single step or not by
14066 supported s and S vCont actions if the stub supports vContSupported
14067 feature. If the stub doesn't support vContSupported feature,
14068 we have conservatively to think target doesn't supports single
14070 if (packet_support (PACKET_vContSupported
) == PACKET_ENABLE
)
14072 struct remote_state
*rs
= get_remote_state ();
14074 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
14075 remote_vcont_probe ();
14077 return rs
->supports_vCont
.s
&& rs
->supports_vCont
.S
;
14083 /* Implementation of the to_execution_direction method for the remote
14086 enum exec_direction_kind
14087 remote_target::execution_direction ()
14089 struct remote_state
*rs
= get_remote_state ();
14091 return rs
->last_resume_exec_dir
;
14094 /* Return pointer to the thread_info struct which corresponds to
14095 THREAD_HANDLE (having length HANDLE_LEN). */
14098 remote_target::thread_handle_to_thread_info (const gdb_byte
*thread_handle
,
14102 for (thread_info
*tp
: all_non_exited_threads (this))
14104 remote_thread_info
*priv
= get_remote_thread_info (tp
);
14106 if (tp
->inf
== inf
&& priv
!= NULL
)
14108 if (handle_len
!= priv
->thread_handle
.size ())
14109 error (_("Thread handle size mismatch: %d vs %zu (from remote)"),
14110 handle_len
, priv
->thread_handle
.size ());
14111 if (memcmp (thread_handle
, priv
->thread_handle
.data (),
14121 remote_target::thread_info_to_thread_handle (struct thread_info
*tp
)
14123 remote_thread_info
*priv
= get_remote_thread_info (tp
);
14124 return priv
->thread_handle
;
14128 remote_target::can_async_p ()
14130 struct remote_state
*rs
= get_remote_state ();
14132 /* We don't go async if the user has explicitly prevented it with the
14133 "maint set target-async" command. */
14134 if (!target_async_permitted
)
14137 /* We're async whenever the serial device is. */
14138 return serial_can_async_p (rs
->remote_desc
);
14142 remote_target::is_async_p ()
14144 struct remote_state
*rs
= get_remote_state ();
14146 if (!target_async_permitted
)
14147 /* We only enable async when the user specifically asks for it. */
14150 /* We're async whenever the serial device is. */
14151 return serial_is_async_p (rs
->remote_desc
);
14154 /* Pass the SERIAL event on and up to the client. One day this code
14155 will be able to delay notifying the client of an event until the
14156 point where an entire packet has been received. */
14158 static serial_event_ftype remote_async_serial_handler
;
14161 remote_async_serial_handler (struct serial
*scb
, void *context
)
14163 /* Don't propogate error information up to the client. Instead let
14164 the client find out about the error by querying the target. */
14165 inferior_event_handler (INF_REG_EVENT
);
14169 remote_async_inferior_event_handler (gdb_client_data data
)
14171 inferior_event_handler (INF_REG_EVENT
);
14173 remote_target
*remote
= (remote_target
*) data
;
14174 remote_state
*rs
= remote
->get_remote_state ();
14176 /* inferior_event_handler may have consumed an event pending on the
14177 infrun side without calling target_wait on the REMOTE target, or
14178 may have pulled an event out of a different target. Keep trying
14179 for this remote target as long it still has either pending events
14180 or unacknowledged notifications. */
14182 if (rs
->notif_state
->pending_event
[notif_client_stop
.id
] != NULL
14183 || !rs
->stop_reply_queue
.empty ())
14184 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
14188 remote_target::async_wait_fd ()
14190 struct remote_state
*rs
= get_remote_state ();
14191 return rs
->remote_desc
->fd
;
14195 remote_target::async (int enable
)
14197 struct remote_state
*rs
= get_remote_state ();
14201 serial_async (rs
->remote_desc
, remote_async_serial_handler
, rs
);
14203 /* If there are pending events in the stop reply queue tell the
14204 event loop to process them. */
14205 if (!rs
->stop_reply_queue
.empty ())
14206 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
14207 /* For simplicity, below we clear the pending events token
14208 without remembering whether it is marked, so here we always
14209 mark it. If there's actually no pending notification to
14210 process, this ends up being a no-op (other than a spurious
14211 event-loop wakeup). */
14212 if (target_is_non_stop_p ())
14213 mark_async_event_handler (rs
->notif_state
->get_pending_events_token
);
14217 serial_async (rs
->remote_desc
, NULL
, NULL
);
14218 /* If the core is disabling async, it doesn't want to be
14219 disturbed with target events. Clear all async event sources
14221 clear_async_event_handler (rs
->remote_async_inferior_event_token
);
14222 if (target_is_non_stop_p ())
14223 clear_async_event_handler (rs
->notif_state
->get_pending_events_token
);
14227 /* Implementation of the to_thread_events method. */
14230 remote_target::thread_events (int enable
)
14232 struct remote_state
*rs
= get_remote_state ();
14233 size_t size
= get_remote_packet_size ();
14235 if (packet_support (PACKET_QThreadEvents
) == PACKET_DISABLE
)
14238 xsnprintf (rs
->buf
.data (), size
, "QThreadEvents:%x", enable
? 1 : 0);
14240 getpkt (&rs
->buf
, 0);
14242 switch (packet_ok (rs
->buf
,
14243 &remote_protocol_packets
[PACKET_QThreadEvents
]))
14246 if (strcmp (rs
->buf
.data (), "OK") != 0)
14247 error (_("Remote refused setting thread events: %s"), rs
->buf
.data ());
14250 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
14252 case PACKET_UNKNOWN
:
14258 show_remote_cmd (const char *args
, int from_tty
)
14260 /* We can't just use cmd_show_list here, because we want to skip
14261 the redundant "show remote Z-packet" and the legacy aliases. */
14262 struct cmd_list_element
*list
= remote_show_cmdlist
;
14263 struct ui_out
*uiout
= current_uiout
;
14265 ui_out_emit_tuple
tuple_emitter (uiout
, "showlist");
14266 for (; list
!= NULL
; list
= list
->next
)
14267 if (strcmp (list
->name
, "Z-packet") == 0)
14269 else if (list
->type
== not_set_cmd
)
14270 /* Alias commands are exactly like the original, except they
14271 don't have the normal type. */
14275 ui_out_emit_tuple
option_emitter (uiout
, "option");
14277 uiout
->field_string ("name", list
->name
);
14278 uiout
->text (": ");
14279 if (list
->type
== show_cmd
)
14280 do_show_command (NULL
, from_tty
, list
);
14282 cmd_func (list
, NULL
, from_tty
);
14287 /* Function to be called whenever a new objfile (shlib) is detected. */
14289 remote_new_objfile (struct objfile
*objfile
)
14291 remote_target
*remote
= get_current_remote_target ();
14293 if (remote
!= NULL
) /* Have a remote connection. */
14294 remote
->remote_check_symbols ();
14297 /* Pull all the tracepoints defined on the target and create local
14298 data structures representing them. We don't want to create real
14299 tracepoints yet, we don't want to mess up the user's existing
14303 remote_target::upload_tracepoints (struct uploaded_tp
**utpp
)
14305 struct remote_state
*rs
= get_remote_state ();
14308 /* Ask for a first packet of tracepoint definition. */
14310 getpkt (&rs
->buf
, 0);
14311 p
= rs
->buf
.data ();
14312 while (*p
&& *p
!= 'l')
14314 parse_tracepoint_definition (p
, utpp
);
14315 /* Ask for another packet of tracepoint definition. */
14317 getpkt (&rs
->buf
, 0);
14318 p
= rs
->buf
.data ();
14324 remote_target::upload_trace_state_variables (struct uploaded_tsv
**utsvp
)
14326 struct remote_state
*rs
= get_remote_state ();
14329 /* Ask for a first packet of variable definition. */
14331 getpkt (&rs
->buf
, 0);
14332 p
= rs
->buf
.data ();
14333 while (*p
&& *p
!= 'l')
14335 parse_tsv_definition (p
, utsvp
);
14336 /* Ask for another packet of variable definition. */
14338 getpkt (&rs
->buf
, 0);
14339 p
= rs
->buf
.data ();
14344 /* The "set/show range-stepping" show hook. */
14347 show_range_stepping (struct ui_file
*file
, int from_tty
,
14348 struct cmd_list_element
*c
,
14351 fprintf_filtered (file
,
14352 _("Debugger's willingness to use range stepping "
14353 "is %s.\n"), value
);
14356 /* Return true if the vCont;r action is supported by the remote
14360 remote_target::vcont_r_supported ()
14362 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
14363 remote_vcont_probe ();
14365 return (packet_support (PACKET_vCont
) == PACKET_ENABLE
14366 && get_remote_state ()->supports_vCont
.r
);
14369 /* The "set/show range-stepping" set hook. */
14372 set_range_stepping (const char *ignore_args
, int from_tty
,
14373 struct cmd_list_element
*c
)
14375 /* When enabling, check whether range stepping is actually supported
14376 by the target, and warn if not. */
14377 if (use_range_stepping
)
14379 remote_target
*remote
= get_current_remote_target ();
14381 || !remote
->vcont_r_supported ())
14382 warning (_("Range stepping is not supported by the current target"));
14386 void _initialize_remote ();
14388 _initialize_remote ()
14390 struct cmd_list_element
*cmd
;
14391 const char *cmd_name
;
14393 /* architecture specific data */
14394 remote_g_packet_data_handle
=
14395 gdbarch_data_register_pre_init (remote_g_packet_data_init
);
14397 add_target (remote_target_info
, remote_target::open
);
14398 add_target (extended_remote_target_info
, extended_remote_target::open
);
14400 /* Hook into new objfile notification. */
14401 gdb::observers::new_objfile
.attach (remote_new_objfile
);
14404 init_remote_threadtests ();
14407 /* set/show remote ... */
14409 add_basic_prefix_cmd ("remote", class_maintenance
, _("\
14410 Remote protocol specific variables.\n\
14411 Configure various remote-protocol specific variables such as\n\
14412 the packets being used."),
14413 &remote_set_cmdlist
, "set remote ",
14414 0 /* allow-unknown */, &setlist
);
14415 add_prefix_cmd ("remote", class_maintenance
, show_remote_cmd
, _("\
14416 Remote protocol specific variables.\n\
14417 Configure various remote-protocol specific variables such as\n\
14418 the packets being used."),
14419 &remote_show_cmdlist
, "show remote ",
14420 0 /* allow-unknown */, &showlist
);
14422 add_cmd ("compare-sections", class_obscure
, compare_sections_command
, _("\
14423 Compare section data on target to the exec file.\n\
14424 Argument is a single section name (default: all loaded sections).\n\
14425 To compare only read-only loaded sections, specify the -r option."),
14428 add_cmd ("packet", class_maintenance
, packet_command
, _("\
14429 Send an arbitrary packet to a remote target.\n\
14430 maintenance packet TEXT\n\
14431 If GDB is talking to an inferior via the GDB serial protocol, then\n\
14432 this command sends the string TEXT to the inferior, and displays the\n\
14433 response packet. GDB supplies the initial `$' character, and the\n\
14434 terminating `#' character and checksum."),
14437 add_setshow_boolean_cmd ("remotebreak", no_class
, &remote_break
, _("\
14438 Set whether to send break if interrupted."), _("\
14439 Show whether to send break if interrupted."), _("\
14440 If set, a break, instead of a cntrl-c, is sent to the remote target."),
14441 set_remotebreak
, show_remotebreak
,
14442 &setlist
, &showlist
);
14443 cmd_name
= "remotebreak";
14444 cmd
= lookup_cmd (&cmd_name
, setlist
, "", NULL
, -1, 1);
14445 deprecate_cmd (cmd
, "set remote interrupt-sequence");
14446 cmd_name
= "remotebreak"; /* needed because lookup_cmd updates the pointer */
14447 cmd
= lookup_cmd (&cmd_name
, showlist
, "", NULL
, -1, 1);
14448 deprecate_cmd (cmd
, "show remote interrupt-sequence");
14450 add_setshow_enum_cmd ("interrupt-sequence", class_support
,
14451 interrupt_sequence_modes
, &interrupt_sequence_mode
,
14453 Set interrupt sequence to remote target."), _("\
14454 Show interrupt sequence to remote target."), _("\
14455 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
14456 NULL
, show_interrupt_sequence
,
14457 &remote_set_cmdlist
,
14458 &remote_show_cmdlist
);
14460 add_setshow_boolean_cmd ("interrupt-on-connect", class_support
,
14461 &interrupt_on_connect
, _("\
14462 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _("\
14463 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _("\
14464 If set, interrupt sequence is sent to remote target."),
14466 &remote_set_cmdlist
, &remote_show_cmdlist
);
14468 /* Install commands for configuring memory read/write packets. */
14470 add_cmd ("remotewritesize", no_class
, set_memory_write_packet_size
, _("\
14471 Set the maximum number of bytes per memory write packet (deprecated)."),
14473 add_cmd ("remotewritesize", no_class
, show_memory_write_packet_size
, _("\
14474 Show the maximum number of bytes per memory write packet (deprecated)."),
14476 add_cmd ("memory-write-packet-size", no_class
,
14477 set_memory_write_packet_size
, _("\
14478 Set the maximum number of bytes per memory-write packet.\n\
14479 Specify the number of bytes in a packet or 0 (zero) for the\n\
14480 default packet size. The actual limit is further reduced\n\
14481 dependent on the target. Specify ``fixed'' to disable the\n\
14482 further restriction and ``limit'' to enable that restriction."),
14483 &remote_set_cmdlist
);
14484 add_cmd ("memory-read-packet-size", no_class
,
14485 set_memory_read_packet_size
, _("\
14486 Set the maximum number of bytes per memory-read packet.\n\
14487 Specify the number of bytes in a packet or 0 (zero) for the\n\
14488 default packet size. The actual limit is further reduced\n\
14489 dependent on the target. Specify ``fixed'' to disable the\n\
14490 further restriction and ``limit'' to enable that restriction."),
14491 &remote_set_cmdlist
);
14492 add_cmd ("memory-write-packet-size", no_class
,
14493 show_memory_write_packet_size
,
14494 _("Show the maximum number of bytes per memory-write packet."),
14495 &remote_show_cmdlist
);
14496 add_cmd ("memory-read-packet-size", no_class
,
14497 show_memory_read_packet_size
,
14498 _("Show the maximum number of bytes per memory-read packet."),
14499 &remote_show_cmdlist
);
14501 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-limit", no_class
,
14502 &remote_hw_watchpoint_limit
, _("\
14503 Set the maximum number of target hardware watchpoints."), _("\
14504 Show the maximum number of target hardware watchpoints."), _("\
14505 Specify \"unlimited\" for unlimited hardware watchpoints."),
14506 NULL
, show_hardware_watchpoint_limit
,
14507 &remote_set_cmdlist
,
14508 &remote_show_cmdlist
);
14509 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-length-limit",
14511 &remote_hw_watchpoint_length_limit
, _("\
14512 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
14513 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
14514 Specify \"unlimited\" to allow watchpoints of unlimited size."),
14515 NULL
, show_hardware_watchpoint_length_limit
,
14516 &remote_set_cmdlist
, &remote_show_cmdlist
);
14517 add_setshow_zuinteger_unlimited_cmd ("hardware-breakpoint-limit", no_class
,
14518 &remote_hw_breakpoint_limit
, _("\
14519 Set the maximum number of target hardware breakpoints."), _("\
14520 Show the maximum number of target hardware breakpoints."), _("\
14521 Specify \"unlimited\" for unlimited hardware breakpoints."),
14522 NULL
, show_hardware_breakpoint_limit
,
14523 &remote_set_cmdlist
, &remote_show_cmdlist
);
14525 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure
,
14526 &remote_address_size
, _("\
14527 Set the maximum size of the address (in bits) in a memory packet."), _("\
14528 Show the maximum size of the address (in bits) in a memory packet."), NULL
,
14530 NULL
, /* FIXME: i18n: */
14531 &setlist
, &showlist
);
14533 init_all_packet_configs ();
14535 add_packet_config_cmd (&remote_protocol_packets
[PACKET_X
],
14536 "X", "binary-download", 1);
14538 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCont
],
14539 "vCont", "verbose-resume", 0);
14541 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QPassSignals
],
14542 "QPassSignals", "pass-signals", 0);
14544 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QCatchSyscalls
],
14545 "QCatchSyscalls", "catch-syscalls", 0);
14547 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QProgramSignals
],
14548 "QProgramSignals", "program-signals", 0);
14550 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QSetWorkingDir
],
14551 "QSetWorkingDir", "set-working-dir", 0);
14553 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartupWithShell
],
14554 "QStartupWithShell", "startup-with-shell", 0);
14556 add_packet_config_cmd (&remote_protocol_packets
14557 [PACKET_QEnvironmentHexEncoded
],
14558 "QEnvironmentHexEncoded", "environment-hex-encoded",
14561 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QEnvironmentReset
],
14562 "QEnvironmentReset", "environment-reset",
14565 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QEnvironmentUnset
],
14566 "QEnvironmentUnset", "environment-unset",
14569 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSymbol
],
14570 "qSymbol", "symbol-lookup", 0);
14572 add_packet_config_cmd (&remote_protocol_packets
[PACKET_P
],
14573 "P", "set-register", 1);
14575 add_packet_config_cmd (&remote_protocol_packets
[PACKET_p
],
14576 "p", "fetch-register", 1);
14578 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
],
14579 "Z0", "software-breakpoint", 0);
14581 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z1
],
14582 "Z1", "hardware-breakpoint", 0);
14584 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z2
],
14585 "Z2", "write-watchpoint", 0);
14587 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z3
],
14588 "Z3", "read-watchpoint", 0);
14590 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z4
],
14591 "Z4", "access-watchpoint", 0);
14593 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_auxv
],
14594 "qXfer:auxv:read", "read-aux-vector", 0);
14596 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_exec_file
],
14597 "qXfer:exec-file:read", "pid-to-exec-file", 0);
14599 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_features
],
14600 "qXfer:features:read", "target-features", 0);
14602 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries
],
14603 "qXfer:libraries:read", "library-info", 0);
14605 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries_svr4
],
14606 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
14608 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_memory_map
],
14609 "qXfer:memory-map:read", "memory-map", 0);
14611 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_osdata
],
14612 "qXfer:osdata:read", "osdata", 0);
14614 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_threads
],
14615 "qXfer:threads:read", "threads", 0);
14617 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_read
],
14618 "qXfer:siginfo:read", "read-siginfo-object", 0);
14620 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_write
],
14621 "qXfer:siginfo:write", "write-siginfo-object", 0);
14623 add_packet_config_cmd
14624 (&remote_protocol_packets
[PACKET_qXfer_traceframe_info
],
14625 "qXfer:traceframe-info:read", "traceframe-info", 0);
14627 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_uib
],
14628 "qXfer:uib:read", "unwind-info-block", 0);
14630 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTLSAddr
],
14631 "qGetTLSAddr", "get-thread-local-storage-address",
14634 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTIBAddr
],
14635 "qGetTIBAddr", "get-thread-information-block-address",
14638 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bc
],
14639 "bc", "reverse-continue", 0);
14641 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bs
],
14642 "bs", "reverse-step", 0);
14644 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSupported
],
14645 "qSupported", "supported-packets", 0);
14647 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSearch_memory
],
14648 "qSearch:memory", "search-memory", 0);
14650 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qTStatus
],
14651 "qTStatus", "trace-status", 0);
14653 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_setfs
],
14654 "vFile:setfs", "hostio-setfs", 0);
14656 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_open
],
14657 "vFile:open", "hostio-open", 0);
14659 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pread
],
14660 "vFile:pread", "hostio-pread", 0);
14662 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pwrite
],
14663 "vFile:pwrite", "hostio-pwrite", 0);
14665 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_close
],
14666 "vFile:close", "hostio-close", 0);
14668 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_unlink
],
14669 "vFile:unlink", "hostio-unlink", 0);
14671 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_readlink
],
14672 "vFile:readlink", "hostio-readlink", 0);
14674 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_fstat
],
14675 "vFile:fstat", "hostio-fstat", 0);
14677 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vAttach
],
14678 "vAttach", "attach", 0);
14680 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vRun
],
14683 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartNoAckMode
],
14684 "QStartNoAckMode", "noack", 0);
14686 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vKill
],
14687 "vKill", "kill", 0);
14689 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qAttached
],
14690 "qAttached", "query-attached", 0);
14692 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalTracepoints
],
14693 "ConditionalTracepoints",
14694 "conditional-tracepoints", 0);
14696 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalBreakpoints
],
14697 "ConditionalBreakpoints",
14698 "conditional-breakpoints", 0);
14700 add_packet_config_cmd (&remote_protocol_packets
[PACKET_BreakpointCommands
],
14701 "BreakpointCommands",
14702 "breakpoint-commands", 0);
14704 add_packet_config_cmd (&remote_protocol_packets
[PACKET_FastTracepoints
],
14705 "FastTracepoints", "fast-tracepoints", 0);
14707 add_packet_config_cmd (&remote_protocol_packets
[PACKET_TracepointSource
],
14708 "TracepointSource", "TracepointSource", 0);
14710 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAllow
],
14711 "QAllow", "allow", 0);
14713 add_packet_config_cmd (&remote_protocol_packets
[PACKET_StaticTracepoints
],
14714 "StaticTracepoints", "static-tracepoints", 0);
14716 add_packet_config_cmd (&remote_protocol_packets
[PACKET_InstallInTrace
],
14717 "InstallInTrace", "install-in-trace", 0);
14719 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_statictrace_read
],
14720 "qXfer:statictrace:read", "read-sdata-object", 0);
14722 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_fdpic
],
14723 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
14725 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QDisableRandomization
],
14726 "QDisableRandomization", "disable-randomization", 0);
14728 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAgent
],
14729 "QAgent", "agent", 0);
14731 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QTBuffer_size
],
14732 "QTBuffer:size", "trace-buffer-size", 0);
14734 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_off
],
14735 "Qbtrace:off", "disable-btrace", 0);
14737 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_bts
],
14738 "Qbtrace:bts", "enable-btrace-bts", 0);
14740 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_pt
],
14741 "Qbtrace:pt", "enable-btrace-pt", 0);
14743 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace
],
14744 "qXfer:btrace", "read-btrace", 0);
14746 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace_conf
],
14747 "qXfer:btrace-conf", "read-btrace-conf", 0);
14749 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_conf_bts_size
],
14750 "Qbtrace-conf:bts:size", "btrace-conf-bts-size", 0);
14752 add_packet_config_cmd (&remote_protocol_packets
[PACKET_multiprocess_feature
],
14753 "multiprocess-feature", "multiprocess-feature", 0);
14755 add_packet_config_cmd (&remote_protocol_packets
[PACKET_swbreak_feature
],
14756 "swbreak-feature", "swbreak-feature", 0);
14758 add_packet_config_cmd (&remote_protocol_packets
[PACKET_hwbreak_feature
],
14759 "hwbreak-feature", "hwbreak-feature", 0);
14761 add_packet_config_cmd (&remote_protocol_packets
[PACKET_fork_event_feature
],
14762 "fork-event-feature", "fork-event-feature", 0);
14764 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vfork_event_feature
],
14765 "vfork-event-feature", "vfork-event-feature", 0);
14767 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_conf_pt_size
],
14768 "Qbtrace-conf:pt:size", "btrace-conf-pt-size", 0);
14770 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vContSupported
],
14771 "vContSupported", "verbose-resume-supported", 0);
14773 add_packet_config_cmd (&remote_protocol_packets
[PACKET_exec_event_feature
],
14774 "exec-event-feature", "exec-event-feature", 0);
14776 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCtrlC
],
14777 "vCtrlC", "ctrl-c", 0);
14779 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QThreadEvents
],
14780 "QThreadEvents", "thread-events", 0);
14782 add_packet_config_cmd (&remote_protocol_packets
[PACKET_no_resumed
],
14783 "N stop reply", "no-resumed-stop-reply", 0);
14785 /* Assert that we've registered "set remote foo-packet" commands
14786 for all packet configs. */
14790 for (i
= 0; i
< PACKET_MAX
; i
++)
14792 /* Ideally all configs would have a command associated. Some
14793 still don't though. */
14798 case PACKET_QNonStop
:
14799 case PACKET_EnableDisableTracepoints_feature
:
14800 case PACKET_tracenz_feature
:
14801 case PACKET_DisconnectedTracing_feature
:
14802 case PACKET_augmented_libraries_svr4_read_feature
:
14804 /* Additions to this list need to be well justified:
14805 pre-existing packets are OK; new packets are not. */
14813 /* This catches both forgetting to add a config command, and
14814 forgetting to remove a packet from the exception list. */
14815 gdb_assert (excepted
== (remote_protocol_packets
[i
].name
== NULL
));
14819 /* Keep the old ``set remote Z-packet ...'' working. Each individual
14820 Z sub-packet has its own set and show commands, but users may
14821 have sets to this variable in their .gdbinit files (or in their
14823 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure
,
14824 &remote_Z_packet_detect
, _("\
14825 Set use of remote protocol `Z' packets."), _("\
14826 Show use of remote protocol `Z' packets."), _("\
14827 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
14829 set_remote_protocol_Z_packet_cmd
,
14830 show_remote_protocol_Z_packet_cmd
,
14831 /* FIXME: i18n: Use of remote protocol
14832 `Z' packets is %s. */
14833 &remote_set_cmdlist
, &remote_show_cmdlist
);
14835 add_basic_prefix_cmd ("remote", class_files
, _("\
14836 Manipulate files on the remote system.\n\
14837 Transfer files to and from the remote target system."),
14838 &remote_cmdlist
, "remote ",
14839 0 /* allow-unknown */, &cmdlist
);
14841 add_cmd ("put", class_files
, remote_put_command
,
14842 _("Copy a local file to the remote system."),
14845 add_cmd ("get", class_files
, remote_get_command
,
14846 _("Copy a remote file to the local system."),
14849 add_cmd ("delete", class_files
, remote_delete_command
,
14850 _("Delete a remote file."),
14853 add_setshow_string_noescape_cmd ("exec-file", class_files
,
14854 &remote_exec_file_var
, _("\
14855 Set the remote pathname for \"run\"."), _("\
14856 Show the remote pathname for \"run\"."), NULL
,
14857 set_remote_exec_file
,
14858 show_remote_exec_file
,
14859 &remote_set_cmdlist
,
14860 &remote_show_cmdlist
);
14862 add_setshow_boolean_cmd ("range-stepping", class_run
,
14863 &use_range_stepping
, _("\
14864 Enable or disable range stepping."), _("\
14865 Show whether target-assisted range stepping is enabled."), _("\
14866 If on, and the target supports it, when stepping a source line, GDB\n\
14867 tells the target to step the corresponding range of addresses itself instead\n\
14868 of issuing multiple single-steps. This speeds up source level\n\
14869 stepping. If off, GDB always issues single-steps, even if range\n\
14870 stepping is supported by the target. The default is on."),
14871 set_range_stepping
,
14872 show_range_stepping
,
14876 add_setshow_zinteger_cmd ("watchdog", class_maintenance
, &watchdog
, _("\
14877 Set watchdog timer."), _("\
14878 Show watchdog timer."), _("\
14879 When non-zero, this timeout is used instead of waiting forever for a target\n\
14880 to finish a low-level step or continue operation. If the specified amount\n\
14881 of time passes without a response from the target, an error occurs."),
14884 &setlist
, &showlist
);
14886 add_setshow_zuinteger_unlimited_cmd ("remote-packet-max-chars", no_class
,
14887 &remote_packet_max_chars
, _("\
14888 Set the maximum number of characters to display for each remote packet."), _("\
14889 Show the maximum number of characters to display for each remote packet."), _("\
14890 Specify \"unlimited\" to display all the characters."),
14891 NULL
, show_remote_packet_max_chars
,
14892 &setdebuglist
, &showdebuglist
);
14894 /* Eventually initialize fileio. See fileio.c */
14895 initialize_remote_fileio (&remote_set_cmdlist
, &remote_show_cmdlist
);