1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2017 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 "terminal.h" */
33 #include "gdb-stabs.h"
34 #include "gdbthread.h"
36 #include "remote-notif.h"
41 #include "cli/cli-decode.h"
42 #include "cli/cli-setshow.h"
43 #include "target-descriptions.h"
45 #include "filestuff.h"
50 #include "gdb_sys_time.h"
52 #include "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"
73 #include "record-btrace.h"
75 #include "common/scoped_restore.h"
77 #include "common/byte-vector.h"
79 /* Per-program-space data key. */
80 static const struct program_space_data *remote_pspace_data;
82 /* The variable registered as the control variable used by the
83 remote exec-file commands. While the remote exec-file setting is
84 per-program-space, the set/show machinery uses this as the
85 location of the remote exec-file value. */
86 static char *remote_exec_file_var;
88 /* The size to align memory write packets, when practical. The protocol
89 does not guarantee any alignment, and gdb will generate short
90 writes and unaligned writes, but even as a best-effort attempt this
91 can improve bulk transfers. For instance, if a write is misaligned
92 relative to the target's data bus, the stub may need to make an extra
93 round trip fetching data from the target. This doesn't make a
94 huge difference, but it's easy to do, so we try to be helpful.
96 The alignment chosen is arbitrary; usually data bus width is
97 important here, not the possibly larger cache line size. */
98 enum { REMOTE_ALIGN_WRITES = 16 };
100 /* Prototypes for local functions. */
101 static int getpkt_sane (char **buf, long *sizeof_buf, int forever);
102 static int getpkt_or_notif_sane (char **buf, long *sizeof_buf,
103 int forever, int *is_notif);
105 static void remote_files_info (struct target_ops *ignore);
107 static void remote_prepare_to_store (struct target_ops *self,
108 struct regcache *regcache);
110 static void remote_open_1 (const char *, int, struct target_ops *,
113 static void remote_close (struct target_ops *self);
117 static int remote_vkill (int pid, struct remote_state *rs);
119 static void remote_kill_k (void);
121 static void remote_mourn (struct target_ops *ops);
123 static void extended_remote_restart (void);
125 static void remote_send (char **buf, long *sizeof_buf_p);
127 static int readchar (int timeout);
129 static void remote_serial_write (const char *str, int len);
131 static void remote_kill (struct target_ops *ops);
133 static int remote_can_async_p (struct target_ops *);
135 static int remote_is_async_p (struct target_ops *);
137 static void remote_async (struct target_ops *ops, int enable);
139 static void remote_thread_events (struct target_ops *ops, int enable);
141 static void interrupt_query (void);
143 static void set_general_thread (ptid_t ptid);
144 static void set_continue_thread (ptid_t ptid);
146 static void get_offsets (void);
148 static void skip_frame (void);
150 static long read_frame (char **buf_p, long *sizeof_buf);
152 static int hexnumlen (ULONGEST num);
154 static void init_remote_ops (void);
156 static void init_extended_remote_ops (void);
158 static void remote_stop (struct target_ops *self, ptid_t);
160 static int stubhex (int ch);
162 static int hexnumstr (char *, ULONGEST);
164 static int hexnumnstr (char *, ULONGEST, int);
166 static CORE_ADDR remote_address_masked (CORE_ADDR);
168 static void print_packet (const char *);
170 static int stub_unpack_int (char *buff, int fieldlength);
172 static ptid_t remote_current_thread (ptid_t oldptid);
174 static int putpkt_binary (const char *buf, int cnt);
176 static void check_binary_download (CORE_ADDR addr);
178 struct packet_config;
180 static void show_packet_config_cmd (struct packet_config *config);
182 static void show_remote_protocol_packet_cmd (struct ui_file *file,
184 struct cmd_list_element *c,
187 static char *write_ptid (char *buf, const char *endbuf, ptid_t ptid);
188 static ptid_t read_ptid (const char *buf, const char **obuf);
190 static void remote_set_permissions (struct target_ops *self);
192 static int remote_get_trace_status (struct target_ops *self,
193 struct trace_status *ts);
195 static int remote_upload_tracepoints (struct target_ops *self,
196 struct uploaded_tp **utpp);
198 static int remote_upload_trace_state_variables (struct target_ops *self,
199 struct uploaded_tsv **utsvp);
201 static void remote_query_supported (void);
203 static void remote_check_symbols (void);
206 static void stop_reply_xfree (struct stop_reply *);
207 static void remote_parse_stop_reply (char *, struct stop_reply *);
208 static void push_stop_reply (struct stop_reply *);
209 static void discard_pending_stop_replies_in_queue (struct remote_state *);
210 static int peek_stop_reply (ptid_t ptid);
212 struct threads_listing_context;
213 static void remove_new_fork_children (struct threads_listing_context *);
215 static void remote_async_inferior_event_handler (gdb_client_data);
217 static void remote_terminal_ours (struct target_ops *self);
219 static int remote_read_description_p (struct target_ops *target);
221 static void remote_console_output (char *msg);
223 static int remote_supports_cond_breakpoints (struct target_ops *self);
225 static int remote_can_run_breakpoint_commands (struct target_ops *self);
227 static void remote_btrace_reset (void);
229 static void remote_btrace_maybe_reopen (void);
231 static int stop_reply_queue_length (void);
233 static void readahead_cache_invalidate (void);
235 static void remote_unpush_and_throw (void);
237 static struct remote_state *get_remote_state (void);
241 static struct cmd_list_element *remote_cmdlist;
243 /* For "set remote" and "show remote". */
245 static struct cmd_list_element *remote_set_cmdlist;
246 static struct cmd_list_element *remote_show_cmdlist;
248 /* Stub vCont actions support.
250 Each field is a boolean flag indicating whether the stub reports
251 support for the corresponding action. */
253 struct vCont_action_support
268 /* Controls whether GDB is willing to use range stepping. */
270 static int use_range_stepping = 1;
272 #define OPAQUETHREADBYTES 8
274 /* a 64 bit opaque identifier */
275 typedef unsigned char threadref[OPAQUETHREADBYTES];
277 /* About this many threadisds fit in a packet. */
279 #define MAXTHREADLISTRESULTS 32
281 /* The max number of chars in debug output. The rest of chars are
284 #define REMOTE_DEBUG_MAX_CHAR 512
286 /* Data for the vFile:pread readahead cache. */
288 struct readahead_cache
290 /* The file descriptor for the file that is being cached. -1 if the
294 /* The offset into the file that the cache buffer corresponds
298 /* The buffer holding the cache contents. */
300 /* The buffer's size. We try to read as much as fits into a packet
304 /* Cache hit and miss counters. */
309 /* Description of the remote protocol state for the currently
310 connected target. This is per-target state, and independent of the
311 selected architecture. */
315 /* A buffer to use for incoming packets, and its current size. The
316 buffer is grown dynamically for larger incoming packets.
317 Outgoing packets may also be constructed in this buffer.
318 BUF_SIZE is always at least REMOTE_PACKET_SIZE;
319 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
324 /* True if we're going through initial connection setup (finding out
325 about the remote side's threads, relocating symbols, etc.). */
328 /* If we negotiated packet size explicitly (and thus can bypass
329 heuristics for the largest packet size that will not overflow
330 a buffer in the stub), this will be set to that packet size.
331 Otherwise zero, meaning to use the guessed size. */
332 long explicit_packet_size;
334 /* remote_wait is normally called when the target is running and
335 waits for a stop reply packet. But sometimes we need to call it
336 when the target is already stopped. We can send a "?" packet
337 and have remote_wait read the response. Or, if we already have
338 the response, we can stash it in BUF and tell remote_wait to
339 skip calling getpkt. This flag is set when BUF contains a
340 stop reply packet and the target is not waiting. */
341 int cached_wait_status;
343 /* True, if in no ack mode. That is, neither GDB nor the stub will
344 expect acks from each other. The connection is assumed to be
348 /* True if we're connected in extended remote mode. */
351 /* True if we resumed the target and we're waiting for the target to
352 stop. In the mean time, we can't start another command/query.
353 The remote server wouldn't be ready to process it, so we'd
354 timeout waiting for a reply that would never come and eventually
355 we'd close the connection. This can happen in asynchronous mode
356 because we allow GDB commands while the target is running. */
357 int waiting_for_stop_reply;
359 /* The status of the stub support for the various vCont actions. */
360 struct vCont_action_support supports_vCont;
362 /* Nonzero if the user has pressed Ctrl-C, but the target hasn't
363 responded to that. */
366 /* True if we saw a Ctrl-C while reading or writing from/to the
367 remote descriptor. At that point it is not safe to send a remote
368 interrupt packet, so we instead remember we saw the Ctrl-C and
369 process it once we're done with sending/receiving the current
370 packet, which should be shortly. If however that takes too long,
371 and the user presses Ctrl-C again, we offer to disconnect. */
372 int got_ctrlc_during_io;
374 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
375 remote_open knows that we don't have a file open when the program
377 struct serial *remote_desc;
379 /* These are the threads which we last sent to the remote system. The
380 TID member will be -1 for all or -2 for not sent yet. */
381 ptid_t general_thread;
382 ptid_t continue_thread;
384 /* This is the traceframe which we last selected on the remote system.
385 It will be -1 if no traceframe is selected. */
386 int remote_traceframe_number;
388 char *last_pass_packet;
390 /* The last QProgramSignals packet sent to the target. We bypass
391 sending a new program signals list down to the target if the new
392 packet is exactly the same as the last we sent. IOW, we only let
393 the target know about program signals list changes. */
394 char *last_program_signals_packet;
396 enum gdb_signal last_sent_signal;
400 /* The execution direction of the last resume we got. */
401 enum exec_direction_kind last_resume_exec_dir;
403 char *finished_object;
404 char *finished_annex;
405 ULONGEST finished_offset;
407 /* Should we try the 'ThreadInfo' query packet?
409 This variable (NOT available to the user: auto-detect only!)
410 determines whether GDB will use the new, simpler "ThreadInfo"
411 query or the older, more complex syntax for thread queries.
412 This is an auto-detect variable (set to true at each connect,
413 and set to false when the target fails to recognize it). */
414 int use_threadinfo_query;
415 int use_threadextra_query;
417 threadref echo_nextthread;
418 threadref nextthread;
419 threadref resultthreadlist[MAXTHREADLISTRESULTS];
421 /* The state of remote notification. */
422 struct remote_notif_state *notif_state;
424 /* The branch trace configuration. */
425 struct btrace_config btrace_config;
427 /* The argument to the last "vFile:setfs:" packet we sent, used
428 to avoid sending repeated unnecessary "vFile:setfs:" packets.
429 Initialized to -1 to indicate that no "vFile:setfs:" packet
430 has yet been sent. */
433 /* A readahead cache for vFile:pread. Often, reading a binary
434 involves a sequence of small reads. E.g., when parsing an ELF
435 file. A readahead cache helps mostly the case of remote
436 debugging on a connection with higher latency, due to the
437 request/reply nature of the RSP. We only cache data for a single
438 file descriptor at a time. */
439 struct readahead_cache readahead_cache;
442 /* Private data that we'll store in (struct thread_info)->priv. */
443 struct remote_thread_info : public private_thread_info
449 /* Thread handle, perhaps a pthread_t or thread_t value, stored as a
450 sequence of bytes. */
451 gdb::byte_vector thread_handle;
453 /* Whether the target stopped for a breakpoint/watchpoint. */
454 enum target_stop_reason stop_reason = TARGET_STOPPED_BY_NO_REASON;
456 /* This is set to the data address of the access causing the target
457 to stop for a watchpoint. */
458 CORE_ADDR watch_data_address = 0;
460 /* Fields used by the vCont action coalescing implemented in
461 remote_resume / remote_commit_resume. remote_resume stores each
462 thread's last resume request in these fields, so that a later
463 remote_commit_resume knows which is the proper action for this
464 thread to include in the vCont packet. */
466 /* True if the last target_resume call for this thread was a step
467 request, false if a continue request. */
468 int last_resume_step = 0;
470 /* The signal specified in the last target_resume call for this
472 gdb_signal last_resume_sig = GDB_SIGNAL_0;
474 /* Whether this thread was already vCont-resumed on the remote
476 int vcont_resumed = 0;
479 /* This data could be associated with a target, but we do not always
480 have access to the current target when we need it, so for now it is
481 static. This will be fine for as long as only one target is in use
483 static struct remote_state *remote_state;
485 static struct remote_state *
486 get_remote_state_raw (void)
491 /* Allocate a new struct remote_state with xmalloc, initialize it, and
494 static struct remote_state *
495 new_remote_state (void)
497 struct remote_state *result = XCNEW (struct remote_state);
499 /* The default buffer size is unimportant; it will be expanded
500 whenever a larger buffer is needed. */
501 result->buf_size = 400;
502 result->buf = (char *) xmalloc (result->buf_size);
503 result->remote_traceframe_number = -1;
504 result->last_sent_signal = GDB_SIGNAL_0;
505 result->last_resume_exec_dir = EXEC_FORWARD;
511 /* Description of the remote protocol for a given architecture. */
515 long offset; /* Offset into G packet. */
516 long regnum; /* GDB's internal register number. */
517 LONGEST pnum; /* Remote protocol register number. */
518 int in_g_packet; /* Always part of G packet. */
519 /* long size in bytes; == register_size (target_gdbarch (), regnum);
521 /* char *name; == gdbarch_register_name (target_gdbarch (), regnum);
525 struct remote_arch_state
527 /* Description of the remote protocol registers. */
528 long sizeof_g_packet;
530 /* Description of the remote protocol registers indexed by REGNUM
531 (making an array gdbarch_num_regs in size). */
532 struct packet_reg *regs;
534 /* This is the size (in chars) of the first response to the ``g''
535 packet. It is used as a heuristic when determining the maximum
536 size of memory-read and memory-write packets. A target will
537 typically only reserve a buffer large enough to hold the ``g''
538 packet. The size does not include packet overhead (headers and
540 long actual_register_packet_size;
542 /* This is the maximum size (in chars) of a non read/write packet.
543 It is also used as a cap on the size of read/write packets. */
544 long remote_packet_size;
547 /* Utility: generate error from an incoming stub packet. */
549 trace_error (char *buf)
552 return; /* not an error msg */
555 case '1': /* malformed packet error */
556 if (*++buf == '0') /* general case: */
557 error (_("remote.c: error in outgoing packet."));
559 error (_("remote.c: error in outgoing packet at field #%ld."),
560 strtol (buf, NULL, 16));
562 error (_("Target returns error code '%s'."), buf);
566 /* Utility: wait for reply from stub, while accepting "O" packets. */
569 remote_get_noisy_reply ()
571 struct remote_state *rs = get_remote_state ();
573 do /* Loop on reply from remote stub. */
577 QUIT; /* Allow user to bail out with ^C. */
578 getpkt (&rs->buf, &rs->buf_size, 0);
582 else if (startswith (buf, "qRelocInsn:"))
585 CORE_ADDR from, to, org_to;
587 int adjusted_size = 0;
590 p = buf + strlen ("qRelocInsn:");
591 pp = unpack_varlen_hex (p, &ul);
593 error (_("invalid qRelocInsn packet: %s"), buf);
597 unpack_varlen_hex (p, &ul);
604 gdbarch_relocate_instruction (target_gdbarch (), &to, from);
607 CATCH (ex, RETURN_MASK_ALL)
609 if (ex.error == MEMORY_ERROR)
611 /* Propagate memory errors silently back to the
612 target. The stub may have limited the range of
613 addresses we can write to, for example. */
617 /* Something unexpectedly bad happened. Be verbose
618 so we can tell what, and propagate the error back
619 to the stub, so it doesn't get stuck waiting for
621 exception_fprintf (gdb_stderr, ex,
622 _("warning: relocating instruction: "));
630 adjusted_size = to - org_to;
632 xsnprintf (buf, rs->buf_size, "qRelocInsn:%x", adjusted_size);
636 else if (buf[0] == 'O' && buf[1] != 'K')
637 remote_console_output (buf + 1); /* 'O' message from stub */
639 return buf; /* Here's the actual reply. */
644 /* Handle for retreving the remote protocol data from gdbarch. */
645 static struct gdbarch_data *remote_gdbarch_data_handle;
647 static struct remote_arch_state *
648 get_remote_arch_state (struct gdbarch *gdbarch)
650 gdb_assert (gdbarch != NULL);
651 return ((struct remote_arch_state *)
652 gdbarch_data (gdbarch, remote_gdbarch_data_handle));
655 /* Fetch the global remote target state. */
657 static struct remote_state *
658 get_remote_state (void)
660 /* Make sure that the remote architecture state has been
661 initialized, because doing so might reallocate rs->buf. Any
662 function which calls getpkt also needs to be mindful of changes
663 to rs->buf, but this call limits the number of places which run
665 get_remote_arch_state (target_gdbarch ());
667 return get_remote_state_raw ();
670 /* Cleanup routine for the remote module's pspace data. */
673 remote_pspace_data_cleanup (struct program_space *pspace, void *arg)
675 char *remote_exec_file = (char *) arg;
677 xfree (remote_exec_file);
680 /* Fetch the remote exec-file from the current program space. */
683 get_remote_exec_file (void)
685 char *remote_exec_file;
688 = (char *) program_space_data (current_program_space,
690 if (remote_exec_file == NULL)
693 return remote_exec_file;
696 /* Set the remote exec file for PSPACE. */
699 set_pspace_remote_exec_file (struct program_space *pspace,
700 char *remote_exec_file)
702 char *old_file = (char *) program_space_data (pspace, remote_pspace_data);
705 set_program_space_data (pspace, remote_pspace_data,
706 xstrdup (remote_exec_file));
709 /* The "set/show remote exec-file" set command hook. */
712 set_remote_exec_file (const char *ignored, int from_tty,
713 struct cmd_list_element *c)
715 gdb_assert (remote_exec_file_var != NULL);
716 set_pspace_remote_exec_file (current_program_space, remote_exec_file_var);
719 /* The "set/show remote exec-file" show command hook. */
722 show_remote_exec_file (struct ui_file *file, int from_tty,
723 struct cmd_list_element *cmd, const char *value)
725 fprintf_filtered (file, "%s\n", remote_exec_file_var);
729 compare_pnums (const void *lhs_, const void *rhs_)
731 const struct packet_reg * const *lhs
732 = (const struct packet_reg * const *) lhs_;
733 const struct packet_reg * const *rhs
734 = (const struct packet_reg * const *) rhs_;
736 if ((*lhs)->pnum < (*rhs)->pnum)
738 else if ((*lhs)->pnum == (*rhs)->pnum)
745 map_regcache_remote_table (struct gdbarch *gdbarch, struct packet_reg *regs)
747 int regnum, num_remote_regs, offset;
748 struct packet_reg **remote_regs;
750 for (regnum = 0; regnum < gdbarch_num_regs (gdbarch); regnum++)
752 struct packet_reg *r = ®s[regnum];
754 if (register_size (gdbarch, regnum) == 0)
755 /* Do not try to fetch zero-sized (placeholder) registers. */
758 r->pnum = gdbarch_remote_register_number (gdbarch, regnum);
763 /* Define the g/G packet format as the contents of each register
764 with a remote protocol number, in order of ascending protocol
767 remote_regs = XALLOCAVEC (struct packet_reg *, gdbarch_num_regs (gdbarch));
768 for (num_remote_regs = 0, regnum = 0;
769 regnum < gdbarch_num_regs (gdbarch);
771 if (regs[regnum].pnum != -1)
772 remote_regs[num_remote_regs++] = ®s[regnum];
774 qsort (remote_regs, num_remote_regs, sizeof (struct packet_reg *),
777 for (regnum = 0, offset = 0; regnum < num_remote_regs; regnum++)
779 remote_regs[regnum]->in_g_packet = 1;
780 remote_regs[regnum]->offset = offset;
781 offset += register_size (gdbarch, remote_regs[regnum]->regnum);
787 /* Given the architecture described by GDBARCH, return the remote
788 protocol register's number and the register's offset in the g/G
789 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
790 If the target does not have a mapping for REGNUM, return false,
791 otherwise, return true. */
794 remote_register_number_and_offset (struct gdbarch *gdbarch, int regnum,
795 int *pnum, int *poffset)
797 gdb_assert (regnum < gdbarch_num_regs (gdbarch));
799 std::vector<packet_reg> regs (gdbarch_num_regs (gdbarch));
801 map_regcache_remote_table (gdbarch, regs.data ());
803 *pnum = regs[regnum].pnum;
804 *poffset = regs[regnum].offset;
810 init_remote_state (struct gdbarch *gdbarch)
812 struct remote_state *rs = get_remote_state_raw ();
813 struct remote_arch_state *rsa;
815 rsa = GDBARCH_OBSTACK_ZALLOC (gdbarch, struct remote_arch_state);
817 /* Use the architecture to build a regnum<->pnum table, which will be
818 1:1 unless a feature set specifies otherwise. */
819 rsa->regs = GDBARCH_OBSTACK_CALLOC (gdbarch,
820 gdbarch_num_regs (gdbarch),
823 /* Record the maximum possible size of the g packet - it may turn out
825 rsa->sizeof_g_packet = map_regcache_remote_table (gdbarch, rsa->regs);
827 /* Default maximum number of characters in a packet body. Many
828 remote stubs have a hardwired buffer size of 400 bytes
829 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
830 as the maximum packet-size to ensure that the packet and an extra
831 NUL character can always fit in the buffer. This stops GDB
832 trashing stubs that try to squeeze an extra NUL into what is
833 already a full buffer (As of 1999-12-04 that was most stubs). */
834 rsa->remote_packet_size = 400 - 1;
836 /* This one is filled in when a ``g'' packet is received. */
837 rsa->actual_register_packet_size = 0;
839 /* Should rsa->sizeof_g_packet needs more space than the
840 default, adjust the size accordingly. Remember that each byte is
841 encoded as two characters. 32 is the overhead for the packet
842 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
843 (``$NN:G...#NN'') is a better guess, the below has been padded a
845 if (rsa->sizeof_g_packet > ((rsa->remote_packet_size - 32) / 2))
846 rsa->remote_packet_size = (rsa->sizeof_g_packet * 2 + 32);
848 /* Make sure that the packet buffer is plenty big enough for
849 this architecture. */
850 if (rs->buf_size < rsa->remote_packet_size)
852 rs->buf_size = 2 * rsa->remote_packet_size;
853 rs->buf = (char *) xrealloc (rs->buf, rs->buf_size);
859 /* Return the current allowed size of a remote packet. This is
860 inferred from the current architecture, and should be used to
861 limit the length of outgoing packets. */
863 get_remote_packet_size (void)
865 struct remote_state *rs = get_remote_state ();
866 remote_arch_state *rsa = get_remote_arch_state (target_gdbarch ());
868 if (rs->explicit_packet_size)
869 return rs->explicit_packet_size;
871 return rsa->remote_packet_size;
874 static struct packet_reg *
875 packet_reg_from_regnum (struct gdbarch *gdbarch, struct remote_arch_state *rsa,
878 if (regnum < 0 && regnum >= gdbarch_num_regs (gdbarch))
882 struct packet_reg *r = &rsa->regs[regnum];
884 gdb_assert (r->regnum == regnum);
889 static struct packet_reg *
890 packet_reg_from_pnum (struct gdbarch *gdbarch, struct remote_arch_state *rsa,
895 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
897 struct packet_reg *r = &rsa->regs[i];
905 static struct target_ops remote_ops;
907 static struct target_ops extended_remote_ops;
909 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
910 ``forever'' still use the normal timeout mechanism. This is
911 currently used by the ASYNC code to guarentee that target reads
912 during the initial connect always time-out. Once getpkt has been
913 modified to return a timeout indication and, in turn
914 remote_wait()/wait_for_inferior() have gained a timeout parameter
916 static int wait_forever_enabled_p = 1;
918 /* Allow the user to specify what sequence to send to the remote
919 when he requests a program interruption: Although ^C is usually
920 what remote systems expect (this is the default, here), it is
921 sometimes preferable to send a break. On other systems such
922 as the Linux kernel, a break followed by g, which is Magic SysRq g
923 is required in order to interrupt the execution. */
924 const char interrupt_sequence_control_c[] = "Ctrl-C";
925 const char interrupt_sequence_break[] = "BREAK";
926 const char interrupt_sequence_break_g[] = "BREAK-g";
927 static const char *const interrupt_sequence_modes[] =
929 interrupt_sequence_control_c,
930 interrupt_sequence_break,
931 interrupt_sequence_break_g,
934 static const char *interrupt_sequence_mode = interrupt_sequence_control_c;
937 show_interrupt_sequence (struct ui_file *file, int from_tty,
938 struct cmd_list_element *c,
941 if (interrupt_sequence_mode == interrupt_sequence_control_c)
942 fprintf_filtered (file,
943 _("Send the ASCII ETX character (Ctrl-c) "
944 "to the remote target to interrupt the "
945 "execution of the program.\n"));
946 else if (interrupt_sequence_mode == interrupt_sequence_break)
947 fprintf_filtered (file,
948 _("send a break signal to the remote target "
949 "to interrupt the execution of the program.\n"));
950 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
951 fprintf_filtered (file,
952 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
953 "the remote target to interrupt the execution "
954 "of Linux kernel.\n"));
956 internal_error (__FILE__, __LINE__,
957 _("Invalid value for interrupt_sequence_mode: %s."),
958 interrupt_sequence_mode);
961 /* This boolean variable specifies whether interrupt_sequence is sent
962 to the remote target when gdb connects to it.
963 This is mostly needed when you debug the Linux kernel: The Linux kernel
964 expects BREAK g which is Magic SysRq g for connecting gdb. */
965 static int interrupt_on_connect = 0;
967 /* This variable is used to implement the "set/show remotebreak" commands.
968 Since these commands are now deprecated in favor of "set/show remote
969 interrupt-sequence", it no longer has any effect on the code. */
970 static int remote_break;
973 set_remotebreak (const char *args, int from_tty, struct cmd_list_element *c)
976 interrupt_sequence_mode = interrupt_sequence_break;
978 interrupt_sequence_mode = interrupt_sequence_control_c;
982 show_remotebreak (struct ui_file *file, int from_tty,
983 struct cmd_list_element *c,
988 /* This variable sets the number of bits in an address that are to be
989 sent in a memory ("M" or "m") packet. Normally, after stripping
990 leading zeros, the entire address would be sent. This variable
991 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
992 initial implementation of remote.c restricted the address sent in
993 memory packets to ``host::sizeof long'' bytes - (typically 32
994 bits). Consequently, for 64 bit targets, the upper 32 bits of an
995 address was never sent. Since fixing this bug may cause a break in
996 some remote targets this variable is principly provided to
997 facilitate backward compatibility. */
999 static unsigned int remote_address_size;
1002 /* User configurable variables for the number of characters in a
1003 memory read/write packet. MIN (rsa->remote_packet_size,
1004 rsa->sizeof_g_packet) is the default. Some targets need smaller
1005 values (fifo overruns, et.al.) and some users need larger values
1006 (speed up transfers). The variables ``preferred_*'' (the user
1007 request), ``current_*'' (what was actually set) and ``forced_*''
1008 (Positive - a soft limit, negative - a hard limit). */
1010 struct memory_packet_config
1017 /* The default max memory-write-packet-size. The 16k is historical.
1018 (It came from older GDB's using alloca for buffers and the
1019 knowledge (folklore?) that some hosts don't cope very well with
1020 large alloca calls.) */
1021 #define DEFAULT_MAX_MEMORY_PACKET_SIZE 16384
1023 /* The minimum remote packet size for memory transfers. Ensures we
1024 can write at least one byte. */
1025 #define MIN_MEMORY_PACKET_SIZE 20
1027 /* Compute the current size of a read/write packet. Since this makes
1028 use of ``actual_register_packet_size'' the computation is dynamic. */
1031 get_memory_packet_size (struct memory_packet_config *config)
1033 struct remote_state *rs = get_remote_state ();
1034 remote_arch_state *rsa = get_remote_arch_state (target_gdbarch ());
1037 if (config->fixed_p)
1039 if (config->size <= 0)
1040 what_they_get = DEFAULT_MAX_MEMORY_PACKET_SIZE;
1042 what_they_get = config->size;
1046 what_they_get = get_remote_packet_size ();
1047 /* Limit the packet to the size specified by the user. */
1048 if (config->size > 0
1049 && what_they_get > config->size)
1050 what_they_get = config->size;
1052 /* Limit it to the size of the targets ``g'' response unless we have
1053 permission from the stub to use a larger packet size. */
1054 if (rs->explicit_packet_size == 0
1055 && rsa->actual_register_packet_size > 0
1056 && what_they_get > rsa->actual_register_packet_size)
1057 what_they_get = rsa->actual_register_packet_size;
1059 if (what_they_get < MIN_MEMORY_PACKET_SIZE)
1060 what_they_get = MIN_MEMORY_PACKET_SIZE;
1062 /* Make sure there is room in the global buffer for this packet
1063 (including its trailing NUL byte). */
1064 if (rs->buf_size < what_they_get + 1)
1066 rs->buf_size = 2 * what_they_get;
1067 rs->buf = (char *) xrealloc (rs->buf, 2 * what_they_get);
1070 return what_they_get;
1073 /* Update the size of a read/write packet. If they user wants
1074 something really big then do a sanity check. */
1077 set_memory_packet_size (const char *args, struct memory_packet_config *config)
1079 int fixed_p = config->fixed_p;
1080 long size = config->size;
1083 error (_("Argument required (integer, `fixed' or `limited')."));
1084 else if (strcmp (args, "hard") == 0
1085 || strcmp (args, "fixed") == 0)
1087 else if (strcmp (args, "soft") == 0
1088 || strcmp (args, "limit") == 0)
1094 size = strtoul (args, &end, 0);
1096 error (_("Invalid %s (bad syntax)."), config->name);
1098 /* Instead of explicitly capping the size of a packet to or
1099 disallowing it, the user is allowed to set the size to
1100 something arbitrarily large. */
1103 /* So that the query shows the correct value. */
1105 size = DEFAULT_MAX_MEMORY_PACKET_SIZE;
1108 if (fixed_p && !config->fixed_p)
1110 if (! query (_("The target may not be able to correctly handle a %s\n"
1111 "of %ld bytes. Change the packet size? "),
1112 config->name, size))
1113 error (_("Packet size not changed."));
1115 /* Update the config. */
1116 config->fixed_p = fixed_p;
1117 config->size = size;
1121 show_memory_packet_size (struct memory_packet_config *config)
1123 printf_filtered (_("The %s is %ld. "), config->name, config->size);
1124 if (config->fixed_p)
1125 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
1126 get_memory_packet_size (config));
1128 printf_filtered (_("Packets are limited to %ld bytes.\n"),
1129 get_memory_packet_size (config));
1132 static struct memory_packet_config memory_write_packet_config =
1134 "memory-write-packet-size",
1138 set_memory_write_packet_size (const char *args, int from_tty)
1140 set_memory_packet_size (args, &memory_write_packet_config);
1144 show_memory_write_packet_size (const char *args, int from_tty)
1146 show_memory_packet_size (&memory_write_packet_config);
1150 get_memory_write_packet_size (void)
1152 return get_memory_packet_size (&memory_write_packet_config);
1155 static struct memory_packet_config memory_read_packet_config =
1157 "memory-read-packet-size",
1161 set_memory_read_packet_size (const char *args, int from_tty)
1163 set_memory_packet_size (args, &memory_read_packet_config);
1167 show_memory_read_packet_size (const char *args, int from_tty)
1169 show_memory_packet_size (&memory_read_packet_config);
1173 get_memory_read_packet_size (void)
1175 long size = get_memory_packet_size (&memory_read_packet_config);
1177 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1178 extra buffer size argument before the memory read size can be
1179 increased beyond this. */
1180 if (size > get_remote_packet_size ())
1181 size = get_remote_packet_size ();
1186 /* Generic configuration support for packets the stub optionally
1187 supports. Allows the user to specify the use of the packet as well
1188 as allowing GDB to auto-detect support in the remote stub. */
1192 PACKET_SUPPORT_UNKNOWN = 0,
1197 struct packet_config
1202 /* If auto, GDB auto-detects support for this packet or feature,
1203 either through qSupported, or by trying the packet and looking
1204 at the response. If true, GDB assumes the target supports this
1205 packet. If false, the packet is disabled. Configs that don't
1206 have an associated command always have this set to auto. */
1207 enum auto_boolean detect;
1209 /* Does the target support this packet? */
1210 enum packet_support support;
1213 /* Analyze a packet's return value and update the packet config
1223 static enum packet_support packet_config_support (struct packet_config *config);
1224 static enum packet_support packet_support (int packet);
1227 show_packet_config_cmd (struct packet_config *config)
1229 const char *support = "internal-error";
1231 switch (packet_config_support (config))
1234 support = "enabled";
1236 case PACKET_DISABLE:
1237 support = "disabled";
1239 case PACKET_SUPPORT_UNKNOWN:
1240 support = "unknown";
1243 switch (config->detect)
1245 case AUTO_BOOLEAN_AUTO:
1246 printf_filtered (_("Support for the `%s' packet "
1247 "is auto-detected, currently %s.\n"),
1248 config->name, support);
1250 case AUTO_BOOLEAN_TRUE:
1251 case AUTO_BOOLEAN_FALSE:
1252 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1253 config->name, support);
1259 add_packet_config_cmd (struct packet_config *config, const char *name,
1260 const char *title, int legacy)
1266 config->name = name;
1267 config->title = title;
1268 set_doc = xstrprintf ("Set use of remote protocol `%s' (%s) packet",
1270 show_doc = xstrprintf ("Show current use of remote "
1271 "protocol `%s' (%s) packet",
1273 /* set/show TITLE-packet {auto,on,off} */
1274 cmd_name = xstrprintf ("%s-packet", title);
1275 add_setshow_auto_boolean_cmd (cmd_name, class_obscure,
1276 &config->detect, set_doc,
1277 show_doc, NULL, /* help_doc */
1279 show_remote_protocol_packet_cmd,
1280 &remote_set_cmdlist, &remote_show_cmdlist);
1281 /* The command code copies the documentation strings. */
1284 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1289 legacy_name = xstrprintf ("%s-packet", name);
1290 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1291 &remote_set_cmdlist);
1292 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1293 &remote_show_cmdlist);
1297 static enum packet_result
1298 packet_check_result (const char *buf)
1302 /* The stub recognized the packet request. Check that the
1303 operation succeeded. */
1305 && isxdigit (buf[1]) && isxdigit (buf[2])
1307 /* "Enn" - definitly an error. */
1308 return PACKET_ERROR;
1310 /* Always treat "E." as an error. This will be used for
1311 more verbose error messages, such as E.memtypes. */
1312 if (buf[0] == 'E' && buf[1] == '.')
1313 return PACKET_ERROR;
1315 /* The packet may or may not be OK. Just assume it is. */
1319 /* The stub does not support the packet. */
1320 return PACKET_UNKNOWN;
1323 static enum packet_result
1324 packet_ok (const char *buf, struct packet_config *config)
1326 enum packet_result result;
1328 if (config->detect != AUTO_BOOLEAN_TRUE
1329 && config->support == PACKET_DISABLE)
1330 internal_error (__FILE__, __LINE__,
1331 _("packet_ok: attempt to use a disabled packet"));
1333 result = packet_check_result (buf);
1338 /* The stub recognized the packet request. */
1339 if (config->support == PACKET_SUPPORT_UNKNOWN)
1342 fprintf_unfiltered (gdb_stdlog,
1343 "Packet %s (%s) is supported\n",
1344 config->name, config->title);
1345 config->support = PACKET_ENABLE;
1348 case PACKET_UNKNOWN:
1349 /* The stub does not support the packet. */
1350 if (config->detect == AUTO_BOOLEAN_AUTO
1351 && config->support == PACKET_ENABLE)
1353 /* If the stub previously indicated that the packet was
1354 supported then there is a protocol error. */
1355 error (_("Protocol error: %s (%s) conflicting enabled responses."),
1356 config->name, config->title);
1358 else if (config->detect == AUTO_BOOLEAN_TRUE)
1360 /* The user set it wrong. */
1361 error (_("Enabled packet %s (%s) not recognized by stub"),
1362 config->name, config->title);
1366 fprintf_unfiltered (gdb_stdlog,
1367 "Packet %s (%s) is NOT supported\n",
1368 config->name, config->title);
1369 config->support = PACKET_DISABLE;
1390 PACKET_vFile_pwrite,
1392 PACKET_vFile_unlink,
1393 PACKET_vFile_readlink,
1396 PACKET_qXfer_features,
1397 PACKET_qXfer_exec_file,
1398 PACKET_qXfer_libraries,
1399 PACKET_qXfer_libraries_svr4,
1400 PACKET_qXfer_memory_map,
1401 PACKET_qXfer_spu_read,
1402 PACKET_qXfer_spu_write,
1403 PACKET_qXfer_osdata,
1404 PACKET_qXfer_threads,
1405 PACKET_qXfer_statictrace_read,
1406 PACKET_qXfer_traceframe_info,
1412 PACKET_QPassSignals,
1413 PACKET_QCatchSyscalls,
1414 PACKET_QProgramSignals,
1415 PACKET_QSetWorkingDir,
1416 PACKET_QStartupWithShell,
1417 PACKET_QEnvironmentHexEncoded,
1418 PACKET_QEnvironmentReset,
1419 PACKET_QEnvironmentUnset,
1421 PACKET_qSearch_memory,
1424 PACKET_QStartNoAckMode,
1426 PACKET_qXfer_siginfo_read,
1427 PACKET_qXfer_siginfo_write,
1430 /* Support for conditional tracepoints. */
1431 PACKET_ConditionalTracepoints,
1433 /* Support for target-side breakpoint conditions. */
1434 PACKET_ConditionalBreakpoints,
1436 /* Support for target-side breakpoint commands. */
1437 PACKET_BreakpointCommands,
1439 /* Support for fast tracepoints. */
1440 PACKET_FastTracepoints,
1442 /* Support for static tracepoints. */
1443 PACKET_StaticTracepoints,
1445 /* Support for installing tracepoints while a trace experiment is
1447 PACKET_InstallInTrace,
1451 PACKET_TracepointSource,
1454 PACKET_QDisableRandomization,
1456 PACKET_QTBuffer_size,
1460 PACKET_qXfer_btrace,
1462 /* Support for the QNonStop packet. */
1465 /* Support for the QThreadEvents packet. */
1466 PACKET_QThreadEvents,
1468 /* Support for multi-process extensions. */
1469 PACKET_multiprocess_feature,
1471 /* Support for enabling and disabling tracepoints while a trace
1472 experiment is running. */
1473 PACKET_EnableDisableTracepoints_feature,
1475 /* Support for collecting strings using the tracenz bytecode. */
1476 PACKET_tracenz_feature,
1478 /* Support for continuing to run a trace experiment while GDB is
1480 PACKET_DisconnectedTracing_feature,
1482 /* Support for qXfer:libraries-svr4:read with a non-empty annex. */
1483 PACKET_augmented_libraries_svr4_read_feature,
1485 /* Support for the qXfer:btrace-conf:read packet. */
1486 PACKET_qXfer_btrace_conf,
1488 /* Support for the Qbtrace-conf:bts:size packet. */
1489 PACKET_Qbtrace_conf_bts_size,
1491 /* Support for swbreak+ feature. */
1492 PACKET_swbreak_feature,
1494 /* Support for hwbreak+ feature. */
1495 PACKET_hwbreak_feature,
1497 /* Support for fork events. */
1498 PACKET_fork_event_feature,
1500 /* Support for vfork events. */
1501 PACKET_vfork_event_feature,
1503 /* Support for the Qbtrace-conf:pt:size packet. */
1504 PACKET_Qbtrace_conf_pt_size,
1506 /* Support for exec events. */
1507 PACKET_exec_event_feature,
1509 /* Support for query supported vCont actions. */
1510 PACKET_vContSupported,
1512 /* Support remote CTRL-C. */
1515 /* Support TARGET_WAITKIND_NO_RESUMED. */
1521 static struct packet_config remote_protocol_packets[PACKET_MAX];
1523 /* Returns the packet's corresponding "set remote foo-packet" command
1524 state. See struct packet_config for more details. */
1526 static enum auto_boolean
1527 packet_set_cmd_state (int packet)
1529 return remote_protocol_packets[packet].detect;
1532 /* Returns whether a given packet or feature is supported. This takes
1533 into account the state of the corresponding "set remote foo-packet"
1534 command, which may be used to bypass auto-detection. */
1536 static enum packet_support
1537 packet_config_support (struct packet_config *config)
1539 switch (config->detect)
1541 case AUTO_BOOLEAN_TRUE:
1542 return PACKET_ENABLE;
1543 case AUTO_BOOLEAN_FALSE:
1544 return PACKET_DISABLE;
1545 case AUTO_BOOLEAN_AUTO:
1546 return config->support;
1548 gdb_assert_not_reached (_("bad switch"));
1552 /* Same as packet_config_support, but takes the packet's enum value as
1555 static enum packet_support
1556 packet_support (int packet)
1558 struct packet_config *config = &remote_protocol_packets[packet];
1560 return packet_config_support (config);
1564 show_remote_protocol_packet_cmd (struct ui_file *file, int from_tty,
1565 struct cmd_list_element *c,
1568 struct packet_config *packet;
1570 for (packet = remote_protocol_packets;
1571 packet < &remote_protocol_packets[PACKET_MAX];
1574 if (&packet->detect == c->var)
1576 show_packet_config_cmd (packet);
1580 internal_error (__FILE__, __LINE__, _("Could not find config for %s"),
1584 /* Should we try one of the 'Z' requests? */
1588 Z_PACKET_SOFTWARE_BP,
1589 Z_PACKET_HARDWARE_BP,
1596 /* For compatibility with older distributions. Provide a ``set remote
1597 Z-packet ...'' command that updates all the Z packet types. */
1599 static enum auto_boolean remote_Z_packet_detect;
1602 set_remote_protocol_Z_packet_cmd (const char *args, int from_tty,
1603 struct cmd_list_element *c)
1607 for (i = 0; i < NR_Z_PACKET_TYPES; i++)
1608 remote_protocol_packets[PACKET_Z0 + i].detect = remote_Z_packet_detect;
1612 show_remote_protocol_Z_packet_cmd (struct ui_file *file, int from_tty,
1613 struct cmd_list_element *c,
1618 for (i = 0; i < NR_Z_PACKET_TYPES; i++)
1620 show_packet_config_cmd (&remote_protocol_packets[PACKET_Z0 + i]);
1624 /* Returns true if the multi-process extensions are in effect. */
1627 remote_multi_process_p (struct remote_state *rs)
1629 return packet_support (PACKET_multiprocess_feature) == PACKET_ENABLE;
1632 /* Returns true if fork events are supported. */
1635 remote_fork_event_p (struct remote_state *rs)
1637 return packet_support (PACKET_fork_event_feature) == PACKET_ENABLE;
1640 /* Returns true if vfork events are supported. */
1643 remote_vfork_event_p (struct remote_state *rs)
1645 return packet_support (PACKET_vfork_event_feature) == PACKET_ENABLE;
1648 /* Returns true if exec events are supported. */
1651 remote_exec_event_p (struct remote_state *rs)
1653 return packet_support (PACKET_exec_event_feature) == PACKET_ENABLE;
1656 /* Insert fork catchpoint target routine. If fork events are enabled
1657 then return success, nothing more to do. */
1660 remote_insert_fork_catchpoint (struct target_ops *ops, int pid)
1662 struct remote_state *rs = get_remote_state ();
1664 return !remote_fork_event_p (rs);
1667 /* Remove fork catchpoint target routine. Nothing to do, just
1671 remote_remove_fork_catchpoint (struct target_ops *ops, int pid)
1676 /* Insert vfork catchpoint target routine. If vfork events are enabled
1677 then return success, nothing more to do. */
1680 remote_insert_vfork_catchpoint (struct target_ops *ops, int pid)
1682 struct remote_state *rs = get_remote_state ();
1684 return !remote_vfork_event_p (rs);
1687 /* Remove vfork catchpoint target routine. Nothing to do, just
1691 remote_remove_vfork_catchpoint (struct target_ops *ops, int pid)
1696 /* Insert exec catchpoint target routine. If exec events are
1697 enabled, just return success. */
1700 remote_insert_exec_catchpoint (struct target_ops *ops, int pid)
1702 struct remote_state *rs = get_remote_state ();
1704 return !remote_exec_event_p (rs);
1707 /* Remove exec catchpoint target routine. Nothing to do, just
1711 remote_remove_exec_catchpoint (struct target_ops *ops, int pid)
1717 /* Asynchronous signal handle registered as event loop source for
1718 when we have pending events ready to be passed to the core. */
1720 static struct async_event_handler *remote_async_inferior_event_token;
1724 static ptid_t magic_null_ptid;
1725 static ptid_t not_sent_ptid;
1726 static ptid_t any_thread_ptid;
1728 /* Find out if the stub attached to PID (and hence GDB should offer to
1729 detach instead of killing it when bailing out). */
1732 remote_query_attached (int pid)
1734 struct remote_state *rs = get_remote_state ();
1735 size_t size = get_remote_packet_size ();
1737 if (packet_support (PACKET_qAttached) == PACKET_DISABLE)
1740 if (remote_multi_process_p (rs))
1741 xsnprintf (rs->buf, size, "qAttached:%x", pid);
1743 xsnprintf (rs->buf, size, "qAttached");
1746 getpkt (&rs->buf, &rs->buf_size, 0);
1748 switch (packet_ok (rs->buf,
1749 &remote_protocol_packets[PACKET_qAttached]))
1752 if (strcmp (rs->buf, "1") == 0)
1756 warning (_("Remote failure reply: %s"), rs->buf);
1758 case PACKET_UNKNOWN:
1765 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
1766 has been invented by GDB, instead of reported by the target. Since
1767 we can be connected to a remote system before before knowing about
1768 any inferior, mark the target with execution when we find the first
1769 inferior. If ATTACHED is 1, then we had just attached to this
1770 inferior. If it is 0, then we just created this inferior. If it
1771 is -1, then try querying the remote stub to find out if it had
1772 attached to the inferior or not. If TRY_OPEN_EXEC is true then
1773 attempt to open this inferior's executable as the main executable
1774 if no main executable is open already. */
1776 static struct inferior *
1777 remote_add_inferior (int fake_pid_p, int pid, int attached,
1780 struct inferior *inf;
1782 /* Check whether this process we're learning about is to be
1783 considered attached, or if is to be considered to have been
1784 spawned by the stub. */
1786 attached = remote_query_attached (pid);
1788 if (gdbarch_has_global_solist (target_gdbarch ()))
1790 /* If the target shares code across all inferiors, then every
1791 attach adds a new inferior. */
1792 inf = add_inferior (pid);
1794 /* ... and every inferior is bound to the same program space.
1795 However, each inferior may still have its own address
1797 inf->aspace = maybe_new_address_space ();
1798 inf->pspace = current_program_space;
1802 /* In the traditional debugging scenario, there's a 1-1 match
1803 between program/address spaces. We simply bind the inferior
1804 to the program space's address space. */
1805 inf = current_inferior ();
1806 inferior_appeared (inf, pid);
1809 inf->attach_flag = attached;
1810 inf->fake_pid_p = fake_pid_p;
1812 /* If no main executable is currently open then attempt to
1813 open the file that was executed to create this inferior. */
1814 if (try_open_exec && get_exec_file (0) == NULL)
1815 exec_file_locate_attach (pid, 0, 1);
1820 static remote_thread_info *get_remote_thread_info (thread_info *thread);
1822 /* Add thread PTID to GDB's thread list. Tag it as executing/running
1823 according to RUNNING. */
1826 remote_add_thread (ptid_t ptid, int running, int executing)
1828 struct remote_state *rs = get_remote_state ();
1829 struct thread_info *thread;
1831 /* GDB historically didn't pull threads in the initial connection
1832 setup. If the remote target doesn't even have a concept of
1833 threads (e.g., a bare-metal target), even if internally we
1834 consider that a single-threaded target, mentioning a new thread
1835 might be confusing to the user. Be silent then, preserving the
1836 age old behavior. */
1837 if (rs->starting_up)
1838 thread = add_thread_silent (ptid);
1840 thread = add_thread (ptid);
1842 get_remote_thread_info (thread)->vcont_resumed = executing;
1843 set_executing (ptid, executing);
1844 set_running (ptid, running);
1847 /* Come here when we learn about a thread id from the remote target.
1848 It may be the first time we hear about such thread, so take the
1849 opportunity to add it to GDB's thread list. In case this is the
1850 first time we're noticing its corresponding inferior, add it to
1851 GDB's inferior list as well. EXECUTING indicates whether the
1852 thread is (internally) executing or stopped. */
1855 remote_notice_new_inferior (ptid_t currthread, int executing)
1857 /* In non-stop mode, we assume new found threads are (externally)
1858 running until proven otherwise with a stop reply. In all-stop,
1859 we can only get here if all threads are stopped. */
1860 int running = target_is_non_stop_p () ? 1 : 0;
1862 /* If this is a new thread, add it to GDB's thread list.
1863 If we leave it up to WFI to do this, bad things will happen. */
1865 if (in_thread_list (currthread) && is_exited (currthread))
1867 /* We're seeing an event on a thread id we knew had exited.
1868 This has to be a new thread reusing the old id. Add it. */
1869 remote_add_thread (currthread, running, executing);
1873 if (!in_thread_list (currthread))
1875 struct inferior *inf = NULL;
1876 int pid = ptid_get_pid (currthread);
1878 if (ptid_is_pid (inferior_ptid)
1879 && pid == ptid_get_pid (inferior_ptid))
1881 /* inferior_ptid has no thread member yet. This can happen
1882 with the vAttach -> remote_wait,"TAAthread:" path if the
1883 stub doesn't support qC. This is the first stop reported
1884 after an attach, so this is the main thread. Update the
1885 ptid in the thread list. */
1886 if (in_thread_list (pid_to_ptid (pid)))
1887 thread_change_ptid (inferior_ptid, currthread);
1890 remote_add_thread (currthread, running, executing);
1891 inferior_ptid = currthread;
1896 if (ptid_equal (magic_null_ptid, inferior_ptid))
1898 /* inferior_ptid is not set yet. This can happen with the
1899 vRun -> remote_wait,"TAAthread:" path if the stub
1900 doesn't support qC. This is the first stop reported
1901 after an attach, so this is the main thread. Update the
1902 ptid in the thread list. */
1903 thread_change_ptid (inferior_ptid, currthread);
1907 /* When connecting to a target remote, or to a target
1908 extended-remote which already was debugging an inferior, we
1909 may not know about it yet. Add it before adding its child
1910 thread, so notifications are emitted in a sensible order. */
1911 if (!in_inferior_list (ptid_get_pid (currthread)))
1913 struct remote_state *rs = get_remote_state ();
1914 int fake_pid_p = !remote_multi_process_p (rs);
1916 inf = remote_add_inferior (fake_pid_p,
1917 ptid_get_pid (currthread), -1, 1);
1920 /* This is really a new thread. Add it. */
1921 remote_add_thread (currthread, running, executing);
1923 /* If we found a new inferior, let the common code do whatever
1924 it needs to with it (e.g., read shared libraries, insert
1925 breakpoints), unless we're just setting up an all-stop
1929 struct remote_state *rs = get_remote_state ();
1931 if (!rs->starting_up)
1932 notice_new_inferior (currthread, executing, 0);
1937 /* Return THREAD's private thread data, creating it if necessary. */
1939 static remote_thread_info *
1940 get_remote_thread_info (thread_info *thread)
1942 gdb_assert (thread != NULL);
1944 if (thread->priv == NULL)
1945 thread->priv.reset (new remote_thread_info);
1947 return static_cast<remote_thread_info *> (thread->priv.get ());
1950 /* Return PTID's private thread data, creating it if necessary. */
1952 static remote_thread_info *
1953 get_remote_thread_info (ptid_t ptid)
1955 struct thread_info *info = find_thread_ptid (ptid);
1957 return get_remote_thread_info (info);
1960 /* Call this function as a result of
1961 1) A halt indication (T packet) containing a thread id
1962 2) A direct query of currthread
1963 3) Successful execution of set thread */
1966 record_currthread (struct remote_state *rs, ptid_t currthread)
1968 rs->general_thread = currthread;
1971 /* If 'QPassSignals' is supported, tell the remote stub what signals
1972 it can simply pass through to the inferior without reporting. */
1975 remote_pass_signals (struct target_ops *self,
1976 int numsigs, unsigned char *pass_signals)
1978 if (packet_support (PACKET_QPassSignals) != PACKET_DISABLE)
1980 char *pass_packet, *p;
1982 struct remote_state *rs = get_remote_state ();
1984 gdb_assert (numsigs < 256);
1985 for (i = 0; i < numsigs; i++)
1987 if (pass_signals[i])
1990 pass_packet = (char *) xmalloc (count * 3 + strlen ("QPassSignals:") + 1);
1991 strcpy (pass_packet, "QPassSignals:");
1992 p = pass_packet + strlen (pass_packet);
1993 for (i = 0; i < numsigs; i++)
1995 if (pass_signals[i])
1998 *p++ = tohex (i >> 4);
1999 *p++ = tohex (i & 15);
2008 if (!rs->last_pass_packet || strcmp (rs->last_pass_packet, pass_packet))
2010 putpkt (pass_packet);
2011 getpkt (&rs->buf, &rs->buf_size, 0);
2012 packet_ok (rs->buf, &remote_protocol_packets[PACKET_QPassSignals]);
2013 if (rs->last_pass_packet)
2014 xfree (rs->last_pass_packet);
2015 rs->last_pass_packet = pass_packet;
2018 xfree (pass_packet);
2022 /* If 'QCatchSyscalls' is supported, tell the remote stub
2023 to report syscalls to GDB. */
2026 remote_set_syscall_catchpoint (struct target_ops *self,
2027 int pid, int needed, int any_count,
2028 int table_size, int *table)
2030 const char *catch_packet;
2031 enum packet_result result;
2034 if (packet_support (PACKET_QCatchSyscalls) == PACKET_DISABLE)
2036 /* Not supported. */
2040 if (needed && !any_count)
2044 /* Count how many syscalls are to be caught (table[sysno] != 0). */
2045 for (i = 0; i < table_size; i++)
2054 fprintf_unfiltered (gdb_stdlog,
2055 "remote_set_syscall_catchpoint "
2056 "pid %d needed %d any_count %d n_sysno %d\n",
2057 pid, needed, any_count, n_sysno);
2060 std::string built_packet;
2063 /* Prepare a packet with the sysno list, assuming max 8+1
2064 characters for a sysno. If the resulting packet size is too
2065 big, fallback on the non-selective packet. */
2066 const int maxpktsz = strlen ("QCatchSyscalls:1") + n_sysno * 9 + 1;
2067 built_packet.reserve (maxpktsz);
2068 built_packet = "QCatchSyscalls:1";
2071 /* Add in catch_packet each syscall to be caught (table[i] != 0). */
2072 for (int i = 0; i < table_size; i++)
2075 string_appendf (built_packet, ";%x", i);
2078 if (built_packet.size () > get_remote_packet_size ())
2080 /* catch_packet too big. Fallback to less efficient
2081 non selective mode, with GDB doing the filtering. */
2082 catch_packet = "QCatchSyscalls:1";
2085 catch_packet = built_packet.c_str ();
2088 catch_packet = "QCatchSyscalls:0";
2090 struct remote_state *rs = get_remote_state ();
2092 putpkt (catch_packet);
2093 getpkt (&rs->buf, &rs->buf_size, 0);
2094 result = packet_ok (rs->buf, &remote_protocol_packets[PACKET_QCatchSyscalls]);
2095 if (result == PACKET_OK)
2101 /* If 'QProgramSignals' is supported, tell the remote stub what
2102 signals it should pass through to the inferior when detaching. */
2105 remote_program_signals (struct target_ops *self,
2106 int numsigs, unsigned char *signals)
2108 if (packet_support (PACKET_QProgramSignals) != PACKET_DISABLE)
2112 struct remote_state *rs = get_remote_state ();
2114 gdb_assert (numsigs < 256);
2115 for (i = 0; i < numsigs; i++)
2120 packet = (char *) xmalloc (count * 3 + strlen ("QProgramSignals:") + 1);
2121 strcpy (packet, "QProgramSignals:");
2122 p = packet + strlen (packet);
2123 for (i = 0; i < numsigs; i++)
2125 if (signal_pass_state (i))
2128 *p++ = tohex (i >> 4);
2129 *p++ = tohex (i & 15);
2138 if (!rs->last_program_signals_packet
2139 || strcmp (rs->last_program_signals_packet, packet) != 0)
2142 getpkt (&rs->buf, &rs->buf_size, 0);
2143 packet_ok (rs->buf, &remote_protocol_packets[PACKET_QProgramSignals]);
2144 xfree (rs->last_program_signals_packet);
2145 rs->last_program_signals_packet = packet;
2152 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
2153 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
2154 thread. If GEN is set, set the general thread, if not, then set
2155 the step/continue thread. */
2157 set_thread (ptid_t ptid, int gen)
2159 struct remote_state *rs = get_remote_state ();
2160 ptid_t state = gen ? rs->general_thread : rs->continue_thread;
2161 char *buf = rs->buf;
2162 char *endbuf = rs->buf + get_remote_packet_size ();
2164 if (ptid_equal (state, ptid))
2168 *buf++ = gen ? 'g' : 'c';
2169 if (ptid_equal (ptid, magic_null_ptid))
2170 xsnprintf (buf, endbuf - buf, "0");
2171 else if (ptid_equal (ptid, any_thread_ptid))
2172 xsnprintf (buf, endbuf - buf, "0");
2173 else if (ptid_equal (ptid, minus_one_ptid))
2174 xsnprintf (buf, endbuf - buf, "-1");
2176 write_ptid (buf, endbuf, ptid);
2178 getpkt (&rs->buf, &rs->buf_size, 0);
2180 rs->general_thread = ptid;
2182 rs->continue_thread = ptid;
2186 set_general_thread (ptid_t ptid)
2188 set_thread (ptid, 1);
2192 set_continue_thread (ptid_t ptid)
2194 set_thread (ptid, 0);
2197 /* Change the remote current process. Which thread within the process
2198 ends up selected isn't important, as long as it is the same process
2199 as what INFERIOR_PTID points to.
2201 This comes from that fact that there is no explicit notion of
2202 "selected process" in the protocol. The selected process for
2203 general operations is the process the selected general thread
2207 set_general_process (void)
2209 struct remote_state *rs = get_remote_state ();
2211 /* If the remote can't handle multiple processes, don't bother. */
2212 if (!remote_multi_process_p (rs))
2215 /* We only need to change the remote current thread if it's pointing
2216 at some other process. */
2217 if (ptid_get_pid (rs->general_thread) != ptid_get_pid (inferior_ptid))
2218 set_general_thread (inferior_ptid);
2222 /* Return nonzero if this is the main thread that we made up ourselves
2223 to model non-threaded targets as single-threaded. */
2226 remote_thread_always_alive (struct target_ops *ops, ptid_t ptid)
2228 if (ptid_equal (ptid, magic_null_ptid))
2229 /* The main thread is always alive. */
2232 if (ptid_get_pid (ptid) != 0 && ptid_get_lwp (ptid) == 0)
2233 /* The main thread is always alive. This can happen after a
2234 vAttach, if the remote side doesn't support
2241 /* Return nonzero if the thread PTID is still alive on the remote
2245 remote_thread_alive (struct target_ops *ops, ptid_t ptid)
2247 struct remote_state *rs = get_remote_state ();
2250 /* Check if this is a thread that we made up ourselves to model
2251 non-threaded targets as single-threaded. */
2252 if (remote_thread_always_alive (ops, ptid))
2256 endp = rs->buf + get_remote_packet_size ();
2259 write_ptid (p, endp, ptid);
2262 getpkt (&rs->buf, &rs->buf_size, 0);
2263 return (rs->buf[0] == 'O' && rs->buf[1] == 'K');
2266 /* Return a pointer to a thread name if we know it and NULL otherwise.
2267 The thread_info object owns the memory for the name. */
2270 remote_thread_name (struct target_ops *ops, struct thread_info *info)
2272 if (info->priv != NULL)
2273 return get_remote_thread_info (info)->name.c_str ();
2278 /* About these extended threadlist and threadinfo packets. They are
2279 variable length packets but, the fields within them are often fixed
2280 length. They are redundent enough to send over UDP as is the
2281 remote protocol in general. There is a matching unit test module
2284 /* WARNING: This threadref data structure comes from the remote O.S.,
2285 libstub protocol encoding, and remote.c. It is not particularly
2288 /* Right now, the internal structure is int. We want it to be bigger.
2289 Plan to fix this. */
2291 typedef int gdb_threadref; /* Internal GDB thread reference. */
2293 /* gdb_ext_thread_info is an internal GDB data structure which is
2294 equivalent to the reply of the remote threadinfo packet. */
2296 struct gdb_ext_thread_info
2298 threadref threadid; /* External form of thread reference. */
2299 int active; /* Has state interesting to GDB?
2301 char display[256]; /* Brief state display, name,
2302 blocked/suspended. */
2303 char shortname[32]; /* To be used to name threads. */
2304 char more_display[256]; /* Long info, statistics, queue depth,
2308 /* The volume of remote transfers can be limited by submitting
2309 a mask containing bits specifying the desired information.
2310 Use a union of these values as the 'selection' parameter to
2311 get_thread_info. FIXME: Make these TAG names more thread specific. */
2313 #define TAG_THREADID 1
2314 #define TAG_EXISTS 2
2315 #define TAG_DISPLAY 4
2316 #define TAG_THREADNAME 8
2317 #define TAG_MOREDISPLAY 16
2319 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
2321 static char *unpack_nibble (char *buf, int *val);
2323 static char *unpack_byte (char *buf, int *value);
2325 static char *pack_int (char *buf, int value);
2327 static char *unpack_int (char *buf, int *value);
2329 static char *unpack_string (char *src, char *dest, int length);
2331 static char *pack_threadid (char *pkt, threadref *id);
2333 static char *unpack_threadid (char *inbuf, threadref *id);
2335 void int_to_threadref (threadref *id, int value);
2337 static int threadref_to_int (threadref *ref);
2339 static void copy_threadref (threadref *dest, threadref *src);
2341 static int threadmatch (threadref *dest, threadref *src);
2343 static char *pack_threadinfo_request (char *pkt, int mode,
2346 static int remote_unpack_thread_info_response (char *pkt,
2347 threadref *expectedref,
2348 struct gdb_ext_thread_info
2352 static int remote_get_threadinfo (threadref *threadid,
2353 int fieldset, /*TAG mask */
2354 struct gdb_ext_thread_info *info);
2356 static char *pack_threadlist_request (char *pkt, int startflag,
2358 threadref *nextthread);
2360 static int parse_threadlist_response (char *pkt,
2362 threadref *original_echo,
2363 threadref *resultlist,
2366 static int remote_get_threadlist (int startflag,
2367 threadref *nextthread,
2371 threadref *threadlist);
2373 typedef int (*rmt_thread_action) (threadref *ref, void *context);
2375 static int remote_threadlist_iterator (rmt_thread_action stepfunction,
2376 void *context, int looplimit);
2378 static int remote_newthread_step (threadref *ref, void *context);
2381 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
2382 buffer we're allowed to write to. Returns
2383 BUF+CHARACTERS_WRITTEN. */
2386 write_ptid (char *buf, const char *endbuf, ptid_t ptid)
2389 struct remote_state *rs = get_remote_state ();
2391 if (remote_multi_process_p (rs))
2393 pid = ptid_get_pid (ptid);
2395 buf += xsnprintf (buf, endbuf - buf, "p-%x.", -pid);
2397 buf += xsnprintf (buf, endbuf - buf, "p%x.", pid);
2399 tid = ptid_get_lwp (ptid);
2401 buf += xsnprintf (buf, endbuf - buf, "-%x", -tid);
2403 buf += xsnprintf (buf, endbuf - buf, "%x", tid);
2408 /* Extract a PTID from BUF. If non-null, OBUF is set to one past the
2409 last parsed char. Returns null_ptid if no thread id is found, and
2410 throws an error if the thread id has an invalid format. */
2413 read_ptid (const char *buf, const char **obuf)
2415 const char *p = buf;
2417 ULONGEST pid = 0, tid = 0;
2421 /* Multi-process ptid. */
2422 pp = unpack_varlen_hex (p + 1, &pid);
2424 error (_("invalid remote ptid: %s"), p);
2427 pp = unpack_varlen_hex (p + 1, &tid);
2430 return ptid_build (pid, tid, 0);
2433 /* No multi-process. Just a tid. */
2434 pp = unpack_varlen_hex (p, &tid);
2436 /* Return null_ptid when no thread id is found. */
2444 /* Since the stub is not sending a process id, then default to
2445 what's in inferior_ptid, unless it's null at this point. If so,
2446 then since there's no way to know the pid of the reported
2447 threads, use the magic number. */
2448 if (ptid_equal (inferior_ptid, null_ptid))
2449 pid = ptid_get_pid (magic_null_ptid);
2451 pid = ptid_get_pid (inferior_ptid);
2455 return ptid_build (pid, tid, 0);
2461 if (ch >= 'a' && ch <= 'f')
2462 return ch - 'a' + 10;
2463 if (ch >= '0' && ch <= '9')
2465 if (ch >= 'A' && ch <= 'F')
2466 return ch - 'A' + 10;
2471 stub_unpack_int (char *buff, int fieldlength)
2478 nibble = stubhex (*buff++);
2482 retval = retval << 4;
2488 unpack_nibble (char *buf, int *val)
2490 *val = fromhex (*buf++);
2495 unpack_byte (char *buf, int *value)
2497 *value = stub_unpack_int (buf, 2);
2502 pack_int (char *buf, int value)
2504 buf = pack_hex_byte (buf, (value >> 24) & 0xff);
2505 buf = pack_hex_byte (buf, (value >> 16) & 0xff);
2506 buf = pack_hex_byte (buf, (value >> 8) & 0x0ff);
2507 buf = pack_hex_byte (buf, (value & 0xff));
2512 unpack_int (char *buf, int *value)
2514 *value = stub_unpack_int (buf, 8);
2518 #if 0 /* Currently unused, uncomment when needed. */
2519 static char *pack_string (char *pkt, char *string);
2522 pack_string (char *pkt, char *string)
2527 len = strlen (string);
2529 len = 200; /* Bigger than most GDB packets, junk??? */
2530 pkt = pack_hex_byte (pkt, len);
2534 if ((ch == '\0') || (ch == '#'))
2535 ch = '*'; /* Protect encapsulation. */
2540 #endif /* 0 (unused) */
2543 unpack_string (char *src, char *dest, int length)
2552 pack_threadid (char *pkt, threadref *id)
2555 unsigned char *altid;
2557 altid = (unsigned char *) id;
2558 limit = pkt + BUF_THREAD_ID_SIZE;
2560 pkt = pack_hex_byte (pkt, *altid++);
2566 unpack_threadid (char *inbuf, threadref *id)
2569 char *limit = inbuf + BUF_THREAD_ID_SIZE;
2572 altref = (char *) id;
2574 while (inbuf < limit)
2576 x = stubhex (*inbuf++);
2577 y = stubhex (*inbuf++);
2578 *altref++ = (x << 4) | y;
2583 /* Externally, threadrefs are 64 bits but internally, they are still
2584 ints. This is due to a mismatch of specifications. We would like
2585 to use 64bit thread references internally. This is an adapter
2589 int_to_threadref (threadref *id, int value)
2591 unsigned char *scan;
2593 scan = (unsigned char *) id;
2599 *scan++ = (value >> 24) & 0xff;
2600 *scan++ = (value >> 16) & 0xff;
2601 *scan++ = (value >> 8) & 0xff;
2602 *scan++ = (value & 0xff);
2606 threadref_to_int (threadref *ref)
2609 unsigned char *scan;
2615 value = (value << 8) | ((*scan++) & 0xff);
2620 copy_threadref (threadref *dest, threadref *src)
2623 unsigned char *csrc, *cdest;
2625 csrc = (unsigned char *) src;
2626 cdest = (unsigned char *) dest;
2633 threadmatch (threadref *dest, threadref *src)
2635 /* Things are broken right now, so just assume we got a match. */
2637 unsigned char *srcp, *destp;
2639 srcp = (char *) src;
2640 destp = (char *) dest;
2644 result &= (*srcp++ == *destp++) ? 1 : 0;
2651 threadid:1, # always request threadid
2658 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
2661 pack_threadinfo_request (char *pkt, int mode, threadref *id)
2663 *pkt++ = 'q'; /* Info Query */
2664 *pkt++ = 'P'; /* process or thread info */
2665 pkt = pack_int (pkt, mode); /* mode */
2666 pkt = pack_threadid (pkt, id); /* threadid */
2667 *pkt = '\0'; /* terminate */
2671 /* These values tag the fields in a thread info response packet. */
2672 /* Tagging the fields allows us to request specific fields and to
2673 add more fields as time goes by. */
2675 #define TAG_THREADID 1 /* Echo the thread identifier. */
2676 #define TAG_EXISTS 2 /* Is this process defined enough to
2677 fetch registers and its stack? */
2678 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
2679 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
2680 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
2684 remote_unpack_thread_info_response (char *pkt, threadref *expectedref,
2685 struct gdb_ext_thread_info *info)
2687 struct remote_state *rs = get_remote_state ();
2691 char *limit = pkt + rs->buf_size; /* Plausible parsing limit. */
2694 /* info->threadid = 0; FIXME: implement zero_threadref. */
2696 info->display[0] = '\0';
2697 info->shortname[0] = '\0';
2698 info->more_display[0] = '\0';
2700 /* Assume the characters indicating the packet type have been
2702 pkt = unpack_int (pkt, &mask); /* arg mask */
2703 pkt = unpack_threadid (pkt, &ref);
2706 warning (_("Incomplete response to threadinfo request."));
2707 if (!threadmatch (&ref, expectedref))
2708 { /* This is an answer to a different request. */
2709 warning (_("ERROR RMT Thread info mismatch."));
2712 copy_threadref (&info->threadid, &ref);
2714 /* Loop on tagged fields , try to bail if somthing goes wrong. */
2716 /* Packets are terminated with nulls. */
2717 while ((pkt < limit) && mask && *pkt)
2719 pkt = unpack_int (pkt, &tag); /* tag */
2720 pkt = unpack_byte (pkt, &length); /* length */
2721 if (!(tag & mask)) /* Tags out of synch with mask. */
2723 warning (_("ERROR RMT: threadinfo tag mismatch."));
2727 if (tag == TAG_THREADID)
2731 warning (_("ERROR RMT: length of threadid is not 16."));
2735 pkt = unpack_threadid (pkt, &ref);
2736 mask = mask & ~TAG_THREADID;
2739 if (tag == TAG_EXISTS)
2741 info->active = stub_unpack_int (pkt, length);
2743 mask = mask & ~(TAG_EXISTS);
2746 warning (_("ERROR RMT: 'exists' length too long."));
2752 if (tag == TAG_THREADNAME)
2754 pkt = unpack_string (pkt, &info->shortname[0], length);
2755 mask = mask & ~TAG_THREADNAME;
2758 if (tag == TAG_DISPLAY)
2760 pkt = unpack_string (pkt, &info->display[0], length);
2761 mask = mask & ~TAG_DISPLAY;
2764 if (tag == TAG_MOREDISPLAY)
2766 pkt = unpack_string (pkt, &info->more_display[0], length);
2767 mask = mask & ~TAG_MOREDISPLAY;
2770 warning (_("ERROR RMT: unknown thread info tag."));
2771 break; /* Not a tag we know about. */
2777 remote_get_threadinfo (threadref *threadid, int fieldset, /* TAG mask */
2778 struct gdb_ext_thread_info *info)
2780 struct remote_state *rs = get_remote_state ();
2783 pack_threadinfo_request (rs->buf, fieldset, threadid);
2785 getpkt (&rs->buf, &rs->buf_size, 0);
2787 if (rs->buf[0] == '\0')
2790 result = remote_unpack_thread_info_response (rs->buf + 2,
2795 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
2798 pack_threadlist_request (char *pkt, int startflag, int threadcount,
2799 threadref *nextthread)
2801 *pkt++ = 'q'; /* info query packet */
2802 *pkt++ = 'L'; /* Process LIST or threadLIST request */
2803 pkt = pack_nibble (pkt, startflag); /* initflag 1 bytes */
2804 pkt = pack_hex_byte (pkt, threadcount); /* threadcount 2 bytes */
2805 pkt = pack_threadid (pkt, nextthread); /* 64 bit thread identifier */
2810 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
2813 parse_threadlist_response (char *pkt, int result_limit,
2814 threadref *original_echo, threadref *resultlist,
2817 struct remote_state *rs = get_remote_state ();
2819 int count, resultcount, done;
2822 /* Assume the 'q' and 'M chars have been stripped. */
2823 limit = pkt + (rs->buf_size - BUF_THREAD_ID_SIZE);
2824 /* done parse past here */
2825 pkt = unpack_byte (pkt, &count); /* count field */
2826 pkt = unpack_nibble (pkt, &done);
2827 /* The first threadid is the argument threadid. */
2828 pkt = unpack_threadid (pkt, original_echo); /* should match query packet */
2829 while ((count-- > 0) && (pkt < limit))
2831 pkt = unpack_threadid (pkt, resultlist++);
2832 if (resultcount++ >= result_limit)
2840 /* Fetch the next batch of threads from the remote. Returns -1 if the
2841 qL packet is not supported, 0 on error and 1 on success. */
2844 remote_get_threadlist (int startflag, threadref *nextthread, int result_limit,
2845 int *done, int *result_count, threadref *threadlist)
2847 struct remote_state *rs = get_remote_state ();
2850 /* Trancate result limit to be smaller than the packet size. */
2851 if ((((result_limit + 1) * BUF_THREAD_ID_SIZE) + 10)
2852 >= get_remote_packet_size ())
2853 result_limit = (get_remote_packet_size () / BUF_THREAD_ID_SIZE) - 2;
2855 pack_threadlist_request (rs->buf, startflag, result_limit, nextthread);
2857 getpkt (&rs->buf, &rs->buf_size, 0);
2858 if (*rs->buf == '\0')
2860 /* Packet not supported. */
2865 parse_threadlist_response (rs->buf + 2, result_limit,
2866 &rs->echo_nextthread, threadlist, done);
2868 if (!threadmatch (&rs->echo_nextthread, nextthread))
2870 /* FIXME: This is a good reason to drop the packet. */
2871 /* Possably, there is a duplicate response. */
2873 retransmit immediatly - race conditions
2874 retransmit after timeout - yes
2876 wait for packet, then exit
2878 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
2879 return 0; /* I choose simply exiting. */
2881 if (*result_count <= 0)
2885 warning (_("RMT ERROR : failed to get remote thread list."));
2888 return result; /* break; */
2890 if (*result_count > result_limit)
2893 warning (_("RMT ERROR: threadlist response longer than requested."));
2899 /* Fetch the list of remote threads, with the qL packet, and call
2900 STEPFUNCTION for each thread found. Stops iterating and returns 1
2901 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
2902 STEPFUNCTION returns false. If the packet is not supported,
2906 remote_threadlist_iterator (rmt_thread_action stepfunction, void *context,
2909 struct remote_state *rs = get_remote_state ();
2910 int done, i, result_count;
2918 if (loopcount++ > looplimit)
2921 warning (_("Remote fetch threadlist -infinite loop-."));
2924 result = remote_get_threadlist (startflag, &rs->nextthread,
2925 MAXTHREADLISTRESULTS,
2926 &done, &result_count,
2927 rs->resultthreadlist);
2930 /* Clear for later iterations. */
2932 /* Setup to resume next batch of thread references, set nextthread. */
2933 if (result_count >= 1)
2934 copy_threadref (&rs->nextthread,
2935 &rs->resultthreadlist[result_count - 1]);
2937 while (result_count--)
2939 if (!(*stepfunction) (&rs->resultthreadlist[i++], context))
2949 /* A thread found on the remote target. */
2953 explicit thread_item (ptid_t ptid_)
2957 thread_item (thread_item &&other) = default;
2958 thread_item &operator= (thread_item &&other) = default;
2960 DISABLE_COPY_AND_ASSIGN (thread_item);
2962 /* The thread's PTID. */
2965 /* The thread's extra info. */
2968 /* The thread's name. */
2971 /* The core the thread was running on. -1 if not known. */
2974 /* The thread handle associated with the thread. */
2975 gdb::byte_vector thread_handle;
2978 /* Context passed around to the various methods listing remote
2979 threads. As new threads are found, they're added to the ITEMS
2982 struct threads_listing_context
2984 /* Return true if this object contains an entry for a thread with ptid
2987 bool contains_thread (ptid_t ptid) const
2989 auto match_ptid = [&] (const thread_item &item)
2991 return item.ptid == ptid;
2994 auto it = std::find_if (this->items.begin (),
2998 return it != this->items.end ();
3001 /* Remove the thread with ptid PTID. */
3003 void remove_thread (ptid_t ptid)
3005 auto match_ptid = [&] (const thread_item &item)
3007 return item.ptid == ptid;
3010 auto it = std::remove_if (this->items.begin (),
3014 if (it != this->items.end ())
3015 this->items.erase (it);
3018 /* The threads found on the remote target. */
3019 std::vector<thread_item> items;
3023 remote_newthread_step (threadref *ref, void *data)
3025 struct threads_listing_context *context
3026 = (struct threads_listing_context *) data;
3027 int pid = inferior_ptid.pid ();
3028 int lwp = threadref_to_int (ref);
3029 ptid_t ptid (pid, lwp);
3031 context->items.emplace_back (ptid);
3033 return 1; /* continue iterator */
3036 #define CRAZY_MAX_THREADS 1000
3039 remote_current_thread (ptid_t oldpid)
3041 struct remote_state *rs = get_remote_state ();
3044 getpkt (&rs->buf, &rs->buf_size, 0);
3045 if (rs->buf[0] == 'Q' && rs->buf[1] == 'C')
3050 result = read_ptid (&rs->buf[2], &obuf);
3051 if (*obuf != '\0' && remote_debug)
3052 fprintf_unfiltered (gdb_stdlog,
3053 "warning: garbage in qC reply\n");
3061 /* List remote threads using the deprecated qL packet. */
3064 remote_get_threads_with_ql (struct target_ops *ops,
3065 struct threads_listing_context *context)
3067 if (remote_threadlist_iterator (remote_newthread_step, context,
3068 CRAZY_MAX_THREADS) >= 0)
3074 #if defined(HAVE_LIBEXPAT)
3077 start_thread (struct gdb_xml_parser *parser,
3078 const struct gdb_xml_element *element,
3079 void *user_data, VEC(gdb_xml_value_s) *attributes)
3081 struct threads_listing_context *data
3082 = (struct threads_listing_context *) user_data;
3083 struct gdb_xml_value *attr;
3085 char *id = (char *) xml_find_attribute (attributes, "id")->value;
3086 ptid_t ptid = read_ptid (id, NULL);
3088 data->items.emplace_back (ptid);
3089 thread_item &item = data->items.back ();
3091 attr = xml_find_attribute (attributes, "core");
3093 item.core = *(ULONGEST *) attr->value;
3095 attr = xml_find_attribute (attributes, "name");
3097 item.name = (const char *) attr->value;
3099 attr = xml_find_attribute (attributes, "handle");
3101 item.thread_handle = hex2bin ((const char *) attr->value);
3105 end_thread (struct gdb_xml_parser *parser,
3106 const struct gdb_xml_element *element,
3107 void *user_data, const char *body_text)
3109 struct threads_listing_context *data
3110 = (struct threads_listing_context *) user_data;
3112 if (body_text != NULL && *body_text != '\0')
3113 data->items.back ().extra = body_text;
3116 const struct gdb_xml_attribute thread_attributes[] = {
3117 { "id", GDB_XML_AF_NONE, NULL, NULL },
3118 { "core", GDB_XML_AF_OPTIONAL, gdb_xml_parse_attr_ulongest, NULL },
3119 { "name", GDB_XML_AF_OPTIONAL, NULL, NULL },
3120 { "handle", GDB_XML_AF_OPTIONAL, NULL, NULL },
3121 { NULL, GDB_XML_AF_NONE, NULL, NULL }
3124 const struct gdb_xml_element thread_children[] = {
3125 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3128 const struct gdb_xml_element threads_children[] = {
3129 { "thread", thread_attributes, thread_children,
3130 GDB_XML_EF_REPEATABLE | GDB_XML_EF_OPTIONAL,
3131 start_thread, end_thread },
3132 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3135 const struct gdb_xml_element threads_elements[] = {
3136 { "threads", NULL, threads_children,
3137 GDB_XML_EF_NONE, NULL, NULL },
3138 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3143 /* List remote threads using qXfer:threads:read. */
3146 remote_get_threads_with_qxfer (struct target_ops *ops,
3147 struct threads_listing_context *context)
3149 #if defined(HAVE_LIBEXPAT)
3150 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
3152 gdb::unique_xmalloc_ptr<char> xml
3153 = target_read_stralloc (ops, TARGET_OBJECT_THREADS, NULL);
3155 if (xml != NULL && *xml != '\0')
3157 gdb_xml_parse_quick (_("threads"), "threads.dtd",
3158 threads_elements, xml.get (), context);
3168 /* List remote threads using qfThreadInfo/qsThreadInfo. */
3171 remote_get_threads_with_qthreadinfo (struct target_ops *ops,
3172 struct threads_listing_context *context)
3174 struct remote_state *rs = get_remote_state ();
3176 if (rs->use_threadinfo_query)
3180 putpkt ("qfThreadInfo");
3181 getpkt (&rs->buf, &rs->buf_size, 0);
3183 if (bufp[0] != '\0') /* q packet recognized */
3185 while (*bufp++ == 'm') /* reply contains one or more TID */
3189 ptid_t ptid = read_ptid (bufp, &bufp);
3190 context->items.emplace_back (ptid);
3192 while (*bufp++ == ','); /* comma-separated list */
3193 putpkt ("qsThreadInfo");
3194 getpkt (&rs->buf, &rs->buf_size, 0);
3201 /* Packet not recognized. */
3202 rs->use_threadinfo_query = 0;
3209 /* Implement the to_update_thread_list function for the remote
3213 remote_update_thread_list (struct target_ops *ops)
3215 struct threads_listing_context context;
3218 /* We have a few different mechanisms to fetch the thread list. Try
3219 them all, starting with the most preferred one first, falling
3220 back to older methods. */
3221 if (remote_get_threads_with_qxfer (ops, &context)
3222 || remote_get_threads_with_qthreadinfo (ops, &context)
3223 || remote_get_threads_with_ql (ops, &context))
3226 struct thread_info *tp, *tmp;
3230 if (context.items.empty ()
3231 && remote_thread_always_alive (ops, inferior_ptid))
3233 /* Some targets don't really support threads, but still
3234 reply an (empty) thread list in response to the thread
3235 listing packets, instead of replying "packet not
3236 supported". Exit early so we don't delete the main
3241 /* CONTEXT now holds the current thread list on the remote
3242 target end. Delete GDB-side threads no longer found on the
3244 ALL_THREADS_SAFE (tp, tmp)
3246 if (!context.contains_thread (tp->ptid))
3249 delete_thread (tp->ptid);
3253 /* Remove any unreported fork child threads from CONTEXT so
3254 that we don't interfere with follow fork, which is where
3255 creation of such threads is handled. */
3256 remove_new_fork_children (&context);
3258 /* And now add threads we don't know about yet to our list. */
3259 for (thread_item &item : context.items)
3261 if (item.ptid != null_ptid)
3263 /* In non-stop mode, we assume new found threads are
3264 executing until proven otherwise with a stop reply.
3265 In all-stop, we can only get here if all threads are
3267 int executing = target_is_non_stop_p () ? 1 : 0;
3269 remote_notice_new_inferior (item.ptid, executing);
3271 remote_thread_info *info = get_remote_thread_info (item.ptid);
3272 info->core = item.core;
3273 info->extra = std::move (item.extra);
3274 info->name = std::move (item.name);
3275 info->thread_handle = std::move (item.thread_handle);
3282 /* If no thread listing method is supported, then query whether
3283 each known thread is alive, one by one, with the T packet.
3284 If the target doesn't support threads at all, then this is a
3285 no-op. See remote_thread_alive. */
3291 * Collect a descriptive string about the given thread.
3292 * The target may say anything it wants to about the thread
3293 * (typically info about its blocked / runnable state, name, etc.).
3294 * This string will appear in the info threads display.
3296 * Optional: targets are not required to implement this function.
3300 remote_threads_extra_info (struct target_ops *self, struct thread_info *tp)
3302 struct remote_state *rs = get_remote_state ();
3306 struct gdb_ext_thread_info threadinfo;
3307 static char display_buf[100]; /* arbitrary... */
3308 int n = 0; /* position in display_buf */
3310 if (rs->remote_desc == 0) /* paranoia */
3311 internal_error (__FILE__, __LINE__,
3312 _("remote_threads_extra_info"));
3314 if (ptid_equal (tp->ptid, magic_null_ptid)
3315 || (ptid_get_pid (tp->ptid) != 0 && ptid_get_lwp (tp->ptid) == 0))
3316 /* This is the main thread which was added by GDB. The remote
3317 server doesn't know about it. */
3320 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
3322 struct thread_info *info = find_thread_ptid (tp->ptid);
3324 if (info != NULL && info->priv != NULL)
3325 return get_remote_thread_info (info)->extra.c_str ();
3330 if (rs->use_threadextra_query)
3333 char *endb = rs->buf + get_remote_packet_size ();
3335 xsnprintf (b, endb - b, "qThreadExtraInfo,");
3337 write_ptid (b, endb, tp->ptid);
3340 getpkt (&rs->buf, &rs->buf_size, 0);
3341 if (rs->buf[0] != 0)
3343 n = std::min (strlen (rs->buf) / 2, sizeof (display_buf));
3344 result = hex2bin (rs->buf, (gdb_byte *) display_buf, n);
3345 display_buf [result] = '\0';
3350 /* If the above query fails, fall back to the old method. */
3351 rs->use_threadextra_query = 0;
3352 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
3353 | TAG_MOREDISPLAY | TAG_DISPLAY;
3354 int_to_threadref (&id, ptid_get_lwp (tp->ptid));
3355 if (remote_get_threadinfo (&id, set, &threadinfo))
3356 if (threadinfo.active)
3358 if (*threadinfo.shortname)
3359 n += xsnprintf (&display_buf[0], sizeof (display_buf) - n,
3360 " Name: %s,", threadinfo.shortname);
3361 if (*threadinfo.display)
3362 n += xsnprintf (&display_buf[n], sizeof (display_buf) - n,
3363 " State: %s,", threadinfo.display);
3364 if (*threadinfo.more_display)
3365 n += xsnprintf (&display_buf[n], sizeof (display_buf) - n,
3366 " Priority: %s", threadinfo.more_display);
3370 /* For purely cosmetic reasons, clear up trailing commas. */
3371 if (',' == display_buf[n-1])
3372 display_buf[n-1] = ' ';
3381 remote_static_tracepoint_marker_at (struct target_ops *self, CORE_ADDR addr,
3382 struct static_tracepoint_marker *marker)
3384 struct remote_state *rs = get_remote_state ();
3387 xsnprintf (p, get_remote_packet_size (), "qTSTMat:");
3389 p += hexnumstr (p, addr);
3391 getpkt (&rs->buf, &rs->buf_size, 0);
3395 error (_("Remote failure reply: %s"), p);
3399 parse_static_tracepoint_marker_definition (p, NULL, marker);
3406 static VEC(static_tracepoint_marker_p) *
3407 remote_static_tracepoint_markers_by_strid (struct target_ops *self,
3410 struct remote_state *rs = get_remote_state ();
3411 VEC(static_tracepoint_marker_p) *markers = NULL;
3412 struct static_tracepoint_marker *marker = NULL;
3413 struct cleanup *old_chain;
3416 /* Ask for a first packet of static tracepoint marker
3419 getpkt (&rs->buf, &rs->buf_size, 0);
3422 error (_("Remote failure reply: %s"), p);
3424 old_chain = make_cleanup (free_current_marker, &marker);
3429 marker = XCNEW (struct static_tracepoint_marker);
3433 parse_static_tracepoint_marker_definition (p, &p, marker);
3435 if (strid == NULL || strcmp (strid, marker->str_id) == 0)
3437 VEC_safe_push (static_tracepoint_marker_p,
3443 release_static_tracepoint_marker (marker);
3444 memset (marker, 0, sizeof (*marker));
3447 while (*p++ == ','); /* comma-separated list */
3448 /* Ask for another packet of static tracepoint definition. */
3450 getpkt (&rs->buf, &rs->buf_size, 0);
3454 do_cleanups (old_chain);
3459 /* Implement the to_get_ada_task_ptid function for the remote targets. */
3462 remote_get_ada_task_ptid (struct target_ops *self, long lwp, long thread)
3464 return ptid_build (ptid_get_pid (inferior_ptid), lwp, 0);
3468 /* Restart the remote side; this is an extended protocol operation. */
3471 extended_remote_restart (void)
3473 struct remote_state *rs = get_remote_state ();
3475 /* Send the restart command; for reasons I don't understand the
3476 remote side really expects a number after the "R". */
3477 xsnprintf (rs->buf, get_remote_packet_size (), "R%x", 0);
3480 remote_fileio_reset ();
3483 /* Clean up connection to a remote debugger. */
3486 remote_close (struct target_ops *self)
3488 struct remote_state *rs = get_remote_state ();
3490 if (rs->remote_desc == NULL)
3491 return; /* already closed */
3493 /* Make sure we leave stdin registered in the event loop. */
3494 remote_terminal_ours (self);
3496 serial_close (rs->remote_desc);
3497 rs->remote_desc = NULL;
3499 /* We don't have a connection to the remote stub anymore. Get rid
3500 of all the inferiors and their threads we were controlling.
3501 Reset inferior_ptid to null_ptid first, as otherwise has_stack_frame
3502 will be unable to find the thread corresponding to (pid, 0, 0). */
3503 inferior_ptid = null_ptid;
3504 discard_all_inferiors ();
3506 /* We are closing the remote target, so we should discard
3507 everything of this target. */
3508 discard_pending_stop_replies_in_queue (rs);
3510 if (remote_async_inferior_event_token)
3511 delete_async_event_handler (&remote_async_inferior_event_token);
3513 remote_notif_state_xfree (rs->notif_state);
3515 trace_reset_local_state ();
3518 /* Query the remote side for the text, data and bss offsets. */
3523 struct remote_state *rs = get_remote_state ();
3526 int lose, num_segments = 0, do_sections, do_segments;
3527 CORE_ADDR text_addr, data_addr, bss_addr, segments[2];
3528 struct section_offsets *offs;
3529 struct symfile_segment_data *data;
3531 if (symfile_objfile == NULL)
3534 putpkt ("qOffsets");
3535 getpkt (&rs->buf, &rs->buf_size, 0);
3538 if (buf[0] == '\000')
3539 return; /* Return silently. Stub doesn't support
3543 warning (_("Remote failure reply: %s"), buf);
3547 /* Pick up each field in turn. This used to be done with scanf, but
3548 scanf will make trouble if CORE_ADDR size doesn't match
3549 conversion directives correctly. The following code will work
3550 with any size of CORE_ADDR. */
3551 text_addr = data_addr = bss_addr = 0;
3555 if (startswith (ptr, "Text="))
3558 /* Don't use strtol, could lose on big values. */
3559 while (*ptr && *ptr != ';')
3560 text_addr = (text_addr << 4) + fromhex (*ptr++);
3562 if (startswith (ptr, ";Data="))
3565 while (*ptr && *ptr != ';')
3566 data_addr = (data_addr << 4) + fromhex (*ptr++);
3571 if (!lose && startswith (ptr, ";Bss="))
3574 while (*ptr && *ptr != ';')
3575 bss_addr = (bss_addr << 4) + fromhex (*ptr++);
3577 if (bss_addr != data_addr)
3578 warning (_("Target reported unsupported offsets: %s"), buf);
3583 else if (startswith (ptr, "TextSeg="))
3586 /* Don't use strtol, could lose on big values. */
3587 while (*ptr && *ptr != ';')
3588 text_addr = (text_addr << 4) + fromhex (*ptr++);
3591 if (startswith (ptr, ";DataSeg="))
3594 while (*ptr && *ptr != ';')
3595 data_addr = (data_addr << 4) + fromhex (*ptr++);
3603 error (_("Malformed response to offset query, %s"), buf);
3604 else if (*ptr != '\0')
3605 warning (_("Target reported unsupported offsets: %s"), buf);
3607 offs = ((struct section_offsets *)
3608 alloca (SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections)));
3609 memcpy (offs, symfile_objfile->section_offsets,
3610 SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections));
3612 data = get_symfile_segment_data (symfile_objfile->obfd);
3613 do_segments = (data != NULL);
3614 do_sections = num_segments == 0;
3616 if (num_segments > 0)
3618 segments[0] = text_addr;
3619 segments[1] = data_addr;
3621 /* If we have two segments, we can still try to relocate everything
3622 by assuming that the .text and .data offsets apply to the whole
3623 text and data segments. Convert the offsets given in the packet
3624 to base addresses for symfile_map_offsets_to_segments. */
3625 else if (data && data->num_segments == 2)
3627 segments[0] = data->segment_bases[0] + text_addr;
3628 segments[1] = data->segment_bases[1] + data_addr;
3631 /* If the object file has only one segment, assume that it is text
3632 rather than data; main programs with no writable data are rare,
3633 but programs with no code are useless. Of course the code might
3634 have ended up in the data segment... to detect that we would need
3635 the permissions here. */
3636 else if (data && data->num_segments == 1)
3638 segments[0] = data->segment_bases[0] + text_addr;
3641 /* There's no way to relocate by segment. */
3647 int ret = symfile_map_offsets_to_segments (symfile_objfile->obfd, data,
3648 offs, num_segments, segments);
3650 if (ret == 0 && !do_sections)
3651 error (_("Can not handle qOffsets TextSeg "
3652 "response with this symbol file"));
3659 free_symfile_segment_data (data);
3663 offs->offsets[SECT_OFF_TEXT (symfile_objfile)] = text_addr;
3665 /* This is a temporary kludge to force data and bss to use the
3666 same offsets because that's what nlmconv does now. The real
3667 solution requires changes to the stub and remote.c that I
3668 don't have time to do right now. */
3670 offs->offsets[SECT_OFF_DATA (symfile_objfile)] = data_addr;
3671 offs->offsets[SECT_OFF_BSS (symfile_objfile)] = data_addr;
3674 objfile_relocate (symfile_objfile, offs);
3677 /* Send interrupt_sequence to remote target. */
3679 send_interrupt_sequence (void)
3681 struct remote_state *rs = get_remote_state ();
3683 if (interrupt_sequence_mode == interrupt_sequence_control_c)
3684 remote_serial_write ("\x03", 1);
3685 else if (interrupt_sequence_mode == interrupt_sequence_break)
3686 serial_send_break (rs->remote_desc);
3687 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
3689 serial_send_break (rs->remote_desc);
3690 remote_serial_write ("g", 1);
3693 internal_error (__FILE__, __LINE__,
3694 _("Invalid value for interrupt_sequence_mode: %s."),
3695 interrupt_sequence_mode);
3699 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
3700 and extract the PTID. Returns NULL_PTID if not found. */
3703 stop_reply_extract_thread (char *stop_reply)
3705 if (stop_reply[0] == 'T' && strlen (stop_reply) > 3)
3709 /* Txx r:val ; r:val (...) */
3712 /* Look for "register" named "thread". */
3717 p1 = strchr (p, ':');
3721 if (strncmp (p, "thread", p1 - p) == 0)
3722 return read_ptid (++p1, &p);
3724 p1 = strchr (p, ';');
3736 /* Determine the remote side's current thread. If we have a stop
3737 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
3738 "thread" register we can extract the current thread from. If not,
3739 ask the remote which is the current thread with qC. The former
3740 method avoids a roundtrip. */
3743 get_current_thread (char *wait_status)
3745 ptid_t ptid = null_ptid;
3747 /* Note we don't use remote_parse_stop_reply as that makes use of
3748 the target architecture, which we haven't yet fully determined at
3750 if (wait_status != NULL)
3751 ptid = stop_reply_extract_thread (wait_status);
3752 if (ptid_equal (ptid, null_ptid))
3753 ptid = remote_current_thread (inferior_ptid);
3758 /* Query the remote target for which is the current thread/process,
3759 add it to our tables, and update INFERIOR_PTID. The caller is
3760 responsible for setting the state such that the remote end is ready
3761 to return the current thread.
3763 This function is called after handling the '?' or 'vRun' packets,
3764 whose response is a stop reply from which we can also try
3765 extracting the thread. If the target doesn't support the explicit
3766 qC query, we infer the current thread from that stop reply, passed
3767 in in WAIT_STATUS, which may be NULL. */
3770 add_current_inferior_and_thread (char *wait_status)
3772 struct remote_state *rs = get_remote_state ();
3775 inferior_ptid = null_ptid;
3777 /* Now, if we have thread information, update inferior_ptid. */
3778 ptid_t curr_ptid = get_current_thread (wait_status);
3780 if (curr_ptid != null_ptid)
3782 if (!remote_multi_process_p (rs))
3787 /* Without this, some commands which require an active target
3788 (such as kill) won't work. This variable serves (at least)
3789 double duty as both the pid of the target process (if it has
3790 such), and as a flag indicating that a target is active. */
3791 curr_ptid = magic_null_ptid;
3795 remote_add_inferior (fake_pid_p, ptid_get_pid (curr_ptid), -1, 1);
3797 /* Add the main thread and switch to it. Don't try reading
3798 registers yet, since we haven't fetched the target description
3800 thread_info *tp = add_thread_silent (curr_ptid);
3801 switch_to_thread_no_regs (tp);
3804 /* Print info about a thread that was found already stopped on
3808 print_one_stopped_thread (struct thread_info *thread)
3810 struct target_waitstatus *ws = &thread->suspend.waitstatus;
3812 switch_to_thread (thread->ptid);
3813 stop_pc = get_frame_pc (get_current_frame ());
3814 set_current_sal_from_frame (get_current_frame ());
3816 thread->suspend.waitstatus_pending_p = 0;
3818 if (ws->kind == TARGET_WAITKIND_STOPPED)
3820 enum gdb_signal sig = ws->value.sig;
3822 if (signal_print_state (sig))
3823 observer_notify_signal_received (sig);
3825 observer_notify_normal_stop (NULL, 1);
3828 /* Process all initial stop replies the remote side sent in response
3829 to the ? packet. These indicate threads that were already stopped
3830 on initial connection. We mark these threads as stopped and print
3831 their current frame before giving the user the prompt. */
3834 process_initial_stop_replies (int from_tty)
3836 int pending_stop_replies = stop_reply_queue_length ();
3837 struct inferior *inf;
3838 struct thread_info *thread;
3839 struct thread_info *selected = NULL;
3840 struct thread_info *lowest_stopped = NULL;
3841 struct thread_info *first = NULL;
3843 /* Consume the initial pending events. */
3844 while (pending_stop_replies-- > 0)
3846 ptid_t waiton_ptid = minus_one_ptid;
3848 struct target_waitstatus ws;
3849 int ignore_event = 0;
3850 struct thread_info *thread;
3852 memset (&ws, 0, sizeof (ws));
3853 event_ptid = target_wait (waiton_ptid, &ws, TARGET_WNOHANG);
3855 print_target_wait_results (waiton_ptid, event_ptid, &ws);
3859 case TARGET_WAITKIND_IGNORE:
3860 case TARGET_WAITKIND_NO_RESUMED:
3861 case TARGET_WAITKIND_SIGNALLED:
3862 case TARGET_WAITKIND_EXITED:
3863 /* We shouldn't see these, but if we do, just ignore. */
3865 fprintf_unfiltered (gdb_stdlog, "remote: event ignored\n");
3869 case TARGET_WAITKIND_EXECD:
3870 xfree (ws.value.execd_pathname);
3879 thread = find_thread_ptid (event_ptid);
3881 if (ws.kind == TARGET_WAITKIND_STOPPED)
3883 enum gdb_signal sig = ws.value.sig;
3885 /* Stubs traditionally report SIGTRAP as initial signal,
3886 instead of signal 0. Suppress it. */
3887 if (sig == GDB_SIGNAL_TRAP)
3889 thread->suspend.stop_signal = sig;
3893 thread->suspend.waitstatus = ws;
3895 if (ws.kind != TARGET_WAITKIND_STOPPED
3896 || ws.value.sig != GDB_SIGNAL_0)
3897 thread->suspend.waitstatus_pending_p = 1;
3899 set_executing (event_ptid, 0);
3900 set_running (event_ptid, 0);
3901 get_remote_thread_info (thread)->vcont_resumed = 0;
3904 /* "Notice" the new inferiors before anything related to
3905 registers/memory. */
3911 inf->needs_setup = 1;
3915 thread = any_live_thread_of_process (inf->pid);
3916 notice_new_inferior (thread->ptid,
3917 thread->state == THREAD_RUNNING,
3922 /* If all-stop on top of non-stop, pause all threads. Note this
3923 records the threads' stop pc, so must be done after "noticing"
3927 stop_all_threads ();
3929 /* If all threads of an inferior were already stopped, we
3930 haven't setup the inferior yet. */
3936 if (inf->needs_setup)
3938 thread = any_live_thread_of_process (inf->pid);
3939 switch_to_thread_no_regs (thread);
3945 /* Now go over all threads that are stopped, and print their current
3946 frame. If all-stop, then if there's a signalled thread, pick
3948 ALL_NON_EXITED_THREADS (thread)
3954 set_running (thread->ptid, 0);
3955 else if (thread->state != THREAD_STOPPED)
3958 if (selected == NULL
3959 && thread->suspend.waitstatus_pending_p)
3962 if (lowest_stopped == NULL
3963 || thread->inf->num < lowest_stopped->inf->num
3964 || thread->per_inf_num < lowest_stopped->per_inf_num)
3965 lowest_stopped = thread;
3968 print_one_stopped_thread (thread);
3971 /* In all-stop, we only print the status of one thread, and leave
3972 others with their status pending. */
3977 thread = lowest_stopped;
3981 print_one_stopped_thread (thread);
3984 /* For "info program". */
3985 thread = inferior_thread ();
3986 if (thread->state == THREAD_STOPPED)
3987 set_last_target_status (inferior_ptid, thread->suspend.waitstatus);
3990 /* Start the remote connection and sync state. */
3993 remote_start_remote (int from_tty, struct target_ops *target, int extended_p)
3995 struct remote_state *rs = get_remote_state ();
3996 struct packet_config *noack_config;
3997 char *wait_status = NULL;
3999 /* Signal other parts that we're going through the initial setup,
4000 and so things may not be stable yet. E.g., we don't try to
4001 install tracepoints until we've relocated symbols. Also, a
4002 Ctrl-C before we're connected and synced up can't interrupt the
4003 target. Instead, it offers to drop the (potentially wedged)
4005 rs->starting_up = 1;
4009 if (interrupt_on_connect)
4010 send_interrupt_sequence ();
4012 /* Ack any packet which the remote side has already sent. */
4013 remote_serial_write ("+", 1);
4015 /* The first packet we send to the target is the optional "supported
4016 packets" request. If the target can answer this, it will tell us
4017 which later probes to skip. */
4018 remote_query_supported ();
4020 /* If the stub wants to get a QAllow, compose one and send it. */
4021 if (packet_support (PACKET_QAllow) != PACKET_DISABLE)
4022 remote_set_permissions (target);
4024 /* gdbserver < 7.7 (before its fix from 2013-12-11) did reply to any
4025 unknown 'v' packet with string "OK". "OK" gets interpreted by GDB
4026 as a reply to known packet. For packet "vFile:setfs:" it is an
4027 invalid reply and GDB would return error in
4028 remote_hostio_set_filesystem, making remote files access impossible.
4029 Disable "vFile:setfs:" in such case. Do not disable other 'v' packets as
4030 other "vFile" packets get correctly detected even on gdbserver < 7.7. */
4032 const char v_mustreplyempty[] = "vMustReplyEmpty";
4034 putpkt (v_mustreplyempty);
4035 getpkt (&rs->buf, &rs->buf_size, 0);
4036 if (strcmp (rs->buf, "OK") == 0)
4037 remote_protocol_packets[PACKET_vFile_setfs].support = PACKET_DISABLE;
4038 else if (strcmp (rs->buf, "") != 0)
4039 error (_("Remote replied unexpectedly to '%s': %s"), v_mustreplyempty,
4043 /* Next, we possibly activate noack mode.
4045 If the QStartNoAckMode packet configuration is set to AUTO,
4046 enable noack mode if the stub reported a wish for it with
4049 If set to TRUE, then enable noack mode even if the stub didn't
4050 report it in qSupported. If the stub doesn't reply OK, the
4051 session ends with an error.
4053 If FALSE, then don't activate noack mode, regardless of what the
4054 stub claimed should be the default with qSupported. */
4056 noack_config = &remote_protocol_packets[PACKET_QStartNoAckMode];
4057 if (packet_config_support (noack_config) != PACKET_DISABLE)
4059 putpkt ("QStartNoAckMode");
4060 getpkt (&rs->buf, &rs->buf_size, 0);
4061 if (packet_ok (rs->buf, noack_config) == PACKET_OK)
4067 /* Tell the remote that we are using the extended protocol. */
4069 getpkt (&rs->buf, &rs->buf_size, 0);
4072 /* Let the target know which signals it is allowed to pass down to
4074 update_signals_program_target ();
4076 /* Next, if the target can specify a description, read it. We do
4077 this before anything involving memory or registers. */
4078 target_find_description ();
4080 /* Next, now that we know something about the target, update the
4081 address spaces in the program spaces. */
4082 update_address_spaces ();
4084 /* On OSs where the list of libraries is global to all
4085 processes, we fetch them early. */
4086 if (gdbarch_has_global_solist (target_gdbarch ()))
4087 solib_add (NULL, from_tty, auto_solib_add);
4089 if (target_is_non_stop_p ())
4091 if (packet_support (PACKET_QNonStop) != PACKET_ENABLE)
4092 error (_("Non-stop mode requested, but remote "
4093 "does not support non-stop"));
4095 putpkt ("QNonStop:1");
4096 getpkt (&rs->buf, &rs->buf_size, 0);
4098 if (strcmp (rs->buf, "OK") != 0)
4099 error (_("Remote refused setting non-stop mode with: %s"), rs->buf);
4101 /* Find about threads and processes the stub is already
4102 controlling. We default to adding them in the running state.
4103 The '?' query below will then tell us about which threads are
4105 remote_update_thread_list (target);
4107 else if (packet_support (PACKET_QNonStop) == PACKET_ENABLE)
4109 /* Don't assume that the stub can operate in all-stop mode.
4110 Request it explicitly. */
4111 putpkt ("QNonStop:0");
4112 getpkt (&rs->buf, &rs->buf_size, 0);
4114 if (strcmp (rs->buf, "OK") != 0)
4115 error (_("Remote refused setting all-stop mode with: %s"), rs->buf);
4118 /* Upload TSVs regardless of whether the target is running or not. The
4119 remote stub, such as GDBserver, may have some predefined or builtin
4120 TSVs, even if the target is not running. */
4121 if (remote_get_trace_status (target, current_trace_status ()) != -1)
4123 struct uploaded_tsv *uploaded_tsvs = NULL;
4125 remote_upload_trace_state_variables (target, &uploaded_tsvs);
4126 merge_uploaded_trace_state_variables (&uploaded_tsvs);
4129 /* Check whether the target is running now. */
4131 getpkt (&rs->buf, &rs->buf_size, 0);
4133 if (!target_is_non_stop_p ())
4135 if (rs->buf[0] == 'W' || rs->buf[0] == 'X')
4138 error (_("The target is not running (try extended-remote?)"));
4140 /* We're connected, but not running. Drop out before we
4141 call start_remote. */
4142 rs->starting_up = 0;
4147 /* Save the reply for later. */
4148 wait_status = (char *) alloca (strlen (rs->buf) + 1);
4149 strcpy (wait_status, rs->buf);
4152 /* Fetch thread list. */
4153 target_update_thread_list ();
4155 /* Let the stub know that we want it to return the thread. */
4156 set_continue_thread (minus_one_ptid);
4158 if (thread_count () == 0)
4160 /* Target has no concept of threads at all. GDB treats
4161 non-threaded target as single-threaded; add a main
4163 add_current_inferior_and_thread (wait_status);
4167 /* We have thread information; select the thread the target
4168 says should be current. If we're reconnecting to a
4169 multi-threaded program, this will ideally be the thread
4170 that last reported an event before GDB disconnected. */
4171 inferior_ptid = get_current_thread (wait_status);
4172 if (ptid_equal (inferior_ptid, null_ptid))
4174 /* Odd... The target was able to list threads, but not
4175 tell us which thread was current (no "thread"
4176 register in T stop reply?). Just pick the first
4177 thread in the thread list then. */
4180 fprintf_unfiltered (gdb_stdlog,
4181 "warning: couldn't determine remote "
4182 "current thread; picking first in list.\n");
4184 inferior_ptid = thread_list->ptid;
4188 /* init_wait_for_inferior should be called before get_offsets in order
4189 to manage `inserted' flag in bp loc in a correct state.
4190 breakpoint_init_inferior, called from init_wait_for_inferior, set
4191 `inserted' flag to 0, while before breakpoint_re_set, called from
4192 start_remote, set `inserted' flag to 1. In the initialization of
4193 inferior, breakpoint_init_inferior should be called first, and then
4194 breakpoint_re_set can be called. If this order is broken, state of
4195 `inserted' flag is wrong, and cause some problems on breakpoint
4197 init_wait_for_inferior ();
4199 get_offsets (); /* Get text, data & bss offsets. */
4201 /* If we could not find a description using qXfer, and we know
4202 how to do it some other way, try again. This is not
4203 supported for non-stop; it could be, but it is tricky if
4204 there are no stopped threads when we connect. */
4205 if (remote_read_description_p (target)
4206 && gdbarch_target_desc (target_gdbarch ()) == NULL)
4208 target_clear_description ();
4209 target_find_description ();
4212 /* Use the previously fetched status. */
4213 gdb_assert (wait_status != NULL);
4214 strcpy (rs->buf, wait_status);
4215 rs->cached_wait_status = 1;
4217 start_remote (from_tty); /* Initialize gdb process mechanisms. */
4221 /* Clear WFI global state. Do this before finding about new
4222 threads and inferiors, and setting the current inferior.
4223 Otherwise we would clear the proceed status of the current
4224 inferior when we want its stop_soon state to be preserved
4225 (see notice_new_inferior). */
4226 init_wait_for_inferior ();
4228 /* In non-stop, we will either get an "OK", meaning that there
4229 are no stopped threads at this time; or, a regular stop
4230 reply. In the latter case, there may be more than one thread
4231 stopped --- we pull them all out using the vStopped
4233 if (strcmp (rs->buf, "OK") != 0)
4235 struct notif_client *notif = ¬if_client_stop;
4237 /* remote_notif_get_pending_replies acks this one, and gets
4239 rs->notif_state->pending_event[notif_client_stop.id]
4240 = remote_notif_parse (notif, rs->buf);
4241 remote_notif_get_pending_events (notif);
4244 if (thread_count () == 0)
4247 error (_("The target is not running (try extended-remote?)"));
4249 /* We're connected, but not running. Drop out before we
4250 call start_remote. */
4251 rs->starting_up = 0;
4255 /* In non-stop mode, any cached wait status will be stored in
4256 the stop reply queue. */
4257 gdb_assert (wait_status == NULL);
4259 /* Report all signals during attach/startup. */
4260 remote_pass_signals (target, 0, NULL);
4262 /* If there are already stopped threads, mark them stopped and
4263 report their stops before giving the prompt to the user. */
4264 process_initial_stop_replies (from_tty);
4266 if (target_can_async_p ())
4270 /* If we connected to a live target, do some additional setup. */
4271 if (target_has_execution)
4273 if (symfile_objfile) /* No use without a symbol-file. */
4274 remote_check_symbols ();
4277 /* Possibly the target has been engaged in a trace run started
4278 previously; find out where things are at. */
4279 if (remote_get_trace_status (target, current_trace_status ()) != -1)
4281 struct uploaded_tp *uploaded_tps = NULL;
4283 if (current_trace_status ()->running)
4284 printf_filtered (_("Trace is already running on the target.\n"));
4286 remote_upload_tracepoints (target, &uploaded_tps);
4288 merge_uploaded_tracepoints (&uploaded_tps);
4291 /* Possibly the target has been engaged in a btrace record started
4292 previously; find out where things are at. */
4293 remote_btrace_maybe_reopen ();
4295 /* The thread and inferior lists are now synchronized with the
4296 target, our symbols have been relocated, and we're merged the
4297 target's tracepoints with ours. We're done with basic start
4299 rs->starting_up = 0;
4301 /* Maybe breakpoints are global and need to be inserted now. */
4302 if (breakpoints_should_be_inserted_now ())
4303 insert_breakpoints ();
4306 /* Open a connection to a remote debugger.
4307 NAME is the filename used for communication. */
4310 remote_open (const char *name, int from_tty)
4312 remote_open_1 (name, from_tty, &remote_ops, 0);
4315 /* Open a connection to a remote debugger using the extended
4316 remote gdb protocol. NAME is the filename used for communication. */
4319 extended_remote_open (const char *name, int from_tty)
4321 remote_open_1 (name, from_tty, &extended_remote_ops, 1 /*extended_p */);
4324 /* Reset all packets back to "unknown support". Called when opening a
4325 new connection to a remote target. */
4328 reset_all_packet_configs_support (void)
4332 for (i = 0; i < PACKET_MAX; i++)
4333 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
4336 /* Initialize all packet configs. */
4339 init_all_packet_configs (void)
4343 for (i = 0; i < PACKET_MAX; i++)
4345 remote_protocol_packets[i].detect = AUTO_BOOLEAN_AUTO;
4346 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
4350 /* Symbol look-up. */
4353 remote_check_symbols (void)
4355 struct remote_state *rs = get_remote_state ();
4356 char *msg, *reply, *tmp;
4359 struct cleanup *old_chain;
4361 /* The remote side has no concept of inferiors that aren't running
4362 yet, it only knows about running processes. If we're connected
4363 but our current inferior is not running, we should not invite the
4364 remote target to request symbol lookups related to its
4365 (unrelated) current process. */
4366 if (!target_has_execution)
4369 if (packet_support (PACKET_qSymbol) == PACKET_DISABLE)
4372 /* Make sure the remote is pointing at the right process. Note
4373 there's no way to select "no process". */
4374 set_general_process ();
4376 /* Allocate a message buffer. We can't reuse the input buffer in RS,
4377 because we need both at the same time. */
4378 msg = (char *) xmalloc (get_remote_packet_size ());
4379 old_chain = make_cleanup (xfree, msg);
4380 reply = (char *) xmalloc (get_remote_packet_size ());
4381 make_cleanup (free_current_contents, &reply);
4382 reply_size = get_remote_packet_size ();
4384 /* Invite target to request symbol lookups. */
4386 putpkt ("qSymbol::");
4387 getpkt (&reply, &reply_size, 0);
4388 packet_ok (reply, &remote_protocol_packets[PACKET_qSymbol]);
4390 while (startswith (reply, "qSymbol:"))
4392 struct bound_minimal_symbol sym;
4395 end = hex2bin (tmp, (gdb_byte *) msg, strlen (tmp) / 2);
4397 sym = lookup_minimal_symbol (msg, NULL, NULL);
4398 if (sym.minsym == NULL)
4399 xsnprintf (msg, get_remote_packet_size (), "qSymbol::%s", &reply[8]);
4402 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
4403 CORE_ADDR sym_addr = BMSYMBOL_VALUE_ADDRESS (sym);
4405 /* If this is a function address, return the start of code
4406 instead of any data function descriptor. */
4407 sym_addr = gdbarch_convert_from_func_ptr_addr (target_gdbarch (),
4411 xsnprintf (msg, get_remote_packet_size (), "qSymbol:%s:%s",
4412 phex_nz (sym_addr, addr_size), &reply[8]);
4416 getpkt (&reply, &reply_size, 0);
4419 do_cleanups (old_chain);
4422 static struct serial *
4423 remote_serial_open (const char *name)
4425 static int udp_warning = 0;
4427 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
4428 of in ser-tcp.c, because it is the remote protocol assuming that the
4429 serial connection is reliable and not the serial connection promising
4431 if (!udp_warning && startswith (name, "udp:"))
4433 warning (_("The remote protocol may be unreliable over UDP.\n"
4434 "Some events may be lost, rendering further debugging "
4439 return serial_open (name);
4442 /* Inform the target of our permission settings. The permission flags
4443 work without this, but if the target knows the settings, it can do
4444 a couple things. First, it can add its own check, to catch cases
4445 that somehow manage to get by the permissions checks in target
4446 methods. Second, if the target is wired to disallow particular
4447 settings (for instance, a system in the field that is not set up to
4448 be able to stop at a breakpoint), it can object to any unavailable
4452 remote_set_permissions (struct target_ops *self)
4454 struct remote_state *rs = get_remote_state ();
4456 xsnprintf (rs->buf, get_remote_packet_size (), "QAllow:"
4457 "WriteReg:%x;WriteMem:%x;"
4458 "InsertBreak:%x;InsertTrace:%x;"
4459 "InsertFastTrace:%x;Stop:%x",
4460 may_write_registers, may_write_memory,
4461 may_insert_breakpoints, may_insert_tracepoints,
4462 may_insert_fast_tracepoints, may_stop);
4464 getpkt (&rs->buf, &rs->buf_size, 0);
4466 /* If the target didn't like the packet, warn the user. Do not try
4467 to undo the user's settings, that would just be maddening. */
4468 if (strcmp (rs->buf, "OK") != 0)
4469 warning (_("Remote refused setting permissions with: %s"), rs->buf);
4472 /* This type describes each known response to the qSupported
4474 struct protocol_feature
4476 /* The name of this protocol feature. */
4479 /* The default for this protocol feature. */
4480 enum packet_support default_support;
4482 /* The function to call when this feature is reported, or after
4483 qSupported processing if the feature is not supported.
4484 The first argument points to this structure. The second
4485 argument indicates whether the packet requested support be
4486 enabled, disabled, or probed (or the default, if this function
4487 is being called at the end of processing and this feature was
4488 not reported). The third argument may be NULL; if not NULL, it
4489 is a NUL-terminated string taken from the packet following
4490 this feature's name and an equals sign. */
4491 void (*func) (const struct protocol_feature *, enum packet_support,
4494 /* The corresponding packet for this feature. Only used if
4495 FUNC is remote_supported_packet. */
4500 remote_supported_packet (const struct protocol_feature *feature,
4501 enum packet_support support,
4502 const char *argument)
4506 warning (_("Remote qSupported response supplied an unexpected value for"
4507 " \"%s\"."), feature->name);
4511 remote_protocol_packets[feature->packet].support = support;
4515 remote_packet_size (const struct protocol_feature *feature,
4516 enum packet_support support, const char *value)
4518 struct remote_state *rs = get_remote_state ();
4523 if (support != PACKET_ENABLE)
4526 if (value == NULL || *value == '\0')
4528 warning (_("Remote target reported \"%s\" without a size."),
4534 packet_size = strtol (value, &value_end, 16);
4535 if (errno != 0 || *value_end != '\0' || packet_size < 0)
4537 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
4538 feature->name, value);
4542 /* Record the new maximum packet size. */
4543 rs->explicit_packet_size = packet_size;
4546 static const struct protocol_feature remote_protocol_features[] = {
4547 { "PacketSize", PACKET_DISABLE, remote_packet_size, -1 },
4548 { "qXfer:auxv:read", PACKET_DISABLE, remote_supported_packet,
4549 PACKET_qXfer_auxv },
4550 { "qXfer:exec-file:read", PACKET_DISABLE, remote_supported_packet,
4551 PACKET_qXfer_exec_file },
4552 { "qXfer:features:read", PACKET_DISABLE, remote_supported_packet,
4553 PACKET_qXfer_features },
4554 { "qXfer:libraries:read", PACKET_DISABLE, remote_supported_packet,
4555 PACKET_qXfer_libraries },
4556 { "qXfer:libraries-svr4:read", PACKET_DISABLE, remote_supported_packet,
4557 PACKET_qXfer_libraries_svr4 },
4558 { "augmented-libraries-svr4-read", PACKET_DISABLE,
4559 remote_supported_packet, PACKET_augmented_libraries_svr4_read_feature },
4560 { "qXfer:memory-map:read", PACKET_DISABLE, remote_supported_packet,
4561 PACKET_qXfer_memory_map },
4562 { "qXfer:spu:read", PACKET_DISABLE, remote_supported_packet,
4563 PACKET_qXfer_spu_read },
4564 { "qXfer:spu:write", PACKET_DISABLE, remote_supported_packet,
4565 PACKET_qXfer_spu_write },
4566 { "qXfer:osdata:read", PACKET_DISABLE, remote_supported_packet,
4567 PACKET_qXfer_osdata },
4568 { "qXfer:threads:read", PACKET_DISABLE, remote_supported_packet,
4569 PACKET_qXfer_threads },
4570 { "qXfer:traceframe-info:read", PACKET_DISABLE, remote_supported_packet,
4571 PACKET_qXfer_traceframe_info },
4572 { "QPassSignals", PACKET_DISABLE, remote_supported_packet,
4573 PACKET_QPassSignals },
4574 { "QCatchSyscalls", PACKET_DISABLE, remote_supported_packet,
4575 PACKET_QCatchSyscalls },
4576 { "QProgramSignals", PACKET_DISABLE, remote_supported_packet,
4577 PACKET_QProgramSignals },
4578 { "QSetWorkingDir", PACKET_DISABLE, remote_supported_packet,
4579 PACKET_QSetWorkingDir },
4580 { "QStartupWithShell", PACKET_DISABLE, remote_supported_packet,
4581 PACKET_QStartupWithShell },
4582 { "QEnvironmentHexEncoded", PACKET_DISABLE, remote_supported_packet,
4583 PACKET_QEnvironmentHexEncoded },
4584 { "QEnvironmentReset", PACKET_DISABLE, remote_supported_packet,
4585 PACKET_QEnvironmentReset },
4586 { "QEnvironmentUnset", PACKET_DISABLE, remote_supported_packet,
4587 PACKET_QEnvironmentUnset },
4588 { "QStartNoAckMode", PACKET_DISABLE, remote_supported_packet,
4589 PACKET_QStartNoAckMode },
4590 { "multiprocess", PACKET_DISABLE, remote_supported_packet,
4591 PACKET_multiprocess_feature },
4592 { "QNonStop", PACKET_DISABLE, remote_supported_packet, PACKET_QNonStop },
4593 { "qXfer:siginfo:read", PACKET_DISABLE, remote_supported_packet,
4594 PACKET_qXfer_siginfo_read },
4595 { "qXfer:siginfo:write", PACKET_DISABLE, remote_supported_packet,
4596 PACKET_qXfer_siginfo_write },
4597 { "ConditionalTracepoints", PACKET_DISABLE, remote_supported_packet,
4598 PACKET_ConditionalTracepoints },
4599 { "ConditionalBreakpoints", PACKET_DISABLE, remote_supported_packet,
4600 PACKET_ConditionalBreakpoints },
4601 { "BreakpointCommands", PACKET_DISABLE, remote_supported_packet,
4602 PACKET_BreakpointCommands },
4603 { "FastTracepoints", PACKET_DISABLE, remote_supported_packet,
4604 PACKET_FastTracepoints },
4605 { "StaticTracepoints", PACKET_DISABLE, remote_supported_packet,
4606 PACKET_StaticTracepoints },
4607 {"InstallInTrace", PACKET_DISABLE, remote_supported_packet,
4608 PACKET_InstallInTrace},
4609 { "DisconnectedTracing", PACKET_DISABLE, remote_supported_packet,
4610 PACKET_DisconnectedTracing_feature },
4611 { "ReverseContinue", PACKET_DISABLE, remote_supported_packet,
4613 { "ReverseStep", PACKET_DISABLE, remote_supported_packet,
4615 { "TracepointSource", PACKET_DISABLE, remote_supported_packet,
4616 PACKET_TracepointSource },
4617 { "QAllow", PACKET_DISABLE, remote_supported_packet,
4619 { "EnableDisableTracepoints", PACKET_DISABLE, remote_supported_packet,
4620 PACKET_EnableDisableTracepoints_feature },
4621 { "qXfer:fdpic:read", PACKET_DISABLE, remote_supported_packet,
4622 PACKET_qXfer_fdpic },
4623 { "qXfer:uib:read", PACKET_DISABLE, remote_supported_packet,
4625 { "QDisableRandomization", PACKET_DISABLE, remote_supported_packet,
4626 PACKET_QDisableRandomization },
4627 { "QAgent", PACKET_DISABLE, remote_supported_packet, PACKET_QAgent},
4628 { "QTBuffer:size", PACKET_DISABLE,
4629 remote_supported_packet, PACKET_QTBuffer_size},
4630 { "tracenz", PACKET_DISABLE, remote_supported_packet, PACKET_tracenz_feature },
4631 { "Qbtrace:off", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_off },
4632 { "Qbtrace:bts", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_bts },
4633 { "Qbtrace:pt", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_pt },
4634 { "qXfer:btrace:read", PACKET_DISABLE, remote_supported_packet,
4635 PACKET_qXfer_btrace },
4636 { "qXfer:btrace-conf:read", PACKET_DISABLE, remote_supported_packet,
4637 PACKET_qXfer_btrace_conf },
4638 { "Qbtrace-conf:bts:size", PACKET_DISABLE, remote_supported_packet,
4639 PACKET_Qbtrace_conf_bts_size },
4640 { "swbreak", PACKET_DISABLE, remote_supported_packet, PACKET_swbreak_feature },
4641 { "hwbreak", PACKET_DISABLE, remote_supported_packet, PACKET_hwbreak_feature },
4642 { "fork-events", PACKET_DISABLE, remote_supported_packet,
4643 PACKET_fork_event_feature },
4644 { "vfork-events", PACKET_DISABLE, remote_supported_packet,
4645 PACKET_vfork_event_feature },
4646 { "exec-events", PACKET_DISABLE, remote_supported_packet,
4647 PACKET_exec_event_feature },
4648 { "Qbtrace-conf:pt:size", PACKET_DISABLE, remote_supported_packet,
4649 PACKET_Qbtrace_conf_pt_size },
4650 { "vContSupported", PACKET_DISABLE, remote_supported_packet, PACKET_vContSupported },
4651 { "QThreadEvents", PACKET_DISABLE, remote_supported_packet, PACKET_QThreadEvents },
4652 { "no-resumed", PACKET_DISABLE, remote_supported_packet, PACKET_no_resumed },
4655 static char *remote_support_xml;
4657 /* Register string appended to "xmlRegisters=" in qSupported query. */
4660 register_remote_support_xml (const char *xml)
4662 #if defined(HAVE_LIBEXPAT)
4663 if (remote_support_xml == NULL)
4664 remote_support_xml = concat ("xmlRegisters=", xml, (char *) NULL);
4667 char *copy = xstrdup (remote_support_xml + 13);
4668 char *p = strtok (copy, ",");
4672 if (strcmp (p, xml) == 0)
4679 while ((p = strtok (NULL, ",")) != NULL);
4682 remote_support_xml = reconcat (remote_support_xml,
4683 remote_support_xml, ",", xml,
4690 remote_query_supported_append (char *msg, const char *append)
4693 return reconcat (msg, msg, ";", append, (char *) NULL);
4695 return xstrdup (append);
4699 remote_query_supported (void)
4701 struct remote_state *rs = get_remote_state ();
4704 unsigned char seen [ARRAY_SIZE (remote_protocol_features)];
4706 /* The packet support flags are handled differently for this packet
4707 than for most others. We treat an error, a disabled packet, and
4708 an empty response identically: any features which must be reported
4709 to be used will be automatically disabled. An empty buffer
4710 accomplishes this, since that is also the representation for a list
4711 containing no features. */
4714 if (packet_support (PACKET_qSupported) != PACKET_DISABLE)
4717 struct cleanup *old_chain = make_cleanup (free_current_contents, &q);
4719 if (packet_set_cmd_state (PACKET_multiprocess_feature) != AUTO_BOOLEAN_FALSE)
4720 q = remote_query_supported_append (q, "multiprocess+");
4722 if (packet_set_cmd_state (PACKET_swbreak_feature) != AUTO_BOOLEAN_FALSE)
4723 q = remote_query_supported_append (q, "swbreak+");
4724 if (packet_set_cmd_state (PACKET_hwbreak_feature) != AUTO_BOOLEAN_FALSE)
4725 q = remote_query_supported_append (q, "hwbreak+");
4727 q = remote_query_supported_append (q, "qRelocInsn+");
4729 if (packet_set_cmd_state (PACKET_fork_event_feature)
4730 != AUTO_BOOLEAN_FALSE)
4731 q = remote_query_supported_append (q, "fork-events+");
4732 if (packet_set_cmd_state (PACKET_vfork_event_feature)
4733 != AUTO_BOOLEAN_FALSE)
4734 q = remote_query_supported_append (q, "vfork-events+");
4735 if (packet_set_cmd_state (PACKET_exec_event_feature)
4736 != AUTO_BOOLEAN_FALSE)
4737 q = remote_query_supported_append (q, "exec-events+");
4739 if (packet_set_cmd_state (PACKET_vContSupported) != AUTO_BOOLEAN_FALSE)
4740 q = remote_query_supported_append (q, "vContSupported+");
4742 if (packet_set_cmd_state (PACKET_QThreadEvents) != AUTO_BOOLEAN_FALSE)
4743 q = remote_query_supported_append (q, "QThreadEvents+");
4745 if (packet_set_cmd_state (PACKET_no_resumed) != AUTO_BOOLEAN_FALSE)
4746 q = remote_query_supported_append (q, "no-resumed+");
4748 /* Keep this one last to work around a gdbserver <= 7.10 bug in
4749 the qSupported:xmlRegisters=i386 handling. */
4750 if (remote_support_xml != NULL)
4751 q = remote_query_supported_append (q, remote_support_xml);
4753 q = reconcat (q, "qSupported:", q, (char *) NULL);
4756 do_cleanups (old_chain);
4758 getpkt (&rs->buf, &rs->buf_size, 0);
4760 /* If an error occured, warn, but do not return - just reset the
4761 buffer to empty and go on to disable features. */
4762 if (packet_ok (rs->buf, &remote_protocol_packets[PACKET_qSupported])
4765 warning (_("Remote failure reply: %s"), rs->buf);
4770 memset (seen, 0, sizeof (seen));
4775 enum packet_support is_supported;
4776 char *p, *end, *name_end, *value;
4778 /* First separate out this item from the rest of the packet. If
4779 there's another item after this, we overwrite the separator
4780 (terminated strings are much easier to work with). */
4782 end = strchr (p, ';');
4785 end = p + strlen (p);
4795 warning (_("empty item in \"qSupported\" response"));
4800 name_end = strchr (p, '=');
4803 /* This is a name=value entry. */
4804 is_supported = PACKET_ENABLE;
4805 value = name_end + 1;
4814 is_supported = PACKET_ENABLE;
4818 is_supported = PACKET_DISABLE;
4822 is_supported = PACKET_SUPPORT_UNKNOWN;
4826 warning (_("unrecognized item \"%s\" "
4827 "in \"qSupported\" response"), p);
4833 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
4834 if (strcmp (remote_protocol_features[i].name, p) == 0)
4836 const struct protocol_feature *feature;
4839 feature = &remote_protocol_features[i];
4840 feature->func (feature, is_supported, value);
4845 /* If we increased the packet size, make sure to increase the global
4846 buffer size also. We delay this until after parsing the entire
4847 qSupported packet, because this is the same buffer we were
4849 if (rs->buf_size < rs->explicit_packet_size)
4851 rs->buf_size = rs->explicit_packet_size;
4852 rs->buf = (char *) xrealloc (rs->buf, rs->buf_size);
4855 /* Handle the defaults for unmentioned features. */
4856 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
4859 const struct protocol_feature *feature;
4861 feature = &remote_protocol_features[i];
4862 feature->func (feature, feature->default_support, NULL);
4866 /* Serial QUIT handler for the remote serial descriptor.
4868 Defers handling a Ctrl-C until we're done with the current
4869 command/response packet sequence, unless:
4871 - We're setting up the connection. Don't send a remote interrupt
4872 request, as we're not fully synced yet. Quit immediately
4875 - The target has been resumed in the foreground
4876 (target_terminal::is_ours is false) with a synchronous resume
4877 packet, and we're blocked waiting for the stop reply, thus a
4878 Ctrl-C should be immediately sent to the target.
4880 - We get a second Ctrl-C while still within the same serial read or
4881 write. In that case the serial is seemingly wedged --- offer to
4884 - We see a second Ctrl-C without target response, after having
4885 previously interrupted the target. In that case the target/stub
4886 is probably wedged --- offer to quit/disconnect.
4890 remote_serial_quit_handler (void)
4892 struct remote_state *rs = get_remote_state ();
4894 if (check_quit_flag ())
4896 /* If we're starting up, we're not fully synced yet. Quit
4898 if (rs->starting_up)
4900 else if (rs->got_ctrlc_during_io)
4902 if (query (_("The target is not responding to GDB commands.\n"
4903 "Stop debugging it? ")))
4904 remote_unpush_and_throw ();
4906 /* If ^C has already been sent once, offer to disconnect. */
4907 else if (!target_terminal::is_ours () && rs->ctrlc_pending_p)
4909 /* All-stop protocol, and blocked waiting for stop reply. Send
4910 an interrupt request. */
4911 else if (!target_terminal::is_ours () && rs->waiting_for_stop_reply)
4912 target_interrupt (inferior_ptid);
4914 rs->got_ctrlc_during_io = 1;
4918 /* Remove any of the remote.c targets from target stack. Upper targets depend
4919 on it so remove them first. */
4922 remote_unpush_target (void)
4924 pop_all_targets_at_and_above (process_stratum);
4928 remote_unpush_and_throw (void)
4930 remote_unpush_target ();
4931 throw_error (TARGET_CLOSE_ERROR, _("Disconnected from target."));
4935 remote_open_1 (const char *name, int from_tty,
4936 struct target_ops *target, int extended_p)
4938 struct remote_state *rs = get_remote_state ();
4941 error (_("To open a remote debug connection, you need to specify what\n"
4942 "serial device is attached to the remote system\n"
4943 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
4945 /* See FIXME above. */
4946 if (!target_async_permitted)
4947 wait_forever_enabled_p = 1;
4949 /* If we're connected to a running target, target_preopen will kill it.
4950 Ask this question first, before target_preopen has a chance to kill
4952 if (rs->remote_desc != NULL && !have_inferiors ())
4955 && !query (_("Already connected to a remote target. Disconnect? ")))
4956 error (_("Still connected."));
4959 /* Here the possibly existing remote target gets unpushed. */
4960 target_preopen (from_tty);
4962 /* Make sure we send the passed signals list the next time we resume. */
4963 xfree (rs->last_pass_packet);
4964 rs->last_pass_packet = NULL;
4966 /* Make sure we send the program signals list the next time we
4968 xfree (rs->last_program_signals_packet);
4969 rs->last_program_signals_packet = NULL;
4971 remote_fileio_reset ();
4972 reopen_exec_file ();
4975 rs->remote_desc = remote_serial_open (name);
4976 if (!rs->remote_desc)
4977 perror_with_name (name);
4979 if (baud_rate != -1)
4981 if (serial_setbaudrate (rs->remote_desc, baud_rate))
4983 /* The requested speed could not be set. Error out to
4984 top level after closing remote_desc. Take care to
4985 set remote_desc to NULL to avoid closing remote_desc
4987 serial_close (rs->remote_desc);
4988 rs->remote_desc = NULL;
4989 perror_with_name (name);
4993 serial_setparity (rs->remote_desc, serial_parity);
4994 serial_raw (rs->remote_desc);
4996 /* If there is something sitting in the buffer we might take it as a
4997 response to a command, which would be bad. */
4998 serial_flush_input (rs->remote_desc);
5002 puts_filtered ("Remote debugging using ");
5003 puts_filtered (name);
5004 puts_filtered ("\n");
5006 push_target (target); /* Switch to using remote target now. */
5008 /* Register extra event sources in the event loop. */
5009 remote_async_inferior_event_token
5010 = create_async_event_handler (remote_async_inferior_event_handler,
5012 rs->notif_state = remote_notif_state_allocate ();
5014 /* Reset the target state; these things will be queried either by
5015 remote_query_supported or as they are needed. */
5016 reset_all_packet_configs_support ();
5017 rs->cached_wait_status = 0;
5018 rs->explicit_packet_size = 0;
5020 rs->extended = extended_p;
5021 rs->waiting_for_stop_reply = 0;
5022 rs->ctrlc_pending_p = 0;
5023 rs->got_ctrlc_during_io = 0;
5025 rs->general_thread = not_sent_ptid;
5026 rs->continue_thread = not_sent_ptid;
5027 rs->remote_traceframe_number = -1;
5029 rs->last_resume_exec_dir = EXEC_FORWARD;
5031 /* Probe for ability to use "ThreadInfo" query, as required. */
5032 rs->use_threadinfo_query = 1;
5033 rs->use_threadextra_query = 1;
5035 readahead_cache_invalidate ();
5037 if (target_async_permitted)
5039 /* FIXME: cagney/1999-09-23: During the initial connection it is
5040 assumed that the target is already ready and able to respond to
5041 requests. Unfortunately remote_start_remote() eventually calls
5042 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
5043 around this. Eventually a mechanism that allows
5044 wait_for_inferior() to expect/get timeouts will be
5046 wait_forever_enabled_p = 0;
5049 /* First delete any symbols previously loaded from shared libraries. */
5050 no_shared_libraries (NULL, 0);
5053 init_thread_list ();
5055 /* Start the remote connection. If error() or QUIT, discard this
5056 target (we'd otherwise be in an inconsistent state) and then
5057 propogate the error on up the exception chain. This ensures that
5058 the caller doesn't stumble along blindly assuming that the
5059 function succeeded. The CLI doesn't have this problem but other
5060 UI's, such as MI do.
5062 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
5063 this function should return an error indication letting the
5064 caller restore the previous state. Unfortunately the command
5065 ``target remote'' is directly wired to this function making that
5066 impossible. On a positive note, the CLI side of this problem has
5067 been fixed - the function set_cmd_context() makes it possible for
5068 all the ``target ....'' commands to share a common callback
5069 function. See cli-dump.c. */
5074 remote_start_remote (from_tty, target, extended_p);
5076 CATCH (ex, RETURN_MASK_ALL)
5078 /* Pop the partially set up target - unless something else did
5079 already before throwing the exception. */
5080 if (rs->remote_desc != NULL)
5081 remote_unpush_target ();
5082 if (target_async_permitted)
5083 wait_forever_enabled_p = 1;
5084 throw_exception (ex);
5089 remote_btrace_reset ();
5091 if (target_async_permitted)
5092 wait_forever_enabled_p = 1;
5095 /* Detach the specified process. */
5098 remote_detach_pid (int pid)
5100 struct remote_state *rs = get_remote_state ();
5102 if (remote_multi_process_p (rs))
5103 xsnprintf (rs->buf, get_remote_packet_size (), "D;%x", pid);
5105 strcpy (rs->buf, "D");
5108 getpkt (&rs->buf, &rs->buf_size, 0);
5110 if (rs->buf[0] == 'O' && rs->buf[1] == 'K')
5112 else if (rs->buf[0] == '\0')
5113 error (_("Remote doesn't know how to detach"));
5115 error (_("Can't detach process."));
5118 /* This detaches a program to which we previously attached, using
5119 inferior_ptid to identify the process. After this is done, GDB
5120 can be used to debug some other program. We better not have left
5121 any breakpoints in the target program or it'll die when it hits
5125 remote_detach_1 (const char *args, int from_tty)
5127 int pid = ptid_get_pid (inferior_ptid);
5128 struct remote_state *rs = get_remote_state ();
5129 struct thread_info *tp = find_thread_ptid (inferior_ptid);
5133 error (_("Argument given to \"detach\" when remotely debugging."));
5135 if (!target_has_execution)
5136 error (_("No process to detach from."));
5138 target_announce_detach (from_tty);
5140 /* Tell the remote target to detach. */
5141 remote_detach_pid (pid);
5143 /* Exit only if this is the only active inferior. */
5144 if (from_tty && !rs->extended && number_of_live_inferiors () == 1)
5145 puts_filtered (_("Ending remote debugging.\n"));
5147 /* Check to see if we are detaching a fork parent. Note that if we
5148 are detaching a fork child, tp == NULL. */
5149 is_fork_parent = (tp != NULL
5150 && tp->pending_follow.kind == TARGET_WAITKIND_FORKED);
5152 /* If doing detach-on-fork, we don't mourn, because that will delete
5153 breakpoints that should be available for the followed inferior. */
5154 if (!is_fork_parent)
5155 target_mourn_inferior (inferior_ptid);
5158 inferior_ptid = null_ptid;
5159 detach_inferior (pid);
5164 remote_detach (struct target_ops *ops, const char *args, int from_tty)
5166 remote_detach_1 (args, from_tty);
5170 extended_remote_detach (struct target_ops *ops, const char *args, int from_tty)
5172 remote_detach_1 (args, from_tty);
5175 /* Target follow-fork function for remote targets. On entry, and
5176 at return, the current inferior is the fork parent.
5178 Note that although this is currently only used for extended-remote,
5179 it is named remote_follow_fork in anticipation of using it for the
5180 remote target as well. */
5183 remote_follow_fork (struct target_ops *ops, int follow_child,
5186 struct remote_state *rs = get_remote_state ();
5187 enum target_waitkind kind = inferior_thread ()->pending_follow.kind;
5189 if ((kind == TARGET_WAITKIND_FORKED && remote_fork_event_p (rs))
5190 || (kind == TARGET_WAITKIND_VFORKED && remote_vfork_event_p (rs)))
5192 /* When following the parent and detaching the child, we detach
5193 the child here. For the case of following the child and
5194 detaching the parent, the detach is done in the target-
5195 independent follow fork code in infrun.c. We can't use
5196 target_detach when detaching an unfollowed child because
5197 the client side doesn't know anything about the child. */
5198 if (detach_fork && !follow_child)
5200 /* Detach the fork child. */
5204 child_ptid = inferior_thread ()->pending_follow.value.related_pid;
5205 child_pid = ptid_get_pid (child_ptid);
5207 remote_detach_pid (child_pid);
5208 detach_inferior (child_pid);
5214 /* Target follow-exec function for remote targets. Save EXECD_PATHNAME
5215 in the program space of the new inferior. On entry and at return the
5216 current inferior is the exec'ing inferior. INF is the new exec'd
5217 inferior, which may be the same as the exec'ing inferior unless
5218 follow-exec-mode is "new". */
5221 remote_follow_exec (struct target_ops *ops,
5222 struct inferior *inf, char *execd_pathname)
5224 /* We know that this is a target file name, so if it has the "target:"
5225 prefix we strip it off before saving it in the program space. */
5226 if (is_target_filename (execd_pathname))
5227 execd_pathname += strlen (TARGET_SYSROOT_PREFIX);
5229 set_pspace_remote_exec_file (inf->pspace, execd_pathname);
5232 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
5235 remote_disconnect (struct target_ops *target, const char *args, int from_tty)
5238 error (_("Argument given to \"disconnect\" when remotely debugging."));
5240 /* Make sure we unpush even the extended remote targets. Calling
5241 target_mourn_inferior won't unpush, and remote_mourn won't
5242 unpush if there is more than one inferior left. */
5243 unpush_target (target);
5244 generic_mourn_inferior ();
5247 puts_filtered ("Ending remote debugging.\n");
5250 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
5251 be chatty about it. */
5254 extended_remote_attach (struct target_ops *target, const char *args,
5257 struct remote_state *rs = get_remote_state ();
5259 char *wait_status = NULL;
5261 pid = parse_pid_to_attach (args);
5263 /* Remote PID can be freely equal to getpid, do not check it here the same
5264 way as in other targets. */
5266 if (packet_support (PACKET_vAttach) == PACKET_DISABLE)
5267 error (_("This target does not support attaching to a process"));
5271 char *exec_file = get_exec_file (0);
5274 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file,
5275 target_pid_to_str (pid_to_ptid (pid)));
5277 printf_unfiltered (_("Attaching to %s\n"),
5278 target_pid_to_str (pid_to_ptid (pid)));
5280 gdb_flush (gdb_stdout);
5283 xsnprintf (rs->buf, get_remote_packet_size (), "vAttach;%x", pid);
5285 getpkt (&rs->buf, &rs->buf_size, 0);
5287 switch (packet_ok (rs->buf,
5288 &remote_protocol_packets[PACKET_vAttach]))
5291 if (!target_is_non_stop_p ())
5293 /* Save the reply for later. */
5294 wait_status = (char *) alloca (strlen (rs->buf) + 1);
5295 strcpy (wait_status, rs->buf);
5297 else if (strcmp (rs->buf, "OK") != 0)
5298 error (_("Attaching to %s failed with: %s"),
5299 target_pid_to_str (pid_to_ptid (pid)),
5302 case PACKET_UNKNOWN:
5303 error (_("This target does not support attaching to a process"));
5305 error (_("Attaching to %s failed"),
5306 target_pid_to_str (pid_to_ptid (pid)));
5309 set_current_inferior (remote_add_inferior (0, pid, 1, 0));
5311 inferior_ptid = pid_to_ptid (pid);
5313 if (target_is_non_stop_p ())
5315 struct thread_info *thread;
5317 /* Get list of threads. */
5318 remote_update_thread_list (target);
5320 thread = first_thread_of_process (pid);
5322 inferior_ptid = thread->ptid;
5324 inferior_ptid = pid_to_ptid (pid);
5326 /* Invalidate our notion of the remote current thread. */
5327 record_currthread (rs, minus_one_ptid);
5331 /* Now, if we have thread information, update inferior_ptid. */
5332 inferior_ptid = remote_current_thread (inferior_ptid);
5334 /* Add the main thread to the thread list. */
5335 add_thread_silent (inferior_ptid);
5338 /* Next, if the target can specify a description, read it. We do
5339 this before anything involving memory or registers. */
5340 target_find_description ();
5342 if (!target_is_non_stop_p ())
5344 /* Use the previously fetched status. */
5345 gdb_assert (wait_status != NULL);
5347 if (target_can_async_p ())
5349 struct notif_event *reply
5350 = remote_notif_parse (¬if_client_stop, wait_status);
5352 push_stop_reply ((struct stop_reply *) reply);
5358 gdb_assert (wait_status != NULL);
5359 strcpy (rs->buf, wait_status);
5360 rs->cached_wait_status = 1;
5364 gdb_assert (wait_status == NULL);
5367 /* Implementation of the to_post_attach method. */
5370 extended_remote_post_attach (struct target_ops *ops, int pid)
5372 /* Get text, data & bss offsets. */
5375 /* In certain cases GDB might not have had the chance to start
5376 symbol lookup up until now. This could happen if the debugged
5377 binary is not using shared libraries, the vsyscall page is not
5378 present (on Linux) and the binary itself hadn't changed since the
5379 debugging process was started. */
5380 if (symfile_objfile != NULL)
5381 remote_check_symbols();
5385 /* Check for the availability of vCont. This function should also check
5389 remote_vcont_probe (struct remote_state *rs)
5393 strcpy (rs->buf, "vCont?");
5395 getpkt (&rs->buf, &rs->buf_size, 0);
5398 /* Make sure that the features we assume are supported. */
5399 if (startswith (buf, "vCont"))
5402 int support_c, support_C;
5404 rs->supports_vCont.s = 0;
5405 rs->supports_vCont.S = 0;
5408 rs->supports_vCont.t = 0;
5409 rs->supports_vCont.r = 0;
5410 while (p && *p == ';')
5413 if (*p == 's' && (*(p + 1) == ';' || *(p + 1) == 0))
5414 rs->supports_vCont.s = 1;
5415 else if (*p == 'S' && (*(p + 1) == ';' || *(p + 1) == 0))
5416 rs->supports_vCont.S = 1;
5417 else if (*p == 'c' && (*(p + 1) == ';' || *(p + 1) == 0))
5419 else if (*p == 'C' && (*(p + 1) == ';' || *(p + 1) == 0))
5421 else if (*p == 't' && (*(p + 1) == ';' || *(p + 1) == 0))
5422 rs->supports_vCont.t = 1;
5423 else if (*p == 'r' && (*(p + 1) == ';' || *(p + 1) == 0))
5424 rs->supports_vCont.r = 1;
5426 p = strchr (p, ';');
5429 /* If c, and C are not all supported, we can't use vCont. Clearing
5430 BUF will make packet_ok disable the packet. */
5431 if (!support_c || !support_C)
5435 packet_ok (buf, &remote_protocol_packets[PACKET_vCont]);
5438 /* Helper function for building "vCont" resumptions. Write a
5439 resumption to P. ENDP points to one-passed-the-end of the buffer
5440 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
5441 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
5442 resumed thread should be single-stepped and/or signalled. If PTID
5443 equals minus_one_ptid, then all threads are resumed; if PTID
5444 represents a process, then all threads of the process are resumed;
5445 the thread to be stepped and/or signalled is given in the global
5449 append_resumption (char *p, char *endp,
5450 ptid_t ptid, int step, enum gdb_signal siggnal)
5452 struct remote_state *rs = get_remote_state ();
5454 if (step && siggnal != GDB_SIGNAL_0)
5455 p += xsnprintf (p, endp - p, ";S%02x", siggnal);
5457 /* GDB is willing to range step. */
5458 && use_range_stepping
5459 /* Target supports range stepping. */
5460 && rs->supports_vCont.r
5461 /* We don't currently support range stepping multiple
5462 threads with a wildcard (though the protocol allows it,
5463 so stubs shouldn't make an active effort to forbid
5465 && !(remote_multi_process_p (rs) && ptid_is_pid (ptid)))
5467 struct thread_info *tp;
5469 if (ptid_equal (ptid, minus_one_ptid))
5471 /* If we don't know about the target thread's tid, then
5472 we're resuming magic_null_ptid (see caller). */
5473 tp = find_thread_ptid (magic_null_ptid);
5476 tp = find_thread_ptid (ptid);
5477 gdb_assert (tp != NULL);
5479 if (tp->control.may_range_step)
5481 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
5483 p += xsnprintf (p, endp - p, ";r%s,%s",
5484 phex_nz (tp->control.step_range_start,
5486 phex_nz (tp->control.step_range_end,
5490 p += xsnprintf (p, endp - p, ";s");
5493 p += xsnprintf (p, endp - p, ";s");
5494 else if (siggnal != GDB_SIGNAL_0)
5495 p += xsnprintf (p, endp - p, ";C%02x", siggnal);
5497 p += xsnprintf (p, endp - p, ";c");
5499 if (remote_multi_process_p (rs) && ptid_is_pid (ptid))
5503 /* All (-1) threads of process. */
5504 nptid = ptid_build (ptid_get_pid (ptid), -1, 0);
5506 p += xsnprintf (p, endp - p, ":");
5507 p = write_ptid (p, endp, nptid);
5509 else if (!ptid_equal (ptid, minus_one_ptid))
5511 p += xsnprintf (p, endp - p, ":");
5512 p = write_ptid (p, endp, ptid);
5518 /* Clear the thread's private info on resume. */
5521 resume_clear_thread_private_info (struct thread_info *thread)
5523 if (thread->priv != NULL)
5525 remote_thread_info *priv = get_remote_thread_info (thread);
5527 priv->stop_reason = TARGET_STOPPED_BY_NO_REASON;
5528 priv->watch_data_address = 0;
5532 /* Append a vCont continue-with-signal action for threads that have a
5533 non-zero stop signal. */
5536 append_pending_thread_resumptions (char *p, char *endp, ptid_t ptid)
5538 struct thread_info *thread;
5540 ALL_NON_EXITED_THREADS (thread)
5541 if (ptid_match (thread->ptid, ptid)
5542 && !ptid_equal (inferior_ptid, thread->ptid)
5543 && thread->suspend.stop_signal != GDB_SIGNAL_0)
5545 p = append_resumption (p, endp, thread->ptid,
5546 0, thread->suspend.stop_signal);
5547 thread->suspend.stop_signal = GDB_SIGNAL_0;
5548 resume_clear_thread_private_info (thread);
5554 /* Set the target running, using the packets that use Hc
5558 remote_resume_with_hc (struct target_ops *ops,
5559 ptid_t ptid, int step, enum gdb_signal siggnal)
5561 struct remote_state *rs = get_remote_state ();
5562 struct thread_info *thread;
5565 rs->last_sent_signal = siggnal;
5566 rs->last_sent_step = step;
5568 /* The c/s/C/S resume packets use Hc, so set the continue
5570 if (ptid_equal (ptid, minus_one_ptid))
5571 set_continue_thread (any_thread_ptid);
5573 set_continue_thread (ptid);
5575 ALL_NON_EXITED_THREADS (thread)
5576 resume_clear_thread_private_info (thread);
5579 if (execution_direction == EXEC_REVERSE)
5581 /* We don't pass signals to the target in reverse exec mode. */
5582 if (info_verbose && siggnal != GDB_SIGNAL_0)
5583 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
5586 if (step && packet_support (PACKET_bs) == PACKET_DISABLE)
5587 error (_("Remote reverse-step not supported."));
5588 if (!step && packet_support (PACKET_bc) == PACKET_DISABLE)
5589 error (_("Remote reverse-continue not supported."));
5591 strcpy (buf, step ? "bs" : "bc");
5593 else if (siggnal != GDB_SIGNAL_0)
5595 buf[0] = step ? 'S' : 'C';
5596 buf[1] = tohex (((int) siggnal >> 4) & 0xf);
5597 buf[2] = tohex (((int) siggnal) & 0xf);
5601 strcpy (buf, step ? "s" : "c");
5606 /* Resume the remote inferior by using a "vCont" packet. The thread
5607 to be resumed is PTID; STEP and SIGGNAL indicate whether the
5608 resumed thread should be single-stepped and/or signalled. If PTID
5609 equals minus_one_ptid, then all threads are resumed; the thread to
5610 be stepped and/or signalled is given in the global INFERIOR_PTID.
5611 This function returns non-zero iff it resumes the inferior.
5613 This function issues a strict subset of all possible vCont commands
5617 remote_resume_with_vcont (ptid_t ptid, int step, enum gdb_signal siggnal)
5619 struct remote_state *rs = get_remote_state ();
5623 /* No reverse execution actions defined for vCont. */
5624 if (execution_direction == EXEC_REVERSE)
5627 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
5628 remote_vcont_probe (rs);
5630 if (packet_support (PACKET_vCont) == PACKET_DISABLE)
5634 endp = rs->buf + get_remote_packet_size ();
5636 /* If we could generate a wider range of packets, we'd have to worry
5637 about overflowing BUF. Should there be a generic
5638 "multi-part-packet" packet? */
5640 p += xsnprintf (p, endp - p, "vCont");
5642 if (ptid_equal (ptid, magic_null_ptid))
5644 /* MAGIC_NULL_PTID means that we don't have any active threads,
5645 so we don't have any TID numbers the inferior will
5646 understand. Make sure to only send forms that do not specify
5648 append_resumption (p, endp, minus_one_ptid, step, siggnal);
5650 else if (ptid_equal (ptid, minus_one_ptid) || ptid_is_pid (ptid))
5652 /* Resume all threads (of all processes, or of a single
5653 process), with preference for INFERIOR_PTID. This assumes
5654 inferior_ptid belongs to the set of all threads we are about
5656 if (step || siggnal != GDB_SIGNAL_0)
5658 /* Step inferior_ptid, with or without signal. */
5659 p = append_resumption (p, endp, inferior_ptid, step, siggnal);
5662 /* Also pass down any pending signaled resumption for other
5663 threads not the current. */
5664 p = append_pending_thread_resumptions (p, endp, ptid);
5666 /* And continue others without a signal. */
5667 append_resumption (p, endp, ptid, /*step=*/ 0, GDB_SIGNAL_0);
5671 /* Scheduler locking; resume only PTID. */
5672 append_resumption (p, endp, ptid, step, siggnal);
5675 gdb_assert (strlen (rs->buf) < get_remote_packet_size ());
5678 if (target_is_non_stop_p ())
5680 /* In non-stop, the stub replies to vCont with "OK". The stop
5681 reply will be reported asynchronously by means of a `%Stop'
5683 getpkt (&rs->buf, &rs->buf_size, 0);
5684 if (strcmp (rs->buf, "OK") != 0)
5685 error (_("Unexpected vCont reply in non-stop mode: %s"), rs->buf);
5691 /* Tell the remote machine to resume. */
5694 remote_resume (struct target_ops *ops,
5695 ptid_t ptid, int step, enum gdb_signal siggnal)
5697 struct remote_state *rs = get_remote_state ();
5699 /* When connected in non-stop mode, the core resumes threads
5700 individually. Resuming remote threads directly in target_resume
5701 would thus result in sending one packet per thread. Instead, to
5702 minimize roundtrip latency, here we just store the resume
5703 request; the actual remote resumption will be done in
5704 target_commit_resume / remote_commit_resume, where we'll be able
5705 to do vCont action coalescing. */
5706 if (target_is_non_stop_p () && execution_direction != EXEC_REVERSE)
5708 remote_thread_info *remote_thr;
5710 if (ptid_equal (minus_one_ptid, ptid) || ptid_is_pid (ptid))
5711 remote_thr = get_remote_thread_info (inferior_ptid);
5713 remote_thr = get_remote_thread_info (ptid);
5715 remote_thr->last_resume_step = step;
5716 remote_thr->last_resume_sig = siggnal;
5720 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
5721 (explained in remote-notif.c:handle_notification) so
5722 remote_notif_process is not called. We need find a place where
5723 it is safe to start a 'vNotif' sequence. It is good to do it
5724 before resuming inferior, because inferior was stopped and no RSP
5725 traffic at that moment. */
5726 if (!target_is_non_stop_p ())
5727 remote_notif_process (rs->notif_state, ¬if_client_stop);
5729 rs->last_resume_exec_dir = execution_direction;
5731 /* Prefer vCont, and fallback to s/c/S/C, which use Hc. */
5732 if (!remote_resume_with_vcont (ptid, step, siggnal))
5733 remote_resume_with_hc (ops, ptid, step, siggnal);
5735 /* We are about to start executing the inferior, let's register it
5736 with the event loop. NOTE: this is the one place where all the
5737 execution commands end up. We could alternatively do this in each
5738 of the execution commands in infcmd.c. */
5739 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
5740 into infcmd.c in order to allow inferior function calls to work
5741 NOT asynchronously. */
5742 if (target_can_async_p ())
5745 /* We've just told the target to resume. The remote server will
5746 wait for the inferior to stop, and then send a stop reply. In
5747 the mean time, we can't start another command/query ourselves
5748 because the stub wouldn't be ready to process it. This applies
5749 only to the base all-stop protocol, however. In non-stop (which
5750 only supports vCont), the stub replies with an "OK", and is
5751 immediate able to process further serial input. */
5752 if (!target_is_non_stop_p ())
5753 rs->waiting_for_stop_reply = 1;
5756 static void check_pending_events_prevent_wildcard_vcont
5757 (int *may_global_wildcard_vcont);
5758 static int is_pending_fork_parent_thread (struct thread_info *thread);
5760 /* Private per-inferior info for target remote processes. */
5762 struct remote_inferior : public private_inferior
5764 /* Whether we can send a wildcard vCont for this process. */
5765 bool may_wildcard_vcont = true;
5768 /* Get the remote private inferior data associated to INF. */
5770 static remote_inferior *
5771 get_remote_inferior (inferior *inf)
5773 if (inf->priv == NULL)
5774 inf->priv.reset (new remote_inferior);
5776 return static_cast<remote_inferior *> (inf->priv.get ());
5779 /* Structure used to track the construction of a vCont packet in the
5780 outgoing packet buffer. This is used to send multiple vCont
5781 packets if we have more actions than would fit a single packet. */
5783 struct vcont_builder
5785 /* Pointer to the first action. P points here if no action has been
5789 /* Where the next action will be appended. */
5792 /* The end of the buffer. Must never write past this. */
5796 /* Prepare the outgoing buffer for a new vCont packet. */
5799 vcont_builder_restart (struct vcont_builder *builder)
5801 struct remote_state *rs = get_remote_state ();
5803 builder->p = rs->buf;
5804 builder->endp = rs->buf + get_remote_packet_size ();
5805 builder->p += xsnprintf (builder->p, builder->endp - builder->p, "vCont");
5806 builder->first_action = builder->p;
5809 /* If the vCont packet being built has any action, send it to the
5813 vcont_builder_flush (struct vcont_builder *builder)
5815 struct remote_state *rs;
5817 if (builder->p == builder->first_action)
5820 rs = get_remote_state ();
5822 getpkt (&rs->buf, &rs->buf_size, 0);
5823 if (strcmp (rs->buf, "OK") != 0)
5824 error (_("Unexpected vCont reply in non-stop mode: %s"), rs->buf);
5827 /* The largest action is range-stepping, with its two addresses. This
5828 is more than sufficient. If a new, bigger action is created, it'll
5829 quickly trigger a failed assertion in append_resumption (and we'll
5831 #define MAX_ACTION_SIZE 200
5833 /* Append a new vCont action in the outgoing packet being built. If
5834 the action doesn't fit the packet along with previous actions, push
5835 what we've got so far to the remote end and start over a new vCont
5836 packet (with the new action). */
5839 vcont_builder_push_action (struct vcont_builder *builder,
5840 ptid_t ptid, int step, enum gdb_signal siggnal)
5842 char buf[MAX_ACTION_SIZE + 1];
5846 endp = append_resumption (buf, buf + sizeof (buf),
5847 ptid, step, siggnal);
5849 /* Check whether this new action would fit in the vCont packet along
5850 with previous actions. If not, send what we've got so far and
5851 start a new vCont packet. */
5853 if (rsize > builder->endp - builder->p)
5855 vcont_builder_flush (builder);
5856 vcont_builder_restart (builder);
5858 /* Should now fit. */
5859 gdb_assert (rsize <= builder->endp - builder->p);
5862 memcpy (builder->p, buf, rsize);
5863 builder->p += rsize;
5867 /* to_commit_resume implementation. */
5870 remote_commit_resume (struct target_ops *ops)
5872 struct remote_state *rs = get_remote_state ();
5873 struct inferior *inf;
5874 struct thread_info *tp;
5875 int any_process_wildcard;
5876 int may_global_wildcard_vcont;
5877 struct vcont_builder vcont_builder;
5879 /* If connected in all-stop mode, we'd send the remote resume
5880 request directly from remote_resume. Likewise if
5881 reverse-debugging, as there are no defined vCont actions for
5882 reverse execution. */
5883 if (!target_is_non_stop_p () || execution_direction == EXEC_REVERSE)
5886 /* Try to send wildcard actions ("vCont;c" or "vCont;c:pPID.-1")
5887 instead of resuming all threads of each process individually.
5888 However, if any thread of a process must remain halted, we can't
5889 send wildcard resumes and must send one action per thread.
5891 Care must be taken to not resume threads/processes the server
5892 side already told us are stopped, but the core doesn't know about
5893 yet, because the events are still in the vStopped notification
5896 #1 => vCont s:p1.1;c
5898 #3 <= %Stopped T05 p1.1
5903 #8 (infrun handles the stop for p1.1 and continues stepping)
5904 #9 => vCont s:p1.1;c
5906 The last vCont above would resume thread p1.2 by mistake, because
5907 the server has no idea that the event for p1.2 had not been
5910 The server side must similarly ignore resume actions for the
5911 thread that has a pending %Stopped notification (and any other
5912 threads with events pending), until GDB acks the notification
5913 with vStopped. Otherwise, e.g., the following case is
5916 #1 => g (or any other packet)
5918 #3 <= %Stopped T05 p1.2
5919 #4 => vCont s:p1.1;c
5922 Above, the server must not resume thread p1.2. GDB can't know
5923 that p1.2 stopped until it acks the %Stopped notification, and
5924 since from GDB's perspective all threads should be running, it
5927 Finally, special care must also be given to handling fork/vfork
5928 events. A (v)fork event actually tells us that two processes
5929 stopped -- the parent and the child. Until we follow the fork,
5930 we must not resume the child. Therefore, if we have a pending
5931 fork follow, we must not send a global wildcard resume action
5932 (vCont;c). We can still send process-wide wildcards though. */
5934 /* Start by assuming a global wildcard (vCont;c) is possible. */
5935 may_global_wildcard_vcont = 1;
5937 /* And assume every process is individually wildcard-able too. */
5938 ALL_NON_EXITED_INFERIORS (inf)
5940 remote_inferior *priv = get_remote_inferior (inf);
5942 priv->may_wildcard_vcont = true;
5945 /* Check for any pending events (not reported or processed yet) and
5946 disable process and global wildcard resumes appropriately. */
5947 check_pending_events_prevent_wildcard_vcont (&may_global_wildcard_vcont);
5949 ALL_NON_EXITED_THREADS (tp)
5951 /* If a thread of a process is not meant to be resumed, then we
5952 can't wildcard that process. */
5955 get_remote_inferior (tp->inf)->may_wildcard_vcont = false;
5957 /* And if we can't wildcard a process, we can't wildcard
5958 everything either. */
5959 may_global_wildcard_vcont = 0;
5963 /* If a thread is the parent of an unfollowed fork, then we
5964 can't do a global wildcard, as that would resume the fork
5966 if (is_pending_fork_parent_thread (tp))
5967 may_global_wildcard_vcont = 0;
5970 /* Now let's build the vCont packet(s). Actions must be appended
5971 from narrower to wider scopes (thread -> process -> global). If
5972 we end up with too many actions for a single packet vcont_builder
5973 flushes the current vCont packet to the remote side and starts a
5975 vcont_builder_restart (&vcont_builder);
5977 /* Threads first. */
5978 ALL_NON_EXITED_THREADS (tp)
5980 remote_thread_info *remote_thr = get_remote_thread_info (tp);
5982 if (!tp->executing || remote_thr->vcont_resumed)
5985 gdb_assert (!thread_is_in_step_over_chain (tp));
5987 if (!remote_thr->last_resume_step
5988 && remote_thr->last_resume_sig == GDB_SIGNAL_0
5989 && get_remote_inferior (tp->inf)->may_wildcard_vcont)
5991 /* We'll send a wildcard resume instead. */
5992 remote_thr->vcont_resumed = 1;
5996 vcont_builder_push_action (&vcont_builder, tp->ptid,
5997 remote_thr->last_resume_step,
5998 remote_thr->last_resume_sig);
5999 remote_thr->vcont_resumed = 1;
6002 /* Now check whether we can send any process-wide wildcard. This is
6003 to avoid sending a global wildcard in the case nothing is
6004 supposed to be resumed. */
6005 any_process_wildcard = 0;
6007 ALL_NON_EXITED_INFERIORS (inf)
6009 if (get_remote_inferior (inf)->may_wildcard_vcont)
6011 any_process_wildcard = 1;
6016 if (any_process_wildcard)
6018 /* If all processes are wildcard-able, then send a single "c"
6019 action, otherwise, send an "all (-1) threads of process"
6020 continue action for each running process, if any. */
6021 if (may_global_wildcard_vcont)
6023 vcont_builder_push_action (&vcont_builder, minus_one_ptid,
6028 ALL_NON_EXITED_INFERIORS (inf)
6030 if (get_remote_inferior (inf)->may_wildcard_vcont)
6032 vcont_builder_push_action (&vcont_builder,
6033 pid_to_ptid (inf->pid),
6040 vcont_builder_flush (&vcont_builder);
6045 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
6046 thread, all threads of a remote process, or all threads of all
6050 remote_stop_ns (ptid_t ptid)
6052 struct remote_state *rs = get_remote_state ();
6054 char *endp = rs->buf + get_remote_packet_size ();
6056 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
6057 remote_vcont_probe (rs);
6059 if (!rs->supports_vCont.t)
6060 error (_("Remote server does not support stopping threads"));
6062 if (ptid_equal (ptid, minus_one_ptid)
6063 || (!remote_multi_process_p (rs) && ptid_is_pid (ptid)))
6064 p += xsnprintf (p, endp - p, "vCont;t");
6069 p += xsnprintf (p, endp - p, "vCont;t:");
6071 if (ptid_is_pid (ptid))
6072 /* All (-1) threads of process. */
6073 nptid = ptid_build (ptid_get_pid (ptid), -1, 0);
6076 /* Small optimization: if we already have a stop reply for
6077 this thread, no use in telling the stub we want this
6079 if (peek_stop_reply (ptid))
6085 write_ptid (p, endp, nptid);
6088 /* In non-stop, we get an immediate OK reply. The stop reply will
6089 come in asynchronously by notification. */
6091 getpkt (&rs->buf, &rs->buf_size, 0);
6092 if (strcmp (rs->buf, "OK") != 0)
6093 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid), rs->buf);
6096 /* All-stop version of target_interrupt. Sends a break or a ^C to
6097 interrupt the remote target. It is undefined which thread of which
6098 process reports the interrupt. */
6101 remote_interrupt_as (void)
6103 struct remote_state *rs = get_remote_state ();
6105 rs->ctrlc_pending_p = 1;
6107 /* If the inferior is stopped already, but the core didn't know
6108 about it yet, just ignore the request. The cached wait status
6109 will be collected in remote_wait. */
6110 if (rs->cached_wait_status)
6113 /* Send interrupt_sequence to remote target. */
6114 send_interrupt_sequence ();
6117 /* Non-stop version of target_interrupt. Uses `vCtrlC' to interrupt
6118 the remote target. It is undefined which thread of which process
6119 reports the interrupt. Throws an error if the packet is not
6120 supported by the server. */
6123 remote_interrupt_ns (void)
6125 struct remote_state *rs = get_remote_state ();
6127 char *endp = rs->buf + get_remote_packet_size ();
6129 xsnprintf (p, endp - p, "vCtrlC");
6131 /* In non-stop, we get an immediate OK reply. The stop reply will
6132 come in asynchronously by notification. */
6134 getpkt (&rs->buf, &rs->buf_size, 0);
6136 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_vCtrlC]))
6140 case PACKET_UNKNOWN:
6141 error (_("No support for interrupting the remote target."));
6143 error (_("Interrupting target failed: %s"), rs->buf);
6147 /* Implement the to_stop function for the remote targets. */
6150 remote_stop (struct target_ops *self, ptid_t ptid)
6153 fprintf_unfiltered (gdb_stdlog, "remote_stop called\n");
6155 if (target_is_non_stop_p ())
6156 remote_stop_ns (ptid);
6159 /* We don't currently have a way to transparently pause the
6160 remote target in all-stop mode. Interrupt it instead. */
6161 remote_interrupt_as ();
6165 /* Implement the to_interrupt function for the remote targets. */
6168 remote_interrupt (struct target_ops *self, ptid_t ptid)
6170 struct remote_state *rs = get_remote_state ();
6173 fprintf_unfiltered (gdb_stdlog, "remote_interrupt called\n");
6175 if (target_is_non_stop_p ())
6176 remote_interrupt_ns ();
6178 remote_interrupt_as ();
6181 /* Implement the to_pass_ctrlc function for the remote targets. */
6184 remote_pass_ctrlc (struct target_ops *self)
6186 struct remote_state *rs = get_remote_state ();
6189 fprintf_unfiltered (gdb_stdlog, "remote_pass_ctrlc called\n");
6191 /* If we're starting up, we're not fully synced yet. Quit
6193 if (rs->starting_up)
6195 /* If ^C has already been sent once, offer to disconnect. */
6196 else if (rs->ctrlc_pending_p)
6199 target_interrupt (inferior_ptid);
6202 /* Ask the user what to do when an interrupt is received. */
6205 interrupt_query (void)
6207 struct remote_state *rs = get_remote_state ();
6209 if (rs->waiting_for_stop_reply && rs->ctrlc_pending_p)
6211 if (query (_("The target is not responding to interrupt requests.\n"
6212 "Stop debugging it? ")))
6214 remote_unpush_target ();
6215 throw_error (TARGET_CLOSE_ERROR, _("Disconnected from target."));
6220 if (query (_("Interrupted while waiting for the program.\n"
6221 "Give up waiting? ")))
6226 /* Enable/disable target terminal ownership. Most targets can use
6227 terminal groups to control terminal ownership. Remote targets are
6228 different in that explicit transfer of ownership to/from GDB/target
6232 remote_terminal_inferior (struct target_ops *self)
6234 /* NOTE: At this point we could also register our selves as the
6235 recipient of all input. Any characters typed could then be
6236 passed on down to the target. */
6240 remote_terminal_ours (struct target_ops *self)
6245 remote_console_output (char *msg)
6249 for (p = msg; p[0] && p[1]; p += 2)
6252 char c = fromhex (p[0]) * 16 + fromhex (p[1]);
6256 fputs_unfiltered (tb, gdb_stdtarg);
6258 gdb_flush (gdb_stdtarg);
6261 DEF_VEC_O(cached_reg_t);
6263 typedef struct stop_reply
6265 struct notif_event base;
6267 /* The identifier of the thread about this event */
6270 /* The remote state this event is associated with. When the remote
6271 connection, represented by a remote_state object, is closed,
6272 all the associated stop_reply events should be released. */
6273 struct remote_state *rs;
6275 struct target_waitstatus ws;
6277 /* The architecture associated with the expedited registers. */
6280 /* Expedited registers. This makes remote debugging a bit more
6281 efficient for those targets that provide critical registers as
6282 part of their normal status mechanism (as another roundtrip to
6283 fetch them is avoided). */
6284 VEC(cached_reg_t) *regcache;
6286 enum target_stop_reason stop_reason;
6288 CORE_ADDR watch_data_address;
6293 DECLARE_QUEUE_P (stop_reply_p);
6294 DEFINE_QUEUE_P (stop_reply_p);
6295 /* The list of already fetched and acknowledged stop events. This
6296 queue is used for notification Stop, and other notifications
6297 don't need queue for their events, because the notification events
6298 of Stop can't be consumed immediately, so that events should be
6299 queued first, and be consumed by remote_wait_{ns,as} one per
6300 time. Other notifications can consume their events immediately,
6301 so queue is not needed for them. */
6302 static QUEUE (stop_reply_p) *stop_reply_queue;
6305 stop_reply_xfree (struct stop_reply *r)
6307 notif_event_xfree ((struct notif_event *) r);
6310 /* Return the length of the stop reply queue. */
6313 stop_reply_queue_length (void)
6315 return QUEUE_length (stop_reply_p, stop_reply_queue);
6319 remote_notif_stop_parse (struct notif_client *self, char *buf,
6320 struct notif_event *event)
6322 remote_parse_stop_reply (buf, (struct stop_reply *) event);
6326 remote_notif_stop_ack (struct notif_client *self, char *buf,
6327 struct notif_event *event)
6329 struct stop_reply *stop_reply = (struct stop_reply *) event;
6332 putpkt (self->ack_command);
6334 if (stop_reply->ws.kind == TARGET_WAITKIND_IGNORE)
6335 /* We got an unknown stop reply. */
6336 error (_("Unknown stop reply"));
6338 push_stop_reply (stop_reply);
6342 remote_notif_stop_can_get_pending_events (struct notif_client *self)
6344 /* We can't get pending events in remote_notif_process for
6345 notification stop, and we have to do this in remote_wait_ns
6346 instead. If we fetch all queued events from stub, remote stub
6347 may exit and we have no chance to process them back in
6349 mark_async_event_handler (remote_async_inferior_event_token);
6354 stop_reply_dtr (struct notif_event *event)
6356 struct stop_reply *r = (struct stop_reply *) event;
6361 VEC_iterate (cached_reg_t, r->regcache, ix, reg);
6365 VEC_free (cached_reg_t, r->regcache);
6368 static struct notif_event *
6369 remote_notif_stop_alloc_reply (void)
6371 /* We cast to a pointer to the "base class". */
6372 struct notif_event *r = (struct notif_event *) XNEW (struct stop_reply);
6374 r->dtr = stop_reply_dtr;
6379 /* A client of notification Stop. */
6381 struct notif_client notif_client_stop =
6385 remote_notif_stop_parse,
6386 remote_notif_stop_ack,
6387 remote_notif_stop_can_get_pending_events,
6388 remote_notif_stop_alloc_reply,
6392 /* A parameter to pass data in and out. */
6394 struct queue_iter_param
6397 struct stop_reply *output;
6400 /* Determine if THREAD_PTID is a pending fork parent thread. ARG contains
6401 the pid of the process that owns the threads we want to check, or
6402 -1 if we want to check all threads. */
6405 is_pending_fork_parent (struct target_waitstatus *ws, int event_pid,
6408 if (ws->kind == TARGET_WAITKIND_FORKED
6409 || ws->kind == TARGET_WAITKIND_VFORKED)
6411 if (event_pid == -1 || event_pid == ptid_get_pid (thread_ptid))
6418 /* Return the thread's pending status used to determine whether the
6419 thread is a fork parent stopped at a fork event. */
6421 static struct target_waitstatus *
6422 thread_pending_fork_status (struct thread_info *thread)
6424 if (thread->suspend.waitstatus_pending_p)
6425 return &thread->suspend.waitstatus;
6427 return &thread->pending_follow;
6430 /* Determine if THREAD is a pending fork parent thread. */
6433 is_pending_fork_parent_thread (struct thread_info *thread)
6435 struct target_waitstatus *ws = thread_pending_fork_status (thread);
6438 return is_pending_fork_parent (ws, pid, thread->ptid);
6441 /* Check whether EVENT is a fork event, and if it is, remove the
6442 fork child from the context list passed in DATA. */
6445 remove_child_of_pending_fork (QUEUE (stop_reply_p) *q,
6446 QUEUE_ITER (stop_reply_p) *iter,
6450 struct queue_iter_param *param = (struct queue_iter_param *) data;
6451 struct threads_listing_context *context
6452 = (struct threads_listing_context *) param->input;
6454 if (event->ws.kind == TARGET_WAITKIND_FORKED
6455 || event->ws.kind == TARGET_WAITKIND_VFORKED
6456 || event->ws.kind == TARGET_WAITKIND_THREAD_EXITED)
6457 context->remove_thread (event->ws.value.related_pid);
6462 /* If CONTEXT contains any fork child threads that have not been
6463 reported yet, remove them from the CONTEXT list. If such a
6464 thread exists it is because we are stopped at a fork catchpoint
6465 and have not yet called follow_fork, which will set up the
6466 host-side data structures for the new process. */
6469 remove_new_fork_children (struct threads_listing_context *context)
6471 struct thread_info * thread;
6473 struct notif_client *notif = ¬if_client_stop;
6474 struct queue_iter_param param;
6476 /* For any threads stopped at a fork event, remove the corresponding
6477 fork child threads from the CONTEXT list. */
6478 ALL_NON_EXITED_THREADS (thread)
6480 struct target_waitstatus *ws = thread_pending_fork_status (thread);
6482 if (is_pending_fork_parent (ws, pid, thread->ptid))
6483 context->remove_thread (ws->value.related_pid);
6486 /* Check for any pending fork events (not reported or processed yet)
6487 in process PID and remove those fork child threads from the
6488 CONTEXT list as well. */
6489 remote_notif_get_pending_events (notif);
6490 param.input = context;
6491 param.output = NULL;
6492 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6493 remove_child_of_pending_fork, ¶m);
6496 /* Check whether EVENT would prevent a global or process wildcard
6500 check_pending_event_prevents_wildcard_vcont_callback
6501 (QUEUE (stop_reply_p) *q,
6502 QUEUE_ITER (stop_reply_p) *iter,
6506 struct inferior *inf;
6507 int *may_global_wildcard_vcont = (int *) data;
6509 if (event->ws.kind == TARGET_WAITKIND_NO_RESUMED
6510 || event->ws.kind == TARGET_WAITKIND_NO_HISTORY)
6513 if (event->ws.kind == TARGET_WAITKIND_FORKED
6514 || event->ws.kind == TARGET_WAITKIND_VFORKED)
6515 *may_global_wildcard_vcont = 0;
6517 inf = find_inferior_ptid (event->ptid);
6519 /* This may be the first time we heard about this process.
6520 Regardless, we must not do a global wildcard resume, otherwise
6521 we'd resume this process too. */
6522 *may_global_wildcard_vcont = 0;
6524 get_remote_inferior (inf)->may_wildcard_vcont = false;
6529 /* Check whether any event pending in the vStopped queue would prevent
6530 a global or process wildcard vCont action. Clear
6531 *may_global_wildcard if we can't do a global wildcard (vCont;c),
6532 and clear the event inferior's may_wildcard_vcont flag if we can't
6533 do a process-wide wildcard resume (vCont;c:pPID.-1). */
6536 check_pending_events_prevent_wildcard_vcont (int *may_global_wildcard)
6538 struct notif_client *notif = ¬if_client_stop;
6540 remote_notif_get_pending_events (notif);
6541 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6542 check_pending_event_prevents_wildcard_vcont_callback,
6543 may_global_wildcard);
6546 /* Remove stop replies in the queue if its pid is equal to the given
6550 remove_stop_reply_for_inferior (QUEUE (stop_reply_p) *q,
6551 QUEUE_ITER (stop_reply_p) *iter,
6555 struct queue_iter_param *param = (struct queue_iter_param *) data;
6556 struct inferior *inf = (struct inferior *) param->input;
6558 if (ptid_get_pid (event->ptid) == inf->pid)
6560 stop_reply_xfree (event);
6561 QUEUE_remove_elem (stop_reply_p, q, iter);
6567 /* Discard all pending stop replies of inferior INF. */
6570 discard_pending_stop_replies (struct inferior *inf)
6572 struct queue_iter_param param;
6573 struct stop_reply *reply;
6574 struct remote_state *rs = get_remote_state ();
6575 struct remote_notif_state *rns = rs->notif_state;
6577 /* This function can be notified when an inferior exists. When the
6578 target is not remote, the notification state is NULL. */
6579 if (rs->remote_desc == NULL)
6582 reply = (struct stop_reply *) rns->pending_event[notif_client_stop.id];
6584 /* Discard the in-flight notification. */
6585 if (reply != NULL && ptid_get_pid (reply->ptid) == inf->pid)
6587 stop_reply_xfree (reply);
6588 rns->pending_event[notif_client_stop.id] = NULL;
6592 param.output = NULL;
6593 /* Discard the stop replies we have already pulled with
6595 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6596 remove_stop_reply_for_inferior, ¶m);
6599 /* If its remote state is equal to the given remote state,
6600 remove EVENT from the stop reply queue. */
6603 remove_stop_reply_of_remote_state (QUEUE (stop_reply_p) *q,
6604 QUEUE_ITER (stop_reply_p) *iter,
6608 struct queue_iter_param *param = (struct queue_iter_param *) data;
6609 struct remote_state *rs = (struct remote_state *) param->input;
6611 if (event->rs == rs)
6613 stop_reply_xfree (event);
6614 QUEUE_remove_elem (stop_reply_p, q, iter);
6620 /* Discard the stop replies for RS in stop_reply_queue. */
6623 discard_pending_stop_replies_in_queue (struct remote_state *rs)
6625 struct queue_iter_param param;
6628 param.output = NULL;
6629 /* Discard the stop replies we have already pulled with
6631 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6632 remove_stop_reply_of_remote_state, ¶m);
6635 /* A parameter to pass data in and out. */
6638 remote_notif_remove_once_on_match (QUEUE (stop_reply_p) *q,
6639 QUEUE_ITER (stop_reply_p) *iter,
6643 struct queue_iter_param *param = (struct queue_iter_param *) data;
6644 ptid_t *ptid = (ptid_t *) param->input;
6646 if (ptid_match (event->ptid, *ptid))
6648 param->output = event;
6649 QUEUE_remove_elem (stop_reply_p, q, iter);
6656 /* Remove the first reply in 'stop_reply_queue' which matches
6659 static struct stop_reply *
6660 remote_notif_remove_queued_reply (ptid_t ptid)
6662 struct queue_iter_param param;
6664 param.input = &ptid;
6665 param.output = NULL;
6667 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6668 remote_notif_remove_once_on_match, ¶m);
6670 fprintf_unfiltered (gdb_stdlog,
6671 "notif: discard queued event: 'Stop' in %s\n",
6672 target_pid_to_str (ptid));
6674 return param.output;
6677 /* Look for a queued stop reply belonging to PTID. If one is found,
6678 remove it from the queue, and return it. Returns NULL if none is
6679 found. If there are still queued events left to process, tell the
6680 event loop to get back to target_wait soon. */
6682 static struct stop_reply *
6683 queued_stop_reply (ptid_t ptid)
6685 struct stop_reply *r = remote_notif_remove_queued_reply (ptid);
6687 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
6688 /* There's still at least an event left. */
6689 mark_async_event_handler (remote_async_inferior_event_token);
6694 /* Push a fully parsed stop reply in the stop reply queue. Since we
6695 know that we now have at least one queued event left to pass to the
6696 core side, tell the event loop to get back to target_wait soon. */
6699 push_stop_reply (struct stop_reply *new_event)
6701 QUEUE_enque (stop_reply_p, stop_reply_queue, new_event);
6704 fprintf_unfiltered (gdb_stdlog,
6705 "notif: push 'Stop' %s to queue %d\n",
6706 target_pid_to_str (new_event->ptid),
6707 QUEUE_length (stop_reply_p,
6710 mark_async_event_handler (remote_async_inferior_event_token);
6714 stop_reply_match_ptid_and_ws (QUEUE (stop_reply_p) *q,
6715 QUEUE_ITER (stop_reply_p) *iter,
6716 struct stop_reply *event,
6719 ptid_t *ptid = (ptid_t *) data;
6721 return !(ptid_equal (*ptid, event->ptid)
6722 && event->ws.kind == TARGET_WAITKIND_STOPPED);
6725 /* Returns true if we have a stop reply for PTID. */
6728 peek_stop_reply (ptid_t ptid)
6730 return !QUEUE_iterate (stop_reply_p, stop_reply_queue,
6731 stop_reply_match_ptid_and_ws, &ptid);
6734 /* Helper for remote_parse_stop_reply. Return nonzero if the substring
6735 starting with P and ending with PEND matches PREFIX. */
6738 strprefix (const char *p, const char *pend, const char *prefix)
6740 for ( ; p < pend; p++, prefix++)
6743 return *prefix == '\0';
6746 /* Parse the stop reply in BUF. Either the function succeeds, and the
6747 result is stored in EVENT, or throws an error. */
6750 remote_parse_stop_reply (char *buf, struct stop_reply *event)
6752 remote_arch_state *rsa = NULL;
6757 event->ptid = null_ptid;
6758 event->rs = get_remote_state ();
6759 event->ws.kind = TARGET_WAITKIND_IGNORE;
6760 event->ws.value.integer = 0;
6761 event->stop_reason = TARGET_STOPPED_BY_NO_REASON;
6762 event->regcache = NULL;
6767 case 'T': /* Status with PC, SP, FP, ... */
6768 /* Expedited reply, containing Signal, {regno, reg} repeat. */
6769 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
6771 n... = register number
6772 r... = register contents
6775 p = &buf[3]; /* after Txx */
6781 p1 = strchr (p, ':');
6783 error (_("Malformed packet(a) (missing colon): %s\n\
6787 error (_("Malformed packet(a) (missing register number): %s\n\
6791 /* Some "registers" are actually extended stop information.
6792 Note if you're adding a new entry here: GDB 7.9 and
6793 earlier assume that all register "numbers" that start
6794 with an hex digit are real register numbers. Make sure
6795 the server only sends such a packet if it knows the
6796 client understands it. */
6798 if (strprefix (p, p1, "thread"))
6799 event->ptid = read_ptid (++p1, &p);
6800 else if (strprefix (p, p1, "syscall_entry"))
6804 event->ws.kind = TARGET_WAITKIND_SYSCALL_ENTRY;
6805 p = unpack_varlen_hex (++p1, &sysno);
6806 event->ws.value.syscall_number = (int) sysno;
6808 else if (strprefix (p, p1, "syscall_return"))
6812 event->ws.kind = TARGET_WAITKIND_SYSCALL_RETURN;
6813 p = unpack_varlen_hex (++p1, &sysno);
6814 event->ws.value.syscall_number = (int) sysno;
6816 else if (strprefix (p, p1, "watch")
6817 || strprefix (p, p1, "rwatch")
6818 || strprefix (p, p1, "awatch"))
6820 event->stop_reason = TARGET_STOPPED_BY_WATCHPOINT;
6821 p = unpack_varlen_hex (++p1, &addr);
6822 event->watch_data_address = (CORE_ADDR) addr;
6824 else if (strprefix (p, p1, "swbreak"))
6826 event->stop_reason = TARGET_STOPPED_BY_SW_BREAKPOINT;
6828 /* Make sure the stub doesn't forget to indicate support
6830 if (packet_support (PACKET_swbreak_feature) != PACKET_ENABLE)
6831 error (_("Unexpected swbreak stop reason"));
6833 /* The value part is documented as "must be empty",
6834 though we ignore it, in case we ever decide to make
6835 use of it in a backward compatible way. */
6836 p = strchrnul (p1 + 1, ';');
6838 else if (strprefix (p, p1, "hwbreak"))
6840 event->stop_reason = TARGET_STOPPED_BY_HW_BREAKPOINT;
6842 /* Make sure the stub doesn't forget to indicate support
6844 if (packet_support (PACKET_hwbreak_feature) != PACKET_ENABLE)
6845 error (_("Unexpected hwbreak stop reason"));
6848 p = strchrnul (p1 + 1, ';');
6850 else if (strprefix (p, p1, "library"))
6852 event->ws.kind = TARGET_WAITKIND_LOADED;
6853 p = strchrnul (p1 + 1, ';');
6855 else if (strprefix (p, p1, "replaylog"))
6857 event->ws.kind = TARGET_WAITKIND_NO_HISTORY;
6858 /* p1 will indicate "begin" or "end", but it makes
6859 no difference for now, so ignore it. */
6860 p = strchrnul (p1 + 1, ';');
6862 else if (strprefix (p, p1, "core"))
6866 p = unpack_varlen_hex (++p1, &c);
6869 else if (strprefix (p, p1, "fork"))
6871 event->ws.value.related_pid = read_ptid (++p1, &p);
6872 event->ws.kind = TARGET_WAITKIND_FORKED;
6874 else if (strprefix (p, p1, "vfork"))
6876 event->ws.value.related_pid = read_ptid (++p1, &p);
6877 event->ws.kind = TARGET_WAITKIND_VFORKED;
6879 else if (strprefix (p, p1, "vforkdone"))
6881 event->ws.kind = TARGET_WAITKIND_VFORK_DONE;
6882 p = strchrnul (p1 + 1, ';');
6884 else if (strprefix (p, p1, "exec"))
6887 char pathname[PATH_MAX];
6890 /* Determine the length of the execd pathname. */
6891 p = unpack_varlen_hex (++p1, &ignored);
6892 pathlen = (p - p1) / 2;
6894 /* Save the pathname for event reporting and for
6895 the next run command. */
6896 hex2bin (p1, (gdb_byte *) pathname, pathlen);
6897 pathname[pathlen] = '\0';
6899 /* This is freed during event handling. */
6900 event->ws.value.execd_pathname = xstrdup (pathname);
6901 event->ws.kind = TARGET_WAITKIND_EXECD;
6903 /* Skip the registers included in this packet, since
6904 they may be for an architecture different from the
6905 one used by the original program. */
6908 else if (strprefix (p, p1, "create"))
6910 event->ws.kind = TARGET_WAITKIND_THREAD_CREATED;
6911 p = strchrnul (p1 + 1, ';');
6920 p = strchrnul (p1 + 1, ';');
6925 /* Maybe a real ``P'' register number. */
6926 p_temp = unpack_varlen_hex (p, &pnum);
6927 /* If the first invalid character is the colon, we got a
6928 register number. Otherwise, it's an unknown stop
6932 /* If we haven't parsed the event's thread yet, find
6933 it now, in order to find the architecture of the
6934 reported expedited registers. */
6935 if (event->ptid == null_ptid)
6937 const char *thr = strstr (p1 + 1, ";thread:");
6939 event->ptid = read_ptid (thr + strlen (";thread:"),
6942 event->ptid = magic_null_ptid;
6947 inferior *inf = (event->ptid == null_ptid
6949 : find_inferior_ptid (event->ptid));
6950 /* If this is the first time we learn anything
6951 about this process, skip the registers
6952 included in this packet, since we don't yet
6953 know which architecture to use to parse them.
6954 We'll determine the architecture later when
6955 we process the stop reply and retrieve the
6956 target description, via
6957 remote_notice_new_inferior ->
6958 post_create_inferior. */
6961 p = strchrnul (p1 + 1, ';');
6966 event->arch = inf->gdbarch;
6967 rsa = get_remote_arch_state (event->arch);
6971 = packet_reg_from_pnum (event->arch, rsa, pnum);
6972 cached_reg_t cached_reg;
6975 error (_("Remote sent bad register number %s: %s\n\
6977 hex_string (pnum), p, buf);
6979 cached_reg.num = reg->regnum;
6980 cached_reg.data = (gdb_byte *)
6981 xmalloc (register_size (event->arch, reg->regnum));
6984 fieldsize = hex2bin (p, cached_reg.data,
6985 register_size (event->arch, reg->regnum));
6987 if (fieldsize < register_size (event->arch, reg->regnum))
6988 warning (_("Remote reply is too short: %s"), buf);
6990 VEC_safe_push (cached_reg_t, event->regcache, &cached_reg);
6994 /* Not a number. Silently skip unknown optional
6996 p = strchrnul (p1 + 1, ';');
7001 error (_("Remote register badly formatted: %s\nhere: %s"),
7006 if (event->ws.kind != TARGET_WAITKIND_IGNORE)
7010 case 'S': /* Old style status, just signal only. */
7014 event->ws.kind = TARGET_WAITKIND_STOPPED;
7015 sig = (fromhex (buf[1]) << 4) + fromhex (buf[2]);
7016 if (GDB_SIGNAL_FIRST <= sig && sig < GDB_SIGNAL_LAST)
7017 event->ws.value.sig = (enum gdb_signal) sig;
7019 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
7022 case 'w': /* Thread exited. */
7027 event->ws.kind = TARGET_WAITKIND_THREAD_EXITED;
7028 p = unpack_varlen_hex (&buf[1], &value);
7029 event->ws.value.integer = value;
7031 error (_("stop reply packet badly formatted: %s"), buf);
7032 event->ptid = read_ptid (++p, NULL);
7035 case 'W': /* Target exited. */
7042 /* GDB used to accept only 2 hex chars here. Stubs should
7043 only send more if they detect GDB supports multi-process
7045 p = unpack_varlen_hex (&buf[1], &value);
7049 /* The remote process exited. */
7050 event->ws.kind = TARGET_WAITKIND_EXITED;
7051 event->ws.value.integer = value;
7055 /* The remote process exited with a signal. */
7056 event->ws.kind = TARGET_WAITKIND_SIGNALLED;
7057 if (GDB_SIGNAL_FIRST <= value && value < GDB_SIGNAL_LAST)
7058 event->ws.value.sig = (enum gdb_signal) value;
7060 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
7063 /* If no process is specified, assume inferior_ptid. */
7064 pid = ptid_get_pid (inferior_ptid);
7073 else if (startswith (p, "process:"))
7077 p += sizeof ("process:") - 1;
7078 unpack_varlen_hex (p, &upid);
7082 error (_("unknown stop reply packet: %s"), buf);
7085 error (_("unknown stop reply packet: %s"), buf);
7086 event->ptid = pid_to_ptid (pid);
7090 event->ws.kind = TARGET_WAITKIND_NO_RESUMED;
7091 event->ptid = minus_one_ptid;
7095 if (target_is_non_stop_p () && ptid_equal (event->ptid, null_ptid))
7096 error (_("No process or thread specified in stop reply: %s"), buf);
7099 /* When the stub wants to tell GDB about a new notification reply, it
7100 sends a notification (%Stop, for example). Those can come it at
7101 any time, hence, we have to make sure that any pending
7102 putpkt/getpkt sequence we're making is finished, before querying
7103 the stub for more events with the corresponding ack command
7104 (vStopped, for example). E.g., if we started a vStopped sequence
7105 immediately upon receiving the notification, something like this
7113 1.6) <-- (registers reply to step #1.3)
7115 Obviously, the reply in step #1.6 would be unexpected to a vStopped
7118 To solve this, whenever we parse a %Stop notification successfully,
7119 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
7120 doing whatever we were doing:
7126 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
7127 2.5) <-- (registers reply to step #2.3)
7129 Eventualy after step #2.5, we return to the event loop, which
7130 notices there's an event on the
7131 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
7132 associated callback --- the function below. At this point, we're
7133 always safe to start a vStopped sequence. :
7136 2.7) <-- T05 thread:2
7142 remote_notif_get_pending_events (struct notif_client *nc)
7144 struct remote_state *rs = get_remote_state ();
7146 if (rs->notif_state->pending_event[nc->id] != NULL)
7149 fprintf_unfiltered (gdb_stdlog,
7150 "notif: process: '%s' ack pending event\n",
7154 nc->ack (nc, rs->buf, rs->notif_state->pending_event[nc->id]);
7155 rs->notif_state->pending_event[nc->id] = NULL;
7159 getpkt (&rs->buf, &rs->buf_size, 0);
7160 if (strcmp (rs->buf, "OK") == 0)
7163 remote_notif_ack (nc, rs->buf);
7169 fprintf_unfiltered (gdb_stdlog,
7170 "notif: process: '%s' no pending reply\n",
7175 /* Called when it is decided that STOP_REPLY holds the info of the
7176 event that is to be returned to the core. This function always
7177 destroys STOP_REPLY. */
7180 process_stop_reply (struct stop_reply *stop_reply,
7181 struct target_waitstatus *status)
7185 *status = stop_reply->ws;
7186 ptid = stop_reply->ptid;
7188 /* If no thread/process was reported by the stub, assume the current
7190 if (ptid_equal (ptid, null_ptid))
7191 ptid = inferior_ptid;
7193 if (status->kind != TARGET_WAITKIND_EXITED
7194 && status->kind != TARGET_WAITKIND_SIGNALLED
7195 && status->kind != TARGET_WAITKIND_NO_RESUMED)
7197 /* Expedited registers. */
7198 if (stop_reply->regcache)
7200 struct regcache *regcache
7201 = get_thread_arch_regcache (ptid, stop_reply->arch);
7206 VEC_iterate (cached_reg_t, stop_reply->regcache, ix, reg);
7209 regcache_raw_supply (regcache, reg->num, reg->data);
7213 VEC_free (cached_reg_t, stop_reply->regcache);
7216 remote_notice_new_inferior (ptid, 0);
7217 remote_thread_info *remote_thr = get_remote_thread_info (ptid);
7218 remote_thr->core = stop_reply->core;
7219 remote_thr->stop_reason = stop_reply->stop_reason;
7220 remote_thr->watch_data_address = stop_reply->watch_data_address;
7221 remote_thr->vcont_resumed = 0;
7224 stop_reply_xfree (stop_reply);
7228 /* The non-stop mode version of target_wait. */
7231 remote_wait_ns (ptid_t ptid, struct target_waitstatus *status, int options)
7233 struct remote_state *rs = get_remote_state ();
7234 struct stop_reply *stop_reply;
7238 /* If in non-stop mode, get out of getpkt even if a
7239 notification is received. */
7241 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
7242 0 /* forever */, &is_notif);
7245 if (ret != -1 && !is_notif)
7248 case 'E': /* Error of some sort. */
7249 /* We're out of sync with the target now. Did it continue
7250 or not? We can't tell which thread it was in non-stop,
7251 so just ignore this. */
7252 warning (_("Remote failure reply: %s"), rs->buf);
7254 case 'O': /* Console output. */
7255 remote_console_output (rs->buf + 1);
7258 warning (_("Invalid remote reply: %s"), rs->buf);
7262 /* Acknowledge a pending stop reply that may have arrived in the
7264 if (rs->notif_state->pending_event[notif_client_stop.id] != NULL)
7265 remote_notif_get_pending_events (¬if_client_stop);
7267 /* If indeed we noticed a stop reply, we're done. */
7268 stop_reply = queued_stop_reply (ptid);
7269 if (stop_reply != NULL)
7270 return process_stop_reply (stop_reply, status);
7272 /* Still no event. If we're just polling for an event, then
7273 return to the event loop. */
7274 if (options & TARGET_WNOHANG)
7276 status->kind = TARGET_WAITKIND_IGNORE;
7277 return minus_one_ptid;
7280 /* Otherwise do a blocking wait. */
7281 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
7282 1 /* forever */, &is_notif);
7286 /* Wait until the remote machine stops, then return, storing status in
7287 STATUS just as `wait' would. */
7290 remote_wait_as (ptid_t ptid, struct target_waitstatus *status, int options)
7292 struct remote_state *rs = get_remote_state ();
7293 ptid_t event_ptid = null_ptid;
7295 struct stop_reply *stop_reply;
7299 status->kind = TARGET_WAITKIND_IGNORE;
7300 status->value.integer = 0;
7302 stop_reply = queued_stop_reply (ptid);
7303 if (stop_reply != NULL)
7304 return process_stop_reply (stop_reply, status);
7306 if (rs->cached_wait_status)
7307 /* Use the cached wait status, but only once. */
7308 rs->cached_wait_status = 0;
7313 int forever = ((options & TARGET_WNOHANG) == 0
7314 && wait_forever_enabled_p);
7316 if (!rs->waiting_for_stop_reply)
7318 status->kind = TARGET_WAITKIND_NO_RESUMED;
7319 return minus_one_ptid;
7322 /* FIXME: cagney/1999-09-27: If we're in async mode we should
7323 _never_ wait for ever -> test on target_is_async_p().
7324 However, before we do that we need to ensure that the caller
7325 knows how to take the target into/out of async mode. */
7326 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
7327 forever, &is_notif);
7329 /* GDB gets a notification. Return to core as this event is
7331 if (ret != -1 && is_notif)
7332 return minus_one_ptid;
7334 if (ret == -1 && (options & TARGET_WNOHANG) != 0)
7335 return minus_one_ptid;
7340 /* Assume that the target has acknowledged Ctrl-C unless we receive
7341 an 'F' or 'O' packet. */
7342 if (buf[0] != 'F' && buf[0] != 'O')
7343 rs->ctrlc_pending_p = 0;
7347 case 'E': /* Error of some sort. */
7348 /* We're out of sync with the target now. Did it continue or
7349 not? Not is more likely, so report a stop. */
7350 rs->waiting_for_stop_reply = 0;
7352 warning (_("Remote failure reply: %s"), buf);
7353 status->kind = TARGET_WAITKIND_STOPPED;
7354 status->value.sig = GDB_SIGNAL_0;
7356 case 'F': /* File-I/O request. */
7357 /* GDB may access the inferior memory while handling the File-I/O
7358 request, but we don't want GDB accessing memory while waiting
7359 for a stop reply. See the comments in putpkt_binary. Set
7360 waiting_for_stop_reply to 0 temporarily. */
7361 rs->waiting_for_stop_reply = 0;
7362 remote_fileio_request (buf, rs->ctrlc_pending_p);
7363 rs->ctrlc_pending_p = 0;
7364 /* GDB handled the File-I/O request, and the target is running
7365 again. Keep waiting for events. */
7366 rs->waiting_for_stop_reply = 1;
7368 case 'N': case 'T': case 'S': case 'X': case 'W':
7370 struct stop_reply *stop_reply;
7372 /* There is a stop reply to handle. */
7373 rs->waiting_for_stop_reply = 0;
7376 = (struct stop_reply *) remote_notif_parse (¬if_client_stop,
7379 event_ptid = process_stop_reply (stop_reply, status);
7382 case 'O': /* Console output. */
7383 remote_console_output (buf + 1);
7386 if (rs->last_sent_signal != GDB_SIGNAL_0)
7388 /* Zero length reply means that we tried 'S' or 'C' and the
7389 remote system doesn't support it. */
7390 target_terminal::ours_for_output ();
7392 ("Can't send signals to this remote system. %s not sent.\n",
7393 gdb_signal_to_name (rs->last_sent_signal));
7394 rs->last_sent_signal = GDB_SIGNAL_0;
7395 target_terminal::inferior ();
7397 strcpy (buf, rs->last_sent_step ? "s" : "c");
7401 /* else fallthrough */
7403 warning (_("Invalid remote reply: %s"), buf);
7407 if (status->kind == TARGET_WAITKIND_NO_RESUMED)
7408 return minus_one_ptid;
7409 else if (status->kind == TARGET_WAITKIND_IGNORE)
7411 /* Nothing interesting happened. If we're doing a non-blocking
7412 poll, we're done. Otherwise, go back to waiting. */
7413 if (options & TARGET_WNOHANG)
7414 return minus_one_ptid;
7418 else if (status->kind != TARGET_WAITKIND_EXITED
7419 && status->kind != TARGET_WAITKIND_SIGNALLED)
7421 if (!ptid_equal (event_ptid, null_ptid))
7422 record_currthread (rs, event_ptid);
7424 event_ptid = inferior_ptid;
7427 /* A process exit. Invalidate our notion of current thread. */
7428 record_currthread (rs, minus_one_ptid);
7433 /* Wait until the remote machine stops, then return, storing status in
7434 STATUS just as `wait' would. */
7437 remote_wait (struct target_ops *ops,
7438 ptid_t ptid, struct target_waitstatus *status, int options)
7442 if (target_is_non_stop_p ())
7443 event_ptid = remote_wait_ns (ptid, status, options);
7445 event_ptid = remote_wait_as (ptid, status, options);
7447 if (target_is_async_p ())
7449 /* If there are are events left in the queue tell the event loop
7451 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
7452 mark_async_event_handler (remote_async_inferior_event_token);
7458 /* Fetch a single register using a 'p' packet. */
7461 fetch_register_using_p (struct regcache *regcache, struct packet_reg *reg)
7463 struct gdbarch *gdbarch = regcache->arch ();
7464 struct remote_state *rs = get_remote_state ();
7466 gdb_byte *regp = (gdb_byte *) alloca (register_size (gdbarch, reg->regnum));
7469 if (packet_support (PACKET_p) == PACKET_DISABLE)
7472 if (reg->pnum == -1)
7477 p += hexnumstr (p, reg->pnum);
7480 getpkt (&rs->buf, &rs->buf_size, 0);
7484 switch (packet_ok (buf, &remote_protocol_packets[PACKET_p]))
7488 case PACKET_UNKNOWN:
7491 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
7492 gdbarch_register_name (regcache->arch (),
7497 /* If this register is unfetchable, tell the regcache. */
7500 regcache_raw_supply (regcache, reg->regnum, NULL);
7504 /* Otherwise, parse and supply the value. */
7510 error (_("fetch_register_using_p: early buf termination"));
7512 regp[i++] = fromhex (p[0]) * 16 + fromhex (p[1]);
7515 regcache_raw_supply (regcache, reg->regnum, regp);
7519 /* Fetch the registers included in the target's 'g' packet. */
7522 send_g_packet (void)
7524 struct remote_state *rs = get_remote_state ();
7527 xsnprintf (rs->buf, get_remote_packet_size (), "g");
7528 remote_send (&rs->buf, &rs->buf_size);
7530 /* We can get out of synch in various cases. If the first character
7531 in the buffer is not a hex character, assume that has happened
7532 and try to fetch another packet to read. */
7533 while ((rs->buf[0] < '0' || rs->buf[0] > '9')
7534 && (rs->buf[0] < 'A' || rs->buf[0] > 'F')
7535 && (rs->buf[0] < 'a' || rs->buf[0] > 'f')
7536 && rs->buf[0] != 'x') /* New: unavailable register value. */
7539 fprintf_unfiltered (gdb_stdlog,
7540 "Bad register packet; fetching a new packet\n");
7541 getpkt (&rs->buf, &rs->buf_size, 0);
7544 buf_len = strlen (rs->buf);
7546 /* Sanity check the received packet. */
7547 if (buf_len % 2 != 0)
7548 error (_("Remote 'g' packet reply is of odd length: %s"), rs->buf);
7554 process_g_packet (struct regcache *regcache)
7556 struct gdbarch *gdbarch = regcache->arch ();
7557 struct remote_state *rs = get_remote_state ();
7558 remote_arch_state *rsa = get_remote_arch_state (gdbarch);
7563 buf_len = strlen (rs->buf);
7565 /* Further sanity checks, with knowledge of the architecture. */
7566 if (buf_len > 2 * rsa->sizeof_g_packet)
7567 error (_("Remote 'g' packet reply is too long (expected %ld bytes, got %d "
7568 "bytes): %s"), rsa->sizeof_g_packet, buf_len / 2, rs->buf);
7570 /* Save the size of the packet sent to us by the target. It is used
7571 as a heuristic when determining the max size of packets that the
7572 target can safely receive. */
7573 if (rsa->actual_register_packet_size == 0)
7574 rsa->actual_register_packet_size = buf_len;
7576 /* If this is smaller than we guessed the 'g' packet would be,
7577 update our records. A 'g' reply that doesn't include a register's
7578 value implies either that the register is not available, or that
7579 the 'p' packet must be used. */
7580 if (buf_len < 2 * rsa->sizeof_g_packet)
7582 long sizeof_g_packet = buf_len / 2;
7584 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
7586 long offset = rsa->regs[i].offset;
7587 long reg_size = register_size (gdbarch, i);
7589 if (rsa->regs[i].pnum == -1)
7592 if (offset >= sizeof_g_packet)
7593 rsa->regs[i].in_g_packet = 0;
7594 else if (offset + reg_size > sizeof_g_packet)
7595 error (_("Truncated register %d in remote 'g' packet"), i);
7597 rsa->regs[i].in_g_packet = 1;
7600 /* Looks valid enough, we can assume this is the correct length
7601 for a 'g' packet. It's important not to adjust
7602 rsa->sizeof_g_packet if we have truncated registers otherwise
7603 this "if" won't be run the next time the method is called
7604 with a packet of the same size and one of the internal errors
7605 below will trigger instead. */
7606 rsa->sizeof_g_packet = sizeof_g_packet;
7609 regs = (char *) alloca (rsa->sizeof_g_packet);
7611 /* Unimplemented registers read as all bits zero. */
7612 memset (regs, 0, rsa->sizeof_g_packet);
7614 /* Reply describes registers byte by byte, each byte encoded as two
7615 hex characters. Suck them all up, then supply them to the
7616 register cacheing/storage mechanism. */
7619 for (i = 0; i < rsa->sizeof_g_packet; i++)
7621 if (p[0] == 0 || p[1] == 0)
7622 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
7623 internal_error (__FILE__, __LINE__,
7624 _("unexpected end of 'g' packet reply"));
7626 if (p[0] == 'x' && p[1] == 'x')
7627 regs[i] = 0; /* 'x' */
7629 regs[i] = fromhex (p[0]) * 16 + fromhex (p[1]);
7633 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
7635 struct packet_reg *r = &rsa->regs[i];
7636 long reg_size = register_size (gdbarch, i);
7640 if ((r->offset + reg_size) * 2 > strlen (rs->buf))
7641 /* This shouldn't happen - we adjusted in_g_packet above. */
7642 internal_error (__FILE__, __LINE__,
7643 _("unexpected end of 'g' packet reply"));
7644 else if (rs->buf[r->offset * 2] == 'x')
7646 gdb_assert (r->offset * 2 < strlen (rs->buf));
7647 /* The register isn't available, mark it as such (at
7648 the same time setting the value to zero). */
7649 regcache_raw_supply (regcache, r->regnum, NULL);
7652 regcache_raw_supply (regcache, r->regnum,
7659 fetch_registers_using_g (struct regcache *regcache)
7662 process_g_packet (regcache);
7665 /* Make the remote selected traceframe match GDB's selected
7669 set_remote_traceframe (void)
7672 struct remote_state *rs = get_remote_state ();
7674 if (rs->remote_traceframe_number == get_traceframe_number ())
7677 /* Avoid recursion, remote_trace_find calls us again. */
7678 rs->remote_traceframe_number = get_traceframe_number ();
7680 newnum = target_trace_find (tfind_number,
7681 get_traceframe_number (), 0, 0, NULL);
7683 /* Should not happen. If it does, all bets are off. */
7684 if (newnum != get_traceframe_number ())
7685 warning (_("could not set remote traceframe"));
7689 remote_fetch_registers (struct target_ops *ops,
7690 struct regcache *regcache, int regnum)
7692 struct gdbarch *gdbarch = regcache->arch ();
7693 remote_arch_state *rsa = get_remote_arch_state (gdbarch);
7696 set_remote_traceframe ();
7697 set_general_thread (regcache_get_ptid (regcache));
7701 packet_reg *reg = packet_reg_from_regnum (gdbarch, rsa, regnum);
7703 gdb_assert (reg != NULL);
7705 /* If this register might be in the 'g' packet, try that first -
7706 we are likely to read more than one register. If this is the
7707 first 'g' packet, we might be overly optimistic about its
7708 contents, so fall back to 'p'. */
7709 if (reg->in_g_packet)
7711 fetch_registers_using_g (regcache);
7712 if (reg->in_g_packet)
7716 if (fetch_register_using_p (regcache, reg))
7719 /* This register is not available. */
7720 regcache_raw_supply (regcache, reg->regnum, NULL);
7725 fetch_registers_using_g (regcache);
7727 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
7728 if (!rsa->regs[i].in_g_packet)
7729 if (!fetch_register_using_p (regcache, &rsa->regs[i]))
7731 /* This register is not available. */
7732 regcache_raw_supply (regcache, i, NULL);
7736 /* Prepare to store registers. Since we may send them all (using a
7737 'G' request), we have to read out the ones we don't want to change
7741 remote_prepare_to_store (struct target_ops *self, struct regcache *regcache)
7743 remote_arch_state *rsa = get_remote_arch_state (regcache->arch ());
7746 /* Make sure the entire registers array is valid. */
7747 switch (packet_support (PACKET_P))
7749 case PACKET_DISABLE:
7750 case PACKET_SUPPORT_UNKNOWN:
7751 /* Make sure all the necessary registers are cached. */
7752 for (i = 0; i < gdbarch_num_regs (regcache->arch ()); i++)
7753 if (rsa->regs[i].in_g_packet)
7754 regcache_raw_update (regcache, rsa->regs[i].regnum);
7761 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
7762 packet was not recognized. */
7765 store_register_using_P (const struct regcache *regcache,
7766 struct packet_reg *reg)
7768 struct gdbarch *gdbarch = regcache->arch ();
7769 struct remote_state *rs = get_remote_state ();
7770 /* Try storing a single register. */
7771 char *buf = rs->buf;
7772 gdb_byte *regp = (gdb_byte *) alloca (register_size (gdbarch, reg->regnum));
7775 if (packet_support (PACKET_P) == PACKET_DISABLE)
7778 if (reg->pnum == -1)
7781 xsnprintf (buf, get_remote_packet_size (), "P%s=", phex_nz (reg->pnum, 0));
7782 p = buf + strlen (buf);
7783 regcache_raw_collect (regcache, reg->regnum, regp);
7784 bin2hex (regp, p, register_size (gdbarch, reg->regnum));
7786 getpkt (&rs->buf, &rs->buf_size, 0);
7788 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_P]))
7793 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
7794 gdbarch_register_name (gdbarch, reg->regnum), rs->buf);
7795 case PACKET_UNKNOWN:
7798 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
7802 /* Store register REGNUM, or all registers if REGNUM == -1, from the
7803 contents of the register cache buffer. FIXME: ignores errors. */
7806 store_registers_using_G (const struct regcache *regcache)
7808 struct remote_state *rs = get_remote_state ();
7809 remote_arch_state *rsa = get_remote_arch_state (regcache->arch ());
7813 /* Extract all the registers in the regcache copying them into a
7818 regs = (gdb_byte *) alloca (rsa->sizeof_g_packet);
7819 memset (regs, 0, rsa->sizeof_g_packet);
7820 for (i = 0; i < gdbarch_num_regs (regcache->arch ()); i++)
7822 struct packet_reg *r = &rsa->regs[i];
7825 regcache_raw_collect (regcache, r->regnum, regs + r->offset);
7829 /* Command describes registers byte by byte,
7830 each byte encoded as two hex characters. */
7833 bin2hex (regs, p, rsa->sizeof_g_packet);
7835 getpkt (&rs->buf, &rs->buf_size, 0);
7836 if (packet_check_result (rs->buf) == PACKET_ERROR)
7837 error (_("Could not write registers; remote failure reply '%s'"),
7841 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
7842 of the register cache buffer. FIXME: ignores errors. */
7845 remote_store_registers (struct target_ops *ops,
7846 struct regcache *regcache, int regnum)
7848 struct gdbarch *gdbarch = regcache->arch ();
7849 remote_arch_state *rsa = get_remote_arch_state (gdbarch);
7852 set_remote_traceframe ();
7853 set_general_thread (regcache_get_ptid (regcache));
7857 packet_reg *reg = packet_reg_from_regnum (gdbarch, rsa, regnum);
7859 gdb_assert (reg != NULL);
7861 /* Always prefer to store registers using the 'P' packet if
7862 possible; we often change only a small number of registers.
7863 Sometimes we change a larger number; we'd need help from a
7864 higher layer to know to use 'G'. */
7865 if (store_register_using_P (regcache, reg))
7868 /* For now, don't complain if we have no way to write the
7869 register. GDB loses track of unavailable registers too
7870 easily. Some day, this may be an error. We don't have
7871 any way to read the register, either... */
7872 if (!reg->in_g_packet)
7875 store_registers_using_G (regcache);
7879 store_registers_using_G (regcache);
7881 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
7882 if (!rsa->regs[i].in_g_packet)
7883 if (!store_register_using_P (regcache, &rsa->regs[i]))
7884 /* See above for why we do not issue an error here. */
7889 /* Return the number of hex digits in num. */
7892 hexnumlen (ULONGEST num)
7896 for (i = 0; num != 0; i++)
7899 return std::max (i, 1);
7902 /* Set BUF to the minimum number of hex digits representing NUM. */
7905 hexnumstr (char *buf, ULONGEST num)
7907 int len = hexnumlen (num);
7909 return hexnumnstr (buf, num, len);
7913 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
7916 hexnumnstr (char *buf, ULONGEST num, int width)
7922 for (i = width - 1; i >= 0; i--)
7924 buf[i] = "0123456789abcdef"[(num & 0xf)];
7931 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
7934 remote_address_masked (CORE_ADDR addr)
7936 unsigned int address_size = remote_address_size;
7938 /* If "remoteaddresssize" was not set, default to target address size. */
7940 address_size = gdbarch_addr_bit (target_gdbarch ());
7942 if (address_size > 0
7943 && address_size < (sizeof (ULONGEST) * 8))
7945 /* Only create a mask when that mask can safely be constructed
7946 in a ULONGEST variable. */
7949 mask = (mask << address_size) - 1;
7955 /* Determine whether the remote target supports binary downloading.
7956 This is accomplished by sending a no-op memory write of zero length
7957 to the target at the specified address. It does not suffice to send
7958 the whole packet, since many stubs strip the eighth bit and
7959 subsequently compute a wrong checksum, which causes real havoc with
7962 NOTE: This can still lose if the serial line is not eight-bit
7963 clean. In cases like this, the user should clear "remote
7967 check_binary_download (CORE_ADDR addr)
7969 struct remote_state *rs = get_remote_state ();
7971 switch (packet_support (PACKET_X))
7973 case PACKET_DISABLE:
7977 case PACKET_SUPPORT_UNKNOWN:
7983 p += hexnumstr (p, (ULONGEST) addr);
7985 p += hexnumstr (p, (ULONGEST) 0);
7989 putpkt_binary (rs->buf, (int) (p - rs->buf));
7990 getpkt (&rs->buf, &rs->buf_size, 0);
7992 if (rs->buf[0] == '\0')
7995 fprintf_unfiltered (gdb_stdlog,
7996 "binary downloading NOT "
7997 "supported by target\n");
7998 remote_protocol_packets[PACKET_X].support = PACKET_DISABLE;
8003 fprintf_unfiltered (gdb_stdlog,
8004 "binary downloading supported by target\n");
8005 remote_protocol_packets[PACKET_X].support = PACKET_ENABLE;
8012 /* Helper function to resize the payload in order to try to get a good
8013 alignment. We try to write an amount of data such that the next write will
8014 start on an address aligned on REMOTE_ALIGN_WRITES. */
8017 align_for_efficient_write (int todo, CORE_ADDR memaddr)
8019 return ((memaddr + todo) & ~(REMOTE_ALIGN_WRITES - 1)) - memaddr;
8022 /* Write memory data directly to the remote machine.
8023 This does not inform the data cache; the data cache uses this.
8024 HEADER is the starting part of the packet.
8025 MEMADDR is the address in the remote memory space.
8026 MYADDR is the address of the buffer in our space.
8027 LEN_UNITS is the number of addressable units to write.
8028 UNIT_SIZE is the length in bytes of an addressable unit.
8029 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
8030 should send data as binary ('X'), or hex-encoded ('M').
8032 The function creates packet of the form
8033 <HEADER><ADDRESS>,<LENGTH>:<DATA>
8035 where encoding of <DATA> is terminated by PACKET_FORMAT.
8037 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
8040 Return the transferred status, error or OK (an
8041 'enum target_xfer_status' value). Save the number of addressable units
8042 transferred in *XFERED_LEN_UNITS. Only transfer a single packet.
8044 On a platform with an addressable memory size of 2 bytes (UNIT_SIZE == 2), an
8045 exchange between gdb and the stub could look like (?? in place of the
8051 -> $M1000,3:eeeeffffeeee#??
8055 <- eeeeffffeeeedddd */
8057 static enum target_xfer_status
8058 remote_write_bytes_aux (const char *header, CORE_ADDR memaddr,
8059 const gdb_byte *myaddr, ULONGEST len_units,
8060 int unit_size, ULONGEST *xfered_len_units,
8061 char packet_format, int use_length)
8063 struct remote_state *rs = get_remote_state ();
8069 int payload_capacity_bytes;
8070 int payload_length_bytes;
8072 if (packet_format != 'X' && packet_format != 'M')
8073 internal_error (__FILE__, __LINE__,
8074 _("remote_write_bytes_aux: bad packet format"));
8077 return TARGET_XFER_EOF;
8079 payload_capacity_bytes = get_memory_write_packet_size ();
8081 /* The packet buffer will be large enough for the payload;
8082 get_memory_packet_size ensures this. */
8085 /* Compute the size of the actual payload by subtracting out the
8086 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
8088 payload_capacity_bytes -= strlen ("$,:#NN");
8090 /* The comma won't be used. */
8091 payload_capacity_bytes += 1;
8092 payload_capacity_bytes -= strlen (header);
8093 payload_capacity_bytes -= hexnumlen (memaddr);
8095 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
8097 strcat (rs->buf, header);
8098 p = rs->buf + strlen (header);
8100 /* Compute a best guess of the number of bytes actually transfered. */
8101 if (packet_format == 'X')
8103 /* Best guess at number of bytes that will fit. */
8104 todo_units = std::min (len_units,
8105 (ULONGEST) payload_capacity_bytes / unit_size);
8107 payload_capacity_bytes -= hexnumlen (todo_units);
8108 todo_units = std::min (todo_units, payload_capacity_bytes / unit_size);
8112 /* Number of bytes that will fit. */
8114 = std::min (len_units,
8115 (ULONGEST) (payload_capacity_bytes / unit_size) / 2);
8117 payload_capacity_bytes -= hexnumlen (todo_units);
8118 todo_units = std::min (todo_units,
8119 (payload_capacity_bytes / unit_size) / 2);
8122 if (todo_units <= 0)
8123 internal_error (__FILE__, __LINE__,
8124 _("minimum packet size too small to write data"));
8126 /* If we already need another packet, then try to align the end
8127 of this packet to a useful boundary. */
8128 if (todo_units > 2 * REMOTE_ALIGN_WRITES && todo_units < len_units)
8129 todo_units = align_for_efficient_write (todo_units, memaddr);
8131 /* Append "<memaddr>". */
8132 memaddr = remote_address_masked (memaddr);
8133 p += hexnumstr (p, (ULONGEST) memaddr);
8140 /* Append the length and retain its location and size. It may need to be
8141 adjusted once the packet body has been created. */
8143 plenlen = hexnumstr (p, (ULONGEST) todo_units);
8151 /* Append the packet body. */
8152 if (packet_format == 'X')
8154 /* Binary mode. Send target system values byte by byte, in
8155 increasing byte addresses. Only escape certain critical
8157 payload_length_bytes =
8158 remote_escape_output (myaddr, todo_units, unit_size, (gdb_byte *) p,
8159 &units_written, payload_capacity_bytes);
8161 /* If not all TODO units fit, then we'll need another packet. Make
8162 a second try to keep the end of the packet aligned. Don't do
8163 this if the packet is tiny. */
8164 if (units_written < todo_units && units_written > 2 * REMOTE_ALIGN_WRITES)
8168 new_todo_units = align_for_efficient_write (units_written, memaddr);
8170 if (new_todo_units != units_written)
8171 payload_length_bytes =
8172 remote_escape_output (myaddr, new_todo_units, unit_size,
8173 (gdb_byte *) p, &units_written,
8174 payload_capacity_bytes);
8177 p += payload_length_bytes;
8178 if (use_length && units_written < todo_units)
8180 /* Escape chars have filled up the buffer prematurely,
8181 and we have actually sent fewer units than planned.
8182 Fix-up the length field of the packet. Use the same
8183 number of characters as before. */
8184 plen += hexnumnstr (plen, (ULONGEST) units_written,
8186 *plen = ':'; /* overwrite \0 from hexnumnstr() */
8191 /* Normal mode: Send target system values byte by byte, in
8192 increasing byte addresses. Each byte is encoded as a two hex
8194 p += 2 * bin2hex (myaddr, p, todo_units * unit_size);
8195 units_written = todo_units;
8198 putpkt_binary (rs->buf, (int) (p - rs->buf));
8199 getpkt (&rs->buf, &rs->buf_size, 0);
8201 if (rs->buf[0] == 'E')
8202 return TARGET_XFER_E_IO;
8204 /* Return UNITS_WRITTEN, not TODO_UNITS, in case escape chars caused us to
8205 send fewer units than we'd planned. */
8206 *xfered_len_units = (ULONGEST) units_written;
8207 return (*xfered_len_units != 0) ? TARGET_XFER_OK : TARGET_XFER_EOF;
8210 /* Write memory data directly to the remote machine.
8211 This does not inform the data cache; the data cache uses this.
8212 MEMADDR is the address in the remote memory space.
8213 MYADDR is the address of the buffer in our space.
8214 LEN is the number of bytes.
8216 Return the transferred status, error or OK (an
8217 'enum target_xfer_status' value). Save the number of bytes
8218 transferred in *XFERED_LEN. Only transfer a single packet. */
8220 static enum target_xfer_status
8221 remote_write_bytes (CORE_ADDR memaddr, const gdb_byte *myaddr, ULONGEST len,
8222 int unit_size, ULONGEST *xfered_len)
8224 const char *packet_format = NULL;
8226 /* Check whether the target supports binary download. */
8227 check_binary_download (memaddr);
8229 switch (packet_support (PACKET_X))
8232 packet_format = "X";
8234 case PACKET_DISABLE:
8235 packet_format = "M";
8237 case PACKET_SUPPORT_UNKNOWN:
8238 internal_error (__FILE__, __LINE__,
8239 _("remote_write_bytes: bad internal state"));
8241 internal_error (__FILE__, __LINE__, _("bad switch"));
8244 return remote_write_bytes_aux (packet_format,
8245 memaddr, myaddr, len, unit_size, xfered_len,
8246 packet_format[0], 1);
8249 /* Read memory data directly from the remote machine.
8250 This does not use the data cache; the data cache uses this.
8251 MEMADDR is the address in the remote memory space.
8252 MYADDR is the address of the buffer in our space.
8253 LEN_UNITS is the number of addressable memory units to read..
8254 UNIT_SIZE is the length in bytes of an addressable unit.
8256 Return the transferred status, error or OK (an
8257 'enum target_xfer_status' value). Save the number of bytes
8258 transferred in *XFERED_LEN_UNITS.
8260 See the comment of remote_write_bytes_aux for an example of
8261 memory read/write exchange between gdb and the stub. */
8263 static enum target_xfer_status
8264 remote_read_bytes_1 (CORE_ADDR memaddr, gdb_byte *myaddr, ULONGEST len_units,
8265 int unit_size, ULONGEST *xfered_len_units)
8267 struct remote_state *rs = get_remote_state ();
8268 int buf_size_bytes; /* Max size of packet output buffer. */
8273 buf_size_bytes = get_memory_read_packet_size ();
8274 /* The packet buffer will be large enough for the payload;
8275 get_memory_packet_size ensures this. */
8277 /* Number of units that will fit. */
8278 todo_units = std::min (len_units,
8279 (ULONGEST) (buf_size_bytes / unit_size) / 2);
8281 /* Construct "m"<memaddr>","<len>". */
8282 memaddr = remote_address_masked (memaddr);
8285 p += hexnumstr (p, (ULONGEST) memaddr);
8287 p += hexnumstr (p, (ULONGEST) todo_units);
8290 getpkt (&rs->buf, &rs->buf_size, 0);
8291 if (rs->buf[0] == 'E'
8292 && isxdigit (rs->buf[1]) && isxdigit (rs->buf[2])
8293 && rs->buf[3] == '\0')
8294 return TARGET_XFER_E_IO;
8295 /* Reply describes memory byte by byte, each byte encoded as two hex
8298 decoded_bytes = hex2bin (p, myaddr, todo_units * unit_size);
8299 /* Return what we have. Let higher layers handle partial reads. */
8300 *xfered_len_units = (ULONGEST) (decoded_bytes / unit_size);
8301 return (*xfered_len_units != 0) ? TARGET_XFER_OK : TARGET_XFER_EOF;
8304 /* Using the set of read-only target sections of remote, read live
8307 For interface/parameters/return description see target.h,
8310 static enum target_xfer_status
8311 remote_xfer_live_readonly_partial (struct target_ops *ops, gdb_byte *readbuf,
8312 ULONGEST memaddr, ULONGEST len,
8313 int unit_size, ULONGEST *xfered_len)
8315 struct target_section *secp;
8316 struct target_section_table *table;
8318 secp = target_section_by_addr (ops, memaddr);
8320 && (bfd_get_section_flags (secp->the_bfd_section->owner,
8321 secp->the_bfd_section)
8324 struct target_section *p;
8325 ULONGEST memend = memaddr + len;
8327 table = target_get_section_table (ops);
8329 for (p = table->sections; p < table->sections_end; p++)
8331 if (memaddr >= p->addr)
8333 if (memend <= p->endaddr)
8335 /* Entire transfer is within this section. */
8336 return remote_read_bytes_1 (memaddr, readbuf, len, unit_size,
8339 else if (memaddr >= p->endaddr)
8341 /* This section ends before the transfer starts. */
8346 /* This section overlaps the transfer. Just do half. */
8347 len = p->endaddr - memaddr;
8348 return remote_read_bytes_1 (memaddr, readbuf, len, unit_size,
8355 return TARGET_XFER_EOF;
8358 /* Similar to remote_read_bytes_1, but it reads from the remote stub
8359 first if the requested memory is unavailable in traceframe.
8360 Otherwise, fall back to remote_read_bytes_1. */
8362 static enum target_xfer_status
8363 remote_read_bytes (struct target_ops *ops, CORE_ADDR memaddr,
8364 gdb_byte *myaddr, ULONGEST len, int unit_size,
8365 ULONGEST *xfered_len)
8368 return TARGET_XFER_EOF;
8370 if (get_traceframe_number () != -1)
8372 std::vector<mem_range> available;
8374 /* If we fail to get the set of available memory, then the
8375 target does not support querying traceframe info, and so we
8376 attempt reading from the traceframe anyway (assuming the
8377 target implements the old QTro packet then). */
8378 if (traceframe_available_memory (&available, memaddr, len))
8380 if (available.empty () || available[0].start != memaddr)
8382 enum target_xfer_status res;
8384 /* Don't read into the traceframe's available
8386 if (!available.empty ())
8388 LONGEST oldlen = len;
8390 len = available[0].start - memaddr;
8391 gdb_assert (len <= oldlen);
8394 /* This goes through the topmost target again. */
8395 res = remote_xfer_live_readonly_partial (ops, myaddr, memaddr,
8396 len, unit_size, xfered_len);
8397 if (res == TARGET_XFER_OK)
8398 return TARGET_XFER_OK;
8401 /* No use trying further, we know some memory starting
8402 at MEMADDR isn't available. */
8404 return (*xfered_len != 0) ?
8405 TARGET_XFER_UNAVAILABLE : TARGET_XFER_EOF;
8409 /* Don't try to read more than how much is available, in
8410 case the target implements the deprecated QTro packet to
8411 cater for older GDBs (the target's knowledge of read-only
8412 sections may be outdated by now). */
8413 len = available[0].length;
8417 return remote_read_bytes_1 (memaddr, myaddr, len, unit_size, xfered_len);
8422 /* Sends a packet with content determined by the printf format string
8423 FORMAT and the remaining arguments, then gets the reply. Returns
8424 whether the packet was a success, a failure, or unknown. */
8426 static enum packet_result remote_send_printf (const char *format, ...)
8427 ATTRIBUTE_PRINTF (1, 2);
8429 static enum packet_result
8430 remote_send_printf (const char *format, ...)
8432 struct remote_state *rs = get_remote_state ();
8433 int max_size = get_remote_packet_size ();
8436 va_start (ap, format);
8439 if (vsnprintf (rs->buf, max_size, format, ap) >= max_size)
8440 internal_error (__FILE__, __LINE__, _("Too long remote packet."));
8442 if (putpkt (rs->buf) < 0)
8443 error (_("Communication problem with target."));
8446 getpkt (&rs->buf, &rs->buf_size, 0);
8448 return packet_check_result (rs->buf);
8451 /* Flash writing can take quite some time. We'll set
8452 effectively infinite timeout for flash operations.
8453 In future, we'll need to decide on a better approach. */
8454 static const int remote_flash_timeout = 1000;
8457 remote_flash_erase (struct target_ops *ops,
8458 ULONGEST address, LONGEST length)
8460 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
8461 enum packet_result ret;
8462 scoped_restore restore_timeout
8463 = make_scoped_restore (&remote_timeout, remote_flash_timeout);
8465 ret = remote_send_printf ("vFlashErase:%s,%s",
8466 phex (address, addr_size),
8470 case PACKET_UNKNOWN:
8471 error (_("Remote target does not support flash erase"));
8473 error (_("Error erasing flash with vFlashErase packet"));
8479 static enum target_xfer_status
8480 remote_flash_write (struct target_ops *ops, ULONGEST address,
8481 ULONGEST length, ULONGEST *xfered_len,
8482 const gdb_byte *data)
8484 scoped_restore restore_timeout
8485 = make_scoped_restore (&remote_timeout, remote_flash_timeout);
8486 return remote_write_bytes_aux ("vFlashWrite:", address, data, length, 1,
8491 remote_flash_done (struct target_ops *ops)
8495 scoped_restore restore_timeout
8496 = make_scoped_restore (&remote_timeout, remote_flash_timeout);
8498 ret = remote_send_printf ("vFlashDone");
8502 case PACKET_UNKNOWN:
8503 error (_("Remote target does not support vFlashDone"));
8505 error (_("Error finishing flash operation"));
8512 remote_files_info (struct target_ops *ignore)
8514 puts_filtered ("Debugging a target over a serial line.\n");
8517 /* Stuff for dealing with the packets which are part of this protocol.
8518 See comment at top of file for details. */
8520 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
8521 error to higher layers. Called when a serial error is detected.
8522 The exception message is STRING, followed by a colon and a blank,
8523 the system error message for errno at function entry and final dot
8524 for output compatibility with throw_perror_with_name. */
8527 unpush_and_perror (const char *string)
8529 int saved_errno = errno;
8531 remote_unpush_target ();
8532 throw_error (TARGET_CLOSE_ERROR, "%s: %s.", string,
8533 safe_strerror (saved_errno));
8536 /* Read a single character from the remote end. The current quit
8537 handler is overridden to avoid quitting in the middle of packet
8538 sequence, as that would break communication with the remote server.
8539 See remote_serial_quit_handler for more detail. */
8542 readchar (int timeout)
8545 struct remote_state *rs = get_remote_state ();
8548 scoped_restore restore_quit
8549 = make_scoped_restore (&quit_handler, remote_serial_quit_handler);
8551 rs->got_ctrlc_during_io = 0;
8553 ch = serial_readchar (rs->remote_desc, timeout);
8555 if (rs->got_ctrlc_during_io)
8562 switch ((enum serial_rc) ch)
8565 remote_unpush_target ();
8566 throw_error (TARGET_CLOSE_ERROR, _("Remote connection closed"));
8569 unpush_and_perror (_("Remote communication error. "
8570 "Target disconnected."));
8572 case SERIAL_TIMEOUT:
8578 /* Wrapper for serial_write that closes the target and throws if
8579 writing fails. The current quit handler is overridden to avoid
8580 quitting in the middle of packet sequence, as that would break
8581 communication with the remote server. See
8582 remote_serial_quit_handler for more detail. */
8585 remote_serial_write (const char *str, int len)
8587 struct remote_state *rs = get_remote_state ();
8589 scoped_restore restore_quit
8590 = make_scoped_restore (&quit_handler, remote_serial_quit_handler);
8592 rs->got_ctrlc_during_io = 0;
8594 if (serial_write (rs->remote_desc, str, len))
8596 unpush_and_perror (_("Remote communication error. "
8597 "Target disconnected."));
8600 if (rs->got_ctrlc_during_io)
8604 /* Send the command in *BUF to the remote machine, and read the reply
8605 into *BUF. Report an error if we get an error reply. Resize
8606 *BUF using xrealloc if necessary to hold the result, and update
8610 remote_send (char **buf,
8614 getpkt (buf, sizeof_buf, 0);
8616 if ((*buf)[0] == 'E')
8617 error (_("Remote failure reply: %s"), *buf);
8620 /* Return a string representing an escaped version of BUF, of len N.
8621 E.g. \n is converted to \\n, \t to \\t, etc. */
8624 escape_buffer (const char *buf, int n)
8628 stb.putstrn (buf, n, '\\');
8629 return std::move (stb.string ());
8632 /* Display a null-terminated packet on stdout, for debugging, using C
8636 print_packet (const char *buf)
8638 puts_filtered ("\"");
8639 fputstr_filtered (buf, '"', gdb_stdout);
8640 puts_filtered ("\"");
8644 putpkt (const char *buf)
8646 return putpkt_binary (buf, strlen (buf));
8649 /* Send a packet to the remote machine, with error checking. The data
8650 of the packet is in BUF. The string in BUF can be at most
8651 get_remote_packet_size () - 5 to account for the $, # and checksum,
8652 and for a possible /0 if we are debugging (remote_debug) and want
8653 to print the sent packet as a string. */
8656 putpkt_binary (const char *buf, int cnt)
8658 struct remote_state *rs = get_remote_state ();
8660 unsigned char csum = 0;
8661 gdb::def_vector<char> data (cnt + 6);
8662 char *buf2 = data.data ();
8668 /* Catch cases like trying to read memory or listing threads while
8669 we're waiting for a stop reply. The remote server wouldn't be
8670 ready to handle this request, so we'd hang and timeout. We don't
8671 have to worry about this in synchronous mode, because in that
8672 case it's not possible to issue a command while the target is
8673 running. This is not a problem in non-stop mode, because in that
8674 case, the stub is always ready to process serial input. */
8675 if (!target_is_non_stop_p ()
8676 && target_is_async_p ()
8677 && rs->waiting_for_stop_reply)
8679 error (_("Cannot execute this command while the target is running.\n"
8680 "Use the \"interrupt\" command to stop the target\n"
8681 "and then try again."));
8684 /* We're sending out a new packet. Make sure we don't look at a
8685 stale cached response. */
8686 rs->cached_wait_status = 0;
8688 /* Copy the packet into buffer BUF2, encapsulating it
8689 and giving it a checksum. */
8694 for (i = 0; i < cnt; i++)
8700 *p++ = tohex ((csum >> 4) & 0xf);
8701 *p++ = tohex (csum & 0xf);
8703 /* Send it over and over until we get a positive ack. */
8707 int started_error_output = 0;
8713 int len = (int) (p - buf2);
8716 = escape_buffer (buf2, std::min (len, REMOTE_DEBUG_MAX_CHAR));
8718 fprintf_unfiltered (gdb_stdlog, "Sending packet: %s", str.c_str ());
8720 if (str.length () > REMOTE_DEBUG_MAX_CHAR)
8722 fprintf_unfiltered (gdb_stdlog, "[%zu bytes omitted]",
8723 str.length () - REMOTE_DEBUG_MAX_CHAR);
8726 fprintf_unfiltered (gdb_stdlog, "...");
8728 gdb_flush (gdb_stdlog);
8730 remote_serial_write (buf2, p - buf2);
8732 /* If this is a no acks version of the remote protocol, send the
8733 packet and move on. */
8737 /* Read until either a timeout occurs (-2) or '+' is read.
8738 Handle any notification that arrives in the mean time. */
8741 ch = readchar (remote_timeout);
8749 case SERIAL_TIMEOUT:
8752 if (started_error_output)
8754 putchar_unfiltered ('\n');
8755 started_error_output = 0;
8764 fprintf_unfiltered (gdb_stdlog, "Ack\n");
8768 fprintf_unfiltered (gdb_stdlog, "Nak\n");
8770 case SERIAL_TIMEOUT:
8774 break; /* Retransmit buffer. */
8778 fprintf_unfiltered (gdb_stdlog,
8779 "Packet instead of Ack, ignoring it\n");
8780 /* It's probably an old response sent because an ACK
8781 was lost. Gobble up the packet and ack it so it
8782 doesn't get retransmitted when we resend this
8785 remote_serial_write ("+", 1);
8786 continue; /* Now, go look for +. */
8793 /* If we got a notification, handle it, and go back to looking
8795 /* We've found the start of a notification. Now
8796 collect the data. */
8797 val = read_frame (&rs->buf, &rs->buf_size);
8802 std::string str = escape_buffer (rs->buf, val);
8804 fprintf_unfiltered (gdb_stdlog,
8805 " Notification received: %s\n",
8808 handle_notification (rs->notif_state, rs->buf);
8809 /* We're in sync now, rewait for the ack. */
8816 if (!started_error_output)
8818 started_error_output = 1;
8819 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
8821 fputc_unfiltered (ch & 0177, gdb_stdlog);
8822 fprintf_unfiltered (gdb_stdlog, "%s", rs->buf);
8831 if (!started_error_output)
8833 started_error_output = 1;
8834 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
8836 fputc_unfiltered (ch & 0177, gdb_stdlog);
8840 break; /* Here to retransmit. */
8844 /* This is wrong. If doing a long backtrace, the user should be
8845 able to get out next time we call QUIT, without anything as
8846 violent as interrupt_query. If we want to provide a way out of
8847 here without getting to the next QUIT, it should be based on
8848 hitting ^C twice as in remote_wait. */
8860 /* Come here after finding the start of a frame when we expected an
8861 ack. Do our best to discard the rest of this packet. */
8870 c = readchar (remote_timeout);
8873 case SERIAL_TIMEOUT:
8874 /* Nothing we can do. */
8877 /* Discard the two bytes of checksum and stop. */
8878 c = readchar (remote_timeout);
8880 c = readchar (remote_timeout);
8883 case '*': /* Run length encoding. */
8884 /* Discard the repeat count. */
8885 c = readchar (remote_timeout);
8890 /* A regular character. */
8896 /* Come here after finding the start of the frame. Collect the rest
8897 into *BUF, verifying the checksum, length, and handling run-length
8898 compression. NUL terminate the buffer. If there is not enough room,
8899 expand *BUF using xrealloc.
8901 Returns -1 on error, number of characters in buffer (ignoring the
8902 trailing NULL) on success. (could be extended to return one of the
8903 SERIAL status indications). */
8906 read_frame (char **buf_p,
8913 struct remote_state *rs = get_remote_state ();
8920 c = readchar (remote_timeout);
8923 case SERIAL_TIMEOUT:
8925 fputs_filtered ("Timeout in mid-packet, retrying\n", gdb_stdlog);
8929 fputs_filtered ("Saw new packet start in middle of old one\n",
8931 return -1; /* Start a new packet, count retries. */
8934 unsigned char pktcsum;
8940 check_0 = readchar (remote_timeout);
8942 check_1 = readchar (remote_timeout);
8944 if (check_0 == SERIAL_TIMEOUT || check_1 == SERIAL_TIMEOUT)
8947 fputs_filtered ("Timeout in checksum, retrying\n",
8951 else if (check_0 < 0 || check_1 < 0)
8954 fputs_filtered ("Communication error in checksum\n",
8959 /* Don't recompute the checksum; with no ack packets we
8960 don't have any way to indicate a packet retransmission
8965 pktcsum = (fromhex (check_0) << 4) | fromhex (check_1);
8966 if (csum == pktcsum)
8971 std::string str = escape_buffer (buf, bc);
8973 fprintf_unfiltered (gdb_stdlog,
8974 "Bad checksum, sentsum=0x%x, "
8975 "csum=0x%x, buf=%s\n",
8976 pktcsum, csum, str.c_str ());
8978 /* Number of characters in buffer ignoring trailing
8982 case '*': /* Run length encoding. */
8987 c = readchar (remote_timeout);
8989 repeat = c - ' ' + 3; /* Compute repeat count. */
8991 /* The character before ``*'' is repeated. */
8993 if (repeat > 0 && repeat <= 255 && bc > 0)
8995 if (bc + repeat - 1 >= *sizeof_buf - 1)
8997 /* Make some more room in the buffer. */
8998 *sizeof_buf += repeat;
8999 *buf_p = (char *) xrealloc (*buf_p, *sizeof_buf);
9003 memset (&buf[bc], buf[bc - 1], repeat);
9009 printf_filtered (_("Invalid run length encoding: %s\n"), buf);
9013 if (bc >= *sizeof_buf - 1)
9015 /* Make some more room in the buffer. */
9017 *buf_p = (char *) xrealloc (*buf_p, *sizeof_buf);
9028 /* Read a packet from the remote machine, with error checking, and
9029 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
9030 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
9031 rather than timing out; this is used (in synchronous mode) to wait
9032 for a target that is is executing user code to stop. */
9033 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
9034 don't have to change all the calls to getpkt to deal with the
9035 return value, because at the moment I don't know what the right
9036 thing to do it for those. */
9042 getpkt_sane (buf, sizeof_buf, forever);
9046 /* Read a packet from the remote machine, with error checking, and
9047 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
9048 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
9049 rather than timing out; this is used (in synchronous mode) to wait
9050 for a target that is is executing user code to stop. If FOREVER ==
9051 0, this function is allowed to time out gracefully and return an
9052 indication of this to the caller. Otherwise return the number of
9053 bytes read. If EXPECTING_NOTIF, consider receiving a notification
9054 enough reason to return to the caller. *IS_NOTIF is an output
9055 boolean that indicates whether *BUF holds a notification or not
9056 (a regular packet). */
9059 getpkt_or_notif_sane_1 (char **buf, long *sizeof_buf, int forever,
9060 int expecting_notif, int *is_notif)
9062 struct remote_state *rs = get_remote_state ();
9068 /* We're reading a new response. Make sure we don't look at a
9069 previously cached response. */
9070 rs->cached_wait_status = 0;
9072 strcpy (*buf, "timeout");
9075 timeout = watchdog > 0 ? watchdog : -1;
9076 else if (expecting_notif)
9077 timeout = 0; /* There should already be a char in the buffer. If
9080 timeout = remote_timeout;
9084 /* Process any number of notifications, and then return when
9088 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
9090 for (tries = 1; tries <= MAX_TRIES; tries++)
9092 /* This can loop forever if the remote side sends us
9093 characters continuously, but if it pauses, we'll get
9094 SERIAL_TIMEOUT from readchar because of timeout. Then
9095 we'll count that as a retry.
9097 Note that even when forever is set, we will only wait
9098 forever prior to the start of a packet. After that, we
9099 expect characters to arrive at a brisk pace. They should
9100 show up within remote_timeout intervals. */
9102 c = readchar (timeout);
9103 while (c != SERIAL_TIMEOUT && c != '$' && c != '%');
9105 if (c == SERIAL_TIMEOUT)
9107 if (expecting_notif)
9108 return -1; /* Don't complain, it's normal to not get
9109 anything in this case. */
9111 if (forever) /* Watchdog went off? Kill the target. */
9113 remote_unpush_target ();
9114 throw_error (TARGET_CLOSE_ERROR,
9115 _("Watchdog timeout has expired. "
9116 "Target detached."));
9119 fputs_filtered ("Timed out.\n", gdb_stdlog);
9123 /* We've found the start of a packet or notification.
9124 Now collect the data. */
9125 val = read_frame (buf, sizeof_buf);
9130 remote_serial_write ("-", 1);
9133 if (tries > MAX_TRIES)
9135 /* We have tried hard enough, and just can't receive the
9136 packet/notification. Give up. */
9137 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
9139 /* Skip the ack char if we're in no-ack mode. */
9140 if (!rs->noack_mode)
9141 remote_serial_write ("+", 1);
9145 /* If we got an ordinary packet, return that to our caller. */
9151 = escape_buffer (*buf,
9152 std::min (val, REMOTE_DEBUG_MAX_CHAR));
9154 fprintf_unfiltered (gdb_stdlog, "Packet received: %s",
9157 if (str.length () > REMOTE_DEBUG_MAX_CHAR)
9159 fprintf_unfiltered (gdb_stdlog, "[%zu bytes omitted]",
9160 str.length () - REMOTE_DEBUG_MAX_CHAR);
9163 fprintf_unfiltered (gdb_stdlog, "\n");
9166 /* Skip the ack char if we're in no-ack mode. */
9167 if (!rs->noack_mode)
9168 remote_serial_write ("+", 1);
9169 if (is_notif != NULL)
9174 /* If we got a notification, handle it, and go back to looking
9178 gdb_assert (c == '%');
9182 std::string str = escape_buffer (*buf, val);
9184 fprintf_unfiltered (gdb_stdlog,
9185 " Notification received: %s\n",
9188 if (is_notif != NULL)
9191 handle_notification (rs->notif_state, *buf);
9193 /* Notifications require no acknowledgement. */
9195 if (expecting_notif)
9202 getpkt_sane (char **buf, long *sizeof_buf, int forever)
9204 return getpkt_or_notif_sane_1 (buf, sizeof_buf, forever, 0, NULL);
9208 getpkt_or_notif_sane (char **buf, long *sizeof_buf, int forever,
9211 return getpkt_or_notif_sane_1 (buf, sizeof_buf, forever, 1,
9215 /* Check whether EVENT is a fork event for the process specified
9216 by the pid passed in DATA, and if it is, kill the fork child. */
9219 kill_child_of_pending_fork (QUEUE (stop_reply_p) *q,
9220 QUEUE_ITER (stop_reply_p) *iter,
9224 struct queue_iter_param *param = (struct queue_iter_param *) data;
9225 int parent_pid = *(int *) param->input;
9227 if (is_pending_fork_parent (&event->ws, parent_pid, event->ptid))
9229 struct remote_state *rs = get_remote_state ();
9230 int child_pid = ptid_get_pid (event->ws.value.related_pid);
9233 res = remote_vkill (child_pid, rs);
9235 error (_("Can't kill fork child process %d"), child_pid);
9241 /* Kill any new fork children of process PID that haven't been
9242 processed by follow_fork. */
9245 kill_new_fork_children (int pid, struct remote_state *rs)
9247 struct thread_info *thread;
9248 struct notif_client *notif = ¬if_client_stop;
9249 struct queue_iter_param param;
9251 /* Kill the fork child threads of any threads in process PID
9252 that are stopped at a fork event. */
9253 ALL_NON_EXITED_THREADS (thread)
9255 struct target_waitstatus *ws = &thread->pending_follow;
9257 if (is_pending_fork_parent (ws, pid, thread->ptid))
9259 struct remote_state *rs = get_remote_state ();
9260 int child_pid = ptid_get_pid (ws->value.related_pid);
9263 res = remote_vkill (child_pid, rs);
9265 error (_("Can't kill fork child process %d"), child_pid);
9269 /* Check for any pending fork events (not reported or processed yet)
9270 in process PID and kill those fork child threads as well. */
9271 remote_notif_get_pending_events (notif);
9273 param.output = NULL;
9274 QUEUE_iterate (stop_reply_p, stop_reply_queue,
9275 kill_child_of_pending_fork, ¶m);
9279 /* Target hook to kill the current inferior. */
9282 remote_kill (struct target_ops *ops)
9285 int pid = ptid_get_pid (inferior_ptid);
9286 struct remote_state *rs = get_remote_state ();
9288 if (packet_support (PACKET_vKill) != PACKET_DISABLE)
9290 /* If we're stopped while forking and we haven't followed yet,
9291 kill the child task. We need to do this before killing the
9292 parent task because if this is a vfork then the parent will
9294 kill_new_fork_children (pid, rs);
9296 res = remote_vkill (pid, rs);
9299 target_mourn_inferior (inferior_ptid);
9304 /* If we are in 'target remote' mode and we are killing the only
9305 inferior, then we will tell gdbserver to exit and unpush the
9307 if (res == -1 && !remote_multi_process_p (rs)
9308 && number_of_live_inferiors () == 1)
9312 /* We've killed the remote end, we get to mourn it. If we are
9313 not in extended mode, mourning the inferior also unpushes
9314 remote_ops from the target stack, which closes the remote
9316 target_mourn_inferior (inferior_ptid);
9321 error (_("Can't kill process"));
9324 /* Send a kill request to the target using the 'vKill' packet. */
9327 remote_vkill (int pid, struct remote_state *rs)
9329 if (packet_support (PACKET_vKill) == PACKET_DISABLE)
9332 /* Tell the remote target to detach. */
9333 xsnprintf (rs->buf, get_remote_packet_size (), "vKill;%x", pid);
9335 getpkt (&rs->buf, &rs->buf_size, 0);
9337 switch (packet_ok (rs->buf,
9338 &remote_protocol_packets[PACKET_vKill]))
9344 case PACKET_UNKNOWN:
9347 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
9351 /* Send a kill request to the target using the 'k' packet. */
9354 remote_kill_k (void)
9356 /* Catch errors so the user can quit from gdb even when we
9357 aren't on speaking terms with the remote system. */
9362 CATCH (ex, RETURN_MASK_ERROR)
9364 if (ex.error == TARGET_CLOSE_ERROR)
9366 /* If we got an (EOF) error that caused the target
9367 to go away, then we're done, that's what we wanted.
9368 "k" is susceptible to cause a premature EOF, given
9369 that the remote server isn't actually required to
9370 reply to "k", and it can happen that it doesn't
9371 even get to reply ACK to the "k". */
9375 /* Otherwise, something went wrong. We didn't actually kill
9376 the target. Just propagate the exception, and let the
9377 user or higher layers decide what to do. */
9378 throw_exception (ex);
9384 remote_mourn (struct target_ops *target)
9386 struct remote_state *rs = get_remote_state ();
9388 /* In 'target remote' mode with one inferior, we close the connection. */
9389 if (!rs->extended && number_of_live_inferiors () <= 1)
9391 unpush_target (target);
9393 /* remote_close takes care of doing most of the clean up. */
9394 generic_mourn_inferior ();
9398 /* In case we got here due to an error, but we're going to stay
9400 rs->waiting_for_stop_reply = 0;
9402 /* If the current general thread belonged to the process we just
9403 detached from or has exited, the remote side current general
9404 thread becomes undefined. Considering a case like this:
9406 - We just got here due to a detach.
9407 - The process that we're detaching from happens to immediately
9408 report a global breakpoint being hit in non-stop mode, in the
9409 same thread we had selected before.
9410 - GDB attaches to this process again.
9411 - This event happens to be the next event we handle.
9413 GDB would consider that the current general thread didn't need to
9414 be set on the stub side (with Hg), since for all it knew,
9415 GENERAL_THREAD hadn't changed.
9417 Notice that although in all-stop mode, the remote server always
9418 sets the current thread to the thread reporting the stop event,
9419 that doesn't happen in non-stop mode; in non-stop, the stub *must
9420 not* change the current thread when reporting a breakpoint hit,
9421 due to the decoupling of event reporting and event handling.
9423 To keep things simple, we always invalidate our notion of the
9425 record_currthread (rs, minus_one_ptid);
9427 /* Call common code to mark the inferior as not running. */
9428 generic_mourn_inferior ();
9430 if (!have_inferiors ())
9432 if (!remote_multi_process_p (rs))
9434 /* Check whether the target is running now - some remote stubs
9435 automatically restart after kill. */
9437 getpkt (&rs->buf, &rs->buf_size, 0);
9439 if (rs->buf[0] == 'S' || rs->buf[0] == 'T')
9441 /* Assume that the target has been restarted. Set
9442 inferior_ptid so that bits of core GDB realizes
9443 there's something here, e.g., so that the user can
9444 say "kill" again. */
9445 inferior_ptid = magic_null_ptid;
9452 extended_remote_supports_disable_randomization (struct target_ops *self)
9454 return packet_support (PACKET_QDisableRandomization) == PACKET_ENABLE;
9458 extended_remote_disable_randomization (int val)
9460 struct remote_state *rs = get_remote_state ();
9463 xsnprintf (rs->buf, get_remote_packet_size (), "QDisableRandomization:%x",
9466 reply = remote_get_noisy_reply ();
9468 error (_("Target does not support QDisableRandomization."));
9469 if (strcmp (reply, "OK") != 0)
9470 error (_("Bogus QDisableRandomization reply from target: %s"), reply);
9474 extended_remote_run (const std::string &args)
9476 struct remote_state *rs = get_remote_state ();
9478 const char *remote_exec_file = get_remote_exec_file ();
9480 /* If the user has disabled vRun support, or we have detected that
9481 support is not available, do not try it. */
9482 if (packet_support (PACKET_vRun) == PACKET_DISABLE)
9485 strcpy (rs->buf, "vRun;");
9486 len = strlen (rs->buf);
9488 if (strlen (remote_exec_file) * 2 + len >= get_remote_packet_size ())
9489 error (_("Remote file name too long for run packet"));
9490 len += 2 * bin2hex ((gdb_byte *) remote_exec_file, rs->buf + len,
9491 strlen (remote_exec_file));
9497 gdb_argv argv (args.c_str ());
9498 for (i = 0; argv[i] != NULL; i++)
9500 if (strlen (argv[i]) * 2 + 1 + len >= get_remote_packet_size ())
9501 error (_("Argument list too long for run packet"));
9502 rs->buf[len++] = ';';
9503 len += 2 * bin2hex ((gdb_byte *) argv[i], rs->buf + len,
9508 rs->buf[len++] = '\0';
9511 getpkt (&rs->buf, &rs->buf_size, 0);
9513 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_vRun]))
9516 /* We have a wait response. All is well. */
9518 case PACKET_UNKNOWN:
9521 if (remote_exec_file[0] == '\0')
9522 error (_("Running the default executable on the remote target failed; "
9523 "try \"set remote exec-file\"?"));
9525 error (_("Running \"%s\" on the remote target failed"),
9528 gdb_assert_not_reached (_("bad switch"));
9532 /* Helper function to send set/unset environment packets. ACTION is
9533 either "set" or "unset". PACKET is either "QEnvironmentHexEncoded"
9534 or "QEnvironmentUnsetVariable". VALUE is the variable to be
9538 send_environment_packet (struct remote_state *rs,
9543 /* Convert the environment variable to an hex string, which
9544 is the best format to be transmitted over the wire. */
9545 std::string encoded_value = bin2hex ((const gdb_byte *) value,
9548 xsnprintf (rs->buf, get_remote_packet_size (),
9549 "%s:%s", packet, encoded_value.c_str ());
9552 getpkt (&rs->buf, &rs->buf_size, 0);
9553 if (strcmp (rs->buf, "OK") != 0)
9554 warning (_("Unable to %s environment variable '%s' on remote."),
9558 /* Helper function to handle the QEnvironment* packets. */
9561 extended_remote_environment_support (struct remote_state *rs)
9563 if (packet_support (PACKET_QEnvironmentReset) != PACKET_DISABLE)
9565 putpkt ("QEnvironmentReset");
9566 getpkt (&rs->buf, &rs->buf_size, 0);
9567 if (strcmp (rs->buf, "OK") != 0)
9568 warning (_("Unable to reset environment on remote."));
9571 gdb_environ *e = ¤t_inferior ()->environment;
9573 if (packet_support (PACKET_QEnvironmentHexEncoded) != PACKET_DISABLE)
9574 for (const std::string &el : e->user_set_env ())
9575 send_environment_packet (rs, "set", "QEnvironmentHexEncoded",
9578 if (packet_support (PACKET_QEnvironmentUnset) != PACKET_DISABLE)
9579 for (const std::string &el : e->user_unset_env ())
9580 send_environment_packet (rs, "unset", "QEnvironmentUnset", el.c_str ());
9583 /* Helper function to set the current working directory for the
9584 inferior in the remote target. */
9587 extended_remote_set_inferior_cwd (struct remote_state *rs)
9589 if (packet_support (PACKET_QSetWorkingDir) != PACKET_DISABLE)
9591 const char *inferior_cwd = get_inferior_cwd ();
9593 if (inferior_cwd != NULL)
9595 std::string hexpath = bin2hex ((const gdb_byte *) inferior_cwd,
9596 strlen (inferior_cwd));
9598 xsnprintf (rs->buf, get_remote_packet_size (),
9599 "QSetWorkingDir:%s", hexpath.c_str ());
9603 /* An empty inferior_cwd means that the user wants us to
9604 reset the remote server's inferior's cwd. */
9605 xsnprintf (rs->buf, get_remote_packet_size (),
9610 getpkt (&rs->buf, &rs->buf_size, 0);
9611 if (packet_ok (rs->buf,
9612 &remote_protocol_packets[PACKET_QSetWorkingDir])
9615 Remote replied unexpectedly while setting the inferior's working\n\
9622 /* In the extended protocol we want to be able to do things like
9623 "run" and have them basically work as expected. So we need
9624 a special create_inferior function. We support changing the
9625 executable file and the command line arguments, but not the
9629 extended_remote_create_inferior (struct target_ops *ops,
9630 const char *exec_file,
9631 const std::string &args,
9632 char **env, int from_tty)
9636 struct remote_state *rs = get_remote_state ();
9637 const char *remote_exec_file = get_remote_exec_file ();
9639 /* If running asynchronously, register the target file descriptor
9640 with the event loop. */
9641 if (target_can_async_p ())
9644 /* Disable address space randomization if requested (and supported). */
9645 if (extended_remote_supports_disable_randomization (ops))
9646 extended_remote_disable_randomization (disable_randomization);
9648 /* If startup-with-shell is on, we inform gdbserver to start the
9649 remote inferior using a shell. */
9650 if (packet_support (PACKET_QStartupWithShell) != PACKET_DISABLE)
9652 xsnprintf (rs->buf, get_remote_packet_size (),
9653 "QStartupWithShell:%d", startup_with_shell ? 1 : 0);
9655 getpkt (&rs->buf, &rs->buf_size, 0);
9656 if (strcmp (rs->buf, "OK") != 0)
9658 Remote replied unexpectedly while setting startup-with-shell: %s"),
9662 extended_remote_environment_support (rs);
9664 extended_remote_set_inferior_cwd (rs);
9666 /* Now restart the remote server. */
9667 run_worked = extended_remote_run (args) != -1;
9670 /* vRun was not supported. Fail if we need it to do what the
9672 if (remote_exec_file[0])
9673 error (_("Remote target does not support \"set remote exec-file\""));
9675 error (_("Remote target does not support \"set args\" or run <ARGS>"));
9677 /* Fall back to "R". */
9678 extended_remote_restart ();
9681 if (!have_inferiors ())
9683 /* Clean up from the last time we ran, before we mark the target
9684 running again. This will mark breakpoints uninserted, and
9685 get_offsets may insert breakpoints. */
9686 init_thread_list ();
9687 init_wait_for_inferior ();
9690 /* vRun's success return is a stop reply. */
9691 stop_reply = run_worked ? rs->buf : NULL;
9692 add_current_inferior_and_thread (stop_reply);
9694 /* Get updated offsets, if the stub uses qOffsets. */
9699 /* Given a location's target info BP_TGT and the packet buffer BUF, output
9700 the list of conditions (in agent expression bytecode format), if any, the
9701 target needs to evaluate. The output is placed into the packet buffer
9702 started from BUF and ended at BUF_END. */
9705 remote_add_target_side_condition (struct gdbarch *gdbarch,
9706 struct bp_target_info *bp_tgt, char *buf,
9709 if (bp_tgt->conditions.empty ())
9712 buf += strlen (buf);
9713 xsnprintf (buf, buf_end - buf, "%s", ";");
9716 /* Send conditions to the target. */
9717 for (agent_expr *aexpr : bp_tgt->conditions)
9719 xsnprintf (buf, buf_end - buf, "X%x,", aexpr->len);
9720 buf += strlen (buf);
9721 for (int i = 0; i < aexpr->len; ++i)
9722 buf = pack_hex_byte (buf, aexpr->buf[i]);
9729 remote_add_target_side_commands (struct gdbarch *gdbarch,
9730 struct bp_target_info *bp_tgt, char *buf)
9732 if (bp_tgt->tcommands.empty ())
9735 buf += strlen (buf);
9737 sprintf (buf, ";cmds:%x,", bp_tgt->persist);
9738 buf += strlen (buf);
9740 /* Concatenate all the agent expressions that are commands into the
9742 for (agent_expr *aexpr : bp_tgt->tcommands)
9744 sprintf (buf, "X%x,", aexpr->len);
9745 buf += strlen (buf);
9746 for (int i = 0; i < aexpr->len; ++i)
9747 buf = pack_hex_byte (buf, aexpr->buf[i]);
9752 /* Insert a breakpoint. On targets that have software breakpoint
9753 support, we ask the remote target to do the work; on targets
9754 which don't, we insert a traditional memory breakpoint. */
9757 remote_insert_breakpoint (struct target_ops *ops,
9758 struct gdbarch *gdbarch,
9759 struct bp_target_info *bp_tgt)
9761 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
9762 If it succeeds, then set the support to PACKET_ENABLE. If it
9763 fails, and the user has explicitly requested the Z support then
9764 report an error, otherwise, mark it disabled and go on. */
9766 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
9768 CORE_ADDR addr = bp_tgt->reqstd_address;
9769 struct remote_state *rs;
9773 /* Make sure the remote is pointing at the right process, if
9775 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9776 set_general_process ();
9778 rs = get_remote_state ();
9780 endbuf = rs->buf + get_remote_packet_size ();
9785 addr = (ULONGEST) remote_address_masked (addr);
9786 p += hexnumstr (p, addr);
9787 xsnprintf (p, endbuf - p, ",%d", bp_tgt->kind);
9789 if (remote_supports_cond_breakpoints (ops))
9790 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
9792 if (remote_can_run_breakpoint_commands (ops))
9793 remote_add_target_side_commands (gdbarch, bp_tgt, p);
9796 getpkt (&rs->buf, &rs->buf_size, 0);
9798 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0]))
9804 case PACKET_UNKNOWN:
9809 /* If this breakpoint has target-side commands but this stub doesn't
9810 support Z0 packets, throw error. */
9811 if (!bp_tgt->tcommands.empty ())
9812 throw_error (NOT_SUPPORTED_ERROR, _("\
9813 Target doesn't support breakpoints that have target side commands."));
9815 return memory_insert_breakpoint (ops, gdbarch, bp_tgt);
9819 remote_remove_breakpoint (struct target_ops *ops,
9820 struct gdbarch *gdbarch,
9821 struct bp_target_info *bp_tgt,
9822 enum remove_bp_reason reason)
9824 CORE_ADDR addr = bp_tgt->placed_address;
9825 struct remote_state *rs = get_remote_state ();
9827 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
9830 char *endbuf = rs->buf + get_remote_packet_size ();
9832 /* Make sure the remote is pointing at the right process, if
9834 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9835 set_general_process ();
9841 addr = (ULONGEST) remote_address_masked (bp_tgt->placed_address);
9842 p += hexnumstr (p, addr);
9843 xsnprintf (p, endbuf - p, ",%d", bp_tgt->kind);
9846 getpkt (&rs->buf, &rs->buf_size, 0);
9848 return (rs->buf[0] == 'E');
9851 return memory_remove_breakpoint (ops, gdbarch, bp_tgt, reason);
9854 static enum Z_packet_type
9855 watchpoint_to_Z_packet (int type)
9860 return Z_PACKET_WRITE_WP;
9863 return Z_PACKET_READ_WP;
9866 return Z_PACKET_ACCESS_WP;
9869 internal_error (__FILE__, __LINE__,
9870 _("hw_bp_to_z: bad watchpoint type %d"), type);
9875 remote_insert_watchpoint (struct target_ops *self, CORE_ADDR addr, int len,
9876 enum target_hw_bp_type type, struct expression *cond)
9878 struct remote_state *rs = get_remote_state ();
9879 char *endbuf = rs->buf + get_remote_packet_size ();
9881 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
9883 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
9886 /* Make sure the remote is pointing at the right process, if
9888 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9889 set_general_process ();
9891 xsnprintf (rs->buf, endbuf - rs->buf, "Z%x,", packet);
9892 p = strchr (rs->buf, '\0');
9893 addr = remote_address_masked (addr);
9894 p += hexnumstr (p, (ULONGEST) addr);
9895 xsnprintf (p, endbuf - p, ",%x", len);
9898 getpkt (&rs->buf, &rs->buf_size, 0);
9900 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
9904 case PACKET_UNKNOWN:
9909 internal_error (__FILE__, __LINE__,
9910 _("remote_insert_watchpoint: reached end of function"));
9914 remote_watchpoint_addr_within_range (struct target_ops *target, CORE_ADDR addr,
9915 CORE_ADDR start, int length)
9917 CORE_ADDR diff = remote_address_masked (addr - start);
9919 return diff < length;
9924 remote_remove_watchpoint (struct target_ops *self, CORE_ADDR addr, int len,
9925 enum target_hw_bp_type type, struct expression *cond)
9927 struct remote_state *rs = get_remote_state ();
9928 char *endbuf = rs->buf + get_remote_packet_size ();
9930 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
9932 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
9935 /* Make sure the remote is pointing at the right process, if
9937 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9938 set_general_process ();
9940 xsnprintf (rs->buf, endbuf - rs->buf, "z%x,", packet);
9941 p = strchr (rs->buf, '\0');
9942 addr = remote_address_masked (addr);
9943 p += hexnumstr (p, (ULONGEST) addr);
9944 xsnprintf (p, endbuf - p, ",%x", len);
9946 getpkt (&rs->buf, &rs->buf_size, 0);
9948 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
9951 case PACKET_UNKNOWN:
9956 internal_error (__FILE__, __LINE__,
9957 _("remote_remove_watchpoint: reached end of function"));
9961 int remote_hw_watchpoint_limit = -1;
9962 int remote_hw_watchpoint_length_limit = -1;
9963 int remote_hw_breakpoint_limit = -1;
9966 remote_region_ok_for_hw_watchpoint (struct target_ops *self,
9967 CORE_ADDR addr, int len)
9969 if (remote_hw_watchpoint_length_limit == 0)
9971 else if (remote_hw_watchpoint_length_limit < 0)
9973 else if (len <= remote_hw_watchpoint_length_limit)
9980 remote_check_watch_resources (struct target_ops *self,
9981 enum bptype type, int cnt, int ot)
9983 if (type == bp_hardware_breakpoint)
9985 if (remote_hw_breakpoint_limit == 0)
9987 else if (remote_hw_breakpoint_limit < 0)
9989 else if (cnt <= remote_hw_breakpoint_limit)
9994 if (remote_hw_watchpoint_limit == 0)
9996 else if (remote_hw_watchpoint_limit < 0)
10000 else if (cnt <= remote_hw_watchpoint_limit)
10006 /* The to_stopped_by_sw_breakpoint method of target remote. */
10009 remote_stopped_by_sw_breakpoint (struct target_ops *ops)
10011 struct thread_info *thread = inferior_thread ();
10013 return (thread->priv != NULL
10014 && (get_remote_thread_info (thread)->stop_reason
10015 == TARGET_STOPPED_BY_SW_BREAKPOINT));
10018 /* The to_supports_stopped_by_sw_breakpoint method of target
10022 remote_supports_stopped_by_sw_breakpoint (struct target_ops *ops)
10024 return (packet_support (PACKET_swbreak_feature) == PACKET_ENABLE);
10027 /* The to_stopped_by_hw_breakpoint method of target remote. */
10030 remote_stopped_by_hw_breakpoint (struct target_ops *ops)
10032 struct thread_info *thread = inferior_thread ();
10034 return (thread->priv != NULL
10035 && (get_remote_thread_info (thread)->stop_reason
10036 == TARGET_STOPPED_BY_HW_BREAKPOINT));
10039 /* The to_supports_stopped_by_hw_breakpoint method of target
10043 remote_supports_stopped_by_hw_breakpoint (struct target_ops *ops)
10045 return (packet_support (PACKET_hwbreak_feature) == PACKET_ENABLE);
10049 remote_stopped_by_watchpoint (struct target_ops *ops)
10051 struct thread_info *thread = inferior_thread ();
10053 return (thread->priv != NULL
10054 && (get_remote_thread_info (thread)->stop_reason
10055 == TARGET_STOPPED_BY_WATCHPOINT));
10059 remote_stopped_data_address (struct target_ops *target, CORE_ADDR *addr_p)
10061 struct thread_info *thread = inferior_thread ();
10063 if (thread->priv != NULL
10064 && (get_remote_thread_info (thread)->stop_reason
10065 == TARGET_STOPPED_BY_WATCHPOINT))
10067 *addr_p = get_remote_thread_info (thread)->watch_data_address;
10076 remote_insert_hw_breakpoint (struct target_ops *self, struct gdbarch *gdbarch,
10077 struct bp_target_info *bp_tgt)
10079 CORE_ADDR addr = bp_tgt->reqstd_address;
10080 struct remote_state *rs;
10084 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
10087 /* Make sure the remote is pointing at the right process, if
10089 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10090 set_general_process ();
10092 rs = get_remote_state ();
10094 endbuf = rs->buf + get_remote_packet_size ();
10100 addr = remote_address_masked (addr);
10101 p += hexnumstr (p, (ULONGEST) addr);
10102 xsnprintf (p, endbuf - p, ",%x", bp_tgt->kind);
10104 if (remote_supports_cond_breakpoints (self))
10105 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
10107 if (remote_can_run_breakpoint_commands (self))
10108 remote_add_target_side_commands (gdbarch, bp_tgt, p);
10111 getpkt (&rs->buf, &rs->buf_size, 0);
10113 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
10116 if (rs->buf[1] == '.')
10118 message = strchr (rs->buf + 2, '.');
10120 error (_("Remote failure reply: %s"), message + 1);
10123 case PACKET_UNKNOWN:
10128 internal_error (__FILE__, __LINE__,
10129 _("remote_insert_hw_breakpoint: reached end of function"));
10134 remote_remove_hw_breakpoint (struct target_ops *self, struct gdbarch *gdbarch,
10135 struct bp_target_info *bp_tgt)
10138 struct remote_state *rs = get_remote_state ();
10140 char *endbuf = rs->buf + get_remote_packet_size ();
10142 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
10145 /* Make sure the remote is pointing at the right process, if
10147 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10148 set_general_process ();
10154 addr = remote_address_masked (bp_tgt->placed_address);
10155 p += hexnumstr (p, (ULONGEST) addr);
10156 xsnprintf (p, endbuf - p, ",%x", bp_tgt->kind);
10159 getpkt (&rs->buf, &rs->buf_size, 0);
10161 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
10164 case PACKET_UNKNOWN:
10169 internal_error (__FILE__, __LINE__,
10170 _("remote_remove_hw_breakpoint: reached end of function"));
10173 /* Verify memory using the "qCRC:" request. */
10176 remote_verify_memory (struct target_ops *ops,
10177 const gdb_byte *data, CORE_ADDR lma, ULONGEST size)
10179 struct remote_state *rs = get_remote_state ();
10180 unsigned long host_crc, target_crc;
10183 /* It doesn't make sense to use qCRC if the remote target is
10184 connected but not running. */
10185 if (target_has_execution && packet_support (PACKET_qCRC) != PACKET_DISABLE)
10187 enum packet_result result;
10189 /* Make sure the remote is pointing at the right process. */
10190 set_general_process ();
10192 /* FIXME: assumes lma can fit into long. */
10193 xsnprintf (rs->buf, get_remote_packet_size (), "qCRC:%lx,%lx",
10194 (long) lma, (long) size);
10197 /* Be clever; compute the host_crc before waiting for target
10199 host_crc = xcrc32 (data, size, 0xffffffff);
10201 getpkt (&rs->buf, &rs->buf_size, 0);
10203 result = packet_ok (rs->buf,
10204 &remote_protocol_packets[PACKET_qCRC]);
10205 if (result == PACKET_ERROR)
10207 else if (result == PACKET_OK)
10209 for (target_crc = 0, tmp = &rs->buf[1]; *tmp; tmp++)
10210 target_crc = target_crc * 16 + fromhex (*tmp);
10212 return (host_crc == target_crc);
10216 return simple_verify_memory (ops, data, lma, size);
10219 /* compare-sections command
10221 With no arguments, compares each loadable section in the exec bfd
10222 with the same memory range on the target, and reports mismatches.
10223 Useful for verifying the image on the target against the exec file. */
10226 compare_sections_command (const char *args, int from_tty)
10229 gdb_byte *sectdata;
10230 const char *sectname;
10231 bfd_size_type size;
10234 int mismatched = 0;
10239 error (_("command cannot be used without an exec file"));
10241 /* Make sure the remote is pointing at the right process. */
10242 set_general_process ();
10244 if (args != NULL && strcmp (args, "-r") == 0)
10250 for (s = exec_bfd->sections; s; s = s->next)
10252 if (!(s->flags & SEC_LOAD))
10253 continue; /* Skip non-loadable section. */
10255 if (read_only && (s->flags & SEC_READONLY) == 0)
10256 continue; /* Skip writeable sections */
10258 size = bfd_get_section_size (s);
10260 continue; /* Skip zero-length section. */
10262 sectname = bfd_get_section_name (exec_bfd, s);
10263 if (args && strcmp (args, sectname) != 0)
10264 continue; /* Not the section selected by user. */
10266 matched = 1; /* Do this section. */
10269 gdb::byte_vector sectdata (size);
10270 bfd_get_section_contents (exec_bfd, s, sectdata.data (), 0, size);
10272 res = target_verify_memory (sectdata.data (), lma, size);
10275 error (_("target memory fault, section %s, range %s -- %s"), sectname,
10276 paddress (target_gdbarch (), lma),
10277 paddress (target_gdbarch (), lma + size));
10279 printf_filtered ("Section %s, range %s -- %s: ", sectname,
10280 paddress (target_gdbarch (), lma),
10281 paddress (target_gdbarch (), lma + size));
10283 printf_filtered ("matched.\n");
10286 printf_filtered ("MIS-MATCHED!\n");
10290 if (mismatched > 0)
10291 warning (_("One or more sections of the target image does not match\n\
10292 the loaded file\n"));
10293 if (args && !matched)
10294 printf_filtered (_("No loaded section named '%s'.\n"), args);
10297 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
10298 into remote target. The number of bytes written to the remote
10299 target is returned, or -1 for error. */
10301 static enum target_xfer_status
10302 remote_write_qxfer (struct target_ops *ops, const char *object_name,
10303 const char *annex, const gdb_byte *writebuf,
10304 ULONGEST offset, LONGEST len, ULONGEST *xfered_len,
10305 struct packet_config *packet)
10309 struct remote_state *rs = get_remote_state ();
10310 int max_size = get_memory_write_packet_size ();
10312 if (packet->support == PACKET_DISABLE)
10313 return TARGET_XFER_E_IO;
10315 /* Insert header. */
10316 i = snprintf (rs->buf, max_size,
10317 "qXfer:%s:write:%s:%s:",
10318 object_name, annex ? annex : "",
10319 phex_nz (offset, sizeof offset));
10320 max_size -= (i + 1);
10322 /* Escape as much data as fits into rs->buf. */
10323 buf_len = remote_escape_output
10324 (writebuf, len, 1, (gdb_byte *) rs->buf + i, &max_size, max_size);
10326 if (putpkt_binary (rs->buf, i + buf_len) < 0
10327 || getpkt_sane (&rs->buf, &rs->buf_size, 0) < 0
10328 || packet_ok (rs->buf, packet) != PACKET_OK)
10329 return TARGET_XFER_E_IO;
10331 unpack_varlen_hex (rs->buf, &n);
10334 return (*xfered_len != 0) ? TARGET_XFER_OK : TARGET_XFER_EOF;
10337 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
10338 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
10339 number of bytes read is returned, or 0 for EOF, or -1 for error.
10340 The number of bytes read may be less than LEN without indicating an
10341 EOF. PACKET is checked and updated to indicate whether the remote
10342 target supports this object. */
10344 static enum target_xfer_status
10345 remote_read_qxfer (struct target_ops *ops, const char *object_name,
10347 gdb_byte *readbuf, ULONGEST offset, LONGEST len,
10348 ULONGEST *xfered_len,
10349 struct packet_config *packet)
10351 struct remote_state *rs = get_remote_state ();
10352 LONGEST i, n, packet_len;
10354 if (packet->support == PACKET_DISABLE)
10355 return TARGET_XFER_E_IO;
10357 /* Check whether we've cached an end-of-object packet that matches
10359 if (rs->finished_object)
10361 if (strcmp (object_name, rs->finished_object) == 0
10362 && strcmp (annex ? annex : "", rs->finished_annex) == 0
10363 && offset == rs->finished_offset)
10364 return TARGET_XFER_EOF;
10367 /* Otherwise, we're now reading something different. Discard
10369 xfree (rs->finished_object);
10370 xfree (rs->finished_annex);
10371 rs->finished_object = NULL;
10372 rs->finished_annex = NULL;
10375 /* Request only enough to fit in a single packet. The actual data
10376 may not, since we don't know how much of it will need to be escaped;
10377 the target is free to respond with slightly less data. We subtract
10378 five to account for the response type and the protocol frame. */
10379 n = std::min<LONGEST> (get_remote_packet_size () - 5, len);
10380 snprintf (rs->buf, get_remote_packet_size () - 4, "qXfer:%s:read:%s:%s,%s",
10381 object_name, annex ? annex : "",
10382 phex_nz (offset, sizeof offset),
10383 phex_nz (n, sizeof n));
10384 i = putpkt (rs->buf);
10386 return TARGET_XFER_E_IO;
10389 packet_len = getpkt_sane (&rs->buf, &rs->buf_size, 0);
10390 if (packet_len < 0 || packet_ok (rs->buf, packet) != PACKET_OK)
10391 return TARGET_XFER_E_IO;
10393 if (rs->buf[0] != 'l' && rs->buf[0] != 'm')
10394 error (_("Unknown remote qXfer reply: %s"), rs->buf);
10396 /* 'm' means there is (or at least might be) more data after this
10397 batch. That does not make sense unless there's at least one byte
10398 of data in this reply. */
10399 if (rs->buf[0] == 'm' && packet_len == 1)
10400 error (_("Remote qXfer reply contained no data."));
10402 /* Got some data. */
10403 i = remote_unescape_input ((gdb_byte *) rs->buf + 1,
10404 packet_len - 1, readbuf, n);
10406 /* 'l' is an EOF marker, possibly including a final block of data,
10407 or possibly empty. If we have the final block of a non-empty
10408 object, record this fact to bypass a subsequent partial read. */
10409 if (rs->buf[0] == 'l' && offset + i > 0)
10411 rs->finished_object = xstrdup (object_name);
10412 rs->finished_annex = xstrdup (annex ? annex : "");
10413 rs->finished_offset = offset + i;
10417 return TARGET_XFER_EOF;
10421 return TARGET_XFER_OK;
10425 static enum target_xfer_status
10426 remote_xfer_partial (struct target_ops *ops, enum target_object object,
10427 const char *annex, gdb_byte *readbuf,
10428 const gdb_byte *writebuf, ULONGEST offset, ULONGEST len,
10429 ULONGEST *xfered_len)
10431 struct remote_state *rs;
10435 int unit_size = gdbarch_addressable_memory_unit_size (target_gdbarch ());
10437 set_remote_traceframe ();
10438 set_general_thread (inferior_ptid);
10440 rs = get_remote_state ();
10442 /* Handle memory using the standard memory routines. */
10443 if (object == TARGET_OBJECT_MEMORY)
10445 /* If the remote target is connected but not running, we should
10446 pass this request down to a lower stratum (e.g. the executable
10448 if (!target_has_execution)
10449 return TARGET_XFER_EOF;
10451 if (writebuf != NULL)
10452 return remote_write_bytes (offset, writebuf, len, unit_size,
10455 return remote_read_bytes (ops, offset, readbuf, len, unit_size,
10459 /* Handle SPU memory using qxfer packets. */
10460 if (object == TARGET_OBJECT_SPU)
10463 return remote_read_qxfer (ops, "spu", annex, readbuf, offset, len,
10464 xfered_len, &remote_protocol_packets
10465 [PACKET_qXfer_spu_read]);
10467 return remote_write_qxfer (ops, "spu", annex, writebuf, offset, len,
10468 xfered_len, &remote_protocol_packets
10469 [PACKET_qXfer_spu_write]);
10472 /* Handle extra signal info using qxfer packets. */
10473 if (object == TARGET_OBJECT_SIGNAL_INFO)
10476 return remote_read_qxfer (ops, "siginfo", annex, readbuf, offset, len,
10477 xfered_len, &remote_protocol_packets
10478 [PACKET_qXfer_siginfo_read]);
10480 return remote_write_qxfer (ops, "siginfo", annex,
10481 writebuf, offset, len, xfered_len,
10482 &remote_protocol_packets
10483 [PACKET_qXfer_siginfo_write]);
10486 if (object == TARGET_OBJECT_STATIC_TRACE_DATA)
10489 return remote_read_qxfer (ops, "statictrace", annex,
10490 readbuf, offset, len, xfered_len,
10491 &remote_protocol_packets
10492 [PACKET_qXfer_statictrace_read]);
10494 return TARGET_XFER_E_IO;
10497 /* Only handle flash writes. */
10498 if (writebuf != NULL)
10502 case TARGET_OBJECT_FLASH:
10503 return remote_flash_write (ops, offset, len, xfered_len,
10507 return TARGET_XFER_E_IO;
10511 /* Map pre-existing objects onto letters. DO NOT do this for new
10512 objects!!! Instead specify new query packets. */
10515 case TARGET_OBJECT_AVR:
10519 case TARGET_OBJECT_AUXV:
10520 gdb_assert (annex == NULL);
10521 return remote_read_qxfer (ops, "auxv", annex, readbuf, offset, len,
10523 &remote_protocol_packets[PACKET_qXfer_auxv]);
10525 case TARGET_OBJECT_AVAILABLE_FEATURES:
10526 return remote_read_qxfer
10527 (ops, "features", annex, readbuf, offset, len, xfered_len,
10528 &remote_protocol_packets[PACKET_qXfer_features]);
10530 case TARGET_OBJECT_LIBRARIES:
10531 return remote_read_qxfer
10532 (ops, "libraries", annex, readbuf, offset, len, xfered_len,
10533 &remote_protocol_packets[PACKET_qXfer_libraries]);
10535 case TARGET_OBJECT_LIBRARIES_SVR4:
10536 return remote_read_qxfer
10537 (ops, "libraries-svr4", annex, readbuf, offset, len, xfered_len,
10538 &remote_protocol_packets[PACKET_qXfer_libraries_svr4]);
10540 case TARGET_OBJECT_MEMORY_MAP:
10541 gdb_assert (annex == NULL);
10542 return remote_read_qxfer (ops, "memory-map", annex, readbuf, offset, len,
10544 &remote_protocol_packets[PACKET_qXfer_memory_map]);
10546 case TARGET_OBJECT_OSDATA:
10547 /* Should only get here if we're connected. */
10548 gdb_assert (rs->remote_desc);
10549 return remote_read_qxfer
10550 (ops, "osdata", annex, readbuf, offset, len, xfered_len,
10551 &remote_protocol_packets[PACKET_qXfer_osdata]);
10553 case TARGET_OBJECT_THREADS:
10554 gdb_assert (annex == NULL);
10555 return remote_read_qxfer (ops, "threads", annex, readbuf, offset, len,
10557 &remote_protocol_packets[PACKET_qXfer_threads]);
10559 case TARGET_OBJECT_TRACEFRAME_INFO:
10560 gdb_assert (annex == NULL);
10561 return remote_read_qxfer
10562 (ops, "traceframe-info", annex, readbuf, offset, len, xfered_len,
10563 &remote_protocol_packets[PACKET_qXfer_traceframe_info]);
10565 case TARGET_OBJECT_FDPIC:
10566 return remote_read_qxfer (ops, "fdpic", annex, readbuf, offset, len,
10568 &remote_protocol_packets[PACKET_qXfer_fdpic]);
10570 case TARGET_OBJECT_OPENVMS_UIB:
10571 return remote_read_qxfer (ops, "uib", annex, readbuf, offset, len,
10573 &remote_protocol_packets[PACKET_qXfer_uib]);
10575 case TARGET_OBJECT_BTRACE:
10576 return remote_read_qxfer (ops, "btrace", annex, readbuf, offset, len,
10578 &remote_protocol_packets[PACKET_qXfer_btrace]);
10580 case TARGET_OBJECT_BTRACE_CONF:
10581 return remote_read_qxfer (ops, "btrace-conf", annex, readbuf, offset,
10583 &remote_protocol_packets[PACKET_qXfer_btrace_conf]);
10585 case TARGET_OBJECT_EXEC_FILE:
10586 return remote_read_qxfer (ops, "exec-file", annex, readbuf, offset,
10588 &remote_protocol_packets[PACKET_qXfer_exec_file]);
10591 return TARGET_XFER_E_IO;
10594 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
10595 large enough let the caller deal with it. */
10596 if (len < get_remote_packet_size ())
10597 return TARGET_XFER_E_IO;
10598 len = get_remote_packet_size ();
10600 /* Except for querying the minimum buffer size, target must be open. */
10601 if (!rs->remote_desc)
10602 error (_("remote query is only available after target open"));
10604 gdb_assert (annex != NULL);
10605 gdb_assert (readbuf != NULL);
10609 *p2++ = query_type;
10611 /* We used one buffer char for the remote protocol q command and
10612 another for the query type. As the remote protocol encapsulation
10613 uses 4 chars plus one extra in case we are debugging
10614 (remote_debug), we have PBUFZIZ - 7 left to pack the query
10617 while (annex[i] && (i < (get_remote_packet_size () - 8)))
10619 /* Bad caller may have sent forbidden characters. */
10620 gdb_assert (isprint (annex[i]) && annex[i] != '$' && annex[i] != '#');
10625 gdb_assert (annex[i] == '\0');
10627 i = putpkt (rs->buf);
10629 return TARGET_XFER_E_IO;
10631 getpkt (&rs->buf, &rs->buf_size, 0);
10632 strcpy ((char *) readbuf, rs->buf);
10634 *xfered_len = strlen ((char *) readbuf);
10635 return (*xfered_len != 0) ? TARGET_XFER_OK : TARGET_XFER_EOF;
10638 /* Implementation of to_get_memory_xfer_limit. */
10641 remote_get_memory_xfer_limit (struct target_ops *ops)
10643 return get_memory_write_packet_size ();
10647 remote_search_memory (struct target_ops* ops,
10648 CORE_ADDR start_addr, ULONGEST search_space_len,
10649 const gdb_byte *pattern, ULONGEST pattern_len,
10650 CORE_ADDR *found_addrp)
10652 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
10653 struct remote_state *rs = get_remote_state ();
10654 int max_size = get_memory_write_packet_size ();
10655 struct packet_config *packet =
10656 &remote_protocol_packets[PACKET_qSearch_memory];
10657 /* Number of packet bytes used to encode the pattern;
10658 this could be more than PATTERN_LEN due to escape characters. */
10659 int escaped_pattern_len;
10660 /* Amount of pattern that was encodable in the packet. */
10661 int used_pattern_len;
10664 ULONGEST found_addr;
10666 /* Don't go to the target if we don't have to.
10667 This is done before checking packet->support to avoid the possibility that
10668 a success for this edge case means the facility works in general. */
10669 if (pattern_len > search_space_len)
10671 if (pattern_len == 0)
10673 *found_addrp = start_addr;
10677 /* If we already know the packet isn't supported, fall back to the simple
10678 way of searching memory. */
10680 if (packet_config_support (packet) == PACKET_DISABLE)
10682 /* Target doesn't provided special support, fall back and use the
10683 standard support (copy memory and do the search here). */
10684 return simple_search_memory (ops, start_addr, search_space_len,
10685 pattern, pattern_len, found_addrp);
10688 /* Make sure the remote is pointing at the right process. */
10689 set_general_process ();
10691 /* Insert header. */
10692 i = snprintf (rs->buf, max_size,
10693 "qSearch:memory:%s;%s;",
10694 phex_nz (start_addr, addr_size),
10695 phex_nz (search_space_len, sizeof (search_space_len)));
10696 max_size -= (i + 1);
10698 /* Escape as much data as fits into rs->buf. */
10699 escaped_pattern_len =
10700 remote_escape_output (pattern, pattern_len, 1, (gdb_byte *) rs->buf + i,
10701 &used_pattern_len, max_size);
10703 /* Bail if the pattern is too large. */
10704 if (used_pattern_len != pattern_len)
10705 error (_("Pattern is too large to transmit to remote target."));
10707 if (putpkt_binary (rs->buf, i + escaped_pattern_len) < 0
10708 || getpkt_sane (&rs->buf, &rs->buf_size, 0) < 0
10709 || packet_ok (rs->buf, packet) != PACKET_OK)
10711 /* The request may not have worked because the command is not
10712 supported. If so, fall back to the simple way. */
10713 if (packet->support == PACKET_DISABLE)
10715 return simple_search_memory (ops, start_addr, search_space_len,
10716 pattern, pattern_len, found_addrp);
10721 if (rs->buf[0] == '0')
10723 else if (rs->buf[0] == '1')
10726 if (rs->buf[1] != ',')
10727 error (_("Unknown qSearch:memory reply: %s"), rs->buf);
10728 unpack_varlen_hex (rs->buf + 2, &found_addr);
10729 *found_addrp = found_addr;
10732 error (_("Unknown qSearch:memory reply: %s"), rs->buf);
10738 remote_rcmd (struct target_ops *self, const char *command,
10739 struct ui_file *outbuf)
10741 struct remote_state *rs = get_remote_state ();
10744 if (!rs->remote_desc)
10745 error (_("remote rcmd is only available after target open"));
10747 /* Send a NULL command across as an empty command. */
10748 if (command == NULL)
10751 /* The query prefix. */
10752 strcpy (rs->buf, "qRcmd,");
10753 p = strchr (rs->buf, '\0');
10755 if ((strlen (rs->buf) + strlen (command) * 2 + 8/*misc*/)
10756 > get_remote_packet_size ())
10757 error (_("\"monitor\" command ``%s'' is too long."), command);
10759 /* Encode the actual command. */
10760 bin2hex ((const gdb_byte *) command, p, strlen (command));
10762 if (putpkt (rs->buf) < 0)
10763 error (_("Communication problem with target."));
10765 /* get/display the response */
10770 /* XXX - see also remote_get_noisy_reply(). */
10771 QUIT; /* Allow user to bail out with ^C. */
10773 if (getpkt_sane (&rs->buf, &rs->buf_size, 0) == -1)
10775 /* Timeout. Continue to (try to) read responses.
10776 This is better than stopping with an error, assuming the stub
10777 is still executing the (long) monitor command.
10778 If needed, the user can interrupt gdb using C-c, obtaining
10779 an effect similar to stop on timeout. */
10783 if (buf[0] == '\0')
10784 error (_("Target does not support this command."));
10785 if (buf[0] == 'O' && buf[1] != 'K')
10787 remote_console_output (buf + 1); /* 'O' message from stub. */
10790 if (strcmp (buf, "OK") == 0)
10792 if (strlen (buf) == 3 && buf[0] == 'E'
10793 && isdigit (buf[1]) && isdigit (buf[2]))
10795 error (_("Protocol error with Rcmd"));
10797 for (p = buf; p[0] != '\0' && p[1] != '\0'; p += 2)
10799 char c = (fromhex (p[0]) << 4) + fromhex (p[1]);
10801 fputc_unfiltered (c, outbuf);
10807 static std::vector<mem_region>
10808 remote_memory_map (struct target_ops *ops)
10810 std::vector<mem_region> result;
10811 gdb::unique_xmalloc_ptr<char> text
10812 = target_read_stralloc (¤t_target, TARGET_OBJECT_MEMORY_MAP, NULL);
10815 result = parse_memory_map (text.get ());
10821 packet_command (const char *args, int from_tty)
10823 struct remote_state *rs = get_remote_state ();
10825 if (!rs->remote_desc)
10826 error (_("command can only be used with remote target"));
10829 error (_("remote-packet command requires packet text as argument"));
10831 puts_filtered ("sending: ");
10832 print_packet (args);
10833 puts_filtered ("\n");
10836 getpkt (&rs->buf, &rs->buf_size, 0);
10837 puts_filtered ("received: ");
10838 print_packet (rs->buf);
10839 puts_filtered ("\n");
10843 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
10845 static void display_thread_info (struct gdb_ext_thread_info *info);
10847 static void threadset_test_cmd (char *cmd, int tty);
10849 static void threadalive_test (char *cmd, int tty);
10851 static void threadlist_test_cmd (char *cmd, int tty);
10853 int get_and_display_threadinfo (threadref *ref);
10855 static void threadinfo_test_cmd (char *cmd, int tty);
10857 static int thread_display_step (threadref *ref, void *context);
10859 static void threadlist_update_test_cmd (char *cmd, int tty);
10861 static void init_remote_threadtests (void);
10863 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
10866 threadset_test_cmd (const char *cmd, int tty)
10868 int sample_thread = SAMPLE_THREAD;
10870 printf_filtered (_("Remote threadset test\n"));
10871 set_general_thread (sample_thread);
10876 threadalive_test (const char *cmd, int tty)
10878 int sample_thread = SAMPLE_THREAD;
10879 int pid = ptid_get_pid (inferior_ptid);
10880 ptid_t ptid = ptid_build (pid, sample_thread, 0);
10882 if (remote_thread_alive (ptid))
10883 printf_filtered ("PASS: Thread alive test\n");
10885 printf_filtered ("FAIL: Thread alive test\n");
10888 void output_threadid (char *title, threadref *ref);
10891 output_threadid (char *title, threadref *ref)
10895 pack_threadid (&hexid[0], ref); /* Convert threead id into hex. */
10897 printf_filtered ("%s %s\n", title, (&hexid[0]));
10901 threadlist_test_cmd (const char *cmd, int tty)
10904 threadref nextthread;
10905 int done, result_count;
10906 threadref threadlist[3];
10908 printf_filtered ("Remote Threadlist test\n");
10909 if (!remote_get_threadlist (startflag, &nextthread, 3, &done,
10910 &result_count, &threadlist[0]))
10911 printf_filtered ("FAIL: threadlist test\n");
10914 threadref *scan = threadlist;
10915 threadref *limit = scan + result_count;
10917 while (scan < limit)
10918 output_threadid (" thread ", scan++);
10923 display_thread_info (struct gdb_ext_thread_info *info)
10925 output_threadid ("Threadid: ", &info->threadid);
10926 printf_filtered ("Name: %s\n ", info->shortname);
10927 printf_filtered ("State: %s\n", info->display);
10928 printf_filtered ("other: %s\n\n", info->more_display);
10932 get_and_display_threadinfo (threadref *ref)
10936 struct gdb_ext_thread_info threadinfo;
10938 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
10939 | TAG_MOREDISPLAY | TAG_DISPLAY;
10940 if (0 != (result = remote_get_threadinfo (ref, set, &threadinfo)))
10941 display_thread_info (&threadinfo);
10946 threadinfo_test_cmd (const char *cmd, int tty)
10948 int athread = SAMPLE_THREAD;
10952 int_to_threadref (&thread, athread);
10953 printf_filtered ("Remote Threadinfo test\n");
10954 if (!get_and_display_threadinfo (&thread))
10955 printf_filtered ("FAIL cannot get thread info\n");
10959 thread_display_step (threadref *ref, void *context)
10961 /* output_threadid(" threadstep ",ref); *//* simple test */
10962 return get_and_display_threadinfo (ref);
10966 threadlist_update_test_cmd (const char *cmd, int tty)
10968 printf_filtered ("Remote Threadlist update test\n");
10969 remote_threadlist_iterator (thread_display_step, 0, CRAZY_MAX_THREADS);
10973 init_remote_threadtests (void)
10975 add_com ("tlist", class_obscure, threadlist_test_cmd,
10976 _("Fetch and print the remote list of "
10977 "thread identifiers, one pkt only"));
10978 add_com ("tinfo", class_obscure, threadinfo_test_cmd,
10979 _("Fetch and display info about one thread"));
10980 add_com ("tset", class_obscure, threadset_test_cmd,
10981 _("Test setting to a different thread"));
10982 add_com ("tupd", class_obscure, threadlist_update_test_cmd,
10983 _("Iterate through updating all remote thread info"));
10984 add_com ("talive", class_obscure, threadalive_test,
10985 _(" Remote thread alive test "));
10990 /* Convert a thread ID to a string. Returns the string in a static
10993 static const char *
10994 remote_pid_to_str (struct target_ops *ops, ptid_t ptid)
10996 static char buf[64];
10997 struct remote_state *rs = get_remote_state ();
10999 if (ptid_equal (ptid, null_ptid))
11000 return normal_pid_to_str (ptid);
11001 else if (ptid_is_pid (ptid))
11003 /* Printing an inferior target id. */
11005 /* When multi-process extensions are off, there's no way in the
11006 remote protocol to know the remote process id, if there's any
11007 at all. There's one exception --- when we're connected with
11008 target extended-remote, and we manually attached to a process
11009 with "attach PID". We don't record anywhere a flag that
11010 allows us to distinguish that case from the case of
11011 connecting with extended-remote and the stub already being
11012 attached to a process, and reporting yes to qAttached, hence
11013 no smart special casing here. */
11014 if (!remote_multi_process_p (rs))
11016 xsnprintf (buf, sizeof buf, "Remote target");
11020 return normal_pid_to_str (ptid);
11024 if (ptid_equal (magic_null_ptid, ptid))
11025 xsnprintf (buf, sizeof buf, "Thread <main>");
11026 else if (remote_multi_process_p (rs))
11027 if (ptid_get_lwp (ptid) == 0)
11028 return normal_pid_to_str (ptid);
11030 xsnprintf (buf, sizeof buf, "Thread %d.%ld",
11031 ptid_get_pid (ptid), ptid_get_lwp (ptid));
11033 xsnprintf (buf, sizeof buf, "Thread %ld",
11034 ptid_get_lwp (ptid));
11039 /* Get the address of the thread local variable in OBJFILE which is
11040 stored at OFFSET within the thread local storage for thread PTID. */
11043 remote_get_thread_local_address (struct target_ops *ops,
11044 ptid_t ptid, CORE_ADDR lm, CORE_ADDR offset)
11046 if (packet_support (PACKET_qGetTLSAddr) != PACKET_DISABLE)
11048 struct remote_state *rs = get_remote_state ();
11050 char *endp = rs->buf + get_remote_packet_size ();
11051 enum packet_result result;
11053 strcpy (p, "qGetTLSAddr:");
11055 p = write_ptid (p, endp, ptid);
11057 p += hexnumstr (p, offset);
11059 p += hexnumstr (p, lm);
11063 getpkt (&rs->buf, &rs->buf_size, 0);
11064 result = packet_ok (rs->buf,
11065 &remote_protocol_packets[PACKET_qGetTLSAddr]);
11066 if (result == PACKET_OK)
11070 unpack_varlen_hex (rs->buf, &result);
11073 else if (result == PACKET_UNKNOWN)
11074 throw_error (TLS_GENERIC_ERROR,
11075 _("Remote target doesn't support qGetTLSAddr packet"));
11077 throw_error (TLS_GENERIC_ERROR,
11078 _("Remote target failed to process qGetTLSAddr request"));
11081 throw_error (TLS_GENERIC_ERROR,
11082 _("TLS not supported or disabled on this target"));
11087 /* Provide thread local base, i.e. Thread Information Block address.
11088 Returns 1 if ptid is found and thread_local_base is non zero. */
11091 remote_get_tib_address (struct target_ops *self, ptid_t ptid, CORE_ADDR *addr)
11093 if (packet_support (PACKET_qGetTIBAddr) != PACKET_DISABLE)
11095 struct remote_state *rs = get_remote_state ();
11097 char *endp = rs->buf + get_remote_packet_size ();
11098 enum packet_result result;
11100 strcpy (p, "qGetTIBAddr:");
11102 p = write_ptid (p, endp, ptid);
11106 getpkt (&rs->buf, &rs->buf_size, 0);
11107 result = packet_ok (rs->buf,
11108 &remote_protocol_packets[PACKET_qGetTIBAddr]);
11109 if (result == PACKET_OK)
11113 unpack_varlen_hex (rs->buf, &result);
11115 *addr = (CORE_ADDR) result;
11118 else if (result == PACKET_UNKNOWN)
11119 error (_("Remote target doesn't support qGetTIBAddr packet"));
11121 error (_("Remote target failed to process qGetTIBAddr request"));
11124 error (_("qGetTIBAddr not supported or disabled on this target"));
11129 /* Support for inferring a target description based on the current
11130 architecture and the size of a 'g' packet. While the 'g' packet
11131 can have any size (since optional registers can be left off the
11132 end), some sizes are easily recognizable given knowledge of the
11133 approximate architecture. */
11135 struct remote_g_packet_guess
11138 const struct target_desc *tdesc;
11140 typedef struct remote_g_packet_guess remote_g_packet_guess_s;
11141 DEF_VEC_O(remote_g_packet_guess_s);
11143 struct remote_g_packet_data
11145 VEC(remote_g_packet_guess_s) *guesses;
11148 static struct gdbarch_data *remote_g_packet_data_handle;
11151 remote_g_packet_data_init (struct obstack *obstack)
11153 return OBSTACK_ZALLOC (obstack, struct remote_g_packet_data);
11157 register_remote_g_packet_guess (struct gdbarch *gdbarch, int bytes,
11158 const struct target_desc *tdesc)
11160 struct remote_g_packet_data *data
11161 = ((struct remote_g_packet_data *)
11162 gdbarch_data (gdbarch, remote_g_packet_data_handle));
11163 struct remote_g_packet_guess new_guess, *guess;
11166 gdb_assert (tdesc != NULL);
11169 VEC_iterate (remote_g_packet_guess_s, data->guesses, ix, guess);
11171 if (guess->bytes == bytes)
11172 internal_error (__FILE__, __LINE__,
11173 _("Duplicate g packet description added for size %d"),
11176 new_guess.bytes = bytes;
11177 new_guess.tdesc = tdesc;
11178 VEC_safe_push (remote_g_packet_guess_s, data->guesses, &new_guess);
11181 /* Return 1 if remote_read_description would do anything on this target
11182 and architecture, 0 otherwise. */
11185 remote_read_description_p (struct target_ops *target)
11187 struct remote_g_packet_data *data
11188 = ((struct remote_g_packet_data *)
11189 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle));
11191 if (!VEC_empty (remote_g_packet_guess_s, data->guesses))
11197 static const struct target_desc *
11198 remote_read_description (struct target_ops *target)
11200 struct remote_g_packet_data *data
11201 = ((struct remote_g_packet_data *)
11202 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle));
11204 /* Do not try this during initial connection, when we do not know
11205 whether there is a running but stopped thread. */
11206 if (!target_has_execution || ptid_equal (inferior_ptid, null_ptid))
11207 return target->beneath->to_read_description (target->beneath);
11209 if (!VEC_empty (remote_g_packet_guess_s, data->guesses))
11211 struct remote_g_packet_guess *guess;
11213 int bytes = send_g_packet ();
11216 VEC_iterate (remote_g_packet_guess_s, data->guesses, ix, guess);
11218 if (guess->bytes == bytes)
11219 return guess->tdesc;
11221 /* We discard the g packet. A minor optimization would be to
11222 hold on to it, and fill the register cache once we have selected
11223 an architecture, but it's too tricky to do safely. */
11226 return target->beneath->to_read_description (target->beneath);
11229 /* Remote file transfer support. This is host-initiated I/O, not
11230 target-initiated; for target-initiated, see remote-fileio.c. */
11232 /* If *LEFT is at least the length of STRING, copy STRING to
11233 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11234 decrease *LEFT. Otherwise raise an error. */
11237 remote_buffer_add_string (char **buffer, int *left, const char *string)
11239 int len = strlen (string);
11242 error (_("Packet too long for target."));
11244 memcpy (*buffer, string, len);
11248 /* NUL-terminate the buffer as a convenience, if there is
11254 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
11255 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11256 decrease *LEFT. Otherwise raise an error. */
11259 remote_buffer_add_bytes (char **buffer, int *left, const gdb_byte *bytes,
11262 if (2 * len > *left)
11263 error (_("Packet too long for target."));
11265 bin2hex (bytes, *buffer, len);
11266 *buffer += 2 * len;
11269 /* NUL-terminate the buffer as a convenience, if there is
11275 /* If *LEFT is large enough, convert VALUE to hex and add it to
11276 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11277 decrease *LEFT. Otherwise raise an error. */
11280 remote_buffer_add_int (char **buffer, int *left, ULONGEST value)
11282 int len = hexnumlen (value);
11285 error (_("Packet too long for target."));
11287 hexnumstr (*buffer, value);
11291 /* NUL-terminate the buffer as a convenience, if there is
11297 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
11298 value, *REMOTE_ERRNO to the remote error number or zero if none
11299 was included, and *ATTACHMENT to point to the start of the annex
11300 if any. The length of the packet isn't needed here; there may
11301 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
11303 Return 0 if the packet could be parsed, -1 if it could not. If
11304 -1 is returned, the other variables may not be initialized. */
11307 remote_hostio_parse_result (char *buffer, int *retcode,
11308 int *remote_errno, char **attachment)
11313 *attachment = NULL;
11315 if (buffer[0] != 'F')
11319 *retcode = strtol (&buffer[1], &p, 16);
11320 if (errno != 0 || p == &buffer[1])
11323 /* Check for ",errno". */
11327 *remote_errno = strtol (p + 1, &p2, 16);
11328 if (errno != 0 || p + 1 == p2)
11333 /* Check for ";attachment". If there is no attachment, the
11334 packet should end here. */
11337 *attachment = p + 1;
11340 else if (*p == '\0')
11346 /* Send a prepared I/O packet to the target and read its response.
11347 The prepared packet is in the global RS->BUF before this function
11348 is called, and the answer is there when we return.
11350 COMMAND_BYTES is the length of the request to send, which may include
11351 binary data. WHICH_PACKET is the packet configuration to check
11352 before attempting a packet. If an error occurs, *REMOTE_ERRNO
11353 is set to the error number and -1 is returned. Otherwise the value
11354 returned by the function is returned.
11356 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
11357 attachment is expected; an error will be reported if there's a
11358 mismatch. If one is found, *ATTACHMENT will be set to point into
11359 the packet buffer and *ATTACHMENT_LEN will be set to the
11360 attachment's length. */
11363 remote_hostio_send_command (int command_bytes, int which_packet,
11364 int *remote_errno, char **attachment,
11365 int *attachment_len)
11367 struct remote_state *rs = get_remote_state ();
11368 int ret, bytes_read;
11369 char *attachment_tmp;
11371 if (!rs->remote_desc
11372 || packet_support (which_packet) == PACKET_DISABLE)
11374 *remote_errno = FILEIO_ENOSYS;
11378 putpkt_binary (rs->buf, command_bytes);
11379 bytes_read = getpkt_sane (&rs->buf, &rs->buf_size, 0);
11381 /* If it timed out, something is wrong. Don't try to parse the
11383 if (bytes_read < 0)
11385 *remote_errno = FILEIO_EINVAL;
11389 switch (packet_ok (rs->buf, &remote_protocol_packets[which_packet]))
11392 *remote_errno = FILEIO_EINVAL;
11394 case PACKET_UNKNOWN:
11395 *remote_errno = FILEIO_ENOSYS;
11401 if (remote_hostio_parse_result (rs->buf, &ret, remote_errno,
11404 *remote_errno = FILEIO_EINVAL;
11408 /* Make sure we saw an attachment if and only if we expected one. */
11409 if ((attachment_tmp == NULL && attachment != NULL)
11410 || (attachment_tmp != NULL && attachment == NULL))
11412 *remote_errno = FILEIO_EINVAL;
11416 /* If an attachment was found, it must point into the packet buffer;
11417 work out how many bytes there were. */
11418 if (attachment_tmp != NULL)
11420 *attachment = attachment_tmp;
11421 *attachment_len = bytes_read - (*attachment - rs->buf);
11427 /* Invalidate the readahead cache. */
11430 readahead_cache_invalidate (void)
11432 struct remote_state *rs = get_remote_state ();
11434 rs->readahead_cache.fd = -1;
11437 /* Invalidate the readahead cache if it is holding data for FD. */
11440 readahead_cache_invalidate_fd (int fd)
11442 struct remote_state *rs = get_remote_state ();
11444 if (rs->readahead_cache.fd == fd)
11445 rs->readahead_cache.fd = -1;
11448 /* Set the filesystem remote_hostio functions that take FILENAME
11449 arguments will use. Return 0 on success, or -1 if an error
11450 occurs (and set *REMOTE_ERRNO). */
11453 remote_hostio_set_filesystem (struct inferior *inf, int *remote_errno)
11455 struct remote_state *rs = get_remote_state ();
11456 int required_pid = (inf == NULL || inf->fake_pid_p) ? 0 : inf->pid;
11458 int left = get_remote_packet_size () - 1;
11462 if (packet_support (PACKET_vFile_setfs) == PACKET_DISABLE)
11465 if (rs->fs_pid != -1 && required_pid == rs->fs_pid)
11468 remote_buffer_add_string (&p, &left, "vFile:setfs:");
11470 xsnprintf (arg, sizeof (arg), "%x", required_pid);
11471 remote_buffer_add_string (&p, &left, arg);
11473 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_setfs,
11474 remote_errno, NULL, NULL);
11476 if (packet_support (PACKET_vFile_setfs) == PACKET_DISABLE)
11480 rs->fs_pid = required_pid;
11485 /* Implementation of to_fileio_open. */
11488 remote_hostio_open (struct target_ops *self,
11489 struct inferior *inf, const char *filename,
11490 int flags, int mode, int warn_if_slow,
11493 struct remote_state *rs = get_remote_state ();
11495 int left = get_remote_packet_size () - 1;
11499 static int warning_issued = 0;
11501 printf_unfiltered (_("Reading %s from remote target...\n"),
11504 if (!warning_issued)
11506 warning (_("File transfers from remote targets can be slow."
11507 " Use \"set sysroot\" to access files locally"
11509 warning_issued = 1;
11513 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
11516 remote_buffer_add_string (&p, &left, "vFile:open:");
11518 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
11519 strlen (filename));
11520 remote_buffer_add_string (&p, &left, ",");
11522 remote_buffer_add_int (&p, &left, flags);
11523 remote_buffer_add_string (&p, &left, ",");
11525 remote_buffer_add_int (&p, &left, mode);
11527 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_open,
11528 remote_errno, NULL, NULL);
11531 /* Implementation of to_fileio_pwrite. */
11534 remote_hostio_pwrite (struct target_ops *self,
11535 int fd, const gdb_byte *write_buf, int len,
11536 ULONGEST offset, int *remote_errno)
11538 struct remote_state *rs = get_remote_state ();
11540 int left = get_remote_packet_size ();
11543 readahead_cache_invalidate_fd (fd);
11545 remote_buffer_add_string (&p, &left, "vFile:pwrite:");
11547 remote_buffer_add_int (&p, &left, fd);
11548 remote_buffer_add_string (&p, &left, ",");
11550 remote_buffer_add_int (&p, &left, offset);
11551 remote_buffer_add_string (&p, &left, ",");
11553 p += remote_escape_output (write_buf, len, 1, (gdb_byte *) p, &out_len,
11554 get_remote_packet_size () - (p - rs->buf));
11556 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_pwrite,
11557 remote_errno, NULL, NULL);
11560 /* Helper for the implementation of to_fileio_pread. Read the file
11561 from the remote side with vFile:pread. */
11564 remote_hostio_pread_vFile (struct target_ops *self,
11565 int fd, gdb_byte *read_buf, int len,
11566 ULONGEST offset, int *remote_errno)
11568 struct remote_state *rs = get_remote_state ();
11571 int left = get_remote_packet_size ();
11572 int ret, attachment_len;
11575 remote_buffer_add_string (&p, &left, "vFile:pread:");
11577 remote_buffer_add_int (&p, &left, fd);
11578 remote_buffer_add_string (&p, &left, ",");
11580 remote_buffer_add_int (&p, &left, len);
11581 remote_buffer_add_string (&p, &left, ",");
11583 remote_buffer_add_int (&p, &left, offset);
11585 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_pread,
11586 remote_errno, &attachment,
11592 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
11594 if (read_len != ret)
11595 error (_("Read returned %d, but %d bytes."), ret, (int) read_len);
11600 /* Serve pread from the readahead cache. Returns number of bytes
11601 read, or 0 if the request can't be served from the cache. */
11604 remote_hostio_pread_from_cache (struct remote_state *rs,
11605 int fd, gdb_byte *read_buf, size_t len,
11608 struct readahead_cache *cache = &rs->readahead_cache;
11610 if (cache->fd == fd
11611 && cache->offset <= offset
11612 && offset < cache->offset + cache->bufsize)
11614 ULONGEST max = cache->offset + cache->bufsize;
11616 if (offset + len > max)
11617 len = max - offset;
11619 memcpy (read_buf, cache->buf + offset - cache->offset, len);
11626 /* Implementation of to_fileio_pread. */
11629 remote_hostio_pread (struct target_ops *self,
11630 int fd, gdb_byte *read_buf, int len,
11631 ULONGEST offset, int *remote_errno)
11634 struct remote_state *rs = get_remote_state ();
11635 struct readahead_cache *cache = &rs->readahead_cache;
11637 ret = remote_hostio_pread_from_cache (rs, fd, read_buf, len, offset);
11640 cache->hit_count++;
11643 fprintf_unfiltered (gdb_stdlog, "readahead cache hit %s\n",
11644 pulongest (cache->hit_count));
11648 cache->miss_count++;
11650 fprintf_unfiltered (gdb_stdlog, "readahead cache miss %s\n",
11651 pulongest (cache->miss_count));
11654 cache->offset = offset;
11655 cache->bufsize = get_remote_packet_size ();
11656 cache->buf = (gdb_byte *) xrealloc (cache->buf, cache->bufsize);
11658 ret = remote_hostio_pread_vFile (self, cache->fd, cache->buf, cache->bufsize,
11659 cache->offset, remote_errno);
11662 readahead_cache_invalidate_fd (fd);
11666 cache->bufsize = ret;
11667 return remote_hostio_pread_from_cache (rs, fd, read_buf, len, offset);
11670 /* Implementation of to_fileio_close. */
11673 remote_hostio_close (struct target_ops *self, int fd, int *remote_errno)
11675 struct remote_state *rs = get_remote_state ();
11677 int left = get_remote_packet_size () - 1;
11679 readahead_cache_invalidate_fd (fd);
11681 remote_buffer_add_string (&p, &left, "vFile:close:");
11683 remote_buffer_add_int (&p, &left, fd);
11685 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_close,
11686 remote_errno, NULL, NULL);
11689 /* Implementation of to_fileio_unlink. */
11692 remote_hostio_unlink (struct target_ops *self,
11693 struct inferior *inf, const char *filename,
11696 struct remote_state *rs = get_remote_state ();
11698 int left = get_remote_packet_size () - 1;
11700 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
11703 remote_buffer_add_string (&p, &left, "vFile:unlink:");
11705 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
11706 strlen (filename));
11708 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_unlink,
11709 remote_errno, NULL, NULL);
11712 /* Implementation of to_fileio_readlink. */
11715 remote_hostio_readlink (struct target_ops *self,
11716 struct inferior *inf, const char *filename,
11719 struct remote_state *rs = get_remote_state ();
11722 int left = get_remote_packet_size ();
11723 int len, attachment_len;
11727 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
11730 remote_buffer_add_string (&p, &left, "vFile:readlink:");
11732 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
11733 strlen (filename));
11735 len = remote_hostio_send_command (p - rs->buf, PACKET_vFile_readlink,
11736 remote_errno, &attachment,
11742 ret = (char *) xmalloc (len + 1);
11744 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
11745 (gdb_byte *) ret, len);
11746 if (read_len != len)
11747 error (_("Readlink returned %d, but %d bytes."), len, read_len);
11753 /* Implementation of to_fileio_fstat. */
11756 remote_hostio_fstat (struct target_ops *self,
11757 int fd, struct stat *st,
11760 struct remote_state *rs = get_remote_state ();
11762 int left = get_remote_packet_size ();
11763 int attachment_len, ret;
11765 struct fio_stat fst;
11768 remote_buffer_add_string (&p, &left, "vFile:fstat:");
11770 remote_buffer_add_int (&p, &left, fd);
11772 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_fstat,
11773 remote_errno, &attachment,
11777 if (*remote_errno != FILEIO_ENOSYS)
11780 /* Strictly we should return -1, ENOSYS here, but when
11781 "set sysroot remote:" was implemented in August 2008
11782 BFD's need for a stat function was sidestepped with
11783 this hack. This was not remedied until March 2015
11784 so we retain the previous behavior to avoid breaking
11787 Note that the memset is a March 2015 addition; older
11788 GDBs set st_size *and nothing else* so the structure
11789 would have garbage in all other fields. This might
11790 break something but retaining the previous behavior
11791 here would be just too wrong. */
11793 memset (st, 0, sizeof (struct stat));
11794 st->st_size = INT_MAX;
11798 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
11799 (gdb_byte *) &fst, sizeof (fst));
11801 if (read_len != ret)
11802 error (_("vFile:fstat returned %d, but %d bytes."), ret, read_len);
11804 if (read_len != sizeof (fst))
11805 error (_("vFile:fstat returned %d bytes, but expecting %d."),
11806 read_len, (int) sizeof (fst));
11808 remote_fileio_to_host_stat (&fst, st);
11813 /* Implementation of to_filesystem_is_local. */
11816 remote_filesystem_is_local (struct target_ops *self)
11818 /* Valgrind GDB presents itself as a remote target but works
11819 on the local filesystem: it does not implement remote get
11820 and users are not expected to set a sysroot. To handle
11821 this case we treat the remote filesystem as local if the
11822 sysroot is exactly TARGET_SYSROOT_PREFIX and if the stub
11823 does not support vFile:open. */
11824 if (strcmp (gdb_sysroot, TARGET_SYSROOT_PREFIX) == 0)
11826 enum packet_support ps = packet_support (PACKET_vFile_open);
11828 if (ps == PACKET_SUPPORT_UNKNOWN)
11830 int fd, remote_errno;
11832 /* Try opening a file to probe support. The supplied
11833 filename is irrelevant, we only care about whether
11834 the stub recognizes the packet or not. */
11835 fd = remote_hostio_open (self, NULL, "just probing",
11836 FILEIO_O_RDONLY, 0700, 0,
11840 remote_hostio_close (self, fd, &remote_errno);
11842 ps = packet_support (PACKET_vFile_open);
11845 if (ps == PACKET_DISABLE)
11847 static int warning_issued = 0;
11849 if (!warning_issued)
11851 warning (_("remote target does not support file"
11852 " transfer, attempting to access files"
11853 " from local filesystem."));
11854 warning_issued = 1;
11865 remote_fileio_errno_to_host (int errnum)
11871 case FILEIO_ENOENT:
11879 case FILEIO_EACCES:
11881 case FILEIO_EFAULT:
11885 case FILEIO_EEXIST:
11887 case FILEIO_ENODEV:
11889 case FILEIO_ENOTDIR:
11891 case FILEIO_EISDIR:
11893 case FILEIO_EINVAL:
11895 case FILEIO_ENFILE:
11897 case FILEIO_EMFILE:
11901 case FILEIO_ENOSPC:
11903 case FILEIO_ESPIPE:
11907 case FILEIO_ENOSYS:
11909 case FILEIO_ENAMETOOLONG:
11910 return ENAMETOOLONG;
11916 remote_hostio_error (int errnum)
11918 int host_error = remote_fileio_errno_to_host (errnum);
11920 if (host_error == -1)
11921 error (_("Unknown remote I/O error %d"), errnum);
11923 error (_("Remote I/O error: %s"), safe_strerror (host_error));
11927 remote_hostio_close_cleanup (void *opaque)
11929 int fd = *(int *) opaque;
11932 remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno);
11936 remote_file_put (const char *local_file, const char *remote_file, int from_tty)
11938 struct cleanup *back_to, *close_cleanup;
11939 int retcode, fd, remote_errno, bytes, io_size;
11941 int bytes_in_buffer;
11944 struct remote_state *rs = get_remote_state ();
11946 if (!rs->remote_desc)
11947 error (_("command can only be used with remote target"));
11949 gdb_file_up file = gdb_fopen_cloexec (local_file, "rb");
11951 perror_with_name (local_file);
11953 fd = remote_hostio_open (find_target_at (process_stratum), NULL,
11954 remote_file, (FILEIO_O_WRONLY | FILEIO_O_CREAT
11956 0700, 0, &remote_errno);
11958 remote_hostio_error (remote_errno);
11960 /* Send up to this many bytes at once. They won't all fit in the
11961 remote packet limit, so we'll transfer slightly fewer. */
11962 io_size = get_remote_packet_size ();
11963 buffer = (gdb_byte *) xmalloc (io_size);
11964 back_to = make_cleanup (xfree, buffer);
11966 close_cleanup = make_cleanup (remote_hostio_close_cleanup, &fd);
11968 bytes_in_buffer = 0;
11971 while (bytes_in_buffer || !saw_eof)
11975 bytes = fread (buffer + bytes_in_buffer, 1,
11976 io_size - bytes_in_buffer,
11980 if (ferror (file.get ()))
11981 error (_("Error reading %s."), local_file);
11984 /* EOF. Unless there is something still in the
11985 buffer from the last iteration, we are done. */
11987 if (bytes_in_buffer == 0)
11995 bytes += bytes_in_buffer;
11996 bytes_in_buffer = 0;
11998 retcode = remote_hostio_pwrite (find_target_at (process_stratum),
12000 offset, &remote_errno);
12003 remote_hostio_error (remote_errno);
12004 else if (retcode == 0)
12005 error (_("Remote write of %d bytes returned 0!"), bytes);
12006 else if (retcode < bytes)
12008 /* Short write. Save the rest of the read data for the next
12010 bytes_in_buffer = bytes - retcode;
12011 memmove (buffer, buffer + retcode, bytes_in_buffer);
12017 discard_cleanups (close_cleanup);
12018 if (remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno))
12019 remote_hostio_error (remote_errno);
12022 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file);
12023 do_cleanups (back_to);
12027 remote_file_get (const char *remote_file, const char *local_file, int from_tty)
12029 struct cleanup *back_to, *close_cleanup;
12030 int fd, remote_errno, bytes, io_size;
12033 struct remote_state *rs = get_remote_state ();
12035 if (!rs->remote_desc)
12036 error (_("command can only be used with remote target"));
12038 fd = remote_hostio_open (find_target_at (process_stratum), NULL,
12039 remote_file, FILEIO_O_RDONLY, 0, 0,
12042 remote_hostio_error (remote_errno);
12044 gdb_file_up file = gdb_fopen_cloexec (local_file, "wb");
12046 perror_with_name (local_file);
12048 /* Send up to this many bytes at once. They won't all fit in the
12049 remote packet limit, so we'll transfer slightly fewer. */
12050 io_size = get_remote_packet_size ();
12051 buffer = (gdb_byte *) xmalloc (io_size);
12052 back_to = make_cleanup (xfree, buffer);
12054 close_cleanup = make_cleanup (remote_hostio_close_cleanup, &fd);
12059 bytes = remote_hostio_pread (find_target_at (process_stratum),
12060 fd, buffer, io_size, offset, &remote_errno);
12062 /* Success, but no bytes, means end-of-file. */
12065 remote_hostio_error (remote_errno);
12069 bytes = fwrite (buffer, 1, bytes, file.get ());
12071 perror_with_name (local_file);
12074 discard_cleanups (close_cleanup);
12075 if (remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno))
12076 remote_hostio_error (remote_errno);
12079 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file);
12080 do_cleanups (back_to);
12084 remote_file_delete (const char *remote_file, int from_tty)
12086 int retcode, remote_errno;
12087 struct remote_state *rs = get_remote_state ();
12089 if (!rs->remote_desc)
12090 error (_("command can only be used with remote target"));
12092 retcode = remote_hostio_unlink (find_target_at (process_stratum),
12093 NULL, remote_file, &remote_errno);
12095 remote_hostio_error (remote_errno);
12098 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file);
12102 remote_put_command (const char *args, int from_tty)
12105 error_no_arg (_("file to put"));
12107 gdb_argv argv (args);
12108 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
12109 error (_("Invalid parameters to remote put"));
12111 remote_file_put (argv[0], argv[1], from_tty);
12115 remote_get_command (const char *args, int from_tty)
12118 error_no_arg (_("file to get"));
12120 gdb_argv argv (args);
12121 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
12122 error (_("Invalid parameters to remote get"));
12124 remote_file_get (argv[0], argv[1], from_tty);
12128 remote_delete_command (const char *args, int from_tty)
12131 error_no_arg (_("file to delete"));
12133 gdb_argv argv (args);
12134 if (argv[0] == NULL || argv[1] != NULL)
12135 error (_("Invalid parameters to remote delete"));
12137 remote_file_delete (argv[0], from_tty);
12141 remote_command (const char *args, int from_tty)
12143 help_list (remote_cmdlist, "remote ", all_commands, gdb_stdout);
12147 remote_can_execute_reverse (struct target_ops *self)
12149 if (packet_support (PACKET_bs) == PACKET_ENABLE
12150 || packet_support (PACKET_bc) == PACKET_ENABLE)
12157 remote_supports_non_stop (struct target_ops *self)
12163 remote_supports_disable_randomization (struct target_ops *self)
12165 /* Only supported in extended mode. */
12170 remote_supports_multi_process (struct target_ops *self)
12172 struct remote_state *rs = get_remote_state ();
12174 return remote_multi_process_p (rs);
12178 remote_supports_cond_tracepoints (void)
12180 return packet_support (PACKET_ConditionalTracepoints) == PACKET_ENABLE;
12184 remote_supports_cond_breakpoints (struct target_ops *self)
12186 return packet_support (PACKET_ConditionalBreakpoints) == PACKET_ENABLE;
12190 remote_supports_fast_tracepoints (void)
12192 return packet_support (PACKET_FastTracepoints) == PACKET_ENABLE;
12196 remote_supports_static_tracepoints (void)
12198 return packet_support (PACKET_StaticTracepoints) == PACKET_ENABLE;
12202 remote_supports_install_in_trace (void)
12204 return packet_support (PACKET_InstallInTrace) == PACKET_ENABLE;
12208 remote_supports_enable_disable_tracepoint (struct target_ops *self)
12210 return (packet_support (PACKET_EnableDisableTracepoints_feature)
12215 remote_supports_string_tracing (struct target_ops *self)
12217 return packet_support (PACKET_tracenz_feature) == PACKET_ENABLE;
12221 remote_can_run_breakpoint_commands (struct target_ops *self)
12223 return packet_support (PACKET_BreakpointCommands) == PACKET_ENABLE;
12227 remote_trace_init (struct target_ops *self)
12229 struct remote_state *rs = get_remote_state ();
12232 remote_get_noisy_reply ();
12233 if (strcmp (rs->buf, "OK") != 0)
12234 error (_("Target does not support this command."));
12237 /* Recursive routine to walk through command list including loops, and
12238 download packets for each command. */
12241 remote_download_command_source (int num, ULONGEST addr,
12242 struct command_line *cmds)
12244 struct remote_state *rs = get_remote_state ();
12245 struct command_line *cmd;
12247 for (cmd = cmds; cmd; cmd = cmd->next)
12249 QUIT; /* Allow user to bail out with ^C. */
12250 strcpy (rs->buf, "QTDPsrc:");
12251 encode_source_string (num, addr, "cmd", cmd->line,
12252 rs->buf + strlen (rs->buf),
12253 rs->buf_size - strlen (rs->buf));
12255 remote_get_noisy_reply ();
12256 if (strcmp (rs->buf, "OK"))
12257 warning (_("Target does not support source download."));
12259 if (cmd->control_type == while_control
12260 || cmd->control_type == while_stepping_control)
12262 remote_download_command_source (num, addr, *cmd->body_list);
12264 QUIT; /* Allow user to bail out with ^C. */
12265 strcpy (rs->buf, "QTDPsrc:");
12266 encode_source_string (num, addr, "cmd", "end",
12267 rs->buf + strlen (rs->buf),
12268 rs->buf_size - strlen (rs->buf));
12270 remote_get_noisy_reply ();
12271 if (strcmp (rs->buf, "OK"))
12272 warning (_("Target does not support source download."));
12278 remote_download_tracepoint (struct target_ops *self, struct bp_location *loc)
12280 #define BUF_SIZE 2048
12284 char buf[BUF_SIZE];
12285 std::vector<std::string> tdp_actions;
12286 std::vector<std::string> stepping_actions;
12288 struct breakpoint *b = loc->owner;
12289 struct tracepoint *t = (struct tracepoint *) b;
12290 struct remote_state *rs = get_remote_state ();
12292 encode_actions_rsp (loc, &tdp_actions, &stepping_actions);
12294 tpaddr = loc->address;
12295 sprintf_vma (addrbuf, tpaddr);
12296 xsnprintf (buf, BUF_SIZE, "QTDP:%x:%s:%c:%lx:%x", b->number,
12297 addrbuf, /* address */
12298 (b->enable_state == bp_enabled ? 'E' : 'D'),
12299 t->step_count, t->pass_count);
12300 /* Fast tracepoints are mostly handled by the target, but we can
12301 tell the target how big of an instruction block should be moved
12303 if (b->type == bp_fast_tracepoint)
12305 /* Only test for support at download time; we may not know
12306 target capabilities at definition time. */
12307 if (remote_supports_fast_tracepoints ())
12309 if (gdbarch_fast_tracepoint_valid_at (loc->gdbarch, tpaddr,
12311 xsnprintf (buf + strlen (buf), BUF_SIZE - strlen (buf), ":F%x",
12312 gdb_insn_length (loc->gdbarch, tpaddr));
12314 /* If it passed validation at definition but fails now,
12315 something is very wrong. */
12316 internal_error (__FILE__, __LINE__,
12317 _("Fast tracepoint not "
12318 "valid during download"));
12321 /* Fast tracepoints are functionally identical to regular
12322 tracepoints, so don't take lack of support as a reason to
12323 give up on the trace run. */
12324 warning (_("Target does not support fast tracepoints, "
12325 "downloading %d as regular tracepoint"), b->number);
12327 else if (b->type == bp_static_tracepoint)
12329 /* Only test for support at download time; we may not know
12330 target capabilities at definition time. */
12331 if (remote_supports_static_tracepoints ())
12333 struct static_tracepoint_marker marker;
12335 if (target_static_tracepoint_marker_at (tpaddr, &marker))
12336 strcat (buf, ":S");
12338 error (_("Static tracepoint not valid during download"));
12341 /* Fast tracepoints are functionally identical to regular
12342 tracepoints, so don't take lack of support as a reason
12343 to give up on the trace run. */
12344 error (_("Target does not support static tracepoints"));
12346 /* If the tracepoint has a conditional, make it into an agent
12347 expression and append to the definition. */
12350 /* Only test support at download time, we may not know target
12351 capabilities at definition time. */
12352 if (remote_supports_cond_tracepoints ())
12354 agent_expr_up aexpr = gen_eval_for_expr (tpaddr, loc->cond.get ());
12355 xsnprintf (buf + strlen (buf), BUF_SIZE - strlen (buf), ":X%x,",
12357 pkt = buf + strlen (buf);
12358 for (int ndx = 0; ndx < aexpr->len; ++ndx)
12359 pkt = pack_hex_byte (pkt, aexpr->buf[ndx]);
12363 warning (_("Target does not support conditional tracepoints, "
12364 "ignoring tp %d cond"), b->number);
12367 if (b->commands || *default_collect)
12370 remote_get_noisy_reply ();
12371 if (strcmp (rs->buf, "OK"))
12372 error (_("Target does not support tracepoints."));
12374 /* do_single_steps (t); */
12375 for (auto action_it = tdp_actions.begin ();
12376 action_it != tdp_actions.end (); action_it++)
12378 QUIT; /* Allow user to bail out with ^C. */
12380 bool has_more = (action_it != tdp_actions.end ()
12381 || !stepping_actions.empty ());
12383 xsnprintf (buf, BUF_SIZE, "QTDP:-%x:%s:%s%c",
12384 b->number, addrbuf, /* address */
12385 action_it->c_str (),
12386 has_more ? '-' : 0);
12388 remote_get_noisy_reply ();
12389 if (strcmp (rs->buf, "OK"))
12390 error (_("Error on target while setting tracepoints."));
12393 for (auto action_it = stepping_actions.begin ();
12394 action_it != stepping_actions.end (); action_it++)
12396 QUIT; /* Allow user to bail out with ^C. */
12398 bool is_first = action_it == stepping_actions.begin ();
12399 bool has_more = action_it != stepping_actions.end ();
12401 xsnprintf (buf, BUF_SIZE, "QTDP:-%x:%s:%s%s%s",
12402 b->number, addrbuf, /* address */
12403 is_first ? "S" : "",
12404 action_it->c_str (),
12405 has_more ? "-" : "");
12407 remote_get_noisy_reply ();
12408 if (strcmp (rs->buf, "OK"))
12409 error (_("Error on target while setting tracepoints."));
12412 if (packet_support (PACKET_TracepointSource) == PACKET_ENABLE)
12414 if (b->location != NULL)
12416 strcpy (buf, "QTDPsrc:");
12417 encode_source_string (b->number, loc->address, "at",
12418 event_location_to_string (b->location.get ()),
12419 buf + strlen (buf), 2048 - strlen (buf));
12421 remote_get_noisy_reply ();
12422 if (strcmp (rs->buf, "OK"))
12423 warning (_("Target does not support source download."));
12425 if (b->cond_string)
12427 strcpy (buf, "QTDPsrc:");
12428 encode_source_string (b->number, loc->address,
12429 "cond", b->cond_string, buf + strlen (buf),
12430 2048 - strlen (buf));
12432 remote_get_noisy_reply ();
12433 if (strcmp (rs->buf, "OK"))
12434 warning (_("Target does not support source download."));
12436 remote_download_command_source (b->number, loc->address,
12437 breakpoint_commands (b));
12442 remote_can_download_tracepoint (struct target_ops *self)
12444 struct remote_state *rs = get_remote_state ();
12445 struct trace_status *ts;
12448 /* Don't try to install tracepoints until we've relocated our
12449 symbols, and fetched and merged the target's tracepoint list with
12451 if (rs->starting_up)
12454 ts = current_trace_status ();
12455 status = remote_get_trace_status (self, ts);
12457 if (status == -1 || !ts->running_known || !ts->running)
12460 /* If we are in a tracing experiment, but remote stub doesn't support
12461 installing tracepoint in trace, we have to return. */
12462 if (!remote_supports_install_in_trace ())
12470 remote_download_trace_state_variable (struct target_ops *self,
12471 struct trace_state_variable *tsv)
12473 struct remote_state *rs = get_remote_state ();
12476 xsnprintf (rs->buf, get_remote_packet_size (), "QTDV:%x:%s:%x:",
12477 tsv->number, phex ((ULONGEST) tsv->initial_value, 8),
12479 p = rs->buf + strlen (rs->buf);
12480 if ((p - rs->buf) + strlen (tsv->name) * 2 >= get_remote_packet_size ())
12481 error (_("Trace state variable name too long for tsv definition packet"));
12482 p += 2 * bin2hex ((gdb_byte *) (tsv->name), p, strlen (tsv->name));
12485 remote_get_noisy_reply ();
12486 if (*rs->buf == '\0')
12487 error (_("Target does not support this command."));
12488 if (strcmp (rs->buf, "OK") != 0)
12489 error (_("Error on target while downloading trace state variable."));
12493 remote_enable_tracepoint (struct target_ops *self,
12494 struct bp_location *location)
12496 struct remote_state *rs = get_remote_state ();
12499 sprintf_vma (addr_buf, location->address);
12500 xsnprintf (rs->buf, get_remote_packet_size (), "QTEnable:%x:%s",
12501 location->owner->number, addr_buf);
12503 remote_get_noisy_reply ();
12504 if (*rs->buf == '\0')
12505 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
12506 if (strcmp (rs->buf, "OK") != 0)
12507 error (_("Error on target while enabling tracepoint."));
12511 remote_disable_tracepoint (struct target_ops *self,
12512 struct bp_location *location)
12514 struct remote_state *rs = get_remote_state ();
12517 sprintf_vma (addr_buf, location->address);
12518 xsnprintf (rs->buf, get_remote_packet_size (), "QTDisable:%x:%s",
12519 location->owner->number, addr_buf);
12521 remote_get_noisy_reply ();
12522 if (*rs->buf == '\0')
12523 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
12524 if (strcmp (rs->buf, "OK") != 0)
12525 error (_("Error on target while disabling tracepoint."));
12529 remote_trace_set_readonly_regions (struct target_ops *self)
12533 bfd_size_type size;
12539 return; /* No information to give. */
12541 struct remote_state *rs = get_remote_state ();
12543 strcpy (rs->buf, "QTro");
12544 offset = strlen (rs->buf);
12545 for (s = exec_bfd->sections; s; s = s->next)
12547 char tmp1[40], tmp2[40];
12550 if ((s->flags & SEC_LOAD) == 0 ||
12551 /* (s->flags & SEC_CODE) == 0 || */
12552 (s->flags & SEC_READONLY) == 0)
12556 vma = bfd_get_section_vma (abfd, s);
12557 size = bfd_get_section_size (s);
12558 sprintf_vma (tmp1, vma);
12559 sprintf_vma (tmp2, vma + size);
12560 sec_length = 1 + strlen (tmp1) + 1 + strlen (tmp2);
12561 if (offset + sec_length + 1 > rs->buf_size)
12563 if (packet_support (PACKET_qXfer_traceframe_info) != PACKET_ENABLE)
12565 Too many sections for read-only sections definition packet."));
12568 xsnprintf (rs->buf + offset, rs->buf_size - offset, ":%s,%s",
12570 offset += sec_length;
12575 getpkt (&rs->buf, &rs->buf_size, 0);
12580 remote_trace_start (struct target_ops *self)
12582 struct remote_state *rs = get_remote_state ();
12584 putpkt ("QTStart");
12585 remote_get_noisy_reply ();
12586 if (*rs->buf == '\0')
12587 error (_("Target does not support this command."));
12588 if (strcmp (rs->buf, "OK") != 0)
12589 error (_("Bogus reply from target: %s"), rs->buf);
12593 remote_get_trace_status (struct target_ops *self, struct trace_status *ts)
12595 /* Initialize it just to avoid a GCC false warning. */
12597 /* FIXME we need to get register block size some other way. */
12598 extern int trace_regblock_size;
12599 enum packet_result result;
12600 struct remote_state *rs = get_remote_state ();
12602 if (packet_support (PACKET_qTStatus) == PACKET_DISABLE)
12605 trace_regblock_size
12606 = get_remote_arch_state (target_gdbarch ())->sizeof_g_packet;
12608 putpkt ("qTStatus");
12612 p = remote_get_noisy_reply ();
12614 CATCH (ex, RETURN_MASK_ERROR)
12616 if (ex.error != TARGET_CLOSE_ERROR)
12618 exception_fprintf (gdb_stderr, ex, "qTStatus: ");
12621 throw_exception (ex);
12625 result = packet_ok (p, &remote_protocol_packets[PACKET_qTStatus]);
12627 /* If the remote target doesn't do tracing, flag it. */
12628 if (result == PACKET_UNKNOWN)
12631 /* We're working with a live target. */
12632 ts->filename = NULL;
12635 error (_("Bogus trace status reply from target: %s"), rs->buf);
12637 /* Function 'parse_trace_status' sets default value of each field of
12638 'ts' at first, so we don't have to do it here. */
12639 parse_trace_status (p, ts);
12641 return ts->running;
12645 remote_get_tracepoint_status (struct target_ops *self, struct breakpoint *bp,
12646 struct uploaded_tp *utp)
12648 struct remote_state *rs = get_remote_state ();
12650 struct bp_location *loc;
12651 struct tracepoint *tp = (struct tracepoint *) bp;
12652 size_t size = get_remote_packet_size ();
12657 tp->traceframe_usage = 0;
12658 for (loc = tp->loc; loc; loc = loc->next)
12660 /* If the tracepoint was never downloaded, don't go asking for
12662 if (tp->number_on_target == 0)
12664 xsnprintf (rs->buf, size, "qTP:%x:%s", tp->number_on_target,
12665 phex_nz (loc->address, 0));
12667 reply = remote_get_noisy_reply ();
12668 if (reply && *reply)
12671 parse_tracepoint_status (reply + 1, bp, utp);
12677 utp->hit_count = 0;
12678 utp->traceframe_usage = 0;
12679 xsnprintf (rs->buf, size, "qTP:%x:%s", utp->number,
12680 phex_nz (utp->addr, 0));
12682 reply = remote_get_noisy_reply ();
12683 if (reply && *reply)
12686 parse_tracepoint_status (reply + 1, bp, utp);
12692 remote_trace_stop (struct target_ops *self)
12694 struct remote_state *rs = get_remote_state ();
12697 remote_get_noisy_reply ();
12698 if (*rs->buf == '\0')
12699 error (_("Target does not support this command."));
12700 if (strcmp (rs->buf, "OK") != 0)
12701 error (_("Bogus reply from target: %s"), rs->buf);
12705 remote_trace_find (struct target_ops *self,
12706 enum trace_find_type type, int num,
12707 CORE_ADDR addr1, CORE_ADDR addr2,
12710 struct remote_state *rs = get_remote_state ();
12711 char *endbuf = rs->buf + get_remote_packet_size ();
12713 int target_frameno = -1, target_tracept = -1;
12715 /* Lookups other than by absolute frame number depend on the current
12716 trace selected, so make sure it is correct on the remote end
12718 if (type != tfind_number)
12719 set_remote_traceframe ();
12722 strcpy (p, "QTFrame:");
12723 p = strchr (p, '\0');
12727 xsnprintf (p, endbuf - p, "%x", num);
12730 xsnprintf (p, endbuf - p, "pc:%s", phex_nz (addr1, 0));
12733 xsnprintf (p, endbuf - p, "tdp:%x", num);
12736 xsnprintf (p, endbuf - p, "range:%s:%s", phex_nz (addr1, 0),
12737 phex_nz (addr2, 0));
12739 case tfind_outside:
12740 xsnprintf (p, endbuf - p, "outside:%s:%s", phex_nz (addr1, 0),
12741 phex_nz (addr2, 0));
12744 error (_("Unknown trace find type %d"), type);
12748 reply = remote_get_noisy_reply ();
12749 if (*reply == '\0')
12750 error (_("Target does not support this command."));
12752 while (reply && *reply)
12757 target_frameno = (int) strtol (p, &reply, 16);
12759 error (_("Unable to parse trace frame number"));
12760 /* Don't update our remote traceframe number cache on failure
12761 to select a remote traceframe. */
12762 if (target_frameno == -1)
12767 target_tracept = (int) strtol (p, &reply, 16);
12769 error (_("Unable to parse tracepoint number"));
12771 case 'O': /* "OK"? */
12772 if (reply[1] == 'K' && reply[2] == '\0')
12775 error (_("Bogus reply from target: %s"), reply);
12778 error (_("Bogus reply from target: %s"), reply);
12781 *tpp = target_tracept;
12783 rs->remote_traceframe_number = target_frameno;
12784 return target_frameno;
12788 remote_get_trace_state_variable_value (struct target_ops *self,
12789 int tsvnum, LONGEST *val)
12791 struct remote_state *rs = get_remote_state ();
12795 set_remote_traceframe ();
12797 xsnprintf (rs->buf, get_remote_packet_size (), "qTV:%x", tsvnum);
12799 reply = remote_get_noisy_reply ();
12800 if (reply && *reply)
12804 unpack_varlen_hex (reply + 1, &uval);
12805 *val = (LONGEST) uval;
12813 remote_save_trace_data (struct target_ops *self, const char *filename)
12815 struct remote_state *rs = get_remote_state ();
12819 strcpy (p, "QTSave:");
12821 if ((p - rs->buf) + strlen (filename) * 2 >= get_remote_packet_size ())
12822 error (_("Remote file name too long for trace save packet"));
12823 p += 2 * bin2hex ((gdb_byte *) filename, p, strlen (filename));
12826 reply = remote_get_noisy_reply ();
12827 if (*reply == '\0')
12828 error (_("Target does not support this command."));
12829 if (strcmp (reply, "OK") != 0)
12830 error (_("Bogus reply from target: %s"), reply);
12834 /* This is basically a memory transfer, but needs to be its own packet
12835 because we don't know how the target actually organizes its trace
12836 memory, plus we want to be able to ask for as much as possible, but
12837 not be unhappy if we don't get as much as we ask for. */
12840 remote_get_raw_trace_data (struct target_ops *self,
12841 gdb_byte *buf, ULONGEST offset, LONGEST len)
12843 struct remote_state *rs = get_remote_state ();
12849 strcpy (p, "qTBuffer:");
12851 p += hexnumstr (p, offset);
12853 p += hexnumstr (p, len);
12857 reply = remote_get_noisy_reply ();
12858 if (reply && *reply)
12860 /* 'l' by itself means we're at the end of the buffer and
12861 there is nothing more to get. */
12865 /* Convert the reply into binary. Limit the number of bytes to
12866 convert according to our passed-in buffer size, rather than
12867 what was returned in the packet; if the target is
12868 unexpectedly generous and gives us a bigger reply than we
12869 asked for, we don't want to crash. */
12870 rslt = hex2bin (reply, buf, len);
12874 /* Something went wrong, flag as an error. */
12879 remote_set_disconnected_tracing (struct target_ops *self, int val)
12881 struct remote_state *rs = get_remote_state ();
12883 if (packet_support (PACKET_DisconnectedTracing_feature) == PACKET_ENABLE)
12887 xsnprintf (rs->buf, get_remote_packet_size (), "QTDisconnected:%x", val);
12889 reply = remote_get_noisy_reply ();
12890 if (*reply == '\0')
12891 error (_("Target does not support this command."));
12892 if (strcmp (reply, "OK") != 0)
12893 error (_("Bogus reply from target: %s"), reply);
12896 warning (_("Target does not support disconnected tracing."));
12900 remote_core_of_thread (struct target_ops *ops, ptid_t ptid)
12902 struct thread_info *info = find_thread_ptid (ptid);
12904 if (info != NULL && info->priv != NULL)
12905 return get_remote_thread_info (info)->core;
12911 remote_set_circular_trace_buffer (struct target_ops *self, int val)
12913 struct remote_state *rs = get_remote_state ();
12916 xsnprintf (rs->buf, get_remote_packet_size (), "QTBuffer:circular:%x", val);
12918 reply = remote_get_noisy_reply ();
12919 if (*reply == '\0')
12920 error (_("Target does not support this command."));
12921 if (strcmp (reply, "OK") != 0)
12922 error (_("Bogus reply from target: %s"), reply);
12925 static traceframe_info_up
12926 remote_traceframe_info (struct target_ops *self)
12928 gdb::unique_xmalloc_ptr<char> text
12929 = target_read_stralloc (¤t_target, TARGET_OBJECT_TRACEFRAME_INFO,
12932 return parse_traceframe_info (text.get ());
12937 /* Handle the qTMinFTPILen packet. Returns the minimum length of
12938 instruction on which a fast tracepoint may be placed. Returns -1
12939 if the packet is not supported, and 0 if the minimum instruction
12940 length is unknown. */
12943 remote_get_min_fast_tracepoint_insn_len (struct target_ops *self)
12945 struct remote_state *rs = get_remote_state ();
12948 /* If we're not debugging a process yet, the IPA can't be
12950 if (!target_has_execution)
12953 /* Make sure the remote is pointing at the right process. */
12954 set_general_process ();
12956 xsnprintf (rs->buf, get_remote_packet_size (), "qTMinFTPILen");
12958 reply = remote_get_noisy_reply ();
12959 if (*reply == '\0')
12963 ULONGEST min_insn_len;
12965 unpack_varlen_hex (reply, &min_insn_len);
12967 return (int) min_insn_len;
12972 remote_set_trace_buffer_size (struct target_ops *self, LONGEST val)
12974 if (packet_support (PACKET_QTBuffer_size) != PACKET_DISABLE)
12976 struct remote_state *rs = get_remote_state ();
12977 char *buf = rs->buf;
12978 char *endbuf = rs->buf + get_remote_packet_size ();
12979 enum packet_result result;
12981 gdb_assert (val >= 0 || val == -1);
12982 buf += xsnprintf (buf, endbuf - buf, "QTBuffer:size:");
12983 /* Send -1 as literal "-1" to avoid host size dependency. */
12987 buf += hexnumstr (buf, (ULONGEST) -val);
12990 buf += hexnumstr (buf, (ULONGEST) val);
12993 remote_get_noisy_reply ();
12994 result = packet_ok (rs->buf,
12995 &remote_protocol_packets[PACKET_QTBuffer_size]);
12997 if (result != PACKET_OK)
12998 warning (_("Bogus reply from target: %s"), rs->buf);
13003 remote_set_trace_notes (struct target_ops *self,
13004 const char *user, const char *notes,
13005 const char *stop_notes)
13007 struct remote_state *rs = get_remote_state ();
13009 char *buf = rs->buf;
13010 char *endbuf = rs->buf + get_remote_packet_size ();
13013 buf += xsnprintf (buf, endbuf - buf, "QTNotes:");
13016 buf += xsnprintf (buf, endbuf - buf, "user:");
13017 nbytes = bin2hex ((gdb_byte *) user, buf, strlen (user));
13023 buf += xsnprintf (buf, endbuf - buf, "notes:");
13024 nbytes = bin2hex ((gdb_byte *) notes, buf, strlen (notes));
13030 buf += xsnprintf (buf, endbuf - buf, "tstop:");
13031 nbytes = bin2hex ((gdb_byte *) stop_notes, buf, strlen (stop_notes));
13035 /* Ensure the buffer is terminated. */
13039 reply = remote_get_noisy_reply ();
13040 if (*reply == '\0')
13043 if (strcmp (reply, "OK") != 0)
13044 error (_("Bogus reply from target: %s"), reply);
13050 remote_use_agent (struct target_ops *self, int use)
13052 if (packet_support (PACKET_QAgent) != PACKET_DISABLE)
13054 struct remote_state *rs = get_remote_state ();
13056 /* If the stub supports QAgent. */
13057 xsnprintf (rs->buf, get_remote_packet_size (), "QAgent:%d", use);
13059 getpkt (&rs->buf, &rs->buf_size, 0);
13061 if (strcmp (rs->buf, "OK") == 0)
13072 remote_can_use_agent (struct target_ops *self)
13074 return (packet_support (PACKET_QAgent) != PACKET_DISABLE);
13077 struct btrace_target_info
13079 /* The ptid of the traced thread. */
13082 /* The obtained branch trace configuration. */
13083 struct btrace_config conf;
13086 /* Reset our idea of our target's btrace configuration. */
13089 remote_btrace_reset (void)
13091 struct remote_state *rs = get_remote_state ();
13093 memset (&rs->btrace_config, 0, sizeof (rs->btrace_config));
13096 /* Check whether the target supports branch tracing. */
13099 remote_supports_btrace (struct target_ops *self, enum btrace_format format)
13101 if (packet_support (PACKET_Qbtrace_off) != PACKET_ENABLE)
13103 if (packet_support (PACKET_qXfer_btrace) != PACKET_ENABLE)
13108 case BTRACE_FORMAT_NONE:
13111 case BTRACE_FORMAT_BTS:
13112 return (packet_support (PACKET_Qbtrace_bts) == PACKET_ENABLE);
13114 case BTRACE_FORMAT_PT:
13115 /* The trace is decoded on the host. Even if our target supports it,
13116 we still need to have libipt to decode the trace. */
13117 #if defined (HAVE_LIBIPT)
13118 return (packet_support (PACKET_Qbtrace_pt) == PACKET_ENABLE);
13119 #else /* !defined (HAVE_LIBIPT) */
13121 #endif /* !defined (HAVE_LIBIPT) */
13124 internal_error (__FILE__, __LINE__, _("Unknown branch trace format"));
13127 /* Synchronize the configuration with the target. */
13130 btrace_sync_conf (const struct btrace_config *conf)
13132 struct packet_config *packet;
13133 struct remote_state *rs;
13134 char *buf, *pos, *endbuf;
13136 rs = get_remote_state ();
13138 endbuf = buf + get_remote_packet_size ();
13140 packet = &remote_protocol_packets[PACKET_Qbtrace_conf_bts_size];
13141 if (packet_config_support (packet) == PACKET_ENABLE
13142 && conf->bts.size != rs->btrace_config.bts.size)
13145 pos += xsnprintf (pos, endbuf - pos, "%s=0x%x", packet->name,
13149 getpkt (&buf, &rs->buf_size, 0);
13151 if (packet_ok (buf, packet) == PACKET_ERROR)
13153 if (buf[0] == 'E' && buf[1] == '.')
13154 error (_("Failed to configure the BTS buffer size: %s"), buf + 2);
13156 error (_("Failed to configure the BTS buffer size."));
13159 rs->btrace_config.bts.size = conf->bts.size;
13162 packet = &remote_protocol_packets[PACKET_Qbtrace_conf_pt_size];
13163 if (packet_config_support (packet) == PACKET_ENABLE
13164 && conf->pt.size != rs->btrace_config.pt.size)
13167 pos += xsnprintf (pos, endbuf - pos, "%s=0x%x", packet->name,
13171 getpkt (&buf, &rs->buf_size, 0);
13173 if (packet_ok (buf, packet) == PACKET_ERROR)
13175 if (buf[0] == 'E' && buf[1] == '.')
13176 error (_("Failed to configure the trace buffer size: %s"), buf + 2);
13178 error (_("Failed to configure the trace buffer size."));
13181 rs->btrace_config.pt.size = conf->pt.size;
13185 /* Read the current thread's btrace configuration from the target and
13186 store it into CONF. */
13189 btrace_read_config (struct btrace_config *conf)
13191 gdb::unique_xmalloc_ptr<char> xml
13192 = target_read_stralloc (¤t_target, TARGET_OBJECT_BTRACE_CONF, "");
13194 parse_xml_btrace_conf (conf, xml.get ());
13197 /* Maybe reopen target btrace. */
13200 remote_btrace_maybe_reopen (void)
13202 struct remote_state *rs = get_remote_state ();
13203 struct thread_info *tp;
13204 int btrace_target_pushed = 0;
13207 scoped_restore_current_thread restore_thread;
13209 ALL_NON_EXITED_THREADS (tp)
13211 set_general_thread (tp->ptid);
13213 memset (&rs->btrace_config, 0x00, sizeof (struct btrace_config));
13214 btrace_read_config (&rs->btrace_config);
13216 if (rs->btrace_config.format == BTRACE_FORMAT_NONE)
13219 #if !defined (HAVE_LIBIPT)
13220 if (rs->btrace_config.format == BTRACE_FORMAT_PT)
13225 warning (_("GDB does not support Intel Processor Trace. "
13226 "\"record\" will not work in this session."));
13231 #endif /* !defined (HAVE_LIBIPT) */
13233 /* Push target, once, but before anything else happens. This way our
13234 changes to the threads will be cleaned up by unpushing the target
13235 in case btrace_read_config () throws. */
13236 if (!btrace_target_pushed)
13238 btrace_target_pushed = 1;
13239 record_btrace_push_target ();
13240 printf_filtered (_("Target is recording using %s.\n"),
13241 btrace_format_string (rs->btrace_config.format));
13244 tp->btrace.target = XCNEW (struct btrace_target_info);
13245 tp->btrace.target->ptid = tp->ptid;
13246 tp->btrace.target->conf = rs->btrace_config;
13250 /* Enable branch tracing. */
13252 static struct btrace_target_info *
13253 remote_enable_btrace (struct target_ops *self, ptid_t ptid,
13254 const struct btrace_config *conf)
13256 struct btrace_target_info *tinfo = NULL;
13257 struct packet_config *packet = NULL;
13258 struct remote_state *rs = get_remote_state ();
13259 char *buf = rs->buf;
13260 char *endbuf = rs->buf + get_remote_packet_size ();
13262 switch (conf->format)
13264 case BTRACE_FORMAT_BTS:
13265 packet = &remote_protocol_packets[PACKET_Qbtrace_bts];
13268 case BTRACE_FORMAT_PT:
13269 packet = &remote_protocol_packets[PACKET_Qbtrace_pt];
13273 if (packet == NULL || packet_config_support (packet) != PACKET_ENABLE)
13274 error (_("Target does not support branch tracing."));
13276 btrace_sync_conf (conf);
13278 set_general_thread (ptid);
13280 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
13282 getpkt (&rs->buf, &rs->buf_size, 0);
13284 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
13286 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
13287 error (_("Could not enable branch tracing for %s: %s"),
13288 target_pid_to_str (ptid), rs->buf + 2);
13290 error (_("Could not enable branch tracing for %s."),
13291 target_pid_to_str (ptid));
13294 tinfo = XCNEW (struct btrace_target_info);
13295 tinfo->ptid = ptid;
13297 /* If we fail to read the configuration, we lose some information, but the
13298 tracing itself is not impacted. */
13301 btrace_read_config (&tinfo->conf);
13303 CATCH (err, RETURN_MASK_ERROR)
13305 if (err.message != NULL)
13306 warning ("%s", err.message);
13313 /* Disable branch tracing. */
13316 remote_disable_btrace (struct target_ops *self,
13317 struct btrace_target_info *tinfo)
13319 struct packet_config *packet = &remote_protocol_packets[PACKET_Qbtrace_off];
13320 struct remote_state *rs = get_remote_state ();
13321 char *buf = rs->buf;
13322 char *endbuf = rs->buf + get_remote_packet_size ();
13324 if (packet_config_support (packet) != PACKET_ENABLE)
13325 error (_("Target does not support branch tracing."));
13327 set_general_thread (tinfo->ptid);
13329 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
13331 getpkt (&rs->buf, &rs->buf_size, 0);
13333 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
13335 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
13336 error (_("Could not disable branch tracing for %s: %s"),
13337 target_pid_to_str (tinfo->ptid), rs->buf + 2);
13339 error (_("Could not disable branch tracing for %s."),
13340 target_pid_to_str (tinfo->ptid));
13346 /* Teardown branch tracing. */
13349 remote_teardown_btrace (struct target_ops *self,
13350 struct btrace_target_info *tinfo)
13352 /* We must not talk to the target during teardown. */
13356 /* Read the branch trace. */
13358 static enum btrace_error
13359 remote_read_btrace (struct target_ops *self,
13360 struct btrace_data *btrace,
13361 struct btrace_target_info *tinfo,
13362 enum btrace_read_type type)
13364 struct packet_config *packet = &remote_protocol_packets[PACKET_qXfer_btrace];
13367 if (packet_config_support (packet) != PACKET_ENABLE)
13368 error (_("Target does not support branch tracing."));
13370 #if !defined(HAVE_LIBEXPAT)
13371 error (_("Cannot process branch tracing result. XML parsing not supported."));
13376 case BTRACE_READ_ALL:
13379 case BTRACE_READ_NEW:
13382 case BTRACE_READ_DELTA:
13386 internal_error (__FILE__, __LINE__,
13387 _("Bad branch tracing read type: %u."),
13388 (unsigned int) type);
13391 gdb::unique_xmalloc_ptr<char> xml
13392 = target_read_stralloc (¤t_target, TARGET_OBJECT_BTRACE, annex);
13394 return BTRACE_ERR_UNKNOWN;
13396 parse_xml_btrace (btrace, xml.get ());
13398 return BTRACE_ERR_NONE;
13401 static const struct btrace_config *
13402 remote_btrace_conf (struct target_ops *self,
13403 const struct btrace_target_info *tinfo)
13405 return &tinfo->conf;
13409 remote_augmented_libraries_svr4_read (struct target_ops *self)
13411 return (packet_support (PACKET_augmented_libraries_svr4_read_feature)
13415 /* Implementation of to_load. */
13418 remote_load (struct target_ops *self, const char *name, int from_tty)
13420 generic_load (name, from_tty);
13423 /* Accepts an integer PID; returns a string representing a file that
13424 can be opened on the remote side to get the symbols for the child
13425 process. Returns NULL if the operation is not supported. */
13428 remote_pid_to_exec_file (struct target_ops *self, int pid)
13430 static gdb::unique_xmalloc_ptr<char> filename;
13431 struct inferior *inf;
13432 char *annex = NULL;
13434 if (packet_support (PACKET_qXfer_exec_file) != PACKET_ENABLE)
13437 inf = find_inferior_pid (pid);
13439 internal_error (__FILE__, __LINE__,
13440 _("not currently attached to process %d"), pid);
13442 if (!inf->fake_pid_p)
13444 const int annex_size = 9;
13446 annex = (char *) alloca (annex_size);
13447 xsnprintf (annex, annex_size, "%x", pid);
13450 filename = target_read_stralloc (¤t_target,
13451 TARGET_OBJECT_EXEC_FILE, annex);
13453 return filename.get ();
13456 /* Implement the to_can_do_single_step target_ops method. */
13459 remote_can_do_single_step (struct target_ops *ops)
13461 /* We can only tell whether target supports single step or not by
13462 supported s and S vCont actions if the stub supports vContSupported
13463 feature. If the stub doesn't support vContSupported feature,
13464 we have conservatively to think target doesn't supports single
13466 if (packet_support (PACKET_vContSupported) == PACKET_ENABLE)
13468 struct remote_state *rs = get_remote_state ();
13470 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
13471 remote_vcont_probe (rs);
13473 return rs->supports_vCont.s && rs->supports_vCont.S;
13479 /* Implementation of the to_execution_direction method for the remote
13482 static enum exec_direction_kind
13483 remote_execution_direction (struct target_ops *self)
13485 struct remote_state *rs = get_remote_state ();
13487 return rs->last_resume_exec_dir;
13490 /* Return pointer to the thread_info struct which corresponds to
13491 THREAD_HANDLE (having length HANDLE_LEN). */
13493 static struct thread_info *
13494 remote_thread_handle_to_thread_info (struct target_ops *ops,
13495 const gdb_byte *thread_handle,
13497 struct inferior *inf)
13499 struct thread_info *tp;
13501 ALL_NON_EXITED_THREADS (tp)
13503 remote_thread_info *priv = get_remote_thread_info (tp);
13505 if (tp->inf == inf && priv != NULL)
13507 if (handle_len != priv->thread_handle.size ())
13508 error (_("Thread handle size mismatch: %d vs %zu (from remote)"),
13509 handle_len, priv->thread_handle.size ());
13510 if (memcmp (thread_handle, priv->thread_handle.data (),
13520 init_remote_ops (void)
13522 remote_ops.to_shortname = "remote";
13523 remote_ops.to_longname = "Remote serial target in gdb-specific protocol";
13524 remote_ops.to_doc =
13525 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
13526 Specify the serial device it is connected to\n\
13527 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).";
13528 remote_ops.to_open = remote_open;
13529 remote_ops.to_close = remote_close;
13530 remote_ops.to_detach = remote_detach;
13531 remote_ops.to_disconnect = remote_disconnect;
13532 remote_ops.to_resume = remote_resume;
13533 remote_ops.to_commit_resume = remote_commit_resume;
13534 remote_ops.to_wait = remote_wait;
13535 remote_ops.to_fetch_registers = remote_fetch_registers;
13536 remote_ops.to_store_registers = remote_store_registers;
13537 remote_ops.to_prepare_to_store = remote_prepare_to_store;
13538 remote_ops.to_files_info = remote_files_info;
13539 remote_ops.to_insert_breakpoint = remote_insert_breakpoint;
13540 remote_ops.to_remove_breakpoint = remote_remove_breakpoint;
13541 remote_ops.to_stopped_by_sw_breakpoint = remote_stopped_by_sw_breakpoint;
13542 remote_ops.to_supports_stopped_by_sw_breakpoint = remote_supports_stopped_by_sw_breakpoint;
13543 remote_ops.to_stopped_by_hw_breakpoint = remote_stopped_by_hw_breakpoint;
13544 remote_ops.to_supports_stopped_by_hw_breakpoint = remote_supports_stopped_by_hw_breakpoint;
13545 remote_ops.to_stopped_by_watchpoint = remote_stopped_by_watchpoint;
13546 remote_ops.to_stopped_data_address = remote_stopped_data_address;
13547 remote_ops.to_watchpoint_addr_within_range =
13548 remote_watchpoint_addr_within_range;
13549 remote_ops.to_can_use_hw_breakpoint = remote_check_watch_resources;
13550 remote_ops.to_insert_hw_breakpoint = remote_insert_hw_breakpoint;
13551 remote_ops.to_remove_hw_breakpoint = remote_remove_hw_breakpoint;
13552 remote_ops.to_region_ok_for_hw_watchpoint
13553 = remote_region_ok_for_hw_watchpoint;
13554 remote_ops.to_insert_watchpoint = remote_insert_watchpoint;
13555 remote_ops.to_remove_watchpoint = remote_remove_watchpoint;
13556 remote_ops.to_kill = remote_kill;
13557 remote_ops.to_load = remote_load;
13558 remote_ops.to_mourn_inferior = remote_mourn;
13559 remote_ops.to_pass_signals = remote_pass_signals;
13560 remote_ops.to_set_syscall_catchpoint = remote_set_syscall_catchpoint;
13561 remote_ops.to_program_signals = remote_program_signals;
13562 remote_ops.to_thread_alive = remote_thread_alive;
13563 remote_ops.to_thread_name = remote_thread_name;
13564 remote_ops.to_update_thread_list = remote_update_thread_list;
13565 remote_ops.to_pid_to_str = remote_pid_to_str;
13566 remote_ops.to_extra_thread_info = remote_threads_extra_info;
13567 remote_ops.to_get_ada_task_ptid = remote_get_ada_task_ptid;
13568 remote_ops.to_stop = remote_stop;
13569 remote_ops.to_interrupt = remote_interrupt;
13570 remote_ops.to_pass_ctrlc = remote_pass_ctrlc;
13571 remote_ops.to_xfer_partial = remote_xfer_partial;
13572 remote_ops.to_get_memory_xfer_limit = remote_get_memory_xfer_limit;
13573 remote_ops.to_rcmd = remote_rcmd;
13574 remote_ops.to_pid_to_exec_file = remote_pid_to_exec_file;
13575 remote_ops.to_log_command = serial_log_command;
13576 remote_ops.to_get_thread_local_address = remote_get_thread_local_address;
13577 remote_ops.to_stratum = process_stratum;
13578 remote_ops.to_has_all_memory = default_child_has_all_memory;
13579 remote_ops.to_has_memory = default_child_has_memory;
13580 remote_ops.to_has_stack = default_child_has_stack;
13581 remote_ops.to_has_registers = default_child_has_registers;
13582 remote_ops.to_has_execution = default_child_has_execution;
13583 remote_ops.to_has_thread_control = tc_schedlock; /* can lock scheduler */
13584 remote_ops.to_can_execute_reverse = remote_can_execute_reverse;
13585 remote_ops.to_magic = OPS_MAGIC;
13586 remote_ops.to_memory_map = remote_memory_map;
13587 remote_ops.to_flash_erase = remote_flash_erase;
13588 remote_ops.to_flash_done = remote_flash_done;
13589 remote_ops.to_read_description = remote_read_description;
13590 remote_ops.to_search_memory = remote_search_memory;
13591 remote_ops.to_can_async_p = remote_can_async_p;
13592 remote_ops.to_is_async_p = remote_is_async_p;
13593 remote_ops.to_async = remote_async;
13594 remote_ops.to_thread_events = remote_thread_events;
13595 remote_ops.to_can_do_single_step = remote_can_do_single_step;
13596 remote_ops.to_terminal_inferior = remote_terminal_inferior;
13597 remote_ops.to_terminal_ours = remote_terminal_ours;
13598 remote_ops.to_supports_non_stop = remote_supports_non_stop;
13599 remote_ops.to_supports_multi_process = remote_supports_multi_process;
13600 remote_ops.to_supports_disable_randomization
13601 = remote_supports_disable_randomization;
13602 remote_ops.to_filesystem_is_local = remote_filesystem_is_local;
13603 remote_ops.to_fileio_open = remote_hostio_open;
13604 remote_ops.to_fileio_pwrite = remote_hostio_pwrite;
13605 remote_ops.to_fileio_pread = remote_hostio_pread;
13606 remote_ops.to_fileio_fstat = remote_hostio_fstat;
13607 remote_ops.to_fileio_close = remote_hostio_close;
13608 remote_ops.to_fileio_unlink = remote_hostio_unlink;
13609 remote_ops.to_fileio_readlink = remote_hostio_readlink;
13610 remote_ops.to_supports_enable_disable_tracepoint = remote_supports_enable_disable_tracepoint;
13611 remote_ops.to_supports_string_tracing = remote_supports_string_tracing;
13612 remote_ops.to_supports_evaluation_of_breakpoint_conditions = remote_supports_cond_breakpoints;
13613 remote_ops.to_can_run_breakpoint_commands = remote_can_run_breakpoint_commands;
13614 remote_ops.to_trace_init = remote_trace_init;
13615 remote_ops.to_download_tracepoint = remote_download_tracepoint;
13616 remote_ops.to_can_download_tracepoint = remote_can_download_tracepoint;
13617 remote_ops.to_download_trace_state_variable
13618 = remote_download_trace_state_variable;
13619 remote_ops.to_enable_tracepoint = remote_enable_tracepoint;
13620 remote_ops.to_disable_tracepoint = remote_disable_tracepoint;
13621 remote_ops.to_trace_set_readonly_regions = remote_trace_set_readonly_regions;
13622 remote_ops.to_trace_start = remote_trace_start;
13623 remote_ops.to_get_trace_status = remote_get_trace_status;
13624 remote_ops.to_get_tracepoint_status = remote_get_tracepoint_status;
13625 remote_ops.to_trace_stop = remote_trace_stop;
13626 remote_ops.to_trace_find = remote_trace_find;
13627 remote_ops.to_get_trace_state_variable_value
13628 = remote_get_trace_state_variable_value;
13629 remote_ops.to_save_trace_data = remote_save_trace_data;
13630 remote_ops.to_upload_tracepoints = remote_upload_tracepoints;
13631 remote_ops.to_upload_trace_state_variables
13632 = remote_upload_trace_state_variables;
13633 remote_ops.to_get_raw_trace_data = remote_get_raw_trace_data;
13634 remote_ops.to_get_min_fast_tracepoint_insn_len = remote_get_min_fast_tracepoint_insn_len;
13635 remote_ops.to_set_disconnected_tracing = remote_set_disconnected_tracing;
13636 remote_ops.to_set_circular_trace_buffer = remote_set_circular_trace_buffer;
13637 remote_ops.to_set_trace_buffer_size = remote_set_trace_buffer_size;
13638 remote_ops.to_set_trace_notes = remote_set_trace_notes;
13639 remote_ops.to_core_of_thread = remote_core_of_thread;
13640 remote_ops.to_verify_memory = remote_verify_memory;
13641 remote_ops.to_get_tib_address = remote_get_tib_address;
13642 remote_ops.to_set_permissions = remote_set_permissions;
13643 remote_ops.to_static_tracepoint_marker_at
13644 = remote_static_tracepoint_marker_at;
13645 remote_ops.to_static_tracepoint_markers_by_strid
13646 = remote_static_tracepoint_markers_by_strid;
13647 remote_ops.to_traceframe_info = remote_traceframe_info;
13648 remote_ops.to_use_agent = remote_use_agent;
13649 remote_ops.to_can_use_agent = remote_can_use_agent;
13650 remote_ops.to_supports_btrace = remote_supports_btrace;
13651 remote_ops.to_enable_btrace = remote_enable_btrace;
13652 remote_ops.to_disable_btrace = remote_disable_btrace;
13653 remote_ops.to_teardown_btrace = remote_teardown_btrace;
13654 remote_ops.to_read_btrace = remote_read_btrace;
13655 remote_ops.to_btrace_conf = remote_btrace_conf;
13656 remote_ops.to_augmented_libraries_svr4_read =
13657 remote_augmented_libraries_svr4_read;
13658 remote_ops.to_follow_fork = remote_follow_fork;
13659 remote_ops.to_follow_exec = remote_follow_exec;
13660 remote_ops.to_insert_fork_catchpoint = remote_insert_fork_catchpoint;
13661 remote_ops.to_remove_fork_catchpoint = remote_remove_fork_catchpoint;
13662 remote_ops.to_insert_vfork_catchpoint = remote_insert_vfork_catchpoint;
13663 remote_ops.to_remove_vfork_catchpoint = remote_remove_vfork_catchpoint;
13664 remote_ops.to_insert_exec_catchpoint = remote_insert_exec_catchpoint;
13665 remote_ops.to_remove_exec_catchpoint = remote_remove_exec_catchpoint;
13666 remote_ops.to_execution_direction = remote_execution_direction;
13667 remote_ops.to_thread_handle_to_thread_info =
13668 remote_thread_handle_to_thread_info;
13671 /* Set up the extended remote vector by making a copy of the standard
13672 remote vector and adding to it. */
13675 init_extended_remote_ops (void)
13677 extended_remote_ops = remote_ops;
13679 extended_remote_ops.to_shortname = "extended-remote";
13680 extended_remote_ops.to_longname =
13681 "Extended remote serial target in gdb-specific protocol";
13682 extended_remote_ops.to_doc =
13683 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
13684 Specify the serial device it is connected to (e.g. /dev/ttya).";
13685 extended_remote_ops.to_open = extended_remote_open;
13686 extended_remote_ops.to_create_inferior = extended_remote_create_inferior;
13687 extended_remote_ops.to_detach = extended_remote_detach;
13688 extended_remote_ops.to_attach = extended_remote_attach;
13689 extended_remote_ops.to_post_attach = extended_remote_post_attach;
13690 extended_remote_ops.to_supports_disable_randomization
13691 = extended_remote_supports_disable_randomization;
13695 remote_can_async_p (struct target_ops *ops)
13697 struct remote_state *rs = get_remote_state ();
13699 /* We don't go async if the user has explicitly prevented it with the
13700 "maint set target-async" command. */
13701 if (!target_async_permitted)
13704 /* We're async whenever the serial device is. */
13705 return serial_can_async_p (rs->remote_desc);
13709 remote_is_async_p (struct target_ops *ops)
13711 struct remote_state *rs = get_remote_state ();
13713 if (!target_async_permitted)
13714 /* We only enable async when the user specifically asks for it. */
13717 /* We're async whenever the serial device is. */
13718 return serial_is_async_p (rs->remote_desc);
13721 /* Pass the SERIAL event on and up to the client. One day this code
13722 will be able to delay notifying the client of an event until the
13723 point where an entire packet has been received. */
13725 static serial_event_ftype remote_async_serial_handler;
13728 remote_async_serial_handler (struct serial *scb, void *context)
13730 /* Don't propogate error information up to the client. Instead let
13731 the client find out about the error by querying the target. */
13732 inferior_event_handler (INF_REG_EVENT, NULL);
13736 remote_async_inferior_event_handler (gdb_client_data data)
13738 inferior_event_handler (INF_REG_EVENT, NULL);
13742 remote_async (struct target_ops *ops, int enable)
13744 struct remote_state *rs = get_remote_state ();
13748 serial_async (rs->remote_desc, remote_async_serial_handler, rs);
13750 /* If there are pending events in the stop reply queue tell the
13751 event loop to process them. */
13752 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
13753 mark_async_event_handler (remote_async_inferior_event_token);
13754 /* For simplicity, below we clear the pending events token
13755 without remembering whether it is marked, so here we always
13756 mark it. If there's actually no pending notification to
13757 process, this ends up being a no-op (other than a spurious
13758 event-loop wakeup). */
13759 if (target_is_non_stop_p ())
13760 mark_async_event_handler (rs->notif_state->get_pending_events_token);
13764 serial_async (rs->remote_desc, NULL, NULL);
13765 /* If the core is disabling async, it doesn't want to be
13766 disturbed with target events. Clear all async event sources
13768 clear_async_event_handler (remote_async_inferior_event_token);
13769 if (target_is_non_stop_p ())
13770 clear_async_event_handler (rs->notif_state->get_pending_events_token);
13774 /* Implementation of the to_thread_events method. */
13777 remote_thread_events (struct target_ops *ops, int enable)
13779 struct remote_state *rs = get_remote_state ();
13780 size_t size = get_remote_packet_size ();
13782 if (packet_support (PACKET_QThreadEvents) == PACKET_DISABLE)
13785 xsnprintf (rs->buf, size, "QThreadEvents:%x", enable ? 1 : 0);
13787 getpkt (&rs->buf, &rs->buf_size, 0);
13789 switch (packet_ok (rs->buf,
13790 &remote_protocol_packets[PACKET_QThreadEvents]))
13793 if (strcmp (rs->buf, "OK") != 0)
13794 error (_("Remote refused setting thread events: %s"), rs->buf);
13797 warning (_("Remote failure reply: %s"), rs->buf);
13799 case PACKET_UNKNOWN:
13805 set_remote_cmd (const char *args, int from_tty)
13807 help_list (remote_set_cmdlist, "set remote ", all_commands, gdb_stdout);
13811 show_remote_cmd (const char *args, int from_tty)
13813 /* We can't just use cmd_show_list here, because we want to skip
13814 the redundant "show remote Z-packet" and the legacy aliases. */
13815 struct cmd_list_element *list = remote_show_cmdlist;
13816 struct ui_out *uiout = current_uiout;
13818 ui_out_emit_tuple tuple_emitter (uiout, "showlist");
13819 for (; list != NULL; list = list->next)
13820 if (strcmp (list->name, "Z-packet") == 0)
13822 else if (list->type == not_set_cmd)
13823 /* Alias commands are exactly like the original, except they
13824 don't have the normal type. */
13828 ui_out_emit_tuple option_emitter (uiout, "option");
13830 uiout->field_string ("name", list->name);
13831 uiout->text (": ");
13832 if (list->type == show_cmd)
13833 do_show_command (NULL, from_tty, list);
13835 cmd_func (list, NULL, from_tty);
13840 /* Function to be called whenever a new objfile (shlib) is detected. */
13842 remote_new_objfile (struct objfile *objfile)
13844 struct remote_state *rs = get_remote_state ();
13846 if (rs->remote_desc != 0) /* Have a remote connection. */
13847 remote_check_symbols ();
13850 /* Pull all the tracepoints defined on the target and create local
13851 data structures representing them. We don't want to create real
13852 tracepoints yet, we don't want to mess up the user's existing
13856 remote_upload_tracepoints (struct target_ops *self, struct uploaded_tp **utpp)
13858 struct remote_state *rs = get_remote_state ();
13861 /* Ask for a first packet of tracepoint definition. */
13863 getpkt (&rs->buf, &rs->buf_size, 0);
13865 while (*p && *p != 'l')
13867 parse_tracepoint_definition (p, utpp);
13868 /* Ask for another packet of tracepoint definition. */
13870 getpkt (&rs->buf, &rs->buf_size, 0);
13877 remote_upload_trace_state_variables (struct target_ops *self,
13878 struct uploaded_tsv **utsvp)
13880 struct remote_state *rs = get_remote_state ();
13883 /* Ask for a first packet of variable definition. */
13885 getpkt (&rs->buf, &rs->buf_size, 0);
13887 while (*p && *p != 'l')
13889 parse_tsv_definition (p, utsvp);
13890 /* Ask for another packet of variable definition. */
13892 getpkt (&rs->buf, &rs->buf_size, 0);
13898 /* The "set/show range-stepping" show hook. */
13901 show_range_stepping (struct ui_file *file, int from_tty,
13902 struct cmd_list_element *c,
13905 fprintf_filtered (file,
13906 _("Debugger's willingness to use range stepping "
13907 "is %s.\n"), value);
13910 /* The "set/show range-stepping" set hook. */
13913 set_range_stepping (const char *ignore_args, int from_tty,
13914 struct cmd_list_element *c)
13916 struct remote_state *rs = get_remote_state ();
13918 /* Whene enabling, check whether range stepping is actually
13919 supported by the target, and warn if not. */
13920 if (use_range_stepping)
13922 if (rs->remote_desc != NULL)
13924 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
13925 remote_vcont_probe (rs);
13927 if (packet_support (PACKET_vCont) == PACKET_ENABLE
13928 && rs->supports_vCont.r)
13932 warning (_("Range stepping is not supported by the current target"));
13937 _initialize_remote (void)
13939 struct cmd_list_element *cmd;
13940 const char *cmd_name;
13942 /* architecture specific data */
13943 remote_gdbarch_data_handle =
13944 gdbarch_data_register_post_init (init_remote_state);
13945 remote_g_packet_data_handle =
13946 gdbarch_data_register_pre_init (remote_g_packet_data_init);
13949 = register_program_space_data_with_cleanup (NULL,
13950 remote_pspace_data_cleanup);
13952 /* Initialize the per-target state. At the moment there is only one
13953 of these, not one per target. Only one target is active at a
13955 remote_state = new_remote_state ();
13957 init_remote_ops ();
13958 add_target (&remote_ops);
13960 init_extended_remote_ops ();
13961 add_target (&extended_remote_ops);
13963 /* Hook into new objfile notification. */
13964 observer_attach_new_objfile (remote_new_objfile);
13965 /* We're no longer interested in notification events of an inferior
13967 observer_attach_inferior_exit (discard_pending_stop_replies);
13970 init_remote_threadtests ();
13973 stop_reply_queue = QUEUE_alloc (stop_reply_p, stop_reply_xfree);
13974 /* set/show remote ... */
13976 add_prefix_cmd ("remote", class_maintenance, set_remote_cmd, _("\
13977 Remote protocol specific variables\n\
13978 Configure various remote-protocol specific variables such as\n\
13979 the packets being used"),
13980 &remote_set_cmdlist, "set remote ",
13981 0 /* allow-unknown */, &setlist);
13982 add_prefix_cmd ("remote", class_maintenance, show_remote_cmd, _("\
13983 Remote protocol specific variables\n\
13984 Configure various remote-protocol specific variables such as\n\
13985 the packets being used"),
13986 &remote_show_cmdlist, "show remote ",
13987 0 /* allow-unknown */, &showlist);
13989 add_cmd ("compare-sections", class_obscure, compare_sections_command, _("\
13990 Compare section data on target to the exec file.\n\
13991 Argument is a single section name (default: all loaded sections).\n\
13992 To compare only read-only loaded sections, specify the -r option."),
13995 add_cmd ("packet", class_maintenance, packet_command, _("\
13996 Send an arbitrary packet to a remote target.\n\
13997 maintenance packet TEXT\n\
13998 If GDB is talking to an inferior via the GDB serial protocol, then\n\
13999 this command sends the string TEXT to the inferior, and displays the\n\
14000 response packet. GDB supplies the initial `$' character, and the\n\
14001 terminating `#' character and checksum."),
14004 add_setshow_boolean_cmd ("remotebreak", no_class, &remote_break, _("\
14005 Set whether to send break if interrupted."), _("\
14006 Show whether to send break if interrupted."), _("\
14007 If set, a break, instead of a cntrl-c, is sent to the remote target."),
14008 set_remotebreak, show_remotebreak,
14009 &setlist, &showlist);
14010 cmd_name = "remotebreak";
14011 cmd = lookup_cmd (&cmd_name, setlist, "", -1, 1);
14012 deprecate_cmd (cmd, "set remote interrupt-sequence");
14013 cmd_name = "remotebreak"; /* needed because lookup_cmd updates the pointer */
14014 cmd = lookup_cmd (&cmd_name, showlist, "", -1, 1);
14015 deprecate_cmd (cmd, "show remote interrupt-sequence");
14017 add_setshow_enum_cmd ("interrupt-sequence", class_support,
14018 interrupt_sequence_modes, &interrupt_sequence_mode,
14020 Set interrupt sequence to remote target."), _("\
14021 Show interrupt sequence to remote target."), _("\
14022 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
14023 NULL, show_interrupt_sequence,
14024 &remote_set_cmdlist,
14025 &remote_show_cmdlist);
14027 add_setshow_boolean_cmd ("interrupt-on-connect", class_support,
14028 &interrupt_on_connect, _("\
14029 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
14030 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
14031 If set, interrupt sequence is sent to remote target."),
14033 &remote_set_cmdlist, &remote_show_cmdlist);
14035 /* Install commands for configuring memory read/write packets. */
14037 add_cmd ("remotewritesize", no_class, set_memory_write_packet_size, _("\
14038 Set the maximum number of bytes per memory write packet (deprecated)."),
14040 add_cmd ("remotewritesize", no_class, show_memory_write_packet_size, _("\
14041 Show the maximum number of bytes per memory write packet (deprecated)."),
14043 add_cmd ("memory-write-packet-size", no_class,
14044 set_memory_write_packet_size, _("\
14045 Set the maximum number of bytes per memory-write packet.\n\
14046 Specify the number of bytes in a packet or 0 (zero) for the\n\
14047 default packet size. The actual limit is further reduced\n\
14048 dependent on the target. Specify ``fixed'' to disable the\n\
14049 further restriction and ``limit'' to enable that restriction."),
14050 &remote_set_cmdlist);
14051 add_cmd ("memory-read-packet-size", no_class,
14052 set_memory_read_packet_size, _("\
14053 Set the maximum number of bytes per memory-read packet.\n\
14054 Specify the number of bytes in a packet or 0 (zero) for the\n\
14055 default packet size. The actual limit is further reduced\n\
14056 dependent on the target. Specify ``fixed'' to disable the\n\
14057 further restriction and ``limit'' to enable that restriction."),
14058 &remote_set_cmdlist);
14059 add_cmd ("memory-write-packet-size", no_class,
14060 show_memory_write_packet_size,
14061 _("Show the maximum number of bytes per memory-write packet."),
14062 &remote_show_cmdlist);
14063 add_cmd ("memory-read-packet-size", no_class,
14064 show_memory_read_packet_size,
14065 _("Show the maximum number of bytes per memory-read packet."),
14066 &remote_show_cmdlist);
14068 add_setshow_zinteger_cmd ("hardware-watchpoint-limit", no_class,
14069 &remote_hw_watchpoint_limit, _("\
14070 Set the maximum number of target hardware watchpoints."), _("\
14071 Show the maximum number of target hardware watchpoints."), _("\
14072 Specify a negative limit for unlimited."),
14073 NULL, NULL, /* FIXME: i18n: The maximum
14074 number of target hardware
14075 watchpoints is %s. */
14076 &remote_set_cmdlist, &remote_show_cmdlist);
14077 add_setshow_zinteger_cmd ("hardware-watchpoint-length-limit", no_class,
14078 &remote_hw_watchpoint_length_limit, _("\
14079 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
14080 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
14081 Specify a negative limit for unlimited."),
14082 NULL, NULL, /* FIXME: i18n: The maximum
14083 length (in bytes) of a target
14084 hardware watchpoint is %s. */
14085 &remote_set_cmdlist, &remote_show_cmdlist);
14086 add_setshow_zinteger_cmd ("hardware-breakpoint-limit", no_class,
14087 &remote_hw_breakpoint_limit, _("\
14088 Set the maximum number of target hardware breakpoints."), _("\
14089 Show the maximum number of target hardware breakpoints."), _("\
14090 Specify a negative limit for unlimited."),
14091 NULL, NULL, /* FIXME: i18n: The maximum
14092 number of target hardware
14093 breakpoints is %s. */
14094 &remote_set_cmdlist, &remote_show_cmdlist);
14096 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure,
14097 &remote_address_size, _("\
14098 Set the maximum size of the address (in bits) in a memory packet."), _("\
14099 Show the maximum size of the address (in bits) in a memory packet."), NULL,
14101 NULL, /* FIXME: i18n: */
14102 &setlist, &showlist);
14104 init_all_packet_configs ();
14106 add_packet_config_cmd (&remote_protocol_packets[PACKET_X],
14107 "X", "binary-download", 1);
14109 add_packet_config_cmd (&remote_protocol_packets[PACKET_vCont],
14110 "vCont", "verbose-resume", 0);
14112 add_packet_config_cmd (&remote_protocol_packets[PACKET_QPassSignals],
14113 "QPassSignals", "pass-signals", 0);
14115 add_packet_config_cmd (&remote_protocol_packets[PACKET_QCatchSyscalls],
14116 "QCatchSyscalls", "catch-syscalls", 0);
14118 add_packet_config_cmd (&remote_protocol_packets[PACKET_QProgramSignals],
14119 "QProgramSignals", "program-signals", 0);
14121 add_packet_config_cmd (&remote_protocol_packets[PACKET_QSetWorkingDir],
14122 "QSetWorkingDir", "set-working-dir", 0);
14124 add_packet_config_cmd (&remote_protocol_packets[PACKET_QStartupWithShell],
14125 "QStartupWithShell", "startup-with-shell", 0);
14127 add_packet_config_cmd (&remote_protocol_packets
14128 [PACKET_QEnvironmentHexEncoded],
14129 "QEnvironmentHexEncoded", "environment-hex-encoded",
14132 add_packet_config_cmd (&remote_protocol_packets[PACKET_QEnvironmentReset],
14133 "QEnvironmentReset", "environment-reset",
14136 add_packet_config_cmd (&remote_protocol_packets[PACKET_QEnvironmentUnset],
14137 "QEnvironmentUnset", "environment-unset",
14140 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSymbol],
14141 "qSymbol", "symbol-lookup", 0);
14143 add_packet_config_cmd (&remote_protocol_packets[PACKET_P],
14144 "P", "set-register", 1);
14146 add_packet_config_cmd (&remote_protocol_packets[PACKET_p],
14147 "p", "fetch-register", 1);
14149 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z0],
14150 "Z0", "software-breakpoint", 0);
14152 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z1],
14153 "Z1", "hardware-breakpoint", 0);
14155 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z2],
14156 "Z2", "write-watchpoint", 0);
14158 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z3],
14159 "Z3", "read-watchpoint", 0);
14161 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z4],
14162 "Z4", "access-watchpoint", 0);
14164 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_auxv],
14165 "qXfer:auxv:read", "read-aux-vector", 0);
14167 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_exec_file],
14168 "qXfer:exec-file:read", "pid-to-exec-file", 0);
14170 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_features],
14171 "qXfer:features:read", "target-features", 0);
14173 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries],
14174 "qXfer:libraries:read", "library-info", 0);
14176 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries_svr4],
14177 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
14179 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_memory_map],
14180 "qXfer:memory-map:read", "memory-map", 0);
14182 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_read],
14183 "qXfer:spu:read", "read-spu-object", 0);
14185 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_write],
14186 "qXfer:spu:write", "write-spu-object", 0);
14188 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_osdata],
14189 "qXfer:osdata:read", "osdata", 0);
14191 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_threads],
14192 "qXfer:threads:read", "threads", 0);
14194 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_read],
14195 "qXfer:siginfo:read", "read-siginfo-object", 0);
14197 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_write],
14198 "qXfer:siginfo:write", "write-siginfo-object", 0);
14200 add_packet_config_cmd
14201 (&remote_protocol_packets[PACKET_qXfer_traceframe_info],
14202 "qXfer:traceframe-info:read", "traceframe-info", 0);
14204 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_uib],
14205 "qXfer:uib:read", "unwind-info-block", 0);
14207 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTLSAddr],
14208 "qGetTLSAddr", "get-thread-local-storage-address",
14211 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTIBAddr],
14212 "qGetTIBAddr", "get-thread-information-block-address",
14215 add_packet_config_cmd (&remote_protocol_packets[PACKET_bc],
14216 "bc", "reverse-continue", 0);
14218 add_packet_config_cmd (&remote_protocol_packets[PACKET_bs],
14219 "bs", "reverse-step", 0);
14221 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSupported],
14222 "qSupported", "supported-packets", 0);
14224 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSearch_memory],
14225 "qSearch:memory", "search-memory", 0);
14227 add_packet_config_cmd (&remote_protocol_packets[PACKET_qTStatus],
14228 "qTStatus", "trace-status", 0);
14230 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_setfs],
14231 "vFile:setfs", "hostio-setfs", 0);
14233 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_open],
14234 "vFile:open", "hostio-open", 0);
14236 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pread],
14237 "vFile:pread", "hostio-pread", 0);
14239 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pwrite],
14240 "vFile:pwrite", "hostio-pwrite", 0);
14242 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_close],
14243 "vFile:close", "hostio-close", 0);
14245 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_unlink],
14246 "vFile:unlink", "hostio-unlink", 0);
14248 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_readlink],
14249 "vFile:readlink", "hostio-readlink", 0);
14251 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_fstat],
14252 "vFile:fstat", "hostio-fstat", 0);
14254 add_packet_config_cmd (&remote_protocol_packets[PACKET_vAttach],
14255 "vAttach", "attach", 0);
14257 add_packet_config_cmd (&remote_protocol_packets[PACKET_vRun],
14260 add_packet_config_cmd (&remote_protocol_packets[PACKET_QStartNoAckMode],
14261 "QStartNoAckMode", "noack", 0);
14263 add_packet_config_cmd (&remote_protocol_packets[PACKET_vKill],
14264 "vKill", "kill", 0);
14266 add_packet_config_cmd (&remote_protocol_packets[PACKET_qAttached],
14267 "qAttached", "query-attached", 0);
14269 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalTracepoints],
14270 "ConditionalTracepoints",
14271 "conditional-tracepoints", 0);
14273 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalBreakpoints],
14274 "ConditionalBreakpoints",
14275 "conditional-breakpoints", 0);
14277 add_packet_config_cmd (&remote_protocol_packets[PACKET_BreakpointCommands],
14278 "BreakpointCommands",
14279 "breakpoint-commands", 0);
14281 add_packet_config_cmd (&remote_protocol_packets[PACKET_FastTracepoints],
14282 "FastTracepoints", "fast-tracepoints", 0);
14284 add_packet_config_cmd (&remote_protocol_packets[PACKET_TracepointSource],
14285 "TracepointSource", "TracepointSource", 0);
14287 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAllow],
14288 "QAllow", "allow", 0);
14290 add_packet_config_cmd (&remote_protocol_packets[PACKET_StaticTracepoints],
14291 "StaticTracepoints", "static-tracepoints", 0);
14293 add_packet_config_cmd (&remote_protocol_packets[PACKET_InstallInTrace],
14294 "InstallInTrace", "install-in-trace", 0);
14296 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_statictrace_read],
14297 "qXfer:statictrace:read", "read-sdata-object", 0);
14299 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_fdpic],
14300 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
14302 add_packet_config_cmd (&remote_protocol_packets[PACKET_QDisableRandomization],
14303 "QDisableRandomization", "disable-randomization", 0);
14305 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAgent],
14306 "QAgent", "agent", 0);
14308 add_packet_config_cmd (&remote_protocol_packets[PACKET_QTBuffer_size],
14309 "QTBuffer:size", "trace-buffer-size", 0);
14311 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_off],
14312 "Qbtrace:off", "disable-btrace", 0);
14314 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_bts],
14315 "Qbtrace:bts", "enable-btrace-bts", 0);
14317 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_pt],
14318 "Qbtrace:pt", "enable-btrace-pt", 0);
14320 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace],
14321 "qXfer:btrace", "read-btrace", 0);
14323 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace_conf],
14324 "qXfer:btrace-conf", "read-btrace-conf", 0);
14326 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_conf_bts_size],
14327 "Qbtrace-conf:bts:size", "btrace-conf-bts-size", 0);
14329 add_packet_config_cmd (&remote_protocol_packets[PACKET_multiprocess_feature],
14330 "multiprocess-feature", "multiprocess-feature", 0);
14332 add_packet_config_cmd (&remote_protocol_packets[PACKET_swbreak_feature],
14333 "swbreak-feature", "swbreak-feature", 0);
14335 add_packet_config_cmd (&remote_protocol_packets[PACKET_hwbreak_feature],
14336 "hwbreak-feature", "hwbreak-feature", 0);
14338 add_packet_config_cmd (&remote_protocol_packets[PACKET_fork_event_feature],
14339 "fork-event-feature", "fork-event-feature", 0);
14341 add_packet_config_cmd (&remote_protocol_packets[PACKET_vfork_event_feature],
14342 "vfork-event-feature", "vfork-event-feature", 0);
14344 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_conf_pt_size],
14345 "Qbtrace-conf:pt:size", "btrace-conf-pt-size", 0);
14347 add_packet_config_cmd (&remote_protocol_packets[PACKET_vContSupported],
14348 "vContSupported", "verbose-resume-supported", 0);
14350 add_packet_config_cmd (&remote_protocol_packets[PACKET_exec_event_feature],
14351 "exec-event-feature", "exec-event-feature", 0);
14353 add_packet_config_cmd (&remote_protocol_packets[PACKET_vCtrlC],
14354 "vCtrlC", "ctrl-c", 0);
14356 add_packet_config_cmd (&remote_protocol_packets[PACKET_QThreadEvents],
14357 "QThreadEvents", "thread-events", 0);
14359 add_packet_config_cmd (&remote_protocol_packets[PACKET_no_resumed],
14360 "N stop reply", "no-resumed-stop-reply", 0);
14362 /* Assert that we've registered "set remote foo-packet" commands
14363 for all packet configs. */
14367 for (i = 0; i < PACKET_MAX; i++)
14369 /* Ideally all configs would have a command associated. Some
14370 still don't though. */
14375 case PACKET_QNonStop:
14376 case PACKET_EnableDisableTracepoints_feature:
14377 case PACKET_tracenz_feature:
14378 case PACKET_DisconnectedTracing_feature:
14379 case PACKET_augmented_libraries_svr4_read_feature:
14381 /* Additions to this list need to be well justified:
14382 pre-existing packets are OK; new packets are not. */
14390 /* This catches both forgetting to add a config command, and
14391 forgetting to remove a packet from the exception list. */
14392 gdb_assert (excepted == (remote_protocol_packets[i].name == NULL));
14396 /* Keep the old ``set remote Z-packet ...'' working. Each individual
14397 Z sub-packet has its own set and show commands, but users may
14398 have sets to this variable in their .gdbinit files (or in their
14400 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure,
14401 &remote_Z_packet_detect, _("\
14402 Set use of remote protocol `Z' packets"), _("\
14403 Show use of remote protocol `Z' packets "), _("\
14404 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
14406 set_remote_protocol_Z_packet_cmd,
14407 show_remote_protocol_Z_packet_cmd,
14408 /* FIXME: i18n: Use of remote protocol
14409 `Z' packets is %s. */
14410 &remote_set_cmdlist, &remote_show_cmdlist);
14412 add_prefix_cmd ("remote", class_files, remote_command, _("\
14413 Manipulate files on the remote system\n\
14414 Transfer files to and from the remote target system."),
14415 &remote_cmdlist, "remote ",
14416 0 /* allow-unknown */, &cmdlist);
14418 add_cmd ("put", class_files, remote_put_command,
14419 _("Copy a local file to the remote system."),
14422 add_cmd ("get", class_files, remote_get_command,
14423 _("Copy a remote file to the local system."),
14426 add_cmd ("delete", class_files, remote_delete_command,
14427 _("Delete a remote file."),
14430 add_setshow_string_noescape_cmd ("exec-file", class_files,
14431 &remote_exec_file_var, _("\
14432 Set the remote pathname for \"run\""), _("\
14433 Show the remote pathname for \"run\""), NULL,
14434 set_remote_exec_file,
14435 show_remote_exec_file,
14436 &remote_set_cmdlist,
14437 &remote_show_cmdlist);
14439 add_setshow_boolean_cmd ("range-stepping", class_run,
14440 &use_range_stepping, _("\
14441 Enable or disable range stepping."), _("\
14442 Show whether target-assisted range stepping is enabled."), _("\
14443 If on, and the target supports it, when stepping a source line, GDB\n\
14444 tells the target to step the corresponding range of addresses itself instead\n\
14445 of issuing multiple single-steps. This speeds up source level\n\
14446 stepping. If off, GDB always issues single-steps, even if range\n\
14447 stepping is supported by the target. The default is on."),
14448 set_range_stepping,
14449 show_range_stepping,
14453 /* Eventually initialize fileio. See fileio.c */
14454 initialize_remote_fileio (remote_set_cmdlist, remote_show_cmdlist);
14456 /* Take advantage of the fact that the TID field is not used, to tag
14457 special ptids with it set to != 0. */
14458 magic_null_ptid = ptid_build (42000, -1, 1);
14459 not_sent_ptid = ptid_build (42000, -2, 1);
14460 any_thread_ptid = ptid_build (42000, 0, 1);