1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2014 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 "event-loop.h"
51 #include "event-top.h"
57 #include "gdbcore.h" /* for exec_bfd */
59 #include "remote-fileio.h"
60 #include "gdb/fileio.h"
62 #include "xml-support.h"
64 #include "memory-map.h"
66 #include "tracepoint.h"
72 /* Temp hacks for tracepoint encoding migration. */
73 static char *target_buf;
74 static long target_buf_size;
76 /* The size to align memory write packets, when practical. The protocol
77 does not guarantee any alignment, and gdb will generate short
78 writes and unaligned writes, but even as a best-effort attempt this
79 can improve bulk transfers. For instance, if a write is misaligned
80 relative to the target's data bus, the stub may need to make an extra
81 round trip fetching data from the target. This doesn't make a
82 huge difference, but it's easy to do, so we try to be helpful.
84 The alignment chosen is arbitrary; usually data bus width is
85 important here, not the possibly larger cache line size. */
86 enum { REMOTE_ALIGN_WRITES = 16 };
88 /* Prototypes for local functions. */
89 static void async_cleanup_sigint_signal_handler (void *dummy);
90 static int getpkt_sane (char **buf, long *sizeof_buf, int forever);
91 static int getpkt_or_notif_sane (char **buf, long *sizeof_buf,
92 int forever, int *is_notif);
94 static void async_handle_remote_sigint (int);
95 static void async_handle_remote_sigint_twice (int);
97 static void remote_files_info (struct target_ops *ignore);
99 static void remote_prepare_to_store (struct target_ops *self,
100 struct regcache *regcache);
102 static void remote_open_1 (const char *, int, struct target_ops *,
105 static void remote_close (struct target_ops *self);
107 static void remote_mourn (struct target_ops *ops);
109 static void extended_remote_restart (void);
111 static void extended_remote_mourn (struct target_ops *);
113 static void remote_mourn_1 (struct target_ops *);
115 static void remote_send (char **buf, long *sizeof_buf_p);
117 static int readchar (int timeout);
119 static void remote_serial_write (const char *str, int len);
121 static void remote_kill (struct target_ops *ops);
123 static int remote_can_async_p (struct target_ops *);
125 static int remote_is_async_p (struct target_ops *);
127 static void remote_async (struct target_ops *ops,
128 void (*callback) (enum inferior_event_type event_type,
132 static void sync_remote_interrupt_twice (int signo);
134 static void interrupt_query (void);
136 static void set_general_thread (struct ptid ptid);
137 static void set_continue_thread (struct ptid ptid);
139 static void get_offsets (void);
141 static void skip_frame (void);
143 static long read_frame (char **buf_p, long *sizeof_buf);
145 static int hexnumlen (ULONGEST num);
147 static void init_remote_ops (void);
149 static void init_extended_remote_ops (void);
151 static void remote_stop (struct target_ops *self, ptid_t);
153 static int stubhex (int ch);
155 static int hexnumstr (char *, ULONGEST);
157 static int hexnumnstr (char *, ULONGEST, int);
159 static CORE_ADDR remote_address_masked (CORE_ADDR);
161 static void print_packet (const char *);
163 static void compare_sections_command (char *, int);
165 static void packet_command (char *, int);
167 static int stub_unpack_int (char *buff, int fieldlength);
169 static ptid_t remote_current_thread (ptid_t oldptid);
171 static int putpkt_binary (const char *buf, int cnt);
173 static void check_binary_download (CORE_ADDR addr);
175 struct packet_config;
177 static void show_packet_config_cmd (struct packet_config *config);
179 static void show_remote_protocol_packet_cmd (struct ui_file *file,
181 struct cmd_list_element *c,
184 static char *write_ptid (char *buf, const char *endbuf, ptid_t ptid);
185 static ptid_t read_ptid (char *buf, char **obuf);
187 static void remote_set_permissions (struct target_ops *self);
190 static int remote_get_trace_status (struct target_ops *self,
191 struct trace_status *ts);
193 static int remote_upload_tracepoints (struct target_ops *self,
194 struct uploaded_tp **utpp);
196 static int remote_upload_trace_state_variables (struct target_ops *self,
197 struct uploaded_tsv **utsvp);
199 static void remote_query_supported (void);
201 static void remote_check_symbols (void);
203 void _initialize_remote (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 static void remote_async_inferior_event_handler (gdb_client_data);
214 static void remote_terminal_ours (struct target_ops *self);
216 static int remote_read_description_p (struct target_ops *target);
218 static void remote_console_output (char *msg);
220 static int remote_supports_cond_breakpoints (struct target_ops *self);
222 static int remote_can_run_breakpoint_commands (struct target_ops *self);
226 static struct cmd_list_element *remote_cmdlist;
228 /* For "set remote" and "show remote". */
230 static struct cmd_list_element *remote_set_cmdlist;
231 static struct cmd_list_element *remote_show_cmdlist;
233 /* Stub vCont actions support.
235 Each field is a boolean flag indicating whether the stub reports
236 support for the corresponding action. */
238 struct vCont_action_support
247 /* Controls whether GDB is willing to use range stepping. */
249 static int use_range_stepping = 1;
251 #define OPAQUETHREADBYTES 8
253 /* a 64 bit opaque identifier */
254 typedef unsigned char threadref[OPAQUETHREADBYTES];
256 /* About this many threadisds fit in a packet. */
258 #define MAXTHREADLISTRESULTS 32
260 /* Description of the remote protocol state for the currently
261 connected target. This is per-target state, and independent of the
262 selected architecture. */
266 /* A buffer to use for incoming packets, and its current size. The
267 buffer is grown dynamically for larger incoming packets.
268 Outgoing packets may also be constructed in this buffer.
269 BUF_SIZE is always at least REMOTE_PACKET_SIZE;
270 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
275 /* True if we're going through initial connection setup (finding out
276 about the remote side's threads, relocating symbols, etc.). */
279 /* If we negotiated packet size explicitly (and thus can bypass
280 heuristics for the largest packet size that will not overflow
281 a buffer in the stub), this will be set to that packet size.
282 Otherwise zero, meaning to use the guessed size. */
283 long explicit_packet_size;
285 /* remote_wait is normally called when the target is running and
286 waits for a stop reply packet. But sometimes we need to call it
287 when the target is already stopped. We can send a "?" packet
288 and have remote_wait read the response. Or, if we already have
289 the response, we can stash it in BUF and tell remote_wait to
290 skip calling getpkt. This flag is set when BUF contains a
291 stop reply packet and the target is not waiting. */
292 int cached_wait_status;
294 /* True, if in no ack mode. That is, neither GDB nor the stub will
295 expect acks from each other. The connection is assumed to be
299 /* True if we're connected in extended remote mode. */
302 /* True if we resumed the target and we're waiting for the target to
303 stop. In the mean time, we can't start another command/query.
304 The remote server wouldn't be ready to process it, so we'd
305 timeout waiting for a reply that would never come and eventually
306 we'd close the connection. This can happen in asynchronous mode
307 because we allow GDB commands while the target is running. */
308 int waiting_for_stop_reply;
310 /* The status of the stub support for the various vCont actions. */
311 struct vCont_action_support supports_vCont;
313 /* Nonzero if the user has pressed Ctrl-C, but the target hasn't
314 responded to that. */
317 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
318 remote_open knows that we don't have a file open when the program
320 struct serial *remote_desc;
322 /* These are the threads which we last sent to the remote system. The
323 TID member will be -1 for all or -2 for not sent yet. */
324 ptid_t general_thread;
325 ptid_t continue_thread;
327 /* This is the traceframe which we last selected on the remote system.
328 It will be -1 if no traceframe is selected. */
329 int remote_traceframe_number;
331 char *last_pass_packet;
333 /* The last QProgramSignals packet sent to the target. We bypass
334 sending a new program signals list down to the target if the new
335 packet is exactly the same as the last we sent. IOW, we only let
336 the target know about program signals list changes. */
337 char *last_program_signals_packet;
339 enum gdb_signal last_sent_signal;
343 char *finished_object;
344 char *finished_annex;
345 ULONGEST finished_offset;
347 /* Should we try the 'ThreadInfo' query packet?
349 This variable (NOT available to the user: auto-detect only!)
350 determines whether GDB will use the new, simpler "ThreadInfo"
351 query or the older, more complex syntax for thread queries.
352 This is an auto-detect variable (set to true at each connect,
353 and set to false when the target fails to recognize it). */
354 int use_threadinfo_query;
355 int use_threadextra_query;
357 void (*async_client_callback) (enum inferior_event_type event_type,
359 void *async_client_context;
361 /* This is set to the data address of the access causing the target
362 to stop for a watchpoint. */
363 CORE_ADDR remote_watch_data_address;
365 /* This is non-zero if target stopped for a watchpoint. */
366 int remote_stopped_by_watchpoint_p;
368 threadref echo_nextthread;
369 threadref nextthread;
370 threadref resultthreadlist[MAXTHREADLISTRESULTS];
372 /* The state of remote notification. */
373 struct remote_notif_state *notif_state;
376 /* Private data that we'll store in (struct thread_info)->private. */
377 struct private_thread_info
384 free_private_thread_info (struct private_thread_info *info)
390 /* This data could be associated with a target, but we do not always
391 have access to the current target when we need it, so for now it is
392 static. This will be fine for as long as only one target is in use
394 static struct remote_state *remote_state;
396 static struct remote_state *
397 get_remote_state_raw (void)
402 /* Allocate a new struct remote_state with xmalloc, initialize it, and
405 static struct remote_state *
406 new_remote_state (void)
408 struct remote_state *result = XCNEW (struct remote_state);
410 /* The default buffer size is unimportant; it will be expanded
411 whenever a larger buffer is needed. */
412 result->buf_size = 400;
413 result->buf = xmalloc (result->buf_size);
414 result->remote_traceframe_number = -1;
415 result->last_sent_signal = GDB_SIGNAL_0;
420 /* Description of the remote protocol for a given architecture. */
424 long offset; /* Offset into G packet. */
425 long regnum; /* GDB's internal register number. */
426 LONGEST pnum; /* Remote protocol register number. */
427 int in_g_packet; /* Always part of G packet. */
428 /* long size in bytes; == register_size (target_gdbarch (), regnum);
430 /* char *name; == gdbarch_register_name (target_gdbarch (), regnum);
434 struct remote_arch_state
436 /* Description of the remote protocol registers. */
437 long sizeof_g_packet;
439 /* Description of the remote protocol registers indexed by REGNUM
440 (making an array gdbarch_num_regs in size). */
441 struct packet_reg *regs;
443 /* This is the size (in chars) of the first response to the ``g''
444 packet. It is used as a heuristic when determining the maximum
445 size of memory-read and memory-write packets. A target will
446 typically only reserve a buffer large enough to hold the ``g''
447 packet. The size does not include packet overhead (headers and
449 long actual_register_packet_size;
451 /* This is the maximum size (in chars) of a non read/write packet.
452 It is also used as a cap on the size of read/write packets. */
453 long remote_packet_size;
456 /* Utility: generate error from an incoming stub packet. */
458 trace_error (char *buf)
461 return; /* not an error msg */
464 case '1': /* malformed packet error */
465 if (*++buf == '0') /* general case: */
466 error (_("remote.c: error in outgoing packet."));
468 error (_("remote.c: error in outgoing packet at field #%ld."),
469 strtol (buf, NULL, 16));
471 error (_("Target returns error code '%s'."), buf);
475 /* Utility: wait for reply from stub, while accepting "O" packets. */
477 remote_get_noisy_reply (char **buf_p,
480 do /* Loop on reply from remote stub. */
484 QUIT; /* Allow user to bail out with ^C. */
485 getpkt (buf_p, sizeof_buf, 0);
489 else if (strncmp (buf, "qRelocInsn:", strlen ("qRelocInsn:")) == 0)
492 CORE_ADDR from, to, org_to;
494 int adjusted_size = 0;
495 volatile struct gdb_exception ex;
497 p = buf + strlen ("qRelocInsn:");
498 pp = unpack_varlen_hex (p, &ul);
500 error (_("invalid qRelocInsn packet: %s"), buf);
504 unpack_varlen_hex (p, &ul);
509 TRY_CATCH (ex, RETURN_MASK_ALL)
511 gdbarch_relocate_instruction (target_gdbarch (), &to, from);
515 adjusted_size = to - org_to;
517 xsnprintf (buf, *sizeof_buf, "qRelocInsn:%x", adjusted_size);
520 else if (ex.reason < 0 && ex.error == MEMORY_ERROR)
522 /* Propagate memory errors silently back to the target.
523 The stub may have limited the range of addresses we
524 can write to, for example. */
529 /* Something unexpectedly bad happened. Be verbose so
530 we can tell what, and propagate the error back to the
531 stub, so it doesn't get stuck waiting for a
533 exception_fprintf (gdb_stderr, ex,
534 _("warning: relocating instruction: "));
538 else if (buf[0] == 'O' && buf[1] != 'K')
539 remote_console_output (buf + 1); /* 'O' message from stub */
541 return buf; /* Here's the actual reply. */
546 /* Handle for retreving the remote protocol data from gdbarch. */
547 static struct gdbarch_data *remote_gdbarch_data_handle;
549 static struct remote_arch_state *
550 get_remote_arch_state (void)
552 return gdbarch_data (target_gdbarch (), remote_gdbarch_data_handle);
555 /* Fetch the global remote target state. */
557 static struct remote_state *
558 get_remote_state (void)
560 /* Make sure that the remote architecture state has been
561 initialized, because doing so might reallocate rs->buf. Any
562 function which calls getpkt also needs to be mindful of changes
563 to rs->buf, but this call limits the number of places which run
565 get_remote_arch_state ();
567 return get_remote_state_raw ();
571 compare_pnums (const void *lhs_, const void *rhs_)
573 const struct packet_reg * const *lhs = lhs_;
574 const struct packet_reg * const *rhs = rhs_;
576 if ((*lhs)->pnum < (*rhs)->pnum)
578 else if ((*lhs)->pnum == (*rhs)->pnum)
585 map_regcache_remote_table (struct gdbarch *gdbarch, struct packet_reg *regs)
587 int regnum, num_remote_regs, offset;
588 struct packet_reg **remote_regs;
590 for (regnum = 0; regnum < gdbarch_num_regs (gdbarch); regnum++)
592 struct packet_reg *r = ®s[regnum];
594 if (register_size (gdbarch, regnum) == 0)
595 /* Do not try to fetch zero-sized (placeholder) registers. */
598 r->pnum = gdbarch_remote_register_number (gdbarch, regnum);
603 /* Define the g/G packet format as the contents of each register
604 with a remote protocol number, in order of ascending protocol
607 remote_regs = alloca (gdbarch_num_regs (gdbarch)
608 * sizeof (struct packet_reg *));
609 for (num_remote_regs = 0, regnum = 0;
610 regnum < gdbarch_num_regs (gdbarch);
612 if (regs[regnum].pnum != -1)
613 remote_regs[num_remote_regs++] = ®s[regnum];
615 qsort (remote_regs, num_remote_regs, sizeof (struct packet_reg *),
618 for (regnum = 0, offset = 0; regnum < num_remote_regs; regnum++)
620 remote_regs[regnum]->in_g_packet = 1;
621 remote_regs[regnum]->offset = offset;
622 offset += register_size (gdbarch, remote_regs[regnum]->regnum);
628 /* Given the architecture described by GDBARCH, return the remote
629 protocol register's number and the register's offset in the g/G
630 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
631 If the target does not have a mapping for REGNUM, return false,
632 otherwise, return true. */
635 remote_register_number_and_offset (struct gdbarch *gdbarch, int regnum,
636 int *pnum, int *poffset)
639 struct packet_reg *regs;
640 struct cleanup *old_chain;
642 gdb_assert (regnum < gdbarch_num_regs (gdbarch));
644 regs = xcalloc (gdbarch_num_regs (gdbarch), sizeof (struct packet_reg));
645 old_chain = make_cleanup (xfree, regs);
647 sizeof_g_packet = map_regcache_remote_table (gdbarch, regs);
649 *pnum = regs[regnum].pnum;
650 *poffset = regs[regnum].offset;
652 do_cleanups (old_chain);
658 init_remote_state (struct gdbarch *gdbarch)
660 struct remote_state *rs = get_remote_state_raw ();
661 struct remote_arch_state *rsa;
663 rsa = GDBARCH_OBSTACK_ZALLOC (gdbarch, struct remote_arch_state);
665 /* Use the architecture to build a regnum<->pnum table, which will be
666 1:1 unless a feature set specifies otherwise. */
667 rsa->regs = GDBARCH_OBSTACK_CALLOC (gdbarch,
668 gdbarch_num_regs (gdbarch),
671 /* Record the maximum possible size of the g packet - it may turn out
673 rsa->sizeof_g_packet = map_regcache_remote_table (gdbarch, rsa->regs);
675 /* Default maximum number of characters in a packet body. Many
676 remote stubs have a hardwired buffer size of 400 bytes
677 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
678 as the maximum packet-size to ensure that the packet and an extra
679 NUL character can always fit in the buffer. This stops GDB
680 trashing stubs that try to squeeze an extra NUL into what is
681 already a full buffer (As of 1999-12-04 that was most stubs). */
682 rsa->remote_packet_size = 400 - 1;
684 /* This one is filled in when a ``g'' packet is received. */
685 rsa->actual_register_packet_size = 0;
687 /* Should rsa->sizeof_g_packet needs more space than the
688 default, adjust the size accordingly. Remember that each byte is
689 encoded as two characters. 32 is the overhead for the packet
690 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
691 (``$NN:G...#NN'') is a better guess, the below has been padded a
693 if (rsa->sizeof_g_packet > ((rsa->remote_packet_size - 32) / 2))
694 rsa->remote_packet_size = (rsa->sizeof_g_packet * 2 + 32);
696 /* Make sure that the packet buffer is plenty big enough for
697 this architecture. */
698 if (rs->buf_size < rsa->remote_packet_size)
700 rs->buf_size = 2 * rsa->remote_packet_size;
701 rs->buf = xrealloc (rs->buf, rs->buf_size);
707 /* Return the current allowed size of a remote packet. This is
708 inferred from the current architecture, and should be used to
709 limit the length of outgoing packets. */
711 get_remote_packet_size (void)
713 struct remote_state *rs = get_remote_state ();
714 struct remote_arch_state *rsa = get_remote_arch_state ();
716 if (rs->explicit_packet_size)
717 return rs->explicit_packet_size;
719 return rsa->remote_packet_size;
722 static struct packet_reg *
723 packet_reg_from_regnum (struct remote_arch_state *rsa, long regnum)
725 if (regnum < 0 && regnum >= gdbarch_num_regs (target_gdbarch ()))
729 struct packet_reg *r = &rsa->regs[regnum];
731 gdb_assert (r->regnum == regnum);
736 static struct packet_reg *
737 packet_reg_from_pnum (struct remote_arch_state *rsa, LONGEST pnum)
741 for (i = 0; i < gdbarch_num_regs (target_gdbarch ()); i++)
743 struct packet_reg *r = &rsa->regs[i];
751 static struct target_ops remote_ops;
753 static struct target_ops extended_remote_ops;
755 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
756 ``forever'' still use the normal timeout mechanism. This is
757 currently used by the ASYNC code to guarentee that target reads
758 during the initial connect always time-out. Once getpkt has been
759 modified to return a timeout indication and, in turn
760 remote_wait()/wait_for_inferior() have gained a timeout parameter
762 static int wait_forever_enabled_p = 1;
764 /* Allow the user to specify what sequence to send to the remote
765 when he requests a program interruption: Although ^C is usually
766 what remote systems expect (this is the default, here), it is
767 sometimes preferable to send a break. On other systems such
768 as the Linux kernel, a break followed by g, which is Magic SysRq g
769 is required in order to interrupt the execution. */
770 const char interrupt_sequence_control_c[] = "Ctrl-C";
771 const char interrupt_sequence_break[] = "BREAK";
772 const char interrupt_sequence_break_g[] = "BREAK-g";
773 static const char *const interrupt_sequence_modes[] =
775 interrupt_sequence_control_c,
776 interrupt_sequence_break,
777 interrupt_sequence_break_g,
780 static const char *interrupt_sequence_mode = interrupt_sequence_control_c;
783 show_interrupt_sequence (struct ui_file *file, int from_tty,
784 struct cmd_list_element *c,
787 if (interrupt_sequence_mode == interrupt_sequence_control_c)
788 fprintf_filtered (file,
789 _("Send the ASCII ETX character (Ctrl-c) "
790 "to the remote target to interrupt the "
791 "execution of the program.\n"));
792 else if (interrupt_sequence_mode == interrupt_sequence_break)
793 fprintf_filtered (file,
794 _("send a break signal to the remote target "
795 "to interrupt the execution of the program.\n"));
796 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
797 fprintf_filtered (file,
798 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
799 "the remote target to interrupt the execution "
800 "of Linux kernel.\n"));
802 internal_error (__FILE__, __LINE__,
803 _("Invalid value for interrupt_sequence_mode: %s."),
804 interrupt_sequence_mode);
807 /* This boolean variable specifies whether interrupt_sequence is sent
808 to the remote target when gdb connects to it.
809 This is mostly needed when you debug the Linux kernel: The Linux kernel
810 expects BREAK g which is Magic SysRq g for connecting gdb. */
811 static int interrupt_on_connect = 0;
813 /* This variable is used to implement the "set/show remotebreak" commands.
814 Since these commands are now deprecated in favor of "set/show remote
815 interrupt-sequence", it no longer has any effect on the code. */
816 static int remote_break;
819 set_remotebreak (char *args, int from_tty, struct cmd_list_element *c)
822 interrupt_sequence_mode = interrupt_sequence_break;
824 interrupt_sequence_mode = interrupt_sequence_control_c;
828 show_remotebreak (struct ui_file *file, int from_tty,
829 struct cmd_list_element *c,
834 /* This variable sets the number of bits in an address that are to be
835 sent in a memory ("M" or "m") packet. Normally, after stripping
836 leading zeros, the entire address would be sent. This variable
837 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
838 initial implementation of remote.c restricted the address sent in
839 memory packets to ``host::sizeof long'' bytes - (typically 32
840 bits). Consequently, for 64 bit targets, the upper 32 bits of an
841 address was never sent. Since fixing this bug may cause a break in
842 some remote targets this variable is principly provided to
843 facilitate backward compatibility. */
845 static unsigned int remote_address_size;
847 /* Temporary to track who currently owns the terminal. See
848 remote_terminal_* for more details. */
850 static int remote_async_terminal_ours_p;
852 /* The executable file to use for "run" on the remote side. */
854 static char *remote_exec_file = "";
857 /* User configurable variables for the number of characters in a
858 memory read/write packet. MIN (rsa->remote_packet_size,
859 rsa->sizeof_g_packet) is the default. Some targets need smaller
860 values (fifo overruns, et.al.) and some users need larger values
861 (speed up transfers). The variables ``preferred_*'' (the user
862 request), ``current_*'' (what was actually set) and ``forced_*''
863 (Positive - a soft limit, negative - a hard limit). */
865 struct memory_packet_config
872 /* Compute the current size of a read/write packet. Since this makes
873 use of ``actual_register_packet_size'' the computation is dynamic. */
876 get_memory_packet_size (struct memory_packet_config *config)
878 struct remote_state *rs = get_remote_state ();
879 struct remote_arch_state *rsa = get_remote_arch_state ();
881 /* NOTE: The somewhat arbitrary 16k comes from the knowledge (folk
882 law?) that some hosts don't cope very well with large alloca()
883 calls. Eventually the alloca() code will be replaced by calls to
884 xmalloc() and make_cleanups() allowing this restriction to either
885 be lifted or removed. */
886 #ifndef MAX_REMOTE_PACKET_SIZE
887 #define MAX_REMOTE_PACKET_SIZE 16384
889 /* NOTE: 20 ensures we can write at least one byte. */
890 #ifndef MIN_REMOTE_PACKET_SIZE
891 #define MIN_REMOTE_PACKET_SIZE 20
896 if (config->size <= 0)
897 what_they_get = MAX_REMOTE_PACKET_SIZE;
899 what_they_get = config->size;
903 what_they_get = get_remote_packet_size ();
904 /* Limit the packet to the size specified by the user. */
906 && what_they_get > config->size)
907 what_they_get = config->size;
909 /* Limit it to the size of the targets ``g'' response unless we have
910 permission from the stub to use a larger packet size. */
911 if (rs->explicit_packet_size == 0
912 && rsa->actual_register_packet_size > 0
913 && what_they_get > rsa->actual_register_packet_size)
914 what_they_get = rsa->actual_register_packet_size;
916 if (what_they_get > MAX_REMOTE_PACKET_SIZE)
917 what_they_get = MAX_REMOTE_PACKET_SIZE;
918 if (what_they_get < MIN_REMOTE_PACKET_SIZE)
919 what_they_get = MIN_REMOTE_PACKET_SIZE;
921 /* Make sure there is room in the global buffer for this packet
922 (including its trailing NUL byte). */
923 if (rs->buf_size < what_they_get + 1)
925 rs->buf_size = 2 * what_they_get;
926 rs->buf = xrealloc (rs->buf, 2 * what_they_get);
929 return what_they_get;
932 /* Update the size of a read/write packet. If they user wants
933 something really big then do a sanity check. */
936 set_memory_packet_size (char *args, struct memory_packet_config *config)
938 int fixed_p = config->fixed_p;
939 long size = config->size;
942 error (_("Argument required (integer, `fixed' or `limited')."));
943 else if (strcmp (args, "hard") == 0
944 || strcmp (args, "fixed") == 0)
946 else if (strcmp (args, "soft") == 0
947 || strcmp (args, "limit") == 0)
953 size = strtoul (args, &end, 0);
955 error (_("Invalid %s (bad syntax)."), config->name);
957 /* Instead of explicitly capping the size of a packet to
958 MAX_REMOTE_PACKET_SIZE or dissallowing it, the user is
959 instead allowed to set the size to something arbitrarily
961 if (size > MAX_REMOTE_PACKET_SIZE)
962 error (_("Invalid %s (too large)."), config->name);
966 if (fixed_p && !config->fixed_p)
968 if (! query (_("The target may not be able to correctly handle a %s\n"
969 "of %ld bytes. Change the packet size? "),
971 error (_("Packet size not changed."));
973 /* Update the config. */
974 config->fixed_p = fixed_p;
979 show_memory_packet_size (struct memory_packet_config *config)
981 printf_filtered (_("The %s is %ld. "), config->name, config->size);
983 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
984 get_memory_packet_size (config));
986 printf_filtered (_("Packets are limited to %ld bytes.\n"),
987 get_memory_packet_size (config));
990 static struct memory_packet_config memory_write_packet_config =
992 "memory-write-packet-size",
996 set_memory_write_packet_size (char *args, int from_tty)
998 set_memory_packet_size (args, &memory_write_packet_config);
1002 show_memory_write_packet_size (char *args, int from_tty)
1004 show_memory_packet_size (&memory_write_packet_config);
1008 get_memory_write_packet_size (void)
1010 return get_memory_packet_size (&memory_write_packet_config);
1013 static struct memory_packet_config memory_read_packet_config =
1015 "memory-read-packet-size",
1019 set_memory_read_packet_size (char *args, int from_tty)
1021 set_memory_packet_size (args, &memory_read_packet_config);
1025 show_memory_read_packet_size (char *args, int from_tty)
1027 show_memory_packet_size (&memory_read_packet_config);
1031 get_memory_read_packet_size (void)
1033 long size = get_memory_packet_size (&memory_read_packet_config);
1035 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1036 extra buffer size argument before the memory read size can be
1037 increased beyond this. */
1038 if (size > get_remote_packet_size ())
1039 size = get_remote_packet_size ();
1044 /* Generic configuration support for packets the stub optionally
1045 supports. Allows the user to specify the use of the packet as well
1046 as allowing GDB to auto-detect support in the remote stub. */
1050 PACKET_SUPPORT_UNKNOWN = 0,
1055 struct packet_config
1060 /* If auto, GDB auto-detects support for this packet or feature,
1061 either through qSupported, or by trying the packet and looking
1062 at the response. If true, GDB assumes the target supports this
1063 packet. If false, the packet is disabled. Configs that don't
1064 have an associated command always have this set to auto. */
1065 enum auto_boolean detect;
1067 /* Does the target support this packet? */
1068 enum packet_support support;
1071 /* Analyze a packet's return value and update the packet config
1081 static enum packet_support packet_config_support (struct packet_config *config);
1082 static enum packet_support packet_support (int packet);
1085 show_packet_config_cmd (struct packet_config *config)
1087 char *support = "internal-error";
1089 switch (packet_config_support (config))
1092 support = "enabled";
1094 case PACKET_DISABLE:
1095 support = "disabled";
1097 case PACKET_SUPPORT_UNKNOWN:
1098 support = "unknown";
1101 switch (config->detect)
1103 case AUTO_BOOLEAN_AUTO:
1104 printf_filtered (_("Support for the `%s' packet "
1105 "is auto-detected, currently %s.\n"),
1106 config->name, support);
1108 case AUTO_BOOLEAN_TRUE:
1109 case AUTO_BOOLEAN_FALSE:
1110 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1111 config->name, support);
1117 add_packet_config_cmd (struct packet_config *config, const char *name,
1118 const char *title, int legacy)
1124 config->name = name;
1125 config->title = title;
1126 set_doc = xstrprintf ("Set use of remote protocol `%s' (%s) packet",
1128 show_doc = xstrprintf ("Show current use of remote "
1129 "protocol `%s' (%s) packet",
1131 /* set/show TITLE-packet {auto,on,off} */
1132 cmd_name = xstrprintf ("%s-packet", title);
1133 add_setshow_auto_boolean_cmd (cmd_name, class_obscure,
1134 &config->detect, set_doc,
1135 show_doc, NULL, /* help_doc */
1137 show_remote_protocol_packet_cmd,
1138 &remote_set_cmdlist, &remote_show_cmdlist);
1139 /* The command code copies the documentation strings. */
1142 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1147 legacy_name = xstrprintf ("%s-packet", name);
1148 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1149 &remote_set_cmdlist);
1150 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1151 &remote_show_cmdlist);
1155 static enum packet_result
1156 packet_check_result (const char *buf)
1160 /* The stub recognized the packet request. Check that the
1161 operation succeeded. */
1163 && isxdigit (buf[1]) && isxdigit (buf[2])
1165 /* "Enn" - definitly an error. */
1166 return PACKET_ERROR;
1168 /* Always treat "E." as an error. This will be used for
1169 more verbose error messages, such as E.memtypes. */
1170 if (buf[0] == 'E' && buf[1] == '.')
1171 return PACKET_ERROR;
1173 /* The packet may or may not be OK. Just assume it is. */
1177 /* The stub does not support the packet. */
1178 return PACKET_UNKNOWN;
1181 static enum packet_result
1182 packet_ok (const char *buf, struct packet_config *config)
1184 enum packet_result result;
1186 if (config->detect != AUTO_BOOLEAN_TRUE
1187 && config->support == PACKET_DISABLE)
1188 internal_error (__FILE__, __LINE__,
1189 _("packet_ok: attempt to use a disabled packet"));
1191 result = packet_check_result (buf);
1196 /* The stub recognized the packet request. */
1197 if (config->support == PACKET_SUPPORT_UNKNOWN)
1200 fprintf_unfiltered (gdb_stdlog,
1201 "Packet %s (%s) is supported\n",
1202 config->name, config->title);
1203 config->support = PACKET_ENABLE;
1206 case PACKET_UNKNOWN:
1207 /* The stub does not support the packet. */
1208 if (config->detect == AUTO_BOOLEAN_AUTO
1209 && config->support == PACKET_ENABLE)
1211 /* If the stub previously indicated that the packet was
1212 supported then there is a protocol error. */
1213 error (_("Protocol error: %s (%s) conflicting enabled responses."),
1214 config->name, config->title);
1216 else if (config->detect == AUTO_BOOLEAN_TRUE)
1218 /* The user set it wrong. */
1219 error (_("Enabled packet %s (%s) not recognized by stub"),
1220 config->name, config->title);
1224 fprintf_unfiltered (gdb_stdlog,
1225 "Packet %s (%s) is NOT supported\n",
1226 config->name, config->title);
1227 config->support = PACKET_DISABLE;
1247 PACKET_vFile_pwrite,
1249 PACKET_vFile_unlink,
1250 PACKET_vFile_readlink,
1252 PACKET_qXfer_features,
1253 PACKET_qXfer_libraries,
1254 PACKET_qXfer_libraries_svr4,
1255 PACKET_qXfer_memory_map,
1256 PACKET_qXfer_spu_read,
1257 PACKET_qXfer_spu_write,
1258 PACKET_qXfer_osdata,
1259 PACKET_qXfer_threads,
1260 PACKET_qXfer_statictrace_read,
1261 PACKET_qXfer_traceframe_info,
1267 PACKET_QPassSignals,
1268 PACKET_QProgramSignals,
1270 PACKET_qSearch_memory,
1273 PACKET_QStartNoAckMode,
1275 PACKET_qXfer_siginfo_read,
1276 PACKET_qXfer_siginfo_write,
1279 /* Support for conditional tracepoints. */
1280 PACKET_ConditionalTracepoints,
1282 /* Support for target-side breakpoint conditions. */
1283 PACKET_ConditionalBreakpoints,
1285 /* Support for target-side breakpoint commands. */
1286 PACKET_BreakpointCommands,
1288 /* Support for fast tracepoints. */
1289 PACKET_FastTracepoints,
1291 /* Support for static tracepoints. */
1292 PACKET_StaticTracepoints,
1294 /* Support for installing tracepoints while a trace experiment is
1296 PACKET_InstallInTrace,
1300 PACKET_TracepointSource,
1303 PACKET_QDisableRandomization,
1305 PACKET_QTBuffer_size,
1308 PACKET_qXfer_btrace,
1310 /* Support for the QNonStop packet. */
1313 /* Support for multi-process extensions. */
1314 PACKET_multiprocess_feature,
1316 /* Support for enabling and disabling tracepoints while a trace
1317 experiment is running. */
1318 PACKET_EnableDisableTracepoints_feature,
1320 /* Support for collecting strings using the tracenz bytecode. */
1321 PACKET_tracenz_feature,
1323 /* Support for continuing to run a trace experiment while GDB is
1325 PACKET_DisconnectedTracing_feature,
1327 /* Support for qXfer:libraries-svr4:read with a non-empty annex. */
1328 PACKET_augmented_libraries_svr4_read_feature,
1333 static struct packet_config remote_protocol_packets[PACKET_MAX];
1335 /* Returns whether a given packet or feature is supported. This takes
1336 into account the state of the corresponding "set remote foo-packet"
1337 command, which may be used to bypass auto-detection. */
1339 static enum packet_support
1340 packet_config_support (struct packet_config *config)
1342 switch (config->detect)
1344 case AUTO_BOOLEAN_TRUE:
1345 return PACKET_ENABLE;
1346 case AUTO_BOOLEAN_FALSE:
1347 return PACKET_DISABLE;
1348 case AUTO_BOOLEAN_AUTO:
1349 return config->support;
1351 gdb_assert_not_reached (_("bad switch"));
1355 /* Same as packet_config_support, but takes the packet's enum value as
1358 static enum packet_support
1359 packet_support (int packet)
1361 struct packet_config *config = &remote_protocol_packets[packet];
1363 return packet_config_support (config);
1367 show_remote_protocol_packet_cmd (struct ui_file *file, int from_tty,
1368 struct cmd_list_element *c,
1371 struct packet_config *packet;
1373 for (packet = remote_protocol_packets;
1374 packet < &remote_protocol_packets[PACKET_MAX];
1377 if (&packet->detect == c->var)
1379 show_packet_config_cmd (packet);
1383 internal_error (__FILE__, __LINE__, _("Could not find config for %s"),
1387 /* Should we try one of the 'Z' requests? */
1391 Z_PACKET_SOFTWARE_BP,
1392 Z_PACKET_HARDWARE_BP,
1399 /* For compatibility with older distributions. Provide a ``set remote
1400 Z-packet ...'' command that updates all the Z packet types. */
1402 static enum auto_boolean remote_Z_packet_detect;
1405 set_remote_protocol_Z_packet_cmd (char *args, int from_tty,
1406 struct cmd_list_element *c)
1410 for (i = 0; i < NR_Z_PACKET_TYPES; i++)
1411 remote_protocol_packets[PACKET_Z0 + i].detect = remote_Z_packet_detect;
1415 show_remote_protocol_Z_packet_cmd (struct ui_file *file, int from_tty,
1416 struct cmd_list_element *c,
1421 for (i = 0; i < NR_Z_PACKET_TYPES; i++)
1423 show_packet_config_cmd (&remote_protocol_packets[PACKET_Z0 + i]);
1427 /* Returns true if the multi-process extensions are in effect. */
1430 remote_multi_process_p (struct remote_state *rs)
1432 return packet_support (PACKET_multiprocess_feature) == PACKET_ENABLE;
1435 /* Tokens for use by the asynchronous signal handlers for SIGINT. */
1436 static struct async_signal_handler *async_sigint_remote_twice_token;
1437 static struct async_signal_handler *async_sigint_remote_token;
1440 /* Asynchronous signal handle registered as event loop source for
1441 when we have pending events ready to be passed to the core. */
1443 static struct async_event_handler *remote_async_inferior_event_token;
1447 static ptid_t magic_null_ptid;
1448 static ptid_t not_sent_ptid;
1449 static ptid_t any_thread_ptid;
1451 /* Find out if the stub attached to PID (and hence GDB should offer to
1452 detach instead of killing it when bailing out). */
1455 remote_query_attached (int pid)
1457 struct remote_state *rs = get_remote_state ();
1458 size_t size = get_remote_packet_size ();
1460 if (packet_support (PACKET_qAttached) == PACKET_DISABLE)
1463 if (remote_multi_process_p (rs))
1464 xsnprintf (rs->buf, size, "qAttached:%x", pid);
1466 xsnprintf (rs->buf, size, "qAttached");
1469 getpkt (&rs->buf, &rs->buf_size, 0);
1471 switch (packet_ok (rs->buf,
1472 &remote_protocol_packets[PACKET_qAttached]))
1475 if (strcmp (rs->buf, "1") == 0)
1479 warning (_("Remote failure reply: %s"), rs->buf);
1481 case PACKET_UNKNOWN:
1488 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
1489 has been invented by GDB, instead of reported by the target. Since
1490 we can be connected to a remote system before before knowing about
1491 any inferior, mark the target with execution when we find the first
1492 inferior. If ATTACHED is 1, then we had just attached to this
1493 inferior. If it is 0, then we just created this inferior. If it
1494 is -1, then try querying the remote stub to find out if it had
1495 attached to the inferior or not. */
1497 static struct inferior *
1498 remote_add_inferior (int fake_pid_p, int pid, int attached)
1500 struct inferior *inf;
1502 /* Check whether this process we're learning about is to be
1503 considered attached, or if is to be considered to have been
1504 spawned by the stub. */
1506 attached = remote_query_attached (pid);
1508 if (gdbarch_has_global_solist (target_gdbarch ()))
1510 /* If the target shares code across all inferiors, then every
1511 attach adds a new inferior. */
1512 inf = add_inferior (pid);
1514 /* ... and every inferior is bound to the same program space.
1515 However, each inferior may still have its own address
1517 inf->aspace = maybe_new_address_space ();
1518 inf->pspace = current_program_space;
1522 /* In the traditional debugging scenario, there's a 1-1 match
1523 between program/address spaces. We simply bind the inferior
1524 to the program space's address space. */
1525 inf = current_inferior ();
1526 inferior_appeared (inf, pid);
1529 inf->attach_flag = attached;
1530 inf->fake_pid_p = fake_pid_p;
1535 /* Add thread PTID to GDB's thread list. Tag it as executing/running
1536 according to RUNNING. */
1539 remote_add_thread (ptid_t ptid, int running)
1541 struct remote_state *rs = get_remote_state ();
1543 /* GDB historically didn't pull threads in the initial connection
1544 setup. If the remote target doesn't even have a concept of
1545 threads (e.g., a bare-metal target), even if internally we
1546 consider that a single-threaded target, mentioning a new thread
1547 might be confusing to the user. Be silent then, preserving the
1548 age old behavior. */
1549 if (rs->starting_up)
1550 add_thread_silent (ptid);
1554 set_executing (ptid, running);
1555 set_running (ptid, running);
1558 /* Come here when we learn about a thread id from the remote target.
1559 It may be the first time we hear about such thread, so take the
1560 opportunity to add it to GDB's thread list. In case this is the
1561 first time we're noticing its corresponding inferior, add it to
1562 GDB's inferior list as well. */
1565 remote_notice_new_inferior (ptid_t currthread, int running)
1567 /* If this is a new thread, add it to GDB's thread list.
1568 If we leave it up to WFI to do this, bad things will happen. */
1570 if (in_thread_list (currthread) && is_exited (currthread))
1572 /* We're seeing an event on a thread id we knew had exited.
1573 This has to be a new thread reusing the old id. Add it. */
1574 remote_add_thread (currthread, running);
1578 if (!in_thread_list (currthread))
1580 struct inferior *inf = NULL;
1581 int pid = ptid_get_pid (currthread);
1583 if (ptid_is_pid (inferior_ptid)
1584 && pid == ptid_get_pid (inferior_ptid))
1586 /* inferior_ptid has no thread member yet. This can happen
1587 with the vAttach -> remote_wait,"TAAthread:" path if the
1588 stub doesn't support qC. This is the first stop reported
1589 after an attach, so this is the main thread. Update the
1590 ptid in the thread list. */
1591 if (in_thread_list (pid_to_ptid (pid)))
1592 thread_change_ptid (inferior_ptid, currthread);
1595 remote_add_thread (currthread, running);
1596 inferior_ptid = currthread;
1601 if (ptid_equal (magic_null_ptid, inferior_ptid))
1603 /* inferior_ptid is not set yet. This can happen with the
1604 vRun -> remote_wait,"TAAthread:" path if the stub
1605 doesn't support qC. This is the first stop reported
1606 after an attach, so this is the main thread. Update the
1607 ptid in the thread list. */
1608 thread_change_ptid (inferior_ptid, currthread);
1612 /* When connecting to a target remote, or to a target
1613 extended-remote which already was debugging an inferior, we
1614 may not know about it yet. Add it before adding its child
1615 thread, so notifications are emitted in a sensible order. */
1616 if (!in_inferior_list (ptid_get_pid (currthread)))
1618 struct remote_state *rs = get_remote_state ();
1619 int fake_pid_p = !remote_multi_process_p (rs);
1621 inf = remote_add_inferior (fake_pid_p,
1622 ptid_get_pid (currthread), -1);
1625 /* This is really a new thread. Add it. */
1626 remote_add_thread (currthread, running);
1628 /* If we found a new inferior, let the common code do whatever
1629 it needs to with it (e.g., read shared libraries, insert
1630 breakpoints), unless we're just setting up an all-stop
1634 struct remote_state *rs = get_remote_state ();
1636 if (non_stop || !rs->starting_up)
1637 notice_new_inferior (currthread, running, 0);
1642 /* Return the private thread data, creating it if necessary. */
1644 static struct private_thread_info *
1645 demand_private_info (ptid_t ptid)
1647 struct thread_info *info = find_thread_ptid (ptid);
1653 info->private = xmalloc (sizeof (*(info->private)));
1654 info->private_dtor = free_private_thread_info;
1655 info->private->core = -1;
1656 info->private->extra = 0;
1659 return info->private;
1662 /* Call this function as a result of
1663 1) A halt indication (T packet) containing a thread id
1664 2) A direct query of currthread
1665 3) Successful execution of set thread */
1668 record_currthread (struct remote_state *rs, ptid_t currthread)
1670 rs->general_thread = currthread;
1673 /* If 'QPassSignals' is supported, tell the remote stub what signals
1674 it can simply pass through to the inferior without reporting. */
1677 remote_pass_signals (struct target_ops *self,
1678 int numsigs, unsigned char *pass_signals)
1680 if (packet_support (PACKET_QPassSignals) != PACKET_DISABLE)
1682 char *pass_packet, *p;
1684 struct remote_state *rs = get_remote_state ();
1686 gdb_assert (numsigs < 256);
1687 for (i = 0; i < numsigs; i++)
1689 if (pass_signals[i])
1692 pass_packet = xmalloc (count * 3 + strlen ("QPassSignals:") + 1);
1693 strcpy (pass_packet, "QPassSignals:");
1694 p = pass_packet + strlen (pass_packet);
1695 for (i = 0; i < numsigs; i++)
1697 if (pass_signals[i])
1700 *p++ = tohex (i >> 4);
1701 *p++ = tohex (i & 15);
1710 if (!rs->last_pass_packet || strcmp (rs->last_pass_packet, pass_packet))
1712 putpkt (pass_packet);
1713 getpkt (&rs->buf, &rs->buf_size, 0);
1714 packet_ok (rs->buf, &remote_protocol_packets[PACKET_QPassSignals]);
1715 if (rs->last_pass_packet)
1716 xfree (rs->last_pass_packet);
1717 rs->last_pass_packet = pass_packet;
1720 xfree (pass_packet);
1724 /* If 'QProgramSignals' is supported, tell the remote stub what
1725 signals it should pass through to the inferior when detaching. */
1728 remote_program_signals (struct target_ops *self,
1729 int numsigs, unsigned char *signals)
1731 if (packet_support (PACKET_QProgramSignals) != PACKET_DISABLE)
1735 struct remote_state *rs = get_remote_state ();
1737 gdb_assert (numsigs < 256);
1738 for (i = 0; i < numsigs; i++)
1743 packet = xmalloc (count * 3 + strlen ("QProgramSignals:") + 1);
1744 strcpy (packet, "QProgramSignals:");
1745 p = packet + strlen (packet);
1746 for (i = 0; i < numsigs; i++)
1748 if (signal_pass_state (i))
1751 *p++ = tohex (i >> 4);
1752 *p++ = tohex (i & 15);
1761 if (!rs->last_program_signals_packet
1762 || strcmp (rs->last_program_signals_packet, packet) != 0)
1765 getpkt (&rs->buf, &rs->buf_size, 0);
1766 packet_ok (rs->buf, &remote_protocol_packets[PACKET_QProgramSignals]);
1767 xfree (rs->last_program_signals_packet);
1768 rs->last_program_signals_packet = packet;
1775 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
1776 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
1777 thread. If GEN is set, set the general thread, if not, then set
1778 the step/continue thread. */
1780 set_thread (struct ptid ptid, int gen)
1782 struct remote_state *rs = get_remote_state ();
1783 ptid_t state = gen ? rs->general_thread : rs->continue_thread;
1784 char *buf = rs->buf;
1785 char *endbuf = rs->buf + get_remote_packet_size ();
1787 if (ptid_equal (state, ptid))
1791 *buf++ = gen ? 'g' : 'c';
1792 if (ptid_equal (ptid, magic_null_ptid))
1793 xsnprintf (buf, endbuf - buf, "0");
1794 else if (ptid_equal (ptid, any_thread_ptid))
1795 xsnprintf (buf, endbuf - buf, "0");
1796 else if (ptid_equal (ptid, minus_one_ptid))
1797 xsnprintf (buf, endbuf - buf, "-1");
1799 write_ptid (buf, endbuf, ptid);
1801 getpkt (&rs->buf, &rs->buf_size, 0);
1803 rs->general_thread = ptid;
1805 rs->continue_thread = ptid;
1809 set_general_thread (struct ptid ptid)
1811 set_thread (ptid, 1);
1815 set_continue_thread (struct ptid ptid)
1817 set_thread (ptid, 0);
1820 /* Change the remote current process. Which thread within the process
1821 ends up selected isn't important, as long as it is the same process
1822 as what INFERIOR_PTID points to.
1824 This comes from that fact that there is no explicit notion of
1825 "selected process" in the protocol. The selected process for
1826 general operations is the process the selected general thread
1830 set_general_process (void)
1832 struct remote_state *rs = get_remote_state ();
1834 /* If the remote can't handle multiple processes, don't bother. */
1835 if (!rs->extended || !remote_multi_process_p (rs))
1838 /* We only need to change the remote current thread if it's pointing
1839 at some other process. */
1840 if (ptid_get_pid (rs->general_thread) != ptid_get_pid (inferior_ptid))
1841 set_general_thread (inferior_ptid);
1845 /* Return nonzero if the thread PTID is still alive on the remote
1849 remote_thread_alive (struct target_ops *ops, ptid_t ptid)
1851 struct remote_state *rs = get_remote_state ();
1854 if (ptid_equal (ptid, magic_null_ptid))
1855 /* The main thread is always alive. */
1858 if (ptid_get_pid (ptid) != 0 && ptid_get_lwp (ptid) == 0)
1859 /* The main thread is always alive. This can happen after a
1860 vAttach, if the remote side doesn't support
1865 endp = rs->buf + get_remote_packet_size ();
1868 write_ptid (p, endp, ptid);
1871 getpkt (&rs->buf, &rs->buf_size, 0);
1872 return (rs->buf[0] == 'O' && rs->buf[1] == 'K');
1875 /* About these extended threadlist and threadinfo packets. They are
1876 variable length packets but, the fields within them are often fixed
1877 length. They are redundent enough to send over UDP as is the
1878 remote protocol in general. There is a matching unit test module
1881 /* WARNING: This threadref data structure comes from the remote O.S.,
1882 libstub protocol encoding, and remote.c. It is not particularly
1885 /* Right now, the internal structure is int. We want it to be bigger.
1886 Plan to fix this. */
1888 typedef int gdb_threadref; /* Internal GDB thread reference. */
1890 /* gdb_ext_thread_info is an internal GDB data structure which is
1891 equivalent to the reply of the remote threadinfo packet. */
1893 struct gdb_ext_thread_info
1895 threadref threadid; /* External form of thread reference. */
1896 int active; /* Has state interesting to GDB?
1898 char display[256]; /* Brief state display, name,
1899 blocked/suspended. */
1900 char shortname[32]; /* To be used to name threads. */
1901 char more_display[256]; /* Long info, statistics, queue depth,
1905 /* The volume of remote transfers can be limited by submitting
1906 a mask containing bits specifying the desired information.
1907 Use a union of these values as the 'selection' parameter to
1908 get_thread_info. FIXME: Make these TAG names more thread specific. */
1910 #define TAG_THREADID 1
1911 #define TAG_EXISTS 2
1912 #define TAG_DISPLAY 4
1913 #define TAG_THREADNAME 8
1914 #define TAG_MOREDISPLAY 16
1916 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
1918 static char *unpack_nibble (char *buf, int *val);
1920 static char *unpack_byte (char *buf, int *value);
1922 static char *pack_int (char *buf, int value);
1924 static char *unpack_int (char *buf, int *value);
1926 static char *unpack_string (char *src, char *dest, int length);
1928 static char *pack_threadid (char *pkt, threadref *id);
1930 static char *unpack_threadid (char *inbuf, threadref *id);
1932 void int_to_threadref (threadref *id, int value);
1934 static int threadref_to_int (threadref *ref);
1936 static void copy_threadref (threadref *dest, threadref *src);
1938 static int threadmatch (threadref *dest, threadref *src);
1940 static char *pack_threadinfo_request (char *pkt, int mode,
1943 static int remote_unpack_thread_info_response (char *pkt,
1944 threadref *expectedref,
1945 struct gdb_ext_thread_info
1949 static int remote_get_threadinfo (threadref *threadid,
1950 int fieldset, /*TAG mask */
1951 struct gdb_ext_thread_info *info);
1953 static char *pack_threadlist_request (char *pkt, int startflag,
1955 threadref *nextthread);
1957 static int parse_threadlist_response (char *pkt,
1959 threadref *original_echo,
1960 threadref *resultlist,
1963 static int remote_get_threadlist (int startflag,
1964 threadref *nextthread,
1968 threadref *threadlist);
1970 typedef int (*rmt_thread_action) (threadref *ref, void *context);
1972 static int remote_threadlist_iterator (rmt_thread_action stepfunction,
1973 void *context, int looplimit);
1975 static int remote_newthread_step (threadref *ref, void *context);
1978 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
1979 buffer we're allowed to write to. Returns
1980 BUF+CHARACTERS_WRITTEN. */
1983 write_ptid (char *buf, const char *endbuf, ptid_t ptid)
1986 struct remote_state *rs = get_remote_state ();
1988 if (remote_multi_process_p (rs))
1990 pid = ptid_get_pid (ptid);
1992 buf += xsnprintf (buf, endbuf - buf, "p-%x.", -pid);
1994 buf += xsnprintf (buf, endbuf - buf, "p%x.", pid);
1996 tid = ptid_get_lwp (ptid);
1998 buf += xsnprintf (buf, endbuf - buf, "-%x", -tid);
2000 buf += xsnprintf (buf, endbuf - buf, "%x", tid);
2005 /* Extract a PTID from BUF. If non-null, OBUF is set to the to one
2006 passed the last parsed char. Returns null_ptid on error. */
2009 read_ptid (char *buf, char **obuf)
2013 ULONGEST pid = 0, tid = 0;
2017 /* Multi-process ptid. */
2018 pp = unpack_varlen_hex (p + 1, &pid);
2020 error (_("invalid remote ptid: %s"), p);
2023 pp = unpack_varlen_hex (p + 1, &tid);
2026 return ptid_build (pid, tid, 0);
2029 /* No multi-process. Just a tid. */
2030 pp = unpack_varlen_hex (p, &tid);
2032 /* Since the stub is not sending a process id, then default to
2033 what's in inferior_ptid, unless it's null at this point. If so,
2034 then since there's no way to know the pid of the reported
2035 threads, use the magic number. */
2036 if (ptid_equal (inferior_ptid, null_ptid))
2037 pid = ptid_get_pid (magic_null_ptid);
2039 pid = ptid_get_pid (inferior_ptid);
2043 return ptid_build (pid, tid, 0);
2049 if (ch >= 'a' && ch <= 'f')
2050 return ch - 'a' + 10;
2051 if (ch >= '0' && ch <= '9')
2053 if (ch >= 'A' && ch <= 'F')
2054 return ch - 'A' + 10;
2059 stub_unpack_int (char *buff, int fieldlength)
2066 nibble = stubhex (*buff++);
2070 retval = retval << 4;
2076 unpack_nibble (char *buf, int *val)
2078 *val = fromhex (*buf++);
2083 unpack_byte (char *buf, int *value)
2085 *value = stub_unpack_int (buf, 2);
2090 pack_int (char *buf, int value)
2092 buf = pack_hex_byte (buf, (value >> 24) & 0xff);
2093 buf = pack_hex_byte (buf, (value >> 16) & 0xff);
2094 buf = pack_hex_byte (buf, (value >> 8) & 0x0ff);
2095 buf = pack_hex_byte (buf, (value & 0xff));
2100 unpack_int (char *buf, int *value)
2102 *value = stub_unpack_int (buf, 8);
2106 #if 0 /* Currently unused, uncomment when needed. */
2107 static char *pack_string (char *pkt, char *string);
2110 pack_string (char *pkt, char *string)
2115 len = strlen (string);
2117 len = 200; /* Bigger than most GDB packets, junk??? */
2118 pkt = pack_hex_byte (pkt, len);
2122 if ((ch == '\0') || (ch == '#'))
2123 ch = '*'; /* Protect encapsulation. */
2128 #endif /* 0 (unused) */
2131 unpack_string (char *src, char *dest, int length)
2140 pack_threadid (char *pkt, threadref *id)
2143 unsigned char *altid;
2145 altid = (unsigned char *) id;
2146 limit = pkt + BUF_THREAD_ID_SIZE;
2148 pkt = pack_hex_byte (pkt, *altid++);
2154 unpack_threadid (char *inbuf, threadref *id)
2157 char *limit = inbuf + BUF_THREAD_ID_SIZE;
2160 altref = (char *) id;
2162 while (inbuf < limit)
2164 x = stubhex (*inbuf++);
2165 y = stubhex (*inbuf++);
2166 *altref++ = (x << 4) | y;
2171 /* Externally, threadrefs are 64 bits but internally, they are still
2172 ints. This is due to a mismatch of specifications. We would like
2173 to use 64bit thread references internally. This is an adapter
2177 int_to_threadref (threadref *id, int value)
2179 unsigned char *scan;
2181 scan = (unsigned char *) id;
2187 *scan++ = (value >> 24) & 0xff;
2188 *scan++ = (value >> 16) & 0xff;
2189 *scan++ = (value >> 8) & 0xff;
2190 *scan++ = (value & 0xff);
2194 threadref_to_int (threadref *ref)
2197 unsigned char *scan;
2203 value = (value << 8) | ((*scan++) & 0xff);
2208 copy_threadref (threadref *dest, threadref *src)
2211 unsigned char *csrc, *cdest;
2213 csrc = (unsigned char *) src;
2214 cdest = (unsigned char *) dest;
2221 threadmatch (threadref *dest, threadref *src)
2223 /* Things are broken right now, so just assume we got a match. */
2225 unsigned char *srcp, *destp;
2227 srcp = (char *) src;
2228 destp = (char *) dest;
2232 result &= (*srcp++ == *destp++) ? 1 : 0;
2239 threadid:1, # always request threadid
2246 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
2249 pack_threadinfo_request (char *pkt, int mode, threadref *id)
2251 *pkt++ = 'q'; /* Info Query */
2252 *pkt++ = 'P'; /* process or thread info */
2253 pkt = pack_int (pkt, mode); /* mode */
2254 pkt = pack_threadid (pkt, id); /* threadid */
2255 *pkt = '\0'; /* terminate */
2259 /* These values tag the fields in a thread info response packet. */
2260 /* Tagging the fields allows us to request specific fields and to
2261 add more fields as time goes by. */
2263 #define TAG_THREADID 1 /* Echo the thread identifier. */
2264 #define TAG_EXISTS 2 /* Is this process defined enough to
2265 fetch registers and its stack? */
2266 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
2267 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
2268 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
2272 remote_unpack_thread_info_response (char *pkt, threadref *expectedref,
2273 struct gdb_ext_thread_info *info)
2275 struct remote_state *rs = get_remote_state ();
2279 char *limit = pkt + rs->buf_size; /* Plausible parsing limit. */
2282 /* info->threadid = 0; FIXME: implement zero_threadref. */
2284 info->display[0] = '\0';
2285 info->shortname[0] = '\0';
2286 info->more_display[0] = '\0';
2288 /* Assume the characters indicating the packet type have been
2290 pkt = unpack_int (pkt, &mask); /* arg mask */
2291 pkt = unpack_threadid (pkt, &ref);
2294 warning (_("Incomplete response to threadinfo request."));
2295 if (!threadmatch (&ref, expectedref))
2296 { /* This is an answer to a different request. */
2297 warning (_("ERROR RMT Thread info mismatch."));
2300 copy_threadref (&info->threadid, &ref);
2302 /* Loop on tagged fields , try to bail if somthing goes wrong. */
2304 /* Packets are terminated with nulls. */
2305 while ((pkt < limit) && mask && *pkt)
2307 pkt = unpack_int (pkt, &tag); /* tag */
2308 pkt = unpack_byte (pkt, &length); /* length */
2309 if (!(tag & mask)) /* Tags out of synch with mask. */
2311 warning (_("ERROR RMT: threadinfo tag mismatch."));
2315 if (tag == TAG_THREADID)
2319 warning (_("ERROR RMT: length of threadid is not 16."));
2323 pkt = unpack_threadid (pkt, &ref);
2324 mask = mask & ~TAG_THREADID;
2327 if (tag == TAG_EXISTS)
2329 info->active = stub_unpack_int (pkt, length);
2331 mask = mask & ~(TAG_EXISTS);
2334 warning (_("ERROR RMT: 'exists' length too long."));
2340 if (tag == TAG_THREADNAME)
2342 pkt = unpack_string (pkt, &info->shortname[0], length);
2343 mask = mask & ~TAG_THREADNAME;
2346 if (tag == TAG_DISPLAY)
2348 pkt = unpack_string (pkt, &info->display[0], length);
2349 mask = mask & ~TAG_DISPLAY;
2352 if (tag == TAG_MOREDISPLAY)
2354 pkt = unpack_string (pkt, &info->more_display[0], length);
2355 mask = mask & ~TAG_MOREDISPLAY;
2358 warning (_("ERROR RMT: unknown thread info tag."));
2359 break; /* Not a tag we know about. */
2365 remote_get_threadinfo (threadref *threadid, int fieldset, /* TAG mask */
2366 struct gdb_ext_thread_info *info)
2368 struct remote_state *rs = get_remote_state ();
2371 pack_threadinfo_request (rs->buf, fieldset, threadid);
2373 getpkt (&rs->buf, &rs->buf_size, 0);
2375 if (rs->buf[0] == '\0')
2378 result = remote_unpack_thread_info_response (rs->buf + 2,
2383 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
2386 pack_threadlist_request (char *pkt, int startflag, int threadcount,
2387 threadref *nextthread)
2389 *pkt++ = 'q'; /* info query packet */
2390 *pkt++ = 'L'; /* Process LIST or threadLIST request */
2391 pkt = pack_nibble (pkt, startflag); /* initflag 1 bytes */
2392 pkt = pack_hex_byte (pkt, threadcount); /* threadcount 2 bytes */
2393 pkt = pack_threadid (pkt, nextthread); /* 64 bit thread identifier */
2398 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
2401 parse_threadlist_response (char *pkt, int result_limit,
2402 threadref *original_echo, threadref *resultlist,
2405 struct remote_state *rs = get_remote_state ();
2407 int count, resultcount, done;
2410 /* Assume the 'q' and 'M chars have been stripped. */
2411 limit = pkt + (rs->buf_size - BUF_THREAD_ID_SIZE);
2412 /* done parse past here */
2413 pkt = unpack_byte (pkt, &count); /* count field */
2414 pkt = unpack_nibble (pkt, &done);
2415 /* The first threadid is the argument threadid. */
2416 pkt = unpack_threadid (pkt, original_echo); /* should match query packet */
2417 while ((count-- > 0) && (pkt < limit))
2419 pkt = unpack_threadid (pkt, resultlist++);
2420 if (resultcount++ >= result_limit)
2428 /* Fetch the next batch of threads from the remote. Returns -1 if the
2429 qL packet is not supported, 0 on error and 1 on success. */
2432 remote_get_threadlist (int startflag, threadref *nextthread, int result_limit,
2433 int *done, int *result_count, threadref *threadlist)
2435 struct remote_state *rs = get_remote_state ();
2438 /* Trancate result limit to be smaller than the packet size. */
2439 if ((((result_limit + 1) * BUF_THREAD_ID_SIZE) + 10)
2440 >= get_remote_packet_size ())
2441 result_limit = (get_remote_packet_size () / BUF_THREAD_ID_SIZE) - 2;
2443 pack_threadlist_request (rs->buf, startflag, result_limit, nextthread);
2445 getpkt (&rs->buf, &rs->buf_size, 0);
2446 if (*rs->buf == '\0')
2448 /* Packet not supported. */
2453 parse_threadlist_response (rs->buf + 2, result_limit,
2454 &rs->echo_nextthread, threadlist, done);
2456 if (!threadmatch (&rs->echo_nextthread, nextthread))
2458 /* FIXME: This is a good reason to drop the packet. */
2459 /* Possably, there is a duplicate response. */
2461 retransmit immediatly - race conditions
2462 retransmit after timeout - yes
2464 wait for packet, then exit
2466 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
2467 return 0; /* I choose simply exiting. */
2469 if (*result_count <= 0)
2473 warning (_("RMT ERROR : failed to get remote thread list."));
2476 return result; /* break; */
2478 if (*result_count > result_limit)
2481 warning (_("RMT ERROR: threadlist response longer than requested."));
2487 /* Fetch the list of remote threads, with the qL packet, and call
2488 STEPFUNCTION for each thread found. Stops iterating and returns 1
2489 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
2490 STEPFUNCTION returns false. If the packet is not supported,
2494 remote_threadlist_iterator (rmt_thread_action stepfunction, void *context,
2497 struct remote_state *rs = get_remote_state ();
2498 int done, i, result_count;
2506 if (loopcount++ > looplimit)
2509 warning (_("Remote fetch threadlist -infinite loop-."));
2512 result = remote_get_threadlist (startflag, &rs->nextthread,
2513 MAXTHREADLISTRESULTS,
2514 &done, &result_count,
2515 rs->resultthreadlist);
2518 /* Clear for later iterations. */
2520 /* Setup to resume next batch of thread references, set nextthread. */
2521 if (result_count >= 1)
2522 copy_threadref (&rs->nextthread,
2523 &rs->resultthreadlist[result_count - 1]);
2525 while (result_count--)
2527 if (!(*stepfunction) (&rs->resultthreadlist[i++], context))
2537 /* A thread found on the remote target. */
2539 typedef struct thread_item
2541 /* The thread's PTID. */
2544 /* The thread's extra info. May be NULL. */
2547 /* The core the thread was running on. -1 if not known. */
2550 DEF_VEC_O(thread_item_t);
2552 /* Context passed around to the various methods listing remote
2553 threads. As new threads are found, they're added to the ITEMS
2556 struct threads_listing_context
2558 /* The threads found on the remote target. */
2559 VEC (thread_item_t) *items;
2562 /* Discard the contents of the constructed thread listing context. */
2565 clear_threads_listing_context (void *p)
2567 struct threads_listing_context *context = p;
2569 struct thread_item *item;
2571 for (i = 0; VEC_iterate (thread_item_t, context->items, i, item); ++i)
2572 xfree (item->extra);
2574 VEC_free (thread_item_t, context->items);
2578 remote_newthread_step (threadref *ref, void *data)
2580 struct threads_listing_context *context = data;
2581 struct thread_item item;
2582 int pid = ptid_get_pid (inferior_ptid);
2584 item.ptid = ptid_build (pid, threadref_to_int (ref), 0);
2588 VEC_safe_push (thread_item_t, context->items, &item);
2590 return 1; /* continue iterator */
2593 #define CRAZY_MAX_THREADS 1000
2596 remote_current_thread (ptid_t oldpid)
2598 struct remote_state *rs = get_remote_state ();
2601 getpkt (&rs->buf, &rs->buf_size, 0);
2602 if (rs->buf[0] == 'Q' && rs->buf[1] == 'C')
2603 return read_ptid (&rs->buf[2], NULL);
2608 /* List remote threads using the deprecated qL packet. */
2611 remote_get_threads_with_ql (struct target_ops *ops,
2612 struct threads_listing_context *context)
2614 if (remote_threadlist_iterator (remote_newthread_step, context,
2615 CRAZY_MAX_THREADS) >= 0)
2621 #if defined(HAVE_LIBEXPAT)
2624 start_thread (struct gdb_xml_parser *parser,
2625 const struct gdb_xml_element *element,
2626 void *user_data, VEC(gdb_xml_value_s) *attributes)
2628 struct threads_listing_context *data = user_data;
2630 struct thread_item item;
2632 struct gdb_xml_value *attr;
2634 id = xml_find_attribute (attributes, "id")->value;
2635 item.ptid = read_ptid (id, NULL);
2637 attr = xml_find_attribute (attributes, "core");
2639 item.core = *(ULONGEST *) attr->value;
2645 VEC_safe_push (thread_item_t, data->items, &item);
2649 end_thread (struct gdb_xml_parser *parser,
2650 const struct gdb_xml_element *element,
2651 void *user_data, const char *body_text)
2653 struct threads_listing_context *data = user_data;
2655 if (body_text && *body_text)
2656 VEC_last (thread_item_t, data->items)->extra = xstrdup (body_text);
2659 const struct gdb_xml_attribute thread_attributes[] = {
2660 { "id", GDB_XML_AF_NONE, NULL, NULL },
2661 { "core", GDB_XML_AF_OPTIONAL, gdb_xml_parse_attr_ulongest, NULL },
2662 { NULL, GDB_XML_AF_NONE, NULL, NULL }
2665 const struct gdb_xml_element thread_children[] = {
2666 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
2669 const struct gdb_xml_element threads_children[] = {
2670 { "thread", thread_attributes, thread_children,
2671 GDB_XML_EF_REPEATABLE | GDB_XML_EF_OPTIONAL,
2672 start_thread, end_thread },
2673 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
2676 const struct gdb_xml_element threads_elements[] = {
2677 { "threads", NULL, threads_children,
2678 GDB_XML_EF_NONE, NULL, NULL },
2679 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
2684 /* List remote threads using qXfer:threads:read. */
2687 remote_get_threads_with_qxfer (struct target_ops *ops,
2688 struct threads_listing_context *context)
2690 #if defined(HAVE_LIBEXPAT)
2691 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
2693 char *xml = target_read_stralloc (ops, TARGET_OBJECT_THREADS, NULL);
2694 struct cleanup *back_to = make_cleanup (xfree, xml);
2696 if (xml != NULL && *xml != '\0')
2698 gdb_xml_parse_quick (_("threads"), "threads.dtd",
2699 threads_elements, xml, context);
2702 do_cleanups (back_to);
2710 /* List remote threads using qfThreadInfo/qsThreadInfo. */
2713 remote_get_threads_with_qthreadinfo (struct target_ops *ops,
2714 struct threads_listing_context *context)
2716 struct remote_state *rs = get_remote_state ();
2718 if (rs->use_threadinfo_query)
2722 putpkt ("qfThreadInfo");
2723 getpkt (&rs->buf, &rs->buf_size, 0);
2725 if (bufp[0] != '\0') /* q packet recognized */
2727 while (*bufp++ == 'm') /* reply contains one or more TID */
2731 struct thread_item item;
2733 item.ptid = read_ptid (bufp, &bufp);
2737 VEC_safe_push (thread_item_t, context->items, &item);
2739 while (*bufp++ == ','); /* comma-separated list */
2740 putpkt ("qsThreadInfo");
2741 getpkt (&rs->buf, &rs->buf_size, 0);
2748 /* Packet not recognized. */
2749 rs->use_threadinfo_query = 0;
2756 /* Implement the to_update_thread_list function for the remote
2760 remote_update_thread_list (struct target_ops *ops)
2762 struct remote_state *rs = get_remote_state ();
2763 struct threads_listing_context context;
2764 struct cleanup *old_chain;
2767 context.items = NULL;
2768 old_chain = make_cleanup (clear_threads_listing_context, &context);
2770 /* We have a few different mechanisms to fetch the thread list. Try
2771 them all, starting with the most preferred one first, falling
2772 back to older methods. */
2773 if (remote_get_threads_with_qxfer (ops, &context)
2774 || remote_get_threads_with_qthreadinfo (ops, &context)
2775 || remote_get_threads_with_ql (ops, &context))
2778 struct thread_item *item;
2779 struct thread_info *tp, *tmp;
2783 /* CONTEXT now holds the current thread list on the remote
2784 target end. Delete GDB-side threads no longer found on the
2786 ALL_NON_EXITED_THREADS_SAFE (tp, tmp)
2789 VEC_iterate (thread_item_t, context.items, i, item);
2792 if (ptid_equal (item->ptid, tp->ptid))
2796 if (i == VEC_length (thread_item_t, context.items))
2799 delete_thread (tp->ptid);
2803 /* And now add threads we don't know about yet to our list. */
2805 VEC_iterate (thread_item_t, context.items, i, item);
2808 if (!ptid_equal (item->ptid, null_ptid))
2810 struct private_thread_info *info;
2811 /* In non-stop mode, we assume new found threads are
2812 running until proven otherwise with a stop reply. In
2813 all-stop, we can only get here if all threads are
2815 int running = non_stop ? 1 : 0;
2817 remote_notice_new_inferior (item->ptid, running);
2819 info = demand_private_info (item->ptid);
2820 info->core = item->core;
2821 info->extra = item->extra;
2829 /* If no thread listing method is supported, then query whether
2830 each known thread is alive, one by one, with the T packet.
2831 If the target doesn't support threads at all, then this is a
2832 no-op. See remote_thread_alive. */
2836 do_cleanups (old_chain);
2840 * Collect a descriptive string about the given thread.
2841 * The target may say anything it wants to about the thread
2842 * (typically info about its blocked / runnable state, name, etc.).
2843 * This string will appear in the info threads display.
2845 * Optional: targets are not required to implement this function.
2849 remote_threads_extra_info (struct target_ops *self, struct thread_info *tp)
2851 struct remote_state *rs = get_remote_state ();
2855 struct gdb_ext_thread_info threadinfo;
2856 static char display_buf[100]; /* arbitrary... */
2857 int n = 0; /* position in display_buf */
2859 if (rs->remote_desc == 0) /* paranoia */
2860 internal_error (__FILE__, __LINE__,
2861 _("remote_threads_extra_info"));
2863 if (ptid_equal (tp->ptid, magic_null_ptid)
2864 || (ptid_get_pid (tp->ptid) != 0 && ptid_get_lwp (tp->ptid) == 0))
2865 /* This is the main thread which was added by GDB. The remote
2866 server doesn't know about it. */
2869 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
2871 struct thread_info *info = find_thread_ptid (tp->ptid);
2873 if (info && info->private)
2874 return info->private->extra;
2879 if (rs->use_threadextra_query)
2882 char *endb = rs->buf + get_remote_packet_size ();
2884 xsnprintf (b, endb - b, "qThreadExtraInfo,");
2886 write_ptid (b, endb, tp->ptid);
2889 getpkt (&rs->buf, &rs->buf_size, 0);
2890 if (rs->buf[0] != 0)
2892 n = min (strlen (rs->buf) / 2, sizeof (display_buf));
2893 result = hex2bin (rs->buf, (gdb_byte *) display_buf, n);
2894 display_buf [result] = '\0';
2899 /* If the above query fails, fall back to the old method. */
2900 rs->use_threadextra_query = 0;
2901 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
2902 | TAG_MOREDISPLAY | TAG_DISPLAY;
2903 int_to_threadref (&id, ptid_get_lwp (tp->ptid));
2904 if (remote_get_threadinfo (&id, set, &threadinfo))
2905 if (threadinfo.active)
2907 if (*threadinfo.shortname)
2908 n += xsnprintf (&display_buf[0], sizeof (display_buf) - n,
2909 " Name: %s,", threadinfo.shortname);
2910 if (*threadinfo.display)
2911 n += xsnprintf (&display_buf[n], sizeof (display_buf) - n,
2912 " State: %s,", threadinfo.display);
2913 if (*threadinfo.more_display)
2914 n += xsnprintf (&display_buf[n], sizeof (display_buf) - n,
2915 " Priority: %s", threadinfo.more_display);
2919 /* For purely cosmetic reasons, clear up trailing commas. */
2920 if (',' == display_buf[n-1])
2921 display_buf[n-1] = ' ';
2930 remote_static_tracepoint_marker_at (struct target_ops *self, CORE_ADDR addr,
2931 struct static_tracepoint_marker *marker)
2933 struct remote_state *rs = get_remote_state ();
2936 xsnprintf (p, get_remote_packet_size (), "qTSTMat:");
2938 p += hexnumstr (p, addr);
2940 getpkt (&rs->buf, &rs->buf_size, 0);
2944 error (_("Remote failure reply: %s"), p);
2948 parse_static_tracepoint_marker_definition (p, &p, marker);
2955 static VEC(static_tracepoint_marker_p) *
2956 remote_static_tracepoint_markers_by_strid (struct target_ops *self,
2959 struct remote_state *rs = get_remote_state ();
2960 VEC(static_tracepoint_marker_p) *markers = NULL;
2961 struct static_tracepoint_marker *marker = NULL;
2962 struct cleanup *old_chain;
2965 /* Ask for a first packet of static tracepoint marker
2968 getpkt (&rs->buf, &rs->buf_size, 0);
2971 error (_("Remote failure reply: %s"), p);
2973 old_chain = make_cleanup (free_current_marker, &marker);
2978 marker = XCNEW (struct static_tracepoint_marker);
2982 parse_static_tracepoint_marker_definition (p, &p, marker);
2984 if (strid == NULL || strcmp (strid, marker->str_id) == 0)
2986 VEC_safe_push (static_tracepoint_marker_p,
2992 release_static_tracepoint_marker (marker);
2993 memset (marker, 0, sizeof (*marker));
2996 while (*p++ == ','); /* comma-separated list */
2997 /* Ask for another packet of static tracepoint definition. */
2999 getpkt (&rs->buf, &rs->buf_size, 0);
3003 do_cleanups (old_chain);
3008 /* Implement the to_get_ada_task_ptid function for the remote targets. */
3011 remote_get_ada_task_ptid (struct target_ops *self, long lwp, long thread)
3013 return ptid_build (ptid_get_pid (inferior_ptid), lwp, 0);
3017 /* Restart the remote side; this is an extended protocol operation. */
3020 extended_remote_restart (void)
3022 struct remote_state *rs = get_remote_state ();
3024 /* Send the restart command; for reasons I don't understand the
3025 remote side really expects a number after the "R". */
3026 xsnprintf (rs->buf, get_remote_packet_size (), "R%x", 0);
3029 remote_fileio_reset ();
3032 /* Clean up connection to a remote debugger. */
3035 remote_close (struct target_ops *self)
3037 struct remote_state *rs = get_remote_state ();
3039 if (rs->remote_desc == NULL)
3040 return; /* already closed */
3042 /* Make sure we leave stdin registered in the event loop, and we
3043 don't leave the async SIGINT signal handler installed. */
3044 remote_terminal_ours (self);
3046 serial_close (rs->remote_desc);
3047 rs->remote_desc = NULL;
3049 /* We don't have a connection to the remote stub anymore. Get rid
3050 of all the inferiors and their threads we were controlling.
3051 Reset inferior_ptid to null_ptid first, as otherwise has_stack_frame
3052 will be unable to find the thread corresponding to (pid, 0, 0). */
3053 inferior_ptid = null_ptid;
3054 discard_all_inferiors ();
3056 /* We are closing the remote target, so we should discard
3057 everything of this target. */
3058 discard_pending_stop_replies_in_queue (rs);
3060 if (remote_async_inferior_event_token)
3061 delete_async_event_handler (&remote_async_inferior_event_token);
3063 remote_notif_state_xfree (rs->notif_state);
3065 trace_reset_local_state ();
3068 /* Query the remote side for the text, data and bss offsets. */
3073 struct remote_state *rs = get_remote_state ();
3076 int lose, num_segments = 0, do_sections, do_segments;
3077 CORE_ADDR text_addr, data_addr, bss_addr, segments[2];
3078 struct section_offsets *offs;
3079 struct symfile_segment_data *data;
3081 if (symfile_objfile == NULL)
3084 putpkt ("qOffsets");
3085 getpkt (&rs->buf, &rs->buf_size, 0);
3088 if (buf[0] == '\000')
3089 return; /* Return silently. Stub doesn't support
3093 warning (_("Remote failure reply: %s"), buf);
3097 /* Pick up each field in turn. This used to be done with scanf, but
3098 scanf will make trouble if CORE_ADDR size doesn't match
3099 conversion directives correctly. The following code will work
3100 with any size of CORE_ADDR. */
3101 text_addr = data_addr = bss_addr = 0;
3105 if (strncmp (ptr, "Text=", 5) == 0)
3108 /* Don't use strtol, could lose on big values. */
3109 while (*ptr && *ptr != ';')
3110 text_addr = (text_addr << 4) + fromhex (*ptr++);
3112 if (strncmp (ptr, ";Data=", 6) == 0)
3115 while (*ptr && *ptr != ';')
3116 data_addr = (data_addr << 4) + fromhex (*ptr++);
3121 if (!lose && strncmp (ptr, ";Bss=", 5) == 0)
3124 while (*ptr && *ptr != ';')
3125 bss_addr = (bss_addr << 4) + fromhex (*ptr++);
3127 if (bss_addr != data_addr)
3128 warning (_("Target reported unsupported offsets: %s"), buf);
3133 else if (strncmp (ptr, "TextSeg=", 8) == 0)
3136 /* Don't use strtol, could lose on big values. */
3137 while (*ptr && *ptr != ';')
3138 text_addr = (text_addr << 4) + fromhex (*ptr++);
3141 if (strncmp (ptr, ";DataSeg=", 9) == 0)
3144 while (*ptr && *ptr != ';')
3145 data_addr = (data_addr << 4) + fromhex (*ptr++);
3153 error (_("Malformed response to offset query, %s"), buf);
3154 else if (*ptr != '\0')
3155 warning (_("Target reported unsupported offsets: %s"), buf);
3157 offs = ((struct section_offsets *)
3158 alloca (SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections)));
3159 memcpy (offs, symfile_objfile->section_offsets,
3160 SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections));
3162 data = get_symfile_segment_data (symfile_objfile->obfd);
3163 do_segments = (data != NULL);
3164 do_sections = num_segments == 0;
3166 if (num_segments > 0)
3168 segments[0] = text_addr;
3169 segments[1] = data_addr;
3171 /* If we have two segments, we can still try to relocate everything
3172 by assuming that the .text and .data offsets apply to the whole
3173 text and data segments. Convert the offsets given in the packet
3174 to base addresses for symfile_map_offsets_to_segments. */
3175 else if (data && data->num_segments == 2)
3177 segments[0] = data->segment_bases[0] + text_addr;
3178 segments[1] = data->segment_bases[1] + data_addr;
3181 /* If the object file has only one segment, assume that it is text
3182 rather than data; main programs with no writable data are rare,
3183 but programs with no code are useless. Of course the code might
3184 have ended up in the data segment... to detect that we would need
3185 the permissions here. */
3186 else if (data && data->num_segments == 1)
3188 segments[0] = data->segment_bases[0] + text_addr;
3191 /* There's no way to relocate by segment. */
3197 int ret = symfile_map_offsets_to_segments (symfile_objfile->obfd, data,
3198 offs, num_segments, segments);
3200 if (ret == 0 && !do_sections)
3201 error (_("Can not handle qOffsets TextSeg "
3202 "response with this symbol file"));
3209 free_symfile_segment_data (data);
3213 offs->offsets[SECT_OFF_TEXT (symfile_objfile)] = text_addr;
3215 /* This is a temporary kludge to force data and bss to use the
3216 same offsets because that's what nlmconv does now. The real
3217 solution requires changes to the stub and remote.c that I
3218 don't have time to do right now. */
3220 offs->offsets[SECT_OFF_DATA (symfile_objfile)] = data_addr;
3221 offs->offsets[SECT_OFF_BSS (symfile_objfile)] = data_addr;
3224 objfile_relocate (symfile_objfile, offs);
3227 /* Callback for iterate_over_threads. Set the STOP_REQUESTED flags in
3228 threads we know are stopped already. This is used during the
3229 initial remote connection in non-stop mode --- threads that are
3230 reported as already being stopped are left stopped. */
3233 set_stop_requested_callback (struct thread_info *thread, void *data)
3235 /* If we have a stop reply for this thread, it must be stopped. */
3236 if (peek_stop_reply (thread->ptid))
3237 set_stop_requested (thread->ptid, 1);
3242 /* Send interrupt_sequence to remote target. */
3244 send_interrupt_sequence (void)
3246 struct remote_state *rs = get_remote_state ();
3248 if (interrupt_sequence_mode == interrupt_sequence_control_c)
3249 remote_serial_write ("\x03", 1);
3250 else if (interrupt_sequence_mode == interrupt_sequence_break)
3251 serial_send_break (rs->remote_desc);
3252 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
3254 serial_send_break (rs->remote_desc);
3255 remote_serial_write ("g", 1);
3258 internal_error (__FILE__, __LINE__,
3259 _("Invalid value for interrupt_sequence_mode: %s."),
3260 interrupt_sequence_mode);
3264 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
3265 and extract the PTID. Returns NULL_PTID if not found. */
3268 stop_reply_extract_thread (char *stop_reply)
3270 if (stop_reply[0] == 'T' && strlen (stop_reply) > 3)
3274 /* Txx r:val ; r:val (...) */
3277 /* Look for "register" named "thread". */
3282 p1 = strchr (p, ':');
3286 if (strncmp (p, "thread", p1 - p) == 0)
3287 return read_ptid (++p1, &p);
3289 p1 = strchr (p, ';');
3301 /* Determine the remote side's current thread. If we have a stop
3302 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
3303 "thread" register we can extract the current thread from. If not,
3304 ask the remote which is the current thread with qC. The former
3305 method avoids a roundtrip. */
3308 get_current_thread (char *wait_status)
3312 /* Note we don't use remote_parse_stop_reply as that makes use of
3313 the target architecture, which we haven't yet fully determined at
3315 if (wait_status != NULL)
3316 ptid = stop_reply_extract_thread (wait_status);
3317 if (ptid_equal (ptid, null_ptid))
3318 ptid = remote_current_thread (inferior_ptid);
3323 /* Query the remote target for which is the current thread/process,
3324 add it to our tables, and update INFERIOR_PTID. The caller is
3325 responsible for setting the state such that the remote end is ready
3326 to return the current thread.
3328 This function is called after handling the '?' or 'vRun' packets,
3329 whose response is a stop reply from which we can also try
3330 extracting the thread. If the target doesn't support the explicit
3331 qC query, we infer the current thread from that stop reply, passed
3332 in in WAIT_STATUS, which may be NULL. */
3335 add_current_inferior_and_thread (char *wait_status)
3337 struct remote_state *rs = get_remote_state ();
3339 ptid_t ptid = null_ptid;
3341 inferior_ptid = null_ptid;
3343 /* Now, if we have thread information, update inferior_ptid. */
3344 ptid = get_current_thread (wait_status);
3346 if (!ptid_equal (ptid, null_ptid))
3348 if (!remote_multi_process_p (rs))
3351 inferior_ptid = ptid;
3355 /* Without this, some commands which require an active target
3356 (such as kill) won't work. This variable serves (at least)
3357 double duty as both the pid of the target process (if it has
3358 such), and as a flag indicating that a target is active. */
3359 inferior_ptid = magic_null_ptid;
3363 remote_add_inferior (fake_pid_p, ptid_get_pid (inferior_ptid), -1);
3365 /* Add the main thread. */
3366 add_thread_silent (inferior_ptid);
3370 remote_start_remote (int from_tty, struct target_ops *target, int extended_p)
3372 struct remote_state *rs = get_remote_state ();
3373 struct packet_config *noack_config;
3374 char *wait_status = NULL;
3376 immediate_quit++; /* Allow user to interrupt it. */
3379 if (interrupt_on_connect)
3380 send_interrupt_sequence ();
3382 /* Ack any packet which the remote side has already sent. */
3383 serial_write (rs->remote_desc, "+", 1);
3385 /* Signal other parts that we're going through the initial setup,
3386 and so things may not be stable yet. */
3387 rs->starting_up = 1;
3389 /* The first packet we send to the target is the optional "supported
3390 packets" request. If the target can answer this, it will tell us
3391 which later probes to skip. */
3392 remote_query_supported ();
3394 /* If the stub wants to get a QAllow, compose one and send it. */
3395 if (packet_support (PACKET_QAllow) != PACKET_DISABLE)
3396 remote_set_permissions (target);
3398 /* Next, we possibly activate noack mode.
3400 If the QStartNoAckMode packet configuration is set to AUTO,
3401 enable noack mode if the stub reported a wish for it with
3404 If set to TRUE, then enable noack mode even if the stub didn't
3405 report it in qSupported. If the stub doesn't reply OK, the
3406 session ends with an error.
3408 If FALSE, then don't activate noack mode, regardless of what the
3409 stub claimed should be the default with qSupported. */
3411 noack_config = &remote_protocol_packets[PACKET_QStartNoAckMode];
3412 if (packet_config_support (noack_config) != PACKET_DISABLE)
3414 putpkt ("QStartNoAckMode");
3415 getpkt (&rs->buf, &rs->buf_size, 0);
3416 if (packet_ok (rs->buf, noack_config) == PACKET_OK)
3422 /* Tell the remote that we are using the extended protocol. */
3424 getpkt (&rs->buf, &rs->buf_size, 0);
3427 /* Let the target know which signals it is allowed to pass down to
3429 update_signals_program_target ();
3431 /* Next, if the target can specify a description, read it. We do
3432 this before anything involving memory or registers. */
3433 target_find_description ();
3435 /* Next, now that we know something about the target, update the
3436 address spaces in the program spaces. */
3437 update_address_spaces ();
3439 /* On OSs where the list of libraries is global to all
3440 processes, we fetch them early. */
3441 if (gdbarch_has_global_solist (target_gdbarch ()))
3442 solib_add (NULL, from_tty, target, auto_solib_add);
3446 if (packet_support (PACKET_QNonStop) != PACKET_ENABLE)
3447 error (_("Non-stop mode requested, but remote "
3448 "does not support non-stop"));
3450 putpkt ("QNonStop:1");
3451 getpkt (&rs->buf, &rs->buf_size, 0);
3453 if (strcmp (rs->buf, "OK") != 0)
3454 error (_("Remote refused setting non-stop mode with: %s"), rs->buf);
3456 /* Find about threads and processes the stub is already
3457 controlling. We default to adding them in the running state.
3458 The '?' query below will then tell us about which threads are
3460 remote_update_thread_list (target);
3462 else if (packet_support (PACKET_QNonStop) == PACKET_ENABLE)
3464 /* Don't assume that the stub can operate in all-stop mode.
3465 Request it explicitly. */
3466 putpkt ("QNonStop:0");
3467 getpkt (&rs->buf, &rs->buf_size, 0);
3469 if (strcmp (rs->buf, "OK") != 0)
3470 error (_("Remote refused setting all-stop mode with: %s"), rs->buf);
3473 /* Upload TSVs regardless of whether the target is running or not. The
3474 remote stub, such as GDBserver, may have some predefined or builtin
3475 TSVs, even if the target is not running. */
3476 if (remote_get_trace_status (target, current_trace_status ()) != -1)
3478 struct uploaded_tsv *uploaded_tsvs = NULL;
3480 remote_upload_trace_state_variables (target, &uploaded_tsvs);
3481 merge_uploaded_trace_state_variables (&uploaded_tsvs);
3484 /* Check whether the target is running now. */
3486 getpkt (&rs->buf, &rs->buf_size, 0);
3492 struct inferior *inf;
3494 if (rs->buf[0] == 'W' || rs->buf[0] == 'X')
3497 error (_("The target is not running (try extended-remote?)"));
3499 /* We're connected, but not running. Drop out before we
3500 call start_remote. */
3501 rs->starting_up = 0;
3506 /* Save the reply for later. */
3507 wait_status = alloca (strlen (rs->buf) + 1);
3508 strcpy (wait_status, rs->buf);
3511 /* Fetch thread list. */
3512 target_update_thread_list ();
3514 /* Let the stub know that we want it to return the thread. */
3515 set_continue_thread (minus_one_ptid);
3517 if (thread_count () == 0)
3519 /* Target has no concept of threads at all. GDB treats
3520 non-threaded target as single-threaded; add a main
3522 add_current_inferior_and_thread (wait_status);
3526 /* We have thread information; select the thread the target
3527 says should be current. If we're reconnecting to a
3528 multi-threaded program, this will ideally be the thread
3529 that last reported an event before GDB disconnected. */
3530 inferior_ptid = get_current_thread (wait_status);
3531 if (ptid_equal (inferior_ptid, null_ptid))
3533 /* Odd... The target was able to list threads, but not
3534 tell us which thread was current (no "thread"
3535 register in T stop reply?). Just pick the first
3536 thread in the thread list then. */
3537 inferior_ptid = thread_list->ptid;
3541 /* init_wait_for_inferior should be called before get_offsets in order
3542 to manage `inserted' flag in bp loc in a correct state.
3543 breakpoint_init_inferior, called from init_wait_for_inferior, set
3544 `inserted' flag to 0, while before breakpoint_re_set, called from
3545 start_remote, set `inserted' flag to 1. In the initialization of
3546 inferior, breakpoint_init_inferior should be called first, and then
3547 breakpoint_re_set can be called. If this order is broken, state of
3548 `inserted' flag is wrong, and cause some problems on breakpoint
3550 init_wait_for_inferior ();
3552 get_offsets (); /* Get text, data & bss offsets. */
3554 /* If we could not find a description using qXfer, and we know
3555 how to do it some other way, try again. This is not
3556 supported for non-stop; it could be, but it is tricky if
3557 there are no stopped threads when we connect. */
3558 if (remote_read_description_p (target)
3559 && gdbarch_target_desc (target_gdbarch ()) == NULL)
3561 target_clear_description ();
3562 target_find_description ();
3565 /* Use the previously fetched status. */
3566 gdb_assert (wait_status != NULL);
3567 strcpy (rs->buf, wait_status);
3568 rs->cached_wait_status = 1;
3571 start_remote (from_tty); /* Initialize gdb process mechanisms. */
3575 /* Clear WFI global state. Do this before finding about new
3576 threads and inferiors, and setting the current inferior.
3577 Otherwise we would clear the proceed status of the current
3578 inferior when we want its stop_soon state to be preserved
3579 (see notice_new_inferior). */
3580 init_wait_for_inferior ();
3582 /* In non-stop, we will either get an "OK", meaning that there
3583 are no stopped threads at this time; or, a regular stop
3584 reply. In the latter case, there may be more than one thread
3585 stopped --- we pull them all out using the vStopped
3587 if (strcmp (rs->buf, "OK") != 0)
3589 struct notif_client *notif = ¬if_client_stop;
3591 /* remote_notif_get_pending_replies acks this one, and gets
3593 rs->notif_state->pending_event[notif_client_stop.id]
3594 = remote_notif_parse (notif, rs->buf);
3595 remote_notif_get_pending_events (notif);
3597 /* Make sure that threads that were stopped remain
3599 iterate_over_threads (set_stop_requested_callback, NULL);
3602 if (target_can_async_p ())
3603 target_async (inferior_event_handler, 0);
3605 if (thread_count () == 0)
3608 error (_("The target is not running (try extended-remote?)"));
3610 /* We're connected, but not running. Drop out before we
3611 call start_remote. */
3612 rs->starting_up = 0;
3616 /* Let the stub know that we want it to return the thread. */
3618 /* Force the stub to choose a thread. */
3619 set_general_thread (null_ptid);
3622 inferior_ptid = remote_current_thread (minus_one_ptid);
3623 if (ptid_equal (inferior_ptid, minus_one_ptid))
3624 error (_("remote didn't report the current thread in non-stop mode"));
3626 get_offsets (); /* Get text, data & bss offsets. */
3628 /* In non-stop mode, any cached wait status will be stored in
3629 the stop reply queue. */
3630 gdb_assert (wait_status == NULL);
3632 /* Report all signals during attach/startup. */
3633 remote_pass_signals (target, 0, NULL);
3636 /* If we connected to a live target, do some additional setup. */
3637 if (target_has_execution)
3639 if (symfile_objfile) /* No use without a symbol-file. */
3640 remote_check_symbols ();
3643 /* Possibly the target has been engaged in a trace run started
3644 previously; find out where things are at. */
3645 if (remote_get_trace_status (target, current_trace_status ()) != -1)
3647 struct uploaded_tp *uploaded_tps = NULL;
3649 if (current_trace_status ()->running)
3650 printf_filtered (_("Trace is already running on the target.\n"));
3652 remote_upload_tracepoints (target, &uploaded_tps);
3654 merge_uploaded_tracepoints (&uploaded_tps);
3657 /* The thread and inferior lists are now synchronized with the
3658 target, our symbols have been relocated, and we're merged the
3659 target's tracepoints with ours. We're done with basic start
3661 rs->starting_up = 0;
3663 /* Maybe breakpoints are global and need to be inserted now. */
3664 if (breakpoints_should_be_inserted_now ())
3665 insert_breakpoints ();
3668 /* Open a connection to a remote debugger.
3669 NAME is the filename used for communication. */
3672 remote_open (const char *name, int from_tty)
3674 remote_open_1 (name, from_tty, &remote_ops, 0);
3677 /* Open a connection to a remote debugger using the extended
3678 remote gdb protocol. NAME is the filename used for communication. */
3681 extended_remote_open (const char *name, int from_tty)
3683 remote_open_1 (name, from_tty, &extended_remote_ops, 1 /*extended_p */);
3686 /* Reset all packets back to "unknown support". Called when opening a
3687 new connection to a remote target. */
3690 reset_all_packet_configs_support (void)
3694 for (i = 0; i < PACKET_MAX; i++)
3695 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
3698 /* Initialize all packet configs. */
3701 init_all_packet_configs (void)
3705 for (i = 0; i < PACKET_MAX; i++)
3707 remote_protocol_packets[i].detect = AUTO_BOOLEAN_AUTO;
3708 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
3712 /* Symbol look-up. */
3715 remote_check_symbols (void)
3717 struct remote_state *rs = get_remote_state ();
3718 char *msg, *reply, *tmp;
3719 struct bound_minimal_symbol sym;
3722 /* The remote side has no concept of inferiors that aren't running
3723 yet, it only knows about running processes. If we're connected
3724 but our current inferior is not running, we should not invite the
3725 remote target to request symbol lookups related to its
3726 (unrelated) current process. */
3727 if (!target_has_execution)
3730 if (packet_support (PACKET_qSymbol) == PACKET_DISABLE)
3733 /* Make sure the remote is pointing at the right process. Note
3734 there's no way to select "no process". */
3735 set_general_process ();
3737 /* Allocate a message buffer. We can't reuse the input buffer in RS,
3738 because we need both at the same time. */
3739 msg = alloca (get_remote_packet_size ());
3741 /* Invite target to request symbol lookups. */
3743 putpkt ("qSymbol::");
3744 getpkt (&rs->buf, &rs->buf_size, 0);
3745 packet_ok (rs->buf, &remote_protocol_packets[PACKET_qSymbol]);
3748 while (strncmp (reply, "qSymbol:", 8) == 0)
3750 struct bound_minimal_symbol sym;
3753 end = hex2bin (tmp, (gdb_byte *) msg, strlen (tmp) / 2);
3755 sym = lookup_minimal_symbol (msg, NULL, NULL);
3756 if (sym.minsym == NULL)
3757 xsnprintf (msg, get_remote_packet_size (), "qSymbol::%s", &reply[8]);
3760 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
3761 CORE_ADDR sym_addr = BMSYMBOL_VALUE_ADDRESS (sym);
3763 /* If this is a function address, return the start of code
3764 instead of any data function descriptor. */
3765 sym_addr = gdbarch_convert_from_func_ptr_addr (target_gdbarch (),
3769 xsnprintf (msg, get_remote_packet_size (), "qSymbol:%s:%s",
3770 phex_nz (sym_addr, addr_size), &reply[8]);
3774 getpkt (&rs->buf, &rs->buf_size, 0);
3779 static struct serial *
3780 remote_serial_open (const char *name)
3782 static int udp_warning = 0;
3784 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
3785 of in ser-tcp.c, because it is the remote protocol assuming that the
3786 serial connection is reliable and not the serial connection promising
3788 if (!udp_warning && strncmp (name, "udp:", 4) == 0)
3790 warning (_("The remote protocol may be unreliable over UDP.\n"
3791 "Some events may be lost, rendering further debugging "
3796 return serial_open (name);
3799 /* Inform the target of our permission settings. The permission flags
3800 work without this, but if the target knows the settings, it can do
3801 a couple things. First, it can add its own check, to catch cases
3802 that somehow manage to get by the permissions checks in target
3803 methods. Second, if the target is wired to disallow particular
3804 settings (for instance, a system in the field that is not set up to
3805 be able to stop at a breakpoint), it can object to any unavailable
3809 remote_set_permissions (struct target_ops *self)
3811 struct remote_state *rs = get_remote_state ();
3813 xsnprintf (rs->buf, get_remote_packet_size (), "QAllow:"
3814 "WriteReg:%x;WriteMem:%x;"
3815 "InsertBreak:%x;InsertTrace:%x;"
3816 "InsertFastTrace:%x;Stop:%x",
3817 may_write_registers, may_write_memory,
3818 may_insert_breakpoints, may_insert_tracepoints,
3819 may_insert_fast_tracepoints, may_stop);
3821 getpkt (&rs->buf, &rs->buf_size, 0);
3823 /* If the target didn't like the packet, warn the user. Do not try
3824 to undo the user's settings, that would just be maddening. */
3825 if (strcmp (rs->buf, "OK") != 0)
3826 warning (_("Remote refused setting permissions with: %s"), rs->buf);
3829 /* This type describes each known response to the qSupported
3831 struct protocol_feature
3833 /* The name of this protocol feature. */
3836 /* The default for this protocol feature. */
3837 enum packet_support default_support;
3839 /* The function to call when this feature is reported, or after
3840 qSupported processing if the feature is not supported.
3841 The first argument points to this structure. The second
3842 argument indicates whether the packet requested support be
3843 enabled, disabled, or probed (or the default, if this function
3844 is being called at the end of processing and this feature was
3845 not reported). The third argument may be NULL; if not NULL, it
3846 is a NUL-terminated string taken from the packet following
3847 this feature's name and an equals sign. */
3848 void (*func) (const struct protocol_feature *, enum packet_support,
3851 /* The corresponding packet for this feature. Only used if
3852 FUNC is remote_supported_packet. */
3857 remote_supported_packet (const struct protocol_feature *feature,
3858 enum packet_support support,
3859 const char *argument)
3863 warning (_("Remote qSupported response supplied an unexpected value for"
3864 " \"%s\"."), feature->name);
3868 remote_protocol_packets[feature->packet].support = support;
3872 remote_packet_size (const struct protocol_feature *feature,
3873 enum packet_support support, const char *value)
3875 struct remote_state *rs = get_remote_state ();
3880 if (support != PACKET_ENABLE)
3883 if (value == NULL || *value == '\0')
3885 warning (_("Remote target reported \"%s\" without a size."),
3891 packet_size = strtol (value, &value_end, 16);
3892 if (errno != 0 || *value_end != '\0' || packet_size < 0)
3894 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
3895 feature->name, value);
3899 if (packet_size > MAX_REMOTE_PACKET_SIZE)
3901 warning (_("limiting remote suggested packet size (%d bytes) to %d"),
3902 packet_size, MAX_REMOTE_PACKET_SIZE);
3903 packet_size = MAX_REMOTE_PACKET_SIZE;
3906 /* Record the new maximum packet size. */
3907 rs->explicit_packet_size = packet_size;
3910 static const struct protocol_feature remote_protocol_features[] = {
3911 { "PacketSize", PACKET_DISABLE, remote_packet_size, -1 },
3912 { "qXfer:auxv:read", PACKET_DISABLE, remote_supported_packet,
3913 PACKET_qXfer_auxv },
3914 { "qXfer:features:read", PACKET_DISABLE, remote_supported_packet,
3915 PACKET_qXfer_features },
3916 { "qXfer:libraries:read", PACKET_DISABLE, remote_supported_packet,
3917 PACKET_qXfer_libraries },
3918 { "qXfer:libraries-svr4:read", PACKET_DISABLE, remote_supported_packet,
3919 PACKET_qXfer_libraries_svr4 },
3920 { "augmented-libraries-svr4-read", PACKET_DISABLE,
3921 remote_supported_packet, PACKET_augmented_libraries_svr4_read_feature },
3922 { "qXfer:memory-map:read", PACKET_DISABLE, remote_supported_packet,
3923 PACKET_qXfer_memory_map },
3924 { "qXfer:spu:read", PACKET_DISABLE, remote_supported_packet,
3925 PACKET_qXfer_spu_read },
3926 { "qXfer:spu:write", PACKET_DISABLE, remote_supported_packet,
3927 PACKET_qXfer_spu_write },
3928 { "qXfer:osdata:read", PACKET_DISABLE, remote_supported_packet,
3929 PACKET_qXfer_osdata },
3930 { "qXfer:threads:read", PACKET_DISABLE, remote_supported_packet,
3931 PACKET_qXfer_threads },
3932 { "qXfer:traceframe-info:read", PACKET_DISABLE, remote_supported_packet,
3933 PACKET_qXfer_traceframe_info },
3934 { "QPassSignals", PACKET_DISABLE, remote_supported_packet,
3935 PACKET_QPassSignals },
3936 { "QProgramSignals", PACKET_DISABLE, remote_supported_packet,
3937 PACKET_QProgramSignals },
3938 { "QStartNoAckMode", PACKET_DISABLE, remote_supported_packet,
3939 PACKET_QStartNoAckMode },
3940 { "multiprocess", PACKET_DISABLE, remote_supported_packet,
3941 PACKET_multiprocess_feature },
3942 { "QNonStop", PACKET_DISABLE, remote_supported_packet, PACKET_QNonStop },
3943 { "qXfer:siginfo:read", PACKET_DISABLE, remote_supported_packet,
3944 PACKET_qXfer_siginfo_read },
3945 { "qXfer:siginfo:write", PACKET_DISABLE, remote_supported_packet,
3946 PACKET_qXfer_siginfo_write },
3947 { "ConditionalTracepoints", PACKET_DISABLE, remote_supported_packet,
3948 PACKET_ConditionalTracepoints },
3949 { "ConditionalBreakpoints", PACKET_DISABLE, remote_supported_packet,
3950 PACKET_ConditionalBreakpoints },
3951 { "BreakpointCommands", PACKET_DISABLE, remote_supported_packet,
3952 PACKET_BreakpointCommands },
3953 { "FastTracepoints", PACKET_DISABLE, remote_supported_packet,
3954 PACKET_FastTracepoints },
3955 { "StaticTracepoints", PACKET_DISABLE, remote_supported_packet,
3956 PACKET_StaticTracepoints },
3957 {"InstallInTrace", PACKET_DISABLE, remote_supported_packet,
3958 PACKET_InstallInTrace},
3959 { "DisconnectedTracing", PACKET_DISABLE, remote_supported_packet,
3960 PACKET_DisconnectedTracing_feature },
3961 { "ReverseContinue", PACKET_DISABLE, remote_supported_packet,
3963 { "ReverseStep", PACKET_DISABLE, remote_supported_packet,
3965 { "TracepointSource", PACKET_DISABLE, remote_supported_packet,
3966 PACKET_TracepointSource },
3967 { "QAllow", PACKET_DISABLE, remote_supported_packet,
3969 { "EnableDisableTracepoints", PACKET_DISABLE, remote_supported_packet,
3970 PACKET_EnableDisableTracepoints_feature },
3971 { "qXfer:fdpic:read", PACKET_DISABLE, remote_supported_packet,
3972 PACKET_qXfer_fdpic },
3973 { "qXfer:uib:read", PACKET_DISABLE, remote_supported_packet,
3975 { "QDisableRandomization", PACKET_DISABLE, remote_supported_packet,
3976 PACKET_QDisableRandomization },
3977 { "QAgent", PACKET_DISABLE, remote_supported_packet, PACKET_QAgent},
3978 { "QTBuffer:size", PACKET_DISABLE,
3979 remote_supported_packet, PACKET_QTBuffer_size},
3980 { "tracenz", PACKET_DISABLE, remote_supported_packet, PACKET_tracenz_feature },
3981 { "Qbtrace:off", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_off },
3982 { "Qbtrace:bts", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_bts },
3983 { "qXfer:btrace:read", PACKET_DISABLE, remote_supported_packet,
3984 PACKET_qXfer_btrace }
3987 static char *remote_support_xml;
3989 /* Register string appended to "xmlRegisters=" in qSupported query. */
3992 register_remote_support_xml (const char *xml)
3994 #if defined(HAVE_LIBEXPAT)
3995 if (remote_support_xml == NULL)
3996 remote_support_xml = concat ("xmlRegisters=", xml, (char *) NULL);
3999 char *copy = xstrdup (remote_support_xml + 13);
4000 char *p = strtok (copy, ",");
4004 if (strcmp (p, xml) == 0)
4011 while ((p = strtok (NULL, ",")) != NULL);
4014 remote_support_xml = reconcat (remote_support_xml,
4015 remote_support_xml, ",", xml,
4022 remote_query_supported_append (char *msg, const char *append)
4025 return reconcat (msg, msg, ";", append, (char *) NULL);
4027 return xstrdup (append);
4031 remote_query_supported (void)
4033 struct remote_state *rs = get_remote_state ();
4036 unsigned char seen [ARRAY_SIZE (remote_protocol_features)];
4038 /* The packet support flags are handled differently for this packet
4039 than for most others. We treat an error, a disabled packet, and
4040 an empty response identically: any features which must be reported
4041 to be used will be automatically disabled. An empty buffer
4042 accomplishes this, since that is also the representation for a list
4043 containing no features. */
4046 if (packet_support (PACKET_qSupported) != PACKET_DISABLE)
4049 struct cleanup *old_chain = make_cleanup (free_current_contents, &q);
4051 q = remote_query_supported_append (q, "multiprocess+");
4053 if (remote_support_xml)
4054 q = remote_query_supported_append (q, remote_support_xml);
4056 q = remote_query_supported_append (q, "qRelocInsn+");
4058 q = reconcat (q, "qSupported:", q, (char *) NULL);
4061 do_cleanups (old_chain);
4063 getpkt (&rs->buf, &rs->buf_size, 0);
4065 /* If an error occured, warn, but do not return - just reset the
4066 buffer to empty and go on to disable features. */
4067 if (packet_ok (rs->buf, &remote_protocol_packets[PACKET_qSupported])
4070 warning (_("Remote failure reply: %s"), rs->buf);
4075 memset (seen, 0, sizeof (seen));
4080 enum packet_support is_supported;
4081 char *p, *end, *name_end, *value;
4083 /* First separate out this item from the rest of the packet. If
4084 there's another item after this, we overwrite the separator
4085 (terminated strings are much easier to work with). */
4087 end = strchr (p, ';');
4090 end = p + strlen (p);
4100 warning (_("empty item in \"qSupported\" response"));
4105 name_end = strchr (p, '=');
4108 /* This is a name=value entry. */
4109 is_supported = PACKET_ENABLE;
4110 value = name_end + 1;
4119 is_supported = PACKET_ENABLE;
4123 is_supported = PACKET_DISABLE;
4127 is_supported = PACKET_SUPPORT_UNKNOWN;
4131 warning (_("unrecognized item \"%s\" "
4132 "in \"qSupported\" response"), p);
4138 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
4139 if (strcmp (remote_protocol_features[i].name, p) == 0)
4141 const struct protocol_feature *feature;
4144 feature = &remote_protocol_features[i];
4145 feature->func (feature, is_supported, value);
4150 /* If we increased the packet size, make sure to increase the global
4151 buffer size also. We delay this until after parsing the entire
4152 qSupported packet, because this is the same buffer we were
4154 if (rs->buf_size < rs->explicit_packet_size)
4156 rs->buf_size = rs->explicit_packet_size;
4157 rs->buf = xrealloc (rs->buf, rs->buf_size);
4160 /* Handle the defaults for unmentioned features. */
4161 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
4164 const struct protocol_feature *feature;
4166 feature = &remote_protocol_features[i];
4167 feature->func (feature, feature->default_support, NULL);
4171 /* Remove any of the remote.c targets from target stack. Upper targets depend
4172 on it so remove them first. */
4175 remote_unpush_target (void)
4177 pop_all_targets_above (process_stratum - 1);
4181 remote_open_1 (const char *name, int from_tty,
4182 struct target_ops *target, int extended_p)
4184 struct remote_state *rs = get_remote_state ();
4187 error (_("To open a remote debug connection, you need to specify what\n"
4188 "serial device is attached to the remote system\n"
4189 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
4191 /* See FIXME above. */
4192 if (!target_async_permitted)
4193 wait_forever_enabled_p = 1;
4195 /* If we're connected to a running target, target_preopen will kill it.
4196 Ask this question first, before target_preopen has a chance to kill
4198 if (rs->remote_desc != NULL && !have_inferiors ())
4201 && !query (_("Already connected to a remote target. Disconnect? ")))
4202 error (_("Still connected."));
4205 /* Here the possibly existing remote target gets unpushed. */
4206 target_preopen (from_tty);
4208 /* Make sure we send the passed signals list the next time we resume. */
4209 xfree (rs->last_pass_packet);
4210 rs->last_pass_packet = NULL;
4212 /* Make sure we send the program signals list the next time we
4214 xfree (rs->last_program_signals_packet);
4215 rs->last_program_signals_packet = NULL;
4217 remote_fileio_reset ();
4218 reopen_exec_file ();
4221 rs->remote_desc = remote_serial_open (name);
4222 if (!rs->remote_desc)
4223 perror_with_name (name);
4225 if (baud_rate != -1)
4227 if (serial_setbaudrate (rs->remote_desc, baud_rate))
4229 /* The requested speed could not be set. Error out to
4230 top level after closing remote_desc. Take care to
4231 set remote_desc to NULL to avoid closing remote_desc
4233 serial_close (rs->remote_desc);
4234 rs->remote_desc = NULL;
4235 perror_with_name (name);
4239 serial_raw (rs->remote_desc);
4241 /* If there is something sitting in the buffer we might take it as a
4242 response to a command, which would be bad. */
4243 serial_flush_input (rs->remote_desc);
4247 puts_filtered ("Remote debugging using ");
4248 puts_filtered (name);
4249 puts_filtered ("\n");
4251 push_target (target); /* Switch to using remote target now. */
4253 /* Register extra event sources in the event loop. */
4254 remote_async_inferior_event_token
4255 = create_async_event_handler (remote_async_inferior_event_handler,
4257 rs->notif_state = remote_notif_state_allocate ();
4259 /* Reset the target state; these things will be queried either by
4260 remote_query_supported or as they are needed. */
4261 reset_all_packet_configs_support ();
4262 rs->cached_wait_status = 0;
4263 rs->explicit_packet_size = 0;
4265 rs->extended = extended_p;
4266 rs->waiting_for_stop_reply = 0;
4267 rs->ctrlc_pending_p = 0;
4269 rs->general_thread = not_sent_ptid;
4270 rs->continue_thread = not_sent_ptid;
4271 rs->remote_traceframe_number = -1;
4273 /* Probe for ability to use "ThreadInfo" query, as required. */
4274 rs->use_threadinfo_query = 1;
4275 rs->use_threadextra_query = 1;
4277 if (target_async_permitted)
4279 /* With this target we start out by owning the terminal. */
4280 remote_async_terminal_ours_p = 1;
4282 /* FIXME: cagney/1999-09-23: During the initial connection it is
4283 assumed that the target is already ready and able to respond to
4284 requests. Unfortunately remote_start_remote() eventually calls
4285 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
4286 around this. Eventually a mechanism that allows
4287 wait_for_inferior() to expect/get timeouts will be
4289 wait_forever_enabled_p = 0;
4292 /* First delete any symbols previously loaded from shared libraries. */
4293 no_shared_libraries (NULL, 0);
4296 init_thread_list ();
4298 /* Start the remote connection. If error() or QUIT, discard this
4299 target (we'd otherwise be in an inconsistent state) and then
4300 propogate the error on up the exception chain. This ensures that
4301 the caller doesn't stumble along blindly assuming that the
4302 function succeeded. The CLI doesn't have this problem but other
4303 UI's, such as MI do.
4305 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
4306 this function should return an error indication letting the
4307 caller restore the previous state. Unfortunately the command
4308 ``target remote'' is directly wired to this function making that
4309 impossible. On a positive note, the CLI side of this problem has
4310 been fixed - the function set_cmd_context() makes it possible for
4311 all the ``target ....'' commands to share a common callback
4312 function. See cli-dump.c. */
4314 volatile struct gdb_exception ex;
4316 TRY_CATCH (ex, RETURN_MASK_ALL)
4318 remote_start_remote (from_tty, target, extended_p);
4322 /* Pop the partially set up target - unless something else did
4323 already before throwing the exception. */
4324 if (rs->remote_desc != NULL)
4325 remote_unpush_target ();
4326 if (target_async_permitted)
4327 wait_forever_enabled_p = 1;
4328 throw_exception (ex);
4332 if (target_async_permitted)
4333 wait_forever_enabled_p = 1;
4336 /* This takes a program previously attached to and detaches it. After
4337 this is done, GDB can be used to debug some other program. We
4338 better not have left any breakpoints in the target program or it'll
4339 die when it hits one. */
4342 remote_detach_1 (const char *args, int from_tty, int extended)
4344 int pid = ptid_get_pid (inferior_ptid);
4345 struct remote_state *rs = get_remote_state ();
4348 error (_("Argument given to \"detach\" when remotely debugging."));
4350 if (!target_has_execution)
4351 error (_("No process to detach from."));
4355 char *exec_file = get_exec_file (0);
4356 if (exec_file == NULL)
4358 printf_unfiltered (_("Detaching from program: %s, %s\n"), exec_file,
4359 target_pid_to_str (pid_to_ptid (pid)));
4360 gdb_flush (gdb_stdout);
4363 /* Tell the remote target to detach. */
4364 if (remote_multi_process_p (rs))
4365 xsnprintf (rs->buf, get_remote_packet_size (), "D;%x", pid);
4367 strcpy (rs->buf, "D");
4370 getpkt (&rs->buf, &rs->buf_size, 0);
4372 if (rs->buf[0] == 'O' && rs->buf[1] == 'K')
4374 else if (rs->buf[0] == '\0')
4375 error (_("Remote doesn't know how to detach"));
4377 error (_("Can't detach process."));
4379 if (from_tty && !extended)
4380 puts_filtered (_("Ending remote debugging.\n"));
4382 target_mourn_inferior ();
4386 remote_detach (struct target_ops *ops, const char *args, int from_tty)
4388 remote_detach_1 (args, from_tty, 0);
4392 extended_remote_detach (struct target_ops *ops, const char *args, int from_tty)
4394 remote_detach_1 (args, from_tty, 1);
4397 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
4400 remote_disconnect (struct target_ops *target, const char *args, int from_tty)
4403 error (_("Argument given to \"disconnect\" when remotely debugging."));
4405 /* Make sure we unpush even the extended remote targets; mourn
4406 won't do it. So call remote_mourn_1 directly instead of
4407 target_mourn_inferior. */
4408 remote_mourn_1 (target);
4411 puts_filtered ("Ending remote debugging.\n");
4414 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
4415 be chatty about it. */
4418 extended_remote_attach_1 (struct target_ops *target, const char *args,
4421 struct remote_state *rs = get_remote_state ();
4423 char *wait_status = NULL;
4425 pid = parse_pid_to_attach (args);
4427 /* Remote PID can be freely equal to getpid, do not check it here the same
4428 way as in other targets. */
4430 if (packet_support (PACKET_vAttach) == PACKET_DISABLE)
4431 error (_("This target does not support attaching to a process"));
4435 char *exec_file = get_exec_file (0);
4438 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file,
4439 target_pid_to_str (pid_to_ptid (pid)));
4441 printf_unfiltered (_("Attaching to %s\n"),
4442 target_pid_to_str (pid_to_ptid (pid)));
4444 gdb_flush (gdb_stdout);
4447 xsnprintf (rs->buf, get_remote_packet_size (), "vAttach;%x", pid);
4449 getpkt (&rs->buf, &rs->buf_size, 0);
4451 switch (packet_ok (rs->buf,
4452 &remote_protocol_packets[PACKET_vAttach]))
4457 /* Save the reply for later. */
4458 wait_status = alloca (strlen (rs->buf) + 1);
4459 strcpy (wait_status, rs->buf);
4461 else if (strcmp (rs->buf, "OK") != 0)
4462 error (_("Attaching to %s failed with: %s"),
4463 target_pid_to_str (pid_to_ptid (pid)),
4466 case PACKET_UNKNOWN:
4467 error (_("This target does not support attaching to a process"));
4469 error (_("Attaching to %s failed"),
4470 target_pid_to_str (pid_to_ptid (pid)));
4473 set_current_inferior (remote_add_inferior (0, pid, 1));
4475 inferior_ptid = pid_to_ptid (pid);
4479 struct thread_info *thread;
4481 /* Get list of threads. */
4482 remote_update_thread_list (target);
4484 thread = first_thread_of_process (pid);
4486 inferior_ptid = thread->ptid;
4488 inferior_ptid = pid_to_ptid (pid);
4490 /* Invalidate our notion of the remote current thread. */
4491 record_currthread (rs, minus_one_ptid);
4495 /* Now, if we have thread information, update inferior_ptid. */
4496 inferior_ptid = remote_current_thread (inferior_ptid);
4498 /* Add the main thread to the thread list. */
4499 add_thread_silent (inferior_ptid);
4502 /* Next, if the target can specify a description, read it. We do
4503 this before anything involving memory or registers. */
4504 target_find_description ();
4508 /* Use the previously fetched status. */
4509 gdb_assert (wait_status != NULL);
4511 if (target_can_async_p ())
4513 struct notif_event *reply
4514 = remote_notif_parse (¬if_client_stop, wait_status);
4516 push_stop_reply ((struct stop_reply *) reply);
4518 target_async (inferior_event_handler, 0);
4522 gdb_assert (wait_status != NULL);
4523 strcpy (rs->buf, wait_status);
4524 rs->cached_wait_status = 1;
4528 gdb_assert (wait_status == NULL);
4532 extended_remote_attach (struct target_ops *ops, const char *args, int from_tty)
4534 extended_remote_attach_1 (ops, args, from_tty);
4537 /* Implementation of the to_post_attach method. */
4540 extended_remote_post_attach (struct target_ops *ops, int pid)
4542 /* In certain cases GDB might not have had the chance to start
4543 symbol lookup up until now. This could happen if the debugged
4544 binary is not using shared libraries, the vsyscall page is not
4545 present (on Linux) and the binary itself hadn't changed since the
4546 debugging process was started. */
4547 if (symfile_objfile != NULL)
4548 remote_check_symbols();
4552 /* Check for the availability of vCont. This function should also check
4556 remote_vcont_probe (struct remote_state *rs)
4560 strcpy (rs->buf, "vCont?");
4562 getpkt (&rs->buf, &rs->buf_size, 0);
4565 /* Make sure that the features we assume are supported. */
4566 if (strncmp (buf, "vCont", 5) == 0)
4569 int support_s, support_S, support_c, support_C;
4575 rs->supports_vCont.t = 0;
4576 rs->supports_vCont.r = 0;
4577 while (p && *p == ';')
4580 if (*p == 's' && (*(p + 1) == ';' || *(p + 1) == 0))
4582 else if (*p == 'S' && (*(p + 1) == ';' || *(p + 1) == 0))
4584 else if (*p == 'c' && (*(p + 1) == ';' || *(p + 1) == 0))
4586 else if (*p == 'C' && (*(p + 1) == ';' || *(p + 1) == 0))
4588 else if (*p == 't' && (*(p + 1) == ';' || *(p + 1) == 0))
4589 rs->supports_vCont.t = 1;
4590 else if (*p == 'r' && (*(p + 1) == ';' || *(p + 1) == 0))
4591 rs->supports_vCont.r = 1;
4593 p = strchr (p, ';');
4596 /* If s, S, c, and C are not all supported, we can't use vCont. Clearing
4597 BUF will make packet_ok disable the packet. */
4598 if (!support_s || !support_S || !support_c || !support_C)
4602 packet_ok (buf, &remote_protocol_packets[PACKET_vCont]);
4605 /* Helper function for building "vCont" resumptions. Write a
4606 resumption to P. ENDP points to one-passed-the-end of the buffer
4607 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
4608 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
4609 resumed thread should be single-stepped and/or signalled. If PTID
4610 equals minus_one_ptid, then all threads are resumed; if PTID
4611 represents a process, then all threads of the process are resumed;
4612 the thread to be stepped and/or signalled is given in the global
4616 append_resumption (char *p, char *endp,
4617 ptid_t ptid, int step, enum gdb_signal siggnal)
4619 struct remote_state *rs = get_remote_state ();
4621 if (step && siggnal != GDB_SIGNAL_0)
4622 p += xsnprintf (p, endp - p, ";S%02x", siggnal);
4624 /* GDB is willing to range step. */
4625 && use_range_stepping
4626 /* Target supports range stepping. */
4627 && rs->supports_vCont.r
4628 /* We don't currently support range stepping multiple
4629 threads with a wildcard (though the protocol allows it,
4630 so stubs shouldn't make an active effort to forbid
4632 && !(remote_multi_process_p (rs) && ptid_is_pid (ptid)))
4634 struct thread_info *tp;
4636 if (ptid_equal (ptid, minus_one_ptid))
4638 /* If we don't know about the target thread's tid, then
4639 we're resuming magic_null_ptid (see caller). */
4640 tp = find_thread_ptid (magic_null_ptid);
4643 tp = find_thread_ptid (ptid);
4644 gdb_assert (tp != NULL);
4646 if (tp->control.may_range_step)
4648 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
4650 p += xsnprintf (p, endp - p, ";r%s,%s",
4651 phex_nz (tp->control.step_range_start,
4653 phex_nz (tp->control.step_range_end,
4657 p += xsnprintf (p, endp - p, ";s");
4660 p += xsnprintf (p, endp - p, ";s");
4661 else if (siggnal != GDB_SIGNAL_0)
4662 p += xsnprintf (p, endp - p, ";C%02x", siggnal);
4664 p += xsnprintf (p, endp - p, ";c");
4666 if (remote_multi_process_p (rs) && ptid_is_pid (ptid))
4670 /* All (-1) threads of process. */
4671 nptid = ptid_build (ptid_get_pid (ptid), -1, 0);
4673 p += xsnprintf (p, endp - p, ":");
4674 p = write_ptid (p, endp, nptid);
4676 else if (!ptid_equal (ptid, minus_one_ptid))
4678 p += xsnprintf (p, endp - p, ":");
4679 p = write_ptid (p, endp, ptid);
4685 /* Append a vCont continue-with-signal action for threads that have a
4686 non-zero stop signal. */
4689 append_pending_thread_resumptions (char *p, char *endp, ptid_t ptid)
4691 struct thread_info *thread;
4693 ALL_NON_EXITED_THREADS (thread)
4694 if (ptid_match (thread->ptid, ptid)
4695 && !ptid_equal (inferior_ptid, thread->ptid)
4696 && thread->suspend.stop_signal != GDB_SIGNAL_0)
4698 p = append_resumption (p, endp, thread->ptid,
4699 0, thread->suspend.stop_signal);
4700 thread->suspend.stop_signal = GDB_SIGNAL_0;
4706 /* Resume the remote inferior by using a "vCont" packet. The thread
4707 to be resumed is PTID; STEP and SIGGNAL indicate whether the
4708 resumed thread should be single-stepped and/or signalled. If PTID
4709 equals minus_one_ptid, then all threads are resumed; the thread to
4710 be stepped and/or signalled is given in the global INFERIOR_PTID.
4711 This function returns non-zero iff it resumes the inferior.
4713 This function issues a strict subset of all possible vCont commands at the
4717 remote_vcont_resume (ptid_t ptid, int step, enum gdb_signal siggnal)
4719 struct remote_state *rs = get_remote_state ();
4723 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
4724 remote_vcont_probe (rs);
4726 if (packet_support (PACKET_vCont) == PACKET_DISABLE)
4730 endp = rs->buf + get_remote_packet_size ();
4732 /* If we could generate a wider range of packets, we'd have to worry
4733 about overflowing BUF. Should there be a generic
4734 "multi-part-packet" packet? */
4736 p += xsnprintf (p, endp - p, "vCont");
4738 if (ptid_equal (ptid, magic_null_ptid))
4740 /* MAGIC_NULL_PTID means that we don't have any active threads,
4741 so we don't have any TID numbers the inferior will
4742 understand. Make sure to only send forms that do not specify
4744 append_resumption (p, endp, minus_one_ptid, step, siggnal);
4746 else if (ptid_equal (ptid, minus_one_ptid) || ptid_is_pid (ptid))
4748 /* Resume all threads (of all processes, or of a single
4749 process), with preference for INFERIOR_PTID. This assumes
4750 inferior_ptid belongs to the set of all threads we are about
4752 if (step || siggnal != GDB_SIGNAL_0)
4754 /* Step inferior_ptid, with or without signal. */
4755 p = append_resumption (p, endp, inferior_ptid, step, siggnal);
4758 /* Also pass down any pending signaled resumption for other
4759 threads not the current. */
4760 p = append_pending_thread_resumptions (p, endp, ptid);
4762 /* And continue others without a signal. */
4763 append_resumption (p, endp, ptid, /*step=*/ 0, GDB_SIGNAL_0);
4767 /* Scheduler locking; resume only PTID. */
4768 append_resumption (p, endp, ptid, step, siggnal);
4771 gdb_assert (strlen (rs->buf) < get_remote_packet_size ());
4776 /* In non-stop, the stub replies to vCont with "OK". The stop
4777 reply will be reported asynchronously by means of a `%Stop'
4779 getpkt (&rs->buf, &rs->buf_size, 0);
4780 if (strcmp (rs->buf, "OK") != 0)
4781 error (_("Unexpected vCont reply in non-stop mode: %s"), rs->buf);
4787 /* Tell the remote machine to resume. */
4790 remote_resume (struct target_ops *ops,
4791 ptid_t ptid, int step, enum gdb_signal siggnal)
4793 struct remote_state *rs = get_remote_state ();
4796 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
4797 (explained in remote-notif.c:handle_notification) so
4798 remote_notif_process is not called. We need find a place where
4799 it is safe to start a 'vNotif' sequence. It is good to do it
4800 before resuming inferior, because inferior was stopped and no RSP
4801 traffic at that moment. */
4803 remote_notif_process (rs->notif_state, ¬if_client_stop);
4805 rs->last_sent_signal = siggnal;
4806 rs->last_sent_step = step;
4808 /* The vCont packet doesn't need to specify threads via Hc. */
4809 /* No reverse support (yet) for vCont. */
4810 if (execution_direction != EXEC_REVERSE)
4811 if (remote_vcont_resume (ptid, step, siggnal))
4814 /* All other supported resume packets do use Hc, so set the continue
4816 if (ptid_equal (ptid, minus_one_ptid))
4817 set_continue_thread (any_thread_ptid);
4819 set_continue_thread (ptid);
4822 if (execution_direction == EXEC_REVERSE)
4824 /* We don't pass signals to the target in reverse exec mode. */
4825 if (info_verbose && siggnal != GDB_SIGNAL_0)
4826 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
4829 if (step && packet_support (PACKET_bs) == PACKET_DISABLE)
4830 error (_("Remote reverse-step not supported."));
4831 if (!step && packet_support (PACKET_bc) == PACKET_DISABLE)
4832 error (_("Remote reverse-continue not supported."));
4834 strcpy (buf, step ? "bs" : "bc");
4836 else if (siggnal != GDB_SIGNAL_0)
4838 buf[0] = step ? 'S' : 'C';
4839 buf[1] = tohex (((int) siggnal >> 4) & 0xf);
4840 buf[2] = tohex (((int) siggnal) & 0xf);
4844 strcpy (buf, step ? "s" : "c");
4849 /* We are about to start executing the inferior, let's register it
4850 with the event loop. NOTE: this is the one place where all the
4851 execution commands end up. We could alternatively do this in each
4852 of the execution commands in infcmd.c. */
4853 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
4854 into infcmd.c in order to allow inferior function calls to work
4855 NOT asynchronously. */
4856 if (target_can_async_p ())
4857 target_async (inferior_event_handler, 0);
4859 /* We've just told the target to resume. The remote server will
4860 wait for the inferior to stop, and then send a stop reply. In
4861 the mean time, we can't start another command/query ourselves
4862 because the stub wouldn't be ready to process it. This applies
4863 only to the base all-stop protocol, however. In non-stop (which
4864 only supports vCont), the stub replies with an "OK", and is
4865 immediate able to process further serial input. */
4867 rs->waiting_for_stop_reply = 1;
4871 /* Set up the signal handler for SIGINT, while the target is
4872 executing, ovewriting the 'regular' SIGINT signal handler. */
4874 async_initialize_sigint_signal_handler (void)
4876 signal (SIGINT, async_handle_remote_sigint);
4879 /* Signal handler for SIGINT, while the target is executing. */
4881 async_handle_remote_sigint (int sig)
4883 signal (sig, async_handle_remote_sigint_twice);
4884 /* Note we need to go through gdb_call_async_signal_handler in order
4885 to wake up the event loop on Windows. */
4886 gdb_call_async_signal_handler (async_sigint_remote_token, 0);
4889 /* Signal handler for SIGINT, installed after SIGINT has already been
4890 sent once. It will take effect the second time that the user sends
4893 async_handle_remote_sigint_twice (int sig)
4895 signal (sig, async_handle_remote_sigint);
4896 /* See note in async_handle_remote_sigint. */
4897 gdb_call_async_signal_handler (async_sigint_remote_twice_token, 0);
4900 /* Perform the real interruption of the target execution, in response
4903 async_remote_interrupt (gdb_client_data arg)
4906 fprintf_unfiltered (gdb_stdlog, "async_remote_interrupt called\n");
4908 target_stop (inferior_ptid);
4911 /* Perform interrupt, if the first attempt did not succeed. Just give
4912 up on the target alltogether. */
4914 async_remote_interrupt_twice (gdb_client_data arg)
4917 fprintf_unfiltered (gdb_stdlog, "async_remote_interrupt_twice called\n");
4922 /* Reinstall the usual SIGINT handlers, after the target has
4925 async_cleanup_sigint_signal_handler (void *dummy)
4927 signal (SIGINT, handle_sigint);
4930 /* Send ^C to target to halt it. Target will respond, and send us a
4932 static void (*ofunc) (int);
4934 /* The command line interface's stop routine. This function is installed
4935 as a signal handler for SIGINT. The first time a user requests a
4936 stop, we call remote_stop to send a break or ^C. If there is no
4937 response from the target (it didn't stop when the user requested it),
4938 we ask the user if he'd like to detach from the target. */
4940 sync_remote_interrupt (int signo)
4942 /* If this doesn't work, try more severe steps. */
4943 signal (signo, sync_remote_interrupt_twice);
4945 gdb_call_async_signal_handler (async_sigint_remote_token, 1);
4948 /* The user typed ^C twice. */
4951 sync_remote_interrupt_twice (int signo)
4953 signal (signo, ofunc);
4954 gdb_call_async_signal_handler (async_sigint_remote_twice_token, 1);
4955 signal (signo, sync_remote_interrupt);
4958 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
4959 thread, all threads of a remote process, or all threads of all
4963 remote_stop_ns (ptid_t ptid)
4965 struct remote_state *rs = get_remote_state ();
4967 char *endp = rs->buf + get_remote_packet_size ();
4969 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
4970 remote_vcont_probe (rs);
4972 if (!rs->supports_vCont.t)
4973 error (_("Remote server does not support stopping threads"));
4975 if (ptid_equal (ptid, minus_one_ptid)
4976 || (!remote_multi_process_p (rs) && ptid_is_pid (ptid)))
4977 p += xsnprintf (p, endp - p, "vCont;t");
4982 p += xsnprintf (p, endp - p, "vCont;t:");
4984 if (ptid_is_pid (ptid))
4985 /* All (-1) threads of process. */
4986 nptid = ptid_build (ptid_get_pid (ptid), -1, 0);
4989 /* Small optimization: if we already have a stop reply for
4990 this thread, no use in telling the stub we want this
4992 if (peek_stop_reply (ptid))
4998 write_ptid (p, endp, nptid);
5001 /* In non-stop, we get an immediate OK reply. The stop reply will
5002 come in asynchronously by notification. */
5004 getpkt (&rs->buf, &rs->buf_size, 0);
5005 if (strcmp (rs->buf, "OK") != 0)
5006 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid), rs->buf);
5009 /* All-stop version of target_stop. Sends a break or a ^C to stop the
5010 remote target. It is undefined which thread of which process
5011 reports the stop. */
5014 remote_stop_as (ptid_t ptid)
5016 struct remote_state *rs = get_remote_state ();
5018 rs->ctrlc_pending_p = 1;
5020 /* If the inferior is stopped already, but the core didn't know
5021 about it yet, just ignore the request. The cached wait status
5022 will be collected in remote_wait. */
5023 if (rs->cached_wait_status)
5026 /* Send interrupt_sequence to remote target. */
5027 send_interrupt_sequence ();
5030 /* This is the generic stop called via the target vector. When a target
5031 interrupt is requested, either by the command line or the GUI, we
5032 will eventually end up here. */
5035 remote_stop (struct target_ops *self, ptid_t ptid)
5038 fprintf_unfiltered (gdb_stdlog, "remote_stop called\n");
5041 remote_stop_ns (ptid);
5043 remote_stop_as (ptid);
5046 /* Ask the user what to do when an interrupt is received. */
5049 interrupt_query (void)
5051 target_terminal_ours ();
5053 if (target_can_async_p ())
5055 signal (SIGINT, handle_sigint);
5060 if (query (_("Interrupted while waiting for the program.\n\
5061 Give up (and stop debugging it)? ")))
5063 remote_unpush_target ();
5068 target_terminal_inferior ();
5071 /* Enable/disable target terminal ownership. Most targets can use
5072 terminal groups to control terminal ownership. Remote targets are
5073 different in that explicit transfer of ownership to/from GDB/target
5077 remote_terminal_inferior (struct target_ops *self)
5079 if (!target_async_permitted)
5080 /* Nothing to do. */
5083 /* FIXME: cagney/1999-09-27: Make calls to target_terminal_*()
5084 idempotent. The event-loop GDB talking to an asynchronous target
5085 with a synchronous command calls this function from both
5086 event-top.c and infrun.c/infcmd.c. Once GDB stops trying to
5087 transfer the terminal to the target when it shouldn't this guard
5089 if (!remote_async_terminal_ours_p)
5091 delete_file_handler (input_fd);
5092 remote_async_terminal_ours_p = 0;
5093 async_initialize_sigint_signal_handler ();
5094 /* NOTE: At this point we could also register our selves as the
5095 recipient of all input. Any characters typed could then be
5096 passed on down to the target. */
5100 remote_terminal_ours (struct target_ops *self)
5102 if (!target_async_permitted)
5103 /* Nothing to do. */
5106 /* See FIXME in remote_terminal_inferior. */
5107 if (remote_async_terminal_ours_p)
5109 async_cleanup_sigint_signal_handler (NULL);
5110 add_file_handler (input_fd, stdin_event_handler, 0);
5111 remote_async_terminal_ours_p = 1;
5115 remote_console_output (char *msg)
5119 for (p = msg; p[0] && p[1]; p += 2)
5122 char c = fromhex (p[0]) * 16 + fromhex (p[1]);
5126 fputs_unfiltered (tb, gdb_stdtarg);
5128 gdb_flush (gdb_stdtarg);
5131 typedef struct cached_reg
5134 gdb_byte data[MAX_REGISTER_SIZE];
5137 DEF_VEC_O(cached_reg_t);
5139 typedef struct stop_reply
5141 struct notif_event base;
5143 /* The identifier of the thread about this event */
5146 /* The remote state this event is associated with. When the remote
5147 connection, represented by a remote_state object, is closed,
5148 all the associated stop_reply events should be released. */
5149 struct remote_state *rs;
5151 struct target_waitstatus ws;
5153 /* Expedited registers. This makes remote debugging a bit more
5154 efficient for those targets that provide critical registers as
5155 part of their normal status mechanism (as another roundtrip to
5156 fetch them is avoided). */
5157 VEC(cached_reg_t) *regcache;
5159 int stopped_by_watchpoint_p;
5160 CORE_ADDR watch_data_address;
5165 DECLARE_QUEUE_P (stop_reply_p);
5166 DEFINE_QUEUE_P (stop_reply_p);
5167 /* The list of already fetched and acknowledged stop events. This
5168 queue is used for notification Stop, and other notifications
5169 don't need queue for their events, because the notification events
5170 of Stop can't be consumed immediately, so that events should be
5171 queued first, and be consumed by remote_wait_{ns,as} one per
5172 time. Other notifications can consume their events immediately,
5173 so queue is not needed for them. */
5174 static QUEUE (stop_reply_p) *stop_reply_queue;
5177 stop_reply_xfree (struct stop_reply *r)
5179 notif_event_xfree ((struct notif_event *) r);
5183 remote_notif_stop_parse (struct notif_client *self, char *buf,
5184 struct notif_event *event)
5186 remote_parse_stop_reply (buf, (struct stop_reply *) event);
5190 remote_notif_stop_ack (struct notif_client *self, char *buf,
5191 struct notif_event *event)
5193 struct stop_reply *stop_reply = (struct stop_reply *) event;
5196 putpkt ((char *) self->ack_command);
5198 if (stop_reply->ws.kind == TARGET_WAITKIND_IGNORE)
5199 /* We got an unknown stop reply. */
5200 error (_("Unknown stop reply"));
5202 push_stop_reply (stop_reply);
5206 remote_notif_stop_can_get_pending_events (struct notif_client *self)
5208 /* We can't get pending events in remote_notif_process for
5209 notification stop, and we have to do this in remote_wait_ns
5210 instead. If we fetch all queued events from stub, remote stub
5211 may exit and we have no chance to process them back in
5213 mark_async_event_handler (remote_async_inferior_event_token);
5218 stop_reply_dtr (struct notif_event *event)
5220 struct stop_reply *r = (struct stop_reply *) event;
5222 VEC_free (cached_reg_t, r->regcache);
5225 static struct notif_event *
5226 remote_notif_stop_alloc_reply (void)
5228 struct notif_event *r
5229 = (struct notif_event *) XNEW (struct stop_reply);
5231 r->dtr = stop_reply_dtr;
5236 /* A client of notification Stop. */
5238 struct notif_client notif_client_stop =
5242 remote_notif_stop_parse,
5243 remote_notif_stop_ack,
5244 remote_notif_stop_can_get_pending_events,
5245 remote_notif_stop_alloc_reply,
5249 /* A parameter to pass data in and out. */
5251 struct queue_iter_param
5254 struct stop_reply *output;
5257 /* Remove stop replies in the queue if its pid is equal to the given
5261 remove_stop_reply_for_inferior (QUEUE (stop_reply_p) *q,
5262 QUEUE_ITER (stop_reply_p) *iter,
5266 struct queue_iter_param *param = data;
5267 struct inferior *inf = param->input;
5269 if (ptid_get_pid (event->ptid) == inf->pid)
5271 stop_reply_xfree (event);
5272 QUEUE_remove_elem (stop_reply_p, q, iter);
5278 /* Discard all pending stop replies of inferior INF. */
5281 discard_pending_stop_replies (struct inferior *inf)
5284 struct queue_iter_param param;
5285 struct stop_reply *reply;
5286 struct remote_state *rs = get_remote_state ();
5287 struct remote_notif_state *rns = rs->notif_state;
5289 /* This function can be notified when an inferior exists. When the
5290 target is not remote, the notification state is NULL. */
5291 if (rs->remote_desc == NULL)
5294 reply = (struct stop_reply *) rns->pending_event[notif_client_stop.id];
5296 /* Discard the in-flight notification. */
5297 if (reply != NULL && ptid_get_pid (reply->ptid) == inf->pid)
5299 stop_reply_xfree (reply);
5300 rns->pending_event[notif_client_stop.id] = NULL;
5304 param.output = NULL;
5305 /* Discard the stop replies we have already pulled with
5307 QUEUE_iterate (stop_reply_p, stop_reply_queue,
5308 remove_stop_reply_for_inferior, ¶m);
5311 /* If its remote state is equal to the given remote state,
5312 remove EVENT from the stop reply queue. */
5315 remove_stop_reply_of_remote_state (QUEUE (stop_reply_p) *q,
5316 QUEUE_ITER (stop_reply_p) *iter,
5320 struct queue_iter_param *param = data;
5321 struct remote_state *rs = param->input;
5323 if (event->rs == rs)
5325 stop_reply_xfree (event);
5326 QUEUE_remove_elem (stop_reply_p, q, iter);
5332 /* Discard the stop replies for RS in stop_reply_queue. */
5335 discard_pending_stop_replies_in_queue (struct remote_state *rs)
5337 struct queue_iter_param param;
5340 param.output = NULL;
5341 /* Discard the stop replies we have already pulled with
5343 QUEUE_iterate (stop_reply_p, stop_reply_queue,
5344 remove_stop_reply_of_remote_state, ¶m);
5347 /* A parameter to pass data in and out. */
5350 remote_notif_remove_once_on_match (QUEUE (stop_reply_p) *q,
5351 QUEUE_ITER (stop_reply_p) *iter,
5355 struct queue_iter_param *param = data;
5356 ptid_t *ptid = param->input;
5358 if (ptid_match (event->ptid, *ptid))
5360 param->output = event;
5361 QUEUE_remove_elem (stop_reply_p, q, iter);
5368 /* Remove the first reply in 'stop_reply_queue' which matches
5371 static struct stop_reply *
5372 remote_notif_remove_queued_reply (ptid_t ptid)
5374 struct queue_iter_param param;
5376 param.input = &ptid;
5377 param.output = NULL;
5379 QUEUE_iterate (stop_reply_p, stop_reply_queue,
5380 remote_notif_remove_once_on_match, ¶m);
5382 fprintf_unfiltered (gdb_stdlog,
5383 "notif: discard queued event: 'Stop' in %s\n",
5384 target_pid_to_str (ptid));
5386 return param.output;
5389 /* Look for a queued stop reply belonging to PTID. If one is found,
5390 remove it from the queue, and return it. Returns NULL if none is
5391 found. If there are still queued events left to process, tell the
5392 event loop to get back to target_wait soon. */
5394 static struct stop_reply *
5395 queued_stop_reply (ptid_t ptid)
5397 struct stop_reply *r = remote_notif_remove_queued_reply (ptid);
5399 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
5400 /* There's still at least an event left. */
5401 mark_async_event_handler (remote_async_inferior_event_token);
5406 /* Push a fully parsed stop reply in the stop reply queue. Since we
5407 know that we now have at least one queued event left to pass to the
5408 core side, tell the event loop to get back to target_wait soon. */
5411 push_stop_reply (struct stop_reply *new_event)
5413 QUEUE_enque (stop_reply_p, stop_reply_queue, new_event);
5416 fprintf_unfiltered (gdb_stdlog,
5417 "notif: push 'Stop' %s to queue %d\n",
5418 target_pid_to_str (new_event->ptid),
5419 QUEUE_length (stop_reply_p,
5422 mark_async_event_handler (remote_async_inferior_event_token);
5426 stop_reply_match_ptid_and_ws (QUEUE (stop_reply_p) *q,
5427 QUEUE_ITER (stop_reply_p) *iter,
5428 struct stop_reply *event,
5431 ptid_t *ptid = data;
5433 return !(ptid_equal (*ptid, event->ptid)
5434 && event->ws.kind == TARGET_WAITKIND_STOPPED);
5437 /* Returns true if we have a stop reply for PTID. */
5440 peek_stop_reply (ptid_t ptid)
5442 return !QUEUE_iterate (stop_reply_p, stop_reply_queue,
5443 stop_reply_match_ptid_and_ws, &ptid);
5446 /* Parse the stop reply in BUF. Either the function succeeds, and the
5447 result is stored in EVENT, or throws an error. */
5450 remote_parse_stop_reply (char *buf, struct stop_reply *event)
5452 struct remote_arch_state *rsa = get_remote_arch_state ();
5456 event->ptid = null_ptid;
5457 event->rs = get_remote_state ();
5458 event->ws.kind = TARGET_WAITKIND_IGNORE;
5459 event->ws.value.integer = 0;
5460 event->stopped_by_watchpoint_p = 0;
5461 event->regcache = NULL;
5466 case 'T': /* Status with PC, SP, FP, ... */
5467 /* Expedited reply, containing Signal, {regno, reg} repeat. */
5468 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
5470 n... = register number
5471 r... = register contents
5474 p = &buf[3]; /* after Txx */
5482 /* If the packet contains a register number, save it in
5483 pnum and set p1 to point to the character following it.
5484 Otherwise p1 points to p. */
5486 /* If this packet is an awatch packet, don't parse the 'a'
5487 as a register number. */
5489 if (strncmp (p, "awatch", strlen("awatch")) != 0
5490 && strncmp (p, "core", strlen ("core") != 0))
5492 /* Read the ``P'' register number. */
5493 pnum = strtol (p, &p_temp, 16);
5499 if (p1 == p) /* No register number present here. */
5501 p1 = strchr (p, ':');
5503 error (_("Malformed packet(a) (missing colon): %s\n\
5506 if (strncmp (p, "thread", p1 - p) == 0)
5507 event->ptid = read_ptid (++p1, &p);
5508 else if ((strncmp (p, "watch", p1 - p) == 0)
5509 || (strncmp (p, "rwatch", p1 - p) == 0)
5510 || (strncmp (p, "awatch", p1 - p) == 0))
5512 event->stopped_by_watchpoint_p = 1;
5513 p = unpack_varlen_hex (++p1, &addr);
5514 event->watch_data_address = (CORE_ADDR) addr;
5516 else if (strncmp (p, "library", p1 - p) == 0)
5520 while (*p_temp && *p_temp != ';')
5523 event->ws.kind = TARGET_WAITKIND_LOADED;
5526 else if (strncmp (p, "replaylog", p1 - p) == 0)
5528 event->ws.kind = TARGET_WAITKIND_NO_HISTORY;
5529 /* p1 will indicate "begin" or "end", but it makes
5530 no difference for now, so ignore it. */
5531 p_temp = strchr (p1 + 1, ';');
5535 else if (strncmp (p, "core", p1 - p) == 0)
5539 p = unpack_varlen_hex (++p1, &c);
5544 /* Silently skip unknown optional info. */
5545 p_temp = strchr (p1 + 1, ';');
5552 struct packet_reg *reg = packet_reg_from_pnum (rsa, pnum);
5553 cached_reg_t cached_reg;
5558 error (_("Malformed packet(b) (missing colon): %s\n\
5564 error (_("Remote sent bad register number %s: %s\n\
5566 hex_string (pnum), p, buf);
5568 cached_reg.num = reg->regnum;
5570 fieldsize = hex2bin (p, cached_reg.data,
5571 register_size (target_gdbarch (),
5574 if (fieldsize < register_size (target_gdbarch (),
5576 warning (_("Remote reply is too short: %s"), buf);
5578 VEC_safe_push (cached_reg_t, event->regcache, &cached_reg);
5582 error (_("Remote register badly formatted: %s\nhere: %s"),
5587 if (event->ws.kind != TARGET_WAITKIND_IGNORE)
5591 case 'S': /* Old style status, just signal only. */
5595 event->ws.kind = TARGET_WAITKIND_STOPPED;
5596 sig = (fromhex (buf[1]) << 4) + fromhex (buf[2]);
5597 if (GDB_SIGNAL_FIRST <= sig && sig < GDB_SIGNAL_LAST)
5598 event->ws.value.sig = (enum gdb_signal) sig;
5600 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
5603 case 'W': /* Target exited. */
5610 /* GDB used to accept only 2 hex chars here. Stubs should
5611 only send more if they detect GDB supports multi-process
5613 p = unpack_varlen_hex (&buf[1], &value);
5617 /* The remote process exited. */
5618 event->ws.kind = TARGET_WAITKIND_EXITED;
5619 event->ws.value.integer = value;
5623 /* The remote process exited with a signal. */
5624 event->ws.kind = TARGET_WAITKIND_SIGNALLED;
5625 if (GDB_SIGNAL_FIRST <= value && value < GDB_SIGNAL_LAST)
5626 event->ws.value.sig = (enum gdb_signal) value;
5628 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
5631 /* If no process is specified, assume inferior_ptid. */
5632 pid = ptid_get_pid (inferior_ptid);
5641 else if (strncmp (p,
5642 "process:", sizeof ("process:") - 1) == 0)
5646 p += sizeof ("process:") - 1;
5647 unpack_varlen_hex (p, &upid);
5651 error (_("unknown stop reply packet: %s"), buf);
5654 error (_("unknown stop reply packet: %s"), buf);
5655 event->ptid = pid_to_ptid (pid);
5660 if (non_stop && ptid_equal (event->ptid, null_ptid))
5661 error (_("No process or thread specified in stop reply: %s"), buf);
5664 /* When the stub wants to tell GDB about a new notification reply, it
5665 sends a notification (%Stop, for example). Those can come it at
5666 any time, hence, we have to make sure that any pending
5667 putpkt/getpkt sequence we're making is finished, before querying
5668 the stub for more events with the corresponding ack command
5669 (vStopped, for example). E.g., if we started a vStopped sequence
5670 immediately upon receiving the notification, something like this
5678 1.6) <-- (registers reply to step #1.3)
5680 Obviously, the reply in step #1.6 would be unexpected to a vStopped
5683 To solve this, whenever we parse a %Stop notification successfully,
5684 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
5685 doing whatever we were doing:
5691 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
5692 2.5) <-- (registers reply to step #2.3)
5694 Eventualy after step #2.5, we return to the event loop, which
5695 notices there's an event on the
5696 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
5697 associated callback --- the function below. At this point, we're
5698 always safe to start a vStopped sequence. :
5701 2.7) <-- T05 thread:2
5707 remote_notif_get_pending_events (struct notif_client *nc)
5709 struct remote_state *rs = get_remote_state ();
5711 if (rs->notif_state->pending_event[nc->id] != NULL)
5714 fprintf_unfiltered (gdb_stdlog,
5715 "notif: process: '%s' ack pending event\n",
5719 nc->ack (nc, rs->buf, rs->notif_state->pending_event[nc->id]);
5720 rs->notif_state->pending_event[nc->id] = NULL;
5724 getpkt (&rs->buf, &rs->buf_size, 0);
5725 if (strcmp (rs->buf, "OK") == 0)
5728 remote_notif_ack (nc, rs->buf);
5734 fprintf_unfiltered (gdb_stdlog,
5735 "notif: process: '%s' no pending reply\n",
5740 /* Called when it is decided that STOP_REPLY holds the info of the
5741 event that is to be returned to the core. This function always
5742 destroys STOP_REPLY. */
5745 process_stop_reply (struct stop_reply *stop_reply,
5746 struct target_waitstatus *status)
5750 *status = stop_reply->ws;
5751 ptid = stop_reply->ptid;
5753 /* If no thread/process was reported by the stub, assume the current
5755 if (ptid_equal (ptid, null_ptid))
5756 ptid = inferior_ptid;
5758 if (status->kind != TARGET_WAITKIND_EXITED
5759 && status->kind != TARGET_WAITKIND_SIGNALLED)
5761 struct remote_state *rs = get_remote_state ();
5763 /* Expedited registers. */
5764 if (stop_reply->regcache)
5766 struct regcache *regcache
5767 = get_thread_arch_regcache (ptid, target_gdbarch ());
5772 VEC_iterate(cached_reg_t, stop_reply->regcache, ix, reg);
5774 regcache_raw_supply (regcache, reg->num, reg->data);
5775 VEC_free (cached_reg_t, stop_reply->regcache);
5778 rs->remote_stopped_by_watchpoint_p = stop_reply->stopped_by_watchpoint_p;
5779 rs->remote_watch_data_address = stop_reply->watch_data_address;
5781 remote_notice_new_inferior (ptid, 0);
5782 demand_private_info (ptid)->core = stop_reply->core;
5785 stop_reply_xfree (stop_reply);
5789 /* The non-stop mode version of target_wait. */
5792 remote_wait_ns (ptid_t ptid, struct target_waitstatus *status, int options)
5794 struct remote_state *rs = get_remote_state ();
5795 struct stop_reply *stop_reply;
5799 /* If in non-stop mode, get out of getpkt even if a
5800 notification is received. */
5802 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
5803 0 /* forever */, &is_notif);
5806 if (ret != -1 && !is_notif)
5809 case 'E': /* Error of some sort. */
5810 /* We're out of sync with the target now. Did it continue
5811 or not? We can't tell which thread it was in non-stop,
5812 so just ignore this. */
5813 warning (_("Remote failure reply: %s"), rs->buf);
5815 case 'O': /* Console output. */
5816 remote_console_output (rs->buf + 1);
5819 warning (_("Invalid remote reply: %s"), rs->buf);
5823 /* Acknowledge a pending stop reply that may have arrived in the
5825 if (rs->notif_state->pending_event[notif_client_stop.id] != NULL)
5826 remote_notif_get_pending_events (¬if_client_stop);
5828 /* If indeed we noticed a stop reply, we're done. */
5829 stop_reply = queued_stop_reply (ptid);
5830 if (stop_reply != NULL)
5831 return process_stop_reply (stop_reply, status);
5833 /* Still no event. If we're just polling for an event, then
5834 return to the event loop. */
5835 if (options & TARGET_WNOHANG)
5837 status->kind = TARGET_WAITKIND_IGNORE;
5838 return minus_one_ptid;
5841 /* Otherwise do a blocking wait. */
5842 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
5843 1 /* forever */, &is_notif);
5847 /* Wait until the remote machine stops, then return, storing status in
5848 STATUS just as `wait' would. */
5851 remote_wait_as (ptid_t ptid, struct target_waitstatus *status, int options)
5853 struct remote_state *rs = get_remote_state ();
5854 ptid_t event_ptid = null_ptid;
5856 struct stop_reply *stop_reply;
5860 status->kind = TARGET_WAITKIND_IGNORE;
5861 status->value.integer = 0;
5863 stop_reply = queued_stop_reply (ptid);
5864 if (stop_reply != NULL)
5865 return process_stop_reply (stop_reply, status);
5867 if (rs->cached_wait_status)
5868 /* Use the cached wait status, but only once. */
5869 rs->cached_wait_status = 0;
5875 if (!target_is_async_p ())
5877 ofunc = signal (SIGINT, sync_remote_interrupt);
5878 /* If the user hit C-c before this packet, or between packets,
5879 pretend that it was hit right here. */
5880 if (check_quit_flag ())
5883 sync_remote_interrupt (SIGINT);
5887 /* FIXME: cagney/1999-09-27: If we're in async mode we should
5888 _never_ wait for ever -> test on target_is_async_p().
5889 However, before we do that we need to ensure that the caller
5890 knows how to take the target into/out of async mode. */
5891 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
5892 wait_forever_enabled_p, &is_notif);
5894 if (!target_is_async_p ())
5895 signal (SIGINT, ofunc);
5897 /* GDB gets a notification. Return to core as this event is
5899 if (ret != -1 && is_notif)
5900 return minus_one_ptid;
5905 rs->remote_stopped_by_watchpoint_p = 0;
5907 /* We got something. */
5908 rs->waiting_for_stop_reply = 0;
5910 /* Assume that the target has acknowledged Ctrl-C unless we receive
5911 an 'F' or 'O' packet. */
5912 if (buf[0] != 'F' && buf[0] != 'O')
5913 rs->ctrlc_pending_p = 0;
5917 case 'E': /* Error of some sort. */
5918 /* We're out of sync with the target now. Did it continue or
5919 not? Not is more likely, so report a stop. */
5920 warning (_("Remote failure reply: %s"), buf);
5921 status->kind = TARGET_WAITKIND_STOPPED;
5922 status->value.sig = GDB_SIGNAL_0;
5924 case 'F': /* File-I/O request. */
5925 remote_fileio_request (buf, rs->ctrlc_pending_p);
5926 rs->ctrlc_pending_p = 0;
5928 case 'T': case 'S': case 'X': case 'W':
5930 struct stop_reply *stop_reply
5931 = (struct stop_reply *) remote_notif_parse (¬if_client_stop,
5934 event_ptid = process_stop_reply (stop_reply, status);
5937 case 'O': /* Console output. */
5938 remote_console_output (buf + 1);
5940 /* The target didn't really stop; keep waiting. */
5941 rs->waiting_for_stop_reply = 1;
5945 if (rs->last_sent_signal != GDB_SIGNAL_0)
5947 /* Zero length reply means that we tried 'S' or 'C' and the
5948 remote system doesn't support it. */
5949 target_terminal_ours_for_output ();
5951 ("Can't send signals to this remote system. %s not sent.\n",
5952 gdb_signal_to_name (rs->last_sent_signal));
5953 rs->last_sent_signal = GDB_SIGNAL_0;
5954 target_terminal_inferior ();
5956 strcpy ((char *) buf, rs->last_sent_step ? "s" : "c");
5957 putpkt ((char *) buf);
5959 /* We just told the target to resume, so a stop reply is in
5961 rs->waiting_for_stop_reply = 1;
5964 /* else fallthrough */
5966 warning (_("Invalid remote reply: %s"), buf);
5968 rs->waiting_for_stop_reply = 1;
5972 if (status->kind == TARGET_WAITKIND_IGNORE)
5974 /* Nothing interesting happened. If we're doing a non-blocking
5975 poll, we're done. Otherwise, go back to waiting. */
5976 if (options & TARGET_WNOHANG)
5977 return minus_one_ptid;
5981 else if (status->kind != TARGET_WAITKIND_EXITED
5982 && status->kind != TARGET_WAITKIND_SIGNALLED)
5984 if (!ptid_equal (event_ptid, null_ptid))
5985 record_currthread (rs, event_ptid);
5987 event_ptid = inferior_ptid;
5990 /* A process exit. Invalidate our notion of current thread. */
5991 record_currthread (rs, minus_one_ptid);
5996 /* Wait until the remote machine stops, then return, storing status in
5997 STATUS just as `wait' would. */
6000 remote_wait (struct target_ops *ops,
6001 ptid_t ptid, struct target_waitstatus *status, int options)
6006 event_ptid = remote_wait_ns (ptid, status, options);
6008 event_ptid = remote_wait_as (ptid, status, options);
6010 if (target_can_async_p ())
6012 /* If there are are events left in the queue tell the event loop
6014 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
6015 mark_async_event_handler (remote_async_inferior_event_token);
6021 /* Fetch a single register using a 'p' packet. */
6024 fetch_register_using_p (struct regcache *regcache, struct packet_reg *reg)
6026 struct remote_state *rs = get_remote_state ();
6028 char regp[MAX_REGISTER_SIZE];
6031 if (packet_support (PACKET_p) == PACKET_DISABLE)
6034 if (reg->pnum == -1)
6039 p += hexnumstr (p, reg->pnum);
6042 getpkt (&rs->buf, &rs->buf_size, 0);
6046 switch (packet_ok (buf, &remote_protocol_packets[PACKET_p]))
6050 case PACKET_UNKNOWN:
6053 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
6054 gdbarch_register_name (get_regcache_arch (regcache),
6059 /* If this register is unfetchable, tell the regcache. */
6062 regcache_raw_supply (regcache, reg->regnum, NULL);
6066 /* Otherwise, parse and supply the value. */
6072 error (_("fetch_register_using_p: early buf termination"));
6074 regp[i++] = fromhex (p[0]) * 16 + fromhex (p[1]);
6077 regcache_raw_supply (regcache, reg->regnum, regp);
6081 /* Fetch the registers included in the target's 'g' packet. */
6084 send_g_packet (void)
6086 struct remote_state *rs = get_remote_state ();
6089 xsnprintf (rs->buf, get_remote_packet_size (), "g");
6090 remote_send (&rs->buf, &rs->buf_size);
6092 /* We can get out of synch in various cases. If the first character
6093 in the buffer is not a hex character, assume that has happened
6094 and try to fetch another packet to read. */
6095 while ((rs->buf[0] < '0' || rs->buf[0] > '9')
6096 && (rs->buf[0] < 'A' || rs->buf[0] > 'F')
6097 && (rs->buf[0] < 'a' || rs->buf[0] > 'f')
6098 && rs->buf[0] != 'x') /* New: unavailable register value. */
6101 fprintf_unfiltered (gdb_stdlog,
6102 "Bad register packet; fetching a new packet\n");
6103 getpkt (&rs->buf, &rs->buf_size, 0);
6106 buf_len = strlen (rs->buf);
6108 /* Sanity check the received packet. */
6109 if (buf_len % 2 != 0)
6110 error (_("Remote 'g' packet reply is of odd length: %s"), rs->buf);
6116 process_g_packet (struct regcache *regcache)
6118 struct gdbarch *gdbarch = get_regcache_arch (regcache);
6119 struct remote_state *rs = get_remote_state ();
6120 struct remote_arch_state *rsa = get_remote_arch_state ();
6125 buf_len = strlen (rs->buf);
6127 /* Further sanity checks, with knowledge of the architecture. */
6128 if (buf_len > 2 * rsa->sizeof_g_packet)
6129 error (_("Remote 'g' packet reply is too long: %s"), rs->buf);
6131 /* Save the size of the packet sent to us by the target. It is used
6132 as a heuristic when determining the max size of packets that the
6133 target can safely receive. */
6134 if (rsa->actual_register_packet_size == 0)
6135 rsa->actual_register_packet_size = buf_len;
6137 /* If this is smaller than we guessed the 'g' packet would be,
6138 update our records. A 'g' reply that doesn't include a register's
6139 value implies either that the register is not available, or that
6140 the 'p' packet must be used. */
6141 if (buf_len < 2 * rsa->sizeof_g_packet)
6143 rsa->sizeof_g_packet = buf_len / 2;
6145 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
6147 if (rsa->regs[i].pnum == -1)
6150 if (rsa->regs[i].offset >= rsa->sizeof_g_packet)
6151 rsa->regs[i].in_g_packet = 0;
6153 rsa->regs[i].in_g_packet = 1;
6157 regs = alloca (rsa->sizeof_g_packet);
6159 /* Unimplemented registers read as all bits zero. */
6160 memset (regs, 0, rsa->sizeof_g_packet);
6162 /* Reply describes registers byte by byte, each byte encoded as two
6163 hex characters. Suck them all up, then supply them to the
6164 register cacheing/storage mechanism. */
6167 for (i = 0; i < rsa->sizeof_g_packet; i++)
6169 if (p[0] == 0 || p[1] == 0)
6170 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
6171 internal_error (__FILE__, __LINE__,
6172 _("unexpected end of 'g' packet reply"));
6174 if (p[0] == 'x' && p[1] == 'x')
6175 regs[i] = 0; /* 'x' */
6177 regs[i] = fromhex (p[0]) * 16 + fromhex (p[1]);
6181 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
6183 struct packet_reg *r = &rsa->regs[i];
6187 if (r->offset * 2 >= strlen (rs->buf))
6188 /* This shouldn't happen - we adjusted in_g_packet above. */
6189 internal_error (__FILE__, __LINE__,
6190 _("unexpected end of 'g' packet reply"));
6191 else if (rs->buf[r->offset * 2] == 'x')
6193 gdb_assert (r->offset * 2 < strlen (rs->buf));
6194 /* The register isn't available, mark it as such (at
6195 the same time setting the value to zero). */
6196 regcache_raw_supply (regcache, r->regnum, NULL);
6199 regcache_raw_supply (regcache, r->regnum,
6206 fetch_registers_using_g (struct regcache *regcache)
6209 process_g_packet (regcache);
6212 /* Make the remote selected traceframe match GDB's selected
6216 set_remote_traceframe (void)
6219 struct remote_state *rs = get_remote_state ();
6221 if (rs->remote_traceframe_number == get_traceframe_number ())
6224 /* Avoid recursion, remote_trace_find calls us again. */
6225 rs->remote_traceframe_number = get_traceframe_number ();
6227 newnum = target_trace_find (tfind_number,
6228 get_traceframe_number (), 0, 0, NULL);
6230 /* Should not happen. If it does, all bets are off. */
6231 if (newnum != get_traceframe_number ())
6232 warning (_("could not set remote traceframe"));
6236 remote_fetch_registers (struct target_ops *ops,
6237 struct regcache *regcache, int regnum)
6239 struct remote_arch_state *rsa = get_remote_arch_state ();
6242 set_remote_traceframe ();
6243 set_general_thread (inferior_ptid);
6247 struct packet_reg *reg = packet_reg_from_regnum (rsa, regnum);
6249 gdb_assert (reg != NULL);
6251 /* If this register might be in the 'g' packet, try that first -
6252 we are likely to read more than one register. If this is the
6253 first 'g' packet, we might be overly optimistic about its
6254 contents, so fall back to 'p'. */
6255 if (reg->in_g_packet)
6257 fetch_registers_using_g (regcache);
6258 if (reg->in_g_packet)
6262 if (fetch_register_using_p (regcache, reg))
6265 /* This register is not available. */
6266 regcache_raw_supply (regcache, reg->regnum, NULL);
6271 fetch_registers_using_g (regcache);
6273 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
6274 if (!rsa->regs[i].in_g_packet)
6275 if (!fetch_register_using_p (regcache, &rsa->regs[i]))
6277 /* This register is not available. */
6278 regcache_raw_supply (regcache, i, NULL);
6282 /* Prepare to store registers. Since we may send them all (using a
6283 'G' request), we have to read out the ones we don't want to change
6287 remote_prepare_to_store (struct target_ops *self, struct regcache *regcache)
6289 struct remote_arch_state *rsa = get_remote_arch_state ();
6291 gdb_byte buf[MAX_REGISTER_SIZE];
6293 /* Make sure the entire registers array is valid. */
6294 switch (packet_support (PACKET_P))
6296 case PACKET_DISABLE:
6297 case PACKET_SUPPORT_UNKNOWN:
6298 /* Make sure all the necessary registers are cached. */
6299 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
6300 if (rsa->regs[i].in_g_packet)
6301 regcache_raw_read (regcache, rsa->regs[i].regnum, buf);
6308 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
6309 packet was not recognized. */
6312 store_register_using_P (const struct regcache *regcache,
6313 struct packet_reg *reg)
6315 struct gdbarch *gdbarch = get_regcache_arch (regcache);
6316 struct remote_state *rs = get_remote_state ();
6317 /* Try storing a single register. */
6318 char *buf = rs->buf;
6319 gdb_byte regp[MAX_REGISTER_SIZE];
6322 if (packet_support (PACKET_P) == PACKET_DISABLE)
6325 if (reg->pnum == -1)
6328 xsnprintf (buf, get_remote_packet_size (), "P%s=", phex_nz (reg->pnum, 0));
6329 p = buf + strlen (buf);
6330 regcache_raw_collect (regcache, reg->regnum, regp);
6331 bin2hex (regp, p, register_size (gdbarch, reg->regnum));
6333 getpkt (&rs->buf, &rs->buf_size, 0);
6335 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_P]))
6340 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
6341 gdbarch_register_name (gdbarch, reg->regnum), rs->buf);
6342 case PACKET_UNKNOWN:
6345 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
6349 /* Store register REGNUM, or all registers if REGNUM == -1, from the
6350 contents of the register cache buffer. FIXME: ignores errors. */
6353 store_registers_using_G (const struct regcache *regcache)
6355 struct remote_state *rs = get_remote_state ();
6356 struct remote_arch_state *rsa = get_remote_arch_state ();
6360 /* Extract all the registers in the regcache copying them into a
6365 regs = alloca (rsa->sizeof_g_packet);
6366 memset (regs, 0, rsa->sizeof_g_packet);
6367 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
6369 struct packet_reg *r = &rsa->regs[i];
6372 regcache_raw_collect (regcache, r->regnum, regs + r->offset);
6376 /* Command describes registers byte by byte,
6377 each byte encoded as two hex characters. */
6380 /* remote_prepare_to_store insures that rsa->sizeof_g_packet gets
6382 bin2hex (regs, p, rsa->sizeof_g_packet);
6384 getpkt (&rs->buf, &rs->buf_size, 0);
6385 if (packet_check_result (rs->buf) == PACKET_ERROR)
6386 error (_("Could not write registers; remote failure reply '%s'"),
6390 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
6391 of the register cache buffer. FIXME: ignores errors. */
6394 remote_store_registers (struct target_ops *ops,
6395 struct regcache *regcache, int regnum)
6397 struct remote_arch_state *rsa = get_remote_arch_state ();
6400 set_remote_traceframe ();
6401 set_general_thread (inferior_ptid);
6405 struct packet_reg *reg = packet_reg_from_regnum (rsa, regnum);
6407 gdb_assert (reg != NULL);
6409 /* Always prefer to store registers using the 'P' packet if
6410 possible; we often change only a small number of registers.
6411 Sometimes we change a larger number; we'd need help from a
6412 higher layer to know to use 'G'. */
6413 if (store_register_using_P (regcache, reg))
6416 /* For now, don't complain if we have no way to write the
6417 register. GDB loses track of unavailable registers too
6418 easily. Some day, this may be an error. We don't have
6419 any way to read the register, either... */
6420 if (!reg->in_g_packet)
6423 store_registers_using_G (regcache);
6427 store_registers_using_G (regcache);
6429 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
6430 if (!rsa->regs[i].in_g_packet)
6431 if (!store_register_using_P (regcache, &rsa->regs[i]))
6432 /* See above for why we do not issue an error here. */
6437 /* Return the number of hex digits in num. */
6440 hexnumlen (ULONGEST num)
6444 for (i = 0; num != 0; i++)
6450 /* Set BUF to the minimum number of hex digits representing NUM. */
6453 hexnumstr (char *buf, ULONGEST num)
6455 int len = hexnumlen (num);
6457 return hexnumnstr (buf, num, len);
6461 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
6464 hexnumnstr (char *buf, ULONGEST num, int width)
6470 for (i = width - 1; i >= 0; i--)
6472 buf[i] = "0123456789abcdef"[(num & 0xf)];
6479 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
6482 remote_address_masked (CORE_ADDR addr)
6484 unsigned int address_size = remote_address_size;
6486 /* If "remoteaddresssize" was not set, default to target address size. */
6488 address_size = gdbarch_addr_bit (target_gdbarch ());
6490 if (address_size > 0
6491 && address_size < (sizeof (ULONGEST) * 8))
6493 /* Only create a mask when that mask can safely be constructed
6494 in a ULONGEST variable. */
6497 mask = (mask << address_size) - 1;
6503 /* Determine whether the remote target supports binary downloading.
6504 This is accomplished by sending a no-op memory write of zero length
6505 to the target at the specified address. It does not suffice to send
6506 the whole packet, since many stubs strip the eighth bit and
6507 subsequently compute a wrong checksum, which causes real havoc with
6510 NOTE: This can still lose if the serial line is not eight-bit
6511 clean. In cases like this, the user should clear "remote
6515 check_binary_download (CORE_ADDR addr)
6517 struct remote_state *rs = get_remote_state ();
6519 switch (packet_support (PACKET_X))
6521 case PACKET_DISABLE:
6525 case PACKET_SUPPORT_UNKNOWN:
6531 p += hexnumstr (p, (ULONGEST) addr);
6533 p += hexnumstr (p, (ULONGEST) 0);
6537 putpkt_binary (rs->buf, (int) (p - rs->buf));
6538 getpkt (&rs->buf, &rs->buf_size, 0);
6540 if (rs->buf[0] == '\0')
6543 fprintf_unfiltered (gdb_stdlog,
6544 "binary downloading NOT "
6545 "supported by target\n");
6546 remote_protocol_packets[PACKET_X].support = PACKET_DISABLE;
6551 fprintf_unfiltered (gdb_stdlog,
6552 "binary downloading supported by target\n");
6553 remote_protocol_packets[PACKET_X].support = PACKET_ENABLE;
6560 /* Write memory data directly to the remote machine.
6561 This does not inform the data cache; the data cache uses this.
6562 HEADER is the starting part of the packet.
6563 MEMADDR is the address in the remote memory space.
6564 MYADDR is the address of the buffer in our space.
6565 LEN is the number of bytes.
6566 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
6567 should send data as binary ('X'), or hex-encoded ('M').
6569 The function creates packet of the form
6570 <HEADER><ADDRESS>,<LENGTH>:<DATA>
6572 where encoding of <DATA> is termined by PACKET_FORMAT.
6574 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
6577 Return the transferred status, error or OK (an
6578 'enum target_xfer_status' value). Save the number of bytes
6579 transferred in *XFERED_LEN. Only transfer a single packet. */
6581 static enum target_xfer_status
6582 remote_write_bytes_aux (const char *header, CORE_ADDR memaddr,
6583 const gdb_byte *myaddr, ULONGEST len,
6584 ULONGEST *xfered_len, char packet_format,
6587 struct remote_state *rs = get_remote_state ();
6597 if (packet_format != 'X' && packet_format != 'M')
6598 internal_error (__FILE__, __LINE__,
6599 _("remote_write_bytes_aux: bad packet format"));
6602 return TARGET_XFER_EOF;
6604 payload_size = get_memory_write_packet_size ();
6606 /* The packet buffer will be large enough for the payload;
6607 get_memory_packet_size ensures this. */
6610 /* Compute the size of the actual payload by subtracting out the
6611 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
6613 payload_size -= strlen ("$,:#NN");
6615 /* The comma won't be used. */
6617 header_length = strlen (header);
6618 payload_size -= header_length;
6619 payload_size -= hexnumlen (memaddr);
6621 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
6623 strcat (rs->buf, header);
6624 p = rs->buf + strlen (header);
6626 /* Compute a best guess of the number of bytes actually transfered. */
6627 if (packet_format == 'X')
6629 /* Best guess at number of bytes that will fit. */
6630 todo = min (len, payload_size);
6632 payload_size -= hexnumlen (todo);
6633 todo = min (todo, payload_size);
6637 /* Num bytes that will fit. */
6638 todo = min (len, payload_size / 2);
6640 payload_size -= hexnumlen (todo);
6641 todo = min (todo, payload_size / 2);
6645 internal_error (__FILE__, __LINE__,
6646 _("minimum packet size too small to write data"));
6648 /* If we already need another packet, then try to align the end
6649 of this packet to a useful boundary. */
6650 if (todo > 2 * REMOTE_ALIGN_WRITES && todo < len)
6651 todo = ((memaddr + todo) & ~(REMOTE_ALIGN_WRITES - 1)) - memaddr;
6653 /* Append "<memaddr>". */
6654 memaddr = remote_address_masked (memaddr);
6655 p += hexnumstr (p, (ULONGEST) memaddr);
6662 /* Append <len>. Retain the location/size of <len>. It may need to
6663 be adjusted once the packet body has been created. */
6665 plenlen = hexnumstr (p, (ULONGEST) todo);
6673 /* Append the packet body. */
6674 if (packet_format == 'X')
6676 /* Binary mode. Send target system values byte by byte, in
6677 increasing byte addresses. Only escape certain critical
6679 payload_length = remote_escape_output (myaddr, todo, (gdb_byte *) p,
6680 &nr_bytes, payload_size);
6682 /* If not all TODO bytes fit, then we'll need another packet. Make
6683 a second try to keep the end of the packet aligned. Don't do
6684 this if the packet is tiny. */
6685 if (nr_bytes < todo && nr_bytes > 2 * REMOTE_ALIGN_WRITES)
6689 new_nr_bytes = (((memaddr + nr_bytes) & ~(REMOTE_ALIGN_WRITES - 1))
6691 if (new_nr_bytes != nr_bytes)
6692 payload_length = remote_escape_output (myaddr, new_nr_bytes,
6693 (gdb_byte *) p, &nr_bytes,
6697 p += payload_length;
6698 if (use_length && nr_bytes < todo)
6700 /* Escape chars have filled up the buffer prematurely,
6701 and we have actually sent fewer bytes than planned.
6702 Fix-up the length field of the packet. Use the same
6703 number of characters as before. */
6704 plen += hexnumnstr (plen, (ULONGEST) nr_bytes, plenlen);
6705 *plen = ':'; /* overwrite \0 from hexnumnstr() */
6710 /* Normal mode: Send target system values byte by byte, in
6711 increasing byte addresses. Each byte is encoded as a two hex
6713 nr_bytes = bin2hex (myaddr, p, todo);
6717 putpkt_binary (rs->buf, (int) (p - rs->buf));
6718 getpkt (&rs->buf, &rs->buf_size, 0);
6720 if (rs->buf[0] == 'E')
6721 return TARGET_XFER_E_IO;
6723 /* Return NR_BYTES, not TODO, in case escape chars caused us to send
6724 fewer bytes than we'd planned. */
6725 *xfered_len = (ULONGEST) nr_bytes;
6726 return TARGET_XFER_OK;
6729 /* Write memory data directly to the remote machine.
6730 This does not inform the data cache; the data cache uses this.
6731 MEMADDR is the address in the remote memory space.
6732 MYADDR is the address of the buffer in our space.
6733 LEN is the number of bytes.
6735 Return the transferred status, error or OK (an
6736 'enum target_xfer_status' value). Save the number of bytes
6737 transferred in *XFERED_LEN. Only transfer a single packet. */
6739 static enum target_xfer_status
6740 remote_write_bytes (CORE_ADDR memaddr, const gdb_byte *myaddr, ULONGEST len,
6741 ULONGEST *xfered_len)
6743 char *packet_format = 0;
6745 /* Check whether the target supports binary download. */
6746 check_binary_download (memaddr);
6748 switch (packet_support (PACKET_X))
6751 packet_format = "X";
6753 case PACKET_DISABLE:
6754 packet_format = "M";
6756 case PACKET_SUPPORT_UNKNOWN:
6757 internal_error (__FILE__, __LINE__,
6758 _("remote_write_bytes: bad internal state"));
6760 internal_error (__FILE__, __LINE__, _("bad switch"));
6763 return remote_write_bytes_aux (packet_format,
6764 memaddr, myaddr, len, xfered_len,
6765 packet_format[0], 1);
6768 /* Read memory data directly from the remote machine.
6769 This does not use the data cache; the data cache uses this.
6770 MEMADDR is the address in the remote memory space.
6771 MYADDR is the address of the buffer in our space.
6772 LEN is the number of bytes.
6774 Return the transferred status, error or OK (an
6775 'enum target_xfer_status' value). Save the number of bytes
6776 transferred in *XFERED_LEN. */
6778 static enum target_xfer_status
6779 remote_read_bytes_1 (CORE_ADDR memaddr, gdb_byte *myaddr, ULONGEST len,
6780 ULONGEST *xfered_len)
6782 struct remote_state *rs = get_remote_state ();
6783 int max_buf_size; /* Max size of packet output buffer. */
6788 max_buf_size = get_memory_read_packet_size ();
6789 /* The packet buffer will be large enough for the payload;
6790 get_memory_packet_size ensures this. */
6792 /* Number if bytes that will fit. */
6793 todo = min (len, max_buf_size / 2);
6795 /* Construct "m"<memaddr>","<len>". */
6796 memaddr = remote_address_masked (memaddr);
6799 p += hexnumstr (p, (ULONGEST) memaddr);
6801 p += hexnumstr (p, (ULONGEST) todo);
6804 getpkt (&rs->buf, &rs->buf_size, 0);
6805 if (rs->buf[0] == 'E'
6806 && isxdigit (rs->buf[1]) && isxdigit (rs->buf[2])
6807 && rs->buf[3] == '\0')
6808 return TARGET_XFER_E_IO;
6809 /* Reply describes memory byte by byte, each byte encoded as two hex
6812 i = hex2bin (p, myaddr, todo);
6813 /* Return what we have. Let higher layers handle partial reads. */
6814 *xfered_len = (ULONGEST) i;
6815 return TARGET_XFER_OK;
6818 /* Using the set of read-only target sections of remote, read live
6821 For interface/parameters/return description see target.h,
6824 static enum target_xfer_status
6825 remote_xfer_live_readonly_partial (struct target_ops *ops, gdb_byte *readbuf,
6826 ULONGEST memaddr, ULONGEST len,
6827 ULONGEST *xfered_len)
6829 struct target_section *secp;
6830 struct target_section_table *table;
6832 secp = target_section_by_addr (ops, memaddr);
6834 && (bfd_get_section_flags (secp->the_bfd_section->owner,
6835 secp->the_bfd_section)
6838 struct target_section *p;
6839 ULONGEST memend = memaddr + len;
6841 table = target_get_section_table (ops);
6843 for (p = table->sections; p < table->sections_end; p++)
6845 if (memaddr >= p->addr)
6847 if (memend <= p->endaddr)
6849 /* Entire transfer is within this section. */
6850 return remote_read_bytes_1 (memaddr, readbuf, len,
6853 else if (memaddr >= p->endaddr)
6855 /* This section ends before the transfer starts. */
6860 /* This section overlaps the transfer. Just do half. */
6861 len = p->endaddr - memaddr;
6862 return remote_read_bytes_1 (memaddr, readbuf, len,
6869 return TARGET_XFER_EOF;
6872 /* Similar to remote_read_bytes_1, but it reads from the remote stub
6873 first if the requested memory is unavailable in traceframe.
6874 Otherwise, fall back to remote_read_bytes_1. */
6876 static enum target_xfer_status
6877 remote_read_bytes (struct target_ops *ops, CORE_ADDR memaddr,
6878 gdb_byte *myaddr, ULONGEST len, ULONGEST *xfered_len)
6881 return TARGET_XFER_EOF;
6883 if (get_traceframe_number () != -1)
6885 VEC(mem_range_s) *available;
6887 /* If we fail to get the set of available memory, then the
6888 target does not support querying traceframe info, and so we
6889 attempt reading from the traceframe anyway (assuming the
6890 target implements the old QTro packet then). */
6891 if (traceframe_available_memory (&available, memaddr, len))
6893 struct cleanup *old_chain;
6895 old_chain = make_cleanup (VEC_cleanup(mem_range_s), &available);
6897 if (VEC_empty (mem_range_s, available)
6898 || VEC_index (mem_range_s, available, 0)->start != memaddr)
6900 enum target_xfer_status res;
6902 /* Don't read into the traceframe's available
6904 if (!VEC_empty (mem_range_s, available))
6906 LONGEST oldlen = len;
6908 len = VEC_index (mem_range_s, available, 0)->start - memaddr;
6909 gdb_assert (len <= oldlen);
6912 do_cleanups (old_chain);
6914 /* This goes through the topmost target again. */
6915 res = remote_xfer_live_readonly_partial (ops, myaddr, memaddr,
6917 if (res == TARGET_XFER_OK)
6918 return TARGET_XFER_OK;
6921 /* No use trying further, we know some memory starting
6922 at MEMADDR isn't available. */
6924 return TARGET_XFER_UNAVAILABLE;
6928 /* Don't try to read more than how much is available, in
6929 case the target implements the deprecated QTro packet to
6930 cater for older GDBs (the target's knowledge of read-only
6931 sections may be outdated by now). */
6932 len = VEC_index (mem_range_s, available, 0)->length;
6934 do_cleanups (old_chain);
6938 return remote_read_bytes_1 (memaddr, myaddr, len, xfered_len);
6943 /* Sends a packet with content determined by the printf format string
6944 FORMAT and the remaining arguments, then gets the reply. Returns
6945 whether the packet was a success, a failure, or unknown. */
6947 static enum packet_result
6948 remote_send_printf (const char *format, ...)
6950 struct remote_state *rs = get_remote_state ();
6951 int max_size = get_remote_packet_size ();
6954 va_start (ap, format);
6957 if (vsnprintf (rs->buf, max_size, format, ap) >= max_size)
6958 internal_error (__FILE__, __LINE__, _("Too long remote packet."));
6960 if (putpkt (rs->buf) < 0)
6961 error (_("Communication problem with target."));
6964 getpkt (&rs->buf, &rs->buf_size, 0);
6966 return packet_check_result (rs->buf);
6970 restore_remote_timeout (void *p)
6972 int value = *(int *)p;
6974 remote_timeout = value;
6977 /* Flash writing can take quite some time. We'll set
6978 effectively infinite timeout for flash operations.
6979 In future, we'll need to decide on a better approach. */
6980 static const int remote_flash_timeout = 1000;
6983 remote_flash_erase (struct target_ops *ops,
6984 ULONGEST address, LONGEST length)
6986 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
6987 int saved_remote_timeout = remote_timeout;
6988 enum packet_result ret;
6989 struct cleanup *back_to = make_cleanup (restore_remote_timeout,
6990 &saved_remote_timeout);
6992 remote_timeout = remote_flash_timeout;
6994 ret = remote_send_printf ("vFlashErase:%s,%s",
6995 phex (address, addr_size),
6999 case PACKET_UNKNOWN:
7000 error (_("Remote target does not support flash erase"));
7002 error (_("Error erasing flash with vFlashErase packet"));
7007 do_cleanups (back_to);
7010 static enum target_xfer_status
7011 remote_flash_write (struct target_ops *ops, ULONGEST address,
7012 ULONGEST length, ULONGEST *xfered_len,
7013 const gdb_byte *data)
7015 int saved_remote_timeout = remote_timeout;
7016 enum target_xfer_status ret;
7017 struct cleanup *back_to = make_cleanup (restore_remote_timeout,
7018 &saved_remote_timeout);
7020 remote_timeout = remote_flash_timeout;
7021 ret = remote_write_bytes_aux ("vFlashWrite:", address, data, length,
7023 do_cleanups (back_to);
7029 remote_flash_done (struct target_ops *ops)
7031 int saved_remote_timeout = remote_timeout;
7033 struct cleanup *back_to = make_cleanup (restore_remote_timeout,
7034 &saved_remote_timeout);
7036 remote_timeout = remote_flash_timeout;
7037 ret = remote_send_printf ("vFlashDone");
7038 do_cleanups (back_to);
7042 case PACKET_UNKNOWN:
7043 error (_("Remote target does not support vFlashDone"));
7045 error (_("Error finishing flash operation"));
7052 remote_files_info (struct target_ops *ignore)
7054 puts_filtered ("Debugging a target over a serial line.\n");
7057 /* Stuff for dealing with the packets which are part of this protocol.
7058 See comment at top of file for details. */
7060 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
7061 error to higher layers. Called when a serial error is detected.
7062 The exception message is STRING, followed by a colon and a blank,
7063 the system error message for errno at function entry and final dot
7064 for output compatibility with throw_perror_with_name. */
7067 unpush_and_perror (const char *string)
7069 int saved_errno = errno;
7071 remote_unpush_target ();
7072 throw_error (TARGET_CLOSE_ERROR, "%s: %s.", string,
7073 safe_strerror (saved_errno));
7076 /* Read a single character from the remote end. */
7079 readchar (int timeout)
7082 struct remote_state *rs = get_remote_state ();
7084 ch = serial_readchar (rs->remote_desc, timeout);
7089 switch ((enum serial_rc) ch)
7092 remote_unpush_target ();
7093 throw_error (TARGET_CLOSE_ERROR, _("Remote connection closed"));
7096 unpush_and_perror (_("Remote communication error. "
7097 "Target disconnected."));
7099 case SERIAL_TIMEOUT:
7105 /* Wrapper for serial_write that closes the target and throws if
7109 remote_serial_write (const char *str, int len)
7111 struct remote_state *rs = get_remote_state ();
7113 if (serial_write (rs->remote_desc, str, len))
7115 unpush_and_perror (_("Remote communication error. "
7116 "Target disconnected."));
7120 /* Send the command in *BUF to the remote machine, and read the reply
7121 into *BUF. Report an error if we get an error reply. Resize
7122 *BUF using xrealloc if necessary to hold the result, and update
7126 remote_send (char **buf,
7130 getpkt (buf, sizeof_buf, 0);
7132 if ((*buf)[0] == 'E')
7133 error (_("Remote failure reply: %s"), *buf);
7136 /* Return a pointer to an xmalloc'ed string representing an escaped
7137 version of BUF, of len N. E.g. \n is converted to \\n, \t to \\t,
7138 etc. The caller is responsible for releasing the returned
7142 escape_buffer (const char *buf, int n)
7144 struct cleanup *old_chain;
7145 struct ui_file *stb;
7148 stb = mem_fileopen ();
7149 old_chain = make_cleanup_ui_file_delete (stb);
7151 fputstrn_unfiltered (buf, n, '\\', stb);
7152 str = ui_file_xstrdup (stb, NULL);
7153 do_cleanups (old_chain);
7157 /* Display a null-terminated packet on stdout, for debugging, using C
7161 print_packet (const char *buf)
7163 puts_filtered ("\"");
7164 fputstr_filtered (buf, '"', gdb_stdout);
7165 puts_filtered ("\"");
7169 putpkt (const char *buf)
7171 return putpkt_binary (buf, strlen (buf));
7174 /* Send a packet to the remote machine, with error checking. The data
7175 of the packet is in BUF. The string in BUF can be at most
7176 get_remote_packet_size () - 5 to account for the $, # and checksum,
7177 and for a possible /0 if we are debugging (remote_debug) and want
7178 to print the sent packet as a string. */
7181 putpkt_binary (const char *buf, int cnt)
7183 struct remote_state *rs = get_remote_state ();
7185 unsigned char csum = 0;
7186 char *buf2 = alloca (cnt + 6);
7193 /* Catch cases like trying to read memory or listing threads while
7194 we're waiting for a stop reply. The remote server wouldn't be
7195 ready to handle this request, so we'd hang and timeout. We don't
7196 have to worry about this in synchronous mode, because in that
7197 case it's not possible to issue a command while the target is
7198 running. This is not a problem in non-stop mode, because in that
7199 case, the stub is always ready to process serial input. */
7200 if (!non_stop && target_can_async_p () && rs->waiting_for_stop_reply)
7202 error (_("Cannot execute this command while the target is running.\n"
7203 "Use the \"interrupt\" command to stop the target\n"
7204 "and then try again."));
7207 /* We're sending out a new packet. Make sure we don't look at a
7208 stale cached response. */
7209 rs->cached_wait_status = 0;
7211 /* Copy the packet into buffer BUF2, encapsulating it
7212 and giving it a checksum. */
7217 for (i = 0; i < cnt; i++)
7223 *p++ = tohex ((csum >> 4) & 0xf);
7224 *p++ = tohex (csum & 0xf);
7226 /* Send it over and over until we get a positive ack. */
7230 int started_error_output = 0;
7234 struct cleanup *old_chain;
7238 str = escape_buffer (buf2, p - buf2);
7239 old_chain = make_cleanup (xfree, str);
7240 fprintf_unfiltered (gdb_stdlog, "Sending packet: %s...", str);
7241 gdb_flush (gdb_stdlog);
7242 do_cleanups (old_chain);
7244 remote_serial_write (buf2, p - buf2);
7246 /* If this is a no acks version of the remote protocol, send the
7247 packet and move on. */
7251 /* Read until either a timeout occurs (-2) or '+' is read.
7252 Handle any notification that arrives in the mean time. */
7255 ch = readchar (remote_timeout);
7263 case SERIAL_TIMEOUT:
7266 if (started_error_output)
7268 putchar_unfiltered ('\n');
7269 started_error_output = 0;
7278 fprintf_unfiltered (gdb_stdlog, "Ack\n");
7282 fprintf_unfiltered (gdb_stdlog, "Nak\n");
7284 case SERIAL_TIMEOUT:
7288 break; /* Retransmit buffer. */
7292 fprintf_unfiltered (gdb_stdlog,
7293 "Packet instead of Ack, ignoring it\n");
7294 /* It's probably an old response sent because an ACK
7295 was lost. Gobble up the packet and ack it so it
7296 doesn't get retransmitted when we resend this
7299 remote_serial_write ("+", 1);
7300 continue; /* Now, go look for +. */
7307 /* If we got a notification, handle it, and go back to looking
7309 /* We've found the start of a notification. Now
7310 collect the data. */
7311 val = read_frame (&rs->buf, &rs->buf_size);
7316 struct cleanup *old_chain;
7319 str = escape_buffer (rs->buf, val);
7320 old_chain = make_cleanup (xfree, str);
7321 fprintf_unfiltered (gdb_stdlog,
7322 " Notification received: %s\n",
7324 do_cleanups (old_chain);
7326 handle_notification (rs->notif_state, rs->buf);
7327 /* We're in sync now, rewait for the ack. */
7334 if (!started_error_output)
7336 started_error_output = 1;
7337 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
7339 fputc_unfiltered (ch & 0177, gdb_stdlog);
7340 fprintf_unfiltered (gdb_stdlog, "%s", rs->buf);
7349 if (!started_error_output)
7351 started_error_output = 1;
7352 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
7354 fputc_unfiltered (ch & 0177, gdb_stdlog);
7358 break; /* Here to retransmit. */
7362 /* This is wrong. If doing a long backtrace, the user should be
7363 able to get out next time we call QUIT, without anything as
7364 violent as interrupt_query. If we want to provide a way out of
7365 here without getting to the next QUIT, it should be based on
7366 hitting ^C twice as in remote_wait. */
7377 /* Come here after finding the start of a frame when we expected an
7378 ack. Do our best to discard the rest of this packet. */
7387 c = readchar (remote_timeout);
7390 case SERIAL_TIMEOUT:
7391 /* Nothing we can do. */
7394 /* Discard the two bytes of checksum and stop. */
7395 c = readchar (remote_timeout);
7397 c = readchar (remote_timeout);
7400 case '*': /* Run length encoding. */
7401 /* Discard the repeat count. */
7402 c = readchar (remote_timeout);
7407 /* A regular character. */
7413 /* Come here after finding the start of the frame. Collect the rest
7414 into *BUF, verifying the checksum, length, and handling run-length
7415 compression. NUL terminate the buffer. If there is not enough room,
7416 expand *BUF using xrealloc.
7418 Returns -1 on error, number of characters in buffer (ignoring the
7419 trailing NULL) on success. (could be extended to return one of the
7420 SERIAL status indications). */
7423 read_frame (char **buf_p,
7430 struct remote_state *rs = get_remote_state ();
7437 c = readchar (remote_timeout);
7440 case SERIAL_TIMEOUT:
7442 fputs_filtered ("Timeout in mid-packet, retrying\n", gdb_stdlog);
7446 fputs_filtered ("Saw new packet start in middle of old one\n",
7448 return -1; /* Start a new packet, count retries. */
7451 unsigned char pktcsum;
7457 check_0 = readchar (remote_timeout);
7459 check_1 = readchar (remote_timeout);
7461 if (check_0 == SERIAL_TIMEOUT || check_1 == SERIAL_TIMEOUT)
7464 fputs_filtered ("Timeout in checksum, retrying\n",
7468 else if (check_0 < 0 || check_1 < 0)
7471 fputs_filtered ("Communication error in checksum\n",
7476 /* Don't recompute the checksum; with no ack packets we
7477 don't have any way to indicate a packet retransmission
7482 pktcsum = (fromhex (check_0) << 4) | fromhex (check_1);
7483 if (csum == pktcsum)
7488 struct cleanup *old_chain;
7491 str = escape_buffer (buf, bc);
7492 old_chain = make_cleanup (xfree, str);
7493 fprintf_unfiltered (gdb_stdlog,
7494 "Bad checksum, sentsum=0x%x, "
7495 "csum=0x%x, buf=%s\n",
7496 pktcsum, csum, str);
7497 do_cleanups (old_chain);
7499 /* Number of characters in buffer ignoring trailing
7503 case '*': /* Run length encoding. */
7508 c = readchar (remote_timeout);
7510 repeat = c - ' ' + 3; /* Compute repeat count. */
7512 /* The character before ``*'' is repeated. */
7514 if (repeat > 0 && repeat <= 255 && bc > 0)
7516 if (bc + repeat - 1 >= *sizeof_buf - 1)
7518 /* Make some more room in the buffer. */
7519 *sizeof_buf += repeat;
7520 *buf_p = xrealloc (*buf_p, *sizeof_buf);
7524 memset (&buf[bc], buf[bc - 1], repeat);
7530 printf_filtered (_("Invalid run length encoding: %s\n"), buf);
7534 if (bc >= *sizeof_buf - 1)
7536 /* Make some more room in the buffer. */
7538 *buf_p = xrealloc (*buf_p, *sizeof_buf);
7549 /* Read a packet from the remote machine, with error checking, and
7550 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
7551 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
7552 rather than timing out; this is used (in synchronous mode) to wait
7553 for a target that is is executing user code to stop. */
7554 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
7555 don't have to change all the calls to getpkt to deal with the
7556 return value, because at the moment I don't know what the right
7557 thing to do it for those. */
7565 timed_out = getpkt_sane (buf, sizeof_buf, forever);
7569 /* Read a packet from the remote machine, with error checking, and
7570 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
7571 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
7572 rather than timing out; this is used (in synchronous mode) to wait
7573 for a target that is is executing user code to stop. If FOREVER ==
7574 0, this function is allowed to time out gracefully and return an
7575 indication of this to the caller. Otherwise return the number of
7576 bytes read. If EXPECTING_NOTIF, consider receiving a notification
7577 enough reason to return to the caller. *IS_NOTIF is an output
7578 boolean that indicates whether *BUF holds a notification or not
7579 (a regular packet). */
7582 getpkt_or_notif_sane_1 (char **buf, long *sizeof_buf, int forever,
7583 int expecting_notif, int *is_notif)
7585 struct remote_state *rs = get_remote_state ();
7591 /* We're reading a new response. Make sure we don't look at a
7592 previously cached response. */
7593 rs->cached_wait_status = 0;
7595 strcpy (*buf, "timeout");
7598 timeout = watchdog > 0 ? watchdog : -1;
7599 else if (expecting_notif)
7600 timeout = 0; /* There should already be a char in the buffer. If
7603 timeout = remote_timeout;
7607 /* Process any number of notifications, and then return when
7611 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
7613 for (tries = 1; tries <= MAX_TRIES; tries++)
7615 /* This can loop forever if the remote side sends us
7616 characters continuously, but if it pauses, we'll get
7617 SERIAL_TIMEOUT from readchar because of timeout. Then
7618 we'll count that as a retry.
7620 Note that even when forever is set, we will only wait
7621 forever prior to the start of a packet. After that, we
7622 expect characters to arrive at a brisk pace. They should
7623 show up within remote_timeout intervals. */
7625 c = readchar (timeout);
7626 while (c != SERIAL_TIMEOUT && c != '$' && c != '%');
7628 if (c == SERIAL_TIMEOUT)
7630 if (expecting_notif)
7631 return -1; /* Don't complain, it's normal to not get
7632 anything in this case. */
7634 if (forever) /* Watchdog went off? Kill the target. */
7637 remote_unpush_target ();
7638 throw_error (TARGET_CLOSE_ERROR,
7639 _("Watchdog timeout has expired. "
7640 "Target detached."));
7643 fputs_filtered ("Timed out.\n", gdb_stdlog);
7647 /* We've found the start of a packet or notification.
7648 Now collect the data. */
7649 val = read_frame (buf, sizeof_buf);
7654 remote_serial_write ("-", 1);
7657 if (tries > MAX_TRIES)
7659 /* We have tried hard enough, and just can't receive the
7660 packet/notification. Give up. */
7661 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
7663 /* Skip the ack char if we're in no-ack mode. */
7664 if (!rs->noack_mode)
7665 remote_serial_write ("+", 1);
7669 /* If we got an ordinary packet, return that to our caller. */
7674 struct cleanup *old_chain;
7677 str = escape_buffer (*buf, val);
7678 old_chain = make_cleanup (xfree, str);
7679 fprintf_unfiltered (gdb_stdlog, "Packet received: %s\n", str);
7680 do_cleanups (old_chain);
7683 /* Skip the ack char if we're in no-ack mode. */
7684 if (!rs->noack_mode)
7685 remote_serial_write ("+", 1);
7686 if (is_notif != NULL)
7691 /* If we got a notification, handle it, and go back to looking
7695 gdb_assert (c == '%');
7699 struct cleanup *old_chain;
7702 str = escape_buffer (*buf, val);
7703 old_chain = make_cleanup (xfree, str);
7704 fprintf_unfiltered (gdb_stdlog,
7705 " Notification received: %s\n",
7707 do_cleanups (old_chain);
7709 if (is_notif != NULL)
7712 handle_notification (rs->notif_state, *buf);
7714 /* Notifications require no acknowledgement. */
7716 if (expecting_notif)
7723 getpkt_sane (char **buf, long *sizeof_buf, int forever)
7725 return getpkt_or_notif_sane_1 (buf, sizeof_buf, forever, 0, NULL);
7729 getpkt_or_notif_sane (char **buf, long *sizeof_buf, int forever,
7732 return getpkt_or_notif_sane_1 (buf, sizeof_buf, forever, 1,
7738 remote_kill (struct target_ops *ops)
7740 volatile struct gdb_exception ex;
7742 /* Catch errors so the user can quit from gdb even when we
7743 aren't on speaking terms with the remote system. */
7744 TRY_CATCH (ex, RETURN_MASK_ERROR)
7750 if (ex.error == TARGET_CLOSE_ERROR)
7752 /* If we got an (EOF) error that caused the target
7753 to go away, then we're done, that's what we wanted.
7754 "k" is susceptible to cause a premature EOF, given
7755 that the remote server isn't actually required to
7756 reply to "k", and it can happen that it doesn't
7757 even get to reply ACK to the "k". */
7761 /* Otherwise, something went wrong. We didn't actually kill
7762 the target. Just propagate the exception, and let the
7763 user or higher layers decide what to do. */
7764 throw_exception (ex);
7767 /* We've killed the remote end, we get to mourn it. Since this is
7768 target remote, single-process, mourning the inferior also
7769 unpushes remote_ops. */
7770 target_mourn_inferior ();
7774 remote_vkill (int pid, struct remote_state *rs)
7776 if (packet_support (PACKET_vKill) == PACKET_DISABLE)
7779 /* Tell the remote target to detach. */
7780 xsnprintf (rs->buf, get_remote_packet_size (), "vKill;%x", pid);
7782 getpkt (&rs->buf, &rs->buf_size, 0);
7784 switch (packet_ok (rs->buf,
7785 &remote_protocol_packets[PACKET_vKill]))
7791 case PACKET_UNKNOWN:
7794 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
7799 extended_remote_kill (struct target_ops *ops)
7802 int pid = ptid_get_pid (inferior_ptid);
7803 struct remote_state *rs = get_remote_state ();
7805 res = remote_vkill (pid, rs);
7806 if (res == -1 && !(rs->extended && remote_multi_process_p (rs)))
7808 /* Don't try 'k' on a multi-process aware stub -- it has no way
7809 to specify the pid. */
7813 getpkt (&rs->buf, &rs->buf_size, 0);
7814 if (rs->buf[0] != 'O' || rs->buf[0] != 'K')
7817 /* Don't wait for it to die. I'm not really sure it matters whether
7818 we do or not. For the existing stubs, kill is a noop. */
7824 error (_("Can't kill process"));
7826 target_mourn_inferior ();
7830 remote_mourn (struct target_ops *ops)
7832 remote_mourn_1 (ops);
7835 /* Worker function for remote_mourn. */
7837 remote_mourn_1 (struct target_ops *target)
7839 unpush_target (target);
7841 /* remote_close takes care of doing most of the clean up. */
7842 generic_mourn_inferior ();
7846 extended_remote_mourn_1 (struct target_ops *target)
7848 struct remote_state *rs = get_remote_state ();
7850 /* In case we got here due to an error, but we're going to stay
7852 rs->waiting_for_stop_reply = 0;
7854 /* If the current general thread belonged to the process we just
7855 detached from or has exited, the remote side current general
7856 thread becomes undefined. Considering a case like this:
7858 - We just got here due to a detach.
7859 - The process that we're detaching from happens to immediately
7860 report a global breakpoint being hit in non-stop mode, in the
7861 same thread we had selected before.
7862 - GDB attaches to this process again.
7863 - This event happens to be the next event we handle.
7865 GDB would consider that the current general thread didn't need to
7866 be set on the stub side (with Hg), since for all it knew,
7867 GENERAL_THREAD hadn't changed.
7869 Notice that although in all-stop mode, the remote server always
7870 sets the current thread to the thread reporting the stop event,
7871 that doesn't happen in non-stop mode; in non-stop, the stub *must
7872 not* change the current thread when reporting a breakpoint hit,
7873 due to the decoupling of event reporting and event handling.
7875 To keep things simple, we always invalidate our notion of the
7877 record_currthread (rs, minus_one_ptid);
7879 /* Unlike "target remote", we do not want to unpush the target; then
7880 the next time the user says "run", we won't be connected. */
7882 /* Call common code to mark the inferior as not running. */
7883 generic_mourn_inferior ();
7885 if (!have_inferiors ())
7887 if (!remote_multi_process_p (rs))
7889 /* Check whether the target is running now - some remote stubs
7890 automatically restart after kill. */
7892 getpkt (&rs->buf, &rs->buf_size, 0);
7894 if (rs->buf[0] == 'S' || rs->buf[0] == 'T')
7896 /* Assume that the target has been restarted. Set
7897 inferior_ptid so that bits of core GDB realizes
7898 there's something here, e.g., so that the user can
7899 say "kill" again. */
7900 inferior_ptid = magic_null_ptid;
7907 extended_remote_mourn (struct target_ops *ops)
7909 extended_remote_mourn_1 (ops);
7913 extended_remote_supports_disable_randomization (struct target_ops *self)
7915 return packet_support (PACKET_QDisableRandomization) == PACKET_ENABLE;
7919 extended_remote_disable_randomization (int val)
7921 struct remote_state *rs = get_remote_state ();
7924 xsnprintf (rs->buf, get_remote_packet_size (), "QDisableRandomization:%x",
7927 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
7929 error (_("Target does not support QDisableRandomization."));
7930 if (strcmp (reply, "OK") != 0)
7931 error (_("Bogus QDisableRandomization reply from target: %s"), reply);
7935 extended_remote_run (char *args)
7937 struct remote_state *rs = get_remote_state ();
7940 /* If the user has disabled vRun support, or we have detected that
7941 support is not available, do not try it. */
7942 if (packet_support (PACKET_vRun) == PACKET_DISABLE)
7945 strcpy (rs->buf, "vRun;");
7946 len = strlen (rs->buf);
7948 if (strlen (remote_exec_file) * 2 + len >= get_remote_packet_size ())
7949 error (_("Remote file name too long for run packet"));
7950 len += 2 * bin2hex ((gdb_byte *) remote_exec_file, rs->buf + len,
7951 strlen (remote_exec_file));
7953 gdb_assert (args != NULL);
7956 struct cleanup *back_to;
7960 argv = gdb_buildargv (args);
7961 back_to = make_cleanup_freeargv (argv);
7962 for (i = 0; argv[i] != NULL; i++)
7964 if (strlen (argv[i]) * 2 + 1 + len >= get_remote_packet_size ())
7965 error (_("Argument list too long for run packet"));
7966 rs->buf[len++] = ';';
7967 len += 2 * bin2hex ((gdb_byte *) argv[i], rs->buf + len,
7970 do_cleanups (back_to);
7973 rs->buf[len++] = '\0';
7976 getpkt (&rs->buf, &rs->buf_size, 0);
7978 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_vRun]))
7981 /* We have a wait response. All is well. */
7983 case PACKET_UNKNOWN:
7986 if (remote_exec_file[0] == '\0')
7987 error (_("Running the default executable on the remote target failed; "
7988 "try \"set remote exec-file\"?"));
7990 error (_("Running \"%s\" on the remote target failed"),
7993 gdb_assert_not_reached (_("bad switch"));
7997 /* In the extended protocol we want to be able to do things like
7998 "run" and have them basically work as expected. So we need
7999 a special create_inferior function. We support changing the
8000 executable file and the command line arguments, but not the
8004 extended_remote_create_inferior (struct target_ops *ops,
8005 char *exec_file, char *args,
8006 char **env, int from_tty)
8010 struct remote_state *rs = get_remote_state ();
8012 /* If running asynchronously, register the target file descriptor
8013 with the event loop. */
8014 if (target_can_async_p ())
8015 target_async (inferior_event_handler, 0);
8017 /* Disable address space randomization if requested (and supported). */
8018 if (extended_remote_supports_disable_randomization (ops))
8019 extended_remote_disable_randomization (disable_randomization);
8021 /* Now restart the remote server. */
8022 run_worked = extended_remote_run (args) != -1;
8025 /* vRun was not supported. Fail if we need it to do what the
8027 if (remote_exec_file[0])
8028 error (_("Remote target does not support \"set remote exec-file\""));
8030 error (_("Remote target does not support \"set args\" or run <ARGS>"));
8032 /* Fall back to "R". */
8033 extended_remote_restart ();
8036 if (!have_inferiors ())
8038 /* Clean up from the last time we ran, before we mark the target
8039 running again. This will mark breakpoints uninserted, and
8040 get_offsets may insert breakpoints. */
8041 init_thread_list ();
8042 init_wait_for_inferior ();
8045 /* vRun's success return is a stop reply. */
8046 stop_reply = run_worked ? rs->buf : NULL;
8047 add_current_inferior_and_thread (stop_reply);
8049 /* Get updated offsets, if the stub uses qOffsets. */
8054 /* Given a location's target info BP_TGT and the packet buffer BUF, output
8055 the list of conditions (in agent expression bytecode format), if any, the
8056 target needs to evaluate. The output is placed into the packet buffer
8057 started from BUF and ended at BUF_END. */
8060 remote_add_target_side_condition (struct gdbarch *gdbarch,
8061 struct bp_target_info *bp_tgt, char *buf,
8064 struct agent_expr *aexpr = NULL;
8067 char *buf_start = buf;
8069 if (VEC_empty (agent_expr_p, bp_tgt->conditions))
8072 buf += strlen (buf);
8073 xsnprintf (buf, buf_end - buf, "%s", ";");
8076 /* Send conditions to the target and free the vector. */
8078 VEC_iterate (agent_expr_p, bp_tgt->conditions, ix, aexpr);
8081 xsnprintf (buf, buf_end - buf, "X%x,", aexpr->len);
8082 buf += strlen (buf);
8083 for (i = 0; i < aexpr->len; ++i)
8084 buf = pack_hex_byte (buf, aexpr->buf[i]);
8091 remote_add_target_side_commands (struct gdbarch *gdbarch,
8092 struct bp_target_info *bp_tgt, char *buf)
8094 struct agent_expr *aexpr = NULL;
8097 if (VEC_empty (agent_expr_p, bp_tgt->tcommands))
8100 buf += strlen (buf);
8102 sprintf (buf, ";cmds:%x,", bp_tgt->persist);
8103 buf += strlen (buf);
8105 /* Concatenate all the agent expressions that are commands into the
8108 VEC_iterate (agent_expr_p, bp_tgt->tcommands, ix, aexpr);
8111 sprintf (buf, "X%x,", aexpr->len);
8112 buf += strlen (buf);
8113 for (i = 0; i < aexpr->len; ++i)
8114 buf = pack_hex_byte (buf, aexpr->buf[i]);
8119 /* Insert a breakpoint. On targets that have software breakpoint
8120 support, we ask the remote target to do the work; on targets
8121 which don't, we insert a traditional memory breakpoint. */
8124 remote_insert_breakpoint (struct target_ops *ops,
8125 struct gdbarch *gdbarch,
8126 struct bp_target_info *bp_tgt)
8128 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
8129 If it succeeds, then set the support to PACKET_ENABLE. If it
8130 fails, and the user has explicitly requested the Z support then
8131 report an error, otherwise, mark it disabled and go on. */
8133 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
8135 CORE_ADDR addr = bp_tgt->reqstd_address;
8136 struct remote_state *rs;
8139 struct condition_list *cond = NULL;
8141 /* Make sure the remote is pointing at the right process, if
8143 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8144 set_general_process ();
8146 gdbarch_remote_breakpoint_from_pc (gdbarch, &addr, &bpsize);
8148 rs = get_remote_state ();
8150 endbuf = rs->buf + get_remote_packet_size ();
8155 addr = (ULONGEST) remote_address_masked (addr);
8156 p += hexnumstr (p, addr);
8157 xsnprintf (p, endbuf - p, ",%d", bpsize);
8159 if (remote_supports_cond_breakpoints (ops))
8160 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
8162 if (remote_can_run_breakpoint_commands (ops))
8163 remote_add_target_side_commands (gdbarch, bp_tgt, p);
8166 getpkt (&rs->buf, &rs->buf_size, 0);
8168 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0]))
8173 bp_tgt->placed_address = addr;
8174 bp_tgt->placed_size = bpsize;
8176 case PACKET_UNKNOWN:
8181 /* If this breakpoint has target-side commands but this stub doesn't
8182 support Z0 packets, throw error. */
8183 if (!VEC_empty (agent_expr_p, bp_tgt->tcommands))
8184 throw_error (NOT_SUPPORTED_ERROR, _("\
8185 Target doesn't support breakpoints that have target side commands."));
8187 return memory_insert_breakpoint (ops, gdbarch, bp_tgt);
8191 remote_remove_breakpoint (struct target_ops *ops,
8192 struct gdbarch *gdbarch,
8193 struct bp_target_info *bp_tgt)
8195 CORE_ADDR addr = bp_tgt->placed_address;
8196 struct remote_state *rs = get_remote_state ();
8198 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
8201 char *endbuf = rs->buf + get_remote_packet_size ();
8203 /* Make sure the remote is pointing at the right process, if
8205 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8206 set_general_process ();
8212 addr = (ULONGEST) remote_address_masked (bp_tgt->placed_address);
8213 p += hexnumstr (p, addr);
8214 xsnprintf (p, endbuf - p, ",%d", bp_tgt->placed_size);
8217 getpkt (&rs->buf, &rs->buf_size, 0);
8219 return (rs->buf[0] == 'E');
8222 return memory_remove_breakpoint (ops, gdbarch, bp_tgt);
8226 watchpoint_to_Z_packet (int type)
8231 return Z_PACKET_WRITE_WP;
8234 return Z_PACKET_READ_WP;
8237 return Z_PACKET_ACCESS_WP;
8240 internal_error (__FILE__, __LINE__,
8241 _("hw_bp_to_z: bad watchpoint type %d"), type);
8246 remote_insert_watchpoint (struct target_ops *self,
8247 CORE_ADDR addr, int len, int type,
8248 struct expression *cond)
8250 struct remote_state *rs = get_remote_state ();
8251 char *endbuf = rs->buf + get_remote_packet_size ();
8253 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
8255 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
8258 /* Make sure the remote is pointing at the right process, if
8260 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8261 set_general_process ();
8263 xsnprintf (rs->buf, endbuf - rs->buf, "Z%x,", packet);
8264 p = strchr (rs->buf, '\0');
8265 addr = remote_address_masked (addr);
8266 p += hexnumstr (p, (ULONGEST) addr);
8267 xsnprintf (p, endbuf - p, ",%x", len);
8270 getpkt (&rs->buf, &rs->buf_size, 0);
8272 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
8276 case PACKET_UNKNOWN:
8281 internal_error (__FILE__, __LINE__,
8282 _("remote_insert_watchpoint: reached end of function"));
8286 remote_watchpoint_addr_within_range (struct target_ops *target, CORE_ADDR addr,
8287 CORE_ADDR start, int length)
8289 CORE_ADDR diff = remote_address_masked (addr - start);
8291 return diff < length;
8296 remote_remove_watchpoint (struct target_ops *self,
8297 CORE_ADDR addr, int len, int type,
8298 struct expression *cond)
8300 struct remote_state *rs = get_remote_state ();
8301 char *endbuf = rs->buf + get_remote_packet_size ();
8303 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
8305 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
8308 /* Make sure the remote is pointing at the right process, if
8310 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8311 set_general_process ();
8313 xsnprintf (rs->buf, endbuf - rs->buf, "z%x,", packet);
8314 p = strchr (rs->buf, '\0');
8315 addr = remote_address_masked (addr);
8316 p += hexnumstr (p, (ULONGEST) addr);
8317 xsnprintf (p, endbuf - p, ",%x", len);
8319 getpkt (&rs->buf, &rs->buf_size, 0);
8321 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
8324 case PACKET_UNKNOWN:
8329 internal_error (__FILE__, __LINE__,
8330 _("remote_remove_watchpoint: reached end of function"));
8334 int remote_hw_watchpoint_limit = -1;
8335 int remote_hw_watchpoint_length_limit = -1;
8336 int remote_hw_breakpoint_limit = -1;
8339 remote_region_ok_for_hw_watchpoint (struct target_ops *self,
8340 CORE_ADDR addr, int len)
8342 if (remote_hw_watchpoint_length_limit == 0)
8344 else if (remote_hw_watchpoint_length_limit < 0)
8346 else if (len <= remote_hw_watchpoint_length_limit)
8353 remote_check_watch_resources (struct target_ops *self,
8354 int type, int cnt, int ot)
8356 if (type == bp_hardware_breakpoint)
8358 if (remote_hw_breakpoint_limit == 0)
8360 else if (remote_hw_breakpoint_limit < 0)
8362 else if (cnt <= remote_hw_breakpoint_limit)
8367 if (remote_hw_watchpoint_limit == 0)
8369 else if (remote_hw_watchpoint_limit < 0)
8373 else if (cnt <= remote_hw_watchpoint_limit)
8380 remote_stopped_by_watchpoint (struct target_ops *ops)
8382 struct remote_state *rs = get_remote_state ();
8384 return rs->remote_stopped_by_watchpoint_p;
8388 remote_stopped_data_address (struct target_ops *target, CORE_ADDR *addr_p)
8390 struct remote_state *rs = get_remote_state ();
8393 if (remote_stopped_by_watchpoint (target))
8395 *addr_p = rs->remote_watch_data_address;
8404 remote_insert_hw_breakpoint (struct target_ops *self, struct gdbarch *gdbarch,
8405 struct bp_target_info *bp_tgt)
8407 CORE_ADDR addr = bp_tgt->reqstd_address;
8408 struct remote_state *rs;
8413 /* The length field should be set to the size of a breakpoint
8414 instruction, even though we aren't inserting one ourselves. */
8416 gdbarch_remote_breakpoint_from_pc (gdbarch, &addr, &bpsize);
8418 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
8421 /* Make sure the remote is pointing at the right process, if
8423 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8424 set_general_process ();
8426 rs = get_remote_state ();
8428 endbuf = rs->buf + get_remote_packet_size ();
8434 addr = remote_address_masked (addr);
8435 p += hexnumstr (p, (ULONGEST) addr);
8436 xsnprintf (p, endbuf - p, ",%x", bpsize);
8438 if (remote_supports_cond_breakpoints (self))
8439 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
8441 if (remote_can_run_breakpoint_commands (self))
8442 remote_add_target_side_commands (gdbarch, bp_tgt, p);
8445 getpkt (&rs->buf, &rs->buf_size, 0);
8447 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
8450 if (rs->buf[1] == '.')
8452 message = strchr (rs->buf + 2, '.');
8454 error (_("Remote failure reply: %s"), message + 1);
8457 case PACKET_UNKNOWN:
8460 bp_tgt->placed_address = addr;
8461 bp_tgt->placed_size = bpsize;
8464 internal_error (__FILE__, __LINE__,
8465 _("remote_insert_hw_breakpoint: reached end of function"));
8470 remote_remove_hw_breakpoint (struct target_ops *self, struct gdbarch *gdbarch,
8471 struct bp_target_info *bp_tgt)
8474 struct remote_state *rs = get_remote_state ();
8476 char *endbuf = rs->buf + get_remote_packet_size ();
8478 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
8481 /* Make sure the remote is pointing at the right process, if
8483 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8484 set_general_process ();
8490 addr = remote_address_masked (bp_tgt->placed_address);
8491 p += hexnumstr (p, (ULONGEST) addr);
8492 xsnprintf (p, endbuf - p, ",%x", bp_tgt->placed_size);
8495 getpkt (&rs->buf, &rs->buf_size, 0);
8497 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
8500 case PACKET_UNKNOWN:
8505 internal_error (__FILE__, __LINE__,
8506 _("remote_remove_hw_breakpoint: reached end of function"));
8509 /* Verify memory using the "qCRC:" request. */
8512 remote_verify_memory (struct target_ops *ops,
8513 const gdb_byte *data, CORE_ADDR lma, ULONGEST size)
8515 struct remote_state *rs = get_remote_state ();
8516 unsigned long host_crc, target_crc;
8519 /* It doesn't make sense to use qCRC if the remote target is
8520 connected but not running. */
8521 if (target_has_execution && packet_support (PACKET_qCRC) != PACKET_DISABLE)
8523 enum packet_result result;
8525 /* Make sure the remote is pointing at the right process. */
8526 set_general_process ();
8528 /* FIXME: assumes lma can fit into long. */
8529 xsnprintf (rs->buf, get_remote_packet_size (), "qCRC:%lx,%lx",
8530 (long) lma, (long) size);
8533 /* Be clever; compute the host_crc before waiting for target
8535 host_crc = xcrc32 (data, size, 0xffffffff);
8537 getpkt (&rs->buf, &rs->buf_size, 0);
8539 result = packet_ok (rs->buf,
8540 &remote_protocol_packets[PACKET_qCRC]);
8541 if (result == PACKET_ERROR)
8543 else if (result == PACKET_OK)
8545 for (target_crc = 0, tmp = &rs->buf[1]; *tmp; tmp++)
8546 target_crc = target_crc * 16 + fromhex (*tmp);
8548 return (host_crc == target_crc);
8552 return simple_verify_memory (ops, data, lma, size);
8555 /* compare-sections command
8557 With no arguments, compares each loadable section in the exec bfd
8558 with the same memory range on the target, and reports mismatches.
8559 Useful for verifying the image on the target against the exec file. */
8562 compare_sections_command (char *args, int from_tty)
8565 struct cleanup *old_chain;
8567 const char *sectname;
8576 error (_("command cannot be used without an exec file"));
8578 /* Make sure the remote is pointing at the right process. */
8579 set_general_process ();
8581 if (args != NULL && strcmp (args, "-r") == 0)
8587 for (s = exec_bfd->sections; s; s = s->next)
8589 if (!(s->flags & SEC_LOAD))
8590 continue; /* Skip non-loadable section. */
8592 if (read_only && (s->flags & SEC_READONLY) == 0)
8593 continue; /* Skip writeable sections */
8595 size = bfd_get_section_size (s);
8597 continue; /* Skip zero-length section. */
8599 sectname = bfd_get_section_name (exec_bfd, s);
8600 if (args && strcmp (args, sectname) != 0)
8601 continue; /* Not the section selected by user. */
8603 matched = 1; /* Do this section. */
8606 sectdata = xmalloc (size);
8607 old_chain = make_cleanup (xfree, sectdata);
8608 bfd_get_section_contents (exec_bfd, s, sectdata, 0, size);
8610 res = target_verify_memory (sectdata, lma, size);
8613 error (_("target memory fault, section %s, range %s -- %s"), sectname,
8614 paddress (target_gdbarch (), lma),
8615 paddress (target_gdbarch (), lma + size));
8617 printf_filtered ("Section %s, range %s -- %s: ", sectname,
8618 paddress (target_gdbarch (), lma),
8619 paddress (target_gdbarch (), lma + size));
8621 printf_filtered ("matched.\n");
8624 printf_filtered ("MIS-MATCHED!\n");
8628 do_cleanups (old_chain);
8631 warning (_("One or more sections of the target image does not match\n\
8632 the loaded file\n"));
8633 if (args && !matched)
8634 printf_filtered (_("No loaded section named '%s'.\n"), args);
8637 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
8638 into remote target. The number of bytes written to the remote
8639 target is returned, or -1 for error. */
8641 static enum target_xfer_status
8642 remote_write_qxfer (struct target_ops *ops, const char *object_name,
8643 const char *annex, const gdb_byte *writebuf,
8644 ULONGEST offset, LONGEST len, ULONGEST *xfered_len,
8645 struct packet_config *packet)
8649 struct remote_state *rs = get_remote_state ();
8650 int max_size = get_memory_write_packet_size ();
8652 if (packet->support == PACKET_DISABLE)
8653 return TARGET_XFER_E_IO;
8655 /* Insert header. */
8656 i = snprintf (rs->buf, max_size,
8657 "qXfer:%s:write:%s:%s:",
8658 object_name, annex ? annex : "",
8659 phex_nz (offset, sizeof offset));
8660 max_size -= (i + 1);
8662 /* Escape as much data as fits into rs->buf. */
8663 buf_len = remote_escape_output
8664 (writebuf, len, (gdb_byte *) rs->buf + i, &max_size, max_size);
8666 if (putpkt_binary (rs->buf, i + buf_len) < 0
8667 || getpkt_sane (&rs->buf, &rs->buf_size, 0) < 0
8668 || packet_ok (rs->buf, packet) != PACKET_OK)
8669 return TARGET_XFER_E_IO;
8671 unpack_varlen_hex (rs->buf, &n);
8674 return TARGET_XFER_OK;
8677 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
8678 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
8679 number of bytes read is returned, or 0 for EOF, or -1 for error.
8680 The number of bytes read may be less than LEN without indicating an
8681 EOF. PACKET is checked and updated to indicate whether the remote
8682 target supports this object. */
8684 static enum target_xfer_status
8685 remote_read_qxfer (struct target_ops *ops, const char *object_name,
8687 gdb_byte *readbuf, ULONGEST offset, LONGEST len,
8688 ULONGEST *xfered_len,
8689 struct packet_config *packet)
8691 struct remote_state *rs = get_remote_state ();
8692 LONGEST i, n, packet_len;
8694 if (packet->support == PACKET_DISABLE)
8695 return TARGET_XFER_E_IO;
8697 /* Check whether we've cached an end-of-object packet that matches
8699 if (rs->finished_object)
8701 if (strcmp (object_name, rs->finished_object) == 0
8702 && strcmp (annex ? annex : "", rs->finished_annex) == 0
8703 && offset == rs->finished_offset)
8704 return TARGET_XFER_EOF;
8707 /* Otherwise, we're now reading something different. Discard
8709 xfree (rs->finished_object);
8710 xfree (rs->finished_annex);
8711 rs->finished_object = NULL;
8712 rs->finished_annex = NULL;
8715 /* Request only enough to fit in a single packet. The actual data
8716 may not, since we don't know how much of it will need to be escaped;
8717 the target is free to respond with slightly less data. We subtract
8718 five to account for the response type and the protocol frame. */
8719 n = min (get_remote_packet_size () - 5, len);
8720 snprintf (rs->buf, get_remote_packet_size () - 4, "qXfer:%s:read:%s:%s,%s",
8721 object_name, annex ? annex : "",
8722 phex_nz (offset, sizeof offset),
8723 phex_nz (n, sizeof n));
8724 i = putpkt (rs->buf);
8726 return TARGET_XFER_E_IO;
8729 packet_len = getpkt_sane (&rs->buf, &rs->buf_size, 0);
8730 if (packet_len < 0 || packet_ok (rs->buf, packet) != PACKET_OK)
8731 return TARGET_XFER_E_IO;
8733 if (rs->buf[0] != 'l' && rs->buf[0] != 'm')
8734 error (_("Unknown remote qXfer reply: %s"), rs->buf);
8736 /* 'm' means there is (or at least might be) more data after this
8737 batch. That does not make sense unless there's at least one byte
8738 of data in this reply. */
8739 if (rs->buf[0] == 'm' && packet_len == 1)
8740 error (_("Remote qXfer reply contained no data."));
8742 /* Got some data. */
8743 i = remote_unescape_input ((gdb_byte *) rs->buf + 1,
8744 packet_len - 1, readbuf, n);
8746 /* 'l' is an EOF marker, possibly including a final block of data,
8747 or possibly empty. If we have the final block of a non-empty
8748 object, record this fact to bypass a subsequent partial read. */
8749 if (rs->buf[0] == 'l' && offset + i > 0)
8751 rs->finished_object = xstrdup (object_name);
8752 rs->finished_annex = xstrdup (annex ? annex : "");
8753 rs->finished_offset = offset + i;
8757 return TARGET_XFER_EOF;
8761 return TARGET_XFER_OK;
8765 static enum target_xfer_status
8766 remote_xfer_partial (struct target_ops *ops, enum target_object object,
8767 const char *annex, gdb_byte *readbuf,
8768 const gdb_byte *writebuf, ULONGEST offset, ULONGEST len,
8769 ULONGEST *xfered_len)
8771 struct remote_state *rs;
8776 set_remote_traceframe ();
8777 set_general_thread (inferior_ptid);
8779 rs = get_remote_state ();
8781 /* Handle memory using the standard memory routines. */
8782 if (object == TARGET_OBJECT_MEMORY)
8784 /* If the remote target is connected but not running, we should
8785 pass this request down to a lower stratum (e.g. the executable
8787 if (!target_has_execution)
8788 return TARGET_XFER_EOF;
8790 if (writebuf != NULL)
8791 return remote_write_bytes (offset, writebuf, len, xfered_len);
8793 return remote_read_bytes (ops, offset, readbuf, len, xfered_len);
8796 /* Handle SPU memory using qxfer packets. */
8797 if (object == TARGET_OBJECT_SPU)
8800 return remote_read_qxfer (ops, "spu", annex, readbuf, offset, len,
8801 xfered_len, &remote_protocol_packets
8802 [PACKET_qXfer_spu_read]);
8804 return remote_write_qxfer (ops, "spu", annex, writebuf, offset, len,
8805 xfered_len, &remote_protocol_packets
8806 [PACKET_qXfer_spu_write]);
8809 /* Handle extra signal info using qxfer packets. */
8810 if (object == TARGET_OBJECT_SIGNAL_INFO)
8813 return remote_read_qxfer (ops, "siginfo", annex, readbuf, offset, len,
8814 xfered_len, &remote_protocol_packets
8815 [PACKET_qXfer_siginfo_read]);
8817 return remote_write_qxfer (ops, "siginfo", annex,
8818 writebuf, offset, len, xfered_len,
8819 &remote_protocol_packets
8820 [PACKET_qXfer_siginfo_write]);
8823 if (object == TARGET_OBJECT_STATIC_TRACE_DATA)
8826 return remote_read_qxfer (ops, "statictrace", annex,
8827 readbuf, offset, len, xfered_len,
8828 &remote_protocol_packets
8829 [PACKET_qXfer_statictrace_read]);
8831 return TARGET_XFER_E_IO;
8834 /* Only handle flash writes. */
8835 if (writebuf != NULL)
8841 case TARGET_OBJECT_FLASH:
8842 return remote_flash_write (ops, offset, len, xfered_len,
8846 return TARGET_XFER_E_IO;
8850 /* Map pre-existing objects onto letters. DO NOT do this for new
8851 objects!!! Instead specify new query packets. */
8854 case TARGET_OBJECT_AVR:
8858 case TARGET_OBJECT_AUXV:
8859 gdb_assert (annex == NULL);
8860 return remote_read_qxfer (ops, "auxv", annex, readbuf, offset, len,
8862 &remote_protocol_packets[PACKET_qXfer_auxv]);
8864 case TARGET_OBJECT_AVAILABLE_FEATURES:
8865 return remote_read_qxfer
8866 (ops, "features", annex, readbuf, offset, len, xfered_len,
8867 &remote_protocol_packets[PACKET_qXfer_features]);
8869 case TARGET_OBJECT_LIBRARIES:
8870 return remote_read_qxfer
8871 (ops, "libraries", annex, readbuf, offset, len, xfered_len,
8872 &remote_protocol_packets[PACKET_qXfer_libraries]);
8874 case TARGET_OBJECT_LIBRARIES_SVR4:
8875 return remote_read_qxfer
8876 (ops, "libraries-svr4", annex, readbuf, offset, len, xfered_len,
8877 &remote_protocol_packets[PACKET_qXfer_libraries_svr4]);
8879 case TARGET_OBJECT_MEMORY_MAP:
8880 gdb_assert (annex == NULL);
8881 return remote_read_qxfer (ops, "memory-map", annex, readbuf, offset, len,
8883 &remote_protocol_packets[PACKET_qXfer_memory_map]);
8885 case TARGET_OBJECT_OSDATA:
8886 /* Should only get here if we're connected. */
8887 gdb_assert (rs->remote_desc);
8888 return remote_read_qxfer
8889 (ops, "osdata", annex, readbuf, offset, len, xfered_len,
8890 &remote_protocol_packets[PACKET_qXfer_osdata]);
8892 case TARGET_OBJECT_THREADS:
8893 gdb_assert (annex == NULL);
8894 return remote_read_qxfer (ops, "threads", annex, readbuf, offset, len,
8896 &remote_protocol_packets[PACKET_qXfer_threads]);
8898 case TARGET_OBJECT_TRACEFRAME_INFO:
8899 gdb_assert (annex == NULL);
8900 return remote_read_qxfer
8901 (ops, "traceframe-info", annex, readbuf, offset, len, xfered_len,
8902 &remote_protocol_packets[PACKET_qXfer_traceframe_info]);
8904 case TARGET_OBJECT_FDPIC:
8905 return remote_read_qxfer (ops, "fdpic", annex, readbuf, offset, len,
8907 &remote_protocol_packets[PACKET_qXfer_fdpic]);
8909 case TARGET_OBJECT_OPENVMS_UIB:
8910 return remote_read_qxfer (ops, "uib", annex, readbuf, offset, len,
8912 &remote_protocol_packets[PACKET_qXfer_uib]);
8914 case TARGET_OBJECT_BTRACE:
8915 return remote_read_qxfer (ops, "btrace", annex, readbuf, offset, len,
8917 &remote_protocol_packets[PACKET_qXfer_btrace]);
8920 return TARGET_XFER_E_IO;
8923 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
8924 large enough let the caller deal with it. */
8925 if (len < get_remote_packet_size ())
8926 return TARGET_XFER_E_IO;
8927 len = get_remote_packet_size ();
8929 /* Except for querying the minimum buffer size, target must be open. */
8930 if (!rs->remote_desc)
8931 error (_("remote query is only available after target open"));
8933 gdb_assert (annex != NULL);
8934 gdb_assert (readbuf != NULL);
8940 /* We used one buffer char for the remote protocol q command and
8941 another for the query type. As the remote protocol encapsulation
8942 uses 4 chars plus one extra in case we are debugging
8943 (remote_debug), we have PBUFZIZ - 7 left to pack the query
8946 while (annex[i] && (i < (get_remote_packet_size () - 8)))
8948 /* Bad caller may have sent forbidden characters. */
8949 gdb_assert (isprint (annex[i]) && annex[i] != '$' && annex[i] != '#');
8954 gdb_assert (annex[i] == '\0');
8956 i = putpkt (rs->buf);
8958 return TARGET_XFER_E_IO;
8960 getpkt (&rs->buf, &rs->buf_size, 0);
8961 strcpy ((char *) readbuf, rs->buf);
8963 *xfered_len = strlen ((char *) readbuf);
8964 return TARGET_XFER_OK;
8968 remote_search_memory (struct target_ops* ops,
8969 CORE_ADDR start_addr, ULONGEST search_space_len,
8970 const gdb_byte *pattern, ULONGEST pattern_len,
8971 CORE_ADDR *found_addrp)
8973 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
8974 struct remote_state *rs = get_remote_state ();
8975 int max_size = get_memory_write_packet_size ();
8976 struct packet_config *packet =
8977 &remote_protocol_packets[PACKET_qSearch_memory];
8978 /* Number of packet bytes used to encode the pattern;
8979 this could be more than PATTERN_LEN due to escape characters. */
8980 int escaped_pattern_len;
8981 /* Amount of pattern that was encodable in the packet. */
8982 int used_pattern_len;
8985 ULONGEST found_addr;
8987 /* Don't go to the target if we don't have to.
8988 This is done before checking packet->support to avoid the possibility that
8989 a success for this edge case means the facility works in general. */
8990 if (pattern_len > search_space_len)
8992 if (pattern_len == 0)
8994 *found_addrp = start_addr;
8998 /* If we already know the packet isn't supported, fall back to the simple
8999 way of searching memory. */
9001 if (packet_config_support (packet) == PACKET_DISABLE)
9003 /* Target doesn't provided special support, fall back and use the
9004 standard support (copy memory and do the search here). */
9005 return simple_search_memory (ops, start_addr, search_space_len,
9006 pattern, pattern_len, found_addrp);
9009 /* Make sure the remote is pointing at the right process. */
9010 set_general_process ();
9012 /* Insert header. */
9013 i = snprintf (rs->buf, max_size,
9014 "qSearch:memory:%s;%s;",
9015 phex_nz (start_addr, addr_size),
9016 phex_nz (search_space_len, sizeof (search_space_len)));
9017 max_size -= (i + 1);
9019 /* Escape as much data as fits into rs->buf. */
9020 escaped_pattern_len =
9021 remote_escape_output (pattern, pattern_len, (gdb_byte *) rs->buf + i,
9022 &used_pattern_len, max_size);
9024 /* Bail if the pattern is too large. */
9025 if (used_pattern_len != pattern_len)
9026 error (_("Pattern is too large to transmit to remote target."));
9028 if (putpkt_binary (rs->buf, i + escaped_pattern_len) < 0
9029 || getpkt_sane (&rs->buf, &rs->buf_size, 0) < 0
9030 || packet_ok (rs->buf, packet) != PACKET_OK)
9032 /* The request may not have worked because the command is not
9033 supported. If so, fall back to the simple way. */
9034 if (packet->support == PACKET_DISABLE)
9036 return simple_search_memory (ops, start_addr, search_space_len,
9037 pattern, pattern_len, found_addrp);
9042 if (rs->buf[0] == '0')
9044 else if (rs->buf[0] == '1')
9047 if (rs->buf[1] != ',')
9048 error (_("Unknown qSearch:memory reply: %s"), rs->buf);
9049 unpack_varlen_hex (rs->buf + 2, &found_addr);
9050 *found_addrp = found_addr;
9053 error (_("Unknown qSearch:memory reply: %s"), rs->buf);
9059 remote_rcmd (struct target_ops *self, const char *command,
9060 struct ui_file *outbuf)
9062 struct remote_state *rs = get_remote_state ();
9065 if (!rs->remote_desc)
9066 error (_("remote rcmd is only available after target open"));
9068 /* Send a NULL command across as an empty command. */
9069 if (command == NULL)
9072 /* The query prefix. */
9073 strcpy (rs->buf, "qRcmd,");
9074 p = strchr (rs->buf, '\0');
9076 if ((strlen (rs->buf) + strlen (command) * 2 + 8/*misc*/)
9077 > get_remote_packet_size ())
9078 error (_("\"monitor\" command ``%s'' is too long."), command);
9080 /* Encode the actual command. */
9081 bin2hex ((const gdb_byte *) command, p, strlen (command));
9083 if (putpkt (rs->buf) < 0)
9084 error (_("Communication problem with target."));
9086 /* get/display the response */
9091 /* XXX - see also remote_get_noisy_reply(). */
9092 QUIT; /* Allow user to bail out with ^C. */
9094 if (getpkt_sane (&rs->buf, &rs->buf_size, 0) == -1)
9096 /* Timeout. Continue to (try to) read responses.
9097 This is better than stopping with an error, assuming the stub
9098 is still executing the (long) monitor command.
9099 If needed, the user can interrupt gdb using C-c, obtaining
9100 an effect similar to stop on timeout. */
9105 error (_("Target does not support this command."));
9106 if (buf[0] == 'O' && buf[1] != 'K')
9108 remote_console_output (buf + 1); /* 'O' message from stub. */
9111 if (strcmp (buf, "OK") == 0)
9113 if (strlen (buf) == 3 && buf[0] == 'E'
9114 && isdigit (buf[1]) && isdigit (buf[2]))
9116 error (_("Protocol error with Rcmd"));
9118 for (p = buf; p[0] != '\0' && p[1] != '\0'; p += 2)
9120 char c = (fromhex (p[0]) << 4) + fromhex (p[1]);
9122 fputc_unfiltered (c, outbuf);
9128 static VEC(mem_region_s) *
9129 remote_memory_map (struct target_ops *ops)
9131 VEC(mem_region_s) *result = NULL;
9132 char *text = target_read_stralloc (¤t_target,
9133 TARGET_OBJECT_MEMORY_MAP, NULL);
9137 struct cleanup *back_to = make_cleanup (xfree, text);
9139 result = parse_memory_map (text);
9140 do_cleanups (back_to);
9147 packet_command (char *args, int from_tty)
9149 struct remote_state *rs = get_remote_state ();
9151 if (!rs->remote_desc)
9152 error (_("command can only be used with remote target"));
9155 error (_("remote-packet command requires packet text as argument"));
9157 puts_filtered ("sending: ");
9158 print_packet (args);
9159 puts_filtered ("\n");
9162 getpkt (&rs->buf, &rs->buf_size, 0);
9163 puts_filtered ("received: ");
9164 print_packet (rs->buf);
9165 puts_filtered ("\n");
9169 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
9171 static void display_thread_info (struct gdb_ext_thread_info *info);
9173 static void threadset_test_cmd (char *cmd, int tty);
9175 static void threadalive_test (char *cmd, int tty);
9177 static void threadlist_test_cmd (char *cmd, int tty);
9179 int get_and_display_threadinfo (threadref *ref);
9181 static void threadinfo_test_cmd (char *cmd, int tty);
9183 static int thread_display_step (threadref *ref, void *context);
9185 static void threadlist_update_test_cmd (char *cmd, int tty);
9187 static void init_remote_threadtests (void);
9189 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
9192 threadset_test_cmd (char *cmd, int tty)
9194 int sample_thread = SAMPLE_THREAD;
9196 printf_filtered (_("Remote threadset test\n"));
9197 set_general_thread (sample_thread);
9202 threadalive_test (char *cmd, int tty)
9204 int sample_thread = SAMPLE_THREAD;
9205 int pid = ptid_get_pid (inferior_ptid);
9206 ptid_t ptid = ptid_build (pid, sample_thread, 0);
9208 if (remote_thread_alive (ptid))
9209 printf_filtered ("PASS: Thread alive test\n");
9211 printf_filtered ("FAIL: Thread alive test\n");
9214 void output_threadid (char *title, threadref *ref);
9217 output_threadid (char *title, threadref *ref)
9221 pack_threadid (&hexid[0], ref); /* Convert threead id into hex. */
9223 printf_filtered ("%s %s\n", title, (&hexid[0]));
9227 threadlist_test_cmd (char *cmd, int tty)
9230 threadref nextthread;
9231 int done, result_count;
9232 threadref threadlist[3];
9234 printf_filtered ("Remote Threadlist test\n");
9235 if (!remote_get_threadlist (startflag, &nextthread, 3, &done,
9236 &result_count, &threadlist[0]))
9237 printf_filtered ("FAIL: threadlist test\n");
9240 threadref *scan = threadlist;
9241 threadref *limit = scan + result_count;
9243 while (scan < limit)
9244 output_threadid (" thread ", scan++);
9249 display_thread_info (struct gdb_ext_thread_info *info)
9251 output_threadid ("Threadid: ", &info->threadid);
9252 printf_filtered ("Name: %s\n ", info->shortname);
9253 printf_filtered ("State: %s\n", info->display);
9254 printf_filtered ("other: %s\n\n", info->more_display);
9258 get_and_display_threadinfo (threadref *ref)
9262 struct gdb_ext_thread_info threadinfo;
9264 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
9265 | TAG_MOREDISPLAY | TAG_DISPLAY;
9266 if (0 != (result = remote_get_threadinfo (ref, set, &threadinfo)))
9267 display_thread_info (&threadinfo);
9272 threadinfo_test_cmd (char *cmd, int tty)
9274 int athread = SAMPLE_THREAD;
9278 int_to_threadref (&thread, athread);
9279 printf_filtered ("Remote Threadinfo test\n");
9280 if (!get_and_display_threadinfo (&thread))
9281 printf_filtered ("FAIL cannot get thread info\n");
9285 thread_display_step (threadref *ref, void *context)
9287 /* output_threadid(" threadstep ",ref); *//* simple test */
9288 return get_and_display_threadinfo (ref);
9292 threadlist_update_test_cmd (char *cmd, int tty)
9294 printf_filtered ("Remote Threadlist update test\n");
9295 remote_threadlist_iterator (thread_display_step, 0, CRAZY_MAX_THREADS);
9299 init_remote_threadtests (void)
9301 add_com ("tlist", class_obscure, threadlist_test_cmd,
9302 _("Fetch and print the remote list of "
9303 "thread identifiers, one pkt only"));
9304 add_com ("tinfo", class_obscure, threadinfo_test_cmd,
9305 _("Fetch and display info about one thread"));
9306 add_com ("tset", class_obscure, threadset_test_cmd,
9307 _("Test setting to a different thread"));
9308 add_com ("tupd", class_obscure, threadlist_update_test_cmd,
9309 _("Iterate through updating all remote thread info"));
9310 add_com ("talive", class_obscure, threadalive_test,
9311 _(" Remote thread alive test "));
9316 /* Convert a thread ID to a string. Returns the string in a static
9320 remote_pid_to_str (struct target_ops *ops, ptid_t ptid)
9322 static char buf[64];
9323 struct remote_state *rs = get_remote_state ();
9325 if (ptid_equal (ptid, null_ptid))
9326 return normal_pid_to_str (ptid);
9327 else if (ptid_is_pid (ptid))
9329 /* Printing an inferior target id. */
9331 /* When multi-process extensions are off, there's no way in the
9332 remote protocol to know the remote process id, if there's any
9333 at all. There's one exception --- when we're connected with
9334 target extended-remote, and we manually attached to a process
9335 with "attach PID". We don't record anywhere a flag that
9336 allows us to distinguish that case from the case of
9337 connecting with extended-remote and the stub already being
9338 attached to a process, and reporting yes to qAttached, hence
9339 no smart special casing here. */
9340 if (!remote_multi_process_p (rs))
9342 xsnprintf (buf, sizeof buf, "Remote target");
9346 return normal_pid_to_str (ptid);
9350 if (ptid_equal (magic_null_ptid, ptid))
9351 xsnprintf (buf, sizeof buf, "Thread <main>");
9352 else if (rs->extended && remote_multi_process_p (rs))
9353 xsnprintf (buf, sizeof buf, "Thread %d.%ld",
9354 ptid_get_pid (ptid), ptid_get_lwp (ptid));
9356 xsnprintf (buf, sizeof buf, "Thread %ld",
9357 ptid_get_lwp (ptid));
9362 /* Get the address of the thread local variable in OBJFILE which is
9363 stored at OFFSET within the thread local storage for thread PTID. */
9366 remote_get_thread_local_address (struct target_ops *ops,
9367 ptid_t ptid, CORE_ADDR lm, CORE_ADDR offset)
9369 if (packet_support (PACKET_qGetTLSAddr) != PACKET_DISABLE)
9371 struct remote_state *rs = get_remote_state ();
9373 char *endp = rs->buf + get_remote_packet_size ();
9374 enum packet_result result;
9376 strcpy (p, "qGetTLSAddr:");
9378 p = write_ptid (p, endp, ptid);
9380 p += hexnumstr (p, offset);
9382 p += hexnumstr (p, lm);
9386 getpkt (&rs->buf, &rs->buf_size, 0);
9387 result = packet_ok (rs->buf,
9388 &remote_protocol_packets[PACKET_qGetTLSAddr]);
9389 if (result == PACKET_OK)
9393 unpack_varlen_hex (rs->buf, &result);
9396 else if (result == PACKET_UNKNOWN)
9397 throw_error (TLS_GENERIC_ERROR,
9398 _("Remote target doesn't support qGetTLSAddr packet"));
9400 throw_error (TLS_GENERIC_ERROR,
9401 _("Remote target failed to process qGetTLSAddr request"));
9404 throw_error (TLS_GENERIC_ERROR,
9405 _("TLS not supported or disabled on this target"));
9410 /* Provide thread local base, i.e. Thread Information Block address.
9411 Returns 1 if ptid is found and thread_local_base is non zero. */
9414 remote_get_tib_address (struct target_ops *self, ptid_t ptid, CORE_ADDR *addr)
9416 if (packet_support (PACKET_qGetTIBAddr) != PACKET_DISABLE)
9418 struct remote_state *rs = get_remote_state ();
9420 char *endp = rs->buf + get_remote_packet_size ();
9421 enum packet_result result;
9423 strcpy (p, "qGetTIBAddr:");
9425 p = write_ptid (p, endp, ptid);
9429 getpkt (&rs->buf, &rs->buf_size, 0);
9430 result = packet_ok (rs->buf,
9431 &remote_protocol_packets[PACKET_qGetTIBAddr]);
9432 if (result == PACKET_OK)
9436 unpack_varlen_hex (rs->buf, &result);
9438 *addr = (CORE_ADDR) result;
9441 else if (result == PACKET_UNKNOWN)
9442 error (_("Remote target doesn't support qGetTIBAddr packet"));
9444 error (_("Remote target failed to process qGetTIBAddr request"));
9447 error (_("qGetTIBAddr not supported or disabled on this target"));
9452 /* Support for inferring a target description based on the current
9453 architecture and the size of a 'g' packet. While the 'g' packet
9454 can have any size (since optional registers can be left off the
9455 end), some sizes are easily recognizable given knowledge of the
9456 approximate architecture. */
9458 struct remote_g_packet_guess
9461 const struct target_desc *tdesc;
9463 typedef struct remote_g_packet_guess remote_g_packet_guess_s;
9464 DEF_VEC_O(remote_g_packet_guess_s);
9466 struct remote_g_packet_data
9468 VEC(remote_g_packet_guess_s) *guesses;
9471 static struct gdbarch_data *remote_g_packet_data_handle;
9474 remote_g_packet_data_init (struct obstack *obstack)
9476 return OBSTACK_ZALLOC (obstack, struct remote_g_packet_data);
9480 register_remote_g_packet_guess (struct gdbarch *gdbarch, int bytes,
9481 const struct target_desc *tdesc)
9483 struct remote_g_packet_data *data
9484 = gdbarch_data (gdbarch, remote_g_packet_data_handle);
9485 struct remote_g_packet_guess new_guess, *guess;
9488 gdb_assert (tdesc != NULL);
9491 VEC_iterate (remote_g_packet_guess_s, data->guesses, ix, guess);
9493 if (guess->bytes == bytes)
9494 internal_error (__FILE__, __LINE__,
9495 _("Duplicate g packet description added for size %d"),
9498 new_guess.bytes = bytes;
9499 new_guess.tdesc = tdesc;
9500 VEC_safe_push (remote_g_packet_guess_s, data->guesses, &new_guess);
9503 /* Return 1 if remote_read_description would do anything on this target
9504 and architecture, 0 otherwise. */
9507 remote_read_description_p (struct target_ops *target)
9509 struct remote_g_packet_data *data
9510 = gdbarch_data (target_gdbarch (), remote_g_packet_data_handle);
9512 if (!VEC_empty (remote_g_packet_guess_s, data->guesses))
9518 static const struct target_desc *
9519 remote_read_description (struct target_ops *target)
9521 struct remote_g_packet_data *data
9522 = gdbarch_data (target_gdbarch (), remote_g_packet_data_handle);
9524 /* Do not try this during initial connection, when we do not know
9525 whether there is a running but stopped thread. */
9526 if (!target_has_execution || ptid_equal (inferior_ptid, null_ptid))
9527 return target->beneath->to_read_description (target->beneath);
9529 if (!VEC_empty (remote_g_packet_guess_s, data->guesses))
9531 struct remote_g_packet_guess *guess;
9533 int bytes = send_g_packet ();
9536 VEC_iterate (remote_g_packet_guess_s, data->guesses, ix, guess);
9538 if (guess->bytes == bytes)
9539 return guess->tdesc;
9541 /* We discard the g packet. A minor optimization would be to
9542 hold on to it, and fill the register cache once we have selected
9543 an architecture, but it's too tricky to do safely. */
9546 return target->beneath->to_read_description (target->beneath);
9549 /* Remote file transfer support. This is host-initiated I/O, not
9550 target-initiated; for target-initiated, see remote-fileio.c. */
9552 /* If *LEFT is at least the length of STRING, copy STRING to
9553 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9554 decrease *LEFT. Otherwise raise an error. */
9557 remote_buffer_add_string (char **buffer, int *left, char *string)
9559 int len = strlen (string);
9562 error (_("Packet too long for target."));
9564 memcpy (*buffer, string, len);
9568 /* NUL-terminate the buffer as a convenience, if there is
9574 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
9575 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9576 decrease *LEFT. Otherwise raise an error. */
9579 remote_buffer_add_bytes (char **buffer, int *left, const gdb_byte *bytes,
9582 if (2 * len > *left)
9583 error (_("Packet too long for target."));
9585 bin2hex (bytes, *buffer, len);
9589 /* NUL-terminate the buffer as a convenience, if there is
9595 /* If *LEFT is large enough, convert VALUE to hex and add it to
9596 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9597 decrease *LEFT. Otherwise raise an error. */
9600 remote_buffer_add_int (char **buffer, int *left, ULONGEST value)
9602 int len = hexnumlen (value);
9605 error (_("Packet too long for target."));
9607 hexnumstr (*buffer, value);
9611 /* NUL-terminate the buffer as a convenience, if there is
9617 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
9618 value, *REMOTE_ERRNO to the remote error number or zero if none
9619 was included, and *ATTACHMENT to point to the start of the annex
9620 if any. The length of the packet isn't needed here; there may
9621 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
9623 Return 0 if the packet could be parsed, -1 if it could not. If
9624 -1 is returned, the other variables may not be initialized. */
9627 remote_hostio_parse_result (char *buffer, int *retcode,
9628 int *remote_errno, char **attachment)
9635 if (buffer[0] != 'F')
9639 *retcode = strtol (&buffer[1], &p, 16);
9640 if (errno != 0 || p == &buffer[1])
9643 /* Check for ",errno". */
9647 *remote_errno = strtol (p + 1, &p2, 16);
9648 if (errno != 0 || p + 1 == p2)
9653 /* Check for ";attachment". If there is no attachment, the
9654 packet should end here. */
9657 *attachment = p + 1;
9660 else if (*p == '\0')
9666 /* Send a prepared I/O packet to the target and read its response.
9667 The prepared packet is in the global RS->BUF before this function
9668 is called, and the answer is there when we return.
9670 COMMAND_BYTES is the length of the request to send, which may include
9671 binary data. WHICH_PACKET is the packet configuration to check
9672 before attempting a packet. If an error occurs, *REMOTE_ERRNO
9673 is set to the error number and -1 is returned. Otherwise the value
9674 returned by the function is returned.
9676 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
9677 attachment is expected; an error will be reported if there's a
9678 mismatch. If one is found, *ATTACHMENT will be set to point into
9679 the packet buffer and *ATTACHMENT_LEN will be set to the
9680 attachment's length. */
9683 remote_hostio_send_command (int command_bytes, int which_packet,
9684 int *remote_errno, char **attachment,
9685 int *attachment_len)
9687 struct remote_state *rs = get_remote_state ();
9688 int ret, bytes_read;
9689 char *attachment_tmp;
9691 if (!rs->remote_desc
9692 || packet_support (which_packet) == PACKET_DISABLE)
9694 *remote_errno = FILEIO_ENOSYS;
9698 putpkt_binary (rs->buf, command_bytes);
9699 bytes_read = getpkt_sane (&rs->buf, &rs->buf_size, 0);
9701 /* If it timed out, something is wrong. Don't try to parse the
9705 *remote_errno = FILEIO_EINVAL;
9709 switch (packet_ok (rs->buf, &remote_protocol_packets[which_packet]))
9712 *remote_errno = FILEIO_EINVAL;
9714 case PACKET_UNKNOWN:
9715 *remote_errno = FILEIO_ENOSYS;
9721 if (remote_hostio_parse_result (rs->buf, &ret, remote_errno,
9724 *remote_errno = FILEIO_EINVAL;
9728 /* Make sure we saw an attachment if and only if we expected one. */
9729 if ((attachment_tmp == NULL && attachment != NULL)
9730 || (attachment_tmp != NULL && attachment == NULL))
9732 *remote_errno = FILEIO_EINVAL;
9736 /* If an attachment was found, it must point into the packet buffer;
9737 work out how many bytes there were. */
9738 if (attachment_tmp != NULL)
9740 *attachment = attachment_tmp;
9741 *attachment_len = bytes_read - (*attachment - rs->buf);
9747 /* Open FILENAME on the remote target, using FLAGS and MODE. Return a
9748 remote file descriptor, or -1 if an error occurs (and set
9752 remote_hostio_open (struct target_ops *self,
9753 const char *filename, int flags, int mode,
9756 struct remote_state *rs = get_remote_state ();
9758 int left = get_remote_packet_size () - 1;
9760 remote_buffer_add_string (&p, &left, "vFile:open:");
9762 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
9764 remote_buffer_add_string (&p, &left, ",");
9766 remote_buffer_add_int (&p, &left, flags);
9767 remote_buffer_add_string (&p, &left, ",");
9769 remote_buffer_add_int (&p, &left, mode);
9771 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_open,
9772 remote_errno, NULL, NULL);
9775 /* Write up to LEN bytes from WRITE_BUF to FD on the remote target.
9776 Return the number of bytes written, or -1 if an error occurs (and
9777 set *REMOTE_ERRNO). */
9780 remote_hostio_pwrite (struct target_ops *self,
9781 int fd, const gdb_byte *write_buf, int len,
9782 ULONGEST offset, int *remote_errno)
9784 struct remote_state *rs = get_remote_state ();
9786 int left = get_remote_packet_size ();
9789 remote_buffer_add_string (&p, &left, "vFile:pwrite:");
9791 remote_buffer_add_int (&p, &left, fd);
9792 remote_buffer_add_string (&p, &left, ",");
9794 remote_buffer_add_int (&p, &left, offset);
9795 remote_buffer_add_string (&p, &left, ",");
9797 p += remote_escape_output (write_buf, len, (gdb_byte *) p, &out_len,
9798 get_remote_packet_size () - (p - rs->buf));
9800 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_pwrite,
9801 remote_errno, NULL, NULL);
9804 /* Read up to LEN bytes FD on the remote target into READ_BUF
9805 Return the number of bytes read, or -1 if an error occurs (and
9806 set *REMOTE_ERRNO). */
9809 remote_hostio_pread (struct target_ops *self,
9810 int fd, gdb_byte *read_buf, int len,
9811 ULONGEST offset, int *remote_errno)
9813 struct remote_state *rs = get_remote_state ();
9816 int left = get_remote_packet_size ();
9817 int ret, attachment_len;
9820 remote_buffer_add_string (&p, &left, "vFile:pread:");
9822 remote_buffer_add_int (&p, &left, fd);
9823 remote_buffer_add_string (&p, &left, ",");
9825 remote_buffer_add_int (&p, &left, len);
9826 remote_buffer_add_string (&p, &left, ",");
9828 remote_buffer_add_int (&p, &left, offset);
9830 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_pread,
9831 remote_errno, &attachment,
9837 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
9839 if (read_len != ret)
9840 error (_("Read returned %d, but %d bytes."), ret, (int) read_len);
9845 /* Close FD on the remote target. Return 0, or -1 if an error occurs
9846 (and set *REMOTE_ERRNO). */
9849 remote_hostio_close (struct target_ops *self, int fd, int *remote_errno)
9851 struct remote_state *rs = get_remote_state ();
9853 int left = get_remote_packet_size () - 1;
9855 remote_buffer_add_string (&p, &left, "vFile:close:");
9857 remote_buffer_add_int (&p, &left, fd);
9859 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_close,
9860 remote_errno, NULL, NULL);
9863 /* Unlink FILENAME on the remote target. Return 0, or -1 if an error
9864 occurs (and set *REMOTE_ERRNO). */
9867 remote_hostio_unlink (struct target_ops *self,
9868 const char *filename, int *remote_errno)
9870 struct remote_state *rs = get_remote_state ();
9872 int left = get_remote_packet_size () - 1;
9874 remote_buffer_add_string (&p, &left, "vFile:unlink:");
9876 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
9879 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_unlink,
9880 remote_errno, NULL, NULL);
9883 /* Read value of symbolic link FILENAME on the remote target. Return
9884 a null-terminated string allocated via xmalloc, or NULL if an error
9885 occurs (and set *REMOTE_ERRNO). */
9888 remote_hostio_readlink (struct target_ops *self,
9889 const char *filename, int *remote_errno)
9891 struct remote_state *rs = get_remote_state ();
9894 int left = get_remote_packet_size ();
9895 int len, attachment_len;
9899 remote_buffer_add_string (&p, &left, "vFile:readlink:");
9901 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
9904 len = remote_hostio_send_command (p - rs->buf, PACKET_vFile_readlink,
9905 remote_errno, &attachment,
9911 ret = xmalloc (len + 1);
9913 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
9914 (gdb_byte *) ret, len);
9915 if (read_len != len)
9916 error (_("Readlink returned %d, but %d bytes."), len, read_len);
9923 remote_fileio_errno_to_host (int errnum)
9947 case FILEIO_ENOTDIR:
9967 case FILEIO_ENAMETOOLONG:
9968 return ENAMETOOLONG;
9974 remote_hostio_error (int errnum)
9976 int host_error = remote_fileio_errno_to_host (errnum);
9978 if (host_error == -1)
9979 error (_("Unknown remote I/O error %d"), errnum);
9981 error (_("Remote I/O error: %s"), safe_strerror (host_error));
9985 remote_hostio_close_cleanup (void *opaque)
9987 int fd = *(int *) opaque;
9990 remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno);
9995 remote_bfd_iovec_open (struct bfd *abfd, void *open_closure)
9997 const char *filename = bfd_get_filename (abfd);
9998 int fd, remote_errno;
10001 gdb_assert (remote_filename_p (filename));
10003 fd = remote_hostio_open (find_target_at (process_stratum),
10004 filename + 7, FILEIO_O_RDONLY, 0, &remote_errno);
10007 errno = remote_fileio_errno_to_host (remote_errno);
10008 bfd_set_error (bfd_error_system_call);
10012 stream = xmalloc (sizeof (int));
10018 remote_bfd_iovec_close (struct bfd *abfd, void *stream)
10020 int fd = *(int *)stream;
10025 /* Ignore errors on close; these may happen if the remote
10026 connection was already torn down. */
10027 remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno);
10029 /* Zero means success. */
10034 remote_bfd_iovec_pread (struct bfd *abfd, void *stream, void *buf,
10035 file_ptr nbytes, file_ptr offset)
10037 int fd = *(int *)stream;
10039 file_ptr pos, bytes;
10042 while (nbytes > pos)
10044 bytes = remote_hostio_pread (find_target_at (process_stratum),
10045 fd, (gdb_byte *) buf + pos, nbytes - pos,
10046 offset + pos, &remote_errno);
10048 /* Success, but no bytes, means end-of-file. */
10052 errno = remote_fileio_errno_to_host (remote_errno);
10053 bfd_set_error (bfd_error_system_call);
10064 remote_bfd_iovec_stat (struct bfd *abfd, void *stream, struct stat *sb)
10066 /* FIXME: We should probably implement remote_hostio_stat. */
10067 sb->st_size = INT_MAX;
10072 remote_filename_p (const char *filename)
10074 return strncmp (filename,
10075 REMOTE_SYSROOT_PREFIX,
10076 sizeof (REMOTE_SYSROOT_PREFIX) - 1) == 0;
10080 remote_bfd_open (const char *remote_file, const char *target)
10082 bfd *abfd = gdb_bfd_openr_iovec (remote_file, target,
10083 remote_bfd_iovec_open, NULL,
10084 remote_bfd_iovec_pread,
10085 remote_bfd_iovec_close,
10086 remote_bfd_iovec_stat);
10092 remote_file_put (const char *local_file, const char *remote_file, int from_tty)
10094 struct cleanup *back_to, *close_cleanup;
10095 int retcode, fd, remote_errno, bytes, io_size;
10098 int bytes_in_buffer;
10101 struct remote_state *rs = get_remote_state ();
10103 if (!rs->remote_desc)
10104 error (_("command can only be used with remote target"));
10106 file = gdb_fopen_cloexec (local_file, "rb");
10108 perror_with_name (local_file);
10109 back_to = make_cleanup_fclose (file);
10111 fd = remote_hostio_open (find_target_at (process_stratum),
10112 remote_file, (FILEIO_O_WRONLY | FILEIO_O_CREAT
10114 0700, &remote_errno);
10116 remote_hostio_error (remote_errno);
10118 /* Send up to this many bytes at once. They won't all fit in the
10119 remote packet limit, so we'll transfer slightly fewer. */
10120 io_size = get_remote_packet_size ();
10121 buffer = xmalloc (io_size);
10122 make_cleanup (xfree, buffer);
10124 close_cleanup = make_cleanup (remote_hostio_close_cleanup, &fd);
10126 bytes_in_buffer = 0;
10129 while (bytes_in_buffer || !saw_eof)
10133 bytes = fread (buffer + bytes_in_buffer, 1,
10134 io_size - bytes_in_buffer,
10139 error (_("Error reading %s."), local_file);
10142 /* EOF. Unless there is something still in the
10143 buffer from the last iteration, we are done. */
10145 if (bytes_in_buffer == 0)
10153 bytes += bytes_in_buffer;
10154 bytes_in_buffer = 0;
10156 retcode = remote_hostio_pwrite (find_target_at (process_stratum),
10158 offset, &remote_errno);
10161 remote_hostio_error (remote_errno);
10162 else if (retcode == 0)
10163 error (_("Remote write of %d bytes returned 0!"), bytes);
10164 else if (retcode < bytes)
10166 /* Short write. Save the rest of the read data for the next
10168 bytes_in_buffer = bytes - retcode;
10169 memmove (buffer, buffer + retcode, bytes_in_buffer);
10175 discard_cleanups (close_cleanup);
10176 if (remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno))
10177 remote_hostio_error (remote_errno);
10180 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file);
10181 do_cleanups (back_to);
10185 remote_file_get (const char *remote_file, const char *local_file, int from_tty)
10187 struct cleanup *back_to, *close_cleanup;
10188 int fd, remote_errno, bytes, io_size;
10192 struct remote_state *rs = get_remote_state ();
10194 if (!rs->remote_desc)
10195 error (_("command can only be used with remote target"));
10197 fd = remote_hostio_open (find_target_at (process_stratum),
10198 remote_file, FILEIO_O_RDONLY, 0, &remote_errno);
10200 remote_hostio_error (remote_errno);
10202 file = gdb_fopen_cloexec (local_file, "wb");
10204 perror_with_name (local_file);
10205 back_to = make_cleanup_fclose (file);
10207 /* Send up to this many bytes at once. They won't all fit in the
10208 remote packet limit, so we'll transfer slightly fewer. */
10209 io_size = get_remote_packet_size ();
10210 buffer = xmalloc (io_size);
10211 make_cleanup (xfree, buffer);
10213 close_cleanup = make_cleanup (remote_hostio_close_cleanup, &fd);
10218 bytes = remote_hostio_pread (find_target_at (process_stratum),
10219 fd, buffer, io_size, offset, &remote_errno);
10221 /* Success, but no bytes, means end-of-file. */
10224 remote_hostio_error (remote_errno);
10228 bytes = fwrite (buffer, 1, bytes, file);
10230 perror_with_name (local_file);
10233 discard_cleanups (close_cleanup);
10234 if (remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno))
10235 remote_hostio_error (remote_errno);
10238 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file);
10239 do_cleanups (back_to);
10243 remote_file_delete (const char *remote_file, int from_tty)
10245 int retcode, remote_errno;
10246 struct remote_state *rs = get_remote_state ();
10248 if (!rs->remote_desc)
10249 error (_("command can only be used with remote target"));
10251 retcode = remote_hostio_unlink (find_target_at (process_stratum),
10252 remote_file, &remote_errno);
10254 remote_hostio_error (remote_errno);
10257 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file);
10261 remote_put_command (char *args, int from_tty)
10263 struct cleanup *back_to;
10267 error_no_arg (_("file to put"));
10269 argv = gdb_buildargv (args);
10270 back_to = make_cleanup_freeargv (argv);
10271 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
10272 error (_("Invalid parameters to remote put"));
10274 remote_file_put (argv[0], argv[1], from_tty);
10276 do_cleanups (back_to);
10280 remote_get_command (char *args, int from_tty)
10282 struct cleanup *back_to;
10286 error_no_arg (_("file to get"));
10288 argv = gdb_buildargv (args);
10289 back_to = make_cleanup_freeargv (argv);
10290 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
10291 error (_("Invalid parameters to remote get"));
10293 remote_file_get (argv[0], argv[1], from_tty);
10295 do_cleanups (back_to);
10299 remote_delete_command (char *args, int from_tty)
10301 struct cleanup *back_to;
10305 error_no_arg (_("file to delete"));
10307 argv = gdb_buildargv (args);
10308 back_to = make_cleanup_freeargv (argv);
10309 if (argv[0] == NULL || argv[1] != NULL)
10310 error (_("Invalid parameters to remote delete"));
10312 remote_file_delete (argv[0], from_tty);
10314 do_cleanups (back_to);
10318 remote_command (char *args, int from_tty)
10320 help_list (remote_cmdlist, "remote ", all_commands, gdb_stdout);
10324 remote_can_execute_reverse (struct target_ops *self)
10326 if (packet_support (PACKET_bs) == PACKET_ENABLE
10327 || packet_support (PACKET_bc) == PACKET_ENABLE)
10334 remote_supports_non_stop (struct target_ops *self)
10340 remote_supports_disable_randomization (struct target_ops *self)
10342 /* Only supported in extended mode. */
10347 remote_supports_multi_process (struct target_ops *self)
10349 struct remote_state *rs = get_remote_state ();
10351 /* Only extended-remote handles being attached to multiple
10352 processes, even though plain remote can use the multi-process
10353 thread id extensions, so that GDB knows the target process's
10355 return rs->extended && remote_multi_process_p (rs);
10359 remote_supports_cond_tracepoints (void)
10361 return packet_support (PACKET_ConditionalTracepoints) == PACKET_ENABLE;
10365 remote_supports_cond_breakpoints (struct target_ops *self)
10367 return packet_support (PACKET_ConditionalBreakpoints) == PACKET_ENABLE;
10371 remote_supports_fast_tracepoints (void)
10373 return packet_support (PACKET_FastTracepoints) == PACKET_ENABLE;
10377 remote_supports_static_tracepoints (void)
10379 return packet_support (PACKET_StaticTracepoints) == PACKET_ENABLE;
10383 remote_supports_install_in_trace (void)
10385 return packet_support (PACKET_InstallInTrace) == PACKET_ENABLE;
10389 remote_supports_enable_disable_tracepoint (struct target_ops *self)
10391 return (packet_support (PACKET_EnableDisableTracepoints_feature)
10396 remote_supports_string_tracing (struct target_ops *self)
10398 return packet_support (PACKET_tracenz_feature) == PACKET_ENABLE;
10402 remote_can_run_breakpoint_commands (struct target_ops *self)
10404 return packet_support (PACKET_BreakpointCommands) == PACKET_ENABLE;
10408 remote_trace_init (struct target_ops *self)
10411 remote_get_noisy_reply (&target_buf, &target_buf_size);
10412 if (strcmp (target_buf, "OK") != 0)
10413 error (_("Target does not support this command."));
10416 static void free_actions_list (char **actions_list);
10417 static void free_actions_list_cleanup_wrapper (void *);
10419 free_actions_list_cleanup_wrapper (void *al)
10421 free_actions_list (al);
10425 free_actions_list (char **actions_list)
10429 if (actions_list == 0)
10432 for (ndx = 0; actions_list[ndx]; ndx++)
10433 xfree (actions_list[ndx]);
10435 xfree (actions_list);
10438 /* Recursive routine to walk through command list including loops, and
10439 download packets for each command. */
10442 remote_download_command_source (int num, ULONGEST addr,
10443 struct command_line *cmds)
10445 struct remote_state *rs = get_remote_state ();
10446 struct command_line *cmd;
10448 for (cmd = cmds; cmd; cmd = cmd->next)
10450 QUIT; /* Allow user to bail out with ^C. */
10451 strcpy (rs->buf, "QTDPsrc:");
10452 encode_source_string (num, addr, "cmd", cmd->line,
10453 rs->buf + strlen (rs->buf),
10454 rs->buf_size - strlen (rs->buf));
10456 remote_get_noisy_reply (&target_buf, &target_buf_size);
10457 if (strcmp (target_buf, "OK"))
10458 warning (_("Target does not support source download."));
10460 if (cmd->control_type == while_control
10461 || cmd->control_type == while_stepping_control)
10463 remote_download_command_source (num, addr, *cmd->body_list);
10465 QUIT; /* Allow user to bail out with ^C. */
10466 strcpy (rs->buf, "QTDPsrc:");
10467 encode_source_string (num, addr, "cmd", "end",
10468 rs->buf + strlen (rs->buf),
10469 rs->buf_size - strlen (rs->buf));
10471 remote_get_noisy_reply (&target_buf, &target_buf_size);
10472 if (strcmp (target_buf, "OK"))
10473 warning (_("Target does not support source download."));
10479 remote_download_tracepoint (struct target_ops *self, struct bp_location *loc)
10481 #define BUF_SIZE 2048
10485 char buf[BUF_SIZE];
10486 char **tdp_actions;
10487 char **stepping_actions;
10489 struct cleanup *old_chain = NULL;
10490 struct agent_expr *aexpr;
10491 struct cleanup *aexpr_chain = NULL;
10493 struct breakpoint *b = loc->owner;
10494 struct tracepoint *t = (struct tracepoint *) b;
10496 encode_actions_rsp (loc, &tdp_actions, &stepping_actions);
10497 old_chain = make_cleanup (free_actions_list_cleanup_wrapper,
10499 (void) make_cleanup (free_actions_list_cleanup_wrapper,
10502 tpaddr = loc->address;
10503 sprintf_vma (addrbuf, tpaddr);
10504 xsnprintf (buf, BUF_SIZE, "QTDP:%x:%s:%c:%lx:%x", b->number,
10505 addrbuf, /* address */
10506 (b->enable_state == bp_enabled ? 'E' : 'D'),
10507 t->step_count, t->pass_count);
10508 /* Fast tracepoints are mostly handled by the target, but we can
10509 tell the target how big of an instruction block should be moved
10511 if (b->type == bp_fast_tracepoint)
10513 /* Only test for support at download time; we may not know
10514 target capabilities at definition time. */
10515 if (remote_supports_fast_tracepoints ())
10519 if (gdbarch_fast_tracepoint_valid_at (target_gdbarch (),
10520 tpaddr, &isize, NULL))
10521 xsnprintf (buf + strlen (buf), BUF_SIZE - strlen (buf), ":F%x",
10524 /* If it passed validation at definition but fails now,
10525 something is very wrong. */
10526 internal_error (__FILE__, __LINE__,
10527 _("Fast tracepoint not "
10528 "valid during download"));
10531 /* Fast tracepoints are functionally identical to regular
10532 tracepoints, so don't take lack of support as a reason to
10533 give up on the trace run. */
10534 warning (_("Target does not support fast tracepoints, "
10535 "downloading %d as regular tracepoint"), b->number);
10537 else if (b->type == bp_static_tracepoint)
10539 /* Only test for support at download time; we may not know
10540 target capabilities at definition time. */
10541 if (remote_supports_static_tracepoints ())
10543 struct static_tracepoint_marker marker;
10545 if (target_static_tracepoint_marker_at (tpaddr, &marker))
10546 strcat (buf, ":S");
10548 error (_("Static tracepoint not valid during download"));
10551 /* Fast tracepoints are functionally identical to regular
10552 tracepoints, so don't take lack of support as a reason
10553 to give up on the trace run. */
10554 error (_("Target does not support static tracepoints"));
10556 /* If the tracepoint has a conditional, make it into an agent
10557 expression and append to the definition. */
10560 /* Only test support at download time, we may not know target
10561 capabilities at definition time. */
10562 if (remote_supports_cond_tracepoints ())
10564 aexpr = gen_eval_for_expr (tpaddr, loc->cond);
10565 aexpr_chain = make_cleanup_free_agent_expr (aexpr);
10566 xsnprintf (buf + strlen (buf), BUF_SIZE - strlen (buf), ":X%x,",
10568 pkt = buf + strlen (buf);
10569 for (ndx = 0; ndx < aexpr->len; ++ndx)
10570 pkt = pack_hex_byte (pkt, aexpr->buf[ndx]);
10572 do_cleanups (aexpr_chain);
10575 warning (_("Target does not support conditional tracepoints, "
10576 "ignoring tp %d cond"), b->number);
10579 if (b->commands || *default_collect)
10582 remote_get_noisy_reply (&target_buf, &target_buf_size);
10583 if (strcmp (target_buf, "OK"))
10584 error (_("Target does not support tracepoints."));
10586 /* do_single_steps (t); */
10589 for (ndx = 0; tdp_actions[ndx]; ndx++)
10591 QUIT; /* Allow user to bail out with ^C. */
10592 xsnprintf (buf, BUF_SIZE, "QTDP:-%x:%s:%s%c",
10593 b->number, addrbuf, /* address */
10595 ((tdp_actions[ndx + 1] || stepping_actions)
10598 remote_get_noisy_reply (&target_buf,
10600 if (strcmp (target_buf, "OK"))
10601 error (_("Error on target while setting tracepoints."));
10604 if (stepping_actions)
10606 for (ndx = 0; stepping_actions[ndx]; ndx++)
10608 QUIT; /* Allow user to bail out with ^C. */
10609 xsnprintf (buf, BUF_SIZE, "QTDP:-%x:%s:%s%s%s",
10610 b->number, addrbuf, /* address */
10611 ((ndx == 0) ? "S" : ""),
10612 stepping_actions[ndx],
10613 (stepping_actions[ndx + 1] ? "-" : ""));
10615 remote_get_noisy_reply (&target_buf,
10617 if (strcmp (target_buf, "OK"))
10618 error (_("Error on target while setting tracepoints."));
10622 if (packet_support (PACKET_TracepointSource) == PACKET_ENABLE)
10624 if (b->addr_string)
10626 strcpy (buf, "QTDPsrc:");
10627 encode_source_string (b->number, loc->address,
10628 "at", b->addr_string, buf + strlen (buf),
10629 2048 - strlen (buf));
10632 remote_get_noisy_reply (&target_buf, &target_buf_size);
10633 if (strcmp (target_buf, "OK"))
10634 warning (_("Target does not support source download."));
10636 if (b->cond_string)
10638 strcpy (buf, "QTDPsrc:");
10639 encode_source_string (b->number, loc->address,
10640 "cond", b->cond_string, buf + strlen (buf),
10641 2048 - strlen (buf));
10643 remote_get_noisy_reply (&target_buf, &target_buf_size);
10644 if (strcmp (target_buf, "OK"))
10645 warning (_("Target does not support source download."));
10647 remote_download_command_source (b->number, loc->address,
10648 breakpoint_commands (b));
10651 do_cleanups (old_chain);
10655 remote_can_download_tracepoint (struct target_ops *self)
10657 struct remote_state *rs = get_remote_state ();
10658 struct trace_status *ts;
10661 /* Don't try to install tracepoints until we've relocated our
10662 symbols, and fetched and merged the target's tracepoint list with
10664 if (rs->starting_up)
10667 ts = current_trace_status ();
10668 status = remote_get_trace_status (self, ts);
10670 if (status == -1 || !ts->running_known || !ts->running)
10673 /* If we are in a tracing experiment, but remote stub doesn't support
10674 installing tracepoint in trace, we have to return. */
10675 if (!remote_supports_install_in_trace ())
10683 remote_download_trace_state_variable (struct target_ops *self,
10684 struct trace_state_variable *tsv)
10686 struct remote_state *rs = get_remote_state ();
10689 xsnprintf (rs->buf, get_remote_packet_size (), "QTDV:%x:%s:%x:",
10690 tsv->number, phex ((ULONGEST) tsv->initial_value, 8),
10692 p = rs->buf + strlen (rs->buf);
10693 if ((p - rs->buf) + strlen (tsv->name) * 2 >= get_remote_packet_size ())
10694 error (_("Trace state variable name too long for tsv definition packet"));
10695 p += 2 * bin2hex ((gdb_byte *) (tsv->name), p, strlen (tsv->name));
10698 remote_get_noisy_reply (&target_buf, &target_buf_size);
10699 if (*target_buf == '\0')
10700 error (_("Target does not support this command."));
10701 if (strcmp (target_buf, "OK") != 0)
10702 error (_("Error on target while downloading trace state variable."));
10706 remote_enable_tracepoint (struct target_ops *self,
10707 struct bp_location *location)
10709 struct remote_state *rs = get_remote_state ();
10712 sprintf_vma (addr_buf, location->address);
10713 xsnprintf (rs->buf, get_remote_packet_size (), "QTEnable:%x:%s",
10714 location->owner->number, addr_buf);
10716 remote_get_noisy_reply (&rs->buf, &rs->buf_size);
10717 if (*rs->buf == '\0')
10718 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
10719 if (strcmp (rs->buf, "OK") != 0)
10720 error (_("Error on target while enabling tracepoint."));
10724 remote_disable_tracepoint (struct target_ops *self,
10725 struct bp_location *location)
10727 struct remote_state *rs = get_remote_state ();
10730 sprintf_vma (addr_buf, location->address);
10731 xsnprintf (rs->buf, get_remote_packet_size (), "QTDisable:%x:%s",
10732 location->owner->number, addr_buf);
10734 remote_get_noisy_reply (&rs->buf, &rs->buf_size);
10735 if (*rs->buf == '\0')
10736 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
10737 if (strcmp (rs->buf, "OK") != 0)
10738 error (_("Error on target while disabling tracepoint."));
10742 remote_trace_set_readonly_regions (struct target_ops *self)
10746 bfd_size_type size;
10752 return; /* No information to give. */
10754 strcpy (target_buf, "QTro");
10755 offset = strlen (target_buf);
10756 for (s = exec_bfd->sections; s; s = s->next)
10758 char tmp1[40], tmp2[40];
10761 if ((s->flags & SEC_LOAD) == 0 ||
10762 /* (s->flags & SEC_CODE) == 0 || */
10763 (s->flags & SEC_READONLY) == 0)
10767 vma = bfd_get_section_vma (abfd, s);
10768 size = bfd_get_section_size (s);
10769 sprintf_vma (tmp1, vma);
10770 sprintf_vma (tmp2, vma + size);
10771 sec_length = 1 + strlen (tmp1) + 1 + strlen (tmp2);
10772 if (offset + sec_length + 1 > target_buf_size)
10774 if (packet_support (PACKET_qXfer_traceframe_info) != PACKET_ENABLE)
10776 Too many sections for read-only sections definition packet."));
10779 xsnprintf (target_buf + offset, target_buf_size - offset, ":%s,%s",
10781 offset += sec_length;
10785 putpkt (target_buf);
10786 getpkt (&target_buf, &target_buf_size, 0);
10791 remote_trace_start (struct target_ops *self)
10793 putpkt ("QTStart");
10794 remote_get_noisy_reply (&target_buf, &target_buf_size);
10795 if (*target_buf == '\0')
10796 error (_("Target does not support this command."));
10797 if (strcmp (target_buf, "OK") != 0)
10798 error (_("Bogus reply from target: %s"), target_buf);
10802 remote_get_trace_status (struct target_ops *self, struct trace_status *ts)
10804 /* Initialize it just to avoid a GCC false warning. */
10806 /* FIXME we need to get register block size some other way. */
10807 extern int trace_regblock_size;
10808 volatile struct gdb_exception ex;
10809 enum packet_result result;
10811 if (packet_support (PACKET_qTStatus) == PACKET_DISABLE)
10814 trace_regblock_size = get_remote_arch_state ()->sizeof_g_packet;
10816 putpkt ("qTStatus");
10818 TRY_CATCH (ex, RETURN_MASK_ERROR)
10820 p = remote_get_noisy_reply (&target_buf, &target_buf_size);
10824 if (ex.error != TARGET_CLOSE_ERROR)
10826 exception_fprintf (gdb_stderr, ex, "qTStatus: ");
10829 throw_exception (ex);
10832 result = packet_ok (p, &remote_protocol_packets[PACKET_qTStatus]);
10834 /* If the remote target doesn't do tracing, flag it. */
10835 if (result == PACKET_UNKNOWN)
10838 /* We're working with a live target. */
10839 ts->filename = NULL;
10842 error (_("Bogus trace status reply from target: %s"), target_buf);
10844 /* Function 'parse_trace_status' sets default value of each field of
10845 'ts' at first, so we don't have to do it here. */
10846 parse_trace_status (p, ts);
10848 return ts->running;
10852 remote_get_tracepoint_status (struct target_ops *self, struct breakpoint *bp,
10853 struct uploaded_tp *utp)
10855 struct remote_state *rs = get_remote_state ();
10857 struct bp_location *loc;
10858 struct tracepoint *tp = (struct tracepoint *) bp;
10859 size_t size = get_remote_packet_size ();
10863 tp->base.hit_count = 0;
10864 tp->traceframe_usage = 0;
10865 for (loc = tp->base.loc; loc; loc = loc->next)
10867 /* If the tracepoint was never downloaded, don't go asking for
10869 if (tp->number_on_target == 0)
10871 xsnprintf (rs->buf, size, "qTP:%x:%s", tp->number_on_target,
10872 phex_nz (loc->address, 0));
10874 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
10875 if (reply && *reply)
10878 parse_tracepoint_status (reply + 1, bp, utp);
10884 utp->hit_count = 0;
10885 utp->traceframe_usage = 0;
10886 xsnprintf (rs->buf, size, "qTP:%x:%s", utp->number,
10887 phex_nz (utp->addr, 0));
10889 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
10890 if (reply && *reply)
10893 parse_tracepoint_status (reply + 1, bp, utp);
10899 remote_trace_stop (struct target_ops *self)
10902 remote_get_noisy_reply (&target_buf, &target_buf_size);
10903 if (*target_buf == '\0')
10904 error (_("Target does not support this command."));
10905 if (strcmp (target_buf, "OK") != 0)
10906 error (_("Bogus reply from target: %s"), target_buf);
10910 remote_trace_find (struct target_ops *self,
10911 enum trace_find_type type, int num,
10912 CORE_ADDR addr1, CORE_ADDR addr2,
10915 struct remote_state *rs = get_remote_state ();
10916 char *endbuf = rs->buf + get_remote_packet_size ();
10918 int target_frameno = -1, target_tracept = -1;
10920 /* Lookups other than by absolute frame number depend on the current
10921 trace selected, so make sure it is correct on the remote end
10923 if (type != tfind_number)
10924 set_remote_traceframe ();
10927 strcpy (p, "QTFrame:");
10928 p = strchr (p, '\0');
10932 xsnprintf (p, endbuf - p, "%x", num);
10935 xsnprintf (p, endbuf - p, "pc:%s", phex_nz (addr1, 0));
10938 xsnprintf (p, endbuf - p, "tdp:%x", num);
10941 xsnprintf (p, endbuf - p, "range:%s:%s", phex_nz (addr1, 0),
10942 phex_nz (addr2, 0));
10944 case tfind_outside:
10945 xsnprintf (p, endbuf - p, "outside:%s:%s", phex_nz (addr1, 0),
10946 phex_nz (addr2, 0));
10949 error (_("Unknown trace find type %d"), type);
10953 reply = remote_get_noisy_reply (&(rs->buf), &rs->buf_size);
10954 if (*reply == '\0')
10955 error (_("Target does not support this command."));
10957 while (reply && *reply)
10962 target_frameno = (int) strtol (p, &reply, 16);
10964 error (_("Unable to parse trace frame number"));
10965 /* Don't update our remote traceframe number cache on failure
10966 to select a remote traceframe. */
10967 if (target_frameno == -1)
10972 target_tracept = (int) strtol (p, &reply, 16);
10974 error (_("Unable to parse tracepoint number"));
10976 case 'O': /* "OK"? */
10977 if (reply[1] == 'K' && reply[2] == '\0')
10980 error (_("Bogus reply from target: %s"), reply);
10983 error (_("Bogus reply from target: %s"), reply);
10986 *tpp = target_tracept;
10988 rs->remote_traceframe_number = target_frameno;
10989 return target_frameno;
10993 remote_get_trace_state_variable_value (struct target_ops *self,
10994 int tsvnum, LONGEST *val)
10996 struct remote_state *rs = get_remote_state ();
11000 set_remote_traceframe ();
11002 xsnprintf (rs->buf, get_remote_packet_size (), "qTV:%x", tsvnum);
11004 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11005 if (reply && *reply)
11009 unpack_varlen_hex (reply + 1, &uval);
11010 *val = (LONGEST) uval;
11018 remote_save_trace_data (struct target_ops *self, const char *filename)
11020 struct remote_state *rs = get_remote_state ();
11024 strcpy (p, "QTSave:");
11026 if ((p - rs->buf) + strlen (filename) * 2 >= get_remote_packet_size ())
11027 error (_("Remote file name too long for trace save packet"));
11028 p += 2 * bin2hex ((gdb_byte *) filename, p, strlen (filename));
11031 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11032 if (*reply == '\0')
11033 error (_("Target does not support this command."));
11034 if (strcmp (reply, "OK") != 0)
11035 error (_("Bogus reply from target: %s"), reply);
11039 /* This is basically a memory transfer, but needs to be its own packet
11040 because we don't know how the target actually organizes its trace
11041 memory, plus we want to be able to ask for as much as possible, but
11042 not be unhappy if we don't get as much as we ask for. */
11045 remote_get_raw_trace_data (struct target_ops *self,
11046 gdb_byte *buf, ULONGEST offset, LONGEST len)
11048 struct remote_state *rs = get_remote_state ();
11054 strcpy (p, "qTBuffer:");
11056 p += hexnumstr (p, offset);
11058 p += hexnumstr (p, len);
11062 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11063 if (reply && *reply)
11065 /* 'l' by itself means we're at the end of the buffer and
11066 there is nothing more to get. */
11070 /* Convert the reply into binary. Limit the number of bytes to
11071 convert according to our passed-in buffer size, rather than
11072 what was returned in the packet; if the target is
11073 unexpectedly generous and gives us a bigger reply than we
11074 asked for, we don't want to crash. */
11075 rslt = hex2bin (target_buf, buf, len);
11079 /* Something went wrong, flag as an error. */
11084 remote_set_disconnected_tracing (struct target_ops *self, int val)
11086 struct remote_state *rs = get_remote_state ();
11088 if (packet_support (PACKET_DisconnectedTracing_feature) == PACKET_ENABLE)
11092 xsnprintf (rs->buf, get_remote_packet_size (), "QTDisconnected:%x", val);
11094 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11095 if (*reply == '\0')
11096 error (_("Target does not support this command."));
11097 if (strcmp (reply, "OK") != 0)
11098 error (_("Bogus reply from target: %s"), reply);
11101 warning (_("Target does not support disconnected tracing."));
11105 remote_core_of_thread (struct target_ops *ops, ptid_t ptid)
11107 struct thread_info *info = find_thread_ptid (ptid);
11109 if (info && info->private)
11110 return info->private->core;
11115 remote_set_circular_trace_buffer (struct target_ops *self, int val)
11117 struct remote_state *rs = get_remote_state ();
11120 xsnprintf (rs->buf, get_remote_packet_size (), "QTBuffer:circular:%x", val);
11122 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11123 if (*reply == '\0')
11124 error (_("Target does not support this command."));
11125 if (strcmp (reply, "OK") != 0)
11126 error (_("Bogus reply from target: %s"), reply);
11129 static struct traceframe_info *
11130 remote_traceframe_info (struct target_ops *self)
11134 text = target_read_stralloc (¤t_target,
11135 TARGET_OBJECT_TRACEFRAME_INFO, NULL);
11138 struct traceframe_info *info;
11139 struct cleanup *back_to = make_cleanup (xfree, text);
11141 info = parse_traceframe_info (text);
11142 do_cleanups (back_to);
11149 /* Handle the qTMinFTPILen packet. Returns the minimum length of
11150 instruction on which a fast tracepoint may be placed. Returns -1
11151 if the packet is not supported, and 0 if the minimum instruction
11152 length is unknown. */
11155 remote_get_min_fast_tracepoint_insn_len (struct target_ops *self)
11157 struct remote_state *rs = get_remote_state ();
11160 /* If we're not debugging a process yet, the IPA can't be
11162 if (!target_has_execution)
11165 /* Make sure the remote is pointing at the right process. */
11166 set_general_process ();
11168 xsnprintf (rs->buf, get_remote_packet_size (), "qTMinFTPILen");
11170 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11171 if (*reply == '\0')
11175 ULONGEST min_insn_len;
11177 unpack_varlen_hex (reply, &min_insn_len);
11179 return (int) min_insn_len;
11184 remote_set_trace_buffer_size (struct target_ops *self, LONGEST val)
11186 if (packet_support (PACKET_QTBuffer_size) != PACKET_DISABLE)
11188 struct remote_state *rs = get_remote_state ();
11189 char *buf = rs->buf;
11190 char *endbuf = rs->buf + get_remote_packet_size ();
11191 enum packet_result result;
11193 gdb_assert (val >= 0 || val == -1);
11194 buf += xsnprintf (buf, endbuf - buf, "QTBuffer:size:");
11195 /* Send -1 as literal "-1" to avoid host size dependency. */
11199 buf += hexnumstr (buf, (ULONGEST) -val);
11202 buf += hexnumstr (buf, (ULONGEST) val);
11205 remote_get_noisy_reply (&rs->buf, &rs->buf_size);
11206 result = packet_ok (rs->buf,
11207 &remote_protocol_packets[PACKET_QTBuffer_size]);
11209 if (result != PACKET_OK)
11210 warning (_("Bogus reply from target: %s"), rs->buf);
11215 remote_set_trace_notes (struct target_ops *self,
11216 const char *user, const char *notes,
11217 const char *stop_notes)
11219 struct remote_state *rs = get_remote_state ();
11221 char *buf = rs->buf;
11222 char *endbuf = rs->buf + get_remote_packet_size ();
11225 buf += xsnprintf (buf, endbuf - buf, "QTNotes:");
11228 buf += xsnprintf (buf, endbuf - buf, "user:");
11229 nbytes = bin2hex ((gdb_byte *) user, buf, strlen (user));
11235 buf += xsnprintf (buf, endbuf - buf, "notes:");
11236 nbytes = bin2hex ((gdb_byte *) notes, buf, strlen (notes));
11242 buf += xsnprintf (buf, endbuf - buf, "tstop:");
11243 nbytes = bin2hex ((gdb_byte *) stop_notes, buf, strlen (stop_notes));
11247 /* Ensure the buffer is terminated. */
11251 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11252 if (*reply == '\0')
11255 if (strcmp (reply, "OK") != 0)
11256 error (_("Bogus reply from target: %s"), reply);
11262 remote_use_agent (struct target_ops *self, int use)
11264 if (packet_support (PACKET_QAgent) != PACKET_DISABLE)
11266 struct remote_state *rs = get_remote_state ();
11268 /* If the stub supports QAgent. */
11269 xsnprintf (rs->buf, get_remote_packet_size (), "QAgent:%d", use);
11271 getpkt (&rs->buf, &rs->buf_size, 0);
11273 if (strcmp (rs->buf, "OK") == 0)
11284 remote_can_use_agent (struct target_ops *self)
11286 return (packet_support (PACKET_QAgent) != PACKET_DISABLE);
11289 struct btrace_target_info
11291 /* The ptid of the traced thread. */
11295 /* Check whether the target supports branch tracing. */
11298 remote_supports_btrace (struct target_ops *self)
11300 if (packet_support (PACKET_Qbtrace_off) != PACKET_ENABLE)
11302 if (packet_support (PACKET_Qbtrace_bts) != PACKET_ENABLE)
11304 if (packet_support (PACKET_qXfer_btrace) != PACKET_ENABLE)
11310 /* Enable branch tracing. */
11312 static struct btrace_target_info *
11313 remote_enable_btrace (struct target_ops *self, ptid_t ptid)
11315 struct btrace_target_info *tinfo = NULL;
11316 struct packet_config *packet = &remote_protocol_packets[PACKET_Qbtrace_bts];
11317 struct remote_state *rs = get_remote_state ();
11318 char *buf = rs->buf;
11319 char *endbuf = rs->buf + get_remote_packet_size ();
11321 if (packet_config_support (packet) != PACKET_ENABLE)
11322 error (_("Target does not support branch tracing."));
11324 set_general_thread (ptid);
11326 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
11328 getpkt (&rs->buf, &rs->buf_size, 0);
11330 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
11332 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
11333 error (_("Could not enable branch tracing for %s: %s"),
11334 target_pid_to_str (ptid), rs->buf + 2);
11336 error (_("Could not enable branch tracing for %s."),
11337 target_pid_to_str (ptid));
11340 tinfo = xzalloc (sizeof (*tinfo));
11341 tinfo->ptid = ptid;
11346 /* Disable branch tracing. */
11349 remote_disable_btrace (struct target_ops *self,
11350 struct btrace_target_info *tinfo)
11352 struct packet_config *packet = &remote_protocol_packets[PACKET_Qbtrace_off];
11353 struct remote_state *rs = get_remote_state ();
11354 char *buf = rs->buf;
11355 char *endbuf = rs->buf + get_remote_packet_size ();
11357 if (packet_config_support (packet) != PACKET_ENABLE)
11358 error (_("Target does not support branch tracing."));
11360 set_general_thread (tinfo->ptid);
11362 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
11364 getpkt (&rs->buf, &rs->buf_size, 0);
11366 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
11368 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
11369 error (_("Could not disable branch tracing for %s: %s"),
11370 target_pid_to_str (tinfo->ptid), rs->buf + 2);
11372 error (_("Could not disable branch tracing for %s."),
11373 target_pid_to_str (tinfo->ptid));
11379 /* Teardown branch tracing. */
11382 remote_teardown_btrace (struct target_ops *self,
11383 struct btrace_target_info *tinfo)
11385 /* We must not talk to the target during teardown. */
11389 /* Read the branch trace. */
11391 static enum btrace_error
11392 remote_read_btrace (struct target_ops *self,
11393 VEC (btrace_block_s) **btrace,
11394 struct btrace_target_info *tinfo,
11395 enum btrace_read_type type)
11397 struct packet_config *packet = &remote_protocol_packets[PACKET_qXfer_btrace];
11398 struct remote_state *rs = get_remote_state ();
11399 struct cleanup *cleanup;
11403 if (packet_config_support (packet) != PACKET_ENABLE)
11404 error (_("Target does not support branch tracing."));
11406 #if !defined(HAVE_LIBEXPAT)
11407 error (_("Cannot process branch tracing result. XML parsing not supported."));
11412 case BTRACE_READ_ALL:
11415 case BTRACE_READ_NEW:
11418 case BTRACE_READ_DELTA:
11422 internal_error (__FILE__, __LINE__,
11423 _("Bad branch tracing read type: %u."),
11424 (unsigned int) type);
11427 xml = target_read_stralloc (¤t_target,
11428 TARGET_OBJECT_BTRACE, annex);
11430 return BTRACE_ERR_UNKNOWN;
11432 cleanup = make_cleanup (xfree, xml);
11433 *btrace = parse_xml_btrace (xml);
11434 do_cleanups (cleanup);
11436 return BTRACE_ERR_NONE;
11440 remote_augmented_libraries_svr4_read (struct target_ops *self)
11442 return (packet_support (PACKET_augmented_libraries_svr4_read_feature)
11446 /* Implementation of to_load. */
11449 remote_load (struct target_ops *self, const char *name, int from_tty)
11451 generic_load (name, from_tty);
11455 init_remote_ops (void)
11457 remote_ops.to_shortname = "remote";
11458 remote_ops.to_longname = "Remote serial target in gdb-specific protocol";
11459 remote_ops.to_doc =
11460 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
11461 Specify the serial device it is connected to\n\
11462 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).";
11463 remote_ops.to_open = remote_open;
11464 remote_ops.to_close = remote_close;
11465 remote_ops.to_detach = remote_detach;
11466 remote_ops.to_disconnect = remote_disconnect;
11467 remote_ops.to_resume = remote_resume;
11468 remote_ops.to_wait = remote_wait;
11469 remote_ops.to_fetch_registers = remote_fetch_registers;
11470 remote_ops.to_store_registers = remote_store_registers;
11471 remote_ops.to_prepare_to_store = remote_prepare_to_store;
11472 remote_ops.to_files_info = remote_files_info;
11473 remote_ops.to_insert_breakpoint = remote_insert_breakpoint;
11474 remote_ops.to_remove_breakpoint = remote_remove_breakpoint;
11475 remote_ops.to_stopped_by_watchpoint = remote_stopped_by_watchpoint;
11476 remote_ops.to_stopped_data_address = remote_stopped_data_address;
11477 remote_ops.to_watchpoint_addr_within_range =
11478 remote_watchpoint_addr_within_range;
11479 remote_ops.to_can_use_hw_breakpoint = remote_check_watch_resources;
11480 remote_ops.to_insert_hw_breakpoint = remote_insert_hw_breakpoint;
11481 remote_ops.to_remove_hw_breakpoint = remote_remove_hw_breakpoint;
11482 remote_ops.to_region_ok_for_hw_watchpoint
11483 = remote_region_ok_for_hw_watchpoint;
11484 remote_ops.to_insert_watchpoint = remote_insert_watchpoint;
11485 remote_ops.to_remove_watchpoint = remote_remove_watchpoint;
11486 remote_ops.to_kill = remote_kill;
11487 remote_ops.to_load = remote_load;
11488 remote_ops.to_mourn_inferior = remote_mourn;
11489 remote_ops.to_pass_signals = remote_pass_signals;
11490 remote_ops.to_program_signals = remote_program_signals;
11491 remote_ops.to_thread_alive = remote_thread_alive;
11492 remote_ops.to_update_thread_list = remote_update_thread_list;
11493 remote_ops.to_pid_to_str = remote_pid_to_str;
11494 remote_ops.to_extra_thread_info = remote_threads_extra_info;
11495 remote_ops.to_get_ada_task_ptid = remote_get_ada_task_ptid;
11496 remote_ops.to_stop = remote_stop;
11497 remote_ops.to_xfer_partial = remote_xfer_partial;
11498 remote_ops.to_rcmd = remote_rcmd;
11499 remote_ops.to_log_command = serial_log_command;
11500 remote_ops.to_get_thread_local_address = remote_get_thread_local_address;
11501 remote_ops.to_stratum = process_stratum;
11502 remote_ops.to_has_all_memory = default_child_has_all_memory;
11503 remote_ops.to_has_memory = default_child_has_memory;
11504 remote_ops.to_has_stack = default_child_has_stack;
11505 remote_ops.to_has_registers = default_child_has_registers;
11506 remote_ops.to_has_execution = default_child_has_execution;
11507 remote_ops.to_has_thread_control = tc_schedlock; /* can lock scheduler */
11508 remote_ops.to_can_execute_reverse = remote_can_execute_reverse;
11509 remote_ops.to_magic = OPS_MAGIC;
11510 remote_ops.to_memory_map = remote_memory_map;
11511 remote_ops.to_flash_erase = remote_flash_erase;
11512 remote_ops.to_flash_done = remote_flash_done;
11513 remote_ops.to_read_description = remote_read_description;
11514 remote_ops.to_search_memory = remote_search_memory;
11515 remote_ops.to_can_async_p = remote_can_async_p;
11516 remote_ops.to_is_async_p = remote_is_async_p;
11517 remote_ops.to_async = remote_async;
11518 remote_ops.to_terminal_inferior = remote_terminal_inferior;
11519 remote_ops.to_terminal_ours = remote_terminal_ours;
11520 remote_ops.to_supports_non_stop = remote_supports_non_stop;
11521 remote_ops.to_supports_multi_process = remote_supports_multi_process;
11522 remote_ops.to_supports_disable_randomization
11523 = remote_supports_disable_randomization;
11524 remote_ops.to_fileio_open = remote_hostio_open;
11525 remote_ops.to_fileio_pwrite = remote_hostio_pwrite;
11526 remote_ops.to_fileio_pread = remote_hostio_pread;
11527 remote_ops.to_fileio_close = remote_hostio_close;
11528 remote_ops.to_fileio_unlink = remote_hostio_unlink;
11529 remote_ops.to_fileio_readlink = remote_hostio_readlink;
11530 remote_ops.to_supports_enable_disable_tracepoint = remote_supports_enable_disable_tracepoint;
11531 remote_ops.to_supports_string_tracing = remote_supports_string_tracing;
11532 remote_ops.to_supports_evaluation_of_breakpoint_conditions = remote_supports_cond_breakpoints;
11533 remote_ops.to_can_run_breakpoint_commands = remote_can_run_breakpoint_commands;
11534 remote_ops.to_trace_init = remote_trace_init;
11535 remote_ops.to_download_tracepoint = remote_download_tracepoint;
11536 remote_ops.to_can_download_tracepoint = remote_can_download_tracepoint;
11537 remote_ops.to_download_trace_state_variable
11538 = remote_download_trace_state_variable;
11539 remote_ops.to_enable_tracepoint = remote_enable_tracepoint;
11540 remote_ops.to_disable_tracepoint = remote_disable_tracepoint;
11541 remote_ops.to_trace_set_readonly_regions = remote_trace_set_readonly_regions;
11542 remote_ops.to_trace_start = remote_trace_start;
11543 remote_ops.to_get_trace_status = remote_get_trace_status;
11544 remote_ops.to_get_tracepoint_status = remote_get_tracepoint_status;
11545 remote_ops.to_trace_stop = remote_trace_stop;
11546 remote_ops.to_trace_find = remote_trace_find;
11547 remote_ops.to_get_trace_state_variable_value
11548 = remote_get_trace_state_variable_value;
11549 remote_ops.to_save_trace_data = remote_save_trace_data;
11550 remote_ops.to_upload_tracepoints = remote_upload_tracepoints;
11551 remote_ops.to_upload_trace_state_variables
11552 = remote_upload_trace_state_variables;
11553 remote_ops.to_get_raw_trace_data = remote_get_raw_trace_data;
11554 remote_ops.to_get_min_fast_tracepoint_insn_len = remote_get_min_fast_tracepoint_insn_len;
11555 remote_ops.to_set_disconnected_tracing = remote_set_disconnected_tracing;
11556 remote_ops.to_set_circular_trace_buffer = remote_set_circular_trace_buffer;
11557 remote_ops.to_set_trace_buffer_size = remote_set_trace_buffer_size;
11558 remote_ops.to_set_trace_notes = remote_set_trace_notes;
11559 remote_ops.to_core_of_thread = remote_core_of_thread;
11560 remote_ops.to_verify_memory = remote_verify_memory;
11561 remote_ops.to_get_tib_address = remote_get_tib_address;
11562 remote_ops.to_set_permissions = remote_set_permissions;
11563 remote_ops.to_static_tracepoint_marker_at
11564 = remote_static_tracepoint_marker_at;
11565 remote_ops.to_static_tracepoint_markers_by_strid
11566 = remote_static_tracepoint_markers_by_strid;
11567 remote_ops.to_traceframe_info = remote_traceframe_info;
11568 remote_ops.to_use_agent = remote_use_agent;
11569 remote_ops.to_can_use_agent = remote_can_use_agent;
11570 remote_ops.to_supports_btrace = remote_supports_btrace;
11571 remote_ops.to_enable_btrace = remote_enable_btrace;
11572 remote_ops.to_disable_btrace = remote_disable_btrace;
11573 remote_ops.to_teardown_btrace = remote_teardown_btrace;
11574 remote_ops.to_read_btrace = remote_read_btrace;
11575 remote_ops.to_augmented_libraries_svr4_read =
11576 remote_augmented_libraries_svr4_read;
11579 /* Set up the extended remote vector by making a copy of the standard
11580 remote vector and adding to it. */
11583 init_extended_remote_ops (void)
11585 extended_remote_ops = remote_ops;
11587 extended_remote_ops.to_shortname = "extended-remote";
11588 extended_remote_ops.to_longname =
11589 "Extended remote serial target in gdb-specific protocol";
11590 extended_remote_ops.to_doc =
11591 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
11592 Specify the serial device it is connected to (e.g. /dev/ttya).";
11593 extended_remote_ops.to_open = extended_remote_open;
11594 extended_remote_ops.to_create_inferior = extended_remote_create_inferior;
11595 extended_remote_ops.to_mourn_inferior = extended_remote_mourn;
11596 extended_remote_ops.to_detach = extended_remote_detach;
11597 extended_remote_ops.to_attach = extended_remote_attach;
11598 extended_remote_ops.to_post_attach = extended_remote_post_attach;
11599 extended_remote_ops.to_kill = extended_remote_kill;
11600 extended_remote_ops.to_supports_disable_randomization
11601 = extended_remote_supports_disable_randomization;
11605 remote_can_async_p (struct target_ops *ops)
11607 struct remote_state *rs = get_remote_state ();
11609 if (!target_async_permitted)
11610 /* We only enable async when the user specifically asks for it. */
11613 /* We're async whenever the serial device is. */
11614 return serial_can_async_p (rs->remote_desc);
11618 remote_is_async_p (struct target_ops *ops)
11620 struct remote_state *rs = get_remote_state ();
11622 if (!target_async_permitted)
11623 /* We only enable async when the user specifically asks for it. */
11626 /* We're async whenever the serial device is. */
11627 return serial_is_async_p (rs->remote_desc);
11630 /* Pass the SERIAL event on and up to the client. One day this code
11631 will be able to delay notifying the client of an event until the
11632 point where an entire packet has been received. */
11634 static serial_event_ftype remote_async_serial_handler;
11637 remote_async_serial_handler (struct serial *scb, void *context)
11639 struct remote_state *rs = context;
11641 /* Don't propogate error information up to the client. Instead let
11642 the client find out about the error by querying the target. */
11643 rs->async_client_callback (INF_REG_EVENT, rs->async_client_context);
11647 remote_async_inferior_event_handler (gdb_client_data data)
11649 inferior_event_handler (INF_REG_EVENT, NULL);
11653 remote_async (struct target_ops *ops,
11654 void (*callback) (enum inferior_event_type event_type,
11658 struct remote_state *rs = get_remote_state ();
11660 if (callback != NULL)
11662 serial_async (rs->remote_desc, remote_async_serial_handler, rs);
11663 rs->async_client_callback = callback;
11664 rs->async_client_context = context;
11667 serial_async (rs->remote_desc, NULL, NULL);
11671 set_remote_cmd (char *args, int from_tty)
11673 help_list (remote_set_cmdlist, "set remote ", all_commands, gdb_stdout);
11677 show_remote_cmd (char *args, int from_tty)
11679 /* We can't just use cmd_show_list here, because we want to skip
11680 the redundant "show remote Z-packet" and the legacy aliases. */
11681 struct cleanup *showlist_chain;
11682 struct cmd_list_element *list = remote_show_cmdlist;
11683 struct ui_out *uiout = current_uiout;
11685 showlist_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "showlist");
11686 for (; list != NULL; list = list->next)
11687 if (strcmp (list->name, "Z-packet") == 0)
11689 else if (list->type == not_set_cmd)
11690 /* Alias commands are exactly like the original, except they
11691 don't have the normal type. */
11695 struct cleanup *option_chain
11696 = make_cleanup_ui_out_tuple_begin_end (uiout, "option");
11698 ui_out_field_string (uiout, "name", list->name);
11699 ui_out_text (uiout, ": ");
11700 if (list->type == show_cmd)
11701 do_show_command ((char *) NULL, from_tty, list);
11703 cmd_func (list, NULL, from_tty);
11704 /* Close the tuple. */
11705 do_cleanups (option_chain);
11708 /* Close the tuple. */
11709 do_cleanups (showlist_chain);
11713 /* Function to be called whenever a new objfile (shlib) is detected. */
11715 remote_new_objfile (struct objfile *objfile)
11717 struct remote_state *rs = get_remote_state ();
11719 if (rs->remote_desc != 0) /* Have a remote connection. */
11720 remote_check_symbols ();
11723 /* Pull all the tracepoints defined on the target and create local
11724 data structures representing them. We don't want to create real
11725 tracepoints yet, we don't want to mess up the user's existing
11729 remote_upload_tracepoints (struct target_ops *self, struct uploaded_tp **utpp)
11731 struct remote_state *rs = get_remote_state ();
11734 /* Ask for a first packet of tracepoint definition. */
11736 getpkt (&rs->buf, &rs->buf_size, 0);
11738 while (*p && *p != 'l')
11740 parse_tracepoint_definition (p, utpp);
11741 /* Ask for another packet of tracepoint definition. */
11743 getpkt (&rs->buf, &rs->buf_size, 0);
11750 remote_upload_trace_state_variables (struct target_ops *self,
11751 struct uploaded_tsv **utsvp)
11753 struct remote_state *rs = get_remote_state ();
11756 /* Ask for a first packet of variable definition. */
11758 getpkt (&rs->buf, &rs->buf_size, 0);
11760 while (*p && *p != 'l')
11762 parse_tsv_definition (p, utsvp);
11763 /* Ask for another packet of variable definition. */
11765 getpkt (&rs->buf, &rs->buf_size, 0);
11771 /* The "set/show range-stepping" show hook. */
11774 show_range_stepping (struct ui_file *file, int from_tty,
11775 struct cmd_list_element *c,
11778 fprintf_filtered (file,
11779 _("Debugger's willingness to use range stepping "
11780 "is %s.\n"), value);
11783 /* The "set/show range-stepping" set hook. */
11786 set_range_stepping (char *ignore_args, int from_tty,
11787 struct cmd_list_element *c)
11789 struct remote_state *rs = get_remote_state ();
11791 /* Whene enabling, check whether range stepping is actually
11792 supported by the target, and warn if not. */
11793 if (use_range_stepping)
11795 if (rs->remote_desc != NULL)
11797 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
11798 remote_vcont_probe (rs);
11800 if (packet_support (PACKET_vCont) == PACKET_ENABLE
11801 && rs->supports_vCont.r)
11805 warning (_("Range stepping is not supported by the current target"));
11810 _initialize_remote (void)
11812 struct remote_state *rs;
11813 struct cmd_list_element *cmd;
11814 const char *cmd_name;
11816 /* architecture specific data */
11817 remote_gdbarch_data_handle =
11818 gdbarch_data_register_post_init (init_remote_state);
11819 remote_g_packet_data_handle =
11820 gdbarch_data_register_pre_init (remote_g_packet_data_init);
11822 /* Initialize the per-target state. At the moment there is only one
11823 of these, not one per target. Only one target is active at a
11825 remote_state = new_remote_state ();
11827 init_remote_ops ();
11828 add_target (&remote_ops);
11830 init_extended_remote_ops ();
11831 add_target (&extended_remote_ops);
11833 /* Hook into new objfile notification. */
11834 observer_attach_new_objfile (remote_new_objfile);
11835 /* We're no longer interested in notification events of an inferior
11837 observer_attach_inferior_exit (discard_pending_stop_replies);
11839 /* Set up signal handlers. */
11840 async_sigint_remote_token =
11841 create_async_signal_handler (async_remote_interrupt, NULL);
11842 async_sigint_remote_twice_token =
11843 create_async_signal_handler (async_remote_interrupt_twice, NULL);
11846 init_remote_threadtests ();
11849 stop_reply_queue = QUEUE_alloc (stop_reply_p, stop_reply_xfree);
11850 /* set/show remote ... */
11852 add_prefix_cmd ("remote", class_maintenance, set_remote_cmd, _("\
11853 Remote protocol specific variables\n\
11854 Configure various remote-protocol specific variables such as\n\
11855 the packets being used"),
11856 &remote_set_cmdlist, "set remote ",
11857 0 /* allow-unknown */, &setlist);
11858 add_prefix_cmd ("remote", class_maintenance, show_remote_cmd, _("\
11859 Remote protocol specific variables\n\
11860 Configure various remote-protocol specific variables such as\n\
11861 the packets being used"),
11862 &remote_show_cmdlist, "show remote ",
11863 0 /* allow-unknown */, &showlist);
11865 add_cmd ("compare-sections", class_obscure, compare_sections_command, _("\
11866 Compare section data on target to the exec file.\n\
11867 Argument is a single section name (default: all loaded sections).\n\
11868 To compare only read-only loaded sections, specify the -r option."),
11871 add_cmd ("packet", class_maintenance, packet_command, _("\
11872 Send an arbitrary packet to a remote target.\n\
11873 maintenance packet TEXT\n\
11874 If GDB is talking to an inferior via the GDB serial protocol, then\n\
11875 this command sends the string TEXT to the inferior, and displays the\n\
11876 response packet. GDB supplies the initial `$' character, and the\n\
11877 terminating `#' character and checksum."),
11880 add_setshow_boolean_cmd ("remotebreak", no_class, &remote_break, _("\
11881 Set whether to send break if interrupted."), _("\
11882 Show whether to send break if interrupted."), _("\
11883 If set, a break, instead of a cntrl-c, is sent to the remote target."),
11884 set_remotebreak, show_remotebreak,
11885 &setlist, &showlist);
11886 cmd_name = "remotebreak";
11887 cmd = lookup_cmd (&cmd_name, setlist, "", -1, 1);
11888 deprecate_cmd (cmd, "set remote interrupt-sequence");
11889 cmd_name = "remotebreak"; /* needed because lookup_cmd updates the pointer */
11890 cmd = lookup_cmd (&cmd_name, showlist, "", -1, 1);
11891 deprecate_cmd (cmd, "show remote interrupt-sequence");
11893 add_setshow_enum_cmd ("interrupt-sequence", class_support,
11894 interrupt_sequence_modes, &interrupt_sequence_mode,
11896 Set interrupt sequence to remote target."), _("\
11897 Show interrupt sequence to remote target."), _("\
11898 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
11899 NULL, show_interrupt_sequence,
11900 &remote_set_cmdlist,
11901 &remote_show_cmdlist);
11903 add_setshow_boolean_cmd ("interrupt-on-connect", class_support,
11904 &interrupt_on_connect, _("\
11905 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
11906 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
11907 If set, interrupt sequence is sent to remote target."),
11909 &remote_set_cmdlist, &remote_show_cmdlist);
11911 /* Install commands for configuring memory read/write packets. */
11913 add_cmd ("remotewritesize", no_class, set_memory_write_packet_size, _("\
11914 Set the maximum number of bytes per memory write packet (deprecated)."),
11916 add_cmd ("remotewritesize", no_class, show_memory_write_packet_size, _("\
11917 Show the maximum number of bytes per memory write packet (deprecated)."),
11919 add_cmd ("memory-write-packet-size", no_class,
11920 set_memory_write_packet_size, _("\
11921 Set the maximum number of bytes per memory-write packet.\n\
11922 Specify the number of bytes in a packet or 0 (zero) for the\n\
11923 default packet size. The actual limit is further reduced\n\
11924 dependent on the target. Specify ``fixed'' to disable the\n\
11925 further restriction and ``limit'' to enable that restriction."),
11926 &remote_set_cmdlist);
11927 add_cmd ("memory-read-packet-size", no_class,
11928 set_memory_read_packet_size, _("\
11929 Set the maximum number of bytes per memory-read packet.\n\
11930 Specify the number of bytes in a packet or 0 (zero) for the\n\
11931 default packet size. The actual limit is further reduced\n\
11932 dependent on the target. Specify ``fixed'' to disable the\n\
11933 further restriction and ``limit'' to enable that restriction."),
11934 &remote_set_cmdlist);
11935 add_cmd ("memory-write-packet-size", no_class,
11936 show_memory_write_packet_size,
11937 _("Show the maximum number of bytes per memory-write packet."),
11938 &remote_show_cmdlist);
11939 add_cmd ("memory-read-packet-size", no_class,
11940 show_memory_read_packet_size,
11941 _("Show the maximum number of bytes per memory-read packet."),
11942 &remote_show_cmdlist);
11944 add_setshow_zinteger_cmd ("hardware-watchpoint-limit", no_class,
11945 &remote_hw_watchpoint_limit, _("\
11946 Set the maximum number of target hardware watchpoints."), _("\
11947 Show the maximum number of target hardware watchpoints."), _("\
11948 Specify a negative limit for unlimited."),
11949 NULL, NULL, /* FIXME: i18n: The maximum
11950 number of target hardware
11951 watchpoints is %s. */
11952 &remote_set_cmdlist, &remote_show_cmdlist);
11953 add_setshow_zinteger_cmd ("hardware-watchpoint-length-limit", no_class,
11954 &remote_hw_watchpoint_length_limit, _("\
11955 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
11956 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
11957 Specify a negative limit for unlimited."),
11958 NULL, NULL, /* FIXME: i18n: The maximum
11959 length (in bytes) of a target
11960 hardware watchpoint is %s. */
11961 &remote_set_cmdlist, &remote_show_cmdlist);
11962 add_setshow_zinteger_cmd ("hardware-breakpoint-limit", no_class,
11963 &remote_hw_breakpoint_limit, _("\
11964 Set the maximum number of target hardware breakpoints."), _("\
11965 Show the maximum number of target hardware breakpoints."), _("\
11966 Specify a negative limit for unlimited."),
11967 NULL, NULL, /* FIXME: i18n: The maximum
11968 number of target hardware
11969 breakpoints is %s. */
11970 &remote_set_cmdlist, &remote_show_cmdlist);
11972 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure,
11973 &remote_address_size, _("\
11974 Set the maximum size of the address (in bits) in a memory packet."), _("\
11975 Show the maximum size of the address (in bits) in a memory packet."), NULL,
11977 NULL, /* FIXME: i18n: */
11978 &setlist, &showlist);
11980 init_all_packet_configs ();
11982 add_packet_config_cmd (&remote_protocol_packets[PACKET_X],
11983 "X", "binary-download", 1);
11985 add_packet_config_cmd (&remote_protocol_packets[PACKET_vCont],
11986 "vCont", "verbose-resume", 0);
11988 add_packet_config_cmd (&remote_protocol_packets[PACKET_QPassSignals],
11989 "QPassSignals", "pass-signals", 0);
11991 add_packet_config_cmd (&remote_protocol_packets[PACKET_QProgramSignals],
11992 "QProgramSignals", "program-signals", 0);
11994 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSymbol],
11995 "qSymbol", "symbol-lookup", 0);
11997 add_packet_config_cmd (&remote_protocol_packets[PACKET_P],
11998 "P", "set-register", 1);
12000 add_packet_config_cmd (&remote_protocol_packets[PACKET_p],
12001 "p", "fetch-register", 1);
12003 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z0],
12004 "Z0", "software-breakpoint", 0);
12006 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z1],
12007 "Z1", "hardware-breakpoint", 0);
12009 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z2],
12010 "Z2", "write-watchpoint", 0);
12012 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z3],
12013 "Z3", "read-watchpoint", 0);
12015 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z4],
12016 "Z4", "access-watchpoint", 0);
12018 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_auxv],
12019 "qXfer:auxv:read", "read-aux-vector", 0);
12021 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_features],
12022 "qXfer:features:read", "target-features", 0);
12024 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries],
12025 "qXfer:libraries:read", "library-info", 0);
12027 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries_svr4],
12028 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
12030 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_memory_map],
12031 "qXfer:memory-map:read", "memory-map", 0);
12033 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_read],
12034 "qXfer:spu:read", "read-spu-object", 0);
12036 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_write],
12037 "qXfer:spu:write", "write-spu-object", 0);
12039 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_osdata],
12040 "qXfer:osdata:read", "osdata", 0);
12042 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_threads],
12043 "qXfer:threads:read", "threads", 0);
12045 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_read],
12046 "qXfer:siginfo:read", "read-siginfo-object", 0);
12048 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_write],
12049 "qXfer:siginfo:write", "write-siginfo-object", 0);
12051 add_packet_config_cmd
12052 (&remote_protocol_packets[PACKET_qXfer_traceframe_info],
12053 "qXfer:traceframe-info:read", "traceframe-info", 0);
12055 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_uib],
12056 "qXfer:uib:read", "unwind-info-block", 0);
12058 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTLSAddr],
12059 "qGetTLSAddr", "get-thread-local-storage-address",
12062 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTIBAddr],
12063 "qGetTIBAddr", "get-thread-information-block-address",
12066 add_packet_config_cmd (&remote_protocol_packets[PACKET_bc],
12067 "bc", "reverse-continue", 0);
12069 add_packet_config_cmd (&remote_protocol_packets[PACKET_bs],
12070 "bs", "reverse-step", 0);
12072 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSupported],
12073 "qSupported", "supported-packets", 0);
12075 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSearch_memory],
12076 "qSearch:memory", "search-memory", 0);
12078 add_packet_config_cmd (&remote_protocol_packets[PACKET_qTStatus],
12079 "qTStatus", "trace-status", 0);
12081 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_open],
12082 "vFile:open", "hostio-open", 0);
12084 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pread],
12085 "vFile:pread", "hostio-pread", 0);
12087 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pwrite],
12088 "vFile:pwrite", "hostio-pwrite", 0);
12090 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_close],
12091 "vFile:close", "hostio-close", 0);
12093 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_unlink],
12094 "vFile:unlink", "hostio-unlink", 0);
12096 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_readlink],
12097 "vFile:readlink", "hostio-readlink", 0);
12099 add_packet_config_cmd (&remote_protocol_packets[PACKET_vAttach],
12100 "vAttach", "attach", 0);
12102 add_packet_config_cmd (&remote_protocol_packets[PACKET_vRun],
12105 add_packet_config_cmd (&remote_protocol_packets[PACKET_QStartNoAckMode],
12106 "QStartNoAckMode", "noack", 0);
12108 add_packet_config_cmd (&remote_protocol_packets[PACKET_vKill],
12109 "vKill", "kill", 0);
12111 add_packet_config_cmd (&remote_protocol_packets[PACKET_qAttached],
12112 "qAttached", "query-attached", 0);
12114 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalTracepoints],
12115 "ConditionalTracepoints",
12116 "conditional-tracepoints", 0);
12118 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalBreakpoints],
12119 "ConditionalBreakpoints",
12120 "conditional-breakpoints", 0);
12122 add_packet_config_cmd (&remote_protocol_packets[PACKET_BreakpointCommands],
12123 "BreakpointCommands",
12124 "breakpoint-commands", 0);
12126 add_packet_config_cmd (&remote_protocol_packets[PACKET_FastTracepoints],
12127 "FastTracepoints", "fast-tracepoints", 0);
12129 add_packet_config_cmd (&remote_protocol_packets[PACKET_TracepointSource],
12130 "TracepointSource", "TracepointSource", 0);
12132 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAllow],
12133 "QAllow", "allow", 0);
12135 add_packet_config_cmd (&remote_protocol_packets[PACKET_StaticTracepoints],
12136 "StaticTracepoints", "static-tracepoints", 0);
12138 add_packet_config_cmd (&remote_protocol_packets[PACKET_InstallInTrace],
12139 "InstallInTrace", "install-in-trace", 0);
12141 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_statictrace_read],
12142 "qXfer:statictrace:read", "read-sdata-object", 0);
12144 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_fdpic],
12145 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
12147 add_packet_config_cmd (&remote_protocol_packets[PACKET_QDisableRandomization],
12148 "QDisableRandomization", "disable-randomization", 0);
12150 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAgent],
12151 "QAgent", "agent", 0);
12153 add_packet_config_cmd (&remote_protocol_packets[PACKET_QTBuffer_size],
12154 "QTBuffer:size", "trace-buffer-size", 0);
12156 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_off],
12157 "Qbtrace:off", "disable-btrace", 0);
12159 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_bts],
12160 "Qbtrace:bts", "enable-btrace", 0);
12162 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace],
12163 "qXfer:btrace", "read-btrace", 0);
12165 /* Assert that we've registered commands for all packet configs. */
12169 for (i = 0; i < PACKET_MAX; i++)
12171 /* Ideally all configs would have a command associated. Some
12172 still don't though. */
12177 case PACKET_QNonStop:
12178 case PACKET_multiprocess_feature:
12179 case PACKET_EnableDisableTracepoints_feature:
12180 case PACKET_tracenz_feature:
12181 case PACKET_DisconnectedTracing_feature:
12182 case PACKET_augmented_libraries_svr4_read_feature:
12184 /* Additions to this list need to be well justified:
12185 pre-existing packets are OK; new packets are not. */
12193 /* This catches both forgetting to add a config command, and
12194 forgetting to remove a packet from the exception list. */
12195 gdb_assert (excepted == (remote_protocol_packets[i].name == NULL));
12199 /* Keep the old ``set remote Z-packet ...'' working. Each individual
12200 Z sub-packet has its own set and show commands, but users may
12201 have sets to this variable in their .gdbinit files (or in their
12203 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure,
12204 &remote_Z_packet_detect, _("\
12205 Set use of remote protocol `Z' packets"), _("\
12206 Show use of remote protocol `Z' packets "), _("\
12207 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
12209 set_remote_protocol_Z_packet_cmd,
12210 show_remote_protocol_Z_packet_cmd,
12211 /* FIXME: i18n: Use of remote protocol
12212 `Z' packets is %s. */
12213 &remote_set_cmdlist, &remote_show_cmdlist);
12215 add_prefix_cmd ("remote", class_files, remote_command, _("\
12216 Manipulate files on the remote system\n\
12217 Transfer files to and from the remote target system."),
12218 &remote_cmdlist, "remote ",
12219 0 /* allow-unknown */, &cmdlist);
12221 add_cmd ("put", class_files, remote_put_command,
12222 _("Copy a local file to the remote system."),
12225 add_cmd ("get", class_files, remote_get_command,
12226 _("Copy a remote file to the local system."),
12229 add_cmd ("delete", class_files, remote_delete_command,
12230 _("Delete a remote file."),
12233 remote_exec_file = xstrdup ("");
12234 add_setshow_string_noescape_cmd ("exec-file", class_files,
12235 &remote_exec_file, _("\
12236 Set the remote pathname for \"run\""), _("\
12237 Show the remote pathname for \"run\""), NULL, NULL, NULL,
12238 &remote_set_cmdlist, &remote_show_cmdlist);
12240 add_setshow_boolean_cmd ("range-stepping", class_run,
12241 &use_range_stepping, _("\
12242 Enable or disable range stepping."), _("\
12243 Show whether target-assisted range stepping is enabled."), _("\
12244 If on, and the target supports it, when stepping a source line, GDB\n\
12245 tells the target to step the corresponding range of addresses itself instead\n\
12246 of issuing multiple single-steps. This speeds up source level\n\
12247 stepping. If off, GDB always issues single-steps, even if range\n\
12248 stepping is supported by the target. The default is on."),
12249 set_range_stepping,
12250 show_range_stepping,
12254 /* Eventually initialize fileio. See fileio.c */
12255 initialize_remote_fileio (remote_set_cmdlist, remote_show_cmdlist);
12257 /* Take advantage of the fact that the TID field is not used, to tag
12258 special ptids with it set to != 0. */
12259 magic_null_ptid = ptid_build (42000, -1, 1);
12260 not_sent_ptid = ptid_build (42000, -2, 1);
12261 any_thread_ptid = ptid_build (42000, 0, 1);
12263 target_buf_size = 2048;
12264 target_buf = xmalloc (target_buf_size);