1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2015 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_send (char **buf, long *sizeof_buf_p);
115 static int readchar (int timeout);
117 static void remote_serial_write (const char *str, int len);
119 static void remote_kill (struct target_ops *ops);
121 static int remote_can_async_p (struct target_ops *);
123 static int remote_is_async_p (struct target_ops *);
125 static void remote_async (struct target_ops *ops, int enable);
127 static void sync_remote_interrupt_twice (int signo);
129 static void interrupt_query (void);
131 static void set_general_thread (struct ptid ptid);
132 static void set_continue_thread (struct ptid ptid);
134 static void get_offsets (void);
136 static void skip_frame (void);
138 static long read_frame (char **buf_p, long *sizeof_buf);
140 static int hexnumlen (ULONGEST num);
142 static void init_remote_ops (void);
144 static void init_extended_remote_ops (void);
146 static void remote_stop (struct target_ops *self, ptid_t);
148 static int stubhex (int ch);
150 static int hexnumstr (char *, ULONGEST);
152 static int hexnumnstr (char *, ULONGEST, int);
154 static CORE_ADDR remote_address_masked (CORE_ADDR);
156 static void print_packet (const char *);
158 static void compare_sections_command (char *, int);
160 static void packet_command (char *, int);
162 static int stub_unpack_int (char *buff, int fieldlength);
164 static ptid_t remote_current_thread (ptid_t oldptid);
166 static int putpkt_binary (const char *buf, int cnt);
168 static void check_binary_download (CORE_ADDR addr);
170 struct packet_config;
172 static void show_packet_config_cmd (struct packet_config *config);
174 static void show_remote_protocol_packet_cmd (struct ui_file *file,
176 struct cmd_list_element *c,
179 static char *write_ptid (char *buf, const char *endbuf, ptid_t ptid);
180 static ptid_t read_ptid (char *buf, char **obuf);
182 static void remote_set_permissions (struct target_ops *self);
185 static int remote_get_trace_status (struct target_ops *self,
186 struct trace_status *ts);
188 static int remote_upload_tracepoints (struct target_ops *self,
189 struct uploaded_tp **utpp);
191 static int remote_upload_trace_state_variables (struct target_ops *self,
192 struct uploaded_tsv **utsvp);
194 static void remote_query_supported (void);
196 static void remote_check_symbols (void);
198 void _initialize_remote (void);
201 static void stop_reply_xfree (struct stop_reply *);
202 static void remote_parse_stop_reply (char *, struct stop_reply *);
203 static void push_stop_reply (struct stop_reply *);
204 static void discard_pending_stop_replies_in_queue (struct remote_state *);
205 static int peek_stop_reply (ptid_t ptid);
207 static void remote_async_inferior_event_handler (gdb_client_data);
209 static void remote_terminal_ours (struct target_ops *self);
211 static int remote_read_description_p (struct target_ops *target);
213 static void remote_console_output (char *msg);
215 static int remote_supports_cond_breakpoints (struct target_ops *self);
217 static int remote_can_run_breakpoint_commands (struct target_ops *self);
219 static void remote_btrace_reset (void);
223 static struct cmd_list_element *remote_cmdlist;
225 /* For "set remote" and "show remote". */
227 static struct cmd_list_element *remote_set_cmdlist;
228 static struct cmd_list_element *remote_show_cmdlist;
230 /* Stub vCont actions support.
232 Each field is a boolean flag indicating whether the stub reports
233 support for the corresponding action. */
235 struct vCont_action_support
244 /* Controls whether GDB is willing to use range stepping. */
246 static int use_range_stepping = 1;
248 #define OPAQUETHREADBYTES 8
250 /* a 64 bit opaque identifier */
251 typedef unsigned char threadref[OPAQUETHREADBYTES];
253 /* About this many threadisds fit in a packet. */
255 #define MAXTHREADLISTRESULTS 32
257 /* Description of the remote protocol state for the currently
258 connected target. This is per-target state, and independent of the
259 selected architecture. */
263 /* A buffer to use for incoming packets, and its current size. The
264 buffer is grown dynamically for larger incoming packets.
265 Outgoing packets may also be constructed in this buffer.
266 BUF_SIZE is always at least REMOTE_PACKET_SIZE;
267 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
272 /* True if we're going through initial connection setup (finding out
273 about the remote side's threads, relocating symbols, etc.). */
276 /* If we negotiated packet size explicitly (and thus can bypass
277 heuristics for the largest packet size that will not overflow
278 a buffer in the stub), this will be set to that packet size.
279 Otherwise zero, meaning to use the guessed size. */
280 long explicit_packet_size;
282 /* remote_wait is normally called when the target is running and
283 waits for a stop reply packet. But sometimes we need to call it
284 when the target is already stopped. We can send a "?" packet
285 and have remote_wait read the response. Or, if we already have
286 the response, we can stash it in BUF and tell remote_wait to
287 skip calling getpkt. This flag is set when BUF contains a
288 stop reply packet and the target is not waiting. */
289 int cached_wait_status;
291 /* True, if in no ack mode. That is, neither GDB nor the stub will
292 expect acks from each other. The connection is assumed to be
296 /* True if we're connected in extended remote mode. */
299 /* True if we resumed the target and we're waiting for the target to
300 stop. In the mean time, we can't start another command/query.
301 The remote server wouldn't be ready to process it, so we'd
302 timeout waiting for a reply that would never come and eventually
303 we'd close the connection. This can happen in asynchronous mode
304 because we allow GDB commands while the target is running. */
305 int waiting_for_stop_reply;
307 /* The status of the stub support for the various vCont actions. */
308 struct vCont_action_support supports_vCont;
310 /* Nonzero if the user has pressed Ctrl-C, but the target hasn't
311 responded to that. */
314 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
315 remote_open knows that we don't have a file open when the program
317 struct serial *remote_desc;
319 /* These are the threads which we last sent to the remote system. The
320 TID member will be -1 for all or -2 for not sent yet. */
321 ptid_t general_thread;
322 ptid_t continue_thread;
324 /* This is the traceframe which we last selected on the remote system.
325 It will be -1 if no traceframe is selected. */
326 int remote_traceframe_number;
328 char *last_pass_packet;
330 /* The last QProgramSignals packet sent to the target. We bypass
331 sending a new program signals list down to the target if the new
332 packet is exactly the same as the last we sent. IOW, we only let
333 the target know about program signals list changes. */
334 char *last_program_signals_packet;
336 enum gdb_signal last_sent_signal;
340 char *finished_object;
341 char *finished_annex;
342 ULONGEST finished_offset;
344 /* Should we try the 'ThreadInfo' query packet?
346 This variable (NOT available to the user: auto-detect only!)
347 determines whether GDB will use the new, simpler "ThreadInfo"
348 query or the older, more complex syntax for thread queries.
349 This is an auto-detect variable (set to true at each connect,
350 and set to false when the target fails to recognize it). */
351 int use_threadinfo_query;
352 int use_threadextra_query;
354 /* This is set to the data address of the access causing the target
355 to stop for a watchpoint. */
356 CORE_ADDR remote_watch_data_address;
358 /* Whether the target stopped for a breakpoint/watchpoint. */
359 enum target_stop_reason stop_reason;
361 threadref echo_nextthread;
362 threadref nextthread;
363 threadref resultthreadlist[MAXTHREADLISTRESULTS];
365 /* The state of remote notification. */
366 struct remote_notif_state *notif_state;
368 /* The branch trace configuration. */
369 struct btrace_config btrace_config;
372 /* Private data that we'll store in (struct thread_info)->private. */
373 struct private_thread_info
380 free_private_thread_info (struct private_thread_info *info)
386 /* This data could be associated with a target, but we do not always
387 have access to the current target when we need it, so for now it is
388 static. This will be fine for as long as only one target is in use
390 static struct remote_state *remote_state;
392 static struct remote_state *
393 get_remote_state_raw (void)
398 /* Allocate a new struct remote_state with xmalloc, initialize it, and
401 static struct remote_state *
402 new_remote_state (void)
404 struct remote_state *result = XCNEW (struct remote_state);
406 /* The default buffer size is unimportant; it will be expanded
407 whenever a larger buffer is needed. */
408 result->buf_size = 400;
409 result->buf = xmalloc (result->buf_size);
410 result->remote_traceframe_number = -1;
411 result->last_sent_signal = GDB_SIGNAL_0;
416 /* Description of the remote protocol for a given architecture. */
420 long offset; /* Offset into G packet. */
421 long regnum; /* GDB's internal register number. */
422 LONGEST pnum; /* Remote protocol register number. */
423 int in_g_packet; /* Always part of G packet. */
424 /* long size in bytes; == register_size (target_gdbarch (), regnum);
426 /* char *name; == gdbarch_register_name (target_gdbarch (), regnum);
430 struct remote_arch_state
432 /* Description of the remote protocol registers. */
433 long sizeof_g_packet;
435 /* Description of the remote protocol registers indexed by REGNUM
436 (making an array gdbarch_num_regs in size). */
437 struct packet_reg *regs;
439 /* This is the size (in chars) of the first response to the ``g''
440 packet. It is used as a heuristic when determining the maximum
441 size of memory-read and memory-write packets. A target will
442 typically only reserve a buffer large enough to hold the ``g''
443 packet. The size does not include packet overhead (headers and
445 long actual_register_packet_size;
447 /* This is the maximum size (in chars) of a non read/write packet.
448 It is also used as a cap on the size of read/write packets. */
449 long remote_packet_size;
452 /* Utility: generate error from an incoming stub packet. */
454 trace_error (char *buf)
457 return; /* not an error msg */
460 case '1': /* malformed packet error */
461 if (*++buf == '0') /* general case: */
462 error (_("remote.c: error in outgoing packet."));
464 error (_("remote.c: error in outgoing packet at field #%ld."),
465 strtol (buf, NULL, 16));
467 error (_("Target returns error code '%s'."), buf);
471 /* Utility: wait for reply from stub, while accepting "O" packets. */
473 remote_get_noisy_reply (char **buf_p,
476 do /* Loop on reply from remote stub. */
480 QUIT; /* Allow user to bail out with ^C. */
481 getpkt (buf_p, sizeof_buf, 0);
485 else if (startswith (buf, "qRelocInsn:"))
488 CORE_ADDR from, to, org_to;
490 int adjusted_size = 0;
493 p = buf + strlen ("qRelocInsn:");
494 pp = unpack_varlen_hex (p, &ul);
496 error (_("invalid qRelocInsn packet: %s"), buf);
500 unpack_varlen_hex (p, &ul);
507 gdbarch_relocate_instruction (target_gdbarch (), &to, from);
510 CATCH (ex, RETURN_MASK_ALL)
512 if (ex.error == MEMORY_ERROR)
514 /* Propagate memory errors silently back to the
515 target. The stub may have limited the range of
516 addresses we can write to, for example. */
520 /* Something unexpectedly bad happened. Be verbose
521 so we can tell what, and propagate the error back
522 to the stub, so it doesn't get stuck waiting for
524 exception_fprintf (gdb_stderr, ex,
525 _("warning: relocating instruction: "));
533 adjusted_size = to - org_to;
535 xsnprintf (buf, *sizeof_buf, "qRelocInsn:%x", adjusted_size);
539 else if (buf[0] == 'O' && buf[1] != 'K')
540 remote_console_output (buf + 1); /* 'O' message from stub */
542 return buf; /* Here's the actual reply. */
547 /* Handle for retreving the remote protocol data from gdbarch. */
548 static struct gdbarch_data *remote_gdbarch_data_handle;
550 static struct remote_arch_state *
551 get_remote_arch_state (void)
553 return gdbarch_data (target_gdbarch (), remote_gdbarch_data_handle);
556 /* Fetch the global remote target state. */
558 static struct remote_state *
559 get_remote_state (void)
561 /* Make sure that the remote architecture state has been
562 initialized, because doing so might reallocate rs->buf. Any
563 function which calls getpkt also needs to be mindful of changes
564 to rs->buf, but this call limits the number of places which run
566 get_remote_arch_state ();
568 return get_remote_state_raw ();
572 compare_pnums (const void *lhs_, const void *rhs_)
574 const struct packet_reg * const *lhs = lhs_;
575 const struct packet_reg * const *rhs = rhs_;
577 if ((*lhs)->pnum < (*rhs)->pnum)
579 else if ((*lhs)->pnum == (*rhs)->pnum)
586 map_regcache_remote_table (struct gdbarch *gdbarch, struct packet_reg *regs)
588 int regnum, num_remote_regs, offset;
589 struct packet_reg **remote_regs;
591 for (regnum = 0; regnum < gdbarch_num_regs (gdbarch); regnum++)
593 struct packet_reg *r = ®s[regnum];
595 if (register_size (gdbarch, regnum) == 0)
596 /* Do not try to fetch zero-sized (placeholder) registers. */
599 r->pnum = gdbarch_remote_register_number (gdbarch, regnum);
604 /* Define the g/G packet format as the contents of each register
605 with a remote protocol number, in order of ascending protocol
608 remote_regs = alloca (gdbarch_num_regs (gdbarch)
609 * sizeof (struct packet_reg *));
610 for (num_remote_regs = 0, regnum = 0;
611 regnum < gdbarch_num_regs (gdbarch);
613 if (regs[regnum].pnum != -1)
614 remote_regs[num_remote_regs++] = ®s[regnum];
616 qsort (remote_regs, num_remote_regs, sizeof (struct packet_reg *),
619 for (regnum = 0, offset = 0; regnum < num_remote_regs; regnum++)
621 remote_regs[regnum]->in_g_packet = 1;
622 remote_regs[regnum]->offset = offset;
623 offset += register_size (gdbarch, remote_regs[regnum]->regnum);
629 /* Given the architecture described by GDBARCH, return the remote
630 protocol register's number and the register's offset in the g/G
631 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
632 If the target does not have a mapping for REGNUM, return false,
633 otherwise, return true. */
636 remote_register_number_and_offset (struct gdbarch *gdbarch, int regnum,
637 int *pnum, int *poffset)
640 struct packet_reg *regs;
641 struct cleanup *old_chain;
643 gdb_assert (regnum < gdbarch_num_regs (gdbarch));
645 regs = xcalloc (gdbarch_num_regs (gdbarch), sizeof (struct packet_reg));
646 old_chain = make_cleanup (xfree, regs);
648 sizeof_g_packet = map_regcache_remote_table (gdbarch, regs);
650 *pnum = regs[regnum].pnum;
651 *poffset = regs[regnum].offset;
653 do_cleanups (old_chain);
659 init_remote_state (struct gdbarch *gdbarch)
661 struct remote_state *rs = get_remote_state_raw ();
662 struct remote_arch_state *rsa;
664 rsa = GDBARCH_OBSTACK_ZALLOC (gdbarch, struct remote_arch_state);
666 /* Use the architecture to build a regnum<->pnum table, which will be
667 1:1 unless a feature set specifies otherwise. */
668 rsa->regs = GDBARCH_OBSTACK_CALLOC (gdbarch,
669 gdbarch_num_regs (gdbarch),
672 /* Record the maximum possible size of the g packet - it may turn out
674 rsa->sizeof_g_packet = map_regcache_remote_table (gdbarch, rsa->regs);
676 /* Default maximum number of characters in a packet body. Many
677 remote stubs have a hardwired buffer size of 400 bytes
678 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
679 as the maximum packet-size to ensure that the packet and an extra
680 NUL character can always fit in the buffer. This stops GDB
681 trashing stubs that try to squeeze an extra NUL into what is
682 already a full buffer (As of 1999-12-04 that was most stubs). */
683 rsa->remote_packet_size = 400 - 1;
685 /* This one is filled in when a ``g'' packet is received. */
686 rsa->actual_register_packet_size = 0;
688 /* Should rsa->sizeof_g_packet needs more space than the
689 default, adjust the size accordingly. Remember that each byte is
690 encoded as two characters. 32 is the overhead for the packet
691 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
692 (``$NN:G...#NN'') is a better guess, the below has been padded a
694 if (rsa->sizeof_g_packet > ((rsa->remote_packet_size - 32) / 2))
695 rsa->remote_packet_size = (rsa->sizeof_g_packet * 2 + 32);
697 /* Make sure that the packet buffer is plenty big enough for
698 this architecture. */
699 if (rs->buf_size < rsa->remote_packet_size)
701 rs->buf_size = 2 * rsa->remote_packet_size;
702 rs->buf = xrealloc (rs->buf, rs->buf_size);
708 /* Return the current allowed size of a remote packet. This is
709 inferred from the current architecture, and should be used to
710 limit the length of outgoing packets. */
712 get_remote_packet_size (void)
714 struct remote_state *rs = get_remote_state ();
715 struct remote_arch_state *rsa = get_remote_arch_state ();
717 if (rs->explicit_packet_size)
718 return rs->explicit_packet_size;
720 return rsa->remote_packet_size;
723 static struct packet_reg *
724 packet_reg_from_regnum (struct remote_arch_state *rsa, long regnum)
726 if (regnum < 0 && regnum >= gdbarch_num_regs (target_gdbarch ()))
730 struct packet_reg *r = &rsa->regs[regnum];
732 gdb_assert (r->regnum == regnum);
737 static struct packet_reg *
738 packet_reg_from_pnum (struct remote_arch_state *rsa, LONGEST pnum)
742 for (i = 0; i < gdbarch_num_regs (target_gdbarch ()); i++)
744 struct packet_reg *r = &rsa->regs[i];
752 static struct target_ops remote_ops;
754 static struct target_ops extended_remote_ops;
756 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
757 ``forever'' still use the normal timeout mechanism. This is
758 currently used by the ASYNC code to guarentee that target reads
759 during the initial connect always time-out. Once getpkt has been
760 modified to return a timeout indication and, in turn
761 remote_wait()/wait_for_inferior() have gained a timeout parameter
763 static int wait_forever_enabled_p = 1;
765 /* Allow the user to specify what sequence to send to the remote
766 when he requests a program interruption: Although ^C is usually
767 what remote systems expect (this is the default, here), it is
768 sometimes preferable to send a break. On other systems such
769 as the Linux kernel, a break followed by g, which is Magic SysRq g
770 is required in order to interrupt the execution. */
771 const char interrupt_sequence_control_c[] = "Ctrl-C";
772 const char interrupt_sequence_break[] = "BREAK";
773 const char interrupt_sequence_break_g[] = "BREAK-g";
774 static const char *const interrupt_sequence_modes[] =
776 interrupt_sequence_control_c,
777 interrupt_sequence_break,
778 interrupt_sequence_break_g,
781 static const char *interrupt_sequence_mode = interrupt_sequence_control_c;
784 show_interrupt_sequence (struct ui_file *file, int from_tty,
785 struct cmd_list_element *c,
788 if (interrupt_sequence_mode == interrupt_sequence_control_c)
789 fprintf_filtered (file,
790 _("Send the ASCII ETX character (Ctrl-c) "
791 "to the remote target to interrupt the "
792 "execution of the program.\n"));
793 else if (interrupt_sequence_mode == interrupt_sequence_break)
794 fprintf_filtered (file,
795 _("send a break signal to the remote target "
796 "to interrupt the execution of the program.\n"));
797 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
798 fprintf_filtered (file,
799 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
800 "the remote target to interrupt the execution "
801 "of Linux kernel.\n"));
803 internal_error (__FILE__, __LINE__,
804 _("Invalid value for interrupt_sequence_mode: %s."),
805 interrupt_sequence_mode);
808 /* This boolean variable specifies whether interrupt_sequence is sent
809 to the remote target when gdb connects to it.
810 This is mostly needed when you debug the Linux kernel: The Linux kernel
811 expects BREAK g which is Magic SysRq g for connecting gdb. */
812 static int interrupt_on_connect = 0;
814 /* This variable is used to implement the "set/show remotebreak" commands.
815 Since these commands are now deprecated in favor of "set/show remote
816 interrupt-sequence", it no longer has any effect on the code. */
817 static int remote_break;
820 set_remotebreak (char *args, int from_tty, struct cmd_list_element *c)
823 interrupt_sequence_mode = interrupt_sequence_break;
825 interrupt_sequence_mode = interrupt_sequence_control_c;
829 show_remotebreak (struct ui_file *file, int from_tty,
830 struct cmd_list_element *c,
835 /* This variable sets the number of bits in an address that are to be
836 sent in a memory ("M" or "m") packet. Normally, after stripping
837 leading zeros, the entire address would be sent. This variable
838 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
839 initial implementation of remote.c restricted the address sent in
840 memory packets to ``host::sizeof long'' bytes - (typically 32
841 bits). Consequently, for 64 bit targets, the upper 32 bits of an
842 address was never sent. Since fixing this bug may cause a break in
843 some remote targets this variable is principly provided to
844 facilitate backward compatibility. */
846 static unsigned int remote_address_size;
848 /* Temporary to track who currently owns the terminal. See
849 remote_terminal_* for more details. */
851 static int remote_async_terminal_ours_p;
853 /* The executable file to use for "run" on the remote side. */
855 static char *remote_exec_file = "";
858 /* User configurable variables for the number of characters in a
859 memory read/write packet. MIN (rsa->remote_packet_size,
860 rsa->sizeof_g_packet) is the default. Some targets need smaller
861 values (fifo overruns, et.al.) and some users need larger values
862 (speed up transfers). The variables ``preferred_*'' (the user
863 request), ``current_*'' (what was actually set) and ``forced_*''
864 (Positive - a soft limit, negative - a hard limit). */
866 struct memory_packet_config
873 /* Compute the current size of a read/write packet. Since this makes
874 use of ``actual_register_packet_size'' the computation is dynamic. */
877 get_memory_packet_size (struct memory_packet_config *config)
879 struct remote_state *rs = get_remote_state ();
880 struct remote_arch_state *rsa = get_remote_arch_state ();
882 /* NOTE: The somewhat arbitrary 16k comes from the knowledge (folk
883 law?) that some hosts don't cope very well with large alloca()
884 calls. Eventually the alloca() code will be replaced by calls to
885 xmalloc() and make_cleanups() allowing this restriction to either
886 be lifted or removed. */
887 #ifndef MAX_REMOTE_PACKET_SIZE
888 #define MAX_REMOTE_PACKET_SIZE 16384
890 /* NOTE: 20 ensures we can write at least one byte. */
891 #ifndef MIN_REMOTE_PACKET_SIZE
892 #define MIN_REMOTE_PACKET_SIZE 20
897 if (config->size <= 0)
898 what_they_get = MAX_REMOTE_PACKET_SIZE;
900 what_they_get = config->size;
904 what_they_get = get_remote_packet_size ();
905 /* Limit the packet to the size specified by the user. */
907 && what_they_get > config->size)
908 what_they_get = config->size;
910 /* Limit it to the size of the targets ``g'' response unless we have
911 permission from the stub to use a larger packet size. */
912 if (rs->explicit_packet_size == 0
913 && rsa->actual_register_packet_size > 0
914 && what_they_get > rsa->actual_register_packet_size)
915 what_they_get = rsa->actual_register_packet_size;
917 if (what_they_get > MAX_REMOTE_PACKET_SIZE)
918 what_they_get = MAX_REMOTE_PACKET_SIZE;
919 if (what_they_get < MIN_REMOTE_PACKET_SIZE)
920 what_they_get = MIN_REMOTE_PACKET_SIZE;
922 /* Make sure there is room in the global buffer for this packet
923 (including its trailing NUL byte). */
924 if (rs->buf_size < what_they_get + 1)
926 rs->buf_size = 2 * what_they_get;
927 rs->buf = xrealloc (rs->buf, 2 * what_they_get);
930 return what_they_get;
933 /* Update the size of a read/write packet. If they user wants
934 something really big then do a sanity check. */
937 set_memory_packet_size (char *args, struct memory_packet_config *config)
939 int fixed_p = config->fixed_p;
940 long size = config->size;
943 error (_("Argument required (integer, `fixed' or `limited')."));
944 else if (strcmp (args, "hard") == 0
945 || strcmp (args, "fixed") == 0)
947 else if (strcmp (args, "soft") == 0
948 || strcmp (args, "limit") == 0)
954 size = strtoul (args, &end, 0);
956 error (_("Invalid %s (bad syntax)."), config->name);
958 /* Instead of explicitly capping the size of a packet to
959 MAX_REMOTE_PACKET_SIZE or dissallowing it, the user is
960 instead allowed to set the size to something arbitrarily
962 if (size > MAX_REMOTE_PACKET_SIZE)
963 error (_("Invalid %s (too large)."), config->name);
967 if (fixed_p && !config->fixed_p)
969 if (! query (_("The target may not be able to correctly handle a %s\n"
970 "of %ld bytes. Change the packet size? "),
972 error (_("Packet size not changed."));
974 /* Update the config. */
975 config->fixed_p = fixed_p;
980 show_memory_packet_size (struct memory_packet_config *config)
982 printf_filtered (_("The %s is %ld. "), config->name, config->size);
984 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
985 get_memory_packet_size (config));
987 printf_filtered (_("Packets are limited to %ld bytes.\n"),
988 get_memory_packet_size (config));
991 static struct memory_packet_config memory_write_packet_config =
993 "memory-write-packet-size",
997 set_memory_write_packet_size (char *args, int from_tty)
999 set_memory_packet_size (args, &memory_write_packet_config);
1003 show_memory_write_packet_size (char *args, int from_tty)
1005 show_memory_packet_size (&memory_write_packet_config);
1009 get_memory_write_packet_size (void)
1011 return get_memory_packet_size (&memory_write_packet_config);
1014 static struct memory_packet_config memory_read_packet_config =
1016 "memory-read-packet-size",
1020 set_memory_read_packet_size (char *args, int from_tty)
1022 set_memory_packet_size (args, &memory_read_packet_config);
1026 show_memory_read_packet_size (char *args, int from_tty)
1028 show_memory_packet_size (&memory_read_packet_config);
1032 get_memory_read_packet_size (void)
1034 long size = get_memory_packet_size (&memory_read_packet_config);
1036 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1037 extra buffer size argument before the memory read size can be
1038 increased beyond this. */
1039 if (size > get_remote_packet_size ())
1040 size = get_remote_packet_size ();
1045 /* Generic configuration support for packets the stub optionally
1046 supports. Allows the user to specify the use of the packet as well
1047 as allowing GDB to auto-detect support in the remote stub. */
1051 PACKET_SUPPORT_UNKNOWN = 0,
1056 struct packet_config
1061 /* If auto, GDB auto-detects support for this packet or feature,
1062 either through qSupported, or by trying the packet and looking
1063 at the response. If true, GDB assumes the target supports this
1064 packet. If false, the packet is disabled. Configs that don't
1065 have an associated command always have this set to auto. */
1066 enum auto_boolean detect;
1068 /* Does the target support this packet? */
1069 enum packet_support support;
1072 /* Analyze a packet's return value and update the packet config
1082 static enum packet_support packet_config_support (struct packet_config *config);
1083 static enum packet_support packet_support (int packet);
1086 show_packet_config_cmd (struct packet_config *config)
1088 char *support = "internal-error";
1090 switch (packet_config_support (config))
1093 support = "enabled";
1095 case PACKET_DISABLE:
1096 support = "disabled";
1098 case PACKET_SUPPORT_UNKNOWN:
1099 support = "unknown";
1102 switch (config->detect)
1104 case AUTO_BOOLEAN_AUTO:
1105 printf_filtered (_("Support for the `%s' packet "
1106 "is auto-detected, currently %s.\n"),
1107 config->name, support);
1109 case AUTO_BOOLEAN_TRUE:
1110 case AUTO_BOOLEAN_FALSE:
1111 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1112 config->name, support);
1118 add_packet_config_cmd (struct packet_config *config, const char *name,
1119 const char *title, int legacy)
1125 config->name = name;
1126 config->title = title;
1127 set_doc = xstrprintf ("Set use of remote protocol `%s' (%s) packet",
1129 show_doc = xstrprintf ("Show current use of remote "
1130 "protocol `%s' (%s) packet",
1132 /* set/show TITLE-packet {auto,on,off} */
1133 cmd_name = xstrprintf ("%s-packet", title);
1134 add_setshow_auto_boolean_cmd (cmd_name, class_obscure,
1135 &config->detect, set_doc,
1136 show_doc, NULL, /* help_doc */
1138 show_remote_protocol_packet_cmd,
1139 &remote_set_cmdlist, &remote_show_cmdlist);
1140 /* The command code copies the documentation strings. */
1143 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1148 legacy_name = xstrprintf ("%s-packet", name);
1149 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1150 &remote_set_cmdlist);
1151 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1152 &remote_show_cmdlist);
1156 static enum packet_result
1157 packet_check_result (const char *buf)
1161 /* The stub recognized the packet request. Check that the
1162 operation succeeded. */
1164 && isxdigit (buf[1]) && isxdigit (buf[2])
1166 /* "Enn" - definitly an error. */
1167 return PACKET_ERROR;
1169 /* Always treat "E." as an error. This will be used for
1170 more verbose error messages, such as E.memtypes. */
1171 if (buf[0] == 'E' && buf[1] == '.')
1172 return PACKET_ERROR;
1174 /* The packet may or may not be OK. Just assume it is. */
1178 /* The stub does not support the packet. */
1179 return PACKET_UNKNOWN;
1182 static enum packet_result
1183 packet_ok (const char *buf, struct packet_config *config)
1185 enum packet_result result;
1187 if (config->detect != AUTO_BOOLEAN_TRUE
1188 && config->support == PACKET_DISABLE)
1189 internal_error (__FILE__, __LINE__,
1190 _("packet_ok: attempt to use a disabled packet"));
1192 result = packet_check_result (buf);
1197 /* The stub recognized the packet request. */
1198 if (config->support == PACKET_SUPPORT_UNKNOWN)
1201 fprintf_unfiltered (gdb_stdlog,
1202 "Packet %s (%s) is supported\n",
1203 config->name, config->title);
1204 config->support = PACKET_ENABLE;
1207 case PACKET_UNKNOWN:
1208 /* The stub does not support the packet. */
1209 if (config->detect == AUTO_BOOLEAN_AUTO
1210 && config->support == PACKET_ENABLE)
1212 /* If the stub previously indicated that the packet was
1213 supported then there is a protocol error. */
1214 error (_("Protocol error: %s (%s) conflicting enabled responses."),
1215 config->name, config->title);
1217 else if (config->detect == AUTO_BOOLEAN_TRUE)
1219 /* The user set it wrong. */
1220 error (_("Enabled packet %s (%s) not recognized by stub"),
1221 config->name, config->title);
1225 fprintf_unfiltered (gdb_stdlog,
1226 "Packet %s (%s) is NOT supported\n",
1227 config->name, config->title);
1228 config->support = PACKET_DISABLE;
1248 PACKET_vFile_pwrite,
1250 PACKET_vFile_unlink,
1251 PACKET_vFile_readlink,
1254 PACKET_qXfer_features,
1255 PACKET_qXfer_exec_file,
1256 PACKET_qXfer_libraries,
1257 PACKET_qXfer_libraries_svr4,
1258 PACKET_qXfer_memory_map,
1259 PACKET_qXfer_spu_read,
1260 PACKET_qXfer_spu_write,
1261 PACKET_qXfer_osdata,
1262 PACKET_qXfer_threads,
1263 PACKET_qXfer_statictrace_read,
1264 PACKET_qXfer_traceframe_info,
1270 PACKET_QPassSignals,
1271 PACKET_QProgramSignals,
1273 PACKET_qSearch_memory,
1276 PACKET_QStartNoAckMode,
1278 PACKET_qXfer_siginfo_read,
1279 PACKET_qXfer_siginfo_write,
1282 /* Support for conditional tracepoints. */
1283 PACKET_ConditionalTracepoints,
1285 /* Support for target-side breakpoint conditions. */
1286 PACKET_ConditionalBreakpoints,
1288 /* Support for target-side breakpoint commands. */
1289 PACKET_BreakpointCommands,
1291 /* Support for fast tracepoints. */
1292 PACKET_FastTracepoints,
1294 /* Support for static tracepoints. */
1295 PACKET_StaticTracepoints,
1297 /* Support for installing tracepoints while a trace experiment is
1299 PACKET_InstallInTrace,
1303 PACKET_TracepointSource,
1306 PACKET_QDisableRandomization,
1308 PACKET_QTBuffer_size,
1311 PACKET_qXfer_btrace,
1313 /* Support for the QNonStop packet. */
1316 /* Support for multi-process extensions. */
1317 PACKET_multiprocess_feature,
1319 /* Support for enabling and disabling tracepoints while a trace
1320 experiment is running. */
1321 PACKET_EnableDisableTracepoints_feature,
1323 /* Support for collecting strings using the tracenz bytecode. */
1324 PACKET_tracenz_feature,
1326 /* Support for continuing to run a trace experiment while GDB is
1328 PACKET_DisconnectedTracing_feature,
1330 /* Support for qXfer:libraries-svr4:read with a non-empty annex. */
1331 PACKET_augmented_libraries_svr4_read_feature,
1333 /* Support for the qXfer:btrace-conf:read packet. */
1334 PACKET_qXfer_btrace_conf,
1336 /* Support for the Qbtrace-conf:bts:size packet. */
1337 PACKET_Qbtrace_conf_bts_size,
1339 /* Support for swbreak+ feature. */
1340 PACKET_swbreak_feature,
1342 /* Support for hwbreak+ feature. */
1343 PACKET_hwbreak_feature,
1345 /* Support for fork events. */
1346 PACKET_fork_event_feature,
1348 /* Support for vfork events. */
1349 PACKET_vfork_event_feature,
1354 static struct packet_config remote_protocol_packets[PACKET_MAX];
1356 /* Returns the packet's corresponding "set remote foo-packet" command
1357 state. See struct packet_config for more details. */
1359 static enum auto_boolean
1360 packet_set_cmd_state (int packet)
1362 return remote_protocol_packets[packet].detect;
1365 /* Returns whether a given packet or feature is supported. This takes
1366 into account the state of the corresponding "set remote foo-packet"
1367 command, which may be used to bypass auto-detection. */
1369 static enum packet_support
1370 packet_config_support (struct packet_config *config)
1372 switch (config->detect)
1374 case AUTO_BOOLEAN_TRUE:
1375 return PACKET_ENABLE;
1376 case AUTO_BOOLEAN_FALSE:
1377 return PACKET_DISABLE;
1378 case AUTO_BOOLEAN_AUTO:
1379 return config->support;
1381 gdb_assert_not_reached (_("bad switch"));
1385 /* Same as packet_config_support, but takes the packet's enum value as
1388 static enum packet_support
1389 packet_support (int packet)
1391 struct packet_config *config = &remote_protocol_packets[packet];
1393 return packet_config_support (config);
1397 show_remote_protocol_packet_cmd (struct ui_file *file, int from_tty,
1398 struct cmd_list_element *c,
1401 struct packet_config *packet;
1403 for (packet = remote_protocol_packets;
1404 packet < &remote_protocol_packets[PACKET_MAX];
1407 if (&packet->detect == c->var)
1409 show_packet_config_cmd (packet);
1413 internal_error (__FILE__, __LINE__, _("Could not find config for %s"),
1417 /* Should we try one of the 'Z' requests? */
1421 Z_PACKET_SOFTWARE_BP,
1422 Z_PACKET_HARDWARE_BP,
1429 /* For compatibility with older distributions. Provide a ``set remote
1430 Z-packet ...'' command that updates all the Z packet types. */
1432 static enum auto_boolean remote_Z_packet_detect;
1435 set_remote_protocol_Z_packet_cmd (char *args, int from_tty,
1436 struct cmd_list_element *c)
1440 for (i = 0; i < NR_Z_PACKET_TYPES; i++)
1441 remote_protocol_packets[PACKET_Z0 + i].detect = remote_Z_packet_detect;
1445 show_remote_protocol_Z_packet_cmd (struct ui_file *file, int from_tty,
1446 struct cmd_list_element *c,
1451 for (i = 0; i < NR_Z_PACKET_TYPES; i++)
1453 show_packet_config_cmd (&remote_protocol_packets[PACKET_Z0 + i]);
1457 /* Returns true if the multi-process extensions are in effect. */
1460 remote_multi_process_p (struct remote_state *rs)
1462 return packet_support (PACKET_multiprocess_feature) == PACKET_ENABLE;
1465 /* Returns true if fork events are supported. */
1468 remote_fork_event_p (struct remote_state *rs)
1470 return packet_support (PACKET_fork_event_feature) == PACKET_ENABLE;
1473 /* Tokens for use by the asynchronous signal handlers for SIGINT. */
1474 static struct async_signal_handler *async_sigint_remote_twice_token;
1475 static struct async_signal_handler *async_sigint_remote_token;
1478 /* Asynchronous signal handle registered as event loop source for
1479 when we have pending events ready to be passed to the core. */
1481 static struct async_event_handler *remote_async_inferior_event_token;
1485 static ptid_t magic_null_ptid;
1486 static ptid_t not_sent_ptid;
1487 static ptid_t any_thread_ptid;
1489 /* Find out if the stub attached to PID (and hence GDB should offer to
1490 detach instead of killing it when bailing out). */
1493 remote_query_attached (int pid)
1495 struct remote_state *rs = get_remote_state ();
1496 size_t size = get_remote_packet_size ();
1498 if (packet_support (PACKET_qAttached) == PACKET_DISABLE)
1501 if (remote_multi_process_p (rs))
1502 xsnprintf (rs->buf, size, "qAttached:%x", pid);
1504 xsnprintf (rs->buf, size, "qAttached");
1507 getpkt (&rs->buf, &rs->buf_size, 0);
1509 switch (packet_ok (rs->buf,
1510 &remote_protocol_packets[PACKET_qAttached]))
1513 if (strcmp (rs->buf, "1") == 0)
1517 warning (_("Remote failure reply: %s"), rs->buf);
1519 case PACKET_UNKNOWN:
1526 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
1527 has been invented by GDB, instead of reported by the target. Since
1528 we can be connected to a remote system before before knowing about
1529 any inferior, mark the target with execution when we find the first
1530 inferior. If ATTACHED is 1, then we had just attached to this
1531 inferior. If it is 0, then we just created this inferior. If it
1532 is -1, then try querying the remote stub to find out if it had
1533 attached to the inferior or not. If TRY_OPEN_EXEC is true then
1534 attempt to open this inferior's executable as the main executable
1535 if no main executable is open already. */
1537 static struct inferior *
1538 remote_add_inferior (int fake_pid_p, int pid, int attached,
1541 struct inferior *inf;
1543 /* Check whether this process we're learning about is to be
1544 considered attached, or if is to be considered to have been
1545 spawned by the stub. */
1547 attached = remote_query_attached (pid);
1549 if (gdbarch_has_global_solist (target_gdbarch ()))
1551 /* If the target shares code across all inferiors, then every
1552 attach adds a new inferior. */
1553 inf = add_inferior (pid);
1555 /* ... and every inferior is bound to the same program space.
1556 However, each inferior may still have its own address
1558 inf->aspace = maybe_new_address_space ();
1559 inf->pspace = current_program_space;
1563 /* In the traditional debugging scenario, there's a 1-1 match
1564 between program/address spaces. We simply bind the inferior
1565 to the program space's address space. */
1566 inf = current_inferior ();
1567 inferior_appeared (inf, pid);
1570 inf->attach_flag = attached;
1571 inf->fake_pid_p = fake_pid_p;
1573 /* If no main executable is currently open then attempt to
1574 open the file that was executed to create this inferior. */
1575 if (try_open_exec && get_exec_file (0) == NULL)
1576 exec_file_locate_attach (pid, 1);
1581 /* Add thread PTID to GDB's thread list. Tag it as executing/running
1582 according to RUNNING. */
1585 remote_add_thread (ptid_t ptid, int running)
1587 struct remote_state *rs = get_remote_state ();
1589 /* GDB historically didn't pull threads in the initial connection
1590 setup. If the remote target doesn't even have a concept of
1591 threads (e.g., a bare-metal target), even if internally we
1592 consider that a single-threaded target, mentioning a new thread
1593 might be confusing to the user. Be silent then, preserving the
1594 age old behavior. */
1595 if (rs->starting_up)
1596 add_thread_silent (ptid);
1600 set_executing (ptid, running);
1601 set_running (ptid, running);
1604 /* Come here when we learn about a thread id from the remote target.
1605 It may be the first time we hear about such thread, so take the
1606 opportunity to add it to GDB's thread list. In case this is the
1607 first time we're noticing its corresponding inferior, add it to
1608 GDB's inferior list as well. */
1611 remote_notice_new_inferior (ptid_t currthread, int running)
1613 /* If this is a new thread, add it to GDB's thread list.
1614 If we leave it up to WFI to do this, bad things will happen. */
1616 if (in_thread_list (currthread) && is_exited (currthread))
1618 /* We're seeing an event on a thread id we knew had exited.
1619 This has to be a new thread reusing the old id. Add it. */
1620 remote_add_thread (currthread, running);
1624 if (!in_thread_list (currthread))
1626 struct inferior *inf = NULL;
1627 int pid = ptid_get_pid (currthread);
1629 if (ptid_is_pid (inferior_ptid)
1630 && pid == ptid_get_pid (inferior_ptid))
1632 /* inferior_ptid has no thread member yet. This can happen
1633 with the vAttach -> remote_wait,"TAAthread:" path if the
1634 stub doesn't support qC. This is the first stop reported
1635 after an attach, so this is the main thread. Update the
1636 ptid in the thread list. */
1637 if (in_thread_list (pid_to_ptid (pid)))
1638 thread_change_ptid (inferior_ptid, currthread);
1641 remote_add_thread (currthread, running);
1642 inferior_ptid = currthread;
1647 if (ptid_equal (magic_null_ptid, inferior_ptid))
1649 /* inferior_ptid is not set yet. This can happen with the
1650 vRun -> remote_wait,"TAAthread:" path if the stub
1651 doesn't support qC. This is the first stop reported
1652 after an attach, so this is the main thread. Update the
1653 ptid in the thread list. */
1654 thread_change_ptid (inferior_ptid, currthread);
1658 /* When connecting to a target remote, or to a target
1659 extended-remote which already was debugging an inferior, we
1660 may not know about it yet. Add it before adding its child
1661 thread, so notifications are emitted in a sensible order. */
1662 if (!in_inferior_list (ptid_get_pid (currthread)))
1664 struct remote_state *rs = get_remote_state ();
1665 int fake_pid_p = !remote_multi_process_p (rs);
1667 inf = remote_add_inferior (fake_pid_p,
1668 ptid_get_pid (currthread), -1, 1);
1671 /* This is really a new thread. Add it. */
1672 remote_add_thread (currthread, running);
1674 /* If we found a new inferior, let the common code do whatever
1675 it needs to with it (e.g., read shared libraries, insert
1676 breakpoints), unless we're just setting up an all-stop
1680 struct remote_state *rs = get_remote_state ();
1682 if (non_stop || !rs->starting_up)
1683 notice_new_inferior (currthread, running, 0);
1688 /* Return the private thread data, creating it if necessary. */
1690 static struct private_thread_info *
1691 demand_private_info (ptid_t ptid)
1693 struct thread_info *info = find_thread_ptid (ptid);
1699 info->priv = xmalloc (sizeof (*(info->priv)));
1700 info->private_dtor = free_private_thread_info;
1701 info->priv->core = -1;
1702 info->priv->extra = 0;
1708 /* Call this function as a result of
1709 1) A halt indication (T packet) containing a thread id
1710 2) A direct query of currthread
1711 3) Successful execution of set thread */
1714 record_currthread (struct remote_state *rs, ptid_t currthread)
1716 rs->general_thread = currthread;
1719 /* If 'QPassSignals' is supported, tell the remote stub what signals
1720 it can simply pass through to the inferior without reporting. */
1723 remote_pass_signals (struct target_ops *self,
1724 int numsigs, unsigned char *pass_signals)
1726 if (packet_support (PACKET_QPassSignals) != PACKET_DISABLE)
1728 char *pass_packet, *p;
1730 struct remote_state *rs = get_remote_state ();
1732 gdb_assert (numsigs < 256);
1733 for (i = 0; i < numsigs; i++)
1735 if (pass_signals[i])
1738 pass_packet = xmalloc (count * 3 + strlen ("QPassSignals:") + 1);
1739 strcpy (pass_packet, "QPassSignals:");
1740 p = pass_packet + strlen (pass_packet);
1741 for (i = 0; i < numsigs; i++)
1743 if (pass_signals[i])
1746 *p++ = tohex (i >> 4);
1747 *p++ = tohex (i & 15);
1756 if (!rs->last_pass_packet || strcmp (rs->last_pass_packet, pass_packet))
1758 putpkt (pass_packet);
1759 getpkt (&rs->buf, &rs->buf_size, 0);
1760 packet_ok (rs->buf, &remote_protocol_packets[PACKET_QPassSignals]);
1761 if (rs->last_pass_packet)
1762 xfree (rs->last_pass_packet);
1763 rs->last_pass_packet = pass_packet;
1766 xfree (pass_packet);
1770 /* If 'QProgramSignals' is supported, tell the remote stub what
1771 signals it should pass through to the inferior when detaching. */
1774 remote_program_signals (struct target_ops *self,
1775 int numsigs, unsigned char *signals)
1777 if (packet_support (PACKET_QProgramSignals) != PACKET_DISABLE)
1781 struct remote_state *rs = get_remote_state ();
1783 gdb_assert (numsigs < 256);
1784 for (i = 0; i < numsigs; i++)
1789 packet = xmalloc (count * 3 + strlen ("QProgramSignals:") + 1);
1790 strcpy (packet, "QProgramSignals:");
1791 p = packet + strlen (packet);
1792 for (i = 0; i < numsigs; i++)
1794 if (signal_pass_state (i))
1797 *p++ = tohex (i >> 4);
1798 *p++ = tohex (i & 15);
1807 if (!rs->last_program_signals_packet
1808 || strcmp (rs->last_program_signals_packet, packet) != 0)
1811 getpkt (&rs->buf, &rs->buf_size, 0);
1812 packet_ok (rs->buf, &remote_protocol_packets[PACKET_QProgramSignals]);
1813 xfree (rs->last_program_signals_packet);
1814 rs->last_program_signals_packet = packet;
1821 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
1822 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
1823 thread. If GEN is set, set the general thread, if not, then set
1824 the step/continue thread. */
1826 set_thread (struct ptid ptid, int gen)
1828 struct remote_state *rs = get_remote_state ();
1829 ptid_t state = gen ? rs->general_thread : rs->continue_thread;
1830 char *buf = rs->buf;
1831 char *endbuf = rs->buf + get_remote_packet_size ();
1833 if (ptid_equal (state, ptid))
1837 *buf++ = gen ? 'g' : 'c';
1838 if (ptid_equal (ptid, magic_null_ptid))
1839 xsnprintf (buf, endbuf - buf, "0");
1840 else if (ptid_equal (ptid, any_thread_ptid))
1841 xsnprintf (buf, endbuf - buf, "0");
1842 else if (ptid_equal (ptid, minus_one_ptid))
1843 xsnprintf (buf, endbuf - buf, "-1");
1845 write_ptid (buf, endbuf, ptid);
1847 getpkt (&rs->buf, &rs->buf_size, 0);
1849 rs->general_thread = ptid;
1851 rs->continue_thread = ptid;
1855 set_general_thread (struct ptid ptid)
1857 set_thread (ptid, 1);
1861 set_continue_thread (struct ptid ptid)
1863 set_thread (ptid, 0);
1866 /* Change the remote current process. Which thread within the process
1867 ends up selected isn't important, as long as it is the same process
1868 as what INFERIOR_PTID points to.
1870 This comes from that fact that there is no explicit notion of
1871 "selected process" in the protocol. The selected process for
1872 general operations is the process the selected general thread
1876 set_general_process (void)
1878 struct remote_state *rs = get_remote_state ();
1880 /* If the remote can't handle multiple processes, don't bother. */
1881 if (!rs->extended || !remote_multi_process_p (rs))
1884 /* We only need to change the remote current thread if it's pointing
1885 at some other process. */
1886 if (ptid_get_pid (rs->general_thread) != ptid_get_pid (inferior_ptid))
1887 set_general_thread (inferior_ptid);
1891 /* Return nonzero if this is the main thread that we made up ourselves
1892 to model non-threaded targets as single-threaded. */
1895 remote_thread_always_alive (struct target_ops *ops, ptid_t ptid)
1897 struct remote_state *rs = get_remote_state ();
1900 if (ptid_equal (ptid, magic_null_ptid))
1901 /* The main thread is always alive. */
1904 if (ptid_get_pid (ptid) != 0 && ptid_get_lwp (ptid) == 0)
1905 /* The main thread is always alive. This can happen after a
1906 vAttach, if the remote side doesn't support
1913 /* Return nonzero if the thread PTID is still alive on the remote
1917 remote_thread_alive (struct target_ops *ops, ptid_t ptid)
1919 struct remote_state *rs = get_remote_state ();
1922 /* Check if this is a thread that we made up ourselves to model
1923 non-threaded targets as single-threaded. */
1924 if (remote_thread_always_alive (ops, ptid))
1928 endp = rs->buf + get_remote_packet_size ();
1931 write_ptid (p, endp, ptid);
1934 getpkt (&rs->buf, &rs->buf_size, 0);
1935 return (rs->buf[0] == 'O' && rs->buf[1] == 'K');
1938 /* About these extended threadlist and threadinfo packets. They are
1939 variable length packets but, the fields within them are often fixed
1940 length. They are redundent enough to send over UDP as is the
1941 remote protocol in general. There is a matching unit test module
1944 /* WARNING: This threadref data structure comes from the remote O.S.,
1945 libstub protocol encoding, and remote.c. It is not particularly
1948 /* Right now, the internal structure is int. We want it to be bigger.
1949 Plan to fix this. */
1951 typedef int gdb_threadref; /* Internal GDB thread reference. */
1953 /* gdb_ext_thread_info is an internal GDB data structure which is
1954 equivalent to the reply of the remote threadinfo packet. */
1956 struct gdb_ext_thread_info
1958 threadref threadid; /* External form of thread reference. */
1959 int active; /* Has state interesting to GDB?
1961 char display[256]; /* Brief state display, name,
1962 blocked/suspended. */
1963 char shortname[32]; /* To be used to name threads. */
1964 char more_display[256]; /* Long info, statistics, queue depth,
1968 /* The volume of remote transfers can be limited by submitting
1969 a mask containing bits specifying the desired information.
1970 Use a union of these values as the 'selection' parameter to
1971 get_thread_info. FIXME: Make these TAG names more thread specific. */
1973 #define TAG_THREADID 1
1974 #define TAG_EXISTS 2
1975 #define TAG_DISPLAY 4
1976 #define TAG_THREADNAME 8
1977 #define TAG_MOREDISPLAY 16
1979 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
1981 static char *unpack_nibble (char *buf, int *val);
1983 static char *unpack_byte (char *buf, int *value);
1985 static char *pack_int (char *buf, int value);
1987 static char *unpack_int (char *buf, int *value);
1989 static char *unpack_string (char *src, char *dest, int length);
1991 static char *pack_threadid (char *pkt, threadref *id);
1993 static char *unpack_threadid (char *inbuf, threadref *id);
1995 void int_to_threadref (threadref *id, int value);
1997 static int threadref_to_int (threadref *ref);
1999 static void copy_threadref (threadref *dest, threadref *src);
2001 static int threadmatch (threadref *dest, threadref *src);
2003 static char *pack_threadinfo_request (char *pkt, int mode,
2006 static int remote_unpack_thread_info_response (char *pkt,
2007 threadref *expectedref,
2008 struct gdb_ext_thread_info
2012 static int remote_get_threadinfo (threadref *threadid,
2013 int fieldset, /*TAG mask */
2014 struct gdb_ext_thread_info *info);
2016 static char *pack_threadlist_request (char *pkt, int startflag,
2018 threadref *nextthread);
2020 static int parse_threadlist_response (char *pkt,
2022 threadref *original_echo,
2023 threadref *resultlist,
2026 static int remote_get_threadlist (int startflag,
2027 threadref *nextthread,
2031 threadref *threadlist);
2033 typedef int (*rmt_thread_action) (threadref *ref, void *context);
2035 static int remote_threadlist_iterator (rmt_thread_action stepfunction,
2036 void *context, int looplimit);
2038 static int remote_newthread_step (threadref *ref, void *context);
2041 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
2042 buffer we're allowed to write to. Returns
2043 BUF+CHARACTERS_WRITTEN. */
2046 write_ptid (char *buf, const char *endbuf, ptid_t ptid)
2049 struct remote_state *rs = get_remote_state ();
2051 if (remote_multi_process_p (rs))
2053 pid = ptid_get_pid (ptid);
2055 buf += xsnprintf (buf, endbuf - buf, "p-%x.", -pid);
2057 buf += xsnprintf (buf, endbuf - buf, "p%x.", pid);
2059 tid = ptid_get_lwp (ptid);
2061 buf += xsnprintf (buf, endbuf - buf, "-%x", -tid);
2063 buf += xsnprintf (buf, endbuf - buf, "%x", tid);
2068 /* Extract a PTID from BUF. If non-null, OBUF is set to the to one
2069 passed the last parsed char. Returns null_ptid on error. */
2072 read_ptid (char *buf, char **obuf)
2076 ULONGEST pid = 0, tid = 0;
2080 /* Multi-process ptid. */
2081 pp = unpack_varlen_hex (p + 1, &pid);
2083 error (_("invalid remote ptid: %s"), p);
2086 pp = unpack_varlen_hex (p + 1, &tid);
2089 return ptid_build (pid, tid, 0);
2092 /* No multi-process. Just a tid. */
2093 pp = unpack_varlen_hex (p, &tid);
2095 /* Since the stub is not sending a process id, then default to
2096 what's in inferior_ptid, unless it's null at this point. If so,
2097 then since there's no way to know the pid of the reported
2098 threads, use the magic number. */
2099 if (ptid_equal (inferior_ptid, null_ptid))
2100 pid = ptid_get_pid (magic_null_ptid);
2102 pid = ptid_get_pid (inferior_ptid);
2106 return ptid_build (pid, tid, 0);
2112 if (ch >= 'a' && ch <= 'f')
2113 return ch - 'a' + 10;
2114 if (ch >= '0' && ch <= '9')
2116 if (ch >= 'A' && ch <= 'F')
2117 return ch - 'A' + 10;
2122 stub_unpack_int (char *buff, int fieldlength)
2129 nibble = stubhex (*buff++);
2133 retval = retval << 4;
2139 unpack_nibble (char *buf, int *val)
2141 *val = fromhex (*buf++);
2146 unpack_byte (char *buf, int *value)
2148 *value = stub_unpack_int (buf, 2);
2153 pack_int (char *buf, int value)
2155 buf = pack_hex_byte (buf, (value >> 24) & 0xff);
2156 buf = pack_hex_byte (buf, (value >> 16) & 0xff);
2157 buf = pack_hex_byte (buf, (value >> 8) & 0x0ff);
2158 buf = pack_hex_byte (buf, (value & 0xff));
2163 unpack_int (char *buf, int *value)
2165 *value = stub_unpack_int (buf, 8);
2169 #if 0 /* Currently unused, uncomment when needed. */
2170 static char *pack_string (char *pkt, char *string);
2173 pack_string (char *pkt, char *string)
2178 len = strlen (string);
2180 len = 200; /* Bigger than most GDB packets, junk??? */
2181 pkt = pack_hex_byte (pkt, len);
2185 if ((ch == '\0') || (ch == '#'))
2186 ch = '*'; /* Protect encapsulation. */
2191 #endif /* 0 (unused) */
2194 unpack_string (char *src, char *dest, int length)
2203 pack_threadid (char *pkt, threadref *id)
2206 unsigned char *altid;
2208 altid = (unsigned char *) id;
2209 limit = pkt + BUF_THREAD_ID_SIZE;
2211 pkt = pack_hex_byte (pkt, *altid++);
2217 unpack_threadid (char *inbuf, threadref *id)
2220 char *limit = inbuf + BUF_THREAD_ID_SIZE;
2223 altref = (char *) id;
2225 while (inbuf < limit)
2227 x = stubhex (*inbuf++);
2228 y = stubhex (*inbuf++);
2229 *altref++ = (x << 4) | y;
2234 /* Externally, threadrefs are 64 bits but internally, they are still
2235 ints. This is due to a mismatch of specifications. We would like
2236 to use 64bit thread references internally. This is an adapter
2240 int_to_threadref (threadref *id, int value)
2242 unsigned char *scan;
2244 scan = (unsigned char *) id;
2250 *scan++ = (value >> 24) & 0xff;
2251 *scan++ = (value >> 16) & 0xff;
2252 *scan++ = (value >> 8) & 0xff;
2253 *scan++ = (value & 0xff);
2257 threadref_to_int (threadref *ref)
2260 unsigned char *scan;
2266 value = (value << 8) | ((*scan++) & 0xff);
2271 copy_threadref (threadref *dest, threadref *src)
2274 unsigned char *csrc, *cdest;
2276 csrc = (unsigned char *) src;
2277 cdest = (unsigned char *) dest;
2284 threadmatch (threadref *dest, threadref *src)
2286 /* Things are broken right now, so just assume we got a match. */
2288 unsigned char *srcp, *destp;
2290 srcp = (char *) src;
2291 destp = (char *) dest;
2295 result &= (*srcp++ == *destp++) ? 1 : 0;
2302 threadid:1, # always request threadid
2309 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
2312 pack_threadinfo_request (char *pkt, int mode, threadref *id)
2314 *pkt++ = 'q'; /* Info Query */
2315 *pkt++ = 'P'; /* process or thread info */
2316 pkt = pack_int (pkt, mode); /* mode */
2317 pkt = pack_threadid (pkt, id); /* threadid */
2318 *pkt = '\0'; /* terminate */
2322 /* These values tag the fields in a thread info response packet. */
2323 /* Tagging the fields allows us to request specific fields and to
2324 add more fields as time goes by. */
2326 #define TAG_THREADID 1 /* Echo the thread identifier. */
2327 #define TAG_EXISTS 2 /* Is this process defined enough to
2328 fetch registers and its stack? */
2329 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
2330 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
2331 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
2335 remote_unpack_thread_info_response (char *pkt, threadref *expectedref,
2336 struct gdb_ext_thread_info *info)
2338 struct remote_state *rs = get_remote_state ();
2342 char *limit = pkt + rs->buf_size; /* Plausible parsing limit. */
2345 /* info->threadid = 0; FIXME: implement zero_threadref. */
2347 info->display[0] = '\0';
2348 info->shortname[0] = '\0';
2349 info->more_display[0] = '\0';
2351 /* Assume the characters indicating the packet type have been
2353 pkt = unpack_int (pkt, &mask); /* arg mask */
2354 pkt = unpack_threadid (pkt, &ref);
2357 warning (_("Incomplete response to threadinfo request."));
2358 if (!threadmatch (&ref, expectedref))
2359 { /* This is an answer to a different request. */
2360 warning (_("ERROR RMT Thread info mismatch."));
2363 copy_threadref (&info->threadid, &ref);
2365 /* Loop on tagged fields , try to bail if somthing goes wrong. */
2367 /* Packets are terminated with nulls. */
2368 while ((pkt < limit) && mask && *pkt)
2370 pkt = unpack_int (pkt, &tag); /* tag */
2371 pkt = unpack_byte (pkt, &length); /* length */
2372 if (!(tag & mask)) /* Tags out of synch with mask. */
2374 warning (_("ERROR RMT: threadinfo tag mismatch."));
2378 if (tag == TAG_THREADID)
2382 warning (_("ERROR RMT: length of threadid is not 16."));
2386 pkt = unpack_threadid (pkt, &ref);
2387 mask = mask & ~TAG_THREADID;
2390 if (tag == TAG_EXISTS)
2392 info->active = stub_unpack_int (pkt, length);
2394 mask = mask & ~(TAG_EXISTS);
2397 warning (_("ERROR RMT: 'exists' length too long."));
2403 if (tag == TAG_THREADNAME)
2405 pkt = unpack_string (pkt, &info->shortname[0], length);
2406 mask = mask & ~TAG_THREADNAME;
2409 if (tag == TAG_DISPLAY)
2411 pkt = unpack_string (pkt, &info->display[0], length);
2412 mask = mask & ~TAG_DISPLAY;
2415 if (tag == TAG_MOREDISPLAY)
2417 pkt = unpack_string (pkt, &info->more_display[0], length);
2418 mask = mask & ~TAG_MOREDISPLAY;
2421 warning (_("ERROR RMT: unknown thread info tag."));
2422 break; /* Not a tag we know about. */
2428 remote_get_threadinfo (threadref *threadid, int fieldset, /* TAG mask */
2429 struct gdb_ext_thread_info *info)
2431 struct remote_state *rs = get_remote_state ();
2434 pack_threadinfo_request (rs->buf, fieldset, threadid);
2436 getpkt (&rs->buf, &rs->buf_size, 0);
2438 if (rs->buf[0] == '\0')
2441 result = remote_unpack_thread_info_response (rs->buf + 2,
2446 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
2449 pack_threadlist_request (char *pkt, int startflag, int threadcount,
2450 threadref *nextthread)
2452 *pkt++ = 'q'; /* info query packet */
2453 *pkt++ = 'L'; /* Process LIST or threadLIST request */
2454 pkt = pack_nibble (pkt, startflag); /* initflag 1 bytes */
2455 pkt = pack_hex_byte (pkt, threadcount); /* threadcount 2 bytes */
2456 pkt = pack_threadid (pkt, nextthread); /* 64 bit thread identifier */
2461 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
2464 parse_threadlist_response (char *pkt, int result_limit,
2465 threadref *original_echo, threadref *resultlist,
2468 struct remote_state *rs = get_remote_state ();
2470 int count, resultcount, done;
2473 /* Assume the 'q' and 'M chars have been stripped. */
2474 limit = pkt + (rs->buf_size - BUF_THREAD_ID_SIZE);
2475 /* done parse past here */
2476 pkt = unpack_byte (pkt, &count); /* count field */
2477 pkt = unpack_nibble (pkt, &done);
2478 /* The first threadid is the argument threadid. */
2479 pkt = unpack_threadid (pkt, original_echo); /* should match query packet */
2480 while ((count-- > 0) && (pkt < limit))
2482 pkt = unpack_threadid (pkt, resultlist++);
2483 if (resultcount++ >= result_limit)
2491 /* Fetch the next batch of threads from the remote. Returns -1 if the
2492 qL packet is not supported, 0 on error and 1 on success. */
2495 remote_get_threadlist (int startflag, threadref *nextthread, int result_limit,
2496 int *done, int *result_count, threadref *threadlist)
2498 struct remote_state *rs = get_remote_state ();
2501 /* Trancate result limit to be smaller than the packet size. */
2502 if ((((result_limit + 1) * BUF_THREAD_ID_SIZE) + 10)
2503 >= get_remote_packet_size ())
2504 result_limit = (get_remote_packet_size () / BUF_THREAD_ID_SIZE) - 2;
2506 pack_threadlist_request (rs->buf, startflag, result_limit, nextthread);
2508 getpkt (&rs->buf, &rs->buf_size, 0);
2509 if (*rs->buf == '\0')
2511 /* Packet not supported. */
2516 parse_threadlist_response (rs->buf + 2, result_limit,
2517 &rs->echo_nextthread, threadlist, done);
2519 if (!threadmatch (&rs->echo_nextthread, nextthread))
2521 /* FIXME: This is a good reason to drop the packet. */
2522 /* Possably, there is a duplicate response. */
2524 retransmit immediatly - race conditions
2525 retransmit after timeout - yes
2527 wait for packet, then exit
2529 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
2530 return 0; /* I choose simply exiting. */
2532 if (*result_count <= 0)
2536 warning (_("RMT ERROR : failed to get remote thread list."));
2539 return result; /* break; */
2541 if (*result_count > result_limit)
2544 warning (_("RMT ERROR: threadlist response longer than requested."));
2550 /* Fetch the list of remote threads, with the qL packet, and call
2551 STEPFUNCTION for each thread found. Stops iterating and returns 1
2552 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
2553 STEPFUNCTION returns false. If the packet is not supported,
2557 remote_threadlist_iterator (rmt_thread_action stepfunction, void *context,
2560 struct remote_state *rs = get_remote_state ();
2561 int done, i, result_count;
2569 if (loopcount++ > looplimit)
2572 warning (_("Remote fetch threadlist -infinite loop-."));
2575 result = remote_get_threadlist (startflag, &rs->nextthread,
2576 MAXTHREADLISTRESULTS,
2577 &done, &result_count,
2578 rs->resultthreadlist);
2581 /* Clear for later iterations. */
2583 /* Setup to resume next batch of thread references, set nextthread. */
2584 if (result_count >= 1)
2585 copy_threadref (&rs->nextthread,
2586 &rs->resultthreadlist[result_count - 1]);
2588 while (result_count--)
2590 if (!(*stepfunction) (&rs->resultthreadlist[i++], context))
2600 /* A thread found on the remote target. */
2602 typedef struct thread_item
2604 /* The thread's PTID. */
2607 /* The thread's extra info. May be NULL. */
2610 /* The core the thread was running on. -1 if not known. */
2613 DEF_VEC_O(thread_item_t);
2615 /* Context passed around to the various methods listing remote
2616 threads. As new threads are found, they're added to the ITEMS
2619 struct threads_listing_context
2621 /* The threads found on the remote target. */
2622 VEC (thread_item_t) *items;
2625 /* Discard the contents of the constructed thread listing context. */
2628 clear_threads_listing_context (void *p)
2630 struct threads_listing_context *context = p;
2632 struct thread_item *item;
2634 for (i = 0; VEC_iterate (thread_item_t, context->items, i, item); ++i)
2635 xfree (item->extra);
2637 VEC_free (thread_item_t, context->items);
2641 remote_newthread_step (threadref *ref, void *data)
2643 struct threads_listing_context *context = data;
2644 struct thread_item item;
2645 int pid = ptid_get_pid (inferior_ptid);
2647 item.ptid = ptid_build (pid, threadref_to_int (ref), 0);
2651 VEC_safe_push (thread_item_t, context->items, &item);
2653 return 1; /* continue iterator */
2656 #define CRAZY_MAX_THREADS 1000
2659 remote_current_thread (ptid_t oldpid)
2661 struct remote_state *rs = get_remote_state ();
2664 getpkt (&rs->buf, &rs->buf_size, 0);
2665 if (rs->buf[0] == 'Q' && rs->buf[1] == 'C')
2666 return read_ptid (&rs->buf[2], NULL);
2671 /* List remote threads using the deprecated qL packet. */
2674 remote_get_threads_with_ql (struct target_ops *ops,
2675 struct threads_listing_context *context)
2677 if (remote_threadlist_iterator (remote_newthread_step, context,
2678 CRAZY_MAX_THREADS) >= 0)
2684 #if defined(HAVE_LIBEXPAT)
2687 start_thread (struct gdb_xml_parser *parser,
2688 const struct gdb_xml_element *element,
2689 void *user_data, VEC(gdb_xml_value_s) *attributes)
2691 struct threads_listing_context *data = user_data;
2693 struct thread_item item;
2695 struct gdb_xml_value *attr;
2697 id = xml_find_attribute (attributes, "id")->value;
2698 item.ptid = read_ptid (id, NULL);
2700 attr = xml_find_attribute (attributes, "core");
2702 item.core = *(ULONGEST *) attr->value;
2708 VEC_safe_push (thread_item_t, data->items, &item);
2712 end_thread (struct gdb_xml_parser *parser,
2713 const struct gdb_xml_element *element,
2714 void *user_data, const char *body_text)
2716 struct threads_listing_context *data = user_data;
2718 if (body_text && *body_text)
2719 VEC_last (thread_item_t, data->items)->extra = xstrdup (body_text);
2722 const struct gdb_xml_attribute thread_attributes[] = {
2723 { "id", GDB_XML_AF_NONE, NULL, NULL },
2724 { "core", GDB_XML_AF_OPTIONAL, gdb_xml_parse_attr_ulongest, NULL },
2725 { NULL, GDB_XML_AF_NONE, NULL, NULL }
2728 const struct gdb_xml_element thread_children[] = {
2729 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
2732 const struct gdb_xml_element threads_children[] = {
2733 { "thread", thread_attributes, thread_children,
2734 GDB_XML_EF_REPEATABLE | GDB_XML_EF_OPTIONAL,
2735 start_thread, end_thread },
2736 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
2739 const struct gdb_xml_element threads_elements[] = {
2740 { "threads", NULL, threads_children,
2741 GDB_XML_EF_NONE, NULL, NULL },
2742 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
2747 /* List remote threads using qXfer:threads:read. */
2750 remote_get_threads_with_qxfer (struct target_ops *ops,
2751 struct threads_listing_context *context)
2753 #if defined(HAVE_LIBEXPAT)
2754 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
2756 char *xml = target_read_stralloc (ops, TARGET_OBJECT_THREADS, NULL);
2757 struct cleanup *back_to = make_cleanup (xfree, xml);
2759 if (xml != NULL && *xml != '\0')
2761 gdb_xml_parse_quick (_("threads"), "threads.dtd",
2762 threads_elements, xml, context);
2765 do_cleanups (back_to);
2773 /* List remote threads using qfThreadInfo/qsThreadInfo. */
2776 remote_get_threads_with_qthreadinfo (struct target_ops *ops,
2777 struct threads_listing_context *context)
2779 struct remote_state *rs = get_remote_state ();
2781 if (rs->use_threadinfo_query)
2785 putpkt ("qfThreadInfo");
2786 getpkt (&rs->buf, &rs->buf_size, 0);
2788 if (bufp[0] != '\0') /* q packet recognized */
2790 while (*bufp++ == 'm') /* reply contains one or more TID */
2794 struct thread_item item;
2796 item.ptid = read_ptid (bufp, &bufp);
2800 VEC_safe_push (thread_item_t, context->items, &item);
2802 while (*bufp++ == ','); /* comma-separated list */
2803 putpkt ("qsThreadInfo");
2804 getpkt (&rs->buf, &rs->buf_size, 0);
2811 /* Packet not recognized. */
2812 rs->use_threadinfo_query = 0;
2819 /* Implement the to_update_thread_list function for the remote
2823 remote_update_thread_list (struct target_ops *ops)
2825 struct remote_state *rs = get_remote_state ();
2826 struct threads_listing_context context;
2827 struct cleanup *old_chain;
2830 context.items = NULL;
2831 old_chain = make_cleanup (clear_threads_listing_context, &context);
2833 /* We have a few different mechanisms to fetch the thread list. Try
2834 them all, starting with the most preferred one first, falling
2835 back to older methods. */
2836 if (remote_get_threads_with_qxfer (ops, &context)
2837 || remote_get_threads_with_qthreadinfo (ops, &context)
2838 || remote_get_threads_with_ql (ops, &context))
2841 struct thread_item *item;
2842 struct thread_info *tp, *tmp;
2846 if (VEC_empty (thread_item_t, context.items)
2847 && remote_thread_always_alive (ops, inferior_ptid))
2849 /* Some targets don't really support threads, but still
2850 reply an (empty) thread list in response to the thread
2851 listing packets, instead of replying "packet not
2852 supported". Exit early so we don't delete the main
2854 do_cleanups (old_chain);
2858 /* CONTEXT now holds the current thread list on the remote
2859 target end. Delete GDB-side threads no longer found on the
2861 ALL_THREADS_SAFE (tp, tmp)
2864 VEC_iterate (thread_item_t, context.items, i, item);
2867 if (ptid_equal (item->ptid, tp->ptid))
2871 if (i == VEC_length (thread_item_t, context.items))
2874 delete_thread (tp->ptid);
2878 /* And now add threads we don't know about yet to our list. */
2880 VEC_iterate (thread_item_t, context.items, i, item);
2883 if (!ptid_equal (item->ptid, null_ptid))
2885 struct private_thread_info *info;
2886 /* In non-stop mode, we assume new found threads are
2887 running until proven otherwise with a stop reply. In
2888 all-stop, we can only get here if all threads are
2890 int running = non_stop ? 1 : 0;
2892 remote_notice_new_inferior (item->ptid, running);
2894 info = demand_private_info (item->ptid);
2895 info->core = item->core;
2896 info->extra = item->extra;
2904 /* If no thread listing method is supported, then query whether
2905 each known thread is alive, one by one, with the T packet.
2906 If the target doesn't support threads at all, then this is a
2907 no-op. See remote_thread_alive. */
2911 do_cleanups (old_chain);
2915 * Collect a descriptive string about the given thread.
2916 * The target may say anything it wants to about the thread
2917 * (typically info about its blocked / runnable state, name, etc.).
2918 * This string will appear in the info threads display.
2920 * Optional: targets are not required to implement this function.
2924 remote_threads_extra_info (struct target_ops *self, struct thread_info *tp)
2926 struct remote_state *rs = get_remote_state ();
2930 struct gdb_ext_thread_info threadinfo;
2931 static char display_buf[100]; /* arbitrary... */
2932 int n = 0; /* position in display_buf */
2934 if (rs->remote_desc == 0) /* paranoia */
2935 internal_error (__FILE__, __LINE__,
2936 _("remote_threads_extra_info"));
2938 if (ptid_equal (tp->ptid, magic_null_ptid)
2939 || (ptid_get_pid (tp->ptid) != 0 && ptid_get_lwp (tp->ptid) == 0))
2940 /* This is the main thread which was added by GDB. The remote
2941 server doesn't know about it. */
2944 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
2946 struct thread_info *info = find_thread_ptid (tp->ptid);
2948 if (info && info->priv)
2949 return info->priv->extra;
2954 if (rs->use_threadextra_query)
2957 char *endb = rs->buf + get_remote_packet_size ();
2959 xsnprintf (b, endb - b, "qThreadExtraInfo,");
2961 write_ptid (b, endb, tp->ptid);
2964 getpkt (&rs->buf, &rs->buf_size, 0);
2965 if (rs->buf[0] != 0)
2967 n = min (strlen (rs->buf) / 2, sizeof (display_buf));
2968 result = hex2bin (rs->buf, (gdb_byte *) display_buf, n);
2969 display_buf [result] = '\0';
2974 /* If the above query fails, fall back to the old method. */
2975 rs->use_threadextra_query = 0;
2976 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
2977 | TAG_MOREDISPLAY | TAG_DISPLAY;
2978 int_to_threadref (&id, ptid_get_lwp (tp->ptid));
2979 if (remote_get_threadinfo (&id, set, &threadinfo))
2980 if (threadinfo.active)
2982 if (*threadinfo.shortname)
2983 n += xsnprintf (&display_buf[0], sizeof (display_buf) - n,
2984 " Name: %s,", threadinfo.shortname);
2985 if (*threadinfo.display)
2986 n += xsnprintf (&display_buf[n], sizeof (display_buf) - n,
2987 " State: %s,", threadinfo.display);
2988 if (*threadinfo.more_display)
2989 n += xsnprintf (&display_buf[n], sizeof (display_buf) - n,
2990 " Priority: %s", threadinfo.more_display);
2994 /* For purely cosmetic reasons, clear up trailing commas. */
2995 if (',' == display_buf[n-1])
2996 display_buf[n-1] = ' ';
3005 remote_static_tracepoint_marker_at (struct target_ops *self, CORE_ADDR addr,
3006 struct static_tracepoint_marker *marker)
3008 struct remote_state *rs = get_remote_state ();
3011 xsnprintf (p, get_remote_packet_size (), "qTSTMat:");
3013 p += hexnumstr (p, addr);
3015 getpkt (&rs->buf, &rs->buf_size, 0);
3019 error (_("Remote failure reply: %s"), p);
3023 parse_static_tracepoint_marker_definition (p, &p, marker);
3030 static VEC(static_tracepoint_marker_p) *
3031 remote_static_tracepoint_markers_by_strid (struct target_ops *self,
3034 struct remote_state *rs = get_remote_state ();
3035 VEC(static_tracepoint_marker_p) *markers = NULL;
3036 struct static_tracepoint_marker *marker = NULL;
3037 struct cleanup *old_chain;
3040 /* Ask for a first packet of static tracepoint marker
3043 getpkt (&rs->buf, &rs->buf_size, 0);
3046 error (_("Remote failure reply: %s"), p);
3048 old_chain = make_cleanup (free_current_marker, &marker);
3053 marker = XCNEW (struct static_tracepoint_marker);
3057 parse_static_tracepoint_marker_definition (p, &p, marker);
3059 if (strid == NULL || strcmp (strid, marker->str_id) == 0)
3061 VEC_safe_push (static_tracepoint_marker_p,
3067 release_static_tracepoint_marker (marker);
3068 memset (marker, 0, sizeof (*marker));
3071 while (*p++ == ','); /* comma-separated list */
3072 /* Ask for another packet of static tracepoint definition. */
3074 getpkt (&rs->buf, &rs->buf_size, 0);
3078 do_cleanups (old_chain);
3083 /* Implement the to_get_ada_task_ptid function for the remote targets. */
3086 remote_get_ada_task_ptid (struct target_ops *self, long lwp, long thread)
3088 return ptid_build (ptid_get_pid (inferior_ptid), lwp, 0);
3092 /* Restart the remote side; this is an extended protocol operation. */
3095 extended_remote_restart (void)
3097 struct remote_state *rs = get_remote_state ();
3099 /* Send the restart command; for reasons I don't understand the
3100 remote side really expects a number after the "R". */
3101 xsnprintf (rs->buf, get_remote_packet_size (), "R%x", 0);
3104 remote_fileio_reset ();
3107 /* Clean up connection to a remote debugger. */
3110 remote_close (struct target_ops *self)
3112 struct remote_state *rs = get_remote_state ();
3114 if (rs->remote_desc == NULL)
3115 return; /* already closed */
3117 /* Make sure we leave stdin registered in the event loop, and we
3118 don't leave the async SIGINT signal handler installed. */
3119 remote_terminal_ours (self);
3121 serial_close (rs->remote_desc);
3122 rs->remote_desc = NULL;
3124 /* We don't have a connection to the remote stub anymore. Get rid
3125 of all the inferiors and their threads we were controlling.
3126 Reset inferior_ptid to null_ptid first, as otherwise has_stack_frame
3127 will be unable to find the thread corresponding to (pid, 0, 0). */
3128 inferior_ptid = null_ptid;
3129 discard_all_inferiors ();
3131 /* We are closing the remote target, so we should discard
3132 everything of this target. */
3133 discard_pending_stop_replies_in_queue (rs);
3135 if (remote_async_inferior_event_token)
3136 delete_async_event_handler (&remote_async_inferior_event_token);
3138 remote_notif_state_xfree (rs->notif_state);
3140 trace_reset_local_state ();
3143 /* Query the remote side for the text, data and bss offsets. */
3148 struct remote_state *rs = get_remote_state ();
3151 int lose, num_segments = 0, do_sections, do_segments;
3152 CORE_ADDR text_addr, data_addr, bss_addr, segments[2];
3153 struct section_offsets *offs;
3154 struct symfile_segment_data *data;
3156 if (symfile_objfile == NULL)
3159 putpkt ("qOffsets");
3160 getpkt (&rs->buf, &rs->buf_size, 0);
3163 if (buf[0] == '\000')
3164 return; /* Return silently. Stub doesn't support
3168 warning (_("Remote failure reply: %s"), buf);
3172 /* Pick up each field in turn. This used to be done with scanf, but
3173 scanf will make trouble if CORE_ADDR size doesn't match
3174 conversion directives correctly. The following code will work
3175 with any size of CORE_ADDR. */
3176 text_addr = data_addr = bss_addr = 0;
3180 if (startswith (ptr, "Text="))
3183 /* Don't use strtol, could lose on big values. */
3184 while (*ptr && *ptr != ';')
3185 text_addr = (text_addr << 4) + fromhex (*ptr++);
3187 if (startswith (ptr, ";Data="))
3190 while (*ptr && *ptr != ';')
3191 data_addr = (data_addr << 4) + fromhex (*ptr++);
3196 if (!lose && startswith (ptr, ";Bss="))
3199 while (*ptr && *ptr != ';')
3200 bss_addr = (bss_addr << 4) + fromhex (*ptr++);
3202 if (bss_addr != data_addr)
3203 warning (_("Target reported unsupported offsets: %s"), buf);
3208 else if (startswith (ptr, "TextSeg="))
3211 /* Don't use strtol, could lose on big values. */
3212 while (*ptr && *ptr != ';')
3213 text_addr = (text_addr << 4) + fromhex (*ptr++);
3216 if (startswith (ptr, ";DataSeg="))
3219 while (*ptr && *ptr != ';')
3220 data_addr = (data_addr << 4) + fromhex (*ptr++);
3228 error (_("Malformed response to offset query, %s"), buf);
3229 else if (*ptr != '\0')
3230 warning (_("Target reported unsupported offsets: %s"), buf);
3232 offs = ((struct section_offsets *)
3233 alloca (SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections)));
3234 memcpy (offs, symfile_objfile->section_offsets,
3235 SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections));
3237 data = get_symfile_segment_data (symfile_objfile->obfd);
3238 do_segments = (data != NULL);
3239 do_sections = num_segments == 0;
3241 if (num_segments > 0)
3243 segments[0] = text_addr;
3244 segments[1] = data_addr;
3246 /* If we have two segments, we can still try to relocate everything
3247 by assuming that the .text and .data offsets apply to the whole
3248 text and data segments. Convert the offsets given in the packet
3249 to base addresses for symfile_map_offsets_to_segments. */
3250 else if (data && data->num_segments == 2)
3252 segments[0] = data->segment_bases[0] + text_addr;
3253 segments[1] = data->segment_bases[1] + data_addr;
3256 /* If the object file has only one segment, assume that it is text
3257 rather than data; main programs with no writable data are rare,
3258 but programs with no code are useless. Of course the code might
3259 have ended up in the data segment... to detect that we would need
3260 the permissions here. */
3261 else if (data && data->num_segments == 1)
3263 segments[0] = data->segment_bases[0] + text_addr;
3266 /* There's no way to relocate by segment. */
3272 int ret = symfile_map_offsets_to_segments (symfile_objfile->obfd, data,
3273 offs, num_segments, segments);
3275 if (ret == 0 && !do_sections)
3276 error (_("Can not handle qOffsets TextSeg "
3277 "response with this symbol file"));
3284 free_symfile_segment_data (data);
3288 offs->offsets[SECT_OFF_TEXT (symfile_objfile)] = text_addr;
3290 /* This is a temporary kludge to force data and bss to use the
3291 same offsets because that's what nlmconv does now. The real
3292 solution requires changes to the stub and remote.c that I
3293 don't have time to do right now. */
3295 offs->offsets[SECT_OFF_DATA (symfile_objfile)] = data_addr;
3296 offs->offsets[SECT_OFF_BSS (symfile_objfile)] = data_addr;
3299 objfile_relocate (symfile_objfile, offs);
3302 /* Callback for iterate_over_threads. Set the STOP_REQUESTED flags in
3303 threads we know are stopped already. This is used during the
3304 initial remote connection in non-stop mode --- threads that are
3305 reported as already being stopped are left stopped. */
3308 set_stop_requested_callback (struct thread_info *thread, void *data)
3310 /* If we have a stop reply for this thread, it must be stopped. */
3311 if (peek_stop_reply (thread->ptid))
3312 set_stop_requested (thread->ptid, 1);
3317 /* Send interrupt_sequence to remote target. */
3319 send_interrupt_sequence (void)
3321 struct remote_state *rs = get_remote_state ();
3323 if (interrupt_sequence_mode == interrupt_sequence_control_c)
3324 remote_serial_write ("\x03", 1);
3325 else if (interrupt_sequence_mode == interrupt_sequence_break)
3326 serial_send_break (rs->remote_desc);
3327 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
3329 serial_send_break (rs->remote_desc);
3330 remote_serial_write ("g", 1);
3333 internal_error (__FILE__, __LINE__,
3334 _("Invalid value for interrupt_sequence_mode: %s."),
3335 interrupt_sequence_mode);
3339 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
3340 and extract the PTID. Returns NULL_PTID if not found. */
3343 stop_reply_extract_thread (char *stop_reply)
3345 if (stop_reply[0] == 'T' && strlen (stop_reply) > 3)
3349 /* Txx r:val ; r:val (...) */
3352 /* Look for "register" named "thread". */
3357 p1 = strchr (p, ':');
3361 if (strncmp (p, "thread", p1 - p) == 0)
3362 return read_ptid (++p1, &p);
3364 p1 = strchr (p, ';');
3376 /* Determine the remote side's current thread. If we have a stop
3377 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
3378 "thread" register we can extract the current thread from. If not,
3379 ask the remote which is the current thread with qC. The former
3380 method avoids a roundtrip. */
3383 get_current_thread (char *wait_status)
3387 /* Note we don't use remote_parse_stop_reply as that makes use of
3388 the target architecture, which we haven't yet fully determined at
3390 if (wait_status != NULL)
3391 ptid = stop_reply_extract_thread (wait_status);
3392 if (ptid_equal (ptid, null_ptid))
3393 ptid = remote_current_thread (inferior_ptid);
3398 /* Query the remote target for which is the current thread/process,
3399 add it to our tables, and update INFERIOR_PTID. The caller is
3400 responsible for setting the state such that the remote end is ready
3401 to return the current thread.
3403 This function is called after handling the '?' or 'vRun' packets,
3404 whose response is a stop reply from which we can also try
3405 extracting the thread. If the target doesn't support the explicit
3406 qC query, we infer the current thread from that stop reply, passed
3407 in in WAIT_STATUS, which may be NULL. */
3410 add_current_inferior_and_thread (char *wait_status)
3412 struct remote_state *rs = get_remote_state ();
3414 ptid_t ptid = null_ptid;
3416 inferior_ptid = null_ptid;
3418 /* Now, if we have thread information, update inferior_ptid. */
3419 ptid = get_current_thread (wait_status);
3421 if (!ptid_equal (ptid, null_ptid))
3423 if (!remote_multi_process_p (rs))
3426 inferior_ptid = ptid;
3430 /* Without this, some commands which require an active target
3431 (such as kill) won't work. This variable serves (at least)
3432 double duty as both the pid of the target process (if it has
3433 such), and as a flag indicating that a target is active. */
3434 inferior_ptid = magic_null_ptid;
3438 remote_add_inferior (fake_pid_p, ptid_get_pid (inferior_ptid), -1, 1);
3440 /* Add the main thread. */
3441 add_thread_silent (inferior_ptid);
3445 remote_start_remote (int from_tty, struct target_ops *target, int extended_p)
3447 struct remote_state *rs = get_remote_state ();
3448 struct packet_config *noack_config;
3449 char *wait_status = NULL;
3451 immediate_quit++; /* Allow user to interrupt it. */
3454 if (interrupt_on_connect)
3455 send_interrupt_sequence ();
3457 /* Ack any packet which the remote side has already sent. */
3458 serial_write (rs->remote_desc, "+", 1);
3460 /* Signal other parts that we're going through the initial setup,
3461 and so things may not be stable yet. */
3462 rs->starting_up = 1;
3464 /* The first packet we send to the target is the optional "supported
3465 packets" request. If the target can answer this, it will tell us
3466 which later probes to skip. */
3467 remote_query_supported ();
3469 /* If the stub wants to get a QAllow, compose one and send it. */
3470 if (packet_support (PACKET_QAllow) != PACKET_DISABLE)
3471 remote_set_permissions (target);
3473 /* Next, we possibly activate noack mode.
3475 If the QStartNoAckMode packet configuration is set to AUTO,
3476 enable noack mode if the stub reported a wish for it with
3479 If set to TRUE, then enable noack mode even if the stub didn't
3480 report it in qSupported. If the stub doesn't reply OK, the
3481 session ends with an error.
3483 If FALSE, then don't activate noack mode, regardless of what the
3484 stub claimed should be the default with qSupported. */
3486 noack_config = &remote_protocol_packets[PACKET_QStartNoAckMode];
3487 if (packet_config_support (noack_config) != PACKET_DISABLE)
3489 putpkt ("QStartNoAckMode");
3490 getpkt (&rs->buf, &rs->buf_size, 0);
3491 if (packet_ok (rs->buf, noack_config) == PACKET_OK)
3497 /* Tell the remote that we are using the extended protocol. */
3499 getpkt (&rs->buf, &rs->buf_size, 0);
3502 /* Let the target know which signals it is allowed to pass down to
3504 update_signals_program_target ();
3506 /* Next, if the target can specify a description, read it. We do
3507 this before anything involving memory or registers. */
3508 target_find_description ();
3510 /* Next, now that we know something about the target, update the
3511 address spaces in the program spaces. */
3512 update_address_spaces ();
3514 /* On OSs where the list of libraries is global to all
3515 processes, we fetch them early. */
3516 if (gdbarch_has_global_solist (target_gdbarch ()))
3517 solib_add (NULL, from_tty, target, auto_solib_add);
3521 if (packet_support (PACKET_QNonStop) != PACKET_ENABLE)
3522 error (_("Non-stop mode requested, but remote "
3523 "does not support non-stop"));
3525 putpkt ("QNonStop:1");
3526 getpkt (&rs->buf, &rs->buf_size, 0);
3528 if (strcmp (rs->buf, "OK") != 0)
3529 error (_("Remote refused setting non-stop mode with: %s"), rs->buf);
3531 /* Find about threads and processes the stub is already
3532 controlling. We default to adding them in the running state.
3533 The '?' query below will then tell us about which threads are
3535 remote_update_thread_list (target);
3537 else if (packet_support (PACKET_QNonStop) == PACKET_ENABLE)
3539 /* Don't assume that the stub can operate in all-stop mode.
3540 Request it explicitly. */
3541 putpkt ("QNonStop:0");
3542 getpkt (&rs->buf, &rs->buf_size, 0);
3544 if (strcmp (rs->buf, "OK") != 0)
3545 error (_("Remote refused setting all-stop mode with: %s"), rs->buf);
3548 /* Upload TSVs regardless of whether the target is running or not. The
3549 remote stub, such as GDBserver, may have some predefined or builtin
3550 TSVs, even if the target is not running. */
3551 if (remote_get_trace_status (target, current_trace_status ()) != -1)
3553 struct uploaded_tsv *uploaded_tsvs = NULL;
3555 remote_upload_trace_state_variables (target, &uploaded_tsvs);
3556 merge_uploaded_trace_state_variables (&uploaded_tsvs);
3559 /* Check whether the target is running now. */
3561 getpkt (&rs->buf, &rs->buf_size, 0);
3567 struct inferior *inf;
3569 if (rs->buf[0] == 'W' || rs->buf[0] == 'X')
3572 error (_("The target is not running (try extended-remote?)"));
3574 /* We're connected, but not running. Drop out before we
3575 call start_remote. */
3576 rs->starting_up = 0;
3581 /* Save the reply for later. */
3582 wait_status = alloca (strlen (rs->buf) + 1);
3583 strcpy (wait_status, rs->buf);
3586 /* Fetch thread list. */
3587 target_update_thread_list ();
3589 /* Let the stub know that we want it to return the thread. */
3590 set_continue_thread (minus_one_ptid);
3592 if (thread_count () == 0)
3594 /* Target has no concept of threads at all. GDB treats
3595 non-threaded target as single-threaded; add a main
3597 add_current_inferior_and_thread (wait_status);
3601 /* We have thread information; select the thread the target
3602 says should be current. If we're reconnecting to a
3603 multi-threaded program, this will ideally be the thread
3604 that last reported an event before GDB disconnected. */
3605 inferior_ptid = get_current_thread (wait_status);
3606 if (ptid_equal (inferior_ptid, null_ptid))
3608 /* Odd... The target was able to list threads, but not
3609 tell us which thread was current (no "thread"
3610 register in T stop reply?). Just pick the first
3611 thread in the thread list then. */
3612 inferior_ptid = thread_list->ptid;
3616 /* init_wait_for_inferior should be called before get_offsets in order
3617 to manage `inserted' flag in bp loc in a correct state.
3618 breakpoint_init_inferior, called from init_wait_for_inferior, set
3619 `inserted' flag to 0, while before breakpoint_re_set, called from
3620 start_remote, set `inserted' flag to 1. In the initialization of
3621 inferior, breakpoint_init_inferior should be called first, and then
3622 breakpoint_re_set can be called. If this order is broken, state of
3623 `inserted' flag is wrong, and cause some problems on breakpoint
3625 init_wait_for_inferior ();
3627 get_offsets (); /* Get text, data & bss offsets. */
3629 /* If we could not find a description using qXfer, and we know
3630 how to do it some other way, try again. This is not
3631 supported for non-stop; it could be, but it is tricky if
3632 there are no stopped threads when we connect. */
3633 if (remote_read_description_p (target)
3634 && gdbarch_target_desc (target_gdbarch ()) == NULL)
3636 target_clear_description ();
3637 target_find_description ();
3640 /* Use the previously fetched status. */
3641 gdb_assert (wait_status != NULL);
3642 strcpy (rs->buf, wait_status);
3643 rs->cached_wait_status = 1;
3646 start_remote (from_tty); /* Initialize gdb process mechanisms. */
3650 /* Clear WFI global state. Do this before finding about new
3651 threads and inferiors, and setting the current inferior.
3652 Otherwise we would clear the proceed status of the current
3653 inferior when we want its stop_soon state to be preserved
3654 (see notice_new_inferior). */
3655 init_wait_for_inferior ();
3657 /* In non-stop, we will either get an "OK", meaning that there
3658 are no stopped threads at this time; or, a regular stop
3659 reply. In the latter case, there may be more than one thread
3660 stopped --- we pull them all out using the vStopped
3662 if (strcmp (rs->buf, "OK") != 0)
3664 struct notif_client *notif = ¬if_client_stop;
3666 /* remote_notif_get_pending_replies acks this one, and gets
3668 rs->notif_state->pending_event[notif_client_stop.id]
3669 = remote_notif_parse (notif, rs->buf);
3670 remote_notif_get_pending_events (notif);
3672 /* Make sure that threads that were stopped remain
3674 iterate_over_threads (set_stop_requested_callback, NULL);
3677 if (target_can_async_p ())
3680 if (thread_count () == 0)
3683 error (_("The target is not running (try extended-remote?)"));
3685 /* We're connected, but not running. Drop out before we
3686 call start_remote. */
3687 rs->starting_up = 0;
3691 /* Let the stub know that we want it to return the thread. */
3693 /* Force the stub to choose a thread. */
3694 set_general_thread (null_ptid);
3697 inferior_ptid = remote_current_thread (minus_one_ptid);
3698 if (ptid_equal (inferior_ptid, minus_one_ptid))
3699 error (_("remote didn't report the current thread in non-stop mode"));
3701 get_offsets (); /* Get text, data & bss offsets. */
3703 /* In non-stop mode, any cached wait status will be stored in
3704 the stop reply queue. */
3705 gdb_assert (wait_status == NULL);
3707 /* Report all signals during attach/startup. */
3708 remote_pass_signals (target, 0, NULL);
3711 /* If we connected to a live target, do some additional setup. */
3712 if (target_has_execution)
3714 if (symfile_objfile) /* No use without a symbol-file. */
3715 remote_check_symbols ();
3718 /* Possibly the target has been engaged in a trace run started
3719 previously; find out where things are at. */
3720 if (remote_get_trace_status (target, current_trace_status ()) != -1)
3722 struct uploaded_tp *uploaded_tps = NULL;
3724 if (current_trace_status ()->running)
3725 printf_filtered (_("Trace is already running on the target.\n"));
3727 remote_upload_tracepoints (target, &uploaded_tps);
3729 merge_uploaded_tracepoints (&uploaded_tps);
3732 /* The thread and inferior lists are now synchronized with the
3733 target, our symbols have been relocated, and we're merged the
3734 target's tracepoints with ours. We're done with basic start
3736 rs->starting_up = 0;
3738 /* Maybe breakpoints are global and need to be inserted now. */
3739 if (breakpoints_should_be_inserted_now ())
3740 insert_breakpoints ();
3743 /* Open a connection to a remote debugger.
3744 NAME is the filename used for communication. */
3747 remote_open (const char *name, int from_tty)
3749 remote_open_1 (name, from_tty, &remote_ops, 0);
3752 /* Open a connection to a remote debugger using the extended
3753 remote gdb protocol. NAME is the filename used for communication. */
3756 extended_remote_open (const char *name, int from_tty)
3758 remote_open_1 (name, from_tty, &extended_remote_ops, 1 /*extended_p */);
3761 /* Reset all packets back to "unknown support". Called when opening a
3762 new connection to a remote target. */
3765 reset_all_packet_configs_support (void)
3769 for (i = 0; i < PACKET_MAX; i++)
3770 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
3773 /* Initialize all packet configs. */
3776 init_all_packet_configs (void)
3780 for (i = 0; i < PACKET_MAX; i++)
3782 remote_protocol_packets[i].detect = AUTO_BOOLEAN_AUTO;
3783 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
3787 /* Symbol look-up. */
3790 remote_check_symbols (void)
3792 struct remote_state *rs = get_remote_state ();
3793 char *msg, *reply, *tmp;
3794 struct bound_minimal_symbol sym;
3797 /* The remote side has no concept of inferiors that aren't running
3798 yet, it only knows about running processes. If we're connected
3799 but our current inferior is not running, we should not invite the
3800 remote target to request symbol lookups related to its
3801 (unrelated) current process. */
3802 if (!target_has_execution)
3805 if (packet_support (PACKET_qSymbol) == PACKET_DISABLE)
3808 /* Make sure the remote is pointing at the right process. Note
3809 there's no way to select "no process". */
3810 set_general_process ();
3812 /* Allocate a message buffer. We can't reuse the input buffer in RS,
3813 because we need both at the same time. */
3814 msg = alloca (get_remote_packet_size ());
3816 /* Invite target to request symbol lookups. */
3818 putpkt ("qSymbol::");
3819 getpkt (&rs->buf, &rs->buf_size, 0);
3820 packet_ok (rs->buf, &remote_protocol_packets[PACKET_qSymbol]);
3823 while (startswith (reply, "qSymbol:"))
3825 struct bound_minimal_symbol sym;
3828 end = hex2bin (tmp, (gdb_byte *) msg, strlen (tmp) / 2);
3830 sym = lookup_minimal_symbol (msg, NULL, NULL);
3831 if (sym.minsym == NULL)
3832 xsnprintf (msg, get_remote_packet_size (), "qSymbol::%s", &reply[8]);
3835 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
3836 CORE_ADDR sym_addr = BMSYMBOL_VALUE_ADDRESS (sym);
3838 /* If this is a function address, return the start of code
3839 instead of any data function descriptor. */
3840 sym_addr = gdbarch_convert_from_func_ptr_addr (target_gdbarch (),
3844 xsnprintf (msg, get_remote_packet_size (), "qSymbol:%s:%s",
3845 phex_nz (sym_addr, addr_size), &reply[8]);
3849 getpkt (&rs->buf, &rs->buf_size, 0);
3854 static struct serial *
3855 remote_serial_open (const char *name)
3857 static int udp_warning = 0;
3859 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
3860 of in ser-tcp.c, because it is the remote protocol assuming that the
3861 serial connection is reliable and not the serial connection promising
3863 if (!udp_warning && startswith (name, "udp:"))
3865 warning (_("The remote protocol may be unreliable over UDP.\n"
3866 "Some events may be lost, rendering further debugging "
3871 return serial_open (name);
3874 /* Inform the target of our permission settings. The permission flags
3875 work without this, but if the target knows the settings, it can do
3876 a couple things. First, it can add its own check, to catch cases
3877 that somehow manage to get by the permissions checks in target
3878 methods. Second, if the target is wired to disallow particular
3879 settings (for instance, a system in the field that is not set up to
3880 be able to stop at a breakpoint), it can object to any unavailable
3884 remote_set_permissions (struct target_ops *self)
3886 struct remote_state *rs = get_remote_state ();
3888 xsnprintf (rs->buf, get_remote_packet_size (), "QAllow:"
3889 "WriteReg:%x;WriteMem:%x;"
3890 "InsertBreak:%x;InsertTrace:%x;"
3891 "InsertFastTrace:%x;Stop:%x",
3892 may_write_registers, may_write_memory,
3893 may_insert_breakpoints, may_insert_tracepoints,
3894 may_insert_fast_tracepoints, may_stop);
3896 getpkt (&rs->buf, &rs->buf_size, 0);
3898 /* If the target didn't like the packet, warn the user. Do not try
3899 to undo the user's settings, that would just be maddening. */
3900 if (strcmp (rs->buf, "OK") != 0)
3901 warning (_("Remote refused setting permissions with: %s"), rs->buf);
3904 /* This type describes each known response to the qSupported
3906 struct protocol_feature
3908 /* The name of this protocol feature. */
3911 /* The default for this protocol feature. */
3912 enum packet_support default_support;
3914 /* The function to call when this feature is reported, or after
3915 qSupported processing if the feature is not supported.
3916 The first argument points to this structure. The second
3917 argument indicates whether the packet requested support be
3918 enabled, disabled, or probed (or the default, if this function
3919 is being called at the end of processing and this feature was
3920 not reported). The third argument may be NULL; if not NULL, it
3921 is a NUL-terminated string taken from the packet following
3922 this feature's name and an equals sign. */
3923 void (*func) (const struct protocol_feature *, enum packet_support,
3926 /* The corresponding packet for this feature. Only used if
3927 FUNC is remote_supported_packet. */
3932 remote_supported_packet (const struct protocol_feature *feature,
3933 enum packet_support support,
3934 const char *argument)
3938 warning (_("Remote qSupported response supplied an unexpected value for"
3939 " \"%s\"."), feature->name);
3943 remote_protocol_packets[feature->packet].support = support;
3947 remote_packet_size (const struct protocol_feature *feature,
3948 enum packet_support support, const char *value)
3950 struct remote_state *rs = get_remote_state ();
3955 if (support != PACKET_ENABLE)
3958 if (value == NULL || *value == '\0')
3960 warning (_("Remote target reported \"%s\" without a size."),
3966 packet_size = strtol (value, &value_end, 16);
3967 if (errno != 0 || *value_end != '\0' || packet_size < 0)
3969 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
3970 feature->name, value);
3974 if (packet_size > MAX_REMOTE_PACKET_SIZE)
3976 warning (_("limiting remote suggested packet size (%d bytes) to %d"),
3977 packet_size, MAX_REMOTE_PACKET_SIZE);
3978 packet_size = MAX_REMOTE_PACKET_SIZE;
3981 /* Record the new maximum packet size. */
3982 rs->explicit_packet_size = packet_size;
3985 static const struct protocol_feature remote_protocol_features[] = {
3986 { "PacketSize", PACKET_DISABLE, remote_packet_size, -1 },
3987 { "qXfer:auxv:read", PACKET_DISABLE, remote_supported_packet,
3988 PACKET_qXfer_auxv },
3989 { "qXfer:exec-file:read", PACKET_DISABLE, remote_supported_packet,
3990 PACKET_qXfer_exec_file },
3991 { "qXfer:features:read", PACKET_DISABLE, remote_supported_packet,
3992 PACKET_qXfer_features },
3993 { "qXfer:libraries:read", PACKET_DISABLE, remote_supported_packet,
3994 PACKET_qXfer_libraries },
3995 { "qXfer:libraries-svr4:read", PACKET_DISABLE, remote_supported_packet,
3996 PACKET_qXfer_libraries_svr4 },
3997 { "augmented-libraries-svr4-read", PACKET_DISABLE,
3998 remote_supported_packet, PACKET_augmented_libraries_svr4_read_feature },
3999 { "qXfer:memory-map:read", PACKET_DISABLE, remote_supported_packet,
4000 PACKET_qXfer_memory_map },
4001 { "qXfer:spu:read", PACKET_DISABLE, remote_supported_packet,
4002 PACKET_qXfer_spu_read },
4003 { "qXfer:spu:write", PACKET_DISABLE, remote_supported_packet,
4004 PACKET_qXfer_spu_write },
4005 { "qXfer:osdata:read", PACKET_DISABLE, remote_supported_packet,
4006 PACKET_qXfer_osdata },
4007 { "qXfer:threads:read", PACKET_DISABLE, remote_supported_packet,
4008 PACKET_qXfer_threads },
4009 { "qXfer:traceframe-info:read", PACKET_DISABLE, remote_supported_packet,
4010 PACKET_qXfer_traceframe_info },
4011 { "QPassSignals", PACKET_DISABLE, remote_supported_packet,
4012 PACKET_QPassSignals },
4013 { "QProgramSignals", PACKET_DISABLE, remote_supported_packet,
4014 PACKET_QProgramSignals },
4015 { "QStartNoAckMode", PACKET_DISABLE, remote_supported_packet,
4016 PACKET_QStartNoAckMode },
4017 { "multiprocess", PACKET_DISABLE, remote_supported_packet,
4018 PACKET_multiprocess_feature },
4019 { "QNonStop", PACKET_DISABLE, remote_supported_packet, PACKET_QNonStop },
4020 { "qXfer:siginfo:read", PACKET_DISABLE, remote_supported_packet,
4021 PACKET_qXfer_siginfo_read },
4022 { "qXfer:siginfo:write", PACKET_DISABLE, remote_supported_packet,
4023 PACKET_qXfer_siginfo_write },
4024 { "ConditionalTracepoints", PACKET_DISABLE, remote_supported_packet,
4025 PACKET_ConditionalTracepoints },
4026 { "ConditionalBreakpoints", PACKET_DISABLE, remote_supported_packet,
4027 PACKET_ConditionalBreakpoints },
4028 { "BreakpointCommands", PACKET_DISABLE, remote_supported_packet,
4029 PACKET_BreakpointCommands },
4030 { "FastTracepoints", PACKET_DISABLE, remote_supported_packet,
4031 PACKET_FastTracepoints },
4032 { "StaticTracepoints", PACKET_DISABLE, remote_supported_packet,
4033 PACKET_StaticTracepoints },
4034 {"InstallInTrace", PACKET_DISABLE, remote_supported_packet,
4035 PACKET_InstallInTrace},
4036 { "DisconnectedTracing", PACKET_DISABLE, remote_supported_packet,
4037 PACKET_DisconnectedTracing_feature },
4038 { "ReverseContinue", PACKET_DISABLE, remote_supported_packet,
4040 { "ReverseStep", PACKET_DISABLE, remote_supported_packet,
4042 { "TracepointSource", PACKET_DISABLE, remote_supported_packet,
4043 PACKET_TracepointSource },
4044 { "QAllow", PACKET_DISABLE, remote_supported_packet,
4046 { "EnableDisableTracepoints", PACKET_DISABLE, remote_supported_packet,
4047 PACKET_EnableDisableTracepoints_feature },
4048 { "qXfer:fdpic:read", PACKET_DISABLE, remote_supported_packet,
4049 PACKET_qXfer_fdpic },
4050 { "qXfer:uib:read", PACKET_DISABLE, remote_supported_packet,
4052 { "QDisableRandomization", PACKET_DISABLE, remote_supported_packet,
4053 PACKET_QDisableRandomization },
4054 { "QAgent", PACKET_DISABLE, remote_supported_packet, PACKET_QAgent},
4055 { "QTBuffer:size", PACKET_DISABLE,
4056 remote_supported_packet, PACKET_QTBuffer_size},
4057 { "tracenz", PACKET_DISABLE, remote_supported_packet, PACKET_tracenz_feature },
4058 { "Qbtrace:off", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_off },
4059 { "Qbtrace:bts", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_bts },
4060 { "qXfer:btrace:read", PACKET_DISABLE, remote_supported_packet,
4061 PACKET_qXfer_btrace },
4062 { "qXfer:btrace-conf:read", PACKET_DISABLE, remote_supported_packet,
4063 PACKET_qXfer_btrace_conf },
4064 { "Qbtrace-conf:bts:size", PACKET_DISABLE, remote_supported_packet,
4065 PACKET_Qbtrace_conf_bts_size },
4066 { "swbreak", PACKET_DISABLE, remote_supported_packet, PACKET_swbreak_feature },
4067 { "hwbreak", PACKET_DISABLE, remote_supported_packet, PACKET_hwbreak_feature },
4068 { "fork-events", PACKET_DISABLE, remote_supported_packet,
4069 PACKET_fork_event_feature },
4070 { "vfork-events", PACKET_DISABLE, remote_supported_packet,
4071 PACKET_vfork_event_feature },
4074 static char *remote_support_xml;
4076 /* Register string appended to "xmlRegisters=" in qSupported query. */
4079 register_remote_support_xml (const char *xml)
4081 #if defined(HAVE_LIBEXPAT)
4082 if (remote_support_xml == NULL)
4083 remote_support_xml = concat ("xmlRegisters=", xml, (char *) NULL);
4086 char *copy = xstrdup (remote_support_xml + 13);
4087 char *p = strtok (copy, ",");
4091 if (strcmp (p, xml) == 0)
4098 while ((p = strtok (NULL, ",")) != NULL);
4101 remote_support_xml = reconcat (remote_support_xml,
4102 remote_support_xml, ",", xml,
4109 remote_query_supported_append (char *msg, const char *append)
4112 return reconcat (msg, msg, ";", append, (char *) NULL);
4114 return xstrdup (append);
4118 remote_query_supported (void)
4120 struct remote_state *rs = get_remote_state ();
4123 unsigned char seen [ARRAY_SIZE (remote_protocol_features)];
4125 /* The packet support flags are handled differently for this packet
4126 than for most others. We treat an error, a disabled packet, and
4127 an empty response identically: any features which must be reported
4128 to be used will be automatically disabled. An empty buffer
4129 accomplishes this, since that is also the representation for a list
4130 containing no features. */
4133 if (packet_support (PACKET_qSupported) != PACKET_DISABLE)
4136 struct cleanup *old_chain = make_cleanup (free_current_contents, &q);
4138 q = remote_query_supported_append (q, "multiprocess+");
4140 if (packet_set_cmd_state (PACKET_swbreak_feature) != AUTO_BOOLEAN_FALSE)
4141 q = remote_query_supported_append (q, "swbreak+");
4142 if (packet_set_cmd_state (PACKET_hwbreak_feature) != AUTO_BOOLEAN_FALSE)
4143 q = remote_query_supported_append (q, "hwbreak+");
4145 if (remote_support_xml)
4146 q = remote_query_supported_append (q, remote_support_xml);
4148 q = remote_query_supported_append (q, "qRelocInsn+");
4152 if (packet_set_cmd_state (PACKET_fork_event_feature)
4153 != AUTO_BOOLEAN_FALSE)
4154 q = remote_query_supported_append (q, "fork-events+");
4155 if (packet_set_cmd_state (PACKET_vfork_event_feature)
4156 != AUTO_BOOLEAN_FALSE)
4157 q = remote_query_supported_append (q, "vfork-events+");
4160 q = reconcat (q, "qSupported:", q, (char *) NULL);
4163 do_cleanups (old_chain);
4165 getpkt (&rs->buf, &rs->buf_size, 0);
4167 /* If an error occured, warn, but do not return - just reset the
4168 buffer to empty and go on to disable features. */
4169 if (packet_ok (rs->buf, &remote_protocol_packets[PACKET_qSupported])
4172 warning (_("Remote failure reply: %s"), rs->buf);
4177 memset (seen, 0, sizeof (seen));
4182 enum packet_support is_supported;
4183 char *p, *end, *name_end, *value;
4185 /* First separate out this item from the rest of the packet. If
4186 there's another item after this, we overwrite the separator
4187 (terminated strings are much easier to work with). */
4189 end = strchr (p, ';');
4192 end = p + strlen (p);
4202 warning (_("empty item in \"qSupported\" response"));
4207 name_end = strchr (p, '=');
4210 /* This is a name=value entry. */
4211 is_supported = PACKET_ENABLE;
4212 value = name_end + 1;
4221 is_supported = PACKET_ENABLE;
4225 is_supported = PACKET_DISABLE;
4229 is_supported = PACKET_SUPPORT_UNKNOWN;
4233 warning (_("unrecognized item \"%s\" "
4234 "in \"qSupported\" response"), p);
4240 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
4241 if (strcmp (remote_protocol_features[i].name, p) == 0)
4243 const struct protocol_feature *feature;
4246 feature = &remote_protocol_features[i];
4247 feature->func (feature, is_supported, value);
4252 /* If we increased the packet size, make sure to increase the global
4253 buffer size also. We delay this until after parsing the entire
4254 qSupported packet, because this is the same buffer we were
4256 if (rs->buf_size < rs->explicit_packet_size)
4258 rs->buf_size = rs->explicit_packet_size;
4259 rs->buf = xrealloc (rs->buf, rs->buf_size);
4262 /* Handle the defaults for unmentioned features. */
4263 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
4266 const struct protocol_feature *feature;
4268 feature = &remote_protocol_features[i];
4269 feature->func (feature, feature->default_support, NULL);
4273 /* Remove any of the remote.c targets from target stack. Upper targets depend
4274 on it so remove them first. */
4277 remote_unpush_target (void)
4279 pop_all_targets_above (process_stratum - 1);
4283 remote_open_1 (const char *name, int from_tty,
4284 struct target_ops *target, int extended_p)
4286 struct remote_state *rs = get_remote_state ();
4289 error (_("To open a remote debug connection, you need to specify what\n"
4290 "serial device is attached to the remote system\n"
4291 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
4293 /* See FIXME above. */
4294 if (!target_async_permitted)
4295 wait_forever_enabled_p = 1;
4297 /* If we're connected to a running target, target_preopen will kill it.
4298 Ask this question first, before target_preopen has a chance to kill
4300 if (rs->remote_desc != NULL && !have_inferiors ())
4303 && !query (_("Already connected to a remote target. Disconnect? ")))
4304 error (_("Still connected."));
4307 /* Here the possibly existing remote target gets unpushed. */
4308 target_preopen (from_tty);
4310 /* Make sure we send the passed signals list the next time we resume. */
4311 xfree (rs->last_pass_packet);
4312 rs->last_pass_packet = NULL;
4314 /* Make sure we send the program signals list the next time we
4316 xfree (rs->last_program_signals_packet);
4317 rs->last_program_signals_packet = NULL;
4319 remote_fileio_reset ();
4320 reopen_exec_file ();
4323 rs->remote_desc = remote_serial_open (name);
4324 if (!rs->remote_desc)
4325 perror_with_name (name);
4327 if (baud_rate != -1)
4329 if (serial_setbaudrate (rs->remote_desc, baud_rate))
4331 /* The requested speed could not be set. Error out to
4332 top level after closing remote_desc. Take care to
4333 set remote_desc to NULL to avoid closing remote_desc
4335 serial_close (rs->remote_desc);
4336 rs->remote_desc = NULL;
4337 perror_with_name (name);
4341 serial_setparity (rs->remote_desc, serial_parity);
4342 serial_raw (rs->remote_desc);
4344 /* If there is something sitting in the buffer we might take it as a
4345 response to a command, which would be bad. */
4346 serial_flush_input (rs->remote_desc);
4350 puts_filtered ("Remote debugging using ");
4351 puts_filtered (name);
4352 puts_filtered ("\n");
4354 push_target (target); /* Switch to using remote target now. */
4356 /* Register extra event sources in the event loop. */
4357 remote_async_inferior_event_token
4358 = create_async_event_handler (remote_async_inferior_event_handler,
4360 rs->notif_state = remote_notif_state_allocate ();
4362 /* Reset the target state; these things will be queried either by
4363 remote_query_supported or as they are needed. */
4364 reset_all_packet_configs_support ();
4365 rs->cached_wait_status = 0;
4366 rs->explicit_packet_size = 0;
4368 rs->extended = extended_p;
4369 rs->waiting_for_stop_reply = 0;
4370 rs->ctrlc_pending_p = 0;
4372 rs->general_thread = not_sent_ptid;
4373 rs->continue_thread = not_sent_ptid;
4374 rs->remote_traceframe_number = -1;
4376 /* Probe for ability to use "ThreadInfo" query, as required. */
4377 rs->use_threadinfo_query = 1;
4378 rs->use_threadextra_query = 1;
4380 if (target_async_permitted)
4382 /* With this target we start out by owning the terminal. */
4383 remote_async_terminal_ours_p = 1;
4385 /* FIXME: cagney/1999-09-23: During the initial connection it is
4386 assumed that the target is already ready and able to respond to
4387 requests. Unfortunately remote_start_remote() eventually calls
4388 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
4389 around this. Eventually a mechanism that allows
4390 wait_for_inferior() to expect/get timeouts will be
4392 wait_forever_enabled_p = 0;
4395 /* First delete any symbols previously loaded from shared libraries. */
4396 no_shared_libraries (NULL, 0);
4399 init_thread_list ();
4401 /* Start the remote connection. If error() or QUIT, discard this
4402 target (we'd otherwise be in an inconsistent state) and then
4403 propogate the error on up the exception chain. This ensures that
4404 the caller doesn't stumble along blindly assuming that the
4405 function succeeded. The CLI doesn't have this problem but other
4406 UI's, such as MI do.
4408 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
4409 this function should return an error indication letting the
4410 caller restore the previous state. Unfortunately the command
4411 ``target remote'' is directly wired to this function making that
4412 impossible. On a positive note, the CLI side of this problem has
4413 been fixed - the function set_cmd_context() makes it possible for
4414 all the ``target ....'' commands to share a common callback
4415 function. See cli-dump.c. */
4420 remote_start_remote (from_tty, target, extended_p);
4422 CATCH (ex, RETURN_MASK_ALL)
4424 /* Pop the partially set up target - unless something else did
4425 already before throwing the exception. */
4426 if (rs->remote_desc != NULL)
4427 remote_unpush_target ();
4428 if (target_async_permitted)
4429 wait_forever_enabled_p = 1;
4430 throw_exception (ex);
4435 remote_btrace_reset ();
4437 if (target_async_permitted)
4438 wait_forever_enabled_p = 1;
4441 /* Detach the specified process. */
4444 remote_detach_pid (int pid)
4446 struct remote_state *rs = get_remote_state ();
4448 if (remote_multi_process_p (rs))
4449 xsnprintf (rs->buf, get_remote_packet_size (), "D;%x", pid);
4451 strcpy (rs->buf, "D");
4454 getpkt (&rs->buf, &rs->buf_size, 0);
4456 if (rs->buf[0] == 'O' && rs->buf[1] == 'K')
4458 else if (rs->buf[0] == '\0')
4459 error (_("Remote doesn't know how to detach"));
4461 error (_("Can't detach process."));
4464 /* This detaches a program to which we previously attached, using
4465 inferior_ptid to identify the process. After this is done, GDB
4466 can be used to debug some other program. We better not have left
4467 any breakpoints in the target program or it'll die when it hits
4471 remote_detach_1 (const char *args, int from_tty)
4473 int pid = ptid_get_pid (inferior_ptid);
4474 struct remote_state *rs = get_remote_state ();
4475 struct thread_info *tp = find_thread_ptid (inferior_ptid);
4479 error (_("Argument given to \"detach\" when remotely debugging."));
4481 if (!target_has_execution)
4482 error (_("No process to detach from."));
4486 char *exec_file = get_exec_file (0);
4487 if (exec_file == NULL)
4489 printf_unfiltered (_("Detaching from program: %s, %s\n"), exec_file,
4490 target_pid_to_str (pid_to_ptid (pid)));
4491 gdb_flush (gdb_stdout);
4494 /* Tell the remote target to detach. */
4495 remote_detach_pid (pid);
4497 if (from_tty && !rs->extended)
4498 puts_filtered (_("Ending remote debugging.\n"));
4500 /* Check to see if we are detaching a fork parent. Note that if we
4501 are detaching a fork child, tp == NULL. */
4502 is_fork_parent = (tp != NULL
4503 && tp->pending_follow.kind == TARGET_WAITKIND_FORKED);
4505 /* If doing detach-on-fork, we don't mourn, because that will delete
4506 breakpoints that should be available for the followed inferior. */
4507 if (!is_fork_parent)
4508 target_mourn_inferior ();
4511 inferior_ptid = null_ptid;
4512 detach_inferior (pid);
4517 remote_detach (struct target_ops *ops, const char *args, int from_tty)
4519 remote_detach_1 (args, from_tty);
4523 extended_remote_detach (struct target_ops *ops, const char *args, int from_tty)
4525 remote_detach_1 (args, from_tty);
4528 /* Target follow-fork function for remote targets. On entry, and
4529 at return, the current inferior is the fork parent.
4531 Note that although this is currently only used for extended-remote,
4532 it is named remote_follow_fork in anticipation of using it for the
4533 remote target as well. */
4536 remote_follow_fork (struct target_ops *ops, int follow_child,
4539 struct remote_state *rs = get_remote_state ();
4541 if (remote_fork_event_p (rs))
4543 /* When following the parent and detaching the child, we detach
4544 the child here. For the case of following the child and
4545 detaching the parent, the detach is done in the target-
4546 independent follow fork code in infrun.c. We can't use
4547 target_detach when detaching an unfollowed child because
4548 the client side doesn't know anything about the child. */
4549 if (detach_fork && !follow_child)
4551 /* Detach the fork child. */
4555 child_ptid = inferior_thread ()->pending_follow.value.related_pid;
4556 child_pid = ptid_get_pid (child_ptid);
4558 remote_detach_pid (child_pid);
4559 detach_inferior (child_pid);
4565 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
4568 remote_disconnect (struct target_ops *target, const char *args, int from_tty)
4571 error (_("Argument given to \"disconnect\" when remotely debugging."));
4573 /* Make sure we unpush even the extended remote targets; mourn
4574 won't do it. So call remote_mourn directly instead of
4575 target_mourn_inferior. */
4576 remote_mourn (target);
4579 puts_filtered ("Ending remote debugging.\n");
4582 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
4583 be chatty about it. */
4586 extended_remote_attach (struct target_ops *target, const char *args,
4589 struct remote_state *rs = get_remote_state ();
4591 char *wait_status = NULL;
4593 pid = parse_pid_to_attach (args);
4595 /* Remote PID can be freely equal to getpid, do not check it here the same
4596 way as in other targets. */
4598 if (packet_support (PACKET_vAttach) == PACKET_DISABLE)
4599 error (_("This target does not support attaching to a process"));
4603 char *exec_file = get_exec_file (0);
4606 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file,
4607 target_pid_to_str (pid_to_ptid (pid)));
4609 printf_unfiltered (_("Attaching to %s\n"),
4610 target_pid_to_str (pid_to_ptid (pid)));
4612 gdb_flush (gdb_stdout);
4615 xsnprintf (rs->buf, get_remote_packet_size (), "vAttach;%x", pid);
4617 getpkt (&rs->buf, &rs->buf_size, 0);
4619 switch (packet_ok (rs->buf,
4620 &remote_protocol_packets[PACKET_vAttach]))
4625 /* Save the reply for later. */
4626 wait_status = alloca (strlen (rs->buf) + 1);
4627 strcpy (wait_status, rs->buf);
4629 else if (strcmp (rs->buf, "OK") != 0)
4630 error (_("Attaching to %s failed with: %s"),
4631 target_pid_to_str (pid_to_ptid (pid)),
4634 case PACKET_UNKNOWN:
4635 error (_("This target does not support attaching to a process"));
4637 error (_("Attaching to %s failed"),
4638 target_pid_to_str (pid_to_ptid (pid)));
4641 set_current_inferior (remote_add_inferior (0, pid, 1, 0));
4643 inferior_ptid = pid_to_ptid (pid);
4647 struct thread_info *thread;
4649 /* Get list of threads. */
4650 remote_update_thread_list (target);
4652 thread = first_thread_of_process (pid);
4654 inferior_ptid = thread->ptid;
4656 inferior_ptid = pid_to_ptid (pid);
4658 /* Invalidate our notion of the remote current thread. */
4659 record_currthread (rs, minus_one_ptid);
4663 /* Now, if we have thread information, update inferior_ptid. */
4664 inferior_ptid = remote_current_thread (inferior_ptid);
4666 /* Add the main thread to the thread list. */
4667 add_thread_silent (inferior_ptid);
4670 /* Next, if the target can specify a description, read it. We do
4671 this before anything involving memory or registers. */
4672 target_find_description ();
4676 /* Use the previously fetched status. */
4677 gdb_assert (wait_status != NULL);
4679 if (target_can_async_p ())
4681 struct notif_event *reply
4682 = remote_notif_parse (¬if_client_stop, wait_status);
4684 push_stop_reply ((struct stop_reply *) reply);
4690 gdb_assert (wait_status != NULL);
4691 strcpy (rs->buf, wait_status);
4692 rs->cached_wait_status = 1;
4696 gdb_assert (wait_status == NULL);
4699 /* Implementation of the to_post_attach method. */
4702 extended_remote_post_attach (struct target_ops *ops, int pid)
4704 /* In certain cases GDB might not have had the chance to start
4705 symbol lookup up until now. This could happen if the debugged
4706 binary is not using shared libraries, the vsyscall page is not
4707 present (on Linux) and the binary itself hadn't changed since the
4708 debugging process was started. */
4709 if (symfile_objfile != NULL)
4710 remote_check_symbols();
4714 /* Check for the availability of vCont. This function should also check
4718 remote_vcont_probe (struct remote_state *rs)
4722 strcpy (rs->buf, "vCont?");
4724 getpkt (&rs->buf, &rs->buf_size, 0);
4727 /* Make sure that the features we assume are supported. */
4728 if (startswith (buf, "vCont"))
4731 int support_s, support_S, support_c, support_C;
4737 rs->supports_vCont.t = 0;
4738 rs->supports_vCont.r = 0;
4739 while (p && *p == ';')
4742 if (*p == 's' && (*(p + 1) == ';' || *(p + 1) == 0))
4744 else if (*p == 'S' && (*(p + 1) == ';' || *(p + 1) == 0))
4746 else if (*p == 'c' && (*(p + 1) == ';' || *(p + 1) == 0))
4748 else if (*p == 'C' && (*(p + 1) == ';' || *(p + 1) == 0))
4750 else if (*p == 't' && (*(p + 1) == ';' || *(p + 1) == 0))
4751 rs->supports_vCont.t = 1;
4752 else if (*p == 'r' && (*(p + 1) == ';' || *(p + 1) == 0))
4753 rs->supports_vCont.r = 1;
4755 p = strchr (p, ';');
4758 /* If s, S, c, and C are not all supported, we can't use vCont. Clearing
4759 BUF will make packet_ok disable the packet. */
4760 if (!support_s || !support_S || !support_c || !support_C)
4764 packet_ok (buf, &remote_protocol_packets[PACKET_vCont]);
4767 /* Helper function for building "vCont" resumptions. Write a
4768 resumption to P. ENDP points to one-passed-the-end of the buffer
4769 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
4770 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
4771 resumed thread should be single-stepped and/or signalled. If PTID
4772 equals minus_one_ptid, then all threads are resumed; if PTID
4773 represents a process, then all threads of the process are resumed;
4774 the thread to be stepped and/or signalled is given in the global
4778 append_resumption (char *p, char *endp,
4779 ptid_t ptid, int step, enum gdb_signal siggnal)
4781 struct remote_state *rs = get_remote_state ();
4783 if (step && siggnal != GDB_SIGNAL_0)
4784 p += xsnprintf (p, endp - p, ";S%02x", siggnal);
4786 /* GDB is willing to range step. */
4787 && use_range_stepping
4788 /* Target supports range stepping. */
4789 && rs->supports_vCont.r
4790 /* We don't currently support range stepping multiple
4791 threads with a wildcard (though the protocol allows it,
4792 so stubs shouldn't make an active effort to forbid
4794 && !(remote_multi_process_p (rs) && ptid_is_pid (ptid)))
4796 struct thread_info *tp;
4798 if (ptid_equal (ptid, minus_one_ptid))
4800 /* If we don't know about the target thread's tid, then
4801 we're resuming magic_null_ptid (see caller). */
4802 tp = find_thread_ptid (magic_null_ptid);
4805 tp = find_thread_ptid (ptid);
4806 gdb_assert (tp != NULL);
4808 if (tp->control.may_range_step)
4810 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
4812 p += xsnprintf (p, endp - p, ";r%s,%s",
4813 phex_nz (tp->control.step_range_start,
4815 phex_nz (tp->control.step_range_end,
4819 p += xsnprintf (p, endp - p, ";s");
4822 p += xsnprintf (p, endp - p, ";s");
4823 else if (siggnal != GDB_SIGNAL_0)
4824 p += xsnprintf (p, endp - p, ";C%02x", siggnal);
4826 p += xsnprintf (p, endp - p, ";c");
4828 if (remote_multi_process_p (rs) && ptid_is_pid (ptid))
4832 /* All (-1) threads of process. */
4833 nptid = ptid_build (ptid_get_pid (ptid), -1, 0);
4835 p += xsnprintf (p, endp - p, ":");
4836 p = write_ptid (p, endp, nptid);
4838 else if (!ptid_equal (ptid, minus_one_ptid))
4840 p += xsnprintf (p, endp - p, ":");
4841 p = write_ptid (p, endp, ptid);
4847 /* Append a vCont continue-with-signal action for threads that have a
4848 non-zero stop signal. */
4851 append_pending_thread_resumptions (char *p, char *endp, ptid_t ptid)
4853 struct thread_info *thread;
4855 ALL_NON_EXITED_THREADS (thread)
4856 if (ptid_match (thread->ptid, ptid)
4857 && !ptid_equal (inferior_ptid, thread->ptid)
4858 && thread->suspend.stop_signal != GDB_SIGNAL_0)
4860 p = append_resumption (p, endp, thread->ptid,
4861 0, thread->suspend.stop_signal);
4862 thread->suspend.stop_signal = GDB_SIGNAL_0;
4868 /* Resume the remote inferior by using a "vCont" packet. The thread
4869 to be resumed is PTID; STEP and SIGGNAL indicate whether the
4870 resumed thread should be single-stepped and/or signalled. If PTID
4871 equals minus_one_ptid, then all threads are resumed; the thread to
4872 be stepped and/or signalled is given in the global INFERIOR_PTID.
4873 This function returns non-zero iff it resumes the inferior.
4875 This function issues a strict subset of all possible vCont commands at the
4879 remote_vcont_resume (ptid_t ptid, int step, enum gdb_signal siggnal)
4881 struct remote_state *rs = get_remote_state ();
4885 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
4886 remote_vcont_probe (rs);
4888 if (packet_support (PACKET_vCont) == PACKET_DISABLE)
4892 endp = rs->buf + get_remote_packet_size ();
4894 /* If we could generate a wider range of packets, we'd have to worry
4895 about overflowing BUF. Should there be a generic
4896 "multi-part-packet" packet? */
4898 p += xsnprintf (p, endp - p, "vCont");
4900 if (ptid_equal (ptid, magic_null_ptid))
4902 /* MAGIC_NULL_PTID means that we don't have any active threads,
4903 so we don't have any TID numbers the inferior will
4904 understand. Make sure to only send forms that do not specify
4906 append_resumption (p, endp, minus_one_ptid, step, siggnal);
4908 else if (ptid_equal (ptid, minus_one_ptid) || ptid_is_pid (ptid))
4910 /* Resume all threads (of all processes, or of a single
4911 process), with preference for INFERIOR_PTID. This assumes
4912 inferior_ptid belongs to the set of all threads we are about
4914 if (step || siggnal != GDB_SIGNAL_0)
4916 /* Step inferior_ptid, with or without signal. */
4917 p = append_resumption (p, endp, inferior_ptid, step, siggnal);
4920 /* Also pass down any pending signaled resumption for other
4921 threads not the current. */
4922 p = append_pending_thread_resumptions (p, endp, ptid);
4924 /* And continue others without a signal. */
4925 append_resumption (p, endp, ptid, /*step=*/ 0, GDB_SIGNAL_0);
4929 /* Scheduler locking; resume only PTID. */
4930 append_resumption (p, endp, ptid, step, siggnal);
4933 gdb_assert (strlen (rs->buf) < get_remote_packet_size ());
4938 /* In non-stop, the stub replies to vCont with "OK". The stop
4939 reply will be reported asynchronously by means of a `%Stop'
4941 getpkt (&rs->buf, &rs->buf_size, 0);
4942 if (strcmp (rs->buf, "OK") != 0)
4943 error (_("Unexpected vCont reply in non-stop mode: %s"), rs->buf);
4949 /* Tell the remote machine to resume. */
4952 remote_resume (struct target_ops *ops,
4953 ptid_t ptid, int step, enum gdb_signal siggnal)
4955 struct remote_state *rs = get_remote_state ();
4958 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
4959 (explained in remote-notif.c:handle_notification) so
4960 remote_notif_process is not called. We need find a place where
4961 it is safe to start a 'vNotif' sequence. It is good to do it
4962 before resuming inferior, because inferior was stopped and no RSP
4963 traffic at that moment. */
4965 remote_notif_process (rs->notif_state, ¬if_client_stop);
4967 rs->last_sent_signal = siggnal;
4968 rs->last_sent_step = step;
4970 /* The vCont packet doesn't need to specify threads via Hc. */
4971 /* No reverse support (yet) for vCont. */
4972 if (execution_direction != EXEC_REVERSE)
4973 if (remote_vcont_resume (ptid, step, siggnal))
4976 /* All other supported resume packets do use Hc, so set the continue
4978 if (ptid_equal (ptid, minus_one_ptid))
4979 set_continue_thread (any_thread_ptid);
4981 set_continue_thread (ptid);
4984 if (execution_direction == EXEC_REVERSE)
4986 /* We don't pass signals to the target in reverse exec mode. */
4987 if (info_verbose && siggnal != GDB_SIGNAL_0)
4988 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
4991 if (step && packet_support (PACKET_bs) == PACKET_DISABLE)
4992 error (_("Remote reverse-step not supported."));
4993 if (!step && packet_support (PACKET_bc) == PACKET_DISABLE)
4994 error (_("Remote reverse-continue not supported."));
4996 strcpy (buf, step ? "bs" : "bc");
4998 else if (siggnal != GDB_SIGNAL_0)
5000 buf[0] = step ? 'S' : 'C';
5001 buf[1] = tohex (((int) siggnal >> 4) & 0xf);
5002 buf[2] = tohex (((int) siggnal) & 0xf);
5006 strcpy (buf, step ? "s" : "c");
5011 /* We are about to start executing the inferior, let's register it
5012 with the event loop. NOTE: this is the one place where all the
5013 execution commands end up. We could alternatively do this in each
5014 of the execution commands in infcmd.c. */
5015 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
5016 into infcmd.c in order to allow inferior function calls to work
5017 NOT asynchronously. */
5018 if (target_can_async_p ())
5021 /* We've just told the target to resume. The remote server will
5022 wait for the inferior to stop, and then send a stop reply. In
5023 the mean time, we can't start another command/query ourselves
5024 because the stub wouldn't be ready to process it. This applies
5025 only to the base all-stop protocol, however. In non-stop (which
5026 only supports vCont), the stub replies with an "OK", and is
5027 immediate able to process further serial input. */
5029 rs->waiting_for_stop_reply = 1;
5033 /* Set up the signal handler for SIGINT, while the target is
5034 executing, ovewriting the 'regular' SIGINT signal handler. */
5036 async_initialize_sigint_signal_handler (void)
5038 signal (SIGINT, async_handle_remote_sigint);
5041 /* Signal handler for SIGINT, while the target is executing. */
5043 async_handle_remote_sigint (int sig)
5045 signal (sig, async_handle_remote_sigint_twice);
5046 /* Note we need to go through gdb_call_async_signal_handler in order
5047 to wake up the event loop on Windows. */
5048 gdb_call_async_signal_handler (async_sigint_remote_token, 0);
5051 /* Signal handler for SIGINT, installed after SIGINT has already been
5052 sent once. It will take effect the second time that the user sends
5055 async_handle_remote_sigint_twice (int sig)
5057 signal (sig, async_handle_remote_sigint);
5058 /* See note in async_handle_remote_sigint. */
5059 gdb_call_async_signal_handler (async_sigint_remote_twice_token, 0);
5062 /* Perform the real interruption of the target execution, in response
5065 async_remote_interrupt (gdb_client_data arg)
5068 fprintf_unfiltered (gdb_stdlog, "async_remote_interrupt called\n");
5070 target_stop (inferior_ptid);
5073 /* Perform interrupt, if the first attempt did not succeed. Just give
5074 up on the target alltogether. */
5076 async_remote_interrupt_twice (gdb_client_data arg)
5079 fprintf_unfiltered (gdb_stdlog, "async_remote_interrupt_twice called\n");
5084 /* Reinstall the usual SIGINT handlers, after the target has
5087 async_cleanup_sigint_signal_handler (void *dummy)
5089 signal (SIGINT, handle_sigint);
5092 /* Send ^C to target to halt it. Target will respond, and send us a
5094 static void (*ofunc) (int);
5096 /* The command line interface's stop routine. This function is installed
5097 as a signal handler for SIGINT. The first time a user requests a
5098 stop, we call remote_stop to send a break or ^C. If there is no
5099 response from the target (it didn't stop when the user requested it),
5100 we ask the user if he'd like to detach from the target. */
5102 sync_remote_interrupt (int signo)
5104 /* If this doesn't work, try more severe steps. */
5105 signal (signo, sync_remote_interrupt_twice);
5107 gdb_call_async_signal_handler (async_sigint_remote_token, 1);
5110 /* The user typed ^C twice. */
5113 sync_remote_interrupt_twice (int signo)
5115 signal (signo, ofunc);
5116 gdb_call_async_signal_handler (async_sigint_remote_twice_token, 1);
5117 signal (signo, sync_remote_interrupt);
5120 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
5121 thread, all threads of a remote process, or all threads of all
5125 remote_stop_ns (ptid_t ptid)
5127 struct remote_state *rs = get_remote_state ();
5129 char *endp = rs->buf + get_remote_packet_size ();
5131 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
5132 remote_vcont_probe (rs);
5134 if (!rs->supports_vCont.t)
5135 error (_("Remote server does not support stopping threads"));
5137 if (ptid_equal (ptid, minus_one_ptid)
5138 || (!remote_multi_process_p (rs) && ptid_is_pid (ptid)))
5139 p += xsnprintf (p, endp - p, "vCont;t");
5144 p += xsnprintf (p, endp - p, "vCont;t:");
5146 if (ptid_is_pid (ptid))
5147 /* All (-1) threads of process. */
5148 nptid = ptid_build (ptid_get_pid (ptid), -1, 0);
5151 /* Small optimization: if we already have a stop reply for
5152 this thread, no use in telling the stub we want this
5154 if (peek_stop_reply (ptid))
5160 write_ptid (p, endp, nptid);
5163 /* In non-stop, we get an immediate OK reply. The stop reply will
5164 come in asynchronously by notification. */
5166 getpkt (&rs->buf, &rs->buf_size, 0);
5167 if (strcmp (rs->buf, "OK") != 0)
5168 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid), rs->buf);
5171 /* All-stop version of target_stop. Sends a break or a ^C to stop the
5172 remote target. It is undefined which thread of which process
5173 reports the stop. */
5176 remote_stop_as (ptid_t ptid)
5178 struct remote_state *rs = get_remote_state ();
5180 rs->ctrlc_pending_p = 1;
5182 /* If the inferior is stopped already, but the core didn't know
5183 about it yet, just ignore the request. The cached wait status
5184 will be collected in remote_wait. */
5185 if (rs->cached_wait_status)
5188 /* Send interrupt_sequence to remote target. */
5189 send_interrupt_sequence ();
5192 /* This is the generic stop called via the target vector. When a target
5193 interrupt is requested, either by the command line or the GUI, we
5194 will eventually end up here. */
5197 remote_stop (struct target_ops *self, ptid_t ptid)
5200 fprintf_unfiltered (gdb_stdlog, "remote_stop called\n");
5203 remote_stop_ns (ptid);
5205 remote_stop_as (ptid);
5208 /* Ask the user what to do when an interrupt is received. */
5211 interrupt_query (void)
5213 target_terminal_ours ();
5215 if (target_is_async_p ())
5217 signal (SIGINT, handle_sigint);
5222 if (query (_("Interrupted while waiting for the program.\n\
5223 Give up (and stop debugging it)? ")))
5225 remote_unpush_target ();
5230 target_terminal_inferior ();
5233 /* Enable/disable target terminal ownership. Most targets can use
5234 terminal groups to control terminal ownership. Remote targets are
5235 different in that explicit transfer of ownership to/from GDB/target
5239 remote_terminal_inferior (struct target_ops *self)
5241 if (!target_async_permitted)
5242 /* Nothing to do. */
5245 /* FIXME: cagney/1999-09-27: Make calls to target_terminal_*()
5246 idempotent. The event-loop GDB talking to an asynchronous target
5247 with a synchronous command calls this function from both
5248 event-top.c and infrun.c/infcmd.c. Once GDB stops trying to
5249 transfer the terminal to the target when it shouldn't this guard
5251 if (!remote_async_terminal_ours_p)
5253 delete_file_handler (input_fd);
5254 remote_async_terminal_ours_p = 0;
5255 async_initialize_sigint_signal_handler ();
5256 /* NOTE: At this point we could also register our selves as the
5257 recipient of all input. Any characters typed could then be
5258 passed on down to the target. */
5262 remote_terminal_ours (struct target_ops *self)
5264 if (!target_async_permitted)
5265 /* Nothing to do. */
5268 /* See FIXME in remote_terminal_inferior. */
5269 if (remote_async_terminal_ours_p)
5271 async_cleanup_sigint_signal_handler (NULL);
5272 add_file_handler (input_fd, stdin_event_handler, 0);
5273 remote_async_terminal_ours_p = 1;
5277 remote_console_output (char *msg)
5281 for (p = msg; p[0] && p[1]; p += 2)
5284 char c = fromhex (p[0]) * 16 + fromhex (p[1]);
5288 fputs_unfiltered (tb, gdb_stdtarg);
5290 gdb_flush (gdb_stdtarg);
5293 typedef struct cached_reg
5296 gdb_byte data[MAX_REGISTER_SIZE];
5299 DEF_VEC_O(cached_reg_t);
5301 typedef struct stop_reply
5303 struct notif_event base;
5305 /* The identifier of the thread about this event */
5308 /* The remote state this event is associated with. When the remote
5309 connection, represented by a remote_state object, is closed,
5310 all the associated stop_reply events should be released. */
5311 struct remote_state *rs;
5313 struct target_waitstatus ws;
5315 /* Expedited registers. This makes remote debugging a bit more
5316 efficient for those targets that provide critical registers as
5317 part of their normal status mechanism (as another roundtrip to
5318 fetch them is avoided). */
5319 VEC(cached_reg_t) *regcache;
5321 enum target_stop_reason stop_reason;
5323 CORE_ADDR watch_data_address;
5328 DECLARE_QUEUE_P (stop_reply_p);
5329 DEFINE_QUEUE_P (stop_reply_p);
5330 /* The list of already fetched and acknowledged stop events. This
5331 queue is used for notification Stop, and other notifications
5332 don't need queue for their events, because the notification events
5333 of Stop can't be consumed immediately, so that events should be
5334 queued first, and be consumed by remote_wait_{ns,as} one per
5335 time. Other notifications can consume their events immediately,
5336 so queue is not needed for them. */
5337 static QUEUE (stop_reply_p) *stop_reply_queue;
5340 stop_reply_xfree (struct stop_reply *r)
5342 notif_event_xfree ((struct notif_event *) r);
5346 remote_notif_stop_parse (struct notif_client *self, char *buf,
5347 struct notif_event *event)
5349 remote_parse_stop_reply (buf, (struct stop_reply *) event);
5353 remote_notif_stop_ack (struct notif_client *self, char *buf,
5354 struct notif_event *event)
5356 struct stop_reply *stop_reply = (struct stop_reply *) event;
5359 putpkt ((char *) self->ack_command);
5361 if (stop_reply->ws.kind == TARGET_WAITKIND_IGNORE)
5362 /* We got an unknown stop reply. */
5363 error (_("Unknown stop reply"));
5365 push_stop_reply (stop_reply);
5369 remote_notif_stop_can_get_pending_events (struct notif_client *self)
5371 /* We can't get pending events in remote_notif_process for
5372 notification stop, and we have to do this in remote_wait_ns
5373 instead. If we fetch all queued events from stub, remote stub
5374 may exit and we have no chance to process them back in
5376 mark_async_event_handler (remote_async_inferior_event_token);
5381 stop_reply_dtr (struct notif_event *event)
5383 struct stop_reply *r = (struct stop_reply *) event;
5385 VEC_free (cached_reg_t, r->regcache);
5388 static struct notif_event *
5389 remote_notif_stop_alloc_reply (void)
5391 struct notif_event *r
5392 = (struct notif_event *) XNEW (struct stop_reply);
5394 r->dtr = stop_reply_dtr;
5399 /* A client of notification Stop. */
5401 struct notif_client notif_client_stop =
5405 remote_notif_stop_parse,
5406 remote_notif_stop_ack,
5407 remote_notif_stop_can_get_pending_events,
5408 remote_notif_stop_alloc_reply,
5412 /* A parameter to pass data in and out. */
5414 struct queue_iter_param
5417 struct stop_reply *output;
5420 /* Remove stop replies in the queue if its pid is equal to the given
5424 remove_stop_reply_for_inferior (QUEUE (stop_reply_p) *q,
5425 QUEUE_ITER (stop_reply_p) *iter,
5429 struct queue_iter_param *param = data;
5430 struct inferior *inf = param->input;
5432 if (ptid_get_pid (event->ptid) == inf->pid)
5434 stop_reply_xfree (event);
5435 QUEUE_remove_elem (stop_reply_p, q, iter);
5441 /* Discard all pending stop replies of inferior INF. */
5444 discard_pending_stop_replies (struct inferior *inf)
5447 struct queue_iter_param param;
5448 struct stop_reply *reply;
5449 struct remote_state *rs = get_remote_state ();
5450 struct remote_notif_state *rns = rs->notif_state;
5452 /* This function can be notified when an inferior exists. When the
5453 target is not remote, the notification state is NULL. */
5454 if (rs->remote_desc == NULL)
5457 reply = (struct stop_reply *) rns->pending_event[notif_client_stop.id];
5459 /* Discard the in-flight notification. */
5460 if (reply != NULL && ptid_get_pid (reply->ptid) == inf->pid)
5462 stop_reply_xfree (reply);
5463 rns->pending_event[notif_client_stop.id] = NULL;
5467 param.output = NULL;
5468 /* Discard the stop replies we have already pulled with
5470 QUEUE_iterate (stop_reply_p, stop_reply_queue,
5471 remove_stop_reply_for_inferior, ¶m);
5474 /* If its remote state is equal to the given remote state,
5475 remove EVENT from the stop reply queue. */
5478 remove_stop_reply_of_remote_state (QUEUE (stop_reply_p) *q,
5479 QUEUE_ITER (stop_reply_p) *iter,
5483 struct queue_iter_param *param = data;
5484 struct remote_state *rs = param->input;
5486 if (event->rs == rs)
5488 stop_reply_xfree (event);
5489 QUEUE_remove_elem (stop_reply_p, q, iter);
5495 /* Discard the stop replies for RS in stop_reply_queue. */
5498 discard_pending_stop_replies_in_queue (struct remote_state *rs)
5500 struct queue_iter_param param;
5503 param.output = NULL;
5504 /* Discard the stop replies we have already pulled with
5506 QUEUE_iterate (stop_reply_p, stop_reply_queue,
5507 remove_stop_reply_of_remote_state, ¶m);
5510 /* A parameter to pass data in and out. */
5513 remote_notif_remove_once_on_match (QUEUE (stop_reply_p) *q,
5514 QUEUE_ITER (stop_reply_p) *iter,
5518 struct queue_iter_param *param = data;
5519 ptid_t *ptid = param->input;
5521 if (ptid_match (event->ptid, *ptid))
5523 param->output = event;
5524 QUEUE_remove_elem (stop_reply_p, q, iter);
5531 /* Remove the first reply in 'stop_reply_queue' which matches
5534 static struct stop_reply *
5535 remote_notif_remove_queued_reply (ptid_t ptid)
5537 struct queue_iter_param param;
5539 param.input = &ptid;
5540 param.output = NULL;
5542 QUEUE_iterate (stop_reply_p, stop_reply_queue,
5543 remote_notif_remove_once_on_match, ¶m);
5545 fprintf_unfiltered (gdb_stdlog,
5546 "notif: discard queued event: 'Stop' in %s\n",
5547 target_pid_to_str (ptid));
5549 return param.output;
5552 /* Look for a queued stop reply belonging to PTID. If one is found,
5553 remove it from the queue, and return it. Returns NULL if none is
5554 found. If there are still queued events left to process, tell the
5555 event loop to get back to target_wait soon. */
5557 static struct stop_reply *
5558 queued_stop_reply (ptid_t ptid)
5560 struct stop_reply *r = remote_notif_remove_queued_reply (ptid);
5562 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
5563 /* There's still at least an event left. */
5564 mark_async_event_handler (remote_async_inferior_event_token);
5569 /* Push a fully parsed stop reply in the stop reply queue. Since we
5570 know that we now have at least one queued event left to pass to the
5571 core side, tell the event loop to get back to target_wait soon. */
5574 push_stop_reply (struct stop_reply *new_event)
5576 QUEUE_enque (stop_reply_p, stop_reply_queue, new_event);
5579 fprintf_unfiltered (gdb_stdlog,
5580 "notif: push 'Stop' %s to queue %d\n",
5581 target_pid_to_str (new_event->ptid),
5582 QUEUE_length (stop_reply_p,
5585 mark_async_event_handler (remote_async_inferior_event_token);
5589 stop_reply_match_ptid_and_ws (QUEUE (stop_reply_p) *q,
5590 QUEUE_ITER (stop_reply_p) *iter,
5591 struct stop_reply *event,
5594 ptid_t *ptid = data;
5596 return !(ptid_equal (*ptid, event->ptid)
5597 && event->ws.kind == TARGET_WAITKIND_STOPPED);
5600 /* Returns true if we have a stop reply for PTID. */
5603 peek_stop_reply (ptid_t ptid)
5605 return !QUEUE_iterate (stop_reply_p, stop_reply_queue,
5606 stop_reply_match_ptid_and_ws, &ptid);
5609 /* Skip PACKET until the next semi-colon (or end of string). */
5612 skip_to_semicolon (char *p)
5614 while (*p != '\0' && *p != ';')
5619 /* Parse the stop reply in BUF. Either the function succeeds, and the
5620 result is stored in EVENT, or throws an error. */
5623 remote_parse_stop_reply (char *buf, struct stop_reply *event)
5625 struct remote_arch_state *rsa = get_remote_arch_state ();
5629 event->ptid = null_ptid;
5630 event->rs = get_remote_state ();
5631 event->ws.kind = TARGET_WAITKIND_IGNORE;
5632 event->ws.value.integer = 0;
5633 event->stop_reason = TARGET_STOPPED_BY_NO_REASON;
5634 event->regcache = NULL;
5639 case 'T': /* Status with PC, SP, FP, ... */
5640 /* Expedited reply, containing Signal, {regno, reg} repeat. */
5641 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
5643 n... = register number
5644 r... = register contents
5647 p = &buf[3]; /* after Txx */
5653 p1 = strchr (p, ':');
5655 error (_("Malformed packet(a) (missing colon): %s\n\
5659 error (_("Malformed packet(a) (missing register number): %s\n\
5663 /* Some "registers" are actually extended stop information.
5664 Note if you're adding a new entry here: GDB 7.9 and
5665 earlier assume that all register "numbers" that start
5666 with an hex digit are real register numbers. Make sure
5667 the server only sends such a packet if it knows the
5668 client understands it. */
5670 if (strncmp (p, "thread", p1 - p) == 0)
5671 event->ptid = read_ptid (++p1, &p);
5672 else if ((strncmp (p, "watch", p1 - p) == 0)
5673 || (strncmp (p, "rwatch", p1 - p) == 0)
5674 || (strncmp (p, "awatch", p1 - p) == 0))
5676 event->stop_reason = TARGET_STOPPED_BY_WATCHPOINT;
5677 p = unpack_varlen_hex (++p1, &addr);
5678 event->watch_data_address = (CORE_ADDR) addr;
5680 else if (strncmp (p, "swbreak", p1 - p) == 0)
5682 event->stop_reason = TARGET_STOPPED_BY_SW_BREAKPOINT;
5684 /* Make sure the stub doesn't forget to indicate support
5686 if (packet_support (PACKET_swbreak_feature) != PACKET_ENABLE)
5687 error (_("Unexpected swbreak stop reason"));
5689 /* The value part is documented as "must be empty",
5690 though we ignore it, in case we ever decide to make
5691 use of it in a backward compatible way. */
5692 p = skip_to_semicolon (p1 + 1);
5694 else if (strncmp (p, "hwbreak", p1 - p) == 0)
5696 event->stop_reason = TARGET_STOPPED_BY_HW_BREAKPOINT;
5698 /* Make sure the stub doesn't forget to indicate support
5700 if (packet_support (PACKET_hwbreak_feature) != PACKET_ENABLE)
5701 error (_("Unexpected hwbreak stop reason"));
5704 p = skip_to_semicolon (p1 + 1);
5706 else if (strncmp (p, "library", p1 - p) == 0)
5708 event->ws.kind = TARGET_WAITKIND_LOADED;
5709 p = skip_to_semicolon (p1 + 1);
5711 else if (strncmp (p, "replaylog", p1 - p) == 0)
5713 event->ws.kind = TARGET_WAITKIND_NO_HISTORY;
5714 /* p1 will indicate "begin" or "end", but it makes
5715 no difference for now, so ignore it. */
5716 p = skip_to_semicolon (p1 + 1);
5718 else if (strncmp (p, "core", p1 - p) == 0)
5722 p = unpack_varlen_hex (++p1, &c);
5725 else if (strncmp (p, "fork", p1 - p) == 0)
5727 event->ws.value.related_pid = read_ptid (++p1, &p);
5728 event->ws.kind = TARGET_WAITKIND_FORKED;
5735 /* Maybe a real ``P'' register number. */
5736 p_temp = unpack_varlen_hex (p, &pnum);
5737 /* If the first invalid character is the colon, we got a
5738 register number. Otherwise, it's an unknown stop
5742 struct packet_reg *reg = packet_reg_from_pnum (rsa, pnum);
5743 cached_reg_t cached_reg;
5746 error (_("Remote sent bad register number %s: %s\n\
5748 hex_string (pnum), p, buf);
5750 cached_reg.num = reg->regnum;
5753 fieldsize = hex2bin (p, cached_reg.data,
5754 register_size (target_gdbarch (),
5757 if (fieldsize < register_size (target_gdbarch (),
5759 warning (_("Remote reply is too short: %s"), buf);
5761 VEC_safe_push (cached_reg_t, event->regcache, &cached_reg);
5765 /* Not a number. Silently skip unknown optional
5767 p = skip_to_semicolon (p1 + 1);
5772 error (_("Remote register badly formatted: %s\nhere: %s"),
5777 if (event->ws.kind != TARGET_WAITKIND_IGNORE)
5781 case 'S': /* Old style status, just signal only. */
5785 event->ws.kind = TARGET_WAITKIND_STOPPED;
5786 sig = (fromhex (buf[1]) << 4) + fromhex (buf[2]);
5787 if (GDB_SIGNAL_FIRST <= sig && sig < GDB_SIGNAL_LAST)
5788 event->ws.value.sig = (enum gdb_signal) sig;
5790 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
5793 case 'W': /* Target exited. */
5800 /* GDB used to accept only 2 hex chars here. Stubs should
5801 only send more if they detect GDB supports multi-process
5803 p = unpack_varlen_hex (&buf[1], &value);
5807 /* The remote process exited. */
5808 event->ws.kind = TARGET_WAITKIND_EXITED;
5809 event->ws.value.integer = value;
5813 /* The remote process exited with a signal. */
5814 event->ws.kind = TARGET_WAITKIND_SIGNALLED;
5815 if (GDB_SIGNAL_FIRST <= value && value < GDB_SIGNAL_LAST)
5816 event->ws.value.sig = (enum gdb_signal) value;
5818 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
5821 /* If no process is specified, assume inferior_ptid. */
5822 pid = ptid_get_pid (inferior_ptid);
5831 else if (startswith (p, "process:"))
5835 p += sizeof ("process:") - 1;
5836 unpack_varlen_hex (p, &upid);
5840 error (_("unknown stop reply packet: %s"), buf);
5843 error (_("unknown stop reply packet: %s"), buf);
5844 event->ptid = pid_to_ptid (pid);
5849 if (non_stop && ptid_equal (event->ptid, null_ptid))
5850 error (_("No process or thread specified in stop reply: %s"), buf);
5853 /* When the stub wants to tell GDB about a new notification reply, it
5854 sends a notification (%Stop, for example). Those can come it at
5855 any time, hence, we have to make sure that any pending
5856 putpkt/getpkt sequence we're making is finished, before querying
5857 the stub for more events with the corresponding ack command
5858 (vStopped, for example). E.g., if we started a vStopped sequence
5859 immediately upon receiving the notification, something like this
5867 1.6) <-- (registers reply to step #1.3)
5869 Obviously, the reply in step #1.6 would be unexpected to a vStopped
5872 To solve this, whenever we parse a %Stop notification successfully,
5873 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
5874 doing whatever we were doing:
5880 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
5881 2.5) <-- (registers reply to step #2.3)
5883 Eventualy after step #2.5, we return to the event loop, which
5884 notices there's an event on the
5885 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
5886 associated callback --- the function below. At this point, we're
5887 always safe to start a vStopped sequence. :
5890 2.7) <-- T05 thread:2
5896 remote_notif_get_pending_events (struct notif_client *nc)
5898 struct remote_state *rs = get_remote_state ();
5900 if (rs->notif_state->pending_event[nc->id] != NULL)
5903 fprintf_unfiltered (gdb_stdlog,
5904 "notif: process: '%s' ack pending event\n",
5908 nc->ack (nc, rs->buf, rs->notif_state->pending_event[nc->id]);
5909 rs->notif_state->pending_event[nc->id] = NULL;
5913 getpkt (&rs->buf, &rs->buf_size, 0);
5914 if (strcmp (rs->buf, "OK") == 0)
5917 remote_notif_ack (nc, rs->buf);
5923 fprintf_unfiltered (gdb_stdlog,
5924 "notif: process: '%s' no pending reply\n",
5929 /* Called when it is decided that STOP_REPLY holds the info of the
5930 event that is to be returned to the core. This function always
5931 destroys STOP_REPLY. */
5934 process_stop_reply (struct stop_reply *stop_reply,
5935 struct target_waitstatus *status)
5939 *status = stop_reply->ws;
5940 ptid = stop_reply->ptid;
5942 /* If no thread/process was reported by the stub, assume the current
5944 if (ptid_equal (ptid, null_ptid))
5945 ptid = inferior_ptid;
5947 if (status->kind != TARGET_WAITKIND_EXITED
5948 && status->kind != TARGET_WAITKIND_SIGNALLED)
5950 struct remote_state *rs = get_remote_state ();
5952 /* Expedited registers. */
5953 if (stop_reply->regcache)
5955 struct regcache *regcache
5956 = get_thread_arch_regcache (ptid, target_gdbarch ());
5961 VEC_iterate(cached_reg_t, stop_reply->regcache, ix, reg);
5963 regcache_raw_supply (regcache, reg->num, reg->data);
5964 VEC_free (cached_reg_t, stop_reply->regcache);
5967 rs->stop_reason = stop_reply->stop_reason;
5968 rs->remote_watch_data_address = stop_reply->watch_data_address;
5970 remote_notice_new_inferior (ptid, 0);
5971 demand_private_info (ptid)->core = stop_reply->core;
5974 stop_reply_xfree (stop_reply);
5978 /* The non-stop mode version of target_wait. */
5981 remote_wait_ns (ptid_t ptid, struct target_waitstatus *status, int options)
5983 struct remote_state *rs = get_remote_state ();
5984 struct stop_reply *stop_reply;
5988 /* If in non-stop mode, get out of getpkt even if a
5989 notification is received. */
5991 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
5992 0 /* forever */, &is_notif);
5995 if (ret != -1 && !is_notif)
5998 case 'E': /* Error of some sort. */
5999 /* We're out of sync with the target now. Did it continue
6000 or not? We can't tell which thread it was in non-stop,
6001 so just ignore this. */
6002 warning (_("Remote failure reply: %s"), rs->buf);
6004 case 'O': /* Console output. */
6005 remote_console_output (rs->buf + 1);
6008 warning (_("Invalid remote reply: %s"), rs->buf);
6012 /* Acknowledge a pending stop reply that may have arrived in the
6014 if (rs->notif_state->pending_event[notif_client_stop.id] != NULL)
6015 remote_notif_get_pending_events (¬if_client_stop);
6017 /* If indeed we noticed a stop reply, we're done. */
6018 stop_reply = queued_stop_reply (ptid);
6019 if (stop_reply != NULL)
6020 return process_stop_reply (stop_reply, status);
6022 /* Still no event. If we're just polling for an event, then
6023 return to the event loop. */
6024 if (options & TARGET_WNOHANG)
6026 status->kind = TARGET_WAITKIND_IGNORE;
6027 return minus_one_ptid;
6030 /* Otherwise do a blocking wait. */
6031 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
6032 1 /* forever */, &is_notif);
6036 /* Wait until the remote machine stops, then return, storing status in
6037 STATUS just as `wait' would. */
6040 remote_wait_as (ptid_t ptid, struct target_waitstatus *status, int options)
6042 struct remote_state *rs = get_remote_state ();
6043 ptid_t event_ptid = null_ptid;
6045 struct stop_reply *stop_reply;
6049 status->kind = TARGET_WAITKIND_IGNORE;
6050 status->value.integer = 0;
6052 stop_reply = queued_stop_reply (ptid);
6053 if (stop_reply != NULL)
6054 return process_stop_reply (stop_reply, status);
6056 if (rs->cached_wait_status)
6057 /* Use the cached wait status, but only once. */
6058 rs->cached_wait_status = 0;
6064 if (!target_is_async_p ())
6066 ofunc = signal (SIGINT, sync_remote_interrupt);
6067 /* If the user hit C-c before this packet, or between packets,
6068 pretend that it was hit right here. */
6069 if (check_quit_flag ())
6072 sync_remote_interrupt (SIGINT);
6076 /* FIXME: cagney/1999-09-27: If we're in async mode we should
6077 _never_ wait for ever -> test on target_is_async_p().
6078 However, before we do that we need to ensure that the caller
6079 knows how to take the target into/out of async mode. */
6080 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
6081 wait_forever_enabled_p, &is_notif);
6083 if (!target_is_async_p ())
6084 signal (SIGINT, ofunc);
6086 /* GDB gets a notification. Return to core as this event is
6088 if (ret != -1 && is_notif)
6089 return minus_one_ptid;
6094 rs->stop_reason = TARGET_STOPPED_BY_NO_REASON;
6096 /* We got something. */
6097 rs->waiting_for_stop_reply = 0;
6099 /* Assume that the target has acknowledged Ctrl-C unless we receive
6100 an 'F' or 'O' packet. */
6101 if (buf[0] != 'F' && buf[0] != 'O')
6102 rs->ctrlc_pending_p = 0;
6106 case 'E': /* Error of some sort. */
6107 /* We're out of sync with the target now. Did it continue or
6108 not? Not is more likely, so report a stop. */
6109 warning (_("Remote failure reply: %s"), buf);
6110 status->kind = TARGET_WAITKIND_STOPPED;
6111 status->value.sig = GDB_SIGNAL_0;
6113 case 'F': /* File-I/O request. */
6114 remote_fileio_request (buf, rs->ctrlc_pending_p);
6115 rs->ctrlc_pending_p = 0;
6117 case 'T': case 'S': case 'X': case 'W':
6119 struct stop_reply *stop_reply
6120 = (struct stop_reply *) remote_notif_parse (¬if_client_stop,
6123 event_ptid = process_stop_reply (stop_reply, status);
6126 case 'O': /* Console output. */
6127 remote_console_output (buf + 1);
6129 /* The target didn't really stop; keep waiting. */
6130 rs->waiting_for_stop_reply = 1;
6134 if (rs->last_sent_signal != GDB_SIGNAL_0)
6136 /* Zero length reply means that we tried 'S' or 'C' and the
6137 remote system doesn't support it. */
6138 target_terminal_ours_for_output ();
6140 ("Can't send signals to this remote system. %s not sent.\n",
6141 gdb_signal_to_name (rs->last_sent_signal));
6142 rs->last_sent_signal = GDB_SIGNAL_0;
6143 target_terminal_inferior ();
6145 strcpy ((char *) buf, rs->last_sent_step ? "s" : "c");
6146 putpkt ((char *) buf);
6148 /* We just told the target to resume, so a stop reply is in
6150 rs->waiting_for_stop_reply = 1;
6153 /* else fallthrough */
6155 warning (_("Invalid remote reply: %s"), buf);
6157 rs->waiting_for_stop_reply = 1;
6161 if (status->kind == TARGET_WAITKIND_IGNORE)
6163 /* Nothing interesting happened. If we're doing a non-blocking
6164 poll, we're done. Otherwise, go back to waiting. */
6165 if (options & TARGET_WNOHANG)
6166 return minus_one_ptid;
6170 else if (status->kind != TARGET_WAITKIND_EXITED
6171 && status->kind != TARGET_WAITKIND_SIGNALLED)
6173 if (!ptid_equal (event_ptid, null_ptid))
6174 record_currthread (rs, event_ptid);
6176 event_ptid = inferior_ptid;
6179 /* A process exit. Invalidate our notion of current thread. */
6180 record_currthread (rs, minus_one_ptid);
6185 /* Wait until the remote machine stops, then return, storing status in
6186 STATUS just as `wait' would. */
6189 remote_wait (struct target_ops *ops,
6190 ptid_t ptid, struct target_waitstatus *status, int options)
6195 event_ptid = remote_wait_ns (ptid, status, options);
6197 event_ptid = remote_wait_as (ptid, status, options);
6199 if (target_is_async_p ())
6201 /* If there are are events left in the queue tell the event loop
6203 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
6204 mark_async_event_handler (remote_async_inferior_event_token);
6210 /* Fetch a single register using a 'p' packet. */
6213 fetch_register_using_p (struct regcache *regcache, struct packet_reg *reg)
6215 struct remote_state *rs = get_remote_state ();
6217 char regp[MAX_REGISTER_SIZE];
6220 if (packet_support (PACKET_p) == PACKET_DISABLE)
6223 if (reg->pnum == -1)
6228 p += hexnumstr (p, reg->pnum);
6231 getpkt (&rs->buf, &rs->buf_size, 0);
6235 switch (packet_ok (buf, &remote_protocol_packets[PACKET_p]))
6239 case PACKET_UNKNOWN:
6242 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
6243 gdbarch_register_name (get_regcache_arch (regcache),
6248 /* If this register is unfetchable, tell the regcache. */
6251 regcache_raw_supply (regcache, reg->regnum, NULL);
6255 /* Otherwise, parse and supply the value. */
6261 error (_("fetch_register_using_p: early buf termination"));
6263 regp[i++] = fromhex (p[0]) * 16 + fromhex (p[1]);
6266 regcache_raw_supply (regcache, reg->regnum, regp);
6270 /* Fetch the registers included in the target's 'g' packet. */
6273 send_g_packet (void)
6275 struct remote_state *rs = get_remote_state ();
6278 xsnprintf (rs->buf, get_remote_packet_size (), "g");
6279 remote_send (&rs->buf, &rs->buf_size);
6281 /* We can get out of synch in various cases. If the first character
6282 in the buffer is not a hex character, assume that has happened
6283 and try to fetch another packet to read. */
6284 while ((rs->buf[0] < '0' || rs->buf[0] > '9')
6285 && (rs->buf[0] < 'A' || rs->buf[0] > 'F')
6286 && (rs->buf[0] < 'a' || rs->buf[0] > 'f')
6287 && rs->buf[0] != 'x') /* New: unavailable register value. */
6290 fprintf_unfiltered (gdb_stdlog,
6291 "Bad register packet; fetching a new packet\n");
6292 getpkt (&rs->buf, &rs->buf_size, 0);
6295 buf_len = strlen (rs->buf);
6297 /* Sanity check the received packet. */
6298 if (buf_len % 2 != 0)
6299 error (_("Remote 'g' packet reply is of odd length: %s"), rs->buf);
6305 process_g_packet (struct regcache *regcache)
6307 struct gdbarch *gdbarch = get_regcache_arch (regcache);
6308 struct remote_state *rs = get_remote_state ();
6309 struct remote_arch_state *rsa = get_remote_arch_state ();
6314 buf_len = strlen (rs->buf);
6316 /* Further sanity checks, with knowledge of the architecture. */
6317 if (buf_len > 2 * rsa->sizeof_g_packet)
6318 error (_("Remote 'g' packet reply is too long: %s"), rs->buf);
6320 /* Save the size of the packet sent to us by the target. It is used
6321 as a heuristic when determining the max size of packets that the
6322 target can safely receive. */
6323 if (rsa->actual_register_packet_size == 0)
6324 rsa->actual_register_packet_size = buf_len;
6326 /* If this is smaller than we guessed the 'g' packet would be,
6327 update our records. A 'g' reply that doesn't include a register's
6328 value implies either that the register is not available, or that
6329 the 'p' packet must be used. */
6330 if (buf_len < 2 * rsa->sizeof_g_packet)
6332 rsa->sizeof_g_packet = buf_len / 2;
6334 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
6336 if (rsa->regs[i].pnum == -1)
6339 if (rsa->regs[i].offset >= rsa->sizeof_g_packet)
6340 rsa->regs[i].in_g_packet = 0;
6342 rsa->regs[i].in_g_packet = 1;
6346 regs = alloca (rsa->sizeof_g_packet);
6348 /* Unimplemented registers read as all bits zero. */
6349 memset (regs, 0, rsa->sizeof_g_packet);
6351 /* Reply describes registers byte by byte, each byte encoded as two
6352 hex characters. Suck them all up, then supply them to the
6353 register cacheing/storage mechanism. */
6356 for (i = 0; i < rsa->sizeof_g_packet; i++)
6358 if (p[0] == 0 || p[1] == 0)
6359 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
6360 internal_error (__FILE__, __LINE__,
6361 _("unexpected end of 'g' packet reply"));
6363 if (p[0] == 'x' && p[1] == 'x')
6364 regs[i] = 0; /* 'x' */
6366 regs[i] = fromhex (p[0]) * 16 + fromhex (p[1]);
6370 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
6372 struct packet_reg *r = &rsa->regs[i];
6376 if (r->offset * 2 >= strlen (rs->buf))
6377 /* This shouldn't happen - we adjusted in_g_packet above. */
6378 internal_error (__FILE__, __LINE__,
6379 _("unexpected end of 'g' packet reply"));
6380 else if (rs->buf[r->offset * 2] == 'x')
6382 gdb_assert (r->offset * 2 < strlen (rs->buf));
6383 /* The register isn't available, mark it as such (at
6384 the same time setting the value to zero). */
6385 regcache_raw_supply (regcache, r->regnum, NULL);
6388 regcache_raw_supply (regcache, r->regnum,
6395 fetch_registers_using_g (struct regcache *regcache)
6398 process_g_packet (regcache);
6401 /* Make the remote selected traceframe match GDB's selected
6405 set_remote_traceframe (void)
6408 struct remote_state *rs = get_remote_state ();
6410 if (rs->remote_traceframe_number == get_traceframe_number ())
6413 /* Avoid recursion, remote_trace_find calls us again. */
6414 rs->remote_traceframe_number = get_traceframe_number ();
6416 newnum = target_trace_find (tfind_number,
6417 get_traceframe_number (), 0, 0, NULL);
6419 /* Should not happen. If it does, all bets are off. */
6420 if (newnum != get_traceframe_number ())
6421 warning (_("could not set remote traceframe"));
6425 remote_fetch_registers (struct target_ops *ops,
6426 struct regcache *regcache, int regnum)
6428 struct remote_arch_state *rsa = get_remote_arch_state ();
6431 set_remote_traceframe ();
6432 set_general_thread (inferior_ptid);
6436 struct packet_reg *reg = packet_reg_from_regnum (rsa, regnum);
6438 gdb_assert (reg != NULL);
6440 /* If this register might be in the 'g' packet, try that first -
6441 we are likely to read more than one register. If this is the
6442 first 'g' packet, we might be overly optimistic about its
6443 contents, so fall back to 'p'. */
6444 if (reg->in_g_packet)
6446 fetch_registers_using_g (regcache);
6447 if (reg->in_g_packet)
6451 if (fetch_register_using_p (regcache, reg))
6454 /* This register is not available. */
6455 regcache_raw_supply (regcache, reg->regnum, NULL);
6460 fetch_registers_using_g (regcache);
6462 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
6463 if (!rsa->regs[i].in_g_packet)
6464 if (!fetch_register_using_p (regcache, &rsa->regs[i]))
6466 /* This register is not available. */
6467 regcache_raw_supply (regcache, i, NULL);
6471 /* Prepare to store registers. Since we may send them all (using a
6472 'G' request), we have to read out the ones we don't want to change
6476 remote_prepare_to_store (struct target_ops *self, struct regcache *regcache)
6478 struct remote_arch_state *rsa = get_remote_arch_state ();
6480 gdb_byte buf[MAX_REGISTER_SIZE];
6482 /* Make sure the entire registers array is valid. */
6483 switch (packet_support (PACKET_P))
6485 case PACKET_DISABLE:
6486 case PACKET_SUPPORT_UNKNOWN:
6487 /* Make sure all the necessary registers are cached. */
6488 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
6489 if (rsa->regs[i].in_g_packet)
6490 regcache_raw_read (regcache, rsa->regs[i].regnum, buf);
6497 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
6498 packet was not recognized. */
6501 store_register_using_P (const struct regcache *regcache,
6502 struct packet_reg *reg)
6504 struct gdbarch *gdbarch = get_regcache_arch (regcache);
6505 struct remote_state *rs = get_remote_state ();
6506 /* Try storing a single register. */
6507 char *buf = rs->buf;
6508 gdb_byte regp[MAX_REGISTER_SIZE];
6511 if (packet_support (PACKET_P) == PACKET_DISABLE)
6514 if (reg->pnum == -1)
6517 xsnprintf (buf, get_remote_packet_size (), "P%s=", phex_nz (reg->pnum, 0));
6518 p = buf + strlen (buf);
6519 regcache_raw_collect (regcache, reg->regnum, regp);
6520 bin2hex (regp, p, register_size (gdbarch, reg->regnum));
6522 getpkt (&rs->buf, &rs->buf_size, 0);
6524 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_P]))
6529 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
6530 gdbarch_register_name (gdbarch, reg->regnum), rs->buf);
6531 case PACKET_UNKNOWN:
6534 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
6538 /* Store register REGNUM, or all registers if REGNUM == -1, from the
6539 contents of the register cache buffer. FIXME: ignores errors. */
6542 store_registers_using_G (const struct regcache *regcache)
6544 struct remote_state *rs = get_remote_state ();
6545 struct remote_arch_state *rsa = get_remote_arch_state ();
6549 /* Extract all the registers in the regcache copying them into a
6554 regs = alloca (rsa->sizeof_g_packet);
6555 memset (regs, 0, rsa->sizeof_g_packet);
6556 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
6558 struct packet_reg *r = &rsa->regs[i];
6561 regcache_raw_collect (regcache, r->regnum, regs + r->offset);
6565 /* Command describes registers byte by byte,
6566 each byte encoded as two hex characters. */
6569 /* remote_prepare_to_store insures that rsa->sizeof_g_packet gets
6571 bin2hex (regs, p, rsa->sizeof_g_packet);
6573 getpkt (&rs->buf, &rs->buf_size, 0);
6574 if (packet_check_result (rs->buf) == PACKET_ERROR)
6575 error (_("Could not write registers; remote failure reply '%s'"),
6579 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
6580 of the register cache buffer. FIXME: ignores errors. */
6583 remote_store_registers (struct target_ops *ops,
6584 struct regcache *regcache, int regnum)
6586 struct remote_arch_state *rsa = get_remote_arch_state ();
6589 set_remote_traceframe ();
6590 set_general_thread (inferior_ptid);
6594 struct packet_reg *reg = packet_reg_from_regnum (rsa, regnum);
6596 gdb_assert (reg != NULL);
6598 /* Always prefer to store registers using the 'P' packet if
6599 possible; we often change only a small number of registers.
6600 Sometimes we change a larger number; we'd need help from a
6601 higher layer to know to use 'G'. */
6602 if (store_register_using_P (regcache, reg))
6605 /* For now, don't complain if we have no way to write the
6606 register. GDB loses track of unavailable registers too
6607 easily. Some day, this may be an error. We don't have
6608 any way to read the register, either... */
6609 if (!reg->in_g_packet)
6612 store_registers_using_G (regcache);
6616 store_registers_using_G (regcache);
6618 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
6619 if (!rsa->regs[i].in_g_packet)
6620 if (!store_register_using_P (regcache, &rsa->regs[i]))
6621 /* See above for why we do not issue an error here. */
6626 /* Return the number of hex digits in num. */
6629 hexnumlen (ULONGEST num)
6633 for (i = 0; num != 0; i++)
6639 /* Set BUF to the minimum number of hex digits representing NUM. */
6642 hexnumstr (char *buf, ULONGEST num)
6644 int len = hexnumlen (num);
6646 return hexnumnstr (buf, num, len);
6650 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
6653 hexnumnstr (char *buf, ULONGEST num, int width)
6659 for (i = width - 1; i >= 0; i--)
6661 buf[i] = "0123456789abcdef"[(num & 0xf)];
6668 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
6671 remote_address_masked (CORE_ADDR addr)
6673 unsigned int address_size = remote_address_size;
6675 /* If "remoteaddresssize" was not set, default to target address size. */
6677 address_size = gdbarch_addr_bit (target_gdbarch ());
6679 if (address_size > 0
6680 && address_size < (sizeof (ULONGEST) * 8))
6682 /* Only create a mask when that mask can safely be constructed
6683 in a ULONGEST variable. */
6686 mask = (mask << address_size) - 1;
6692 /* Determine whether the remote target supports binary downloading.
6693 This is accomplished by sending a no-op memory write of zero length
6694 to the target at the specified address. It does not suffice to send
6695 the whole packet, since many stubs strip the eighth bit and
6696 subsequently compute a wrong checksum, which causes real havoc with
6699 NOTE: This can still lose if the serial line is not eight-bit
6700 clean. In cases like this, the user should clear "remote
6704 check_binary_download (CORE_ADDR addr)
6706 struct remote_state *rs = get_remote_state ();
6708 switch (packet_support (PACKET_X))
6710 case PACKET_DISABLE:
6714 case PACKET_SUPPORT_UNKNOWN:
6720 p += hexnumstr (p, (ULONGEST) addr);
6722 p += hexnumstr (p, (ULONGEST) 0);
6726 putpkt_binary (rs->buf, (int) (p - rs->buf));
6727 getpkt (&rs->buf, &rs->buf_size, 0);
6729 if (rs->buf[0] == '\0')
6732 fprintf_unfiltered (gdb_stdlog,
6733 "binary downloading NOT "
6734 "supported by target\n");
6735 remote_protocol_packets[PACKET_X].support = PACKET_DISABLE;
6740 fprintf_unfiltered (gdb_stdlog,
6741 "binary downloading supported by target\n");
6742 remote_protocol_packets[PACKET_X].support = PACKET_ENABLE;
6749 /* Write memory data directly to the remote machine.
6750 This does not inform the data cache; the data cache uses this.
6751 HEADER is the starting part of the packet.
6752 MEMADDR is the address in the remote memory space.
6753 MYADDR is the address of the buffer in our space.
6754 LEN is the number of bytes.
6755 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
6756 should send data as binary ('X'), or hex-encoded ('M').
6758 The function creates packet of the form
6759 <HEADER><ADDRESS>,<LENGTH>:<DATA>
6761 where encoding of <DATA> is termined by PACKET_FORMAT.
6763 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
6766 Return the transferred status, error or OK (an
6767 'enum target_xfer_status' value). Save the number of bytes
6768 transferred in *XFERED_LEN. Only transfer a single packet. */
6770 static enum target_xfer_status
6771 remote_write_bytes_aux (const char *header, CORE_ADDR memaddr,
6772 const gdb_byte *myaddr, ULONGEST len,
6773 ULONGEST *xfered_len, char packet_format,
6776 struct remote_state *rs = get_remote_state ();
6786 if (packet_format != 'X' && packet_format != 'M')
6787 internal_error (__FILE__, __LINE__,
6788 _("remote_write_bytes_aux: bad packet format"));
6791 return TARGET_XFER_EOF;
6793 payload_size = get_memory_write_packet_size ();
6795 /* The packet buffer will be large enough for the payload;
6796 get_memory_packet_size ensures this. */
6799 /* Compute the size of the actual payload by subtracting out the
6800 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
6802 payload_size -= strlen ("$,:#NN");
6804 /* The comma won't be used. */
6806 header_length = strlen (header);
6807 payload_size -= header_length;
6808 payload_size -= hexnumlen (memaddr);
6810 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
6812 strcat (rs->buf, header);
6813 p = rs->buf + strlen (header);
6815 /* Compute a best guess of the number of bytes actually transfered. */
6816 if (packet_format == 'X')
6818 /* Best guess at number of bytes that will fit. */
6819 todo = min (len, payload_size);
6821 payload_size -= hexnumlen (todo);
6822 todo = min (todo, payload_size);
6826 /* Num bytes that will fit. */
6827 todo = min (len, payload_size / 2);
6829 payload_size -= hexnumlen (todo);
6830 todo = min (todo, payload_size / 2);
6834 internal_error (__FILE__, __LINE__,
6835 _("minimum packet size too small to write data"));
6837 /* If we already need another packet, then try to align the end
6838 of this packet to a useful boundary. */
6839 if (todo > 2 * REMOTE_ALIGN_WRITES && todo < len)
6840 todo = ((memaddr + todo) & ~(REMOTE_ALIGN_WRITES - 1)) - memaddr;
6842 /* Append "<memaddr>". */
6843 memaddr = remote_address_masked (memaddr);
6844 p += hexnumstr (p, (ULONGEST) memaddr);
6851 /* Append <len>. Retain the location/size of <len>. It may need to
6852 be adjusted once the packet body has been created. */
6854 plenlen = hexnumstr (p, (ULONGEST) todo);
6862 /* Append the packet body. */
6863 if (packet_format == 'X')
6865 /* Binary mode. Send target system values byte by byte, in
6866 increasing byte addresses. Only escape certain critical
6868 payload_length = remote_escape_output (myaddr, todo, (gdb_byte *) p,
6869 &nr_bytes, payload_size);
6871 /* If not all TODO bytes fit, then we'll need another packet. Make
6872 a second try to keep the end of the packet aligned. Don't do
6873 this if the packet is tiny. */
6874 if (nr_bytes < todo && nr_bytes > 2 * REMOTE_ALIGN_WRITES)
6878 new_nr_bytes = (((memaddr + nr_bytes) & ~(REMOTE_ALIGN_WRITES - 1))
6880 if (new_nr_bytes != nr_bytes)
6881 payload_length = remote_escape_output (myaddr, new_nr_bytes,
6882 (gdb_byte *) p, &nr_bytes,
6886 p += payload_length;
6887 if (use_length && nr_bytes < todo)
6889 /* Escape chars have filled up the buffer prematurely,
6890 and we have actually sent fewer bytes than planned.
6891 Fix-up the length field of the packet. Use the same
6892 number of characters as before. */
6893 plen += hexnumnstr (plen, (ULONGEST) nr_bytes, plenlen);
6894 *plen = ':'; /* overwrite \0 from hexnumnstr() */
6899 /* Normal mode: Send target system values byte by byte, in
6900 increasing byte addresses. Each byte is encoded as a two hex
6902 nr_bytes = bin2hex (myaddr, p, todo);
6906 putpkt_binary (rs->buf, (int) (p - rs->buf));
6907 getpkt (&rs->buf, &rs->buf_size, 0);
6909 if (rs->buf[0] == 'E')
6910 return TARGET_XFER_E_IO;
6912 /* Return NR_BYTES, not TODO, in case escape chars caused us to send
6913 fewer bytes than we'd planned. */
6914 *xfered_len = (ULONGEST) nr_bytes;
6915 return TARGET_XFER_OK;
6918 /* Write memory data directly to the remote machine.
6919 This does not inform the data cache; the data cache uses this.
6920 MEMADDR is the address in the remote memory space.
6921 MYADDR is the address of the buffer in our space.
6922 LEN is the number of bytes.
6924 Return the transferred status, error or OK (an
6925 'enum target_xfer_status' value). Save the number of bytes
6926 transferred in *XFERED_LEN. Only transfer a single packet. */
6928 static enum target_xfer_status
6929 remote_write_bytes (CORE_ADDR memaddr, const gdb_byte *myaddr, ULONGEST len,
6930 ULONGEST *xfered_len)
6932 char *packet_format = 0;
6934 /* Check whether the target supports binary download. */
6935 check_binary_download (memaddr);
6937 switch (packet_support (PACKET_X))
6940 packet_format = "X";
6942 case PACKET_DISABLE:
6943 packet_format = "M";
6945 case PACKET_SUPPORT_UNKNOWN:
6946 internal_error (__FILE__, __LINE__,
6947 _("remote_write_bytes: bad internal state"));
6949 internal_error (__FILE__, __LINE__, _("bad switch"));
6952 return remote_write_bytes_aux (packet_format,
6953 memaddr, myaddr, len, xfered_len,
6954 packet_format[0], 1);
6957 /* Read memory data directly from the remote machine.
6958 This does not use the data cache; the data cache uses this.
6959 MEMADDR is the address in the remote memory space.
6960 MYADDR is the address of the buffer in our space.
6961 LEN is the number of bytes.
6963 Return the transferred status, error or OK (an
6964 'enum target_xfer_status' value). Save the number of bytes
6965 transferred in *XFERED_LEN. */
6967 static enum target_xfer_status
6968 remote_read_bytes_1 (CORE_ADDR memaddr, gdb_byte *myaddr, ULONGEST len,
6969 ULONGEST *xfered_len)
6971 struct remote_state *rs = get_remote_state ();
6972 int max_buf_size; /* Max size of packet output buffer. */
6977 max_buf_size = get_memory_read_packet_size ();
6978 /* The packet buffer will be large enough for the payload;
6979 get_memory_packet_size ensures this. */
6981 /* Number if bytes that will fit. */
6982 todo = min (len, max_buf_size / 2);
6984 /* Construct "m"<memaddr>","<len>". */
6985 memaddr = remote_address_masked (memaddr);
6988 p += hexnumstr (p, (ULONGEST) memaddr);
6990 p += hexnumstr (p, (ULONGEST) todo);
6993 getpkt (&rs->buf, &rs->buf_size, 0);
6994 if (rs->buf[0] == 'E'
6995 && isxdigit (rs->buf[1]) && isxdigit (rs->buf[2])
6996 && rs->buf[3] == '\0')
6997 return TARGET_XFER_E_IO;
6998 /* Reply describes memory byte by byte, each byte encoded as two hex
7001 i = hex2bin (p, myaddr, todo);
7002 /* Return what we have. Let higher layers handle partial reads. */
7003 *xfered_len = (ULONGEST) i;
7004 return TARGET_XFER_OK;
7007 /* Using the set of read-only target sections of remote, read live
7010 For interface/parameters/return description see target.h,
7013 static enum target_xfer_status
7014 remote_xfer_live_readonly_partial (struct target_ops *ops, gdb_byte *readbuf,
7015 ULONGEST memaddr, ULONGEST len,
7016 ULONGEST *xfered_len)
7018 struct target_section *secp;
7019 struct target_section_table *table;
7021 secp = target_section_by_addr (ops, memaddr);
7023 && (bfd_get_section_flags (secp->the_bfd_section->owner,
7024 secp->the_bfd_section)
7027 struct target_section *p;
7028 ULONGEST memend = memaddr + len;
7030 table = target_get_section_table (ops);
7032 for (p = table->sections; p < table->sections_end; p++)
7034 if (memaddr >= p->addr)
7036 if (memend <= p->endaddr)
7038 /* Entire transfer is within this section. */
7039 return remote_read_bytes_1 (memaddr, readbuf, len,
7042 else if (memaddr >= p->endaddr)
7044 /* This section ends before the transfer starts. */
7049 /* This section overlaps the transfer. Just do half. */
7050 len = p->endaddr - memaddr;
7051 return remote_read_bytes_1 (memaddr, readbuf, len,
7058 return TARGET_XFER_EOF;
7061 /* Similar to remote_read_bytes_1, but it reads from the remote stub
7062 first if the requested memory is unavailable in traceframe.
7063 Otherwise, fall back to remote_read_bytes_1. */
7065 static enum target_xfer_status
7066 remote_read_bytes (struct target_ops *ops, CORE_ADDR memaddr,
7067 gdb_byte *myaddr, ULONGEST len, ULONGEST *xfered_len)
7070 return TARGET_XFER_EOF;
7072 if (get_traceframe_number () != -1)
7074 VEC(mem_range_s) *available;
7076 /* If we fail to get the set of available memory, then the
7077 target does not support querying traceframe info, and so we
7078 attempt reading from the traceframe anyway (assuming the
7079 target implements the old QTro packet then). */
7080 if (traceframe_available_memory (&available, memaddr, len))
7082 struct cleanup *old_chain;
7084 old_chain = make_cleanup (VEC_cleanup(mem_range_s), &available);
7086 if (VEC_empty (mem_range_s, available)
7087 || VEC_index (mem_range_s, available, 0)->start != memaddr)
7089 enum target_xfer_status res;
7091 /* Don't read into the traceframe's available
7093 if (!VEC_empty (mem_range_s, available))
7095 LONGEST oldlen = len;
7097 len = VEC_index (mem_range_s, available, 0)->start - memaddr;
7098 gdb_assert (len <= oldlen);
7101 do_cleanups (old_chain);
7103 /* This goes through the topmost target again. */
7104 res = remote_xfer_live_readonly_partial (ops, myaddr, memaddr,
7106 if (res == TARGET_XFER_OK)
7107 return TARGET_XFER_OK;
7110 /* No use trying further, we know some memory starting
7111 at MEMADDR isn't available. */
7113 return TARGET_XFER_UNAVAILABLE;
7117 /* Don't try to read more than how much is available, in
7118 case the target implements the deprecated QTro packet to
7119 cater for older GDBs (the target's knowledge of read-only
7120 sections may be outdated by now). */
7121 len = VEC_index (mem_range_s, available, 0)->length;
7123 do_cleanups (old_chain);
7127 return remote_read_bytes_1 (memaddr, myaddr, len, xfered_len);
7132 /* Sends a packet with content determined by the printf format string
7133 FORMAT and the remaining arguments, then gets the reply. Returns
7134 whether the packet was a success, a failure, or unknown. */
7136 static enum packet_result remote_send_printf (const char *format, ...)
7137 ATTRIBUTE_PRINTF (1, 2);
7139 static enum packet_result
7140 remote_send_printf (const char *format, ...)
7142 struct remote_state *rs = get_remote_state ();
7143 int max_size = get_remote_packet_size ();
7146 va_start (ap, format);
7149 if (vsnprintf (rs->buf, max_size, format, ap) >= max_size)
7150 internal_error (__FILE__, __LINE__, _("Too long remote packet."));
7152 if (putpkt (rs->buf) < 0)
7153 error (_("Communication problem with target."));
7156 getpkt (&rs->buf, &rs->buf_size, 0);
7158 return packet_check_result (rs->buf);
7162 restore_remote_timeout (void *p)
7164 int value = *(int *)p;
7166 remote_timeout = value;
7169 /* Flash writing can take quite some time. We'll set
7170 effectively infinite timeout for flash operations.
7171 In future, we'll need to decide on a better approach. */
7172 static const int remote_flash_timeout = 1000;
7175 remote_flash_erase (struct target_ops *ops,
7176 ULONGEST address, LONGEST length)
7178 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
7179 int saved_remote_timeout = remote_timeout;
7180 enum packet_result ret;
7181 struct cleanup *back_to = make_cleanup (restore_remote_timeout,
7182 &saved_remote_timeout);
7184 remote_timeout = remote_flash_timeout;
7186 ret = remote_send_printf ("vFlashErase:%s,%s",
7187 phex (address, addr_size),
7191 case PACKET_UNKNOWN:
7192 error (_("Remote target does not support flash erase"));
7194 error (_("Error erasing flash with vFlashErase packet"));
7199 do_cleanups (back_to);
7202 static enum target_xfer_status
7203 remote_flash_write (struct target_ops *ops, ULONGEST address,
7204 ULONGEST length, ULONGEST *xfered_len,
7205 const gdb_byte *data)
7207 int saved_remote_timeout = remote_timeout;
7208 enum target_xfer_status ret;
7209 struct cleanup *back_to = make_cleanup (restore_remote_timeout,
7210 &saved_remote_timeout);
7212 remote_timeout = remote_flash_timeout;
7213 ret = remote_write_bytes_aux ("vFlashWrite:", address, data, length,
7215 do_cleanups (back_to);
7221 remote_flash_done (struct target_ops *ops)
7223 int saved_remote_timeout = remote_timeout;
7225 struct cleanup *back_to = make_cleanup (restore_remote_timeout,
7226 &saved_remote_timeout);
7228 remote_timeout = remote_flash_timeout;
7229 ret = remote_send_printf ("vFlashDone");
7230 do_cleanups (back_to);
7234 case PACKET_UNKNOWN:
7235 error (_("Remote target does not support vFlashDone"));
7237 error (_("Error finishing flash operation"));
7244 remote_files_info (struct target_ops *ignore)
7246 puts_filtered ("Debugging a target over a serial line.\n");
7249 /* Stuff for dealing with the packets which are part of this protocol.
7250 See comment at top of file for details. */
7252 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
7253 error to higher layers. Called when a serial error is detected.
7254 The exception message is STRING, followed by a colon and a blank,
7255 the system error message for errno at function entry and final dot
7256 for output compatibility with throw_perror_with_name. */
7259 unpush_and_perror (const char *string)
7261 int saved_errno = errno;
7263 remote_unpush_target ();
7264 throw_error (TARGET_CLOSE_ERROR, "%s: %s.", string,
7265 safe_strerror (saved_errno));
7268 /* Read a single character from the remote end. */
7271 readchar (int timeout)
7274 struct remote_state *rs = get_remote_state ();
7276 ch = serial_readchar (rs->remote_desc, timeout);
7281 switch ((enum serial_rc) ch)
7284 remote_unpush_target ();
7285 throw_error (TARGET_CLOSE_ERROR, _("Remote connection closed"));
7288 unpush_and_perror (_("Remote communication error. "
7289 "Target disconnected."));
7291 case SERIAL_TIMEOUT:
7297 /* Wrapper for serial_write that closes the target and throws if
7301 remote_serial_write (const char *str, int len)
7303 struct remote_state *rs = get_remote_state ();
7305 if (serial_write (rs->remote_desc, str, len))
7307 unpush_and_perror (_("Remote communication error. "
7308 "Target disconnected."));
7312 /* Send the command in *BUF to the remote machine, and read the reply
7313 into *BUF. Report an error if we get an error reply. Resize
7314 *BUF using xrealloc if necessary to hold the result, and update
7318 remote_send (char **buf,
7322 getpkt (buf, sizeof_buf, 0);
7324 if ((*buf)[0] == 'E')
7325 error (_("Remote failure reply: %s"), *buf);
7328 /* Return a pointer to an xmalloc'ed string representing an escaped
7329 version of BUF, of len N. E.g. \n is converted to \\n, \t to \\t,
7330 etc. The caller is responsible for releasing the returned
7334 escape_buffer (const char *buf, int n)
7336 struct cleanup *old_chain;
7337 struct ui_file *stb;
7340 stb = mem_fileopen ();
7341 old_chain = make_cleanup_ui_file_delete (stb);
7343 fputstrn_unfiltered (buf, n, '\\', stb);
7344 str = ui_file_xstrdup (stb, NULL);
7345 do_cleanups (old_chain);
7349 /* Display a null-terminated packet on stdout, for debugging, using C
7353 print_packet (const char *buf)
7355 puts_filtered ("\"");
7356 fputstr_filtered (buf, '"', gdb_stdout);
7357 puts_filtered ("\"");
7361 putpkt (const char *buf)
7363 return putpkt_binary (buf, strlen (buf));
7366 /* Send a packet to the remote machine, with error checking. The data
7367 of the packet is in BUF. The string in BUF can be at most
7368 get_remote_packet_size () - 5 to account for the $, # and checksum,
7369 and for a possible /0 if we are debugging (remote_debug) and want
7370 to print the sent packet as a string. */
7373 putpkt_binary (const char *buf, int cnt)
7375 struct remote_state *rs = get_remote_state ();
7377 unsigned char csum = 0;
7378 char *buf2 = alloca (cnt + 6);
7385 /* Catch cases like trying to read memory or listing threads while
7386 we're waiting for a stop reply. The remote server wouldn't be
7387 ready to handle this request, so we'd hang and timeout. We don't
7388 have to worry about this in synchronous mode, because in that
7389 case it's not possible to issue a command while the target is
7390 running. This is not a problem in non-stop mode, because in that
7391 case, the stub is always ready to process serial input. */
7392 if (!non_stop && target_is_async_p () && rs->waiting_for_stop_reply)
7394 error (_("Cannot execute this command while the target is running.\n"
7395 "Use the \"interrupt\" command to stop the target\n"
7396 "and then try again."));
7399 /* We're sending out a new packet. Make sure we don't look at a
7400 stale cached response. */
7401 rs->cached_wait_status = 0;
7403 /* Copy the packet into buffer BUF2, encapsulating it
7404 and giving it a checksum. */
7409 for (i = 0; i < cnt; i++)
7415 *p++ = tohex ((csum >> 4) & 0xf);
7416 *p++ = tohex (csum & 0xf);
7418 /* Send it over and over until we get a positive ack. */
7422 int started_error_output = 0;
7426 struct cleanup *old_chain;
7430 str = escape_buffer (buf2, p - buf2);
7431 old_chain = make_cleanup (xfree, str);
7432 fprintf_unfiltered (gdb_stdlog, "Sending packet: %s...", str);
7433 gdb_flush (gdb_stdlog);
7434 do_cleanups (old_chain);
7436 remote_serial_write (buf2, p - buf2);
7438 /* If this is a no acks version of the remote protocol, send the
7439 packet and move on. */
7443 /* Read until either a timeout occurs (-2) or '+' is read.
7444 Handle any notification that arrives in the mean time. */
7447 ch = readchar (remote_timeout);
7455 case SERIAL_TIMEOUT:
7458 if (started_error_output)
7460 putchar_unfiltered ('\n');
7461 started_error_output = 0;
7470 fprintf_unfiltered (gdb_stdlog, "Ack\n");
7474 fprintf_unfiltered (gdb_stdlog, "Nak\n");
7476 case SERIAL_TIMEOUT:
7480 break; /* Retransmit buffer. */
7484 fprintf_unfiltered (gdb_stdlog,
7485 "Packet instead of Ack, ignoring it\n");
7486 /* It's probably an old response sent because an ACK
7487 was lost. Gobble up the packet and ack it so it
7488 doesn't get retransmitted when we resend this
7491 remote_serial_write ("+", 1);
7492 continue; /* Now, go look for +. */
7499 /* If we got a notification, handle it, and go back to looking
7501 /* We've found the start of a notification. Now
7502 collect the data. */
7503 val = read_frame (&rs->buf, &rs->buf_size);
7508 struct cleanup *old_chain;
7511 str = escape_buffer (rs->buf, val);
7512 old_chain = make_cleanup (xfree, str);
7513 fprintf_unfiltered (gdb_stdlog,
7514 " Notification received: %s\n",
7516 do_cleanups (old_chain);
7518 handle_notification (rs->notif_state, rs->buf);
7519 /* We're in sync now, rewait for the ack. */
7526 if (!started_error_output)
7528 started_error_output = 1;
7529 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
7531 fputc_unfiltered (ch & 0177, gdb_stdlog);
7532 fprintf_unfiltered (gdb_stdlog, "%s", rs->buf);
7541 if (!started_error_output)
7543 started_error_output = 1;
7544 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
7546 fputc_unfiltered (ch & 0177, gdb_stdlog);
7550 break; /* Here to retransmit. */
7554 /* This is wrong. If doing a long backtrace, the user should be
7555 able to get out next time we call QUIT, without anything as
7556 violent as interrupt_query. If we want to provide a way out of
7557 here without getting to the next QUIT, it should be based on
7558 hitting ^C twice as in remote_wait. */
7569 /* Come here after finding the start of a frame when we expected an
7570 ack. Do our best to discard the rest of this packet. */
7579 c = readchar (remote_timeout);
7582 case SERIAL_TIMEOUT:
7583 /* Nothing we can do. */
7586 /* Discard the two bytes of checksum and stop. */
7587 c = readchar (remote_timeout);
7589 c = readchar (remote_timeout);
7592 case '*': /* Run length encoding. */
7593 /* Discard the repeat count. */
7594 c = readchar (remote_timeout);
7599 /* A regular character. */
7605 /* Come here after finding the start of the frame. Collect the rest
7606 into *BUF, verifying the checksum, length, and handling run-length
7607 compression. NUL terminate the buffer. If there is not enough room,
7608 expand *BUF using xrealloc.
7610 Returns -1 on error, number of characters in buffer (ignoring the
7611 trailing NULL) on success. (could be extended to return one of the
7612 SERIAL status indications). */
7615 read_frame (char **buf_p,
7622 struct remote_state *rs = get_remote_state ();
7629 c = readchar (remote_timeout);
7632 case SERIAL_TIMEOUT:
7634 fputs_filtered ("Timeout in mid-packet, retrying\n", gdb_stdlog);
7638 fputs_filtered ("Saw new packet start in middle of old one\n",
7640 return -1; /* Start a new packet, count retries. */
7643 unsigned char pktcsum;
7649 check_0 = readchar (remote_timeout);
7651 check_1 = readchar (remote_timeout);
7653 if (check_0 == SERIAL_TIMEOUT || check_1 == SERIAL_TIMEOUT)
7656 fputs_filtered ("Timeout in checksum, retrying\n",
7660 else if (check_0 < 0 || check_1 < 0)
7663 fputs_filtered ("Communication error in checksum\n",
7668 /* Don't recompute the checksum; with no ack packets we
7669 don't have any way to indicate a packet retransmission
7674 pktcsum = (fromhex (check_0) << 4) | fromhex (check_1);
7675 if (csum == pktcsum)
7680 struct cleanup *old_chain;
7683 str = escape_buffer (buf, bc);
7684 old_chain = make_cleanup (xfree, str);
7685 fprintf_unfiltered (gdb_stdlog,
7686 "Bad checksum, sentsum=0x%x, "
7687 "csum=0x%x, buf=%s\n",
7688 pktcsum, csum, str);
7689 do_cleanups (old_chain);
7691 /* Number of characters in buffer ignoring trailing
7695 case '*': /* Run length encoding. */
7700 c = readchar (remote_timeout);
7702 repeat = c - ' ' + 3; /* Compute repeat count. */
7704 /* The character before ``*'' is repeated. */
7706 if (repeat > 0 && repeat <= 255 && bc > 0)
7708 if (bc + repeat - 1 >= *sizeof_buf - 1)
7710 /* Make some more room in the buffer. */
7711 *sizeof_buf += repeat;
7712 *buf_p = xrealloc (*buf_p, *sizeof_buf);
7716 memset (&buf[bc], buf[bc - 1], repeat);
7722 printf_filtered (_("Invalid run length encoding: %s\n"), buf);
7726 if (bc >= *sizeof_buf - 1)
7728 /* Make some more room in the buffer. */
7730 *buf_p = xrealloc (*buf_p, *sizeof_buf);
7741 /* Read a packet from the remote machine, with error checking, and
7742 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
7743 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
7744 rather than timing out; this is used (in synchronous mode) to wait
7745 for a target that is is executing user code to stop. */
7746 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
7747 don't have to change all the calls to getpkt to deal with the
7748 return value, because at the moment I don't know what the right
7749 thing to do it for those. */
7757 timed_out = getpkt_sane (buf, sizeof_buf, forever);
7761 /* Read a packet from the remote machine, with error checking, and
7762 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
7763 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
7764 rather than timing out; this is used (in synchronous mode) to wait
7765 for a target that is is executing user code to stop. If FOREVER ==
7766 0, this function is allowed to time out gracefully and return an
7767 indication of this to the caller. Otherwise return the number of
7768 bytes read. If EXPECTING_NOTIF, consider receiving a notification
7769 enough reason to return to the caller. *IS_NOTIF is an output
7770 boolean that indicates whether *BUF holds a notification or not
7771 (a regular packet). */
7774 getpkt_or_notif_sane_1 (char **buf, long *sizeof_buf, int forever,
7775 int expecting_notif, int *is_notif)
7777 struct remote_state *rs = get_remote_state ();
7783 /* We're reading a new response. Make sure we don't look at a
7784 previously cached response. */
7785 rs->cached_wait_status = 0;
7787 strcpy (*buf, "timeout");
7790 timeout = watchdog > 0 ? watchdog : -1;
7791 else if (expecting_notif)
7792 timeout = 0; /* There should already be a char in the buffer. If
7795 timeout = remote_timeout;
7799 /* Process any number of notifications, and then return when
7803 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
7805 for (tries = 1; tries <= MAX_TRIES; tries++)
7807 /* This can loop forever if the remote side sends us
7808 characters continuously, but if it pauses, we'll get
7809 SERIAL_TIMEOUT from readchar because of timeout. Then
7810 we'll count that as a retry.
7812 Note that even when forever is set, we will only wait
7813 forever prior to the start of a packet. After that, we
7814 expect characters to arrive at a brisk pace. They should
7815 show up within remote_timeout intervals. */
7817 c = readchar (timeout);
7818 while (c != SERIAL_TIMEOUT && c != '$' && c != '%');
7820 if (c == SERIAL_TIMEOUT)
7822 if (expecting_notif)
7823 return -1; /* Don't complain, it's normal to not get
7824 anything in this case. */
7826 if (forever) /* Watchdog went off? Kill the target. */
7829 remote_unpush_target ();
7830 throw_error (TARGET_CLOSE_ERROR,
7831 _("Watchdog timeout has expired. "
7832 "Target detached."));
7835 fputs_filtered ("Timed out.\n", gdb_stdlog);
7839 /* We've found the start of a packet or notification.
7840 Now collect the data. */
7841 val = read_frame (buf, sizeof_buf);
7846 remote_serial_write ("-", 1);
7849 if (tries > MAX_TRIES)
7851 /* We have tried hard enough, and just can't receive the
7852 packet/notification. Give up. */
7853 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
7855 /* Skip the ack char if we're in no-ack mode. */
7856 if (!rs->noack_mode)
7857 remote_serial_write ("+", 1);
7861 /* If we got an ordinary packet, return that to our caller. */
7866 struct cleanup *old_chain;
7869 str = escape_buffer (*buf, val);
7870 old_chain = make_cleanup (xfree, str);
7871 fprintf_unfiltered (gdb_stdlog, "Packet received: %s\n", str);
7872 do_cleanups (old_chain);
7875 /* Skip the ack char if we're in no-ack mode. */
7876 if (!rs->noack_mode)
7877 remote_serial_write ("+", 1);
7878 if (is_notif != NULL)
7883 /* If we got a notification, handle it, and go back to looking
7887 gdb_assert (c == '%');
7891 struct cleanup *old_chain;
7894 str = escape_buffer (*buf, val);
7895 old_chain = make_cleanup (xfree, str);
7896 fprintf_unfiltered (gdb_stdlog,
7897 " Notification received: %s\n",
7899 do_cleanups (old_chain);
7901 if (is_notif != NULL)
7904 handle_notification (rs->notif_state, *buf);
7906 /* Notifications require no acknowledgement. */
7908 if (expecting_notif)
7915 getpkt_sane (char **buf, long *sizeof_buf, int forever)
7917 return getpkt_or_notif_sane_1 (buf, sizeof_buf, forever, 0, NULL);
7921 getpkt_or_notif_sane (char **buf, long *sizeof_buf, int forever,
7924 return getpkt_or_notif_sane_1 (buf, sizeof_buf, forever, 1,
7930 remote_kill (struct target_ops *ops)
7933 /* Catch errors so the user can quit from gdb even when we
7934 aren't on speaking terms with the remote system. */
7939 CATCH (ex, RETURN_MASK_ERROR)
7941 if (ex.error == TARGET_CLOSE_ERROR)
7943 /* If we got an (EOF) error that caused the target
7944 to go away, then we're done, that's what we wanted.
7945 "k" is susceptible to cause a premature EOF, given
7946 that the remote server isn't actually required to
7947 reply to "k", and it can happen that it doesn't
7948 even get to reply ACK to the "k". */
7952 /* Otherwise, something went wrong. We didn't actually kill
7953 the target. Just propagate the exception, and let the
7954 user or higher layers decide what to do. */
7955 throw_exception (ex);
7959 /* We've killed the remote end, we get to mourn it. Since this is
7960 target remote, single-process, mourning the inferior also
7961 unpushes remote_ops. */
7962 target_mourn_inferior ();
7966 remote_vkill (int pid, struct remote_state *rs)
7968 if (packet_support (PACKET_vKill) == PACKET_DISABLE)
7971 /* Tell the remote target to detach. */
7972 xsnprintf (rs->buf, get_remote_packet_size (), "vKill;%x", pid);
7974 getpkt (&rs->buf, &rs->buf_size, 0);
7976 switch (packet_ok (rs->buf,
7977 &remote_protocol_packets[PACKET_vKill]))
7983 case PACKET_UNKNOWN:
7986 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
7991 extended_remote_kill (struct target_ops *ops)
7994 int pid = ptid_get_pid (inferior_ptid);
7995 struct remote_state *rs = get_remote_state ();
7997 res = remote_vkill (pid, rs);
7998 if (res == -1 && !(rs->extended && remote_multi_process_p (rs)))
8000 /* Don't try 'k' on a multi-process aware stub -- it has no way
8001 to specify the pid. */
8005 getpkt (&rs->buf, &rs->buf_size, 0);
8006 if (rs->buf[0] != 'O' || rs->buf[0] != 'K')
8009 /* Don't wait for it to die. I'm not really sure it matters whether
8010 we do or not. For the existing stubs, kill is a noop. */
8016 error (_("Can't kill process"));
8018 target_mourn_inferior ();
8022 remote_mourn (struct target_ops *target)
8024 unpush_target (target);
8026 /* remote_close takes care of doing most of the clean up. */
8027 generic_mourn_inferior ();
8031 extended_remote_mourn (struct target_ops *target)
8033 struct remote_state *rs = get_remote_state ();
8035 /* In case we got here due to an error, but we're going to stay
8037 rs->waiting_for_stop_reply = 0;
8039 /* If the current general thread belonged to the process we just
8040 detached from or has exited, the remote side current general
8041 thread becomes undefined. Considering a case like this:
8043 - We just got here due to a detach.
8044 - The process that we're detaching from happens to immediately
8045 report a global breakpoint being hit in non-stop mode, in the
8046 same thread we had selected before.
8047 - GDB attaches to this process again.
8048 - This event happens to be the next event we handle.
8050 GDB would consider that the current general thread didn't need to
8051 be set on the stub side (with Hg), since for all it knew,
8052 GENERAL_THREAD hadn't changed.
8054 Notice that although in all-stop mode, the remote server always
8055 sets the current thread to the thread reporting the stop event,
8056 that doesn't happen in non-stop mode; in non-stop, the stub *must
8057 not* change the current thread when reporting a breakpoint hit,
8058 due to the decoupling of event reporting and event handling.
8060 To keep things simple, we always invalidate our notion of the
8062 record_currthread (rs, minus_one_ptid);
8064 /* Unlike "target remote", we do not want to unpush the target; then
8065 the next time the user says "run", we won't be connected. */
8067 /* Call common code to mark the inferior as not running. */
8068 generic_mourn_inferior ();
8070 if (!have_inferiors ())
8072 if (!remote_multi_process_p (rs))
8074 /* Check whether the target is running now - some remote stubs
8075 automatically restart after kill. */
8077 getpkt (&rs->buf, &rs->buf_size, 0);
8079 if (rs->buf[0] == 'S' || rs->buf[0] == 'T')
8081 /* Assume that the target has been restarted. Set
8082 inferior_ptid so that bits of core GDB realizes
8083 there's something here, e.g., so that the user can
8084 say "kill" again. */
8085 inferior_ptid = magic_null_ptid;
8092 extended_remote_supports_disable_randomization (struct target_ops *self)
8094 return packet_support (PACKET_QDisableRandomization) == PACKET_ENABLE;
8098 extended_remote_disable_randomization (int val)
8100 struct remote_state *rs = get_remote_state ();
8103 xsnprintf (rs->buf, get_remote_packet_size (), "QDisableRandomization:%x",
8106 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
8108 error (_("Target does not support QDisableRandomization."));
8109 if (strcmp (reply, "OK") != 0)
8110 error (_("Bogus QDisableRandomization reply from target: %s"), reply);
8114 extended_remote_run (char *args)
8116 struct remote_state *rs = get_remote_state ();
8119 /* If the user has disabled vRun support, or we have detected that
8120 support is not available, do not try it. */
8121 if (packet_support (PACKET_vRun) == PACKET_DISABLE)
8124 strcpy (rs->buf, "vRun;");
8125 len = strlen (rs->buf);
8127 if (strlen (remote_exec_file) * 2 + len >= get_remote_packet_size ())
8128 error (_("Remote file name too long for run packet"));
8129 len += 2 * bin2hex ((gdb_byte *) remote_exec_file, rs->buf + len,
8130 strlen (remote_exec_file));
8132 gdb_assert (args != NULL);
8135 struct cleanup *back_to;
8139 argv = gdb_buildargv (args);
8140 back_to = make_cleanup_freeargv (argv);
8141 for (i = 0; argv[i] != NULL; i++)
8143 if (strlen (argv[i]) * 2 + 1 + len >= get_remote_packet_size ())
8144 error (_("Argument list too long for run packet"));
8145 rs->buf[len++] = ';';
8146 len += 2 * bin2hex ((gdb_byte *) argv[i], rs->buf + len,
8149 do_cleanups (back_to);
8152 rs->buf[len++] = '\0';
8155 getpkt (&rs->buf, &rs->buf_size, 0);
8157 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_vRun]))
8160 /* We have a wait response. All is well. */
8162 case PACKET_UNKNOWN:
8165 if (remote_exec_file[0] == '\0')
8166 error (_("Running the default executable on the remote target failed; "
8167 "try \"set remote exec-file\"?"));
8169 error (_("Running \"%s\" on the remote target failed"),
8172 gdb_assert_not_reached (_("bad switch"));
8176 /* In the extended protocol we want to be able to do things like
8177 "run" and have them basically work as expected. So we need
8178 a special create_inferior function. We support changing the
8179 executable file and the command line arguments, but not the
8183 extended_remote_create_inferior (struct target_ops *ops,
8184 char *exec_file, char *args,
8185 char **env, int from_tty)
8189 struct remote_state *rs = get_remote_state ();
8191 /* If running asynchronously, register the target file descriptor
8192 with the event loop. */
8193 if (target_can_async_p ())
8196 /* Disable address space randomization if requested (and supported). */
8197 if (extended_remote_supports_disable_randomization (ops))
8198 extended_remote_disable_randomization (disable_randomization);
8200 /* Now restart the remote server. */
8201 run_worked = extended_remote_run (args) != -1;
8204 /* vRun was not supported. Fail if we need it to do what the
8206 if (remote_exec_file[0])
8207 error (_("Remote target does not support \"set remote exec-file\""));
8209 error (_("Remote target does not support \"set args\" or run <ARGS>"));
8211 /* Fall back to "R". */
8212 extended_remote_restart ();
8215 if (!have_inferiors ())
8217 /* Clean up from the last time we ran, before we mark the target
8218 running again. This will mark breakpoints uninserted, and
8219 get_offsets may insert breakpoints. */
8220 init_thread_list ();
8221 init_wait_for_inferior ();
8224 /* vRun's success return is a stop reply. */
8225 stop_reply = run_worked ? rs->buf : NULL;
8226 add_current_inferior_and_thread (stop_reply);
8228 /* Get updated offsets, if the stub uses qOffsets. */
8233 /* Given a location's target info BP_TGT and the packet buffer BUF, output
8234 the list of conditions (in agent expression bytecode format), if any, the
8235 target needs to evaluate. The output is placed into the packet buffer
8236 started from BUF and ended at BUF_END. */
8239 remote_add_target_side_condition (struct gdbarch *gdbarch,
8240 struct bp_target_info *bp_tgt, char *buf,
8243 struct agent_expr *aexpr = NULL;
8246 char *buf_start = buf;
8248 if (VEC_empty (agent_expr_p, bp_tgt->conditions))
8251 buf += strlen (buf);
8252 xsnprintf (buf, buf_end - buf, "%s", ";");
8255 /* Send conditions to the target and free the vector. */
8257 VEC_iterate (agent_expr_p, bp_tgt->conditions, ix, aexpr);
8260 xsnprintf (buf, buf_end - buf, "X%x,", aexpr->len);
8261 buf += strlen (buf);
8262 for (i = 0; i < aexpr->len; ++i)
8263 buf = pack_hex_byte (buf, aexpr->buf[i]);
8270 remote_add_target_side_commands (struct gdbarch *gdbarch,
8271 struct bp_target_info *bp_tgt, char *buf)
8273 struct agent_expr *aexpr = NULL;
8276 if (VEC_empty (agent_expr_p, bp_tgt->tcommands))
8279 buf += strlen (buf);
8281 sprintf (buf, ";cmds:%x,", bp_tgt->persist);
8282 buf += strlen (buf);
8284 /* Concatenate all the agent expressions that are commands into the
8287 VEC_iterate (agent_expr_p, bp_tgt->tcommands, ix, aexpr);
8290 sprintf (buf, "X%x,", aexpr->len);
8291 buf += strlen (buf);
8292 for (i = 0; i < aexpr->len; ++i)
8293 buf = pack_hex_byte (buf, aexpr->buf[i]);
8298 /* Insert a breakpoint. On targets that have software breakpoint
8299 support, we ask the remote target to do the work; on targets
8300 which don't, we insert a traditional memory breakpoint. */
8303 remote_insert_breakpoint (struct target_ops *ops,
8304 struct gdbarch *gdbarch,
8305 struct bp_target_info *bp_tgt)
8307 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
8308 If it succeeds, then set the support to PACKET_ENABLE. If it
8309 fails, and the user has explicitly requested the Z support then
8310 report an error, otherwise, mark it disabled and go on. */
8312 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
8314 CORE_ADDR addr = bp_tgt->reqstd_address;
8315 struct remote_state *rs;
8318 struct condition_list *cond = NULL;
8320 /* Make sure the remote is pointing at the right process, if
8322 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8323 set_general_process ();
8325 gdbarch_remote_breakpoint_from_pc (gdbarch, &addr, &bpsize);
8327 rs = get_remote_state ();
8329 endbuf = rs->buf + get_remote_packet_size ();
8334 addr = (ULONGEST) remote_address_masked (addr);
8335 p += hexnumstr (p, addr);
8336 xsnprintf (p, endbuf - p, ",%d", bpsize);
8338 if (remote_supports_cond_breakpoints (ops))
8339 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
8341 if (remote_can_run_breakpoint_commands (ops))
8342 remote_add_target_side_commands (gdbarch, bp_tgt, p);
8345 getpkt (&rs->buf, &rs->buf_size, 0);
8347 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0]))
8352 bp_tgt->placed_address = addr;
8353 bp_tgt->placed_size = bpsize;
8355 case PACKET_UNKNOWN:
8360 /* If this breakpoint has target-side commands but this stub doesn't
8361 support Z0 packets, throw error. */
8362 if (!VEC_empty (agent_expr_p, bp_tgt->tcommands))
8363 throw_error (NOT_SUPPORTED_ERROR, _("\
8364 Target doesn't support breakpoints that have target side commands."));
8366 return memory_insert_breakpoint (ops, gdbarch, bp_tgt);
8370 remote_remove_breakpoint (struct target_ops *ops,
8371 struct gdbarch *gdbarch,
8372 struct bp_target_info *bp_tgt)
8374 CORE_ADDR addr = bp_tgt->placed_address;
8375 struct remote_state *rs = get_remote_state ();
8377 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
8380 char *endbuf = rs->buf + get_remote_packet_size ();
8382 /* Make sure the remote is pointing at the right process, if
8384 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8385 set_general_process ();
8391 addr = (ULONGEST) remote_address_masked (bp_tgt->placed_address);
8392 p += hexnumstr (p, addr);
8393 xsnprintf (p, endbuf - p, ",%d", bp_tgt->placed_size);
8396 getpkt (&rs->buf, &rs->buf_size, 0);
8398 return (rs->buf[0] == 'E');
8401 return memory_remove_breakpoint (ops, gdbarch, bp_tgt);
8405 watchpoint_to_Z_packet (int type)
8410 return Z_PACKET_WRITE_WP;
8413 return Z_PACKET_READ_WP;
8416 return Z_PACKET_ACCESS_WP;
8419 internal_error (__FILE__, __LINE__,
8420 _("hw_bp_to_z: bad watchpoint type %d"), type);
8425 remote_insert_watchpoint (struct target_ops *self,
8426 CORE_ADDR addr, int len, int type,
8427 struct expression *cond)
8429 struct remote_state *rs = get_remote_state ();
8430 char *endbuf = rs->buf + get_remote_packet_size ();
8432 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
8434 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
8437 /* Make sure the remote is pointing at the right process, if
8439 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8440 set_general_process ();
8442 xsnprintf (rs->buf, endbuf - rs->buf, "Z%x,", packet);
8443 p = strchr (rs->buf, '\0');
8444 addr = remote_address_masked (addr);
8445 p += hexnumstr (p, (ULONGEST) addr);
8446 xsnprintf (p, endbuf - p, ",%x", len);
8449 getpkt (&rs->buf, &rs->buf_size, 0);
8451 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
8455 case PACKET_UNKNOWN:
8460 internal_error (__FILE__, __LINE__,
8461 _("remote_insert_watchpoint: reached end of function"));
8465 remote_watchpoint_addr_within_range (struct target_ops *target, CORE_ADDR addr,
8466 CORE_ADDR start, int length)
8468 CORE_ADDR diff = remote_address_masked (addr - start);
8470 return diff < length;
8475 remote_remove_watchpoint (struct target_ops *self,
8476 CORE_ADDR addr, int len, int type,
8477 struct expression *cond)
8479 struct remote_state *rs = get_remote_state ();
8480 char *endbuf = rs->buf + get_remote_packet_size ();
8482 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
8484 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
8487 /* Make sure the remote is pointing at the right process, if
8489 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8490 set_general_process ();
8492 xsnprintf (rs->buf, endbuf - rs->buf, "z%x,", packet);
8493 p = strchr (rs->buf, '\0');
8494 addr = remote_address_masked (addr);
8495 p += hexnumstr (p, (ULONGEST) addr);
8496 xsnprintf (p, endbuf - p, ",%x", len);
8498 getpkt (&rs->buf, &rs->buf_size, 0);
8500 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
8503 case PACKET_UNKNOWN:
8508 internal_error (__FILE__, __LINE__,
8509 _("remote_remove_watchpoint: reached end of function"));
8513 int remote_hw_watchpoint_limit = -1;
8514 int remote_hw_watchpoint_length_limit = -1;
8515 int remote_hw_breakpoint_limit = -1;
8518 remote_region_ok_for_hw_watchpoint (struct target_ops *self,
8519 CORE_ADDR addr, int len)
8521 if (remote_hw_watchpoint_length_limit == 0)
8523 else if (remote_hw_watchpoint_length_limit < 0)
8525 else if (len <= remote_hw_watchpoint_length_limit)
8532 remote_check_watch_resources (struct target_ops *self,
8533 int type, int cnt, int ot)
8535 if (type == bp_hardware_breakpoint)
8537 if (remote_hw_breakpoint_limit == 0)
8539 else if (remote_hw_breakpoint_limit < 0)
8541 else if (cnt <= remote_hw_breakpoint_limit)
8546 if (remote_hw_watchpoint_limit == 0)
8548 else if (remote_hw_watchpoint_limit < 0)
8552 else if (cnt <= remote_hw_watchpoint_limit)
8558 /* The to_stopped_by_sw_breakpoint method of target remote. */
8561 remote_stopped_by_sw_breakpoint (struct target_ops *ops)
8563 struct remote_state *rs = get_remote_state ();
8565 return rs->stop_reason == TARGET_STOPPED_BY_SW_BREAKPOINT;
8568 /* The to_supports_stopped_by_sw_breakpoint method of target
8572 remote_supports_stopped_by_sw_breakpoint (struct target_ops *ops)
8574 struct remote_state *rs = get_remote_state ();
8576 return (packet_support (PACKET_swbreak_feature) == PACKET_ENABLE);
8579 /* The to_stopped_by_hw_breakpoint method of target remote. */
8582 remote_stopped_by_hw_breakpoint (struct target_ops *ops)
8584 struct remote_state *rs = get_remote_state ();
8586 return rs->stop_reason == TARGET_STOPPED_BY_HW_BREAKPOINT;
8589 /* The to_supports_stopped_by_hw_breakpoint method of target
8593 remote_supports_stopped_by_hw_breakpoint (struct target_ops *ops)
8595 struct remote_state *rs = get_remote_state ();
8597 return (packet_support (PACKET_hwbreak_feature) == PACKET_ENABLE);
8601 remote_stopped_by_watchpoint (struct target_ops *ops)
8603 struct remote_state *rs = get_remote_state ();
8605 return rs->stop_reason == TARGET_STOPPED_BY_WATCHPOINT;
8609 remote_stopped_data_address (struct target_ops *target, CORE_ADDR *addr_p)
8611 struct remote_state *rs = get_remote_state ();
8614 if (remote_stopped_by_watchpoint (target))
8616 *addr_p = rs->remote_watch_data_address;
8625 remote_insert_hw_breakpoint (struct target_ops *self, struct gdbarch *gdbarch,
8626 struct bp_target_info *bp_tgt)
8628 CORE_ADDR addr = bp_tgt->reqstd_address;
8629 struct remote_state *rs;
8634 /* The length field should be set to the size of a breakpoint
8635 instruction, even though we aren't inserting one ourselves. */
8637 gdbarch_remote_breakpoint_from_pc (gdbarch, &addr, &bpsize);
8639 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
8642 /* Make sure the remote is pointing at the right process, if
8644 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8645 set_general_process ();
8647 rs = get_remote_state ();
8649 endbuf = rs->buf + get_remote_packet_size ();
8655 addr = remote_address_masked (addr);
8656 p += hexnumstr (p, (ULONGEST) addr);
8657 xsnprintf (p, endbuf - p, ",%x", bpsize);
8659 if (remote_supports_cond_breakpoints (self))
8660 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
8662 if (remote_can_run_breakpoint_commands (self))
8663 remote_add_target_side_commands (gdbarch, bp_tgt, p);
8666 getpkt (&rs->buf, &rs->buf_size, 0);
8668 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
8671 if (rs->buf[1] == '.')
8673 message = strchr (rs->buf + 2, '.');
8675 error (_("Remote failure reply: %s"), message + 1);
8678 case PACKET_UNKNOWN:
8681 bp_tgt->placed_address = addr;
8682 bp_tgt->placed_size = bpsize;
8685 internal_error (__FILE__, __LINE__,
8686 _("remote_insert_hw_breakpoint: reached end of function"));
8691 remote_remove_hw_breakpoint (struct target_ops *self, struct gdbarch *gdbarch,
8692 struct bp_target_info *bp_tgt)
8695 struct remote_state *rs = get_remote_state ();
8697 char *endbuf = rs->buf + get_remote_packet_size ();
8699 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
8702 /* Make sure the remote is pointing at the right process, if
8704 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8705 set_general_process ();
8711 addr = remote_address_masked (bp_tgt->placed_address);
8712 p += hexnumstr (p, (ULONGEST) addr);
8713 xsnprintf (p, endbuf - p, ",%x", bp_tgt->placed_size);
8716 getpkt (&rs->buf, &rs->buf_size, 0);
8718 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
8721 case PACKET_UNKNOWN:
8726 internal_error (__FILE__, __LINE__,
8727 _("remote_remove_hw_breakpoint: reached end of function"));
8730 /* Verify memory using the "qCRC:" request. */
8733 remote_verify_memory (struct target_ops *ops,
8734 const gdb_byte *data, CORE_ADDR lma, ULONGEST size)
8736 struct remote_state *rs = get_remote_state ();
8737 unsigned long host_crc, target_crc;
8740 /* It doesn't make sense to use qCRC if the remote target is
8741 connected but not running. */
8742 if (target_has_execution && packet_support (PACKET_qCRC) != PACKET_DISABLE)
8744 enum packet_result result;
8746 /* Make sure the remote is pointing at the right process. */
8747 set_general_process ();
8749 /* FIXME: assumes lma can fit into long. */
8750 xsnprintf (rs->buf, get_remote_packet_size (), "qCRC:%lx,%lx",
8751 (long) lma, (long) size);
8754 /* Be clever; compute the host_crc before waiting for target
8756 host_crc = xcrc32 (data, size, 0xffffffff);
8758 getpkt (&rs->buf, &rs->buf_size, 0);
8760 result = packet_ok (rs->buf,
8761 &remote_protocol_packets[PACKET_qCRC]);
8762 if (result == PACKET_ERROR)
8764 else if (result == PACKET_OK)
8766 for (target_crc = 0, tmp = &rs->buf[1]; *tmp; tmp++)
8767 target_crc = target_crc * 16 + fromhex (*tmp);
8769 return (host_crc == target_crc);
8773 return simple_verify_memory (ops, data, lma, size);
8776 /* compare-sections command
8778 With no arguments, compares each loadable section in the exec bfd
8779 with the same memory range on the target, and reports mismatches.
8780 Useful for verifying the image on the target against the exec file. */
8783 compare_sections_command (char *args, int from_tty)
8786 struct cleanup *old_chain;
8788 const char *sectname;
8797 error (_("command cannot be used without an exec file"));
8799 /* Make sure the remote is pointing at the right process. */
8800 set_general_process ();
8802 if (args != NULL && strcmp (args, "-r") == 0)
8808 for (s = exec_bfd->sections; s; s = s->next)
8810 if (!(s->flags & SEC_LOAD))
8811 continue; /* Skip non-loadable section. */
8813 if (read_only && (s->flags & SEC_READONLY) == 0)
8814 continue; /* Skip writeable sections */
8816 size = bfd_get_section_size (s);
8818 continue; /* Skip zero-length section. */
8820 sectname = bfd_get_section_name (exec_bfd, s);
8821 if (args && strcmp (args, sectname) != 0)
8822 continue; /* Not the section selected by user. */
8824 matched = 1; /* Do this section. */
8827 sectdata = xmalloc (size);
8828 old_chain = make_cleanup (xfree, sectdata);
8829 bfd_get_section_contents (exec_bfd, s, sectdata, 0, size);
8831 res = target_verify_memory (sectdata, lma, size);
8834 error (_("target memory fault, section %s, range %s -- %s"), sectname,
8835 paddress (target_gdbarch (), lma),
8836 paddress (target_gdbarch (), lma + size));
8838 printf_filtered ("Section %s, range %s -- %s: ", sectname,
8839 paddress (target_gdbarch (), lma),
8840 paddress (target_gdbarch (), lma + size));
8842 printf_filtered ("matched.\n");
8845 printf_filtered ("MIS-MATCHED!\n");
8849 do_cleanups (old_chain);
8852 warning (_("One or more sections of the target image does not match\n\
8853 the loaded file\n"));
8854 if (args && !matched)
8855 printf_filtered (_("No loaded section named '%s'.\n"), args);
8858 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
8859 into remote target. The number of bytes written to the remote
8860 target is returned, or -1 for error. */
8862 static enum target_xfer_status
8863 remote_write_qxfer (struct target_ops *ops, const char *object_name,
8864 const char *annex, const gdb_byte *writebuf,
8865 ULONGEST offset, LONGEST len, ULONGEST *xfered_len,
8866 struct packet_config *packet)
8870 struct remote_state *rs = get_remote_state ();
8871 int max_size = get_memory_write_packet_size ();
8873 if (packet->support == PACKET_DISABLE)
8874 return TARGET_XFER_E_IO;
8876 /* Insert header. */
8877 i = snprintf (rs->buf, max_size,
8878 "qXfer:%s:write:%s:%s:",
8879 object_name, annex ? annex : "",
8880 phex_nz (offset, sizeof offset));
8881 max_size -= (i + 1);
8883 /* Escape as much data as fits into rs->buf. */
8884 buf_len = remote_escape_output
8885 (writebuf, len, (gdb_byte *) rs->buf + i, &max_size, max_size);
8887 if (putpkt_binary (rs->buf, i + buf_len) < 0
8888 || getpkt_sane (&rs->buf, &rs->buf_size, 0) < 0
8889 || packet_ok (rs->buf, packet) != PACKET_OK)
8890 return TARGET_XFER_E_IO;
8892 unpack_varlen_hex (rs->buf, &n);
8895 return TARGET_XFER_OK;
8898 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
8899 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
8900 number of bytes read is returned, or 0 for EOF, or -1 for error.
8901 The number of bytes read may be less than LEN without indicating an
8902 EOF. PACKET is checked and updated to indicate whether the remote
8903 target supports this object. */
8905 static enum target_xfer_status
8906 remote_read_qxfer (struct target_ops *ops, const char *object_name,
8908 gdb_byte *readbuf, ULONGEST offset, LONGEST len,
8909 ULONGEST *xfered_len,
8910 struct packet_config *packet)
8912 struct remote_state *rs = get_remote_state ();
8913 LONGEST i, n, packet_len;
8915 if (packet->support == PACKET_DISABLE)
8916 return TARGET_XFER_E_IO;
8918 /* Check whether we've cached an end-of-object packet that matches
8920 if (rs->finished_object)
8922 if (strcmp (object_name, rs->finished_object) == 0
8923 && strcmp (annex ? annex : "", rs->finished_annex) == 0
8924 && offset == rs->finished_offset)
8925 return TARGET_XFER_EOF;
8928 /* Otherwise, we're now reading something different. Discard
8930 xfree (rs->finished_object);
8931 xfree (rs->finished_annex);
8932 rs->finished_object = NULL;
8933 rs->finished_annex = NULL;
8936 /* Request only enough to fit in a single packet. The actual data
8937 may not, since we don't know how much of it will need to be escaped;
8938 the target is free to respond with slightly less data. We subtract
8939 five to account for the response type and the protocol frame. */
8940 n = min (get_remote_packet_size () - 5, len);
8941 snprintf (rs->buf, get_remote_packet_size () - 4, "qXfer:%s:read:%s:%s,%s",
8942 object_name, annex ? annex : "",
8943 phex_nz (offset, sizeof offset),
8944 phex_nz (n, sizeof n));
8945 i = putpkt (rs->buf);
8947 return TARGET_XFER_E_IO;
8950 packet_len = getpkt_sane (&rs->buf, &rs->buf_size, 0);
8951 if (packet_len < 0 || packet_ok (rs->buf, packet) != PACKET_OK)
8952 return TARGET_XFER_E_IO;
8954 if (rs->buf[0] != 'l' && rs->buf[0] != 'm')
8955 error (_("Unknown remote qXfer reply: %s"), rs->buf);
8957 /* 'm' means there is (or at least might be) more data after this
8958 batch. That does not make sense unless there's at least one byte
8959 of data in this reply. */
8960 if (rs->buf[0] == 'm' && packet_len == 1)
8961 error (_("Remote qXfer reply contained no data."));
8963 /* Got some data. */
8964 i = remote_unescape_input ((gdb_byte *) rs->buf + 1,
8965 packet_len - 1, readbuf, n);
8967 /* 'l' is an EOF marker, possibly including a final block of data,
8968 or possibly empty. If we have the final block of a non-empty
8969 object, record this fact to bypass a subsequent partial read. */
8970 if (rs->buf[0] == 'l' && offset + i > 0)
8972 rs->finished_object = xstrdup (object_name);
8973 rs->finished_annex = xstrdup (annex ? annex : "");
8974 rs->finished_offset = offset + i;
8978 return TARGET_XFER_EOF;
8982 return TARGET_XFER_OK;
8986 static enum target_xfer_status
8987 remote_xfer_partial (struct target_ops *ops, enum target_object object,
8988 const char *annex, gdb_byte *readbuf,
8989 const gdb_byte *writebuf, ULONGEST offset, ULONGEST len,
8990 ULONGEST *xfered_len)
8992 struct remote_state *rs;
8997 set_remote_traceframe ();
8998 set_general_thread (inferior_ptid);
9000 rs = get_remote_state ();
9002 /* Handle memory using the standard memory routines. */
9003 if (object == TARGET_OBJECT_MEMORY)
9005 /* If the remote target is connected but not running, we should
9006 pass this request down to a lower stratum (e.g. the executable
9008 if (!target_has_execution)
9009 return TARGET_XFER_EOF;
9011 if (writebuf != NULL)
9012 return remote_write_bytes (offset, writebuf, len, xfered_len);
9014 return remote_read_bytes (ops, offset, readbuf, len, xfered_len);
9017 /* Handle SPU memory using qxfer packets. */
9018 if (object == TARGET_OBJECT_SPU)
9021 return remote_read_qxfer (ops, "spu", annex, readbuf, offset, len,
9022 xfered_len, &remote_protocol_packets
9023 [PACKET_qXfer_spu_read]);
9025 return remote_write_qxfer (ops, "spu", annex, writebuf, offset, len,
9026 xfered_len, &remote_protocol_packets
9027 [PACKET_qXfer_spu_write]);
9030 /* Handle extra signal info using qxfer packets. */
9031 if (object == TARGET_OBJECT_SIGNAL_INFO)
9034 return remote_read_qxfer (ops, "siginfo", annex, readbuf, offset, len,
9035 xfered_len, &remote_protocol_packets
9036 [PACKET_qXfer_siginfo_read]);
9038 return remote_write_qxfer (ops, "siginfo", annex,
9039 writebuf, offset, len, xfered_len,
9040 &remote_protocol_packets
9041 [PACKET_qXfer_siginfo_write]);
9044 if (object == TARGET_OBJECT_STATIC_TRACE_DATA)
9047 return remote_read_qxfer (ops, "statictrace", annex,
9048 readbuf, offset, len, xfered_len,
9049 &remote_protocol_packets
9050 [PACKET_qXfer_statictrace_read]);
9052 return TARGET_XFER_E_IO;
9055 /* Only handle flash writes. */
9056 if (writebuf != NULL)
9062 case TARGET_OBJECT_FLASH:
9063 return remote_flash_write (ops, offset, len, xfered_len,
9067 return TARGET_XFER_E_IO;
9071 /* Map pre-existing objects onto letters. DO NOT do this for new
9072 objects!!! Instead specify new query packets. */
9075 case TARGET_OBJECT_AVR:
9079 case TARGET_OBJECT_AUXV:
9080 gdb_assert (annex == NULL);
9081 return remote_read_qxfer (ops, "auxv", annex, readbuf, offset, len,
9083 &remote_protocol_packets[PACKET_qXfer_auxv]);
9085 case TARGET_OBJECT_AVAILABLE_FEATURES:
9086 return remote_read_qxfer
9087 (ops, "features", annex, readbuf, offset, len, xfered_len,
9088 &remote_protocol_packets[PACKET_qXfer_features]);
9090 case TARGET_OBJECT_LIBRARIES:
9091 return remote_read_qxfer
9092 (ops, "libraries", annex, readbuf, offset, len, xfered_len,
9093 &remote_protocol_packets[PACKET_qXfer_libraries]);
9095 case TARGET_OBJECT_LIBRARIES_SVR4:
9096 return remote_read_qxfer
9097 (ops, "libraries-svr4", annex, readbuf, offset, len, xfered_len,
9098 &remote_protocol_packets[PACKET_qXfer_libraries_svr4]);
9100 case TARGET_OBJECT_MEMORY_MAP:
9101 gdb_assert (annex == NULL);
9102 return remote_read_qxfer (ops, "memory-map", annex, readbuf, offset, len,
9104 &remote_protocol_packets[PACKET_qXfer_memory_map]);
9106 case TARGET_OBJECT_OSDATA:
9107 /* Should only get here if we're connected. */
9108 gdb_assert (rs->remote_desc);
9109 return remote_read_qxfer
9110 (ops, "osdata", annex, readbuf, offset, len, xfered_len,
9111 &remote_protocol_packets[PACKET_qXfer_osdata]);
9113 case TARGET_OBJECT_THREADS:
9114 gdb_assert (annex == NULL);
9115 return remote_read_qxfer (ops, "threads", annex, readbuf, offset, len,
9117 &remote_protocol_packets[PACKET_qXfer_threads]);
9119 case TARGET_OBJECT_TRACEFRAME_INFO:
9120 gdb_assert (annex == NULL);
9121 return remote_read_qxfer
9122 (ops, "traceframe-info", annex, readbuf, offset, len, xfered_len,
9123 &remote_protocol_packets[PACKET_qXfer_traceframe_info]);
9125 case TARGET_OBJECT_FDPIC:
9126 return remote_read_qxfer (ops, "fdpic", annex, readbuf, offset, len,
9128 &remote_protocol_packets[PACKET_qXfer_fdpic]);
9130 case TARGET_OBJECT_OPENVMS_UIB:
9131 return remote_read_qxfer (ops, "uib", annex, readbuf, offset, len,
9133 &remote_protocol_packets[PACKET_qXfer_uib]);
9135 case TARGET_OBJECT_BTRACE:
9136 return remote_read_qxfer (ops, "btrace", annex, readbuf, offset, len,
9138 &remote_protocol_packets[PACKET_qXfer_btrace]);
9140 case TARGET_OBJECT_BTRACE_CONF:
9141 return remote_read_qxfer (ops, "btrace-conf", annex, readbuf, offset,
9143 &remote_protocol_packets[PACKET_qXfer_btrace_conf]);
9145 case TARGET_OBJECT_EXEC_FILE:
9146 return remote_read_qxfer (ops, "exec-file", annex, readbuf, offset,
9148 &remote_protocol_packets[PACKET_qXfer_exec_file]);
9151 return TARGET_XFER_E_IO;
9154 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
9155 large enough let the caller deal with it. */
9156 if (len < get_remote_packet_size ())
9157 return TARGET_XFER_E_IO;
9158 len = get_remote_packet_size ();
9160 /* Except for querying the minimum buffer size, target must be open. */
9161 if (!rs->remote_desc)
9162 error (_("remote query is only available after target open"));
9164 gdb_assert (annex != NULL);
9165 gdb_assert (readbuf != NULL);
9171 /* We used one buffer char for the remote protocol q command and
9172 another for the query type. As the remote protocol encapsulation
9173 uses 4 chars plus one extra in case we are debugging
9174 (remote_debug), we have PBUFZIZ - 7 left to pack the query
9177 while (annex[i] && (i < (get_remote_packet_size () - 8)))
9179 /* Bad caller may have sent forbidden characters. */
9180 gdb_assert (isprint (annex[i]) && annex[i] != '$' && annex[i] != '#');
9185 gdb_assert (annex[i] == '\0');
9187 i = putpkt (rs->buf);
9189 return TARGET_XFER_E_IO;
9191 getpkt (&rs->buf, &rs->buf_size, 0);
9192 strcpy ((char *) readbuf, rs->buf);
9194 *xfered_len = strlen ((char *) readbuf);
9195 return TARGET_XFER_OK;
9199 remote_search_memory (struct target_ops* ops,
9200 CORE_ADDR start_addr, ULONGEST search_space_len,
9201 const gdb_byte *pattern, ULONGEST pattern_len,
9202 CORE_ADDR *found_addrp)
9204 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
9205 struct remote_state *rs = get_remote_state ();
9206 int max_size = get_memory_write_packet_size ();
9207 struct packet_config *packet =
9208 &remote_protocol_packets[PACKET_qSearch_memory];
9209 /* Number of packet bytes used to encode the pattern;
9210 this could be more than PATTERN_LEN due to escape characters. */
9211 int escaped_pattern_len;
9212 /* Amount of pattern that was encodable in the packet. */
9213 int used_pattern_len;
9216 ULONGEST found_addr;
9218 /* Don't go to the target if we don't have to.
9219 This is done before checking packet->support to avoid the possibility that
9220 a success for this edge case means the facility works in general. */
9221 if (pattern_len > search_space_len)
9223 if (pattern_len == 0)
9225 *found_addrp = start_addr;
9229 /* If we already know the packet isn't supported, fall back to the simple
9230 way of searching memory. */
9232 if (packet_config_support (packet) == PACKET_DISABLE)
9234 /* Target doesn't provided special support, fall back and use the
9235 standard support (copy memory and do the search here). */
9236 return simple_search_memory (ops, start_addr, search_space_len,
9237 pattern, pattern_len, found_addrp);
9240 /* Make sure the remote is pointing at the right process. */
9241 set_general_process ();
9243 /* Insert header. */
9244 i = snprintf (rs->buf, max_size,
9245 "qSearch:memory:%s;%s;",
9246 phex_nz (start_addr, addr_size),
9247 phex_nz (search_space_len, sizeof (search_space_len)));
9248 max_size -= (i + 1);
9250 /* Escape as much data as fits into rs->buf. */
9251 escaped_pattern_len =
9252 remote_escape_output (pattern, pattern_len, (gdb_byte *) rs->buf + i,
9253 &used_pattern_len, max_size);
9255 /* Bail if the pattern is too large. */
9256 if (used_pattern_len != pattern_len)
9257 error (_("Pattern is too large to transmit to remote target."));
9259 if (putpkt_binary (rs->buf, i + escaped_pattern_len) < 0
9260 || getpkt_sane (&rs->buf, &rs->buf_size, 0) < 0
9261 || packet_ok (rs->buf, packet) != PACKET_OK)
9263 /* The request may not have worked because the command is not
9264 supported. If so, fall back to the simple way. */
9265 if (packet->support == PACKET_DISABLE)
9267 return simple_search_memory (ops, start_addr, search_space_len,
9268 pattern, pattern_len, found_addrp);
9273 if (rs->buf[0] == '0')
9275 else if (rs->buf[0] == '1')
9278 if (rs->buf[1] != ',')
9279 error (_("Unknown qSearch:memory reply: %s"), rs->buf);
9280 unpack_varlen_hex (rs->buf + 2, &found_addr);
9281 *found_addrp = found_addr;
9284 error (_("Unknown qSearch:memory reply: %s"), rs->buf);
9290 remote_rcmd (struct target_ops *self, const char *command,
9291 struct ui_file *outbuf)
9293 struct remote_state *rs = get_remote_state ();
9296 if (!rs->remote_desc)
9297 error (_("remote rcmd is only available after target open"));
9299 /* Send a NULL command across as an empty command. */
9300 if (command == NULL)
9303 /* The query prefix. */
9304 strcpy (rs->buf, "qRcmd,");
9305 p = strchr (rs->buf, '\0');
9307 if ((strlen (rs->buf) + strlen (command) * 2 + 8/*misc*/)
9308 > get_remote_packet_size ())
9309 error (_("\"monitor\" command ``%s'' is too long."), command);
9311 /* Encode the actual command. */
9312 bin2hex ((const gdb_byte *) command, p, strlen (command));
9314 if (putpkt (rs->buf) < 0)
9315 error (_("Communication problem with target."));
9317 /* get/display the response */
9322 /* XXX - see also remote_get_noisy_reply(). */
9323 QUIT; /* Allow user to bail out with ^C. */
9325 if (getpkt_sane (&rs->buf, &rs->buf_size, 0) == -1)
9327 /* Timeout. Continue to (try to) read responses.
9328 This is better than stopping with an error, assuming the stub
9329 is still executing the (long) monitor command.
9330 If needed, the user can interrupt gdb using C-c, obtaining
9331 an effect similar to stop on timeout. */
9336 error (_("Target does not support this command."));
9337 if (buf[0] == 'O' && buf[1] != 'K')
9339 remote_console_output (buf + 1); /* 'O' message from stub. */
9342 if (strcmp (buf, "OK") == 0)
9344 if (strlen (buf) == 3 && buf[0] == 'E'
9345 && isdigit (buf[1]) && isdigit (buf[2]))
9347 error (_("Protocol error with Rcmd"));
9349 for (p = buf; p[0] != '\0' && p[1] != '\0'; p += 2)
9351 char c = (fromhex (p[0]) << 4) + fromhex (p[1]);
9353 fputc_unfiltered (c, outbuf);
9359 static VEC(mem_region_s) *
9360 remote_memory_map (struct target_ops *ops)
9362 VEC(mem_region_s) *result = NULL;
9363 char *text = target_read_stralloc (¤t_target,
9364 TARGET_OBJECT_MEMORY_MAP, NULL);
9368 struct cleanup *back_to = make_cleanup (xfree, text);
9370 result = parse_memory_map (text);
9371 do_cleanups (back_to);
9378 packet_command (char *args, int from_tty)
9380 struct remote_state *rs = get_remote_state ();
9382 if (!rs->remote_desc)
9383 error (_("command can only be used with remote target"));
9386 error (_("remote-packet command requires packet text as argument"));
9388 puts_filtered ("sending: ");
9389 print_packet (args);
9390 puts_filtered ("\n");
9393 getpkt (&rs->buf, &rs->buf_size, 0);
9394 puts_filtered ("received: ");
9395 print_packet (rs->buf);
9396 puts_filtered ("\n");
9400 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
9402 static void display_thread_info (struct gdb_ext_thread_info *info);
9404 static void threadset_test_cmd (char *cmd, int tty);
9406 static void threadalive_test (char *cmd, int tty);
9408 static void threadlist_test_cmd (char *cmd, int tty);
9410 int get_and_display_threadinfo (threadref *ref);
9412 static void threadinfo_test_cmd (char *cmd, int tty);
9414 static int thread_display_step (threadref *ref, void *context);
9416 static void threadlist_update_test_cmd (char *cmd, int tty);
9418 static void init_remote_threadtests (void);
9420 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
9423 threadset_test_cmd (char *cmd, int tty)
9425 int sample_thread = SAMPLE_THREAD;
9427 printf_filtered (_("Remote threadset test\n"));
9428 set_general_thread (sample_thread);
9433 threadalive_test (char *cmd, int tty)
9435 int sample_thread = SAMPLE_THREAD;
9436 int pid = ptid_get_pid (inferior_ptid);
9437 ptid_t ptid = ptid_build (pid, sample_thread, 0);
9439 if (remote_thread_alive (ptid))
9440 printf_filtered ("PASS: Thread alive test\n");
9442 printf_filtered ("FAIL: Thread alive test\n");
9445 void output_threadid (char *title, threadref *ref);
9448 output_threadid (char *title, threadref *ref)
9452 pack_threadid (&hexid[0], ref); /* Convert threead id into hex. */
9454 printf_filtered ("%s %s\n", title, (&hexid[0]));
9458 threadlist_test_cmd (char *cmd, int tty)
9461 threadref nextthread;
9462 int done, result_count;
9463 threadref threadlist[3];
9465 printf_filtered ("Remote Threadlist test\n");
9466 if (!remote_get_threadlist (startflag, &nextthread, 3, &done,
9467 &result_count, &threadlist[0]))
9468 printf_filtered ("FAIL: threadlist test\n");
9471 threadref *scan = threadlist;
9472 threadref *limit = scan + result_count;
9474 while (scan < limit)
9475 output_threadid (" thread ", scan++);
9480 display_thread_info (struct gdb_ext_thread_info *info)
9482 output_threadid ("Threadid: ", &info->threadid);
9483 printf_filtered ("Name: %s\n ", info->shortname);
9484 printf_filtered ("State: %s\n", info->display);
9485 printf_filtered ("other: %s\n\n", info->more_display);
9489 get_and_display_threadinfo (threadref *ref)
9493 struct gdb_ext_thread_info threadinfo;
9495 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
9496 | TAG_MOREDISPLAY | TAG_DISPLAY;
9497 if (0 != (result = remote_get_threadinfo (ref, set, &threadinfo)))
9498 display_thread_info (&threadinfo);
9503 threadinfo_test_cmd (char *cmd, int tty)
9505 int athread = SAMPLE_THREAD;
9509 int_to_threadref (&thread, athread);
9510 printf_filtered ("Remote Threadinfo test\n");
9511 if (!get_and_display_threadinfo (&thread))
9512 printf_filtered ("FAIL cannot get thread info\n");
9516 thread_display_step (threadref *ref, void *context)
9518 /* output_threadid(" threadstep ",ref); *//* simple test */
9519 return get_and_display_threadinfo (ref);
9523 threadlist_update_test_cmd (char *cmd, int tty)
9525 printf_filtered ("Remote Threadlist update test\n");
9526 remote_threadlist_iterator (thread_display_step, 0, CRAZY_MAX_THREADS);
9530 init_remote_threadtests (void)
9532 add_com ("tlist", class_obscure, threadlist_test_cmd,
9533 _("Fetch and print the remote list of "
9534 "thread identifiers, one pkt only"));
9535 add_com ("tinfo", class_obscure, threadinfo_test_cmd,
9536 _("Fetch and display info about one thread"));
9537 add_com ("tset", class_obscure, threadset_test_cmd,
9538 _("Test setting to a different thread"));
9539 add_com ("tupd", class_obscure, threadlist_update_test_cmd,
9540 _("Iterate through updating all remote thread info"));
9541 add_com ("talive", class_obscure, threadalive_test,
9542 _(" Remote thread alive test "));
9547 /* Convert a thread ID to a string. Returns the string in a static
9551 remote_pid_to_str (struct target_ops *ops, ptid_t ptid)
9553 static char buf[64];
9554 struct remote_state *rs = get_remote_state ();
9556 if (ptid_equal (ptid, null_ptid))
9557 return normal_pid_to_str (ptid);
9558 else if (ptid_is_pid (ptid))
9560 /* Printing an inferior target id. */
9562 /* When multi-process extensions are off, there's no way in the
9563 remote protocol to know the remote process id, if there's any
9564 at all. There's one exception --- when we're connected with
9565 target extended-remote, and we manually attached to a process
9566 with "attach PID". We don't record anywhere a flag that
9567 allows us to distinguish that case from the case of
9568 connecting with extended-remote and the stub already being
9569 attached to a process, and reporting yes to qAttached, hence
9570 no smart special casing here. */
9571 if (!remote_multi_process_p (rs))
9573 xsnprintf (buf, sizeof buf, "Remote target");
9577 return normal_pid_to_str (ptid);
9581 if (ptid_equal (magic_null_ptid, ptid))
9582 xsnprintf (buf, sizeof buf, "Thread <main>");
9583 else if (rs->extended && remote_multi_process_p (rs))
9584 if (ptid_get_lwp (ptid) == 0)
9585 return normal_pid_to_str (ptid);
9587 xsnprintf (buf, sizeof buf, "Thread %d.%ld",
9588 ptid_get_pid (ptid), ptid_get_lwp (ptid));
9590 xsnprintf (buf, sizeof buf, "Thread %ld",
9591 ptid_get_lwp (ptid));
9596 /* Get the address of the thread local variable in OBJFILE which is
9597 stored at OFFSET within the thread local storage for thread PTID. */
9600 remote_get_thread_local_address (struct target_ops *ops,
9601 ptid_t ptid, CORE_ADDR lm, CORE_ADDR offset)
9603 if (packet_support (PACKET_qGetTLSAddr) != PACKET_DISABLE)
9605 struct remote_state *rs = get_remote_state ();
9607 char *endp = rs->buf + get_remote_packet_size ();
9608 enum packet_result result;
9610 strcpy (p, "qGetTLSAddr:");
9612 p = write_ptid (p, endp, ptid);
9614 p += hexnumstr (p, offset);
9616 p += hexnumstr (p, lm);
9620 getpkt (&rs->buf, &rs->buf_size, 0);
9621 result = packet_ok (rs->buf,
9622 &remote_protocol_packets[PACKET_qGetTLSAddr]);
9623 if (result == PACKET_OK)
9627 unpack_varlen_hex (rs->buf, &result);
9630 else if (result == PACKET_UNKNOWN)
9631 throw_error (TLS_GENERIC_ERROR,
9632 _("Remote target doesn't support qGetTLSAddr packet"));
9634 throw_error (TLS_GENERIC_ERROR,
9635 _("Remote target failed to process qGetTLSAddr request"));
9638 throw_error (TLS_GENERIC_ERROR,
9639 _("TLS not supported or disabled on this target"));
9644 /* Provide thread local base, i.e. Thread Information Block address.
9645 Returns 1 if ptid is found and thread_local_base is non zero. */
9648 remote_get_tib_address (struct target_ops *self, ptid_t ptid, CORE_ADDR *addr)
9650 if (packet_support (PACKET_qGetTIBAddr) != PACKET_DISABLE)
9652 struct remote_state *rs = get_remote_state ();
9654 char *endp = rs->buf + get_remote_packet_size ();
9655 enum packet_result result;
9657 strcpy (p, "qGetTIBAddr:");
9659 p = write_ptid (p, endp, ptid);
9663 getpkt (&rs->buf, &rs->buf_size, 0);
9664 result = packet_ok (rs->buf,
9665 &remote_protocol_packets[PACKET_qGetTIBAddr]);
9666 if (result == PACKET_OK)
9670 unpack_varlen_hex (rs->buf, &result);
9672 *addr = (CORE_ADDR) result;
9675 else if (result == PACKET_UNKNOWN)
9676 error (_("Remote target doesn't support qGetTIBAddr packet"));
9678 error (_("Remote target failed to process qGetTIBAddr request"));
9681 error (_("qGetTIBAddr not supported or disabled on this target"));
9686 /* Support for inferring a target description based on the current
9687 architecture and the size of a 'g' packet. While the 'g' packet
9688 can have any size (since optional registers can be left off the
9689 end), some sizes are easily recognizable given knowledge of the
9690 approximate architecture. */
9692 struct remote_g_packet_guess
9695 const struct target_desc *tdesc;
9697 typedef struct remote_g_packet_guess remote_g_packet_guess_s;
9698 DEF_VEC_O(remote_g_packet_guess_s);
9700 struct remote_g_packet_data
9702 VEC(remote_g_packet_guess_s) *guesses;
9705 static struct gdbarch_data *remote_g_packet_data_handle;
9708 remote_g_packet_data_init (struct obstack *obstack)
9710 return OBSTACK_ZALLOC (obstack, struct remote_g_packet_data);
9714 register_remote_g_packet_guess (struct gdbarch *gdbarch, int bytes,
9715 const struct target_desc *tdesc)
9717 struct remote_g_packet_data *data
9718 = gdbarch_data (gdbarch, remote_g_packet_data_handle);
9719 struct remote_g_packet_guess new_guess, *guess;
9722 gdb_assert (tdesc != NULL);
9725 VEC_iterate (remote_g_packet_guess_s, data->guesses, ix, guess);
9727 if (guess->bytes == bytes)
9728 internal_error (__FILE__, __LINE__,
9729 _("Duplicate g packet description added for size %d"),
9732 new_guess.bytes = bytes;
9733 new_guess.tdesc = tdesc;
9734 VEC_safe_push (remote_g_packet_guess_s, data->guesses, &new_guess);
9737 /* Return 1 if remote_read_description would do anything on this target
9738 and architecture, 0 otherwise. */
9741 remote_read_description_p (struct target_ops *target)
9743 struct remote_g_packet_data *data
9744 = gdbarch_data (target_gdbarch (), remote_g_packet_data_handle);
9746 if (!VEC_empty (remote_g_packet_guess_s, data->guesses))
9752 static const struct target_desc *
9753 remote_read_description (struct target_ops *target)
9755 struct remote_g_packet_data *data
9756 = gdbarch_data (target_gdbarch (), remote_g_packet_data_handle);
9758 /* Do not try this during initial connection, when we do not know
9759 whether there is a running but stopped thread. */
9760 if (!target_has_execution || ptid_equal (inferior_ptid, null_ptid))
9761 return target->beneath->to_read_description (target->beneath);
9763 if (!VEC_empty (remote_g_packet_guess_s, data->guesses))
9765 struct remote_g_packet_guess *guess;
9767 int bytes = send_g_packet ();
9770 VEC_iterate (remote_g_packet_guess_s, data->guesses, ix, guess);
9772 if (guess->bytes == bytes)
9773 return guess->tdesc;
9775 /* We discard the g packet. A minor optimization would be to
9776 hold on to it, and fill the register cache once we have selected
9777 an architecture, but it's too tricky to do safely. */
9780 return target->beneath->to_read_description (target->beneath);
9783 /* Remote file transfer support. This is host-initiated I/O, not
9784 target-initiated; for target-initiated, see remote-fileio.c. */
9786 /* If *LEFT is at least the length of STRING, copy STRING to
9787 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9788 decrease *LEFT. Otherwise raise an error. */
9791 remote_buffer_add_string (char **buffer, int *left, char *string)
9793 int len = strlen (string);
9796 error (_("Packet too long for target."));
9798 memcpy (*buffer, string, len);
9802 /* NUL-terminate the buffer as a convenience, if there is
9808 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
9809 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9810 decrease *LEFT. Otherwise raise an error. */
9813 remote_buffer_add_bytes (char **buffer, int *left, const gdb_byte *bytes,
9816 if (2 * len > *left)
9817 error (_("Packet too long for target."));
9819 bin2hex (bytes, *buffer, len);
9823 /* NUL-terminate the buffer as a convenience, if there is
9829 /* If *LEFT is large enough, convert VALUE to hex and add it to
9830 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9831 decrease *LEFT. Otherwise raise an error. */
9834 remote_buffer_add_int (char **buffer, int *left, ULONGEST value)
9836 int len = hexnumlen (value);
9839 error (_("Packet too long for target."));
9841 hexnumstr (*buffer, value);
9845 /* NUL-terminate the buffer as a convenience, if there is
9851 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
9852 value, *REMOTE_ERRNO to the remote error number or zero if none
9853 was included, and *ATTACHMENT to point to the start of the annex
9854 if any. The length of the packet isn't needed here; there may
9855 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
9857 Return 0 if the packet could be parsed, -1 if it could not. If
9858 -1 is returned, the other variables may not be initialized. */
9861 remote_hostio_parse_result (char *buffer, int *retcode,
9862 int *remote_errno, char **attachment)
9869 if (buffer[0] != 'F')
9873 *retcode = strtol (&buffer[1], &p, 16);
9874 if (errno != 0 || p == &buffer[1])
9877 /* Check for ",errno". */
9881 *remote_errno = strtol (p + 1, &p2, 16);
9882 if (errno != 0 || p + 1 == p2)
9887 /* Check for ";attachment". If there is no attachment, the
9888 packet should end here. */
9891 *attachment = p + 1;
9894 else if (*p == '\0')
9900 /* Send a prepared I/O packet to the target and read its response.
9901 The prepared packet is in the global RS->BUF before this function
9902 is called, and the answer is there when we return.
9904 COMMAND_BYTES is the length of the request to send, which may include
9905 binary data. WHICH_PACKET is the packet configuration to check
9906 before attempting a packet. If an error occurs, *REMOTE_ERRNO
9907 is set to the error number and -1 is returned. Otherwise the value
9908 returned by the function is returned.
9910 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
9911 attachment is expected; an error will be reported if there's a
9912 mismatch. If one is found, *ATTACHMENT will be set to point into
9913 the packet buffer and *ATTACHMENT_LEN will be set to the
9914 attachment's length. */
9917 remote_hostio_send_command (int command_bytes, int which_packet,
9918 int *remote_errno, char **attachment,
9919 int *attachment_len)
9921 struct remote_state *rs = get_remote_state ();
9922 int ret, bytes_read;
9923 char *attachment_tmp;
9925 if (!rs->remote_desc
9926 || packet_support (which_packet) == PACKET_DISABLE)
9928 *remote_errno = FILEIO_ENOSYS;
9932 putpkt_binary (rs->buf, command_bytes);
9933 bytes_read = getpkt_sane (&rs->buf, &rs->buf_size, 0);
9935 /* If it timed out, something is wrong. Don't try to parse the
9939 *remote_errno = FILEIO_EINVAL;
9943 switch (packet_ok (rs->buf, &remote_protocol_packets[which_packet]))
9946 *remote_errno = FILEIO_EINVAL;
9948 case PACKET_UNKNOWN:
9949 *remote_errno = FILEIO_ENOSYS;
9955 if (remote_hostio_parse_result (rs->buf, &ret, remote_errno,
9958 *remote_errno = FILEIO_EINVAL;
9962 /* Make sure we saw an attachment if and only if we expected one. */
9963 if ((attachment_tmp == NULL && attachment != NULL)
9964 || (attachment_tmp != NULL && attachment == NULL))
9966 *remote_errno = FILEIO_EINVAL;
9970 /* If an attachment was found, it must point into the packet buffer;
9971 work out how many bytes there were. */
9972 if (attachment_tmp != NULL)
9974 *attachment = attachment_tmp;
9975 *attachment_len = bytes_read - (*attachment - rs->buf);
9981 /* Return nonzero if the filesystem accessed by the target_fileio_*
9982 methods is the local filesystem, zero otherwise. */
9985 remote_filesystem_is_local (struct target_ops *self)
9990 /* Open FILENAME on the remote target, using FLAGS and MODE. Return a
9991 remote file descriptor, or -1 if an error occurs (and set
9995 remote_hostio_open (struct target_ops *self,
9996 const char *filename, int flags, int mode,
9999 struct remote_state *rs = get_remote_state ();
10001 int left = get_remote_packet_size () - 1;
10003 remote_buffer_add_string (&p, &left, "vFile:open:");
10005 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
10006 strlen (filename));
10007 remote_buffer_add_string (&p, &left, ",");
10009 remote_buffer_add_int (&p, &left, flags);
10010 remote_buffer_add_string (&p, &left, ",");
10012 remote_buffer_add_int (&p, &left, mode);
10014 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_open,
10015 remote_errno, NULL, NULL);
10018 /* Write up to LEN bytes from WRITE_BUF to FD on the remote target.
10019 Return the number of bytes written, or -1 if an error occurs (and
10020 set *REMOTE_ERRNO). */
10023 remote_hostio_pwrite (struct target_ops *self,
10024 int fd, const gdb_byte *write_buf, int len,
10025 ULONGEST offset, int *remote_errno)
10027 struct remote_state *rs = get_remote_state ();
10029 int left = get_remote_packet_size ();
10032 remote_buffer_add_string (&p, &left, "vFile:pwrite:");
10034 remote_buffer_add_int (&p, &left, fd);
10035 remote_buffer_add_string (&p, &left, ",");
10037 remote_buffer_add_int (&p, &left, offset);
10038 remote_buffer_add_string (&p, &left, ",");
10040 p += remote_escape_output (write_buf, len, (gdb_byte *) p, &out_len,
10041 get_remote_packet_size () - (p - rs->buf));
10043 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_pwrite,
10044 remote_errno, NULL, NULL);
10047 /* Read up to LEN bytes FD on the remote target into READ_BUF
10048 Return the number of bytes read, or -1 if an error occurs (and
10049 set *REMOTE_ERRNO). */
10052 remote_hostio_pread (struct target_ops *self,
10053 int fd, gdb_byte *read_buf, int len,
10054 ULONGEST offset, int *remote_errno)
10056 struct remote_state *rs = get_remote_state ();
10059 int left = get_remote_packet_size ();
10060 int ret, attachment_len;
10063 remote_buffer_add_string (&p, &left, "vFile:pread:");
10065 remote_buffer_add_int (&p, &left, fd);
10066 remote_buffer_add_string (&p, &left, ",");
10068 remote_buffer_add_int (&p, &left, len);
10069 remote_buffer_add_string (&p, &left, ",");
10071 remote_buffer_add_int (&p, &left, offset);
10073 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_pread,
10074 remote_errno, &attachment,
10080 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
10082 if (read_len != ret)
10083 error (_("Read returned %d, but %d bytes."), ret, (int) read_len);
10088 /* Close FD on the remote target. Return 0, or -1 if an error occurs
10089 (and set *REMOTE_ERRNO). */
10092 remote_hostio_close (struct target_ops *self, int fd, int *remote_errno)
10094 struct remote_state *rs = get_remote_state ();
10096 int left = get_remote_packet_size () - 1;
10098 remote_buffer_add_string (&p, &left, "vFile:close:");
10100 remote_buffer_add_int (&p, &left, fd);
10102 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_close,
10103 remote_errno, NULL, NULL);
10106 /* Unlink FILENAME on the remote target. Return 0, or -1 if an error
10107 occurs (and set *REMOTE_ERRNO). */
10110 remote_hostio_unlink (struct target_ops *self,
10111 const char *filename, int *remote_errno)
10113 struct remote_state *rs = get_remote_state ();
10115 int left = get_remote_packet_size () - 1;
10117 remote_buffer_add_string (&p, &left, "vFile:unlink:");
10119 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
10120 strlen (filename));
10122 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_unlink,
10123 remote_errno, NULL, NULL);
10126 /* Read value of symbolic link FILENAME on the remote target. Return
10127 a null-terminated string allocated via xmalloc, or NULL if an error
10128 occurs (and set *REMOTE_ERRNO). */
10131 remote_hostio_readlink (struct target_ops *self,
10132 const char *filename, int *remote_errno)
10134 struct remote_state *rs = get_remote_state ();
10137 int left = get_remote_packet_size ();
10138 int len, attachment_len;
10142 remote_buffer_add_string (&p, &left, "vFile:readlink:");
10144 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
10145 strlen (filename));
10147 len = remote_hostio_send_command (p - rs->buf, PACKET_vFile_readlink,
10148 remote_errno, &attachment,
10154 ret = xmalloc (len + 1);
10156 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
10157 (gdb_byte *) ret, len);
10158 if (read_len != len)
10159 error (_("Readlink returned %d, but %d bytes."), len, read_len);
10165 /* Read information about the open file FD on the remote target
10166 into ST. Return 0 on success, or -1 if an error occurs (and
10167 set *REMOTE_ERRNO). */
10170 remote_hostio_fstat (struct target_ops *self,
10171 int fd, struct stat *st,
10174 struct remote_state *rs = get_remote_state ();
10176 int left = get_remote_packet_size ();
10177 int attachment_len, ret;
10179 struct fio_stat fst;
10182 remote_buffer_add_string (&p, &left, "vFile:fstat:");
10184 remote_buffer_add_int (&p, &left, fd);
10186 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_fstat,
10187 remote_errno, &attachment,
10191 if (*remote_errno != FILEIO_ENOSYS)
10194 /* Strictly we should return -1, ENOSYS here, but when
10195 "set sysroot remote:" was implemented in August 2008
10196 BFD's need for a stat function was sidestepped with
10197 this hack. This was not remedied until March 2015
10198 so we retain the previous behavior to avoid breaking
10201 Note that the memset is a March 2015 addition; older
10202 GDBs set st_size *and nothing else* so the structure
10203 would have garbage in all other fields. This might
10204 break something but retaining the previous behavior
10205 here would be just too wrong. */
10207 memset (st, 0, sizeof (struct stat));
10208 st->st_size = INT_MAX;
10212 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
10213 (gdb_byte *) &fst, sizeof (fst));
10215 if (read_len != ret)
10216 error (_("vFile:fstat returned %d, but %d bytes."), ret, read_len);
10218 if (read_len != sizeof (fst))
10219 error (_("vFile:fstat returned %d bytes, but expecting %d."),
10220 read_len, (int) sizeof (fst));
10222 remote_fileio_to_host_stat (&fst, st);
10228 remote_fileio_errno_to_host (int errnum)
10234 case FILEIO_ENOENT:
10242 case FILEIO_EACCES:
10244 case FILEIO_EFAULT:
10248 case FILEIO_EEXIST:
10250 case FILEIO_ENODEV:
10252 case FILEIO_ENOTDIR:
10254 case FILEIO_EISDIR:
10256 case FILEIO_EINVAL:
10258 case FILEIO_ENFILE:
10260 case FILEIO_EMFILE:
10264 case FILEIO_ENOSPC:
10266 case FILEIO_ESPIPE:
10270 case FILEIO_ENOSYS:
10272 case FILEIO_ENAMETOOLONG:
10273 return ENAMETOOLONG;
10279 remote_hostio_error (int errnum)
10281 int host_error = remote_fileio_errno_to_host (errnum);
10283 if (host_error == -1)
10284 error (_("Unknown remote I/O error %d"), errnum);
10286 error (_("Remote I/O error: %s"), safe_strerror (host_error));
10290 remote_hostio_close_cleanup (void *opaque)
10292 int fd = *(int *) opaque;
10295 remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno);
10299 remote_file_put (const char *local_file, const char *remote_file, int from_tty)
10301 struct cleanup *back_to, *close_cleanup;
10302 int retcode, fd, remote_errno, bytes, io_size;
10305 int bytes_in_buffer;
10308 struct remote_state *rs = get_remote_state ();
10310 if (!rs->remote_desc)
10311 error (_("command can only be used with remote target"));
10313 file = gdb_fopen_cloexec (local_file, "rb");
10315 perror_with_name (local_file);
10316 back_to = make_cleanup_fclose (file);
10318 fd = remote_hostio_open (find_target_at (process_stratum),
10319 remote_file, (FILEIO_O_WRONLY | FILEIO_O_CREAT
10321 0700, &remote_errno);
10323 remote_hostio_error (remote_errno);
10325 /* Send up to this many bytes at once. They won't all fit in the
10326 remote packet limit, so we'll transfer slightly fewer. */
10327 io_size = get_remote_packet_size ();
10328 buffer = xmalloc (io_size);
10329 make_cleanup (xfree, buffer);
10331 close_cleanup = make_cleanup (remote_hostio_close_cleanup, &fd);
10333 bytes_in_buffer = 0;
10336 while (bytes_in_buffer || !saw_eof)
10340 bytes = fread (buffer + bytes_in_buffer, 1,
10341 io_size - bytes_in_buffer,
10346 error (_("Error reading %s."), local_file);
10349 /* EOF. Unless there is something still in the
10350 buffer from the last iteration, we are done. */
10352 if (bytes_in_buffer == 0)
10360 bytes += bytes_in_buffer;
10361 bytes_in_buffer = 0;
10363 retcode = remote_hostio_pwrite (find_target_at (process_stratum),
10365 offset, &remote_errno);
10368 remote_hostio_error (remote_errno);
10369 else if (retcode == 0)
10370 error (_("Remote write of %d bytes returned 0!"), bytes);
10371 else if (retcode < bytes)
10373 /* Short write. Save the rest of the read data for the next
10375 bytes_in_buffer = bytes - retcode;
10376 memmove (buffer, buffer + retcode, bytes_in_buffer);
10382 discard_cleanups (close_cleanup);
10383 if (remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno))
10384 remote_hostio_error (remote_errno);
10387 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file);
10388 do_cleanups (back_to);
10392 remote_file_get (const char *remote_file, const char *local_file, int from_tty)
10394 struct cleanup *back_to, *close_cleanup;
10395 int fd, remote_errno, bytes, io_size;
10399 struct remote_state *rs = get_remote_state ();
10401 if (!rs->remote_desc)
10402 error (_("command can only be used with remote target"));
10404 fd = remote_hostio_open (find_target_at (process_stratum),
10405 remote_file, FILEIO_O_RDONLY, 0, &remote_errno);
10407 remote_hostio_error (remote_errno);
10409 file = gdb_fopen_cloexec (local_file, "wb");
10411 perror_with_name (local_file);
10412 back_to = make_cleanup_fclose (file);
10414 /* Send up to this many bytes at once. They won't all fit in the
10415 remote packet limit, so we'll transfer slightly fewer. */
10416 io_size = get_remote_packet_size ();
10417 buffer = xmalloc (io_size);
10418 make_cleanup (xfree, buffer);
10420 close_cleanup = make_cleanup (remote_hostio_close_cleanup, &fd);
10425 bytes = remote_hostio_pread (find_target_at (process_stratum),
10426 fd, buffer, io_size, offset, &remote_errno);
10428 /* Success, but no bytes, means end-of-file. */
10431 remote_hostio_error (remote_errno);
10435 bytes = fwrite (buffer, 1, bytes, file);
10437 perror_with_name (local_file);
10440 discard_cleanups (close_cleanup);
10441 if (remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno))
10442 remote_hostio_error (remote_errno);
10445 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file);
10446 do_cleanups (back_to);
10450 remote_file_delete (const char *remote_file, int from_tty)
10452 int retcode, remote_errno;
10453 struct remote_state *rs = get_remote_state ();
10455 if (!rs->remote_desc)
10456 error (_("command can only be used with remote target"));
10458 retcode = remote_hostio_unlink (find_target_at (process_stratum),
10459 remote_file, &remote_errno);
10461 remote_hostio_error (remote_errno);
10464 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file);
10468 remote_put_command (char *args, int from_tty)
10470 struct cleanup *back_to;
10474 error_no_arg (_("file to put"));
10476 argv = gdb_buildargv (args);
10477 back_to = make_cleanup_freeargv (argv);
10478 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
10479 error (_("Invalid parameters to remote put"));
10481 remote_file_put (argv[0], argv[1], from_tty);
10483 do_cleanups (back_to);
10487 remote_get_command (char *args, int from_tty)
10489 struct cleanup *back_to;
10493 error_no_arg (_("file to get"));
10495 argv = gdb_buildargv (args);
10496 back_to = make_cleanup_freeargv (argv);
10497 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
10498 error (_("Invalid parameters to remote get"));
10500 remote_file_get (argv[0], argv[1], from_tty);
10502 do_cleanups (back_to);
10506 remote_delete_command (char *args, int from_tty)
10508 struct cleanup *back_to;
10512 error_no_arg (_("file to delete"));
10514 argv = gdb_buildargv (args);
10515 back_to = make_cleanup_freeargv (argv);
10516 if (argv[0] == NULL || argv[1] != NULL)
10517 error (_("Invalid parameters to remote delete"));
10519 remote_file_delete (argv[0], from_tty);
10521 do_cleanups (back_to);
10525 remote_command (char *args, int from_tty)
10527 help_list (remote_cmdlist, "remote ", all_commands, gdb_stdout);
10531 remote_can_execute_reverse (struct target_ops *self)
10533 if (packet_support (PACKET_bs) == PACKET_ENABLE
10534 || packet_support (PACKET_bc) == PACKET_ENABLE)
10541 remote_supports_non_stop (struct target_ops *self)
10547 remote_supports_disable_randomization (struct target_ops *self)
10549 /* Only supported in extended mode. */
10554 remote_supports_multi_process (struct target_ops *self)
10556 struct remote_state *rs = get_remote_state ();
10558 /* Only extended-remote handles being attached to multiple
10559 processes, even though plain remote can use the multi-process
10560 thread id extensions, so that GDB knows the target process's
10562 return rs->extended && remote_multi_process_p (rs);
10566 remote_supports_cond_tracepoints (void)
10568 return packet_support (PACKET_ConditionalTracepoints) == PACKET_ENABLE;
10572 remote_supports_cond_breakpoints (struct target_ops *self)
10574 return packet_support (PACKET_ConditionalBreakpoints) == PACKET_ENABLE;
10578 remote_supports_fast_tracepoints (void)
10580 return packet_support (PACKET_FastTracepoints) == PACKET_ENABLE;
10584 remote_supports_static_tracepoints (void)
10586 return packet_support (PACKET_StaticTracepoints) == PACKET_ENABLE;
10590 remote_supports_install_in_trace (void)
10592 return packet_support (PACKET_InstallInTrace) == PACKET_ENABLE;
10596 remote_supports_enable_disable_tracepoint (struct target_ops *self)
10598 return (packet_support (PACKET_EnableDisableTracepoints_feature)
10603 remote_supports_string_tracing (struct target_ops *self)
10605 return packet_support (PACKET_tracenz_feature) == PACKET_ENABLE;
10609 remote_can_run_breakpoint_commands (struct target_ops *self)
10611 return packet_support (PACKET_BreakpointCommands) == PACKET_ENABLE;
10615 remote_trace_init (struct target_ops *self)
10618 remote_get_noisy_reply (&target_buf, &target_buf_size);
10619 if (strcmp (target_buf, "OK") != 0)
10620 error (_("Target does not support this command."));
10623 static void free_actions_list (char **actions_list);
10624 static void free_actions_list_cleanup_wrapper (void *);
10626 free_actions_list_cleanup_wrapper (void *al)
10628 free_actions_list (al);
10632 free_actions_list (char **actions_list)
10636 if (actions_list == 0)
10639 for (ndx = 0; actions_list[ndx]; ndx++)
10640 xfree (actions_list[ndx]);
10642 xfree (actions_list);
10645 /* Recursive routine to walk through command list including loops, and
10646 download packets for each command. */
10649 remote_download_command_source (int num, ULONGEST addr,
10650 struct command_line *cmds)
10652 struct remote_state *rs = get_remote_state ();
10653 struct command_line *cmd;
10655 for (cmd = cmds; cmd; cmd = cmd->next)
10657 QUIT; /* Allow user to bail out with ^C. */
10658 strcpy (rs->buf, "QTDPsrc:");
10659 encode_source_string (num, addr, "cmd", cmd->line,
10660 rs->buf + strlen (rs->buf),
10661 rs->buf_size - strlen (rs->buf));
10663 remote_get_noisy_reply (&target_buf, &target_buf_size);
10664 if (strcmp (target_buf, "OK"))
10665 warning (_("Target does not support source download."));
10667 if (cmd->control_type == while_control
10668 || cmd->control_type == while_stepping_control)
10670 remote_download_command_source (num, addr, *cmd->body_list);
10672 QUIT; /* Allow user to bail out with ^C. */
10673 strcpy (rs->buf, "QTDPsrc:");
10674 encode_source_string (num, addr, "cmd", "end",
10675 rs->buf + strlen (rs->buf),
10676 rs->buf_size - strlen (rs->buf));
10678 remote_get_noisy_reply (&target_buf, &target_buf_size);
10679 if (strcmp (target_buf, "OK"))
10680 warning (_("Target does not support source download."));
10686 remote_download_tracepoint (struct target_ops *self, struct bp_location *loc)
10688 #define BUF_SIZE 2048
10692 char buf[BUF_SIZE];
10693 char **tdp_actions;
10694 char **stepping_actions;
10696 struct cleanup *old_chain = NULL;
10697 struct agent_expr *aexpr;
10698 struct cleanup *aexpr_chain = NULL;
10700 struct breakpoint *b = loc->owner;
10701 struct tracepoint *t = (struct tracepoint *) b;
10703 encode_actions_rsp (loc, &tdp_actions, &stepping_actions);
10704 old_chain = make_cleanup (free_actions_list_cleanup_wrapper,
10706 (void) make_cleanup (free_actions_list_cleanup_wrapper,
10709 tpaddr = loc->address;
10710 sprintf_vma (addrbuf, tpaddr);
10711 xsnprintf (buf, BUF_SIZE, "QTDP:%x:%s:%c:%lx:%x", b->number,
10712 addrbuf, /* address */
10713 (b->enable_state == bp_enabled ? 'E' : 'D'),
10714 t->step_count, t->pass_count);
10715 /* Fast tracepoints are mostly handled by the target, but we can
10716 tell the target how big of an instruction block should be moved
10718 if (b->type == bp_fast_tracepoint)
10720 /* Only test for support at download time; we may not know
10721 target capabilities at definition time. */
10722 if (remote_supports_fast_tracepoints ())
10726 if (gdbarch_fast_tracepoint_valid_at (target_gdbarch (),
10727 tpaddr, &isize, NULL))
10728 xsnprintf (buf + strlen (buf), BUF_SIZE - strlen (buf), ":F%x",
10731 /* If it passed validation at definition but fails now,
10732 something is very wrong. */
10733 internal_error (__FILE__, __LINE__,
10734 _("Fast tracepoint not "
10735 "valid during download"));
10738 /* Fast tracepoints are functionally identical to regular
10739 tracepoints, so don't take lack of support as a reason to
10740 give up on the trace run. */
10741 warning (_("Target does not support fast tracepoints, "
10742 "downloading %d as regular tracepoint"), b->number);
10744 else if (b->type == bp_static_tracepoint)
10746 /* Only test for support at download time; we may not know
10747 target capabilities at definition time. */
10748 if (remote_supports_static_tracepoints ())
10750 struct static_tracepoint_marker marker;
10752 if (target_static_tracepoint_marker_at (tpaddr, &marker))
10753 strcat (buf, ":S");
10755 error (_("Static tracepoint not valid during download"));
10758 /* Fast tracepoints are functionally identical to regular
10759 tracepoints, so don't take lack of support as a reason
10760 to give up on the trace run. */
10761 error (_("Target does not support static tracepoints"));
10763 /* If the tracepoint has a conditional, make it into an agent
10764 expression and append to the definition. */
10767 /* Only test support at download time, we may not know target
10768 capabilities at definition time. */
10769 if (remote_supports_cond_tracepoints ())
10771 aexpr = gen_eval_for_expr (tpaddr, loc->cond);
10772 aexpr_chain = make_cleanup_free_agent_expr (aexpr);
10773 xsnprintf (buf + strlen (buf), BUF_SIZE - strlen (buf), ":X%x,",
10775 pkt = buf + strlen (buf);
10776 for (ndx = 0; ndx < aexpr->len; ++ndx)
10777 pkt = pack_hex_byte (pkt, aexpr->buf[ndx]);
10779 do_cleanups (aexpr_chain);
10782 warning (_("Target does not support conditional tracepoints, "
10783 "ignoring tp %d cond"), b->number);
10786 if (b->commands || *default_collect)
10789 remote_get_noisy_reply (&target_buf, &target_buf_size);
10790 if (strcmp (target_buf, "OK"))
10791 error (_("Target does not support tracepoints."));
10793 /* do_single_steps (t); */
10796 for (ndx = 0; tdp_actions[ndx]; ndx++)
10798 QUIT; /* Allow user to bail out with ^C. */
10799 xsnprintf (buf, BUF_SIZE, "QTDP:-%x:%s:%s%c",
10800 b->number, addrbuf, /* address */
10802 ((tdp_actions[ndx + 1] || stepping_actions)
10805 remote_get_noisy_reply (&target_buf,
10807 if (strcmp (target_buf, "OK"))
10808 error (_("Error on target while setting tracepoints."));
10811 if (stepping_actions)
10813 for (ndx = 0; stepping_actions[ndx]; ndx++)
10815 QUIT; /* Allow user to bail out with ^C. */
10816 xsnprintf (buf, BUF_SIZE, "QTDP:-%x:%s:%s%s%s",
10817 b->number, addrbuf, /* address */
10818 ((ndx == 0) ? "S" : ""),
10819 stepping_actions[ndx],
10820 (stepping_actions[ndx + 1] ? "-" : ""));
10822 remote_get_noisy_reply (&target_buf,
10824 if (strcmp (target_buf, "OK"))
10825 error (_("Error on target while setting tracepoints."));
10829 if (packet_support (PACKET_TracepointSource) == PACKET_ENABLE)
10831 if (b->addr_string)
10833 strcpy (buf, "QTDPsrc:");
10834 encode_source_string (b->number, loc->address,
10835 "at", b->addr_string, buf + strlen (buf),
10836 2048 - strlen (buf));
10839 remote_get_noisy_reply (&target_buf, &target_buf_size);
10840 if (strcmp (target_buf, "OK"))
10841 warning (_("Target does not support source download."));
10843 if (b->cond_string)
10845 strcpy (buf, "QTDPsrc:");
10846 encode_source_string (b->number, loc->address,
10847 "cond", b->cond_string, buf + strlen (buf),
10848 2048 - strlen (buf));
10850 remote_get_noisy_reply (&target_buf, &target_buf_size);
10851 if (strcmp (target_buf, "OK"))
10852 warning (_("Target does not support source download."));
10854 remote_download_command_source (b->number, loc->address,
10855 breakpoint_commands (b));
10858 do_cleanups (old_chain);
10862 remote_can_download_tracepoint (struct target_ops *self)
10864 struct remote_state *rs = get_remote_state ();
10865 struct trace_status *ts;
10868 /* Don't try to install tracepoints until we've relocated our
10869 symbols, and fetched and merged the target's tracepoint list with
10871 if (rs->starting_up)
10874 ts = current_trace_status ();
10875 status = remote_get_trace_status (self, ts);
10877 if (status == -1 || !ts->running_known || !ts->running)
10880 /* If we are in a tracing experiment, but remote stub doesn't support
10881 installing tracepoint in trace, we have to return. */
10882 if (!remote_supports_install_in_trace ())
10890 remote_download_trace_state_variable (struct target_ops *self,
10891 struct trace_state_variable *tsv)
10893 struct remote_state *rs = get_remote_state ();
10896 xsnprintf (rs->buf, get_remote_packet_size (), "QTDV:%x:%s:%x:",
10897 tsv->number, phex ((ULONGEST) tsv->initial_value, 8),
10899 p = rs->buf + strlen (rs->buf);
10900 if ((p - rs->buf) + strlen (tsv->name) * 2 >= get_remote_packet_size ())
10901 error (_("Trace state variable name too long for tsv definition packet"));
10902 p += 2 * bin2hex ((gdb_byte *) (tsv->name), p, strlen (tsv->name));
10905 remote_get_noisy_reply (&target_buf, &target_buf_size);
10906 if (*target_buf == '\0')
10907 error (_("Target does not support this command."));
10908 if (strcmp (target_buf, "OK") != 0)
10909 error (_("Error on target while downloading trace state variable."));
10913 remote_enable_tracepoint (struct target_ops *self,
10914 struct bp_location *location)
10916 struct remote_state *rs = get_remote_state ();
10919 sprintf_vma (addr_buf, location->address);
10920 xsnprintf (rs->buf, get_remote_packet_size (), "QTEnable:%x:%s",
10921 location->owner->number, addr_buf);
10923 remote_get_noisy_reply (&rs->buf, &rs->buf_size);
10924 if (*rs->buf == '\0')
10925 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
10926 if (strcmp (rs->buf, "OK") != 0)
10927 error (_("Error on target while enabling tracepoint."));
10931 remote_disable_tracepoint (struct target_ops *self,
10932 struct bp_location *location)
10934 struct remote_state *rs = get_remote_state ();
10937 sprintf_vma (addr_buf, location->address);
10938 xsnprintf (rs->buf, get_remote_packet_size (), "QTDisable:%x:%s",
10939 location->owner->number, addr_buf);
10941 remote_get_noisy_reply (&rs->buf, &rs->buf_size);
10942 if (*rs->buf == '\0')
10943 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
10944 if (strcmp (rs->buf, "OK") != 0)
10945 error (_("Error on target while disabling tracepoint."));
10949 remote_trace_set_readonly_regions (struct target_ops *self)
10953 bfd_size_type size;
10959 return; /* No information to give. */
10961 strcpy (target_buf, "QTro");
10962 offset = strlen (target_buf);
10963 for (s = exec_bfd->sections; s; s = s->next)
10965 char tmp1[40], tmp2[40];
10968 if ((s->flags & SEC_LOAD) == 0 ||
10969 /* (s->flags & SEC_CODE) == 0 || */
10970 (s->flags & SEC_READONLY) == 0)
10974 vma = bfd_get_section_vma (abfd, s);
10975 size = bfd_get_section_size (s);
10976 sprintf_vma (tmp1, vma);
10977 sprintf_vma (tmp2, vma + size);
10978 sec_length = 1 + strlen (tmp1) + 1 + strlen (tmp2);
10979 if (offset + sec_length + 1 > target_buf_size)
10981 if (packet_support (PACKET_qXfer_traceframe_info) != PACKET_ENABLE)
10983 Too many sections for read-only sections definition packet."));
10986 xsnprintf (target_buf + offset, target_buf_size - offset, ":%s,%s",
10988 offset += sec_length;
10992 putpkt (target_buf);
10993 getpkt (&target_buf, &target_buf_size, 0);
10998 remote_trace_start (struct target_ops *self)
11000 putpkt ("QTStart");
11001 remote_get_noisy_reply (&target_buf, &target_buf_size);
11002 if (*target_buf == '\0')
11003 error (_("Target does not support this command."));
11004 if (strcmp (target_buf, "OK") != 0)
11005 error (_("Bogus reply from target: %s"), target_buf);
11009 remote_get_trace_status (struct target_ops *self, struct trace_status *ts)
11011 /* Initialize it just to avoid a GCC false warning. */
11013 /* FIXME we need to get register block size some other way. */
11014 extern int trace_regblock_size;
11015 enum packet_result result;
11017 if (packet_support (PACKET_qTStatus) == PACKET_DISABLE)
11020 trace_regblock_size = get_remote_arch_state ()->sizeof_g_packet;
11022 putpkt ("qTStatus");
11026 p = remote_get_noisy_reply (&target_buf, &target_buf_size);
11028 CATCH (ex, RETURN_MASK_ERROR)
11030 if (ex.error != TARGET_CLOSE_ERROR)
11032 exception_fprintf (gdb_stderr, ex, "qTStatus: ");
11035 throw_exception (ex);
11039 result = packet_ok (p, &remote_protocol_packets[PACKET_qTStatus]);
11041 /* If the remote target doesn't do tracing, flag it. */
11042 if (result == PACKET_UNKNOWN)
11045 /* We're working with a live target. */
11046 ts->filename = NULL;
11049 error (_("Bogus trace status reply from target: %s"), target_buf);
11051 /* Function 'parse_trace_status' sets default value of each field of
11052 'ts' at first, so we don't have to do it here. */
11053 parse_trace_status (p, ts);
11055 return ts->running;
11059 remote_get_tracepoint_status (struct target_ops *self, struct breakpoint *bp,
11060 struct uploaded_tp *utp)
11062 struct remote_state *rs = get_remote_state ();
11064 struct bp_location *loc;
11065 struct tracepoint *tp = (struct tracepoint *) bp;
11066 size_t size = get_remote_packet_size ();
11070 tp->base.hit_count = 0;
11071 tp->traceframe_usage = 0;
11072 for (loc = tp->base.loc; loc; loc = loc->next)
11074 /* If the tracepoint was never downloaded, don't go asking for
11076 if (tp->number_on_target == 0)
11078 xsnprintf (rs->buf, size, "qTP:%x:%s", tp->number_on_target,
11079 phex_nz (loc->address, 0));
11081 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11082 if (reply && *reply)
11085 parse_tracepoint_status (reply + 1, bp, utp);
11091 utp->hit_count = 0;
11092 utp->traceframe_usage = 0;
11093 xsnprintf (rs->buf, size, "qTP:%x:%s", utp->number,
11094 phex_nz (utp->addr, 0));
11096 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11097 if (reply && *reply)
11100 parse_tracepoint_status (reply + 1, bp, utp);
11106 remote_trace_stop (struct target_ops *self)
11109 remote_get_noisy_reply (&target_buf, &target_buf_size);
11110 if (*target_buf == '\0')
11111 error (_("Target does not support this command."));
11112 if (strcmp (target_buf, "OK") != 0)
11113 error (_("Bogus reply from target: %s"), target_buf);
11117 remote_trace_find (struct target_ops *self,
11118 enum trace_find_type type, int num,
11119 CORE_ADDR addr1, CORE_ADDR addr2,
11122 struct remote_state *rs = get_remote_state ();
11123 char *endbuf = rs->buf + get_remote_packet_size ();
11125 int target_frameno = -1, target_tracept = -1;
11127 /* Lookups other than by absolute frame number depend on the current
11128 trace selected, so make sure it is correct on the remote end
11130 if (type != tfind_number)
11131 set_remote_traceframe ();
11134 strcpy (p, "QTFrame:");
11135 p = strchr (p, '\0');
11139 xsnprintf (p, endbuf - p, "%x", num);
11142 xsnprintf (p, endbuf - p, "pc:%s", phex_nz (addr1, 0));
11145 xsnprintf (p, endbuf - p, "tdp:%x", num);
11148 xsnprintf (p, endbuf - p, "range:%s:%s", phex_nz (addr1, 0),
11149 phex_nz (addr2, 0));
11151 case tfind_outside:
11152 xsnprintf (p, endbuf - p, "outside:%s:%s", phex_nz (addr1, 0),
11153 phex_nz (addr2, 0));
11156 error (_("Unknown trace find type %d"), type);
11160 reply = remote_get_noisy_reply (&(rs->buf), &rs->buf_size);
11161 if (*reply == '\0')
11162 error (_("Target does not support this command."));
11164 while (reply && *reply)
11169 target_frameno = (int) strtol (p, &reply, 16);
11171 error (_("Unable to parse trace frame number"));
11172 /* Don't update our remote traceframe number cache on failure
11173 to select a remote traceframe. */
11174 if (target_frameno == -1)
11179 target_tracept = (int) strtol (p, &reply, 16);
11181 error (_("Unable to parse tracepoint number"));
11183 case 'O': /* "OK"? */
11184 if (reply[1] == 'K' && reply[2] == '\0')
11187 error (_("Bogus reply from target: %s"), reply);
11190 error (_("Bogus reply from target: %s"), reply);
11193 *tpp = target_tracept;
11195 rs->remote_traceframe_number = target_frameno;
11196 return target_frameno;
11200 remote_get_trace_state_variable_value (struct target_ops *self,
11201 int tsvnum, LONGEST *val)
11203 struct remote_state *rs = get_remote_state ();
11207 set_remote_traceframe ();
11209 xsnprintf (rs->buf, get_remote_packet_size (), "qTV:%x", tsvnum);
11211 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11212 if (reply && *reply)
11216 unpack_varlen_hex (reply + 1, &uval);
11217 *val = (LONGEST) uval;
11225 remote_save_trace_data (struct target_ops *self, const char *filename)
11227 struct remote_state *rs = get_remote_state ();
11231 strcpy (p, "QTSave:");
11233 if ((p - rs->buf) + strlen (filename) * 2 >= get_remote_packet_size ())
11234 error (_("Remote file name too long for trace save packet"));
11235 p += 2 * bin2hex ((gdb_byte *) filename, p, strlen (filename));
11238 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11239 if (*reply == '\0')
11240 error (_("Target does not support this command."));
11241 if (strcmp (reply, "OK") != 0)
11242 error (_("Bogus reply from target: %s"), reply);
11246 /* This is basically a memory transfer, but needs to be its own packet
11247 because we don't know how the target actually organizes its trace
11248 memory, plus we want to be able to ask for as much as possible, but
11249 not be unhappy if we don't get as much as we ask for. */
11252 remote_get_raw_trace_data (struct target_ops *self,
11253 gdb_byte *buf, ULONGEST offset, LONGEST len)
11255 struct remote_state *rs = get_remote_state ();
11261 strcpy (p, "qTBuffer:");
11263 p += hexnumstr (p, offset);
11265 p += hexnumstr (p, len);
11269 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11270 if (reply && *reply)
11272 /* 'l' by itself means we're at the end of the buffer and
11273 there is nothing more to get. */
11277 /* Convert the reply into binary. Limit the number of bytes to
11278 convert according to our passed-in buffer size, rather than
11279 what was returned in the packet; if the target is
11280 unexpectedly generous and gives us a bigger reply than we
11281 asked for, we don't want to crash. */
11282 rslt = hex2bin (target_buf, buf, len);
11286 /* Something went wrong, flag as an error. */
11291 remote_set_disconnected_tracing (struct target_ops *self, int val)
11293 struct remote_state *rs = get_remote_state ();
11295 if (packet_support (PACKET_DisconnectedTracing_feature) == PACKET_ENABLE)
11299 xsnprintf (rs->buf, get_remote_packet_size (), "QTDisconnected:%x", val);
11301 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11302 if (*reply == '\0')
11303 error (_("Target does not support this command."));
11304 if (strcmp (reply, "OK") != 0)
11305 error (_("Bogus reply from target: %s"), reply);
11308 warning (_("Target does not support disconnected tracing."));
11312 remote_core_of_thread (struct target_ops *ops, ptid_t ptid)
11314 struct thread_info *info = find_thread_ptid (ptid);
11316 if (info && info->priv)
11317 return info->priv->core;
11322 remote_set_circular_trace_buffer (struct target_ops *self, int val)
11324 struct remote_state *rs = get_remote_state ();
11327 xsnprintf (rs->buf, get_remote_packet_size (), "QTBuffer:circular:%x", val);
11329 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11330 if (*reply == '\0')
11331 error (_("Target does not support this command."));
11332 if (strcmp (reply, "OK") != 0)
11333 error (_("Bogus reply from target: %s"), reply);
11336 static struct traceframe_info *
11337 remote_traceframe_info (struct target_ops *self)
11341 text = target_read_stralloc (¤t_target,
11342 TARGET_OBJECT_TRACEFRAME_INFO, NULL);
11345 struct traceframe_info *info;
11346 struct cleanup *back_to = make_cleanup (xfree, text);
11348 info = parse_traceframe_info (text);
11349 do_cleanups (back_to);
11356 /* Handle the qTMinFTPILen packet. Returns the minimum length of
11357 instruction on which a fast tracepoint may be placed. Returns -1
11358 if the packet is not supported, and 0 if the minimum instruction
11359 length is unknown. */
11362 remote_get_min_fast_tracepoint_insn_len (struct target_ops *self)
11364 struct remote_state *rs = get_remote_state ();
11367 /* If we're not debugging a process yet, the IPA can't be
11369 if (!target_has_execution)
11372 /* Make sure the remote is pointing at the right process. */
11373 set_general_process ();
11375 xsnprintf (rs->buf, get_remote_packet_size (), "qTMinFTPILen");
11377 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11378 if (*reply == '\0')
11382 ULONGEST min_insn_len;
11384 unpack_varlen_hex (reply, &min_insn_len);
11386 return (int) min_insn_len;
11391 remote_set_trace_buffer_size (struct target_ops *self, LONGEST val)
11393 if (packet_support (PACKET_QTBuffer_size) != PACKET_DISABLE)
11395 struct remote_state *rs = get_remote_state ();
11396 char *buf = rs->buf;
11397 char *endbuf = rs->buf + get_remote_packet_size ();
11398 enum packet_result result;
11400 gdb_assert (val >= 0 || val == -1);
11401 buf += xsnprintf (buf, endbuf - buf, "QTBuffer:size:");
11402 /* Send -1 as literal "-1" to avoid host size dependency. */
11406 buf += hexnumstr (buf, (ULONGEST) -val);
11409 buf += hexnumstr (buf, (ULONGEST) val);
11412 remote_get_noisy_reply (&rs->buf, &rs->buf_size);
11413 result = packet_ok (rs->buf,
11414 &remote_protocol_packets[PACKET_QTBuffer_size]);
11416 if (result != PACKET_OK)
11417 warning (_("Bogus reply from target: %s"), rs->buf);
11422 remote_set_trace_notes (struct target_ops *self,
11423 const char *user, const char *notes,
11424 const char *stop_notes)
11426 struct remote_state *rs = get_remote_state ();
11428 char *buf = rs->buf;
11429 char *endbuf = rs->buf + get_remote_packet_size ();
11432 buf += xsnprintf (buf, endbuf - buf, "QTNotes:");
11435 buf += xsnprintf (buf, endbuf - buf, "user:");
11436 nbytes = bin2hex ((gdb_byte *) user, buf, strlen (user));
11442 buf += xsnprintf (buf, endbuf - buf, "notes:");
11443 nbytes = bin2hex ((gdb_byte *) notes, buf, strlen (notes));
11449 buf += xsnprintf (buf, endbuf - buf, "tstop:");
11450 nbytes = bin2hex ((gdb_byte *) stop_notes, buf, strlen (stop_notes));
11454 /* Ensure the buffer is terminated. */
11458 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
11459 if (*reply == '\0')
11462 if (strcmp (reply, "OK") != 0)
11463 error (_("Bogus reply from target: %s"), reply);
11469 remote_use_agent (struct target_ops *self, int use)
11471 if (packet_support (PACKET_QAgent) != PACKET_DISABLE)
11473 struct remote_state *rs = get_remote_state ();
11475 /* If the stub supports QAgent. */
11476 xsnprintf (rs->buf, get_remote_packet_size (), "QAgent:%d", use);
11478 getpkt (&rs->buf, &rs->buf_size, 0);
11480 if (strcmp (rs->buf, "OK") == 0)
11491 remote_can_use_agent (struct target_ops *self)
11493 return (packet_support (PACKET_QAgent) != PACKET_DISABLE);
11496 struct btrace_target_info
11498 /* The ptid of the traced thread. */
11501 /* The obtained branch trace configuration. */
11502 struct btrace_config conf;
11505 /* Reset our idea of our target's btrace configuration. */
11508 remote_btrace_reset (void)
11510 struct remote_state *rs = get_remote_state ();
11512 memset (&rs->btrace_config, 0, sizeof (rs->btrace_config));
11515 /* Check whether the target supports branch tracing. */
11518 remote_supports_btrace (struct target_ops *self, enum btrace_format format)
11520 if (packet_support (PACKET_Qbtrace_off) != PACKET_ENABLE)
11522 if (packet_support (PACKET_qXfer_btrace) != PACKET_ENABLE)
11527 case BTRACE_FORMAT_NONE:
11530 case BTRACE_FORMAT_BTS:
11531 return (packet_support (PACKET_Qbtrace_bts) == PACKET_ENABLE);
11534 internal_error (__FILE__, __LINE__, _("Unknown branch trace format"));
11537 /* Synchronize the configuration with the target. */
11540 btrace_sync_conf (const struct btrace_config *conf)
11542 struct packet_config *packet;
11543 struct remote_state *rs;
11544 char *buf, *pos, *endbuf;
11546 rs = get_remote_state ();
11548 endbuf = buf + get_remote_packet_size ();
11550 packet = &remote_protocol_packets[PACKET_Qbtrace_conf_bts_size];
11551 if (packet_config_support (packet) == PACKET_ENABLE
11552 && conf->bts.size != rs->btrace_config.bts.size)
11555 pos += xsnprintf (pos, endbuf - pos, "%s=0x%x", packet->name,
11559 getpkt (&buf, &rs->buf_size, 0);
11561 if (packet_ok (buf, packet) == PACKET_ERROR)
11563 if (buf[0] == 'E' && buf[1] == '.')
11564 error (_("Failed to configure the BTS buffer size: %s"), buf + 2);
11566 error (_("Failed to configure the BTS buffer size."));
11569 rs->btrace_config.bts.size = conf->bts.size;
11573 /* Read the current thread's btrace configuration from the target and
11574 store it into CONF. */
11577 btrace_read_config (struct btrace_config *conf)
11581 xml = target_read_stralloc (¤t_target,
11582 TARGET_OBJECT_BTRACE_CONF, "");
11585 struct cleanup *cleanup;
11587 cleanup = make_cleanup (xfree, xml);
11588 parse_xml_btrace_conf (conf, xml);
11589 do_cleanups (cleanup);
11593 /* Enable branch tracing. */
11595 static struct btrace_target_info *
11596 remote_enable_btrace (struct target_ops *self, ptid_t ptid,
11597 const struct btrace_config *conf)
11599 struct btrace_target_info *tinfo = NULL;
11600 struct packet_config *packet = &remote_protocol_packets[PACKET_Qbtrace_bts];
11601 struct remote_state *rs = get_remote_state ();
11602 char *buf = rs->buf;
11603 char *endbuf = rs->buf + get_remote_packet_size ();
11605 if (packet_config_support (packet) != PACKET_ENABLE)
11606 error (_("Target does not support branch tracing."));
11608 btrace_sync_conf (conf);
11610 set_general_thread (ptid);
11612 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
11614 getpkt (&rs->buf, &rs->buf_size, 0);
11616 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
11618 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
11619 error (_("Could not enable branch tracing for %s: %s"),
11620 target_pid_to_str (ptid), rs->buf + 2);
11622 error (_("Could not enable branch tracing for %s."),
11623 target_pid_to_str (ptid));
11626 tinfo = xzalloc (sizeof (*tinfo));
11627 tinfo->ptid = ptid;
11629 /* If we fail to read the configuration, we lose some information, but the
11630 tracing itself is not impacted. */
11633 btrace_read_config (&tinfo->conf);
11635 CATCH (err, RETURN_MASK_ERROR)
11637 if (err.message != NULL)
11638 warning ("%s", err.message);
11645 /* Disable branch tracing. */
11648 remote_disable_btrace (struct target_ops *self,
11649 struct btrace_target_info *tinfo)
11651 struct packet_config *packet = &remote_protocol_packets[PACKET_Qbtrace_off];
11652 struct remote_state *rs = get_remote_state ();
11653 char *buf = rs->buf;
11654 char *endbuf = rs->buf + get_remote_packet_size ();
11656 if (packet_config_support (packet) != PACKET_ENABLE)
11657 error (_("Target does not support branch tracing."));
11659 set_general_thread (tinfo->ptid);
11661 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
11663 getpkt (&rs->buf, &rs->buf_size, 0);
11665 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
11667 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
11668 error (_("Could not disable branch tracing for %s: %s"),
11669 target_pid_to_str (tinfo->ptid), rs->buf + 2);
11671 error (_("Could not disable branch tracing for %s."),
11672 target_pid_to_str (tinfo->ptid));
11678 /* Teardown branch tracing. */
11681 remote_teardown_btrace (struct target_ops *self,
11682 struct btrace_target_info *tinfo)
11684 /* We must not talk to the target during teardown. */
11688 /* Read the branch trace. */
11690 static enum btrace_error
11691 remote_read_btrace (struct target_ops *self,
11692 struct btrace_data *btrace,
11693 struct btrace_target_info *tinfo,
11694 enum btrace_read_type type)
11696 struct packet_config *packet = &remote_protocol_packets[PACKET_qXfer_btrace];
11697 struct remote_state *rs = get_remote_state ();
11698 struct cleanup *cleanup;
11702 if (packet_config_support (packet) != PACKET_ENABLE)
11703 error (_("Target does not support branch tracing."));
11705 #if !defined(HAVE_LIBEXPAT)
11706 error (_("Cannot process branch tracing result. XML parsing not supported."));
11711 case BTRACE_READ_ALL:
11714 case BTRACE_READ_NEW:
11717 case BTRACE_READ_DELTA:
11721 internal_error (__FILE__, __LINE__,
11722 _("Bad branch tracing read type: %u."),
11723 (unsigned int) type);
11726 xml = target_read_stralloc (¤t_target,
11727 TARGET_OBJECT_BTRACE, annex);
11729 return BTRACE_ERR_UNKNOWN;
11731 cleanup = make_cleanup (xfree, xml);
11732 parse_xml_btrace (btrace, xml);
11733 do_cleanups (cleanup);
11735 return BTRACE_ERR_NONE;
11738 static const struct btrace_config *
11739 remote_btrace_conf (struct target_ops *self,
11740 const struct btrace_target_info *tinfo)
11742 return &tinfo->conf;
11746 remote_augmented_libraries_svr4_read (struct target_ops *self)
11748 return (packet_support (PACKET_augmented_libraries_svr4_read_feature)
11752 /* Implementation of to_load. */
11755 remote_load (struct target_ops *self, const char *name, int from_tty)
11757 generic_load (name, from_tty);
11760 /* Accepts an integer PID; returns a string representing a file that
11761 can be opened on the remote side to get the symbols for the child
11762 process. Returns NULL if the operation is not supported. */
11765 remote_pid_to_exec_file (struct target_ops *self, int pid)
11767 static char *filename = NULL;
11768 struct inferior *inf;
11769 char *annex = NULL;
11771 if (packet_support (PACKET_qXfer_exec_file) != PACKET_ENABLE)
11774 if (filename != NULL)
11777 inf = find_inferior_pid (pid);
11779 internal_error (__FILE__, __LINE__,
11780 _("not currently attached to process %d"), pid);
11782 if (!inf->fake_pid_p)
11784 const int annex_size = 9;
11786 annex = alloca (annex_size);
11787 xsnprintf (annex, annex_size, "%x", pid);
11790 filename = target_read_stralloc (¤t_target,
11791 TARGET_OBJECT_EXEC_FILE, annex);
11797 init_remote_ops (void)
11799 remote_ops.to_shortname = "remote";
11800 remote_ops.to_longname = "Remote serial target in gdb-specific protocol";
11801 remote_ops.to_doc =
11802 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
11803 Specify the serial device it is connected to\n\
11804 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).";
11805 remote_ops.to_open = remote_open;
11806 remote_ops.to_close = remote_close;
11807 remote_ops.to_detach = remote_detach;
11808 remote_ops.to_disconnect = remote_disconnect;
11809 remote_ops.to_resume = remote_resume;
11810 remote_ops.to_wait = remote_wait;
11811 remote_ops.to_fetch_registers = remote_fetch_registers;
11812 remote_ops.to_store_registers = remote_store_registers;
11813 remote_ops.to_prepare_to_store = remote_prepare_to_store;
11814 remote_ops.to_files_info = remote_files_info;
11815 remote_ops.to_insert_breakpoint = remote_insert_breakpoint;
11816 remote_ops.to_remove_breakpoint = remote_remove_breakpoint;
11817 remote_ops.to_stopped_by_sw_breakpoint = remote_stopped_by_sw_breakpoint;
11818 remote_ops.to_supports_stopped_by_sw_breakpoint = remote_supports_stopped_by_sw_breakpoint;
11819 remote_ops.to_stopped_by_hw_breakpoint = remote_stopped_by_hw_breakpoint;
11820 remote_ops.to_supports_stopped_by_hw_breakpoint = remote_supports_stopped_by_hw_breakpoint;
11821 remote_ops.to_stopped_by_watchpoint = remote_stopped_by_watchpoint;
11822 remote_ops.to_stopped_data_address = remote_stopped_data_address;
11823 remote_ops.to_watchpoint_addr_within_range =
11824 remote_watchpoint_addr_within_range;
11825 remote_ops.to_can_use_hw_breakpoint = remote_check_watch_resources;
11826 remote_ops.to_insert_hw_breakpoint = remote_insert_hw_breakpoint;
11827 remote_ops.to_remove_hw_breakpoint = remote_remove_hw_breakpoint;
11828 remote_ops.to_region_ok_for_hw_watchpoint
11829 = remote_region_ok_for_hw_watchpoint;
11830 remote_ops.to_insert_watchpoint = remote_insert_watchpoint;
11831 remote_ops.to_remove_watchpoint = remote_remove_watchpoint;
11832 remote_ops.to_kill = remote_kill;
11833 remote_ops.to_load = remote_load;
11834 remote_ops.to_mourn_inferior = remote_mourn;
11835 remote_ops.to_pass_signals = remote_pass_signals;
11836 remote_ops.to_program_signals = remote_program_signals;
11837 remote_ops.to_thread_alive = remote_thread_alive;
11838 remote_ops.to_update_thread_list = remote_update_thread_list;
11839 remote_ops.to_pid_to_str = remote_pid_to_str;
11840 remote_ops.to_extra_thread_info = remote_threads_extra_info;
11841 remote_ops.to_get_ada_task_ptid = remote_get_ada_task_ptid;
11842 remote_ops.to_stop = remote_stop;
11843 remote_ops.to_xfer_partial = remote_xfer_partial;
11844 remote_ops.to_rcmd = remote_rcmd;
11845 remote_ops.to_pid_to_exec_file = remote_pid_to_exec_file;
11846 remote_ops.to_log_command = serial_log_command;
11847 remote_ops.to_get_thread_local_address = remote_get_thread_local_address;
11848 remote_ops.to_stratum = process_stratum;
11849 remote_ops.to_has_all_memory = default_child_has_all_memory;
11850 remote_ops.to_has_memory = default_child_has_memory;
11851 remote_ops.to_has_stack = default_child_has_stack;
11852 remote_ops.to_has_registers = default_child_has_registers;
11853 remote_ops.to_has_execution = default_child_has_execution;
11854 remote_ops.to_has_thread_control = tc_schedlock; /* can lock scheduler */
11855 remote_ops.to_can_execute_reverse = remote_can_execute_reverse;
11856 remote_ops.to_magic = OPS_MAGIC;
11857 remote_ops.to_memory_map = remote_memory_map;
11858 remote_ops.to_flash_erase = remote_flash_erase;
11859 remote_ops.to_flash_done = remote_flash_done;
11860 remote_ops.to_read_description = remote_read_description;
11861 remote_ops.to_search_memory = remote_search_memory;
11862 remote_ops.to_can_async_p = remote_can_async_p;
11863 remote_ops.to_is_async_p = remote_is_async_p;
11864 remote_ops.to_async = remote_async;
11865 remote_ops.to_terminal_inferior = remote_terminal_inferior;
11866 remote_ops.to_terminal_ours = remote_terminal_ours;
11867 remote_ops.to_supports_non_stop = remote_supports_non_stop;
11868 remote_ops.to_supports_multi_process = remote_supports_multi_process;
11869 remote_ops.to_supports_disable_randomization
11870 = remote_supports_disable_randomization;
11871 remote_ops.to_filesystem_is_local = remote_filesystem_is_local;
11872 remote_ops.to_fileio_open = remote_hostio_open;
11873 remote_ops.to_fileio_pwrite = remote_hostio_pwrite;
11874 remote_ops.to_fileio_pread = remote_hostio_pread;
11875 remote_ops.to_fileio_fstat = remote_hostio_fstat;
11876 remote_ops.to_fileio_close = remote_hostio_close;
11877 remote_ops.to_fileio_unlink = remote_hostio_unlink;
11878 remote_ops.to_fileio_readlink = remote_hostio_readlink;
11879 remote_ops.to_supports_enable_disable_tracepoint = remote_supports_enable_disable_tracepoint;
11880 remote_ops.to_supports_string_tracing = remote_supports_string_tracing;
11881 remote_ops.to_supports_evaluation_of_breakpoint_conditions = remote_supports_cond_breakpoints;
11882 remote_ops.to_can_run_breakpoint_commands = remote_can_run_breakpoint_commands;
11883 remote_ops.to_trace_init = remote_trace_init;
11884 remote_ops.to_download_tracepoint = remote_download_tracepoint;
11885 remote_ops.to_can_download_tracepoint = remote_can_download_tracepoint;
11886 remote_ops.to_download_trace_state_variable
11887 = remote_download_trace_state_variable;
11888 remote_ops.to_enable_tracepoint = remote_enable_tracepoint;
11889 remote_ops.to_disable_tracepoint = remote_disable_tracepoint;
11890 remote_ops.to_trace_set_readonly_regions = remote_trace_set_readonly_regions;
11891 remote_ops.to_trace_start = remote_trace_start;
11892 remote_ops.to_get_trace_status = remote_get_trace_status;
11893 remote_ops.to_get_tracepoint_status = remote_get_tracepoint_status;
11894 remote_ops.to_trace_stop = remote_trace_stop;
11895 remote_ops.to_trace_find = remote_trace_find;
11896 remote_ops.to_get_trace_state_variable_value
11897 = remote_get_trace_state_variable_value;
11898 remote_ops.to_save_trace_data = remote_save_trace_data;
11899 remote_ops.to_upload_tracepoints = remote_upload_tracepoints;
11900 remote_ops.to_upload_trace_state_variables
11901 = remote_upload_trace_state_variables;
11902 remote_ops.to_get_raw_trace_data = remote_get_raw_trace_data;
11903 remote_ops.to_get_min_fast_tracepoint_insn_len = remote_get_min_fast_tracepoint_insn_len;
11904 remote_ops.to_set_disconnected_tracing = remote_set_disconnected_tracing;
11905 remote_ops.to_set_circular_trace_buffer = remote_set_circular_trace_buffer;
11906 remote_ops.to_set_trace_buffer_size = remote_set_trace_buffer_size;
11907 remote_ops.to_set_trace_notes = remote_set_trace_notes;
11908 remote_ops.to_core_of_thread = remote_core_of_thread;
11909 remote_ops.to_verify_memory = remote_verify_memory;
11910 remote_ops.to_get_tib_address = remote_get_tib_address;
11911 remote_ops.to_set_permissions = remote_set_permissions;
11912 remote_ops.to_static_tracepoint_marker_at
11913 = remote_static_tracepoint_marker_at;
11914 remote_ops.to_static_tracepoint_markers_by_strid
11915 = remote_static_tracepoint_markers_by_strid;
11916 remote_ops.to_traceframe_info = remote_traceframe_info;
11917 remote_ops.to_use_agent = remote_use_agent;
11918 remote_ops.to_can_use_agent = remote_can_use_agent;
11919 remote_ops.to_supports_btrace = remote_supports_btrace;
11920 remote_ops.to_enable_btrace = remote_enable_btrace;
11921 remote_ops.to_disable_btrace = remote_disable_btrace;
11922 remote_ops.to_teardown_btrace = remote_teardown_btrace;
11923 remote_ops.to_read_btrace = remote_read_btrace;
11924 remote_ops.to_btrace_conf = remote_btrace_conf;
11925 remote_ops.to_augmented_libraries_svr4_read =
11926 remote_augmented_libraries_svr4_read;
11929 /* Set up the extended remote vector by making a copy of the standard
11930 remote vector and adding to it. */
11933 init_extended_remote_ops (void)
11935 extended_remote_ops = remote_ops;
11937 extended_remote_ops.to_shortname = "extended-remote";
11938 extended_remote_ops.to_longname =
11939 "Extended remote serial target in gdb-specific protocol";
11940 extended_remote_ops.to_doc =
11941 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
11942 Specify the serial device it is connected to (e.g. /dev/ttya).";
11943 extended_remote_ops.to_open = extended_remote_open;
11944 extended_remote_ops.to_create_inferior = extended_remote_create_inferior;
11945 extended_remote_ops.to_mourn_inferior = extended_remote_mourn;
11946 extended_remote_ops.to_detach = extended_remote_detach;
11947 extended_remote_ops.to_attach = extended_remote_attach;
11948 extended_remote_ops.to_post_attach = extended_remote_post_attach;
11949 extended_remote_ops.to_kill = extended_remote_kill;
11950 extended_remote_ops.to_supports_disable_randomization
11951 = extended_remote_supports_disable_randomization;
11952 extended_remote_ops.to_follow_fork = remote_follow_fork;
11956 remote_can_async_p (struct target_ops *ops)
11958 struct remote_state *rs = get_remote_state ();
11960 if (!target_async_permitted)
11961 /* We only enable async when the user specifically asks for it. */
11964 /* We're async whenever the serial device is. */
11965 return serial_can_async_p (rs->remote_desc);
11969 remote_is_async_p (struct target_ops *ops)
11971 struct remote_state *rs = get_remote_state ();
11973 if (!target_async_permitted)
11974 /* We only enable async when the user specifically asks for it. */
11977 /* We're async whenever the serial device is. */
11978 return serial_is_async_p (rs->remote_desc);
11981 /* Pass the SERIAL event on and up to the client. One day this code
11982 will be able to delay notifying the client of an event until the
11983 point where an entire packet has been received. */
11985 static serial_event_ftype remote_async_serial_handler;
11988 remote_async_serial_handler (struct serial *scb, void *context)
11990 struct remote_state *rs = context;
11992 /* Don't propogate error information up to the client. Instead let
11993 the client find out about the error by querying the target. */
11994 inferior_event_handler (INF_REG_EVENT, NULL);
11998 remote_async_inferior_event_handler (gdb_client_data data)
12000 inferior_event_handler (INF_REG_EVENT, NULL);
12004 remote_async (struct target_ops *ops, int enable)
12006 struct remote_state *rs = get_remote_state ();
12010 serial_async (rs->remote_desc, remote_async_serial_handler, rs);
12012 /* If there are pending events in the stop reply queue tell the
12013 event loop to process them. */
12014 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
12015 mark_async_event_handler (remote_async_inferior_event_token);
12019 serial_async (rs->remote_desc, NULL, NULL);
12020 clear_async_event_handler (remote_async_inferior_event_token);
12025 set_remote_cmd (char *args, int from_tty)
12027 help_list (remote_set_cmdlist, "set remote ", all_commands, gdb_stdout);
12031 show_remote_cmd (char *args, int from_tty)
12033 /* We can't just use cmd_show_list here, because we want to skip
12034 the redundant "show remote Z-packet" and the legacy aliases. */
12035 struct cleanup *showlist_chain;
12036 struct cmd_list_element *list = remote_show_cmdlist;
12037 struct ui_out *uiout = current_uiout;
12039 showlist_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "showlist");
12040 for (; list != NULL; list = list->next)
12041 if (strcmp (list->name, "Z-packet") == 0)
12043 else if (list->type == not_set_cmd)
12044 /* Alias commands are exactly like the original, except they
12045 don't have the normal type. */
12049 struct cleanup *option_chain
12050 = make_cleanup_ui_out_tuple_begin_end (uiout, "option");
12052 ui_out_field_string (uiout, "name", list->name);
12053 ui_out_text (uiout, ": ");
12054 if (list->type == show_cmd)
12055 do_show_command ((char *) NULL, from_tty, list);
12057 cmd_func (list, NULL, from_tty);
12058 /* Close the tuple. */
12059 do_cleanups (option_chain);
12062 /* Close the tuple. */
12063 do_cleanups (showlist_chain);
12067 /* Function to be called whenever a new objfile (shlib) is detected. */
12069 remote_new_objfile (struct objfile *objfile)
12071 struct remote_state *rs = get_remote_state ();
12073 if (rs->remote_desc != 0) /* Have a remote connection. */
12074 remote_check_symbols ();
12077 /* Pull all the tracepoints defined on the target and create local
12078 data structures representing them. We don't want to create real
12079 tracepoints yet, we don't want to mess up the user's existing
12083 remote_upload_tracepoints (struct target_ops *self, struct uploaded_tp **utpp)
12085 struct remote_state *rs = get_remote_state ();
12088 /* Ask for a first packet of tracepoint definition. */
12090 getpkt (&rs->buf, &rs->buf_size, 0);
12092 while (*p && *p != 'l')
12094 parse_tracepoint_definition (p, utpp);
12095 /* Ask for another packet of tracepoint definition. */
12097 getpkt (&rs->buf, &rs->buf_size, 0);
12104 remote_upload_trace_state_variables (struct target_ops *self,
12105 struct uploaded_tsv **utsvp)
12107 struct remote_state *rs = get_remote_state ();
12110 /* Ask for a first packet of variable definition. */
12112 getpkt (&rs->buf, &rs->buf_size, 0);
12114 while (*p && *p != 'l')
12116 parse_tsv_definition (p, utsvp);
12117 /* Ask for another packet of variable definition. */
12119 getpkt (&rs->buf, &rs->buf_size, 0);
12125 /* The "set/show range-stepping" show hook. */
12128 show_range_stepping (struct ui_file *file, int from_tty,
12129 struct cmd_list_element *c,
12132 fprintf_filtered (file,
12133 _("Debugger's willingness to use range stepping "
12134 "is %s.\n"), value);
12137 /* The "set/show range-stepping" set hook. */
12140 set_range_stepping (char *ignore_args, int from_tty,
12141 struct cmd_list_element *c)
12143 struct remote_state *rs = get_remote_state ();
12145 /* Whene enabling, check whether range stepping is actually
12146 supported by the target, and warn if not. */
12147 if (use_range_stepping)
12149 if (rs->remote_desc != NULL)
12151 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
12152 remote_vcont_probe (rs);
12154 if (packet_support (PACKET_vCont) == PACKET_ENABLE
12155 && rs->supports_vCont.r)
12159 warning (_("Range stepping is not supported by the current target"));
12164 _initialize_remote (void)
12166 struct remote_state *rs;
12167 struct cmd_list_element *cmd;
12168 const char *cmd_name;
12170 /* architecture specific data */
12171 remote_gdbarch_data_handle =
12172 gdbarch_data_register_post_init (init_remote_state);
12173 remote_g_packet_data_handle =
12174 gdbarch_data_register_pre_init (remote_g_packet_data_init);
12176 /* Initialize the per-target state. At the moment there is only one
12177 of these, not one per target. Only one target is active at a
12179 remote_state = new_remote_state ();
12181 init_remote_ops ();
12182 add_target (&remote_ops);
12184 init_extended_remote_ops ();
12185 add_target (&extended_remote_ops);
12187 /* Hook into new objfile notification. */
12188 observer_attach_new_objfile (remote_new_objfile);
12189 /* We're no longer interested in notification events of an inferior
12191 observer_attach_inferior_exit (discard_pending_stop_replies);
12193 /* Set up signal handlers. */
12194 async_sigint_remote_token =
12195 create_async_signal_handler (async_remote_interrupt, NULL);
12196 async_sigint_remote_twice_token =
12197 create_async_signal_handler (async_remote_interrupt_twice, NULL);
12200 init_remote_threadtests ();
12203 stop_reply_queue = QUEUE_alloc (stop_reply_p, stop_reply_xfree);
12204 /* set/show remote ... */
12206 add_prefix_cmd ("remote", class_maintenance, set_remote_cmd, _("\
12207 Remote protocol specific variables\n\
12208 Configure various remote-protocol specific variables such as\n\
12209 the packets being used"),
12210 &remote_set_cmdlist, "set remote ",
12211 0 /* allow-unknown */, &setlist);
12212 add_prefix_cmd ("remote", class_maintenance, show_remote_cmd, _("\
12213 Remote protocol specific variables\n\
12214 Configure various remote-protocol specific variables such as\n\
12215 the packets being used"),
12216 &remote_show_cmdlist, "show remote ",
12217 0 /* allow-unknown */, &showlist);
12219 add_cmd ("compare-sections", class_obscure, compare_sections_command, _("\
12220 Compare section data on target to the exec file.\n\
12221 Argument is a single section name (default: all loaded sections).\n\
12222 To compare only read-only loaded sections, specify the -r option."),
12225 add_cmd ("packet", class_maintenance, packet_command, _("\
12226 Send an arbitrary packet to a remote target.\n\
12227 maintenance packet TEXT\n\
12228 If GDB is talking to an inferior via the GDB serial protocol, then\n\
12229 this command sends the string TEXT to the inferior, and displays the\n\
12230 response packet. GDB supplies the initial `$' character, and the\n\
12231 terminating `#' character and checksum."),
12234 add_setshow_boolean_cmd ("remotebreak", no_class, &remote_break, _("\
12235 Set whether to send break if interrupted."), _("\
12236 Show whether to send break if interrupted."), _("\
12237 If set, a break, instead of a cntrl-c, is sent to the remote target."),
12238 set_remotebreak, show_remotebreak,
12239 &setlist, &showlist);
12240 cmd_name = "remotebreak";
12241 cmd = lookup_cmd (&cmd_name, setlist, "", -1, 1);
12242 deprecate_cmd (cmd, "set remote interrupt-sequence");
12243 cmd_name = "remotebreak"; /* needed because lookup_cmd updates the pointer */
12244 cmd = lookup_cmd (&cmd_name, showlist, "", -1, 1);
12245 deprecate_cmd (cmd, "show remote interrupt-sequence");
12247 add_setshow_enum_cmd ("interrupt-sequence", class_support,
12248 interrupt_sequence_modes, &interrupt_sequence_mode,
12250 Set interrupt sequence to remote target."), _("\
12251 Show interrupt sequence to remote target."), _("\
12252 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
12253 NULL, show_interrupt_sequence,
12254 &remote_set_cmdlist,
12255 &remote_show_cmdlist);
12257 add_setshow_boolean_cmd ("interrupt-on-connect", class_support,
12258 &interrupt_on_connect, _("\
12259 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
12260 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
12261 If set, interrupt sequence is sent to remote target."),
12263 &remote_set_cmdlist, &remote_show_cmdlist);
12265 /* Install commands for configuring memory read/write packets. */
12267 add_cmd ("remotewritesize", no_class, set_memory_write_packet_size, _("\
12268 Set the maximum number of bytes per memory write packet (deprecated)."),
12270 add_cmd ("remotewritesize", no_class, show_memory_write_packet_size, _("\
12271 Show the maximum number of bytes per memory write packet (deprecated)."),
12273 add_cmd ("memory-write-packet-size", no_class,
12274 set_memory_write_packet_size, _("\
12275 Set the maximum number of bytes per memory-write packet.\n\
12276 Specify the number of bytes in a packet or 0 (zero) for the\n\
12277 default packet size. The actual limit is further reduced\n\
12278 dependent on the target. Specify ``fixed'' to disable the\n\
12279 further restriction and ``limit'' to enable that restriction."),
12280 &remote_set_cmdlist);
12281 add_cmd ("memory-read-packet-size", no_class,
12282 set_memory_read_packet_size, _("\
12283 Set the maximum number of bytes per memory-read packet.\n\
12284 Specify the number of bytes in a packet or 0 (zero) for the\n\
12285 default packet size. The actual limit is further reduced\n\
12286 dependent on the target. Specify ``fixed'' to disable the\n\
12287 further restriction and ``limit'' to enable that restriction."),
12288 &remote_set_cmdlist);
12289 add_cmd ("memory-write-packet-size", no_class,
12290 show_memory_write_packet_size,
12291 _("Show the maximum number of bytes per memory-write packet."),
12292 &remote_show_cmdlist);
12293 add_cmd ("memory-read-packet-size", no_class,
12294 show_memory_read_packet_size,
12295 _("Show the maximum number of bytes per memory-read packet."),
12296 &remote_show_cmdlist);
12298 add_setshow_zinteger_cmd ("hardware-watchpoint-limit", no_class,
12299 &remote_hw_watchpoint_limit, _("\
12300 Set the maximum number of target hardware watchpoints."), _("\
12301 Show the maximum number of target hardware watchpoints."), _("\
12302 Specify a negative limit for unlimited."),
12303 NULL, NULL, /* FIXME: i18n: The maximum
12304 number of target hardware
12305 watchpoints is %s. */
12306 &remote_set_cmdlist, &remote_show_cmdlist);
12307 add_setshow_zinteger_cmd ("hardware-watchpoint-length-limit", no_class,
12308 &remote_hw_watchpoint_length_limit, _("\
12309 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
12310 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
12311 Specify a negative limit for unlimited."),
12312 NULL, NULL, /* FIXME: i18n: The maximum
12313 length (in bytes) of a target
12314 hardware watchpoint is %s. */
12315 &remote_set_cmdlist, &remote_show_cmdlist);
12316 add_setshow_zinteger_cmd ("hardware-breakpoint-limit", no_class,
12317 &remote_hw_breakpoint_limit, _("\
12318 Set the maximum number of target hardware breakpoints."), _("\
12319 Show the maximum number of target hardware breakpoints."), _("\
12320 Specify a negative limit for unlimited."),
12321 NULL, NULL, /* FIXME: i18n: The maximum
12322 number of target hardware
12323 breakpoints is %s. */
12324 &remote_set_cmdlist, &remote_show_cmdlist);
12326 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure,
12327 &remote_address_size, _("\
12328 Set the maximum size of the address (in bits) in a memory packet."), _("\
12329 Show the maximum size of the address (in bits) in a memory packet."), NULL,
12331 NULL, /* FIXME: i18n: */
12332 &setlist, &showlist);
12334 init_all_packet_configs ();
12336 add_packet_config_cmd (&remote_protocol_packets[PACKET_X],
12337 "X", "binary-download", 1);
12339 add_packet_config_cmd (&remote_protocol_packets[PACKET_vCont],
12340 "vCont", "verbose-resume", 0);
12342 add_packet_config_cmd (&remote_protocol_packets[PACKET_QPassSignals],
12343 "QPassSignals", "pass-signals", 0);
12345 add_packet_config_cmd (&remote_protocol_packets[PACKET_QProgramSignals],
12346 "QProgramSignals", "program-signals", 0);
12348 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSymbol],
12349 "qSymbol", "symbol-lookup", 0);
12351 add_packet_config_cmd (&remote_protocol_packets[PACKET_P],
12352 "P", "set-register", 1);
12354 add_packet_config_cmd (&remote_protocol_packets[PACKET_p],
12355 "p", "fetch-register", 1);
12357 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z0],
12358 "Z0", "software-breakpoint", 0);
12360 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z1],
12361 "Z1", "hardware-breakpoint", 0);
12363 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z2],
12364 "Z2", "write-watchpoint", 0);
12366 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z3],
12367 "Z3", "read-watchpoint", 0);
12369 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z4],
12370 "Z4", "access-watchpoint", 0);
12372 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_auxv],
12373 "qXfer:auxv:read", "read-aux-vector", 0);
12375 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_exec_file],
12376 "qXfer:exec-file:read", "pid-to-exec-file", 0);
12378 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_features],
12379 "qXfer:features:read", "target-features", 0);
12381 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries],
12382 "qXfer:libraries:read", "library-info", 0);
12384 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries_svr4],
12385 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
12387 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_memory_map],
12388 "qXfer:memory-map:read", "memory-map", 0);
12390 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_read],
12391 "qXfer:spu:read", "read-spu-object", 0);
12393 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_write],
12394 "qXfer:spu:write", "write-spu-object", 0);
12396 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_osdata],
12397 "qXfer:osdata:read", "osdata", 0);
12399 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_threads],
12400 "qXfer:threads:read", "threads", 0);
12402 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_read],
12403 "qXfer:siginfo:read", "read-siginfo-object", 0);
12405 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_write],
12406 "qXfer:siginfo:write", "write-siginfo-object", 0);
12408 add_packet_config_cmd
12409 (&remote_protocol_packets[PACKET_qXfer_traceframe_info],
12410 "qXfer:traceframe-info:read", "traceframe-info", 0);
12412 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_uib],
12413 "qXfer:uib:read", "unwind-info-block", 0);
12415 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTLSAddr],
12416 "qGetTLSAddr", "get-thread-local-storage-address",
12419 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTIBAddr],
12420 "qGetTIBAddr", "get-thread-information-block-address",
12423 add_packet_config_cmd (&remote_protocol_packets[PACKET_bc],
12424 "bc", "reverse-continue", 0);
12426 add_packet_config_cmd (&remote_protocol_packets[PACKET_bs],
12427 "bs", "reverse-step", 0);
12429 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSupported],
12430 "qSupported", "supported-packets", 0);
12432 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSearch_memory],
12433 "qSearch:memory", "search-memory", 0);
12435 add_packet_config_cmd (&remote_protocol_packets[PACKET_qTStatus],
12436 "qTStatus", "trace-status", 0);
12438 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_open],
12439 "vFile:open", "hostio-open", 0);
12441 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pread],
12442 "vFile:pread", "hostio-pread", 0);
12444 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pwrite],
12445 "vFile:pwrite", "hostio-pwrite", 0);
12447 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_close],
12448 "vFile:close", "hostio-close", 0);
12450 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_unlink],
12451 "vFile:unlink", "hostio-unlink", 0);
12453 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_readlink],
12454 "vFile:readlink", "hostio-readlink", 0);
12456 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_fstat],
12457 "vFile:fstat", "hostio-fstat", 0);
12459 add_packet_config_cmd (&remote_protocol_packets[PACKET_vAttach],
12460 "vAttach", "attach", 0);
12462 add_packet_config_cmd (&remote_protocol_packets[PACKET_vRun],
12465 add_packet_config_cmd (&remote_protocol_packets[PACKET_QStartNoAckMode],
12466 "QStartNoAckMode", "noack", 0);
12468 add_packet_config_cmd (&remote_protocol_packets[PACKET_vKill],
12469 "vKill", "kill", 0);
12471 add_packet_config_cmd (&remote_protocol_packets[PACKET_qAttached],
12472 "qAttached", "query-attached", 0);
12474 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalTracepoints],
12475 "ConditionalTracepoints",
12476 "conditional-tracepoints", 0);
12478 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalBreakpoints],
12479 "ConditionalBreakpoints",
12480 "conditional-breakpoints", 0);
12482 add_packet_config_cmd (&remote_protocol_packets[PACKET_BreakpointCommands],
12483 "BreakpointCommands",
12484 "breakpoint-commands", 0);
12486 add_packet_config_cmd (&remote_protocol_packets[PACKET_FastTracepoints],
12487 "FastTracepoints", "fast-tracepoints", 0);
12489 add_packet_config_cmd (&remote_protocol_packets[PACKET_TracepointSource],
12490 "TracepointSource", "TracepointSource", 0);
12492 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAllow],
12493 "QAllow", "allow", 0);
12495 add_packet_config_cmd (&remote_protocol_packets[PACKET_StaticTracepoints],
12496 "StaticTracepoints", "static-tracepoints", 0);
12498 add_packet_config_cmd (&remote_protocol_packets[PACKET_InstallInTrace],
12499 "InstallInTrace", "install-in-trace", 0);
12501 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_statictrace_read],
12502 "qXfer:statictrace:read", "read-sdata-object", 0);
12504 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_fdpic],
12505 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
12507 add_packet_config_cmd (&remote_protocol_packets[PACKET_QDisableRandomization],
12508 "QDisableRandomization", "disable-randomization", 0);
12510 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAgent],
12511 "QAgent", "agent", 0);
12513 add_packet_config_cmd (&remote_protocol_packets[PACKET_QTBuffer_size],
12514 "QTBuffer:size", "trace-buffer-size", 0);
12516 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_off],
12517 "Qbtrace:off", "disable-btrace", 0);
12519 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_bts],
12520 "Qbtrace:bts", "enable-btrace", 0);
12522 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace],
12523 "qXfer:btrace", "read-btrace", 0);
12525 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace_conf],
12526 "qXfer:btrace-conf", "read-btrace-conf", 0);
12528 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_conf_bts_size],
12529 "Qbtrace-conf:bts:size", "btrace-conf-bts-size", 0);
12531 add_packet_config_cmd (&remote_protocol_packets[PACKET_swbreak_feature],
12532 "swbreak-feature", "swbreak-feature", 0);
12534 add_packet_config_cmd (&remote_protocol_packets[PACKET_hwbreak_feature],
12535 "hwbreak-feature", "hwbreak-feature", 0);
12537 add_packet_config_cmd (&remote_protocol_packets[PACKET_fork_event_feature],
12538 "fork-event-feature", "fork-event-feature", 0);
12540 add_packet_config_cmd (&remote_protocol_packets[PACKET_vfork_event_feature],
12541 "vfork-event-feature", "vfork-event-feature", 0);
12543 /* Assert that we've registered "set remote foo-packet" commands
12544 for all packet configs. */
12548 for (i = 0; i < PACKET_MAX; i++)
12550 /* Ideally all configs would have a command associated. Some
12551 still don't though. */
12556 case PACKET_QNonStop:
12557 case PACKET_multiprocess_feature:
12558 case PACKET_EnableDisableTracepoints_feature:
12559 case PACKET_tracenz_feature:
12560 case PACKET_DisconnectedTracing_feature:
12561 case PACKET_augmented_libraries_svr4_read_feature:
12563 /* Additions to this list need to be well justified:
12564 pre-existing packets are OK; new packets are not. */
12572 /* This catches both forgetting to add a config command, and
12573 forgetting to remove a packet from the exception list. */
12574 gdb_assert (excepted == (remote_protocol_packets[i].name == NULL));
12578 /* Keep the old ``set remote Z-packet ...'' working. Each individual
12579 Z sub-packet has its own set and show commands, but users may
12580 have sets to this variable in their .gdbinit files (or in their
12582 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure,
12583 &remote_Z_packet_detect, _("\
12584 Set use of remote protocol `Z' packets"), _("\
12585 Show use of remote protocol `Z' packets "), _("\
12586 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
12588 set_remote_protocol_Z_packet_cmd,
12589 show_remote_protocol_Z_packet_cmd,
12590 /* FIXME: i18n: Use of remote protocol
12591 `Z' packets is %s. */
12592 &remote_set_cmdlist, &remote_show_cmdlist);
12594 add_prefix_cmd ("remote", class_files, remote_command, _("\
12595 Manipulate files on the remote system\n\
12596 Transfer files to and from the remote target system."),
12597 &remote_cmdlist, "remote ",
12598 0 /* allow-unknown */, &cmdlist);
12600 add_cmd ("put", class_files, remote_put_command,
12601 _("Copy a local file to the remote system."),
12604 add_cmd ("get", class_files, remote_get_command,
12605 _("Copy a remote file to the local system."),
12608 add_cmd ("delete", class_files, remote_delete_command,
12609 _("Delete a remote file."),
12612 remote_exec_file = xstrdup ("");
12613 add_setshow_string_noescape_cmd ("exec-file", class_files,
12614 &remote_exec_file, _("\
12615 Set the remote pathname for \"run\""), _("\
12616 Show the remote pathname for \"run\""), NULL, NULL, NULL,
12617 &remote_set_cmdlist, &remote_show_cmdlist);
12619 add_setshow_boolean_cmd ("range-stepping", class_run,
12620 &use_range_stepping, _("\
12621 Enable or disable range stepping."), _("\
12622 Show whether target-assisted range stepping is enabled."), _("\
12623 If on, and the target supports it, when stepping a source line, GDB\n\
12624 tells the target to step the corresponding range of addresses itself instead\n\
12625 of issuing multiple single-steps. This speeds up source level\n\
12626 stepping. If off, GDB always issues single-steps, even if range\n\
12627 stepping is supported by the target. The default is on."),
12628 set_range_stepping,
12629 show_range_stepping,
12633 /* Eventually initialize fileio. See fileio.c */
12634 initialize_remote_fileio (remote_set_cmdlist, remote_show_cmdlist);
12636 /* Take advantage of the fact that the TID field is not used, to tag
12637 special ptids with it set to != 0. */
12638 magic_null_ptid = ptid_build (42000, -1, 1);
12639 not_sent_ptid = ptid_build (42000, -2, 1);
12640 any_thread_ptid = ptid_build (42000, 0, 1);
12642 target_buf_size = 2048;
12643 target_buf = xmalloc (target_buf_size);