1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2016 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
20 /* See the GDB User Guide for details of the GDB remote protocol. */
30 /*#include "terminal.h" */
33 #include "gdb-stabs.h"
34 #include "gdbthread.h"
36 #include "remote-notif.h"
41 #include "cli/cli-decode.h"
42 #include "cli/cli-setshow.h"
43 #include "target-descriptions.h"
45 #include "filestuff.h"
50 #include "gdb_sys_time.h"
52 #include "event-loop.h"
53 #include "event-top.h"
59 #include "gdbcore.h" /* for exec_bfd */
61 #include "remote-fileio.h"
62 #include "gdb/fileio.h"
64 #include "xml-support.h"
66 #include "memory-map.h"
68 #include "tracepoint.h"
74 /* Temp hacks for tracepoint encoding migration. */
75 static char *target_buf;
76 static long target_buf_size;
78 /* Per-program-space data key. */
79 static const struct program_space_data *remote_pspace_data;
81 /* The variable registered as the control variable used by the
82 remote exec-file commands. While the remote exec-file setting is
83 per-program-space, the set/show machinery uses this as the
84 location of the remote exec-file value. */
85 static char *remote_exec_file_var;
87 /* The size to align memory write packets, when practical. The protocol
88 does not guarantee any alignment, and gdb will generate short
89 writes and unaligned writes, but even as a best-effort attempt this
90 can improve bulk transfers. For instance, if a write is misaligned
91 relative to the target's data bus, the stub may need to make an extra
92 round trip fetching data from the target. This doesn't make a
93 huge difference, but it's easy to do, so we try to be helpful.
95 The alignment chosen is arbitrary; usually data bus width is
96 important here, not the possibly larger cache line size. */
97 enum { REMOTE_ALIGN_WRITES = 16 };
99 /* Prototypes for local functions. */
100 static void async_cleanup_sigint_signal_handler (void *dummy);
101 static int getpkt_sane (char **buf, long *sizeof_buf, int forever);
102 static int getpkt_or_notif_sane (char **buf, long *sizeof_buf,
103 int forever, int *is_notif);
105 static void async_handle_remote_sigint (int);
106 static void async_handle_remote_sigint_twice (int);
108 static void remote_files_info (struct target_ops *ignore);
110 static void remote_prepare_to_store (struct target_ops *self,
111 struct regcache *regcache);
113 static void remote_open_1 (const char *, int, struct target_ops *,
116 static void remote_close (struct target_ops *self);
120 static int remote_vkill (int pid, struct remote_state *rs);
122 static void remote_kill_k (void);
124 static void remote_mourn (struct target_ops *ops);
126 static void extended_remote_restart (void);
128 static void remote_send (char **buf, long *sizeof_buf_p);
130 static int readchar (int timeout);
132 static void remote_serial_write (const char *str, int len);
134 static void remote_kill (struct target_ops *ops);
136 static int remote_can_async_p (struct target_ops *);
138 static int remote_is_async_p (struct target_ops *);
140 static void remote_async (struct target_ops *ops, int enable);
142 static void remote_thread_events (struct target_ops *ops, int enable);
144 static void sync_remote_interrupt_twice (int signo);
146 static void interrupt_query (void);
148 static void set_general_thread (struct ptid ptid);
149 static void set_continue_thread (struct ptid ptid);
151 static void get_offsets (void);
153 static void skip_frame (void);
155 static long read_frame (char **buf_p, long *sizeof_buf);
157 static int hexnumlen (ULONGEST num);
159 static void init_remote_ops (void);
161 static void init_extended_remote_ops (void);
163 static void remote_stop (struct target_ops *self, ptid_t);
165 static int stubhex (int ch);
167 static int hexnumstr (char *, ULONGEST);
169 static int hexnumnstr (char *, ULONGEST, int);
171 static CORE_ADDR remote_address_masked (CORE_ADDR);
173 static void print_packet (const char *);
175 static void compare_sections_command (char *, int);
177 static void packet_command (char *, int);
179 static int stub_unpack_int (char *buff, int fieldlength);
181 static ptid_t remote_current_thread (ptid_t oldptid);
183 static int putpkt_binary (const char *buf, int cnt);
185 static void check_binary_download (CORE_ADDR addr);
187 struct packet_config;
189 static void show_packet_config_cmd (struct packet_config *config);
191 static void show_remote_protocol_packet_cmd (struct ui_file *file,
193 struct cmd_list_element *c,
196 static char *write_ptid (char *buf, const char *endbuf, ptid_t ptid);
197 static ptid_t read_ptid (char *buf, char **obuf);
199 static void remote_set_permissions (struct target_ops *self);
201 static int remote_get_trace_status (struct target_ops *self,
202 struct trace_status *ts);
204 static int remote_upload_tracepoints (struct target_ops *self,
205 struct uploaded_tp **utpp);
207 static int remote_upload_trace_state_variables (struct target_ops *self,
208 struct uploaded_tsv **utsvp);
210 static void remote_query_supported (void);
212 static void remote_check_symbols (void);
214 void _initialize_remote (void);
217 static void stop_reply_xfree (struct stop_reply *);
218 static void remote_parse_stop_reply (char *, struct stop_reply *);
219 static void push_stop_reply (struct stop_reply *);
220 static void discard_pending_stop_replies_in_queue (struct remote_state *);
221 static int peek_stop_reply (ptid_t ptid);
223 struct threads_listing_context;
224 static void remove_new_fork_children (struct threads_listing_context *);
226 static void remote_async_inferior_event_handler (gdb_client_data);
228 static void remote_terminal_ours (struct target_ops *self);
230 static int remote_read_description_p (struct target_ops *target);
232 static void remote_console_output (char *msg);
234 static int remote_supports_cond_breakpoints (struct target_ops *self);
236 static int remote_can_run_breakpoint_commands (struct target_ops *self);
238 static void remote_btrace_reset (void);
240 static int stop_reply_queue_length (void);
242 static void readahead_cache_invalidate (void);
246 static struct cmd_list_element *remote_cmdlist;
248 /* For "set remote" and "show remote". */
250 static struct cmd_list_element *remote_set_cmdlist;
251 static struct cmd_list_element *remote_show_cmdlist;
253 /* Stub vCont actions support.
255 Each field is a boolean flag indicating whether the stub reports
256 support for the corresponding action. */
258 struct vCont_action_support
273 /* Controls whether GDB is willing to use range stepping. */
275 static int use_range_stepping = 1;
277 #define OPAQUETHREADBYTES 8
279 /* a 64 bit opaque identifier */
280 typedef unsigned char threadref[OPAQUETHREADBYTES];
282 /* About this many threadisds fit in a packet. */
284 #define MAXTHREADLISTRESULTS 32
286 /* Data for the vFile:pread readahead cache. */
288 struct readahead_cache
290 /* The file descriptor for the file that is being cached. -1 if the
294 /* The offset into the file that the cache buffer corresponds
298 /* The buffer holding the cache contents. */
300 /* The buffer's size. We try to read as much as fits into a packet
304 /* Cache hit and miss counters. */
309 /* Description of the remote protocol state for the currently
310 connected target. This is per-target state, and independent of the
311 selected architecture. */
315 /* A buffer to use for incoming packets, and its current size. The
316 buffer is grown dynamically for larger incoming packets.
317 Outgoing packets may also be constructed in this buffer.
318 BUF_SIZE is always at least REMOTE_PACKET_SIZE;
319 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
324 /* True if we're going through initial connection setup (finding out
325 about the remote side's threads, relocating symbols, etc.). */
328 /* If we negotiated packet size explicitly (and thus can bypass
329 heuristics for the largest packet size that will not overflow
330 a buffer in the stub), this will be set to that packet size.
331 Otherwise zero, meaning to use the guessed size. */
332 long explicit_packet_size;
334 /* remote_wait is normally called when the target is running and
335 waits for a stop reply packet. But sometimes we need to call it
336 when the target is already stopped. We can send a "?" packet
337 and have remote_wait read the response. Or, if we already have
338 the response, we can stash it in BUF and tell remote_wait to
339 skip calling getpkt. This flag is set when BUF contains a
340 stop reply packet and the target is not waiting. */
341 int cached_wait_status;
343 /* True, if in no ack mode. That is, neither GDB nor the stub will
344 expect acks from each other. The connection is assumed to be
348 /* True if we're connected in extended remote mode. */
351 /* True if we resumed the target and we're waiting for the target to
352 stop. In the mean time, we can't start another command/query.
353 The remote server wouldn't be ready to process it, so we'd
354 timeout waiting for a reply that would never come and eventually
355 we'd close the connection. This can happen in asynchronous mode
356 because we allow GDB commands while the target is running. */
357 int waiting_for_stop_reply;
359 /* The status of the stub support for the various vCont actions. */
360 struct vCont_action_support supports_vCont;
362 /* Nonzero if the user has pressed Ctrl-C, but the target hasn't
363 responded to that. */
366 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
367 remote_open knows that we don't have a file open when the program
369 struct serial *remote_desc;
371 /* These are the threads which we last sent to the remote system. The
372 TID member will be -1 for all or -2 for not sent yet. */
373 ptid_t general_thread;
374 ptid_t continue_thread;
376 /* This is the traceframe which we last selected on the remote system.
377 It will be -1 if no traceframe is selected. */
378 int remote_traceframe_number;
380 char *last_pass_packet;
382 /* The last QProgramSignals packet sent to the target. We bypass
383 sending a new program signals list down to the target if the new
384 packet is exactly the same as the last we sent. IOW, we only let
385 the target know about program signals list changes. */
386 char *last_program_signals_packet;
388 enum gdb_signal last_sent_signal;
392 char *finished_object;
393 char *finished_annex;
394 ULONGEST finished_offset;
396 /* Should we try the 'ThreadInfo' query packet?
398 This variable (NOT available to the user: auto-detect only!)
399 determines whether GDB will use the new, simpler "ThreadInfo"
400 query or the older, more complex syntax for thread queries.
401 This is an auto-detect variable (set to true at each connect,
402 and set to false when the target fails to recognize it). */
403 int use_threadinfo_query;
404 int use_threadextra_query;
406 threadref echo_nextthread;
407 threadref nextthread;
408 threadref resultthreadlist[MAXTHREADLISTRESULTS];
410 /* The state of remote notification. */
411 struct remote_notif_state *notif_state;
413 /* The branch trace configuration. */
414 struct btrace_config btrace_config;
416 /* The argument to the last "vFile:setfs:" packet we sent, used
417 to avoid sending repeated unnecessary "vFile:setfs:" packets.
418 Initialized to -1 to indicate that no "vFile:setfs:" packet
419 has yet been sent. */
422 /* A readahead cache for vFile:pread. Often, reading a binary
423 involves a sequence of small reads. E.g., when parsing an ELF
424 file. A readahead cache helps mostly the case of remote
425 debugging on a connection with higher latency, due to the
426 request/reply nature of the RSP. We only cache data for a single
427 file descriptor at a time. */
428 struct readahead_cache readahead_cache;
431 /* Private data that we'll store in (struct thread_info)->private. */
432 struct private_thread_info
438 /* Whether the target stopped for a breakpoint/watchpoint. */
439 enum target_stop_reason stop_reason;
441 /* This is set to the data address of the access causing the target
442 to stop for a watchpoint. */
443 CORE_ADDR watch_data_address;
447 free_private_thread_info (struct private_thread_info *info)
454 /* This data could be associated with a target, but we do not always
455 have access to the current target when we need it, so for now it is
456 static. This will be fine for as long as only one target is in use
458 static struct remote_state *remote_state;
460 static struct remote_state *
461 get_remote_state_raw (void)
466 /* Allocate a new struct remote_state with xmalloc, initialize it, and
469 static struct remote_state *
470 new_remote_state (void)
472 struct remote_state *result = XCNEW (struct remote_state);
474 /* The default buffer size is unimportant; it will be expanded
475 whenever a larger buffer is needed. */
476 result->buf_size = 400;
477 result->buf = (char *) xmalloc (result->buf_size);
478 result->remote_traceframe_number = -1;
479 result->last_sent_signal = GDB_SIGNAL_0;
485 /* Description of the remote protocol for a given architecture. */
489 long offset; /* Offset into G packet. */
490 long regnum; /* GDB's internal register number. */
491 LONGEST pnum; /* Remote protocol register number. */
492 int in_g_packet; /* Always part of G packet. */
493 /* long size in bytes; == register_size (target_gdbarch (), regnum);
495 /* char *name; == gdbarch_register_name (target_gdbarch (), regnum);
499 struct remote_arch_state
501 /* Description of the remote protocol registers. */
502 long sizeof_g_packet;
504 /* Description of the remote protocol registers indexed by REGNUM
505 (making an array gdbarch_num_regs in size). */
506 struct packet_reg *regs;
508 /* This is the size (in chars) of the first response to the ``g''
509 packet. It is used as a heuristic when determining the maximum
510 size of memory-read and memory-write packets. A target will
511 typically only reserve a buffer large enough to hold the ``g''
512 packet. The size does not include packet overhead (headers and
514 long actual_register_packet_size;
516 /* This is the maximum size (in chars) of a non read/write packet.
517 It is also used as a cap on the size of read/write packets. */
518 long remote_packet_size;
521 /* Utility: generate error from an incoming stub packet. */
523 trace_error (char *buf)
526 return; /* not an error msg */
529 case '1': /* malformed packet error */
530 if (*++buf == '0') /* general case: */
531 error (_("remote.c: error in outgoing packet."));
533 error (_("remote.c: error in outgoing packet at field #%ld."),
534 strtol (buf, NULL, 16));
536 error (_("Target returns error code '%s'."), buf);
540 /* Utility: wait for reply from stub, while accepting "O" packets. */
542 remote_get_noisy_reply (char **buf_p,
545 do /* Loop on reply from remote stub. */
549 QUIT; /* Allow user to bail out with ^C. */
550 getpkt (buf_p, sizeof_buf, 0);
554 else if (startswith (buf, "qRelocInsn:"))
557 CORE_ADDR from, to, org_to;
559 int adjusted_size = 0;
562 p = buf + strlen ("qRelocInsn:");
563 pp = unpack_varlen_hex (p, &ul);
565 error (_("invalid qRelocInsn packet: %s"), buf);
569 unpack_varlen_hex (p, &ul);
576 gdbarch_relocate_instruction (target_gdbarch (), &to, from);
579 CATCH (ex, RETURN_MASK_ALL)
581 if (ex.error == MEMORY_ERROR)
583 /* Propagate memory errors silently back to the
584 target. The stub may have limited the range of
585 addresses we can write to, for example. */
589 /* Something unexpectedly bad happened. Be verbose
590 so we can tell what, and propagate the error back
591 to the stub, so it doesn't get stuck waiting for
593 exception_fprintf (gdb_stderr, ex,
594 _("warning: relocating instruction: "));
602 adjusted_size = to - org_to;
604 xsnprintf (buf, *sizeof_buf, "qRelocInsn:%x", adjusted_size);
608 else if (buf[0] == 'O' && buf[1] != 'K')
609 remote_console_output (buf + 1); /* 'O' message from stub */
611 return buf; /* Here's the actual reply. */
616 /* Handle for retreving the remote protocol data from gdbarch. */
617 static struct gdbarch_data *remote_gdbarch_data_handle;
619 static struct remote_arch_state *
620 get_remote_arch_state (void)
622 gdb_assert (target_gdbarch () != NULL);
623 return ((struct remote_arch_state *)
624 gdbarch_data (target_gdbarch (), remote_gdbarch_data_handle));
627 /* Fetch the global remote target state. */
629 static struct remote_state *
630 get_remote_state (void)
632 /* Make sure that the remote architecture state has been
633 initialized, because doing so might reallocate rs->buf. Any
634 function which calls getpkt also needs to be mindful of changes
635 to rs->buf, but this call limits the number of places which run
637 get_remote_arch_state ();
639 return get_remote_state_raw ();
642 /* Cleanup routine for the remote module's pspace data. */
645 remote_pspace_data_cleanup (struct program_space *pspace, void *arg)
647 char *remote_exec_file = (char *) arg;
649 xfree (remote_exec_file);
652 /* Fetch the remote exec-file from the current program space. */
655 get_remote_exec_file (void)
657 char *remote_exec_file;
660 = (char *) program_space_data (current_program_space,
662 if (remote_exec_file == NULL)
665 return remote_exec_file;
668 /* Set the remote exec file for PSPACE. */
671 set_pspace_remote_exec_file (struct program_space *pspace,
672 char *remote_exec_file)
674 char *old_file = (char *) program_space_data (pspace, remote_pspace_data);
677 set_program_space_data (pspace, remote_pspace_data,
678 xstrdup (remote_exec_file));
681 /* The "set/show remote exec-file" set command hook. */
684 set_remote_exec_file (char *ignored, int from_tty,
685 struct cmd_list_element *c)
687 gdb_assert (remote_exec_file_var != NULL);
688 set_pspace_remote_exec_file (current_program_space, remote_exec_file_var);
691 /* The "set/show remote exec-file" show command hook. */
694 show_remote_exec_file (struct ui_file *file, int from_tty,
695 struct cmd_list_element *cmd, const char *value)
697 fprintf_filtered (file, "%s\n", remote_exec_file_var);
701 compare_pnums (const void *lhs_, const void *rhs_)
703 const struct packet_reg * const *lhs
704 = (const struct packet_reg * const *) lhs_;
705 const struct packet_reg * const *rhs
706 = (const struct packet_reg * const *) rhs_;
708 if ((*lhs)->pnum < (*rhs)->pnum)
710 else if ((*lhs)->pnum == (*rhs)->pnum)
717 map_regcache_remote_table (struct gdbarch *gdbarch, struct packet_reg *regs)
719 int regnum, num_remote_regs, offset;
720 struct packet_reg **remote_regs;
722 for (regnum = 0; regnum < gdbarch_num_regs (gdbarch); regnum++)
724 struct packet_reg *r = ®s[regnum];
726 if (register_size (gdbarch, regnum) == 0)
727 /* Do not try to fetch zero-sized (placeholder) registers. */
730 r->pnum = gdbarch_remote_register_number (gdbarch, regnum);
735 /* Define the g/G packet format as the contents of each register
736 with a remote protocol number, in order of ascending protocol
739 remote_regs = XALLOCAVEC (struct packet_reg *, gdbarch_num_regs (gdbarch));
740 for (num_remote_regs = 0, regnum = 0;
741 regnum < gdbarch_num_regs (gdbarch);
743 if (regs[regnum].pnum != -1)
744 remote_regs[num_remote_regs++] = ®s[regnum];
746 qsort (remote_regs, num_remote_regs, sizeof (struct packet_reg *),
749 for (regnum = 0, offset = 0; regnum < num_remote_regs; regnum++)
751 remote_regs[regnum]->in_g_packet = 1;
752 remote_regs[regnum]->offset = offset;
753 offset += register_size (gdbarch, remote_regs[regnum]->regnum);
759 /* Given the architecture described by GDBARCH, return the remote
760 protocol register's number and the register's offset in the g/G
761 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
762 If the target does not have a mapping for REGNUM, return false,
763 otherwise, return true. */
766 remote_register_number_and_offset (struct gdbarch *gdbarch, int regnum,
767 int *pnum, int *poffset)
769 struct packet_reg *regs;
770 struct cleanup *old_chain;
772 gdb_assert (regnum < gdbarch_num_regs (gdbarch));
774 regs = XCNEWVEC (struct packet_reg, gdbarch_num_regs (gdbarch));
775 old_chain = make_cleanup (xfree, regs);
777 map_regcache_remote_table (gdbarch, regs);
779 *pnum = regs[regnum].pnum;
780 *poffset = regs[regnum].offset;
782 do_cleanups (old_chain);
788 init_remote_state (struct gdbarch *gdbarch)
790 struct remote_state *rs = get_remote_state_raw ();
791 struct remote_arch_state *rsa;
793 rsa = GDBARCH_OBSTACK_ZALLOC (gdbarch, struct remote_arch_state);
795 /* Use the architecture to build a regnum<->pnum table, which will be
796 1:1 unless a feature set specifies otherwise. */
797 rsa->regs = GDBARCH_OBSTACK_CALLOC (gdbarch,
798 gdbarch_num_regs (gdbarch),
801 /* Record the maximum possible size of the g packet - it may turn out
803 rsa->sizeof_g_packet = map_regcache_remote_table (gdbarch, rsa->regs);
805 /* Default maximum number of characters in a packet body. Many
806 remote stubs have a hardwired buffer size of 400 bytes
807 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
808 as the maximum packet-size to ensure that the packet and an extra
809 NUL character can always fit in the buffer. This stops GDB
810 trashing stubs that try to squeeze an extra NUL into what is
811 already a full buffer (As of 1999-12-04 that was most stubs). */
812 rsa->remote_packet_size = 400 - 1;
814 /* This one is filled in when a ``g'' packet is received. */
815 rsa->actual_register_packet_size = 0;
817 /* Should rsa->sizeof_g_packet needs more space than the
818 default, adjust the size accordingly. Remember that each byte is
819 encoded as two characters. 32 is the overhead for the packet
820 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
821 (``$NN:G...#NN'') is a better guess, the below has been padded a
823 if (rsa->sizeof_g_packet > ((rsa->remote_packet_size - 32) / 2))
824 rsa->remote_packet_size = (rsa->sizeof_g_packet * 2 + 32);
826 /* Make sure that the packet buffer is plenty big enough for
827 this architecture. */
828 if (rs->buf_size < rsa->remote_packet_size)
830 rs->buf_size = 2 * rsa->remote_packet_size;
831 rs->buf = (char *) xrealloc (rs->buf, rs->buf_size);
837 /* Return the current allowed size of a remote packet. This is
838 inferred from the current architecture, and should be used to
839 limit the length of outgoing packets. */
841 get_remote_packet_size (void)
843 struct remote_state *rs = get_remote_state ();
844 struct remote_arch_state *rsa = get_remote_arch_state ();
846 if (rs->explicit_packet_size)
847 return rs->explicit_packet_size;
849 return rsa->remote_packet_size;
852 static struct packet_reg *
853 packet_reg_from_regnum (struct remote_arch_state *rsa, long regnum)
855 if (regnum < 0 && regnum >= gdbarch_num_regs (target_gdbarch ()))
859 struct packet_reg *r = &rsa->regs[regnum];
861 gdb_assert (r->regnum == regnum);
866 static struct packet_reg *
867 packet_reg_from_pnum (struct remote_arch_state *rsa, LONGEST pnum)
871 for (i = 0; i < gdbarch_num_regs (target_gdbarch ()); i++)
873 struct packet_reg *r = &rsa->regs[i];
881 static struct target_ops remote_ops;
883 static struct target_ops extended_remote_ops;
885 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
886 ``forever'' still use the normal timeout mechanism. This is
887 currently used by the ASYNC code to guarentee that target reads
888 during the initial connect always time-out. Once getpkt has been
889 modified to return a timeout indication and, in turn
890 remote_wait()/wait_for_inferior() have gained a timeout parameter
892 static int wait_forever_enabled_p = 1;
894 /* Allow the user to specify what sequence to send to the remote
895 when he requests a program interruption: Although ^C is usually
896 what remote systems expect (this is the default, here), it is
897 sometimes preferable to send a break. On other systems such
898 as the Linux kernel, a break followed by g, which is Magic SysRq g
899 is required in order to interrupt the execution. */
900 const char interrupt_sequence_control_c[] = "Ctrl-C";
901 const char interrupt_sequence_break[] = "BREAK";
902 const char interrupt_sequence_break_g[] = "BREAK-g";
903 static const char *const interrupt_sequence_modes[] =
905 interrupt_sequence_control_c,
906 interrupt_sequence_break,
907 interrupt_sequence_break_g,
910 static const char *interrupt_sequence_mode = interrupt_sequence_control_c;
913 show_interrupt_sequence (struct ui_file *file, int from_tty,
914 struct cmd_list_element *c,
917 if (interrupt_sequence_mode == interrupt_sequence_control_c)
918 fprintf_filtered (file,
919 _("Send the ASCII ETX character (Ctrl-c) "
920 "to the remote target to interrupt the "
921 "execution of the program.\n"));
922 else if (interrupt_sequence_mode == interrupt_sequence_break)
923 fprintf_filtered (file,
924 _("send a break signal to the remote target "
925 "to interrupt the execution of the program.\n"));
926 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
927 fprintf_filtered (file,
928 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
929 "the remote target to interrupt the execution "
930 "of Linux kernel.\n"));
932 internal_error (__FILE__, __LINE__,
933 _("Invalid value for interrupt_sequence_mode: %s."),
934 interrupt_sequence_mode);
937 /* This boolean variable specifies whether interrupt_sequence is sent
938 to the remote target when gdb connects to it.
939 This is mostly needed when you debug the Linux kernel: The Linux kernel
940 expects BREAK g which is Magic SysRq g for connecting gdb. */
941 static int interrupt_on_connect = 0;
943 /* This variable is used to implement the "set/show remotebreak" commands.
944 Since these commands are now deprecated in favor of "set/show remote
945 interrupt-sequence", it no longer has any effect on the code. */
946 static int remote_break;
949 set_remotebreak (char *args, int from_tty, struct cmd_list_element *c)
952 interrupt_sequence_mode = interrupt_sequence_break;
954 interrupt_sequence_mode = interrupt_sequence_control_c;
958 show_remotebreak (struct ui_file *file, int from_tty,
959 struct cmd_list_element *c,
964 /* This variable sets the number of bits in an address that are to be
965 sent in a memory ("M" or "m") packet. Normally, after stripping
966 leading zeros, the entire address would be sent. This variable
967 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
968 initial implementation of remote.c restricted the address sent in
969 memory packets to ``host::sizeof long'' bytes - (typically 32
970 bits). Consequently, for 64 bit targets, the upper 32 bits of an
971 address was never sent. Since fixing this bug may cause a break in
972 some remote targets this variable is principly provided to
973 facilitate backward compatibility. */
975 static unsigned int remote_address_size;
977 /* Temporary to track who currently owns the terminal. See
978 remote_terminal_* for more details. */
980 static int remote_async_terminal_ours_p;
983 /* User configurable variables for the number of characters in a
984 memory read/write packet. MIN (rsa->remote_packet_size,
985 rsa->sizeof_g_packet) is the default. Some targets need smaller
986 values (fifo overruns, et.al.) and some users need larger values
987 (speed up transfers). The variables ``preferred_*'' (the user
988 request), ``current_*'' (what was actually set) and ``forced_*''
989 (Positive - a soft limit, negative - a hard limit). */
991 struct memory_packet_config
998 /* The default max memory-write-packet-size. The 16k is historical.
999 (It came from older GDB's using alloca for buffers and the
1000 knowledge (folklore?) that some hosts don't cope very well with
1001 large alloca calls.) */
1002 #define DEFAULT_MAX_MEMORY_PACKET_SIZE 16384
1004 /* The minimum remote packet size for memory transfers. Ensures we
1005 can write at least one byte. */
1006 #define MIN_MEMORY_PACKET_SIZE 20
1008 /* Compute the current size of a read/write packet. Since this makes
1009 use of ``actual_register_packet_size'' the computation is dynamic. */
1012 get_memory_packet_size (struct memory_packet_config *config)
1014 struct remote_state *rs = get_remote_state ();
1015 struct remote_arch_state *rsa = get_remote_arch_state ();
1018 if (config->fixed_p)
1020 if (config->size <= 0)
1021 what_they_get = DEFAULT_MAX_MEMORY_PACKET_SIZE;
1023 what_they_get = config->size;
1027 what_they_get = get_remote_packet_size ();
1028 /* Limit the packet to the size specified by the user. */
1029 if (config->size > 0
1030 && what_they_get > config->size)
1031 what_they_get = config->size;
1033 /* Limit it to the size of the targets ``g'' response unless we have
1034 permission from the stub to use a larger packet size. */
1035 if (rs->explicit_packet_size == 0
1036 && rsa->actual_register_packet_size > 0
1037 && what_they_get > rsa->actual_register_packet_size)
1038 what_they_get = rsa->actual_register_packet_size;
1040 if (what_they_get < MIN_MEMORY_PACKET_SIZE)
1041 what_they_get = MIN_MEMORY_PACKET_SIZE;
1043 /* Make sure there is room in the global buffer for this packet
1044 (including its trailing NUL byte). */
1045 if (rs->buf_size < what_they_get + 1)
1047 rs->buf_size = 2 * what_they_get;
1048 rs->buf = (char *) xrealloc (rs->buf, 2 * what_they_get);
1051 return what_they_get;
1054 /* Update the size of a read/write packet. If they user wants
1055 something really big then do a sanity check. */
1058 set_memory_packet_size (char *args, struct memory_packet_config *config)
1060 int fixed_p = config->fixed_p;
1061 long size = config->size;
1064 error (_("Argument required (integer, `fixed' or `limited')."));
1065 else if (strcmp (args, "hard") == 0
1066 || strcmp (args, "fixed") == 0)
1068 else if (strcmp (args, "soft") == 0
1069 || strcmp (args, "limit") == 0)
1075 size = strtoul (args, &end, 0);
1077 error (_("Invalid %s (bad syntax)."), config->name);
1079 /* Instead of explicitly capping the size of a packet to or
1080 disallowing it, the user is allowed to set the size to
1081 something arbitrarily large. */
1084 /* So that the query shows the correct value. */
1086 size = DEFAULT_MAX_MEMORY_PACKET_SIZE;
1089 if (fixed_p && !config->fixed_p)
1091 if (! query (_("The target may not be able to correctly handle a %s\n"
1092 "of %ld bytes. Change the packet size? "),
1093 config->name, size))
1094 error (_("Packet size not changed."));
1096 /* Update the config. */
1097 config->fixed_p = fixed_p;
1098 config->size = size;
1102 show_memory_packet_size (struct memory_packet_config *config)
1104 printf_filtered (_("The %s is %ld. "), config->name, config->size);
1105 if (config->fixed_p)
1106 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
1107 get_memory_packet_size (config));
1109 printf_filtered (_("Packets are limited to %ld bytes.\n"),
1110 get_memory_packet_size (config));
1113 static struct memory_packet_config memory_write_packet_config =
1115 "memory-write-packet-size",
1119 set_memory_write_packet_size (char *args, int from_tty)
1121 set_memory_packet_size (args, &memory_write_packet_config);
1125 show_memory_write_packet_size (char *args, int from_tty)
1127 show_memory_packet_size (&memory_write_packet_config);
1131 get_memory_write_packet_size (void)
1133 return get_memory_packet_size (&memory_write_packet_config);
1136 static struct memory_packet_config memory_read_packet_config =
1138 "memory-read-packet-size",
1142 set_memory_read_packet_size (char *args, int from_tty)
1144 set_memory_packet_size (args, &memory_read_packet_config);
1148 show_memory_read_packet_size (char *args, int from_tty)
1150 show_memory_packet_size (&memory_read_packet_config);
1154 get_memory_read_packet_size (void)
1156 long size = get_memory_packet_size (&memory_read_packet_config);
1158 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1159 extra buffer size argument before the memory read size can be
1160 increased beyond this. */
1161 if (size > get_remote_packet_size ())
1162 size = get_remote_packet_size ();
1167 /* Generic configuration support for packets the stub optionally
1168 supports. Allows the user to specify the use of the packet as well
1169 as allowing GDB to auto-detect support in the remote stub. */
1173 PACKET_SUPPORT_UNKNOWN = 0,
1178 struct packet_config
1183 /* If auto, GDB auto-detects support for this packet or feature,
1184 either through qSupported, or by trying the packet and looking
1185 at the response. If true, GDB assumes the target supports this
1186 packet. If false, the packet is disabled. Configs that don't
1187 have an associated command always have this set to auto. */
1188 enum auto_boolean detect;
1190 /* Does the target support this packet? */
1191 enum packet_support support;
1194 /* Analyze a packet's return value and update the packet config
1204 static enum packet_support packet_config_support (struct packet_config *config);
1205 static enum packet_support packet_support (int packet);
1208 show_packet_config_cmd (struct packet_config *config)
1210 char *support = "internal-error";
1212 switch (packet_config_support (config))
1215 support = "enabled";
1217 case PACKET_DISABLE:
1218 support = "disabled";
1220 case PACKET_SUPPORT_UNKNOWN:
1221 support = "unknown";
1224 switch (config->detect)
1226 case AUTO_BOOLEAN_AUTO:
1227 printf_filtered (_("Support for the `%s' packet "
1228 "is auto-detected, currently %s.\n"),
1229 config->name, support);
1231 case AUTO_BOOLEAN_TRUE:
1232 case AUTO_BOOLEAN_FALSE:
1233 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1234 config->name, support);
1240 add_packet_config_cmd (struct packet_config *config, const char *name,
1241 const char *title, int legacy)
1247 config->name = name;
1248 config->title = title;
1249 set_doc = xstrprintf ("Set use of remote protocol `%s' (%s) packet",
1251 show_doc = xstrprintf ("Show current use of remote "
1252 "protocol `%s' (%s) packet",
1254 /* set/show TITLE-packet {auto,on,off} */
1255 cmd_name = xstrprintf ("%s-packet", title);
1256 add_setshow_auto_boolean_cmd (cmd_name, class_obscure,
1257 &config->detect, set_doc,
1258 show_doc, NULL, /* help_doc */
1260 show_remote_protocol_packet_cmd,
1261 &remote_set_cmdlist, &remote_show_cmdlist);
1262 /* The command code copies the documentation strings. */
1265 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1270 legacy_name = xstrprintf ("%s-packet", name);
1271 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1272 &remote_set_cmdlist);
1273 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1274 &remote_show_cmdlist);
1278 static enum packet_result
1279 packet_check_result (const char *buf)
1283 /* The stub recognized the packet request. Check that the
1284 operation succeeded. */
1286 && isxdigit (buf[1]) && isxdigit (buf[2])
1288 /* "Enn" - definitly an error. */
1289 return PACKET_ERROR;
1291 /* Always treat "E." as an error. This will be used for
1292 more verbose error messages, such as E.memtypes. */
1293 if (buf[0] == 'E' && buf[1] == '.')
1294 return PACKET_ERROR;
1296 /* The packet may or may not be OK. Just assume it is. */
1300 /* The stub does not support the packet. */
1301 return PACKET_UNKNOWN;
1304 static enum packet_result
1305 packet_ok (const char *buf, struct packet_config *config)
1307 enum packet_result result;
1309 if (config->detect != AUTO_BOOLEAN_TRUE
1310 && config->support == PACKET_DISABLE)
1311 internal_error (__FILE__, __LINE__,
1312 _("packet_ok: attempt to use a disabled packet"));
1314 result = packet_check_result (buf);
1319 /* The stub recognized the packet request. */
1320 if (config->support == PACKET_SUPPORT_UNKNOWN)
1323 fprintf_unfiltered (gdb_stdlog,
1324 "Packet %s (%s) is supported\n",
1325 config->name, config->title);
1326 config->support = PACKET_ENABLE;
1329 case PACKET_UNKNOWN:
1330 /* The stub does not support the packet. */
1331 if (config->detect == AUTO_BOOLEAN_AUTO
1332 && config->support == PACKET_ENABLE)
1334 /* If the stub previously indicated that the packet was
1335 supported then there is a protocol error. */
1336 error (_("Protocol error: %s (%s) conflicting enabled responses."),
1337 config->name, config->title);
1339 else if (config->detect == AUTO_BOOLEAN_TRUE)
1341 /* The user set it wrong. */
1342 error (_("Enabled packet %s (%s) not recognized by stub"),
1343 config->name, config->title);
1347 fprintf_unfiltered (gdb_stdlog,
1348 "Packet %s (%s) is NOT supported\n",
1349 config->name, config->title);
1350 config->support = PACKET_DISABLE;
1371 PACKET_vFile_pwrite,
1373 PACKET_vFile_unlink,
1374 PACKET_vFile_readlink,
1377 PACKET_qXfer_features,
1378 PACKET_qXfer_exec_file,
1379 PACKET_qXfer_libraries,
1380 PACKET_qXfer_libraries_svr4,
1381 PACKET_qXfer_memory_map,
1382 PACKET_qXfer_spu_read,
1383 PACKET_qXfer_spu_write,
1384 PACKET_qXfer_osdata,
1385 PACKET_qXfer_threads,
1386 PACKET_qXfer_statictrace_read,
1387 PACKET_qXfer_traceframe_info,
1393 PACKET_QPassSignals,
1394 PACKET_QCatchSyscalls,
1395 PACKET_QProgramSignals,
1397 PACKET_qSearch_memory,
1400 PACKET_QStartNoAckMode,
1402 PACKET_qXfer_siginfo_read,
1403 PACKET_qXfer_siginfo_write,
1406 /* Support for conditional tracepoints. */
1407 PACKET_ConditionalTracepoints,
1409 /* Support for target-side breakpoint conditions. */
1410 PACKET_ConditionalBreakpoints,
1412 /* Support for target-side breakpoint commands. */
1413 PACKET_BreakpointCommands,
1415 /* Support for fast tracepoints. */
1416 PACKET_FastTracepoints,
1418 /* Support for static tracepoints. */
1419 PACKET_StaticTracepoints,
1421 /* Support for installing tracepoints while a trace experiment is
1423 PACKET_InstallInTrace,
1427 PACKET_TracepointSource,
1430 PACKET_QDisableRandomization,
1432 PACKET_QTBuffer_size,
1436 PACKET_qXfer_btrace,
1438 /* Support for the QNonStop packet. */
1441 /* Support for the QThreadEvents packet. */
1442 PACKET_QThreadEvents,
1444 /* Support for multi-process extensions. */
1445 PACKET_multiprocess_feature,
1447 /* Support for enabling and disabling tracepoints while a trace
1448 experiment is running. */
1449 PACKET_EnableDisableTracepoints_feature,
1451 /* Support for collecting strings using the tracenz bytecode. */
1452 PACKET_tracenz_feature,
1454 /* Support for continuing to run a trace experiment while GDB is
1456 PACKET_DisconnectedTracing_feature,
1458 /* Support for qXfer:libraries-svr4:read with a non-empty annex. */
1459 PACKET_augmented_libraries_svr4_read_feature,
1461 /* Support for the qXfer:btrace-conf:read packet. */
1462 PACKET_qXfer_btrace_conf,
1464 /* Support for the Qbtrace-conf:bts:size packet. */
1465 PACKET_Qbtrace_conf_bts_size,
1467 /* Support for swbreak+ feature. */
1468 PACKET_swbreak_feature,
1470 /* Support for hwbreak+ feature. */
1471 PACKET_hwbreak_feature,
1473 /* Support for fork events. */
1474 PACKET_fork_event_feature,
1476 /* Support for vfork events. */
1477 PACKET_vfork_event_feature,
1479 /* Support for the Qbtrace-conf:pt:size packet. */
1480 PACKET_Qbtrace_conf_pt_size,
1482 /* Support for exec events. */
1483 PACKET_exec_event_feature,
1485 /* Support for query supported vCont actions. */
1486 PACKET_vContSupported,
1488 /* Support remote CTRL-C. */
1491 /* Support TARGET_WAITKIND_NO_RESUMED. */
1497 static struct packet_config remote_protocol_packets[PACKET_MAX];
1499 /* Returns the packet's corresponding "set remote foo-packet" command
1500 state. See struct packet_config for more details. */
1502 static enum auto_boolean
1503 packet_set_cmd_state (int packet)
1505 return remote_protocol_packets[packet].detect;
1508 /* Returns whether a given packet or feature is supported. This takes
1509 into account the state of the corresponding "set remote foo-packet"
1510 command, which may be used to bypass auto-detection. */
1512 static enum packet_support
1513 packet_config_support (struct packet_config *config)
1515 switch (config->detect)
1517 case AUTO_BOOLEAN_TRUE:
1518 return PACKET_ENABLE;
1519 case AUTO_BOOLEAN_FALSE:
1520 return PACKET_DISABLE;
1521 case AUTO_BOOLEAN_AUTO:
1522 return config->support;
1524 gdb_assert_not_reached (_("bad switch"));
1528 /* Same as packet_config_support, but takes the packet's enum value as
1531 static enum packet_support
1532 packet_support (int packet)
1534 struct packet_config *config = &remote_protocol_packets[packet];
1536 return packet_config_support (config);
1540 show_remote_protocol_packet_cmd (struct ui_file *file, int from_tty,
1541 struct cmd_list_element *c,
1544 struct packet_config *packet;
1546 for (packet = remote_protocol_packets;
1547 packet < &remote_protocol_packets[PACKET_MAX];
1550 if (&packet->detect == c->var)
1552 show_packet_config_cmd (packet);
1556 internal_error (__FILE__, __LINE__, _("Could not find config for %s"),
1560 /* Should we try one of the 'Z' requests? */
1564 Z_PACKET_SOFTWARE_BP,
1565 Z_PACKET_HARDWARE_BP,
1572 /* For compatibility with older distributions. Provide a ``set remote
1573 Z-packet ...'' command that updates all the Z packet types. */
1575 static enum auto_boolean remote_Z_packet_detect;
1578 set_remote_protocol_Z_packet_cmd (char *args, int from_tty,
1579 struct cmd_list_element *c)
1583 for (i = 0; i < NR_Z_PACKET_TYPES; i++)
1584 remote_protocol_packets[PACKET_Z0 + i].detect = remote_Z_packet_detect;
1588 show_remote_protocol_Z_packet_cmd (struct ui_file *file, int from_tty,
1589 struct cmd_list_element *c,
1594 for (i = 0; i < NR_Z_PACKET_TYPES; i++)
1596 show_packet_config_cmd (&remote_protocol_packets[PACKET_Z0 + i]);
1600 /* Returns true if the multi-process extensions are in effect. */
1603 remote_multi_process_p (struct remote_state *rs)
1605 return packet_support (PACKET_multiprocess_feature) == PACKET_ENABLE;
1608 /* Returns true if fork events are supported. */
1611 remote_fork_event_p (struct remote_state *rs)
1613 return packet_support (PACKET_fork_event_feature) == PACKET_ENABLE;
1616 /* Returns true if vfork events are supported. */
1619 remote_vfork_event_p (struct remote_state *rs)
1621 return packet_support (PACKET_vfork_event_feature) == PACKET_ENABLE;
1624 /* Returns true if exec events are supported. */
1627 remote_exec_event_p (struct remote_state *rs)
1629 return packet_support (PACKET_exec_event_feature) == PACKET_ENABLE;
1632 /* Insert fork catchpoint target routine. If fork events are enabled
1633 then return success, nothing more to do. */
1636 remote_insert_fork_catchpoint (struct target_ops *ops, int pid)
1638 struct remote_state *rs = get_remote_state ();
1640 return !remote_fork_event_p (rs);
1643 /* Remove fork catchpoint target routine. Nothing to do, just
1647 remote_remove_fork_catchpoint (struct target_ops *ops, int pid)
1652 /* Insert vfork catchpoint target routine. If vfork events are enabled
1653 then return success, nothing more to do. */
1656 remote_insert_vfork_catchpoint (struct target_ops *ops, int pid)
1658 struct remote_state *rs = get_remote_state ();
1660 return !remote_vfork_event_p (rs);
1663 /* Remove vfork catchpoint target routine. Nothing to do, just
1667 remote_remove_vfork_catchpoint (struct target_ops *ops, int pid)
1672 /* Insert exec catchpoint target routine. If exec events are
1673 enabled, just return success. */
1676 remote_insert_exec_catchpoint (struct target_ops *ops, int pid)
1678 struct remote_state *rs = get_remote_state ();
1680 return !remote_exec_event_p (rs);
1683 /* Remove exec catchpoint target routine. Nothing to do, just
1687 remote_remove_exec_catchpoint (struct target_ops *ops, int pid)
1692 /* Tokens for use by the asynchronous signal handlers for SIGINT. */
1693 static struct async_signal_handler *async_sigint_remote_twice_token;
1694 static struct async_signal_handler *async_sigint_remote_token;
1697 /* Asynchronous signal handle registered as event loop source for
1698 when we have pending events ready to be passed to the core. */
1700 static struct async_event_handler *remote_async_inferior_event_token;
1704 static ptid_t magic_null_ptid;
1705 static ptid_t not_sent_ptid;
1706 static ptid_t any_thread_ptid;
1708 /* Find out if the stub attached to PID (and hence GDB should offer to
1709 detach instead of killing it when bailing out). */
1712 remote_query_attached (int pid)
1714 struct remote_state *rs = get_remote_state ();
1715 size_t size = get_remote_packet_size ();
1717 if (packet_support (PACKET_qAttached) == PACKET_DISABLE)
1720 if (remote_multi_process_p (rs))
1721 xsnprintf (rs->buf, size, "qAttached:%x", pid);
1723 xsnprintf (rs->buf, size, "qAttached");
1726 getpkt (&rs->buf, &rs->buf_size, 0);
1728 switch (packet_ok (rs->buf,
1729 &remote_protocol_packets[PACKET_qAttached]))
1732 if (strcmp (rs->buf, "1") == 0)
1736 warning (_("Remote failure reply: %s"), rs->buf);
1738 case PACKET_UNKNOWN:
1745 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
1746 has been invented by GDB, instead of reported by the target. Since
1747 we can be connected to a remote system before before knowing about
1748 any inferior, mark the target with execution when we find the first
1749 inferior. If ATTACHED is 1, then we had just attached to this
1750 inferior. If it is 0, then we just created this inferior. If it
1751 is -1, then try querying the remote stub to find out if it had
1752 attached to the inferior or not. If TRY_OPEN_EXEC is true then
1753 attempt to open this inferior's executable as the main executable
1754 if no main executable is open already. */
1756 static struct inferior *
1757 remote_add_inferior (int fake_pid_p, int pid, int attached,
1760 struct inferior *inf;
1762 /* Check whether this process we're learning about is to be
1763 considered attached, or if is to be considered to have been
1764 spawned by the stub. */
1766 attached = remote_query_attached (pid);
1768 if (gdbarch_has_global_solist (target_gdbarch ()))
1770 /* If the target shares code across all inferiors, then every
1771 attach adds a new inferior. */
1772 inf = add_inferior (pid);
1774 /* ... and every inferior is bound to the same program space.
1775 However, each inferior may still have its own address
1777 inf->aspace = maybe_new_address_space ();
1778 inf->pspace = current_program_space;
1782 /* In the traditional debugging scenario, there's a 1-1 match
1783 between program/address spaces. We simply bind the inferior
1784 to the program space's address space. */
1785 inf = current_inferior ();
1786 inferior_appeared (inf, pid);
1789 inf->attach_flag = attached;
1790 inf->fake_pid_p = fake_pid_p;
1792 /* If no main executable is currently open then attempt to
1793 open the file that was executed to create this inferior. */
1794 if (try_open_exec && get_exec_file (0) == NULL)
1795 exec_file_locate_attach (pid, 1);
1800 /* Add thread PTID to GDB's thread list. Tag it as executing/running
1801 according to RUNNING. */
1804 remote_add_thread (ptid_t ptid, int running)
1806 struct remote_state *rs = get_remote_state ();
1808 /* GDB historically didn't pull threads in the initial connection
1809 setup. If the remote target doesn't even have a concept of
1810 threads (e.g., a bare-metal target), even if internally we
1811 consider that a single-threaded target, mentioning a new thread
1812 might be confusing to the user. Be silent then, preserving the
1813 age old behavior. */
1814 if (rs->starting_up)
1815 add_thread_silent (ptid);
1819 set_executing (ptid, running);
1820 set_running (ptid, running);
1823 /* Come here when we learn about a thread id from the remote target.
1824 It may be the first time we hear about such thread, so take the
1825 opportunity to add it to GDB's thread list. In case this is the
1826 first time we're noticing its corresponding inferior, add it to
1827 GDB's inferior list as well. */
1830 remote_notice_new_inferior (ptid_t currthread, int running)
1832 /* If this is a new thread, add it to GDB's thread list.
1833 If we leave it up to WFI to do this, bad things will happen. */
1835 if (in_thread_list (currthread) && is_exited (currthread))
1837 /* We're seeing an event on a thread id we knew had exited.
1838 This has to be a new thread reusing the old id. Add it. */
1839 remote_add_thread (currthread, running);
1843 if (!in_thread_list (currthread))
1845 struct inferior *inf = NULL;
1846 int pid = ptid_get_pid (currthread);
1848 if (ptid_is_pid (inferior_ptid)
1849 && pid == ptid_get_pid (inferior_ptid))
1851 /* inferior_ptid has no thread member yet. This can happen
1852 with the vAttach -> remote_wait,"TAAthread:" path if the
1853 stub doesn't support qC. This is the first stop reported
1854 after an attach, so this is the main thread. Update the
1855 ptid in the thread list. */
1856 if (in_thread_list (pid_to_ptid (pid)))
1857 thread_change_ptid (inferior_ptid, currthread);
1860 remote_add_thread (currthread, running);
1861 inferior_ptid = currthread;
1866 if (ptid_equal (magic_null_ptid, inferior_ptid))
1868 /* inferior_ptid is not set yet. This can happen with the
1869 vRun -> remote_wait,"TAAthread:" path if the stub
1870 doesn't support qC. This is the first stop reported
1871 after an attach, so this is the main thread. Update the
1872 ptid in the thread list. */
1873 thread_change_ptid (inferior_ptid, currthread);
1877 /* When connecting to a target remote, or to a target
1878 extended-remote which already was debugging an inferior, we
1879 may not know about it yet. Add it before adding its child
1880 thread, so notifications are emitted in a sensible order. */
1881 if (!in_inferior_list (ptid_get_pid (currthread)))
1883 struct remote_state *rs = get_remote_state ();
1884 int fake_pid_p = !remote_multi_process_p (rs);
1886 inf = remote_add_inferior (fake_pid_p,
1887 ptid_get_pid (currthread), -1, 1);
1890 /* This is really a new thread. Add it. */
1891 remote_add_thread (currthread, running);
1893 /* If we found a new inferior, let the common code do whatever
1894 it needs to with it (e.g., read shared libraries, insert
1895 breakpoints), unless we're just setting up an all-stop
1899 struct remote_state *rs = get_remote_state ();
1901 if (!rs->starting_up)
1902 notice_new_inferior (currthread, running, 0);
1907 /* Return the private thread data, creating it if necessary. */
1909 static struct private_thread_info *
1910 demand_private_info (ptid_t ptid)
1912 struct thread_info *info = find_thread_ptid (ptid);
1918 info->priv = XNEW (struct private_thread_info);
1919 info->private_dtor = free_private_thread_info;
1920 info->priv->core = -1;
1921 info->priv->extra = NULL;
1922 info->priv->name = NULL;
1928 /* Call this function as a result of
1929 1) A halt indication (T packet) containing a thread id
1930 2) A direct query of currthread
1931 3) Successful execution of set thread */
1934 record_currthread (struct remote_state *rs, ptid_t currthread)
1936 rs->general_thread = currthread;
1939 /* If 'QPassSignals' is supported, tell the remote stub what signals
1940 it can simply pass through to the inferior without reporting. */
1943 remote_pass_signals (struct target_ops *self,
1944 int numsigs, unsigned char *pass_signals)
1946 if (packet_support (PACKET_QPassSignals) != PACKET_DISABLE)
1948 char *pass_packet, *p;
1950 struct remote_state *rs = get_remote_state ();
1952 gdb_assert (numsigs < 256);
1953 for (i = 0; i < numsigs; i++)
1955 if (pass_signals[i])
1958 pass_packet = (char *) xmalloc (count * 3 + strlen ("QPassSignals:") + 1);
1959 strcpy (pass_packet, "QPassSignals:");
1960 p = pass_packet + strlen (pass_packet);
1961 for (i = 0; i < numsigs; i++)
1963 if (pass_signals[i])
1966 *p++ = tohex (i >> 4);
1967 *p++ = tohex (i & 15);
1976 if (!rs->last_pass_packet || strcmp (rs->last_pass_packet, pass_packet))
1978 putpkt (pass_packet);
1979 getpkt (&rs->buf, &rs->buf_size, 0);
1980 packet_ok (rs->buf, &remote_protocol_packets[PACKET_QPassSignals]);
1981 if (rs->last_pass_packet)
1982 xfree (rs->last_pass_packet);
1983 rs->last_pass_packet = pass_packet;
1986 xfree (pass_packet);
1990 /* If 'QCatchSyscalls' is supported, tell the remote stub
1991 to report syscalls to GDB. */
1994 remote_set_syscall_catchpoint (struct target_ops *self,
1995 int pid, int needed, int any_count,
1996 int table_size, int *table)
1999 enum packet_result result;
2002 if (packet_support (PACKET_QCatchSyscalls) == PACKET_DISABLE)
2004 /* Not supported. */
2008 if (needed && !any_count)
2012 /* Count how many syscalls are to be caught (table[sysno] != 0). */
2013 for (i = 0; i < table_size; i++)
2022 fprintf_unfiltered (gdb_stdlog,
2023 "remote_set_syscall_catchpoint "
2024 "pid %d needed %d any_count %d n_sysno %d\n",
2025 pid, needed, any_count, n_sysno);
2030 /* Prepare a packet with the sysno list, assuming max 8+1
2031 characters for a sysno. If the resulting packet size is too
2032 big, fallback on the non-selective packet. */
2033 const int maxpktsz = strlen ("QCatchSyscalls:1") + n_sysno * 9 + 1;
2035 catch_packet = (char *) xmalloc (maxpktsz);
2036 strcpy (catch_packet, "QCatchSyscalls:1");
2045 /* Add in catch_packet each syscall to be caught (table[i] != 0). */
2046 for (i = 0; i < table_size; i++)
2049 p += xsnprintf (p, catch_packet + maxpktsz - p, ";%x", i);
2052 if (strlen (catch_packet) > get_remote_packet_size ())
2054 /* catch_packet too big. Fallback to less efficient
2055 non selective mode, with GDB doing the filtering. */
2056 catch_packet[sizeof ("QCatchSyscalls:1") - 1] = 0;
2060 catch_packet = xstrdup ("QCatchSyscalls:0");
2063 struct cleanup *old_chain = make_cleanup (xfree, catch_packet);
2064 struct remote_state *rs = get_remote_state ();
2066 putpkt (catch_packet);
2067 getpkt (&rs->buf, &rs->buf_size, 0);
2068 result = packet_ok (rs->buf, &remote_protocol_packets[PACKET_QCatchSyscalls]);
2069 do_cleanups (old_chain);
2070 if (result == PACKET_OK)
2077 /* If 'QProgramSignals' is supported, tell the remote stub what
2078 signals it should pass through to the inferior when detaching. */
2081 remote_program_signals (struct target_ops *self,
2082 int numsigs, unsigned char *signals)
2084 if (packet_support (PACKET_QProgramSignals) != PACKET_DISABLE)
2088 struct remote_state *rs = get_remote_state ();
2090 gdb_assert (numsigs < 256);
2091 for (i = 0; i < numsigs; i++)
2096 packet = (char *) xmalloc (count * 3 + strlen ("QProgramSignals:") + 1);
2097 strcpy (packet, "QProgramSignals:");
2098 p = packet + strlen (packet);
2099 for (i = 0; i < numsigs; i++)
2101 if (signal_pass_state (i))
2104 *p++ = tohex (i >> 4);
2105 *p++ = tohex (i & 15);
2114 if (!rs->last_program_signals_packet
2115 || strcmp (rs->last_program_signals_packet, packet) != 0)
2118 getpkt (&rs->buf, &rs->buf_size, 0);
2119 packet_ok (rs->buf, &remote_protocol_packets[PACKET_QProgramSignals]);
2120 xfree (rs->last_program_signals_packet);
2121 rs->last_program_signals_packet = packet;
2128 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
2129 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
2130 thread. If GEN is set, set the general thread, if not, then set
2131 the step/continue thread. */
2133 set_thread (struct ptid ptid, int gen)
2135 struct remote_state *rs = get_remote_state ();
2136 ptid_t state = gen ? rs->general_thread : rs->continue_thread;
2137 char *buf = rs->buf;
2138 char *endbuf = rs->buf + get_remote_packet_size ();
2140 if (ptid_equal (state, ptid))
2144 *buf++ = gen ? 'g' : 'c';
2145 if (ptid_equal (ptid, magic_null_ptid))
2146 xsnprintf (buf, endbuf - buf, "0");
2147 else if (ptid_equal (ptid, any_thread_ptid))
2148 xsnprintf (buf, endbuf - buf, "0");
2149 else if (ptid_equal (ptid, minus_one_ptid))
2150 xsnprintf (buf, endbuf - buf, "-1");
2152 write_ptid (buf, endbuf, ptid);
2154 getpkt (&rs->buf, &rs->buf_size, 0);
2156 rs->general_thread = ptid;
2158 rs->continue_thread = ptid;
2162 set_general_thread (struct ptid ptid)
2164 set_thread (ptid, 1);
2168 set_continue_thread (struct ptid ptid)
2170 set_thread (ptid, 0);
2173 /* Change the remote current process. Which thread within the process
2174 ends up selected isn't important, as long as it is the same process
2175 as what INFERIOR_PTID points to.
2177 This comes from that fact that there is no explicit notion of
2178 "selected process" in the protocol. The selected process for
2179 general operations is the process the selected general thread
2183 set_general_process (void)
2185 struct remote_state *rs = get_remote_state ();
2187 /* If the remote can't handle multiple processes, don't bother. */
2188 if (!remote_multi_process_p (rs))
2191 /* We only need to change the remote current thread if it's pointing
2192 at some other process. */
2193 if (ptid_get_pid (rs->general_thread) != ptid_get_pid (inferior_ptid))
2194 set_general_thread (inferior_ptid);
2198 /* Return nonzero if this is the main thread that we made up ourselves
2199 to model non-threaded targets as single-threaded. */
2202 remote_thread_always_alive (struct target_ops *ops, ptid_t ptid)
2204 if (ptid_equal (ptid, magic_null_ptid))
2205 /* The main thread is always alive. */
2208 if (ptid_get_pid (ptid) != 0 && ptid_get_lwp (ptid) == 0)
2209 /* The main thread is always alive. This can happen after a
2210 vAttach, if the remote side doesn't support
2217 /* Return nonzero if the thread PTID is still alive on the remote
2221 remote_thread_alive (struct target_ops *ops, ptid_t ptid)
2223 struct remote_state *rs = get_remote_state ();
2226 /* Check if this is a thread that we made up ourselves to model
2227 non-threaded targets as single-threaded. */
2228 if (remote_thread_always_alive (ops, ptid))
2232 endp = rs->buf + get_remote_packet_size ();
2235 write_ptid (p, endp, ptid);
2238 getpkt (&rs->buf, &rs->buf_size, 0);
2239 return (rs->buf[0] == 'O' && rs->buf[1] == 'K');
2242 /* Return a pointer to a thread name if we know it and NULL otherwise.
2243 The thread_info object owns the memory for the name. */
2246 remote_thread_name (struct target_ops *ops, struct thread_info *info)
2248 if (info->priv != NULL)
2249 return info->priv->name;
2254 /* About these extended threadlist and threadinfo packets. They are
2255 variable length packets but, the fields within them are often fixed
2256 length. They are redundent enough to send over UDP as is the
2257 remote protocol in general. There is a matching unit test module
2260 /* WARNING: This threadref data structure comes from the remote O.S.,
2261 libstub protocol encoding, and remote.c. It is not particularly
2264 /* Right now, the internal structure is int. We want it to be bigger.
2265 Plan to fix this. */
2267 typedef int gdb_threadref; /* Internal GDB thread reference. */
2269 /* gdb_ext_thread_info is an internal GDB data structure which is
2270 equivalent to the reply of the remote threadinfo packet. */
2272 struct gdb_ext_thread_info
2274 threadref threadid; /* External form of thread reference. */
2275 int active; /* Has state interesting to GDB?
2277 char display[256]; /* Brief state display, name,
2278 blocked/suspended. */
2279 char shortname[32]; /* To be used to name threads. */
2280 char more_display[256]; /* Long info, statistics, queue depth,
2284 /* The volume of remote transfers can be limited by submitting
2285 a mask containing bits specifying the desired information.
2286 Use a union of these values as the 'selection' parameter to
2287 get_thread_info. FIXME: Make these TAG names more thread specific. */
2289 #define TAG_THREADID 1
2290 #define TAG_EXISTS 2
2291 #define TAG_DISPLAY 4
2292 #define TAG_THREADNAME 8
2293 #define TAG_MOREDISPLAY 16
2295 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
2297 static char *unpack_nibble (char *buf, int *val);
2299 static char *unpack_byte (char *buf, int *value);
2301 static char *pack_int (char *buf, int value);
2303 static char *unpack_int (char *buf, int *value);
2305 static char *unpack_string (char *src, char *dest, int length);
2307 static char *pack_threadid (char *pkt, threadref *id);
2309 static char *unpack_threadid (char *inbuf, threadref *id);
2311 void int_to_threadref (threadref *id, int value);
2313 static int threadref_to_int (threadref *ref);
2315 static void copy_threadref (threadref *dest, threadref *src);
2317 static int threadmatch (threadref *dest, threadref *src);
2319 static char *pack_threadinfo_request (char *pkt, int mode,
2322 static int remote_unpack_thread_info_response (char *pkt,
2323 threadref *expectedref,
2324 struct gdb_ext_thread_info
2328 static int remote_get_threadinfo (threadref *threadid,
2329 int fieldset, /*TAG mask */
2330 struct gdb_ext_thread_info *info);
2332 static char *pack_threadlist_request (char *pkt, int startflag,
2334 threadref *nextthread);
2336 static int parse_threadlist_response (char *pkt,
2338 threadref *original_echo,
2339 threadref *resultlist,
2342 static int remote_get_threadlist (int startflag,
2343 threadref *nextthread,
2347 threadref *threadlist);
2349 typedef int (*rmt_thread_action) (threadref *ref, void *context);
2351 static int remote_threadlist_iterator (rmt_thread_action stepfunction,
2352 void *context, int looplimit);
2354 static int remote_newthread_step (threadref *ref, void *context);
2357 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
2358 buffer we're allowed to write to. Returns
2359 BUF+CHARACTERS_WRITTEN. */
2362 write_ptid (char *buf, const char *endbuf, ptid_t ptid)
2365 struct remote_state *rs = get_remote_state ();
2367 if (remote_multi_process_p (rs))
2369 pid = ptid_get_pid (ptid);
2371 buf += xsnprintf (buf, endbuf - buf, "p-%x.", -pid);
2373 buf += xsnprintf (buf, endbuf - buf, "p%x.", pid);
2375 tid = ptid_get_lwp (ptid);
2377 buf += xsnprintf (buf, endbuf - buf, "-%x", -tid);
2379 buf += xsnprintf (buf, endbuf - buf, "%x", tid);
2384 /* Extract a PTID from BUF. If non-null, OBUF is set to the to one
2385 passed the last parsed char. Returns null_ptid on error. */
2388 read_ptid (char *buf, char **obuf)
2392 ULONGEST pid = 0, tid = 0;
2396 /* Multi-process ptid. */
2397 pp = unpack_varlen_hex (p + 1, &pid);
2399 error (_("invalid remote ptid: %s"), p);
2402 pp = unpack_varlen_hex (p + 1, &tid);
2405 return ptid_build (pid, tid, 0);
2408 /* No multi-process. Just a tid. */
2409 pp = unpack_varlen_hex (p, &tid);
2411 /* Return null_ptid when no thread id is found. */
2419 /* Since the stub is not sending a process id, then default to
2420 what's in inferior_ptid, unless it's null at this point. If so,
2421 then since there's no way to know the pid of the reported
2422 threads, use the magic number. */
2423 if (ptid_equal (inferior_ptid, null_ptid))
2424 pid = ptid_get_pid (magic_null_ptid);
2426 pid = ptid_get_pid (inferior_ptid);
2430 return ptid_build (pid, tid, 0);
2436 if (ch >= 'a' && ch <= 'f')
2437 return ch - 'a' + 10;
2438 if (ch >= '0' && ch <= '9')
2440 if (ch >= 'A' && ch <= 'F')
2441 return ch - 'A' + 10;
2446 stub_unpack_int (char *buff, int fieldlength)
2453 nibble = stubhex (*buff++);
2457 retval = retval << 4;
2463 unpack_nibble (char *buf, int *val)
2465 *val = fromhex (*buf++);
2470 unpack_byte (char *buf, int *value)
2472 *value = stub_unpack_int (buf, 2);
2477 pack_int (char *buf, int value)
2479 buf = pack_hex_byte (buf, (value >> 24) & 0xff);
2480 buf = pack_hex_byte (buf, (value >> 16) & 0xff);
2481 buf = pack_hex_byte (buf, (value >> 8) & 0x0ff);
2482 buf = pack_hex_byte (buf, (value & 0xff));
2487 unpack_int (char *buf, int *value)
2489 *value = stub_unpack_int (buf, 8);
2493 #if 0 /* Currently unused, uncomment when needed. */
2494 static char *pack_string (char *pkt, char *string);
2497 pack_string (char *pkt, char *string)
2502 len = strlen (string);
2504 len = 200; /* Bigger than most GDB packets, junk??? */
2505 pkt = pack_hex_byte (pkt, len);
2509 if ((ch == '\0') || (ch == '#'))
2510 ch = '*'; /* Protect encapsulation. */
2515 #endif /* 0 (unused) */
2518 unpack_string (char *src, char *dest, int length)
2527 pack_threadid (char *pkt, threadref *id)
2530 unsigned char *altid;
2532 altid = (unsigned char *) id;
2533 limit = pkt + BUF_THREAD_ID_SIZE;
2535 pkt = pack_hex_byte (pkt, *altid++);
2541 unpack_threadid (char *inbuf, threadref *id)
2544 char *limit = inbuf + BUF_THREAD_ID_SIZE;
2547 altref = (char *) id;
2549 while (inbuf < limit)
2551 x = stubhex (*inbuf++);
2552 y = stubhex (*inbuf++);
2553 *altref++ = (x << 4) | y;
2558 /* Externally, threadrefs are 64 bits but internally, they are still
2559 ints. This is due to a mismatch of specifications. We would like
2560 to use 64bit thread references internally. This is an adapter
2564 int_to_threadref (threadref *id, int value)
2566 unsigned char *scan;
2568 scan = (unsigned char *) id;
2574 *scan++ = (value >> 24) & 0xff;
2575 *scan++ = (value >> 16) & 0xff;
2576 *scan++ = (value >> 8) & 0xff;
2577 *scan++ = (value & 0xff);
2581 threadref_to_int (threadref *ref)
2584 unsigned char *scan;
2590 value = (value << 8) | ((*scan++) & 0xff);
2595 copy_threadref (threadref *dest, threadref *src)
2598 unsigned char *csrc, *cdest;
2600 csrc = (unsigned char *) src;
2601 cdest = (unsigned char *) dest;
2608 threadmatch (threadref *dest, threadref *src)
2610 /* Things are broken right now, so just assume we got a match. */
2612 unsigned char *srcp, *destp;
2614 srcp = (char *) src;
2615 destp = (char *) dest;
2619 result &= (*srcp++ == *destp++) ? 1 : 0;
2626 threadid:1, # always request threadid
2633 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
2636 pack_threadinfo_request (char *pkt, int mode, threadref *id)
2638 *pkt++ = 'q'; /* Info Query */
2639 *pkt++ = 'P'; /* process or thread info */
2640 pkt = pack_int (pkt, mode); /* mode */
2641 pkt = pack_threadid (pkt, id); /* threadid */
2642 *pkt = '\0'; /* terminate */
2646 /* These values tag the fields in a thread info response packet. */
2647 /* Tagging the fields allows us to request specific fields and to
2648 add more fields as time goes by. */
2650 #define TAG_THREADID 1 /* Echo the thread identifier. */
2651 #define TAG_EXISTS 2 /* Is this process defined enough to
2652 fetch registers and its stack? */
2653 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
2654 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
2655 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
2659 remote_unpack_thread_info_response (char *pkt, threadref *expectedref,
2660 struct gdb_ext_thread_info *info)
2662 struct remote_state *rs = get_remote_state ();
2666 char *limit = pkt + rs->buf_size; /* Plausible parsing limit. */
2669 /* info->threadid = 0; FIXME: implement zero_threadref. */
2671 info->display[0] = '\0';
2672 info->shortname[0] = '\0';
2673 info->more_display[0] = '\0';
2675 /* Assume the characters indicating the packet type have been
2677 pkt = unpack_int (pkt, &mask); /* arg mask */
2678 pkt = unpack_threadid (pkt, &ref);
2681 warning (_("Incomplete response to threadinfo request."));
2682 if (!threadmatch (&ref, expectedref))
2683 { /* This is an answer to a different request. */
2684 warning (_("ERROR RMT Thread info mismatch."));
2687 copy_threadref (&info->threadid, &ref);
2689 /* Loop on tagged fields , try to bail if somthing goes wrong. */
2691 /* Packets are terminated with nulls. */
2692 while ((pkt < limit) && mask && *pkt)
2694 pkt = unpack_int (pkt, &tag); /* tag */
2695 pkt = unpack_byte (pkt, &length); /* length */
2696 if (!(tag & mask)) /* Tags out of synch with mask. */
2698 warning (_("ERROR RMT: threadinfo tag mismatch."));
2702 if (tag == TAG_THREADID)
2706 warning (_("ERROR RMT: length of threadid is not 16."));
2710 pkt = unpack_threadid (pkt, &ref);
2711 mask = mask & ~TAG_THREADID;
2714 if (tag == TAG_EXISTS)
2716 info->active = stub_unpack_int (pkt, length);
2718 mask = mask & ~(TAG_EXISTS);
2721 warning (_("ERROR RMT: 'exists' length too long."));
2727 if (tag == TAG_THREADNAME)
2729 pkt = unpack_string (pkt, &info->shortname[0], length);
2730 mask = mask & ~TAG_THREADNAME;
2733 if (tag == TAG_DISPLAY)
2735 pkt = unpack_string (pkt, &info->display[0], length);
2736 mask = mask & ~TAG_DISPLAY;
2739 if (tag == TAG_MOREDISPLAY)
2741 pkt = unpack_string (pkt, &info->more_display[0], length);
2742 mask = mask & ~TAG_MOREDISPLAY;
2745 warning (_("ERROR RMT: unknown thread info tag."));
2746 break; /* Not a tag we know about. */
2752 remote_get_threadinfo (threadref *threadid, int fieldset, /* TAG mask */
2753 struct gdb_ext_thread_info *info)
2755 struct remote_state *rs = get_remote_state ();
2758 pack_threadinfo_request (rs->buf, fieldset, threadid);
2760 getpkt (&rs->buf, &rs->buf_size, 0);
2762 if (rs->buf[0] == '\0')
2765 result = remote_unpack_thread_info_response (rs->buf + 2,
2770 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
2773 pack_threadlist_request (char *pkt, int startflag, int threadcount,
2774 threadref *nextthread)
2776 *pkt++ = 'q'; /* info query packet */
2777 *pkt++ = 'L'; /* Process LIST or threadLIST request */
2778 pkt = pack_nibble (pkt, startflag); /* initflag 1 bytes */
2779 pkt = pack_hex_byte (pkt, threadcount); /* threadcount 2 bytes */
2780 pkt = pack_threadid (pkt, nextthread); /* 64 bit thread identifier */
2785 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
2788 parse_threadlist_response (char *pkt, int result_limit,
2789 threadref *original_echo, threadref *resultlist,
2792 struct remote_state *rs = get_remote_state ();
2794 int count, resultcount, done;
2797 /* Assume the 'q' and 'M chars have been stripped. */
2798 limit = pkt + (rs->buf_size - BUF_THREAD_ID_SIZE);
2799 /* done parse past here */
2800 pkt = unpack_byte (pkt, &count); /* count field */
2801 pkt = unpack_nibble (pkt, &done);
2802 /* The first threadid is the argument threadid. */
2803 pkt = unpack_threadid (pkt, original_echo); /* should match query packet */
2804 while ((count-- > 0) && (pkt < limit))
2806 pkt = unpack_threadid (pkt, resultlist++);
2807 if (resultcount++ >= result_limit)
2815 /* Fetch the next batch of threads from the remote. Returns -1 if the
2816 qL packet is not supported, 0 on error and 1 on success. */
2819 remote_get_threadlist (int startflag, threadref *nextthread, int result_limit,
2820 int *done, int *result_count, threadref *threadlist)
2822 struct remote_state *rs = get_remote_state ();
2825 /* Trancate result limit to be smaller than the packet size. */
2826 if ((((result_limit + 1) * BUF_THREAD_ID_SIZE) + 10)
2827 >= get_remote_packet_size ())
2828 result_limit = (get_remote_packet_size () / BUF_THREAD_ID_SIZE) - 2;
2830 pack_threadlist_request (rs->buf, startflag, result_limit, nextthread);
2832 getpkt (&rs->buf, &rs->buf_size, 0);
2833 if (*rs->buf == '\0')
2835 /* Packet not supported. */
2840 parse_threadlist_response (rs->buf + 2, result_limit,
2841 &rs->echo_nextthread, threadlist, done);
2843 if (!threadmatch (&rs->echo_nextthread, nextthread))
2845 /* FIXME: This is a good reason to drop the packet. */
2846 /* Possably, there is a duplicate response. */
2848 retransmit immediatly - race conditions
2849 retransmit after timeout - yes
2851 wait for packet, then exit
2853 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
2854 return 0; /* I choose simply exiting. */
2856 if (*result_count <= 0)
2860 warning (_("RMT ERROR : failed to get remote thread list."));
2863 return result; /* break; */
2865 if (*result_count > result_limit)
2868 warning (_("RMT ERROR: threadlist response longer than requested."));
2874 /* Fetch the list of remote threads, with the qL packet, and call
2875 STEPFUNCTION for each thread found. Stops iterating and returns 1
2876 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
2877 STEPFUNCTION returns false. If the packet is not supported,
2881 remote_threadlist_iterator (rmt_thread_action stepfunction, void *context,
2884 struct remote_state *rs = get_remote_state ();
2885 int done, i, result_count;
2893 if (loopcount++ > looplimit)
2896 warning (_("Remote fetch threadlist -infinite loop-."));
2899 result = remote_get_threadlist (startflag, &rs->nextthread,
2900 MAXTHREADLISTRESULTS,
2901 &done, &result_count,
2902 rs->resultthreadlist);
2905 /* Clear for later iterations. */
2907 /* Setup to resume next batch of thread references, set nextthread. */
2908 if (result_count >= 1)
2909 copy_threadref (&rs->nextthread,
2910 &rs->resultthreadlist[result_count - 1]);
2912 while (result_count--)
2914 if (!(*stepfunction) (&rs->resultthreadlist[i++], context))
2924 /* A thread found on the remote target. */
2926 typedef struct thread_item
2928 /* The thread's PTID. */
2931 /* The thread's extra info. May be NULL. */
2934 /* The thread's name. May be NULL. */
2937 /* The core the thread was running on. -1 if not known. */
2940 DEF_VEC_O(thread_item_t);
2942 /* Context passed around to the various methods listing remote
2943 threads. As new threads are found, they're added to the ITEMS
2946 struct threads_listing_context
2948 /* The threads found on the remote target. */
2949 VEC (thread_item_t) *items;
2952 /* Discard the contents of the constructed thread listing context. */
2955 clear_threads_listing_context (void *p)
2957 struct threads_listing_context *context
2958 = (struct threads_listing_context *) p;
2960 struct thread_item *item;
2962 for (i = 0; VEC_iterate (thread_item_t, context->items, i, item); ++i)
2964 xfree (item->extra);
2968 VEC_free (thread_item_t, context->items);
2971 /* Remove the thread specified as the related_pid field of WS
2972 from the CONTEXT list. */
2975 threads_listing_context_remove (struct target_waitstatus *ws,
2976 struct threads_listing_context *context)
2978 struct thread_item *item;
2980 ptid_t child_ptid = ws->value.related_pid;
2982 for (i = 0; VEC_iterate (thread_item_t, context->items, i, item); ++i)
2984 if (ptid_equal (item->ptid, child_ptid))
2986 VEC_ordered_remove (thread_item_t, context->items, i);
2993 remote_newthread_step (threadref *ref, void *data)
2995 struct threads_listing_context *context
2996 = (struct threads_listing_context *) data;
2997 struct thread_item item;
2998 int pid = ptid_get_pid (inferior_ptid);
3000 item.ptid = ptid_build (pid, threadref_to_int (ref), 0);
3005 VEC_safe_push (thread_item_t, context->items, &item);
3007 return 1; /* continue iterator */
3010 #define CRAZY_MAX_THREADS 1000
3013 remote_current_thread (ptid_t oldpid)
3015 struct remote_state *rs = get_remote_state ();
3018 getpkt (&rs->buf, &rs->buf_size, 0);
3019 if (rs->buf[0] == 'Q' && rs->buf[1] == 'C')
3024 result = read_ptid (&rs->buf[2], &obuf);
3025 if (*obuf != '\0' && remote_debug)
3026 fprintf_unfiltered (gdb_stdlog,
3027 "warning: garbage in qC reply\n");
3035 /* List remote threads using the deprecated qL packet. */
3038 remote_get_threads_with_ql (struct target_ops *ops,
3039 struct threads_listing_context *context)
3041 if (remote_threadlist_iterator (remote_newthread_step, context,
3042 CRAZY_MAX_THREADS) >= 0)
3048 #if defined(HAVE_LIBEXPAT)
3051 start_thread (struct gdb_xml_parser *parser,
3052 const struct gdb_xml_element *element,
3053 void *user_data, VEC(gdb_xml_value_s) *attributes)
3055 struct threads_listing_context *data
3056 = (struct threads_listing_context *) user_data;
3058 struct thread_item item;
3060 struct gdb_xml_value *attr;
3062 id = (char *) xml_find_attribute (attributes, "id")->value;
3063 item.ptid = read_ptid (id, NULL);
3065 attr = xml_find_attribute (attributes, "core");
3067 item.core = *(ULONGEST *) attr->value;
3071 attr = xml_find_attribute (attributes, "name");
3072 item.name = attr != NULL ? xstrdup ((const char *) attr->value) : NULL;
3076 VEC_safe_push (thread_item_t, data->items, &item);
3080 end_thread (struct gdb_xml_parser *parser,
3081 const struct gdb_xml_element *element,
3082 void *user_data, const char *body_text)
3084 struct threads_listing_context *data
3085 = (struct threads_listing_context *) user_data;
3087 if (body_text && *body_text)
3088 VEC_last (thread_item_t, data->items)->extra = xstrdup (body_text);
3091 const struct gdb_xml_attribute thread_attributes[] = {
3092 { "id", GDB_XML_AF_NONE, NULL, NULL },
3093 { "core", GDB_XML_AF_OPTIONAL, gdb_xml_parse_attr_ulongest, NULL },
3094 { "name", GDB_XML_AF_OPTIONAL, NULL, NULL },
3095 { NULL, GDB_XML_AF_NONE, NULL, NULL }
3098 const struct gdb_xml_element thread_children[] = {
3099 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3102 const struct gdb_xml_element threads_children[] = {
3103 { "thread", thread_attributes, thread_children,
3104 GDB_XML_EF_REPEATABLE | GDB_XML_EF_OPTIONAL,
3105 start_thread, end_thread },
3106 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3109 const struct gdb_xml_element threads_elements[] = {
3110 { "threads", NULL, threads_children,
3111 GDB_XML_EF_NONE, NULL, NULL },
3112 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3117 /* List remote threads using qXfer:threads:read. */
3120 remote_get_threads_with_qxfer (struct target_ops *ops,
3121 struct threads_listing_context *context)
3123 #if defined(HAVE_LIBEXPAT)
3124 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
3126 char *xml = target_read_stralloc (ops, TARGET_OBJECT_THREADS, NULL);
3127 struct cleanup *back_to = make_cleanup (xfree, xml);
3129 if (xml != NULL && *xml != '\0')
3131 gdb_xml_parse_quick (_("threads"), "threads.dtd",
3132 threads_elements, xml, context);
3135 do_cleanups (back_to);
3143 /* List remote threads using qfThreadInfo/qsThreadInfo. */
3146 remote_get_threads_with_qthreadinfo (struct target_ops *ops,
3147 struct threads_listing_context *context)
3149 struct remote_state *rs = get_remote_state ();
3151 if (rs->use_threadinfo_query)
3155 putpkt ("qfThreadInfo");
3156 getpkt (&rs->buf, &rs->buf_size, 0);
3158 if (bufp[0] != '\0') /* q packet recognized */
3160 while (*bufp++ == 'm') /* reply contains one or more TID */
3164 struct thread_item item;
3166 item.ptid = read_ptid (bufp, &bufp);
3171 VEC_safe_push (thread_item_t, context->items, &item);
3173 while (*bufp++ == ','); /* comma-separated list */
3174 putpkt ("qsThreadInfo");
3175 getpkt (&rs->buf, &rs->buf_size, 0);
3182 /* Packet not recognized. */
3183 rs->use_threadinfo_query = 0;
3190 /* Implement the to_update_thread_list function for the remote
3194 remote_update_thread_list (struct target_ops *ops)
3196 struct threads_listing_context context;
3197 struct cleanup *old_chain;
3200 context.items = NULL;
3201 old_chain = make_cleanup (clear_threads_listing_context, &context);
3203 /* We have a few different mechanisms to fetch the thread list. Try
3204 them all, starting with the most preferred one first, falling
3205 back to older methods. */
3206 if (remote_get_threads_with_qxfer (ops, &context)
3207 || remote_get_threads_with_qthreadinfo (ops, &context)
3208 || remote_get_threads_with_ql (ops, &context))
3211 struct thread_item *item;
3212 struct thread_info *tp, *tmp;
3216 if (VEC_empty (thread_item_t, context.items)
3217 && remote_thread_always_alive (ops, inferior_ptid))
3219 /* Some targets don't really support threads, but still
3220 reply an (empty) thread list in response to the thread
3221 listing packets, instead of replying "packet not
3222 supported". Exit early so we don't delete the main
3224 do_cleanups (old_chain);
3228 /* CONTEXT now holds the current thread list on the remote
3229 target end. Delete GDB-side threads no longer found on the
3231 ALL_THREADS_SAFE (tp, tmp)
3234 VEC_iterate (thread_item_t, context.items, i, item);
3237 if (ptid_equal (item->ptid, tp->ptid))
3241 if (i == VEC_length (thread_item_t, context.items))
3244 delete_thread (tp->ptid);
3248 /* Remove any unreported fork child threads from CONTEXT so
3249 that we don't interfere with follow fork, which is where
3250 creation of such threads is handled. */
3251 remove_new_fork_children (&context);
3253 /* And now add threads we don't know about yet to our list. */
3255 VEC_iterate (thread_item_t, context.items, i, item);
3258 if (!ptid_equal (item->ptid, null_ptid))
3260 struct private_thread_info *info;
3261 /* In non-stop mode, we assume new found threads are
3262 running until proven otherwise with a stop reply. In
3263 all-stop, we can only get here if all threads are
3265 int running = target_is_non_stop_p () ? 1 : 0;
3267 remote_notice_new_inferior (item->ptid, running);
3269 info = demand_private_info (item->ptid);
3270 info->core = item->core;
3271 info->extra = item->extra;
3273 info->name = item->name;
3281 /* If no thread listing method is supported, then query whether
3282 each known thread is alive, one by one, with the T packet.
3283 If the target doesn't support threads at all, then this is a
3284 no-op. See remote_thread_alive. */
3288 do_cleanups (old_chain);
3292 * Collect a descriptive string about the given thread.
3293 * The target may say anything it wants to about the thread
3294 * (typically info about its blocked / runnable state, name, etc.).
3295 * This string will appear in the info threads display.
3297 * Optional: targets are not required to implement this function.
3301 remote_threads_extra_info (struct target_ops *self, struct thread_info *tp)
3303 struct remote_state *rs = get_remote_state ();
3307 struct gdb_ext_thread_info threadinfo;
3308 static char display_buf[100]; /* arbitrary... */
3309 int n = 0; /* position in display_buf */
3311 if (rs->remote_desc == 0) /* paranoia */
3312 internal_error (__FILE__, __LINE__,
3313 _("remote_threads_extra_info"));
3315 if (ptid_equal (tp->ptid, magic_null_ptid)
3316 || (ptid_get_pid (tp->ptid) != 0 && ptid_get_lwp (tp->ptid) == 0))
3317 /* This is the main thread which was added by GDB. The remote
3318 server doesn't know about it. */
3321 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
3323 struct thread_info *info = find_thread_ptid (tp->ptid);
3325 if (info && info->priv)
3326 return info->priv->extra;
3331 if (rs->use_threadextra_query)
3334 char *endb = rs->buf + get_remote_packet_size ();
3336 xsnprintf (b, endb - b, "qThreadExtraInfo,");
3338 write_ptid (b, endb, tp->ptid);
3341 getpkt (&rs->buf, &rs->buf_size, 0);
3342 if (rs->buf[0] != 0)
3344 n = min (strlen (rs->buf) / 2, sizeof (display_buf));
3345 result = hex2bin (rs->buf, (gdb_byte *) display_buf, n);
3346 display_buf [result] = '\0';
3351 /* If the above query fails, fall back to the old method. */
3352 rs->use_threadextra_query = 0;
3353 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
3354 | TAG_MOREDISPLAY | TAG_DISPLAY;
3355 int_to_threadref (&id, ptid_get_lwp (tp->ptid));
3356 if (remote_get_threadinfo (&id, set, &threadinfo))
3357 if (threadinfo.active)
3359 if (*threadinfo.shortname)
3360 n += xsnprintf (&display_buf[0], sizeof (display_buf) - n,
3361 " Name: %s,", threadinfo.shortname);
3362 if (*threadinfo.display)
3363 n += xsnprintf (&display_buf[n], sizeof (display_buf) - n,
3364 " State: %s,", threadinfo.display);
3365 if (*threadinfo.more_display)
3366 n += xsnprintf (&display_buf[n], sizeof (display_buf) - n,
3367 " Priority: %s", threadinfo.more_display);
3371 /* For purely cosmetic reasons, clear up trailing commas. */
3372 if (',' == display_buf[n-1])
3373 display_buf[n-1] = ' ';
3382 remote_static_tracepoint_marker_at (struct target_ops *self, CORE_ADDR addr,
3383 struct static_tracepoint_marker *marker)
3385 struct remote_state *rs = get_remote_state ();
3388 xsnprintf (p, get_remote_packet_size (), "qTSTMat:");
3390 p += hexnumstr (p, addr);
3392 getpkt (&rs->buf, &rs->buf_size, 0);
3396 error (_("Remote failure reply: %s"), p);
3400 parse_static_tracepoint_marker_definition (p, &p, marker);
3407 static VEC(static_tracepoint_marker_p) *
3408 remote_static_tracepoint_markers_by_strid (struct target_ops *self,
3411 struct remote_state *rs = get_remote_state ();
3412 VEC(static_tracepoint_marker_p) *markers = NULL;
3413 struct static_tracepoint_marker *marker = NULL;
3414 struct cleanup *old_chain;
3417 /* Ask for a first packet of static tracepoint marker
3420 getpkt (&rs->buf, &rs->buf_size, 0);
3423 error (_("Remote failure reply: %s"), p);
3425 old_chain = make_cleanup (free_current_marker, &marker);
3430 marker = XCNEW (struct static_tracepoint_marker);
3434 parse_static_tracepoint_marker_definition (p, &p, marker);
3436 if (strid == NULL || strcmp (strid, marker->str_id) == 0)
3438 VEC_safe_push (static_tracepoint_marker_p,
3444 release_static_tracepoint_marker (marker);
3445 memset (marker, 0, sizeof (*marker));
3448 while (*p++ == ','); /* comma-separated list */
3449 /* Ask for another packet of static tracepoint definition. */
3451 getpkt (&rs->buf, &rs->buf_size, 0);
3455 do_cleanups (old_chain);
3460 /* Implement the to_get_ada_task_ptid function for the remote targets. */
3463 remote_get_ada_task_ptid (struct target_ops *self, long lwp, long thread)
3465 return ptid_build (ptid_get_pid (inferior_ptid), lwp, 0);
3469 /* Restart the remote side; this is an extended protocol operation. */
3472 extended_remote_restart (void)
3474 struct remote_state *rs = get_remote_state ();
3476 /* Send the restart command; for reasons I don't understand the
3477 remote side really expects a number after the "R". */
3478 xsnprintf (rs->buf, get_remote_packet_size (), "R%x", 0);
3481 remote_fileio_reset ();
3484 /* Clean up connection to a remote debugger. */
3487 remote_close (struct target_ops *self)
3489 struct remote_state *rs = get_remote_state ();
3491 if (rs->remote_desc == NULL)
3492 return; /* already closed */
3494 /* Make sure we leave stdin registered in the event loop, and we
3495 don't leave the async SIGINT signal handler installed. */
3496 remote_terminal_ours (self);
3498 serial_close (rs->remote_desc);
3499 rs->remote_desc = NULL;
3501 /* We don't have a connection to the remote stub anymore. Get rid
3502 of all the inferiors and their threads we were controlling.
3503 Reset inferior_ptid to null_ptid first, as otherwise has_stack_frame
3504 will be unable to find the thread corresponding to (pid, 0, 0). */
3505 inferior_ptid = null_ptid;
3506 discard_all_inferiors ();
3508 /* We are closing the remote target, so we should discard
3509 everything of this target. */
3510 discard_pending_stop_replies_in_queue (rs);
3512 if (remote_async_inferior_event_token)
3513 delete_async_event_handler (&remote_async_inferior_event_token);
3515 remote_notif_state_xfree (rs->notif_state);
3517 trace_reset_local_state ();
3520 /* Query the remote side for the text, data and bss offsets. */
3525 struct remote_state *rs = get_remote_state ();
3528 int lose, num_segments = 0, do_sections, do_segments;
3529 CORE_ADDR text_addr, data_addr, bss_addr, segments[2];
3530 struct section_offsets *offs;
3531 struct symfile_segment_data *data;
3533 if (symfile_objfile == NULL)
3536 putpkt ("qOffsets");
3537 getpkt (&rs->buf, &rs->buf_size, 0);
3540 if (buf[0] == '\000')
3541 return; /* Return silently. Stub doesn't support
3545 warning (_("Remote failure reply: %s"), buf);
3549 /* Pick up each field in turn. This used to be done with scanf, but
3550 scanf will make trouble if CORE_ADDR size doesn't match
3551 conversion directives correctly. The following code will work
3552 with any size of CORE_ADDR. */
3553 text_addr = data_addr = bss_addr = 0;
3557 if (startswith (ptr, "Text="))
3560 /* Don't use strtol, could lose on big values. */
3561 while (*ptr && *ptr != ';')
3562 text_addr = (text_addr << 4) + fromhex (*ptr++);
3564 if (startswith (ptr, ";Data="))
3567 while (*ptr && *ptr != ';')
3568 data_addr = (data_addr << 4) + fromhex (*ptr++);
3573 if (!lose && startswith (ptr, ";Bss="))
3576 while (*ptr && *ptr != ';')
3577 bss_addr = (bss_addr << 4) + fromhex (*ptr++);
3579 if (bss_addr != data_addr)
3580 warning (_("Target reported unsupported offsets: %s"), buf);
3585 else if (startswith (ptr, "TextSeg="))
3588 /* Don't use strtol, could lose on big values. */
3589 while (*ptr && *ptr != ';')
3590 text_addr = (text_addr << 4) + fromhex (*ptr++);
3593 if (startswith (ptr, ";DataSeg="))
3596 while (*ptr && *ptr != ';')
3597 data_addr = (data_addr << 4) + fromhex (*ptr++);
3605 error (_("Malformed response to offset query, %s"), buf);
3606 else if (*ptr != '\0')
3607 warning (_("Target reported unsupported offsets: %s"), buf);
3609 offs = ((struct section_offsets *)
3610 alloca (SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections)));
3611 memcpy (offs, symfile_objfile->section_offsets,
3612 SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections));
3614 data = get_symfile_segment_data (symfile_objfile->obfd);
3615 do_segments = (data != NULL);
3616 do_sections = num_segments == 0;
3618 if (num_segments > 0)
3620 segments[0] = text_addr;
3621 segments[1] = data_addr;
3623 /* If we have two segments, we can still try to relocate everything
3624 by assuming that the .text and .data offsets apply to the whole
3625 text and data segments. Convert the offsets given in the packet
3626 to base addresses for symfile_map_offsets_to_segments. */
3627 else if (data && data->num_segments == 2)
3629 segments[0] = data->segment_bases[0] + text_addr;
3630 segments[1] = data->segment_bases[1] + data_addr;
3633 /* If the object file has only one segment, assume that it is text
3634 rather than data; main programs with no writable data are rare,
3635 but programs with no code are useless. Of course the code might
3636 have ended up in the data segment... to detect that we would need
3637 the permissions here. */
3638 else if (data && data->num_segments == 1)
3640 segments[0] = data->segment_bases[0] + text_addr;
3643 /* There's no way to relocate by segment. */
3649 int ret = symfile_map_offsets_to_segments (symfile_objfile->obfd, data,
3650 offs, num_segments, segments);
3652 if (ret == 0 && !do_sections)
3653 error (_("Can not handle qOffsets TextSeg "
3654 "response with this symbol file"));
3661 free_symfile_segment_data (data);
3665 offs->offsets[SECT_OFF_TEXT (symfile_objfile)] = text_addr;
3667 /* This is a temporary kludge to force data and bss to use the
3668 same offsets because that's what nlmconv does now. The real
3669 solution requires changes to the stub and remote.c that I
3670 don't have time to do right now. */
3672 offs->offsets[SECT_OFF_DATA (symfile_objfile)] = data_addr;
3673 offs->offsets[SECT_OFF_BSS (symfile_objfile)] = data_addr;
3676 objfile_relocate (symfile_objfile, offs);
3679 /* Send interrupt_sequence to remote target. */
3681 send_interrupt_sequence (void)
3683 struct remote_state *rs = get_remote_state ();
3685 if (interrupt_sequence_mode == interrupt_sequence_control_c)
3686 remote_serial_write ("\x03", 1);
3687 else if (interrupt_sequence_mode == interrupt_sequence_break)
3688 serial_send_break (rs->remote_desc);
3689 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
3691 serial_send_break (rs->remote_desc);
3692 remote_serial_write ("g", 1);
3695 internal_error (__FILE__, __LINE__,
3696 _("Invalid value for interrupt_sequence_mode: %s."),
3697 interrupt_sequence_mode);
3701 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
3702 and extract the PTID. Returns NULL_PTID if not found. */
3705 stop_reply_extract_thread (char *stop_reply)
3707 if (stop_reply[0] == 'T' && strlen (stop_reply) > 3)
3711 /* Txx r:val ; r:val (...) */
3714 /* Look for "register" named "thread". */
3719 p1 = strchr (p, ':');
3723 if (strncmp (p, "thread", p1 - p) == 0)
3724 return read_ptid (++p1, &p);
3726 p1 = strchr (p, ';');
3738 /* Determine the remote side's current thread. If we have a stop
3739 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
3740 "thread" register we can extract the current thread from. If not,
3741 ask the remote which is the current thread with qC. The former
3742 method avoids a roundtrip. */
3745 get_current_thread (char *wait_status)
3747 ptid_t ptid = null_ptid;
3749 /* Note we don't use remote_parse_stop_reply as that makes use of
3750 the target architecture, which we haven't yet fully determined at
3752 if (wait_status != NULL)
3753 ptid = stop_reply_extract_thread (wait_status);
3754 if (ptid_equal (ptid, null_ptid))
3755 ptid = remote_current_thread (inferior_ptid);
3760 /* Query the remote target for which is the current thread/process,
3761 add it to our tables, and update INFERIOR_PTID. The caller is
3762 responsible for setting the state such that the remote end is ready
3763 to return the current thread.
3765 This function is called after handling the '?' or 'vRun' packets,
3766 whose response is a stop reply from which we can also try
3767 extracting the thread. If the target doesn't support the explicit
3768 qC query, we infer the current thread from that stop reply, passed
3769 in in WAIT_STATUS, which may be NULL. */
3772 add_current_inferior_and_thread (char *wait_status)
3774 struct remote_state *rs = get_remote_state ();
3778 inferior_ptid = null_ptid;
3780 /* Now, if we have thread information, update inferior_ptid. */
3781 ptid = get_current_thread (wait_status);
3783 if (!ptid_equal (ptid, null_ptid))
3785 if (!remote_multi_process_p (rs))
3788 inferior_ptid = ptid;
3792 /* Without this, some commands which require an active target
3793 (such as kill) won't work. This variable serves (at least)
3794 double duty as both the pid of the target process (if it has
3795 such), and as a flag indicating that a target is active. */
3796 inferior_ptid = magic_null_ptid;
3800 remote_add_inferior (fake_pid_p, ptid_get_pid (inferior_ptid), -1, 1);
3802 /* Add the main thread. */
3803 add_thread_silent (inferior_ptid);
3806 /* Print info about a thread that was found already stopped on
3810 print_one_stopped_thread (struct thread_info *thread)
3812 struct target_waitstatus *ws = &thread->suspend.waitstatus;
3814 switch_to_thread (thread->ptid);
3815 stop_pc = get_frame_pc (get_current_frame ());
3816 set_current_sal_from_frame (get_current_frame ());
3818 thread->suspend.waitstatus_pending_p = 0;
3820 if (ws->kind == TARGET_WAITKIND_STOPPED)
3822 enum gdb_signal sig = ws->value.sig;
3824 if (signal_print_state (sig))
3825 observer_notify_signal_received (sig);
3827 observer_notify_normal_stop (NULL, 1);
3830 /* Process all initial stop replies the remote side sent in response
3831 to the ? packet. These indicate threads that were already stopped
3832 on initial connection. We mark these threads as stopped and print
3833 their current frame before giving the user the prompt. */
3836 process_initial_stop_replies (int from_tty)
3838 int pending_stop_replies = stop_reply_queue_length ();
3839 struct inferior *inf;
3840 struct thread_info *thread;
3841 struct thread_info *selected = NULL;
3842 struct thread_info *lowest_stopped = NULL;
3843 struct thread_info *first = NULL;
3845 /* Consume the initial pending events. */
3846 while (pending_stop_replies-- > 0)
3848 ptid_t waiton_ptid = minus_one_ptid;
3850 struct target_waitstatus ws;
3851 int ignore_event = 0;
3852 struct thread_info *thread;
3854 memset (&ws, 0, sizeof (ws));
3855 event_ptid = target_wait (waiton_ptid, &ws, TARGET_WNOHANG);
3857 print_target_wait_results (waiton_ptid, event_ptid, &ws);
3861 case TARGET_WAITKIND_IGNORE:
3862 case TARGET_WAITKIND_NO_RESUMED:
3863 case TARGET_WAITKIND_SIGNALLED:
3864 case TARGET_WAITKIND_EXITED:
3865 /* We shouldn't see these, but if we do, just ignore. */
3867 fprintf_unfiltered (gdb_stdlog, "remote: event ignored\n");
3871 case TARGET_WAITKIND_EXECD:
3872 xfree (ws.value.execd_pathname);
3881 thread = find_thread_ptid (event_ptid);
3883 if (ws.kind == TARGET_WAITKIND_STOPPED)
3885 enum gdb_signal sig = ws.value.sig;
3887 /* Stubs traditionally report SIGTRAP as initial signal,
3888 instead of signal 0. Suppress it. */
3889 if (sig == GDB_SIGNAL_TRAP)
3891 thread->suspend.stop_signal = sig;
3895 thread->suspend.waitstatus = ws;
3897 if (ws.kind != TARGET_WAITKIND_STOPPED
3898 || ws.value.sig != GDB_SIGNAL_0)
3899 thread->suspend.waitstatus_pending_p = 1;
3901 set_executing (event_ptid, 0);
3902 set_running (event_ptid, 0);
3905 /* "Notice" the new inferiors before anything related to
3906 registers/memory. */
3912 inf->needs_setup = 1;
3916 thread = any_live_thread_of_process (inf->pid);
3917 notice_new_inferior (thread->ptid,
3918 thread->state == THREAD_RUNNING,
3923 /* If all-stop on top of non-stop, pause all threads. Note this
3924 records the threads' stop pc, so must be done after "noticing"
3928 stop_all_threads ();
3930 /* If all threads of an inferior were already stopped, we
3931 haven't setup the inferior yet. */
3937 if (inf->needs_setup)
3939 thread = any_live_thread_of_process (inf->pid);
3940 switch_to_thread_no_regs (thread);
3946 /* Now go over all threads that are stopped, and print their current
3947 frame. If all-stop, then if there's a signalled thread, pick
3949 ALL_NON_EXITED_THREADS (thread)
3955 set_running (thread->ptid, 0);
3956 else if (thread->state != THREAD_STOPPED)
3959 if (selected == NULL
3960 && thread->suspend.waitstatus_pending_p)
3963 if (lowest_stopped == NULL
3964 || thread->inf->num < lowest_stopped->inf->num
3965 || thread->per_inf_num < lowest_stopped->per_inf_num)
3966 lowest_stopped = thread;
3969 print_one_stopped_thread (thread);
3972 /* In all-stop, we only print the status of one thread, and leave
3973 others with their status pending. */
3978 thread = lowest_stopped;
3982 print_one_stopped_thread (thread);
3985 /* For "info program". */
3986 thread = inferior_thread ();
3987 if (thread->state == THREAD_STOPPED)
3988 set_last_target_status (inferior_ptid, thread->suspend.waitstatus);
3992 remote_start_remote (int from_tty, struct target_ops *target, int extended_p)
3994 struct remote_state *rs = get_remote_state ();
3995 struct packet_config *noack_config;
3996 char *wait_status = NULL;
3998 immediate_quit++; /* Allow user to interrupt it. */
4001 if (interrupt_on_connect)
4002 send_interrupt_sequence ();
4004 /* Ack any packet which the remote side has already sent. */
4005 serial_write (rs->remote_desc, "+", 1);
4007 /* Signal other parts that we're going through the initial setup,
4008 and so things may not be stable yet. */
4009 rs->starting_up = 1;
4011 /* The first packet we send to the target is the optional "supported
4012 packets" request. If the target can answer this, it will tell us
4013 which later probes to skip. */
4014 remote_query_supported ();
4016 /* If the stub wants to get a QAllow, compose one and send it. */
4017 if (packet_support (PACKET_QAllow) != PACKET_DISABLE)
4018 remote_set_permissions (target);
4020 /* Next, we possibly activate noack mode.
4022 If the QStartNoAckMode packet configuration is set to AUTO,
4023 enable noack mode if the stub reported a wish for it with
4026 If set to TRUE, then enable noack mode even if the stub didn't
4027 report it in qSupported. If the stub doesn't reply OK, the
4028 session ends with an error.
4030 If FALSE, then don't activate noack mode, regardless of what the
4031 stub claimed should be the default with qSupported. */
4033 noack_config = &remote_protocol_packets[PACKET_QStartNoAckMode];
4034 if (packet_config_support (noack_config) != PACKET_DISABLE)
4036 putpkt ("QStartNoAckMode");
4037 getpkt (&rs->buf, &rs->buf_size, 0);
4038 if (packet_ok (rs->buf, noack_config) == PACKET_OK)
4044 /* Tell the remote that we are using the extended protocol. */
4046 getpkt (&rs->buf, &rs->buf_size, 0);
4049 /* Let the target know which signals it is allowed to pass down to
4051 update_signals_program_target ();
4053 /* Next, if the target can specify a description, read it. We do
4054 this before anything involving memory or registers. */
4055 target_find_description ();
4057 /* Next, now that we know something about the target, update the
4058 address spaces in the program spaces. */
4059 update_address_spaces ();
4061 /* On OSs where the list of libraries is global to all
4062 processes, we fetch them early. */
4063 if (gdbarch_has_global_solist (target_gdbarch ()))
4064 solib_add (NULL, from_tty, target, auto_solib_add);
4066 if (target_is_non_stop_p ())
4068 if (packet_support (PACKET_QNonStop) != PACKET_ENABLE)
4069 error (_("Non-stop mode requested, but remote "
4070 "does not support non-stop"));
4072 putpkt ("QNonStop:1");
4073 getpkt (&rs->buf, &rs->buf_size, 0);
4075 if (strcmp (rs->buf, "OK") != 0)
4076 error (_("Remote refused setting non-stop mode with: %s"), rs->buf);
4078 /* Find about threads and processes the stub is already
4079 controlling. We default to adding them in the running state.
4080 The '?' query below will then tell us about which threads are
4082 remote_update_thread_list (target);
4084 else if (packet_support (PACKET_QNonStop) == PACKET_ENABLE)
4086 /* Don't assume that the stub can operate in all-stop mode.
4087 Request it explicitly. */
4088 putpkt ("QNonStop:0");
4089 getpkt (&rs->buf, &rs->buf_size, 0);
4091 if (strcmp (rs->buf, "OK") != 0)
4092 error (_("Remote refused setting all-stop mode with: %s"), rs->buf);
4095 /* Upload TSVs regardless of whether the target is running or not. The
4096 remote stub, such as GDBserver, may have some predefined or builtin
4097 TSVs, even if the target is not running. */
4098 if (remote_get_trace_status (target, current_trace_status ()) != -1)
4100 struct uploaded_tsv *uploaded_tsvs = NULL;
4102 remote_upload_trace_state_variables (target, &uploaded_tsvs);
4103 merge_uploaded_trace_state_variables (&uploaded_tsvs);
4106 /* Check whether the target is running now. */
4108 getpkt (&rs->buf, &rs->buf_size, 0);
4110 if (!target_is_non_stop_p ())
4112 if (rs->buf[0] == 'W' || rs->buf[0] == 'X')
4115 error (_("The target is not running (try extended-remote?)"));
4117 /* We're connected, but not running. Drop out before we
4118 call start_remote. */
4119 rs->starting_up = 0;
4124 /* Save the reply for later. */
4125 wait_status = (char *) alloca (strlen (rs->buf) + 1);
4126 strcpy (wait_status, rs->buf);
4129 /* Fetch thread list. */
4130 target_update_thread_list ();
4132 /* Let the stub know that we want it to return the thread. */
4133 set_continue_thread (minus_one_ptid);
4135 if (thread_count () == 0)
4137 /* Target has no concept of threads at all. GDB treats
4138 non-threaded target as single-threaded; add a main
4140 add_current_inferior_and_thread (wait_status);
4144 /* We have thread information; select the thread the target
4145 says should be current. If we're reconnecting to a
4146 multi-threaded program, this will ideally be the thread
4147 that last reported an event before GDB disconnected. */
4148 inferior_ptid = get_current_thread (wait_status);
4149 if (ptid_equal (inferior_ptid, null_ptid))
4151 /* Odd... The target was able to list threads, but not
4152 tell us which thread was current (no "thread"
4153 register in T stop reply?). Just pick the first
4154 thread in the thread list then. */
4157 fprintf_unfiltered (gdb_stdlog,
4158 "warning: couldn't determine remote "
4159 "current thread; picking first in list.\n");
4161 inferior_ptid = thread_list->ptid;
4165 /* init_wait_for_inferior should be called before get_offsets in order
4166 to manage `inserted' flag in bp loc in a correct state.
4167 breakpoint_init_inferior, called from init_wait_for_inferior, set
4168 `inserted' flag to 0, while before breakpoint_re_set, called from
4169 start_remote, set `inserted' flag to 1. In the initialization of
4170 inferior, breakpoint_init_inferior should be called first, and then
4171 breakpoint_re_set can be called. If this order is broken, state of
4172 `inserted' flag is wrong, and cause some problems on breakpoint
4174 init_wait_for_inferior ();
4176 get_offsets (); /* Get text, data & bss offsets. */
4178 /* If we could not find a description using qXfer, and we know
4179 how to do it some other way, try again. This is not
4180 supported for non-stop; it could be, but it is tricky if
4181 there are no stopped threads when we connect. */
4182 if (remote_read_description_p (target)
4183 && gdbarch_target_desc (target_gdbarch ()) == NULL)
4185 target_clear_description ();
4186 target_find_description ();
4189 /* Use the previously fetched status. */
4190 gdb_assert (wait_status != NULL);
4191 strcpy (rs->buf, wait_status);
4192 rs->cached_wait_status = 1;
4195 start_remote (from_tty); /* Initialize gdb process mechanisms. */
4199 /* Clear WFI global state. Do this before finding about new
4200 threads and inferiors, and setting the current inferior.
4201 Otherwise we would clear the proceed status of the current
4202 inferior when we want its stop_soon state to be preserved
4203 (see notice_new_inferior). */
4204 init_wait_for_inferior ();
4206 /* In non-stop, we will either get an "OK", meaning that there
4207 are no stopped threads at this time; or, a regular stop
4208 reply. In the latter case, there may be more than one thread
4209 stopped --- we pull them all out using the vStopped
4211 if (strcmp (rs->buf, "OK") != 0)
4213 struct notif_client *notif = ¬if_client_stop;
4215 /* remote_notif_get_pending_replies acks this one, and gets
4217 rs->notif_state->pending_event[notif_client_stop.id]
4218 = remote_notif_parse (notif, rs->buf);
4219 remote_notif_get_pending_events (notif);
4222 if (thread_count () == 0)
4225 error (_("The target is not running (try extended-remote?)"));
4227 /* We're connected, but not running. Drop out before we
4228 call start_remote. */
4229 rs->starting_up = 0;
4233 /* In non-stop mode, any cached wait status will be stored in
4234 the stop reply queue. */
4235 gdb_assert (wait_status == NULL);
4237 /* Report all signals during attach/startup. */
4238 remote_pass_signals (target, 0, NULL);
4240 /* If there are already stopped threads, mark them stopped and
4241 report their stops before giving the prompt to the user. */
4242 process_initial_stop_replies (from_tty);
4244 if (target_can_async_p ())
4248 /* If we connected to a live target, do some additional setup. */
4249 if (target_has_execution)
4251 if (symfile_objfile) /* No use without a symbol-file. */
4252 remote_check_symbols ();
4255 /* Possibly the target has been engaged in a trace run started
4256 previously; find out where things are at. */
4257 if (remote_get_trace_status (target, current_trace_status ()) != -1)
4259 struct uploaded_tp *uploaded_tps = NULL;
4261 if (current_trace_status ()->running)
4262 printf_filtered (_("Trace is already running on the target.\n"));
4264 remote_upload_tracepoints (target, &uploaded_tps);
4266 merge_uploaded_tracepoints (&uploaded_tps);
4269 /* The thread and inferior lists are now synchronized with the
4270 target, our symbols have been relocated, and we're merged the
4271 target's tracepoints with ours. We're done with basic start
4273 rs->starting_up = 0;
4275 /* Maybe breakpoints are global and need to be inserted now. */
4276 if (breakpoints_should_be_inserted_now ())
4277 insert_breakpoints ();
4280 /* Open a connection to a remote debugger.
4281 NAME is the filename used for communication. */
4284 remote_open (const char *name, int from_tty)
4286 remote_open_1 (name, from_tty, &remote_ops, 0);
4289 /* Open a connection to a remote debugger using the extended
4290 remote gdb protocol. NAME is the filename used for communication. */
4293 extended_remote_open (const char *name, int from_tty)
4295 remote_open_1 (name, from_tty, &extended_remote_ops, 1 /*extended_p */);
4298 /* Reset all packets back to "unknown support". Called when opening a
4299 new connection to a remote target. */
4302 reset_all_packet_configs_support (void)
4306 for (i = 0; i < PACKET_MAX; i++)
4307 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
4310 /* Initialize all packet configs. */
4313 init_all_packet_configs (void)
4317 for (i = 0; i < PACKET_MAX; i++)
4319 remote_protocol_packets[i].detect = AUTO_BOOLEAN_AUTO;
4320 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
4324 /* Symbol look-up. */
4327 remote_check_symbols (void)
4329 struct remote_state *rs = get_remote_state ();
4330 char *msg, *reply, *tmp;
4332 struct cleanup *old_chain;
4334 /* The remote side has no concept of inferiors that aren't running
4335 yet, it only knows about running processes. If we're connected
4336 but our current inferior is not running, we should not invite the
4337 remote target to request symbol lookups related to its
4338 (unrelated) current process. */
4339 if (!target_has_execution)
4342 if (packet_support (PACKET_qSymbol) == PACKET_DISABLE)
4345 /* Make sure the remote is pointing at the right process. Note
4346 there's no way to select "no process". */
4347 set_general_process ();
4349 /* Allocate a message buffer. We can't reuse the input buffer in RS,
4350 because we need both at the same time. */
4351 msg = (char *) xmalloc (get_remote_packet_size ());
4352 old_chain = make_cleanup (xfree, msg);
4354 /* Invite target to request symbol lookups. */
4356 putpkt ("qSymbol::");
4357 getpkt (&rs->buf, &rs->buf_size, 0);
4358 packet_ok (rs->buf, &remote_protocol_packets[PACKET_qSymbol]);
4361 while (startswith (reply, "qSymbol:"))
4363 struct bound_minimal_symbol sym;
4366 end = hex2bin (tmp, (gdb_byte *) msg, strlen (tmp) / 2);
4368 sym = lookup_minimal_symbol (msg, NULL, NULL);
4369 if (sym.minsym == NULL)
4370 xsnprintf (msg, get_remote_packet_size (), "qSymbol::%s", &reply[8]);
4373 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
4374 CORE_ADDR sym_addr = BMSYMBOL_VALUE_ADDRESS (sym);
4376 /* If this is a function address, return the start of code
4377 instead of any data function descriptor. */
4378 sym_addr = gdbarch_convert_from_func_ptr_addr (target_gdbarch (),
4382 xsnprintf (msg, get_remote_packet_size (), "qSymbol:%s:%s",
4383 phex_nz (sym_addr, addr_size), &reply[8]);
4387 getpkt (&rs->buf, &rs->buf_size, 0);
4391 do_cleanups (old_chain);
4394 static struct serial *
4395 remote_serial_open (const char *name)
4397 static int udp_warning = 0;
4399 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
4400 of in ser-tcp.c, because it is the remote protocol assuming that the
4401 serial connection is reliable and not the serial connection promising
4403 if (!udp_warning && startswith (name, "udp:"))
4405 warning (_("The remote protocol may be unreliable over UDP.\n"
4406 "Some events may be lost, rendering further debugging "
4411 return serial_open (name);
4414 /* Inform the target of our permission settings. The permission flags
4415 work without this, but if the target knows the settings, it can do
4416 a couple things. First, it can add its own check, to catch cases
4417 that somehow manage to get by the permissions checks in target
4418 methods. Second, if the target is wired to disallow particular
4419 settings (for instance, a system in the field that is not set up to
4420 be able to stop at a breakpoint), it can object to any unavailable
4424 remote_set_permissions (struct target_ops *self)
4426 struct remote_state *rs = get_remote_state ();
4428 xsnprintf (rs->buf, get_remote_packet_size (), "QAllow:"
4429 "WriteReg:%x;WriteMem:%x;"
4430 "InsertBreak:%x;InsertTrace:%x;"
4431 "InsertFastTrace:%x;Stop:%x",
4432 may_write_registers, may_write_memory,
4433 may_insert_breakpoints, may_insert_tracepoints,
4434 may_insert_fast_tracepoints, may_stop);
4436 getpkt (&rs->buf, &rs->buf_size, 0);
4438 /* If the target didn't like the packet, warn the user. Do not try
4439 to undo the user's settings, that would just be maddening. */
4440 if (strcmp (rs->buf, "OK") != 0)
4441 warning (_("Remote refused setting permissions with: %s"), rs->buf);
4444 /* This type describes each known response to the qSupported
4446 struct protocol_feature
4448 /* The name of this protocol feature. */
4451 /* The default for this protocol feature. */
4452 enum packet_support default_support;
4454 /* The function to call when this feature is reported, or after
4455 qSupported processing if the feature is not supported.
4456 The first argument points to this structure. The second
4457 argument indicates whether the packet requested support be
4458 enabled, disabled, or probed (or the default, if this function
4459 is being called at the end of processing and this feature was
4460 not reported). The third argument may be NULL; if not NULL, it
4461 is a NUL-terminated string taken from the packet following
4462 this feature's name and an equals sign. */
4463 void (*func) (const struct protocol_feature *, enum packet_support,
4466 /* The corresponding packet for this feature. Only used if
4467 FUNC is remote_supported_packet. */
4472 remote_supported_packet (const struct protocol_feature *feature,
4473 enum packet_support support,
4474 const char *argument)
4478 warning (_("Remote qSupported response supplied an unexpected value for"
4479 " \"%s\"."), feature->name);
4483 remote_protocol_packets[feature->packet].support = support;
4487 remote_packet_size (const struct protocol_feature *feature,
4488 enum packet_support support, const char *value)
4490 struct remote_state *rs = get_remote_state ();
4495 if (support != PACKET_ENABLE)
4498 if (value == NULL || *value == '\0')
4500 warning (_("Remote target reported \"%s\" without a size."),
4506 packet_size = strtol (value, &value_end, 16);
4507 if (errno != 0 || *value_end != '\0' || packet_size < 0)
4509 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
4510 feature->name, value);
4514 /* Record the new maximum packet size. */
4515 rs->explicit_packet_size = packet_size;
4518 static const struct protocol_feature remote_protocol_features[] = {
4519 { "PacketSize", PACKET_DISABLE, remote_packet_size, -1 },
4520 { "qXfer:auxv:read", PACKET_DISABLE, remote_supported_packet,
4521 PACKET_qXfer_auxv },
4522 { "qXfer:exec-file:read", PACKET_DISABLE, remote_supported_packet,
4523 PACKET_qXfer_exec_file },
4524 { "qXfer:features:read", PACKET_DISABLE, remote_supported_packet,
4525 PACKET_qXfer_features },
4526 { "qXfer:libraries:read", PACKET_DISABLE, remote_supported_packet,
4527 PACKET_qXfer_libraries },
4528 { "qXfer:libraries-svr4:read", PACKET_DISABLE, remote_supported_packet,
4529 PACKET_qXfer_libraries_svr4 },
4530 { "augmented-libraries-svr4-read", PACKET_DISABLE,
4531 remote_supported_packet, PACKET_augmented_libraries_svr4_read_feature },
4532 { "qXfer:memory-map:read", PACKET_DISABLE, remote_supported_packet,
4533 PACKET_qXfer_memory_map },
4534 { "qXfer:spu:read", PACKET_DISABLE, remote_supported_packet,
4535 PACKET_qXfer_spu_read },
4536 { "qXfer:spu:write", PACKET_DISABLE, remote_supported_packet,
4537 PACKET_qXfer_spu_write },
4538 { "qXfer:osdata:read", PACKET_DISABLE, remote_supported_packet,
4539 PACKET_qXfer_osdata },
4540 { "qXfer:threads:read", PACKET_DISABLE, remote_supported_packet,
4541 PACKET_qXfer_threads },
4542 { "qXfer:traceframe-info:read", PACKET_DISABLE, remote_supported_packet,
4543 PACKET_qXfer_traceframe_info },
4544 { "QPassSignals", PACKET_DISABLE, remote_supported_packet,
4545 PACKET_QPassSignals },
4546 { "QCatchSyscalls", PACKET_DISABLE, remote_supported_packet,
4547 PACKET_QCatchSyscalls },
4548 { "QProgramSignals", PACKET_DISABLE, remote_supported_packet,
4549 PACKET_QProgramSignals },
4550 { "QStartNoAckMode", PACKET_DISABLE, remote_supported_packet,
4551 PACKET_QStartNoAckMode },
4552 { "multiprocess", PACKET_DISABLE, remote_supported_packet,
4553 PACKET_multiprocess_feature },
4554 { "QNonStop", PACKET_DISABLE, remote_supported_packet, PACKET_QNonStop },
4555 { "qXfer:siginfo:read", PACKET_DISABLE, remote_supported_packet,
4556 PACKET_qXfer_siginfo_read },
4557 { "qXfer:siginfo:write", PACKET_DISABLE, remote_supported_packet,
4558 PACKET_qXfer_siginfo_write },
4559 { "ConditionalTracepoints", PACKET_DISABLE, remote_supported_packet,
4560 PACKET_ConditionalTracepoints },
4561 { "ConditionalBreakpoints", PACKET_DISABLE, remote_supported_packet,
4562 PACKET_ConditionalBreakpoints },
4563 { "BreakpointCommands", PACKET_DISABLE, remote_supported_packet,
4564 PACKET_BreakpointCommands },
4565 { "FastTracepoints", PACKET_DISABLE, remote_supported_packet,
4566 PACKET_FastTracepoints },
4567 { "StaticTracepoints", PACKET_DISABLE, remote_supported_packet,
4568 PACKET_StaticTracepoints },
4569 {"InstallInTrace", PACKET_DISABLE, remote_supported_packet,
4570 PACKET_InstallInTrace},
4571 { "DisconnectedTracing", PACKET_DISABLE, remote_supported_packet,
4572 PACKET_DisconnectedTracing_feature },
4573 { "ReverseContinue", PACKET_DISABLE, remote_supported_packet,
4575 { "ReverseStep", PACKET_DISABLE, remote_supported_packet,
4577 { "TracepointSource", PACKET_DISABLE, remote_supported_packet,
4578 PACKET_TracepointSource },
4579 { "QAllow", PACKET_DISABLE, remote_supported_packet,
4581 { "EnableDisableTracepoints", PACKET_DISABLE, remote_supported_packet,
4582 PACKET_EnableDisableTracepoints_feature },
4583 { "qXfer:fdpic:read", PACKET_DISABLE, remote_supported_packet,
4584 PACKET_qXfer_fdpic },
4585 { "qXfer:uib:read", PACKET_DISABLE, remote_supported_packet,
4587 { "QDisableRandomization", PACKET_DISABLE, remote_supported_packet,
4588 PACKET_QDisableRandomization },
4589 { "QAgent", PACKET_DISABLE, remote_supported_packet, PACKET_QAgent},
4590 { "QTBuffer:size", PACKET_DISABLE,
4591 remote_supported_packet, PACKET_QTBuffer_size},
4592 { "tracenz", PACKET_DISABLE, remote_supported_packet, PACKET_tracenz_feature },
4593 { "Qbtrace:off", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_off },
4594 { "Qbtrace:bts", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_bts },
4595 { "Qbtrace:pt", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_pt },
4596 { "qXfer:btrace:read", PACKET_DISABLE, remote_supported_packet,
4597 PACKET_qXfer_btrace },
4598 { "qXfer:btrace-conf:read", PACKET_DISABLE, remote_supported_packet,
4599 PACKET_qXfer_btrace_conf },
4600 { "Qbtrace-conf:bts:size", PACKET_DISABLE, remote_supported_packet,
4601 PACKET_Qbtrace_conf_bts_size },
4602 { "swbreak", PACKET_DISABLE, remote_supported_packet, PACKET_swbreak_feature },
4603 { "hwbreak", PACKET_DISABLE, remote_supported_packet, PACKET_hwbreak_feature },
4604 { "fork-events", PACKET_DISABLE, remote_supported_packet,
4605 PACKET_fork_event_feature },
4606 { "vfork-events", PACKET_DISABLE, remote_supported_packet,
4607 PACKET_vfork_event_feature },
4608 { "exec-events", PACKET_DISABLE, remote_supported_packet,
4609 PACKET_exec_event_feature },
4610 { "Qbtrace-conf:pt:size", PACKET_DISABLE, remote_supported_packet,
4611 PACKET_Qbtrace_conf_pt_size },
4612 { "vContSupported", PACKET_DISABLE, remote_supported_packet, PACKET_vContSupported },
4613 { "QThreadEvents", PACKET_DISABLE, remote_supported_packet, PACKET_QThreadEvents },
4614 { "no-resumed", PACKET_DISABLE, remote_supported_packet, PACKET_no_resumed },
4617 static char *remote_support_xml;
4619 /* Register string appended to "xmlRegisters=" in qSupported query. */
4622 register_remote_support_xml (const char *xml)
4624 #if defined(HAVE_LIBEXPAT)
4625 if (remote_support_xml == NULL)
4626 remote_support_xml = concat ("xmlRegisters=", xml, (char *) NULL);
4629 char *copy = xstrdup (remote_support_xml + 13);
4630 char *p = strtok (copy, ",");
4634 if (strcmp (p, xml) == 0)
4641 while ((p = strtok (NULL, ",")) != NULL);
4644 remote_support_xml = reconcat (remote_support_xml,
4645 remote_support_xml, ",", xml,
4652 remote_query_supported_append (char *msg, const char *append)
4655 return reconcat (msg, msg, ";", append, (char *) NULL);
4657 return xstrdup (append);
4661 remote_query_supported (void)
4663 struct remote_state *rs = get_remote_state ();
4666 unsigned char seen [ARRAY_SIZE (remote_protocol_features)];
4668 /* The packet support flags are handled differently for this packet
4669 than for most others. We treat an error, a disabled packet, and
4670 an empty response identically: any features which must be reported
4671 to be used will be automatically disabled. An empty buffer
4672 accomplishes this, since that is also the representation for a list
4673 containing no features. */
4676 if (packet_support (PACKET_qSupported) != PACKET_DISABLE)
4679 struct cleanup *old_chain = make_cleanup (free_current_contents, &q);
4681 if (packet_set_cmd_state (PACKET_multiprocess_feature) != AUTO_BOOLEAN_FALSE)
4682 q = remote_query_supported_append (q, "multiprocess+");
4684 if (packet_set_cmd_state (PACKET_swbreak_feature) != AUTO_BOOLEAN_FALSE)
4685 q = remote_query_supported_append (q, "swbreak+");
4686 if (packet_set_cmd_state (PACKET_hwbreak_feature) != AUTO_BOOLEAN_FALSE)
4687 q = remote_query_supported_append (q, "hwbreak+");
4689 q = remote_query_supported_append (q, "qRelocInsn+");
4691 if (packet_set_cmd_state (PACKET_fork_event_feature)
4692 != AUTO_BOOLEAN_FALSE)
4693 q = remote_query_supported_append (q, "fork-events+");
4694 if (packet_set_cmd_state (PACKET_vfork_event_feature)
4695 != AUTO_BOOLEAN_FALSE)
4696 q = remote_query_supported_append (q, "vfork-events+");
4697 if (packet_set_cmd_state (PACKET_exec_event_feature)
4698 != AUTO_BOOLEAN_FALSE)
4699 q = remote_query_supported_append (q, "exec-events+");
4701 if (packet_set_cmd_state (PACKET_vContSupported) != AUTO_BOOLEAN_FALSE)
4702 q = remote_query_supported_append (q, "vContSupported+");
4704 if (packet_set_cmd_state (PACKET_QThreadEvents) != AUTO_BOOLEAN_FALSE)
4705 q = remote_query_supported_append (q, "QThreadEvents+");
4707 if (packet_set_cmd_state (PACKET_no_resumed) != AUTO_BOOLEAN_FALSE)
4708 q = remote_query_supported_append (q, "no-resumed+");
4710 /* Keep this one last to work around a gdbserver <= 7.10 bug in
4711 the qSupported:xmlRegisters=i386 handling. */
4712 if (remote_support_xml != NULL)
4713 q = remote_query_supported_append (q, remote_support_xml);
4715 q = reconcat (q, "qSupported:", q, (char *) NULL);
4718 do_cleanups (old_chain);
4720 getpkt (&rs->buf, &rs->buf_size, 0);
4722 /* If an error occured, warn, but do not return - just reset the
4723 buffer to empty and go on to disable features. */
4724 if (packet_ok (rs->buf, &remote_protocol_packets[PACKET_qSupported])
4727 warning (_("Remote failure reply: %s"), rs->buf);
4732 memset (seen, 0, sizeof (seen));
4737 enum packet_support is_supported;
4738 char *p, *end, *name_end, *value;
4740 /* First separate out this item from the rest of the packet. If
4741 there's another item after this, we overwrite the separator
4742 (terminated strings are much easier to work with). */
4744 end = strchr (p, ';');
4747 end = p + strlen (p);
4757 warning (_("empty item in \"qSupported\" response"));
4762 name_end = strchr (p, '=');
4765 /* This is a name=value entry. */
4766 is_supported = PACKET_ENABLE;
4767 value = name_end + 1;
4776 is_supported = PACKET_ENABLE;
4780 is_supported = PACKET_DISABLE;
4784 is_supported = PACKET_SUPPORT_UNKNOWN;
4788 warning (_("unrecognized item \"%s\" "
4789 "in \"qSupported\" response"), p);
4795 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
4796 if (strcmp (remote_protocol_features[i].name, p) == 0)
4798 const struct protocol_feature *feature;
4801 feature = &remote_protocol_features[i];
4802 feature->func (feature, is_supported, value);
4807 /* If we increased the packet size, make sure to increase the global
4808 buffer size also. We delay this until after parsing the entire
4809 qSupported packet, because this is the same buffer we were
4811 if (rs->buf_size < rs->explicit_packet_size)
4813 rs->buf_size = rs->explicit_packet_size;
4814 rs->buf = (char *) xrealloc (rs->buf, rs->buf_size);
4817 /* Handle the defaults for unmentioned features. */
4818 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
4821 const struct protocol_feature *feature;
4823 feature = &remote_protocol_features[i];
4824 feature->func (feature, feature->default_support, NULL);
4828 /* Remove any of the remote.c targets from target stack. Upper targets depend
4829 on it so remove them first. */
4832 remote_unpush_target (void)
4834 pop_all_targets_at_and_above (process_stratum);
4838 remote_open_1 (const char *name, int from_tty,
4839 struct target_ops *target, int extended_p)
4841 struct remote_state *rs = get_remote_state ();
4844 error (_("To open a remote debug connection, you need to specify what\n"
4845 "serial device is attached to the remote system\n"
4846 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
4848 /* See FIXME above. */
4849 if (!target_async_permitted)
4850 wait_forever_enabled_p = 1;
4852 /* If we're connected to a running target, target_preopen will kill it.
4853 Ask this question first, before target_preopen has a chance to kill
4855 if (rs->remote_desc != NULL && !have_inferiors ())
4858 && !query (_("Already connected to a remote target. Disconnect? ")))
4859 error (_("Still connected."));
4862 /* Here the possibly existing remote target gets unpushed. */
4863 target_preopen (from_tty);
4865 /* Make sure we send the passed signals list the next time we resume. */
4866 xfree (rs->last_pass_packet);
4867 rs->last_pass_packet = NULL;
4869 /* Make sure we send the program signals list the next time we
4871 xfree (rs->last_program_signals_packet);
4872 rs->last_program_signals_packet = NULL;
4874 remote_fileio_reset ();
4875 reopen_exec_file ();
4878 rs->remote_desc = remote_serial_open (name);
4879 if (!rs->remote_desc)
4880 perror_with_name (name);
4882 if (baud_rate != -1)
4884 if (serial_setbaudrate (rs->remote_desc, baud_rate))
4886 /* The requested speed could not be set. Error out to
4887 top level after closing remote_desc. Take care to
4888 set remote_desc to NULL to avoid closing remote_desc
4890 serial_close (rs->remote_desc);
4891 rs->remote_desc = NULL;
4892 perror_with_name (name);
4896 serial_setparity (rs->remote_desc, serial_parity);
4897 serial_raw (rs->remote_desc);
4899 /* If there is something sitting in the buffer we might take it as a
4900 response to a command, which would be bad. */
4901 serial_flush_input (rs->remote_desc);
4905 puts_filtered ("Remote debugging using ");
4906 puts_filtered (name);
4907 puts_filtered ("\n");
4909 push_target (target); /* Switch to using remote target now. */
4911 /* Register extra event sources in the event loop. */
4912 remote_async_inferior_event_token
4913 = create_async_event_handler (remote_async_inferior_event_handler,
4915 rs->notif_state = remote_notif_state_allocate ();
4917 /* Reset the target state; these things will be queried either by
4918 remote_query_supported or as they are needed. */
4919 reset_all_packet_configs_support ();
4920 rs->cached_wait_status = 0;
4921 rs->explicit_packet_size = 0;
4923 rs->extended = extended_p;
4924 rs->waiting_for_stop_reply = 0;
4925 rs->ctrlc_pending_p = 0;
4927 rs->general_thread = not_sent_ptid;
4928 rs->continue_thread = not_sent_ptid;
4929 rs->remote_traceframe_number = -1;
4931 /* Probe for ability to use "ThreadInfo" query, as required. */
4932 rs->use_threadinfo_query = 1;
4933 rs->use_threadextra_query = 1;
4935 readahead_cache_invalidate ();
4937 if (target_async_permitted)
4939 /* With this target we start out by owning the terminal. */
4940 remote_async_terminal_ours_p = 1;
4942 /* FIXME: cagney/1999-09-23: During the initial connection it is
4943 assumed that the target is already ready and able to respond to
4944 requests. Unfortunately remote_start_remote() eventually calls
4945 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
4946 around this. Eventually a mechanism that allows
4947 wait_for_inferior() to expect/get timeouts will be
4949 wait_forever_enabled_p = 0;
4952 /* First delete any symbols previously loaded from shared libraries. */
4953 no_shared_libraries (NULL, 0);
4956 init_thread_list ();
4958 /* Start the remote connection. If error() or QUIT, discard this
4959 target (we'd otherwise be in an inconsistent state) and then
4960 propogate the error on up the exception chain. This ensures that
4961 the caller doesn't stumble along blindly assuming that the
4962 function succeeded. The CLI doesn't have this problem but other
4963 UI's, such as MI do.
4965 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
4966 this function should return an error indication letting the
4967 caller restore the previous state. Unfortunately the command
4968 ``target remote'' is directly wired to this function making that
4969 impossible. On a positive note, the CLI side of this problem has
4970 been fixed - the function set_cmd_context() makes it possible for
4971 all the ``target ....'' commands to share a common callback
4972 function. See cli-dump.c. */
4977 remote_start_remote (from_tty, target, extended_p);
4979 CATCH (ex, RETURN_MASK_ALL)
4981 /* Pop the partially set up target - unless something else did
4982 already before throwing the exception. */
4983 if (rs->remote_desc != NULL)
4984 remote_unpush_target ();
4985 if (target_async_permitted)
4986 wait_forever_enabled_p = 1;
4987 throw_exception (ex);
4992 remote_btrace_reset ();
4994 if (target_async_permitted)
4995 wait_forever_enabled_p = 1;
4998 /* Detach the specified process. */
5001 remote_detach_pid (int pid)
5003 struct remote_state *rs = get_remote_state ();
5005 if (remote_multi_process_p (rs))
5006 xsnprintf (rs->buf, get_remote_packet_size (), "D;%x", pid);
5008 strcpy (rs->buf, "D");
5011 getpkt (&rs->buf, &rs->buf_size, 0);
5013 if (rs->buf[0] == 'O' && rs->buf[1] == 'K')
5015 else if (rs->buf[0] == '\0')
5016 error (_("Remote doesn't know how to detach"));
5018 error (_("Can't detach process."));
5021 /* This detaches a program to which we previously attached, using
5022 inferior_ptid to identify the process. After this is done, GDB
5023 can be used to debug some other program. We better not have left
5024 any breakpoints in the target program or it'll die when it hits
5028 remote_detach_1 (const char *args, int from_tty)
5030 int pid = ptid_get_pid (inferior_ptid);
5031 struct remote_state *rs = get_remote_state ();
5032 struct thread_info *tp = find_thread_ptid (inferior_ptid);
5036 error (_("Argument given to \"detach\" when remotely debugging."));
5038 if (!target_has_execution)
5039 error (_("No process to detach from."));
5043 char *exec_file = get_exec_file (0);
5044 if (exec_file == NULL)
5046 printf_unfiltered (_("Detaching from program: %s, %s\n"), exec_file,
5047 target_pid_to_str (pid_to_ptid (pid)));
5048 gdb_flush (gdb_stdout);
5051 /* Tell the remote target to detach. */
5052 remote_detach_pid (pid);
5054 /* Exit only if this is the only active inferior. */
5055 if (from_tty && !rs->extended && number_of_live_inferiors () == 1)
5056 puts_filtered (_("Ending remote debugging.\n"));
5058 /* Check to see if we are detaching a fork parent. Note that if we
5059 are detaching a fork child, tp == NULL. */
5060 is_fork_parent = (tp != NULL
5061 && tp->pending_follow.kind == TARGET_WAITKIND_FORKED);
5063 /* If doing detach-on-fork, we don't mourn, because that will delete
5064 breakpoints that should be available for the followed inferior. */
5065 if (!is_fork_parent)
5066 target_mourn_inferior ();
5069 inferior_ptid = null_ptid;
5070 detach_inferior (pid);
5075 remote_detach (struct target_ops *ops, const char *args, int from_tty)
5077 remote_detach_1 (args, from_tty);
5081 extended_remote_detach (struct target_ops *ops, const char *args, int from_tty)
5083 remote_detach_1 (args, from_tty);
5086 /* Target follow-fork function for remote targets. On entry, and
5087 at return, the current inferior is the fork parent.
5089 Note that although this is currently only used for extended-remote,
5090 it is named remote_follow_fork in anticipation of using it for the
5091 remote target as well. */
5094 remote_follow_fork (struct target_ops *ops, int follow_child,
5097 struct remote_state *rs = get_remote_state ();
5098 enum target_waitkind kind = inferior_thread ()->pending_follow.kind;
5100 if ((kind == TARGET_WAITKIND_FORKED && remote_fork_event_p (rs))
5101 || (kind == TARGET_WAITKIND_VFORKED && remote_vfork_event_p (rs)))
5103 /* When following the parent and detaching the child, we detach
5104 the child here. For the case of following the child and
5105 detaching the parent, the detach is done in the target-
5106 independent follow fork code in infrun.c. We can't use
5107 target_detach when detaching an unfollowed child because
5108 the client side doesn't know anything about the child. */
5109 if (detach_fork && !follow_child)
5111 /* Detach the fork child. */
5115 child_ptid = inferior_thread ()->pending_follow.value.related_pid;
5116 child_pid = ptid_get_pid (child_ptid);
5118 remote_detach_pid (child_pid);
5119 detach_inferior (child_pid);
5125 /* Target follow-exec function for remote targets. Save EXECD_PATHNAME
5126 in the program space of the new inferior. On entry and at return the
5127 current inferior is the exec'ing inferior. INF is the new exec'd
5128 inferior, which may be the same as the exec'ing inferior unless
5129 follow-exec-mode is "new". */
5132 remote_follow_exec (struct target_ops *ops,
5133 struct inferior *inf, char *execd_pathname)
5135 /* We know that this is a target file name, so if it has the "target:"
5136 prefix we strip it off before saving it in the program space. */
5137 if (is_target_filename (execd_pathname))
5138 execd_pathname += strlen (TARGET_SYSROOT_PREFIX);
5140 set_pspace_remote_exec_file (inf->pspace, execd_pathname);
5143 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
5146 remote_disconnect (struct target_ops *target, const char *args, int from_tty)
5149 error (_("Argument given to \"disconnect\" when remotely debugging."));
5151 /* Make sure we unpush even the extended remote targets. Calling
5152 target_mourn_inferior won't unpush, and remote_mourn won't
5153 unpush if there is more than one inferior left. */
5154 unpush_target (target);
5155 generic_mourn_inferior ();
5158 puts_filtered ("Ending remote debugging.\n");
5161 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
5162 be chatty about it. */
5165 extended_remote_attach (struct target_ops *target, const char *args,
5168 struct remote_state *rs = get_remote_state ();
5170 char *wait_status = NULL;
5172 pid = parse_pid_to_attach (args);
5174 /* Remote PID can be freely equal to getpid, do not check it here the same
5175 way as in other targets. */
5177 if (packet_support (PACKET_vAttach) == PACKET_DISABLE)
5178 error (_("This target does not support attaching to a process"));
5182 char *exec_file = get_exec_file (0);
5185 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file,
5186 target_pid_to_str (pid_to_ptid (pid)));
5188 printf_unfiltered (_("Attaching to %s\n"),
5189 target_pid_to_str (pid_to_ptid (pid)));
5191 gdb_flush (gdb_stdout);
5194 xsnprintf (rs->buf, get_remote_packet_size (), "vAttach;%x", pid);
5196 getpkt (&rs->buf, &rs->buf_size, 0);
5198 switch (packet_ok (rs->buf,
5199 &remote_protocol_packets[PACKET_vAttach]))
5202 if (!target_is_non_stop_p ())
5204 /* Save the reply for later. */
5205 wait_status = (char *) alloca (strlen (rs->buf) + 1);
5206 strcpy (wait_status, rs->buf);
5208 else if (strcmp (rs->buf, "OK") != 0)
5209 error (_("Attaching to %s failed with: %s"),
5210 target_pid_to_str (pid_to_ptid (pid)),
5213 case PACKET_UNKNOWN:
5214 error (_("This target does not support attaching to a process"));
5216 error (_("Attaching to %s failed"),
5217 target_pid_to_str (pid_to_ptid (pid)));
5220 set_current_inferior (remote_add_inferior (0, pid, 1, 0));
5222 inferior_ptid = pid_to_ptid (pid);
5224 if (target_is_non_stop_p ())
5226 struct thread_info *thread;
5228 /* Get list of threads. */
5229 remote_update_thread_list (target);
5231 thread = first_thread_of_process (pid);
5233 inferior_ptid = thread->ptid;
5235 inferior_ptid = pid_to_ptid (pid);
5237 /* Invalidate our notion of the remote current thread. */
5238 record_currthread (rs, minus_one_ptid);
5242 /* Now, if we have thread information, update inferior_ptid. */
5243 inferior_ptid = remote_current_thread (inferior_ptid);
5245 /* Add the main thread to the thread list. */
5246 add_thread_silent (inferior_ptid);
5249 /* Next, if the target can specify a description, read it. We do
5250 this before anything involving memory or registers. */
5251 target_find_description ();
5253 if (!target_is_non_stop_p ())
5255 /* Use the previously fetched status. */
5256 gdb_assert (wait_status != NULL);
5258 if (target_can_async_p ())
5260 struct notif_event *reply
5261 = remote_notif_parse (¬if_client_stop, wait_status);
5263 push_stop_reply ((struct stop_reply *) reply);
5269 gdb_assert (wait_status != NULL);
5270 strcpy (rs->buf, wait_status);
5271 rs->cached_wait_status = 1;
5275 gdb_assert (wait_status == NULL);
5278 /* Implementation of the to_post_attach method. */
5281 extended_remote_post_attach (struct target_ops *ops, int pid)
5283 /* Get text, data & bss offsets. */
5286 /* In certain cases GDB might not have had the chance to start
5287 symbol lookup up until now. This could happen if the debugged
5288 binary is not using shared libraries, the vsyscall page is not
5289 present (on Linux) and the binary itself hadn't changed since the
5290 debugging process was started. */
5291 if (symfile_objfile != NULL)
5292 remote_check_symbols();
5296 /* Check for the availability of vCont. This function should also check
5300 remote_vcont_probe (struct remote_state *rs)
5304 strcpy (rs->buf, "vCont?");
5306 getpkt (&rs->buf, &rs->buf_size, 0);
5309 /* Make sure that the features we assume are supported. */
5310 if (startswith (buf, "vCont"))
5313 int support_c, support_C;
5315 rs->supports_vCont.s = 0;
5316 rs->supports_vCont.S = 0;
5319 rs->supports_vCont.t = 0;
5320 rs->supports_vCont.r = 0;
5321 while (p && *p == ';')
5324 if (*p == 's' && (*(p + 1) == ';' || *(p + 1) == 0))
5325 rs->supports_vCont.s = 1;
5326 else if (*p == 'S' && (*(p + 1) == ';' || *(p + 1) == 0))
5327 rs->supports_vCont.S = 1;
5328 else if (*p == 'c' && (*(p + 1) == ';' || *(p + 1) == 0))
5330 else if (*p == 'C' && (*(p + 1) == ';' || *(p + 1) == 0))
5332 else if (*p == 't' && (*(p + 1) == ';' || *(p + 1) == 0))
5333 rs->supports_vCont.t = 1;
5334 else if (*p == 'r' && (*(p + 1) == ';' || *(p + 1) == 0))
5335 rs->supports_vCont.r = 1;
5337 p = strchr (p, ';');
5340 /* If c, and C are not all supported, we can't use vCont. Clearing
5341 BUF will make packet_ok disable the packet. */
5342 if (!support_c || !support_C)
5346 packet_ok (buf, &remote_protocol_packets[PACKET_vCont]);
5349 /* Helper function for building "vCont" resumptions. Write a
5350 resumption to P. ENDP points to one-passed-the-end of the buffer
5351 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
5352 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
5353 resumed thread should be single-stepped and/or signalled. If PTID
5354 equals minus_one_ptid, then all threads are resumed; if PTID
5355 represents a process, then all threads of the process are resumed;
5356 the thread to be stepped and/or signalled is given in the global
5360 append_resumption (char *p, char *endp,
5361 ptid_t ptid, int step, enum gdb_signal siggnal)
5363 struct remote_state *rs = get_remote_state ();
5365 if (step && siggnal != GDB_SIGNAL_0)
5366 p += xsnprintf (p, endp - p, ";S%02x", siggnal);
5368 /* GDB is willing to range step. */
5369 && use_range_stepping
5370 /* Target supports range stepping. */
5371 && rs->supports_vCont.r
5372 /* We don't currently support range stepping multiple
5373 threads with a wildcard (though the protocol allows it,
5374 so stubs shouldn't make an active effort to forbid
5376 && !(remote_multi_process_p (rs) && ptid_is_pid (ptid)))
5378 struct thread_info *tp;
5380 if (ptid_equal (ptid, minus_one_ptid))
5382 /* If we don't know about the target thread's tid, then
5383 we're resuming magic_null_ptid (see caller). */
5384 tp = find_thread_ptid (magic_null_ptid);
5387 tp = find_thread_ptid (ptid);
5388 gdb_assert (tp != NULL);
5390 if (tp->control.may_range_step)
5392 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
5394 p += xsnprintf (p, endp - p, ";r%s,%s",
5395 phex_nz (tp->control.step_range_start,
5397 phex_nz (tp->control.step_range_end,
5401 p += xsnprintf (p, endp - p, ";s");
5404 p += xsnprintf (p, endp - p, ";s");
5405 else if (siggnal != GDB_SIGNAL_0)
5406 p += xsnprintf (p, endp - p, ";C%02x", siggnal);
5408 p += xsnprintf (p, endp - p, ";c");
5410 if (remote_multi_process_p (rs) && ptid_is_pid (ptid))
5414 /* All (-1) threads of process. */
5415 nptid = ptid_build (ptid_get_pid (ptid), -1, 0);
5417 p += xsnprintf (p, endp - p, ":");
5418 p = write_ptid (p, endp, nptid);
5420 else if (!ptid_equal (ptid, minus_one_ptid))
5422 p += xsnprintf (p, endp - p, ":");
5423 p = write_ptid (p, endp, ptid);
5429 /* Clear the thread's private info on resume. */
5432 resume_clear_thread_private_info (struct thread_info *thread)
5434 if (thread->priv != NULL)
5436 thread->priv->stop_reason = TARGET_STOPPED_BY_NO_REASON;
5437 thread->priv->watch_data_address = 0;
5441 /* Append a vCont continue-with-signal action for threads that have a
5442 non-zero stop signal. */
5445 append_pending_thread_resumptions (char *p, char *endp, ptid_t ptid)
5447 struct thread_info *thread;
5449 ALL_NON_EXITED_THREADS (thread)
5450 if (ptid_match (thread->ptid, ptid)
5451 && !ptid_equal (inferior_ptid, thread->ptid)
5452 && thread->suspend.stop_signal != GDB_SIGNAL_0)
5454 p = append_resumption (p, endp, thread->ptid,
5455 0, thread->suspend.stop_signal);
5456 thread->suspend.stop_signal = GDB_SIGNAL_0;
5457 resume_clear_thread_private_info (thread);
5463 /* Resume the remote inferior by using a "vCont" packet. The thread
5464 to be resumed is PTID; STEP and SIGGNAL indicate whether the
5465 resumed thread should be single-stepped and/or signalled. If PTID
5466 equals minus_one_ptid, then all threads are resumed; the thread to
5467 be stepped and/or signalled is given in the global INFERIOR_PTID.
5468 This function returns non-zero iff it resumes the inferior.
5470 This function issues a strict subset of all possible vCont commands at the
5474 remote_vcont_resume (ptid_t ptid, int step, enum gdb_signal siggnal)
5476 struct remote_state *rs = get_remote_state ();
5480 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
5481 remote_vcont_probe (rs);
5483 if (packet_support (PACKET_vCont) == PACKET_DISABLE)
5487 endp = rs->buf + get_remote_packet_size ();
5489 /* If we could generate a wider range of packets, we'd have to worry
5490 about overflowing BUF. Should there be a generic
5491 "multi-part-packet" packet? */
5493 p += xsnprintf (p, endp - p, "vCont");
5495 if (ptid_equal (ptid, magic_null_ptid))
5497 /* MAGIC_NULL_PTID means that we don't have any active threads,
5498 so we don't have any TID numbers the inferior will
5499 understand. Make sure to only send forms that do not specify
5501 append_resumption (p, endp, minus_one_ptid, step, siggnal);
5503 else if (ptid_equal (ptid, minus_one_ptid) || ptid_is_pid (ptid))
5505 /* Resume all threads (of all processes, or of a single
5506 process), with preference for INFERIOR_PTID. This assumes
5507 inferior_ptid belongs to the set of all threads we are about
5509 if (step || siggnal != GDB_SIGNAL_0)
5511 /* Step inferior_ptid, with or without signal. */
5512 p = append_resumption (p, endp, inferior_ptid, step, siggnal);
5515 /* Also pass down any pending signaled resumption for other
5516 threads not the current. */
5517 p = append_pending_thread_resumptions (p, endp, ptid);
5519 /* And continue others without a signal. */
5520 append_resumption (p, endp, ptid, /*step=*/ 0, GDB_SIGNAL_0);
5524 /* Scheduler locking; resume only PTID. */
5525 append_resumption (p, endp, ptid, step, siggnal);
5528 gdb_assert (strlen (rs->buf) < get_remote_packet_size ());
5531 if (target_is_non_stop_p ())
5533 /* In non-stop, the stub replies to vCont with "OK". The stop
5534 reply will be reported asynchronously by means of a `%Stop'
5536 getpkt (&rs->buf, &rs->buf_size, 0);
5537 if (strcmp (rs->buf, "OK") != 0)
5538 error (_("Unexpected vCont reply in non-stop mode: %s"), rs->buf);
5544 /* Tell the remote machine to resume. */
5547 remote_resume (struct target_ops *ops,
5548 ptid_t ptid, int step, enum gdb_signal siggnal)
5550 struct remote_state *rs = get_remote_state ();
5552 struct thread_info *thread;
5554 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
5555 (explained in remote-notif.c:handle_notification) so
5556 remote_notif_process is not called. We need find a place where
5557 it is safe to start a 'vNotif' sequence. It is good to do it
5558 before resuming inferior, because inferior was stopped and no RSP
5559 traffic at that moment. */
5560 if (!target_is_non_stop_p ())
5561 remote_notif_process (rs->notif_state, ¬if_client_stop);
5563 rs->last_sent_signal = siggnal;
5564 rs->last_sent_step = step;
5566 /* The vCont packet doesn't need to specify threads via Hc. */
5567 /* No reverse support (yet) for vCont. */
5568 if (execution_direction != EXEC_REVERSE)
5569 if (remote_vcont_resume (ptid, step, siggnal))
5572 /* All other supported resume packets do use Hc, so set the continue
5574 if (ptid_equal (ptid, minus_one_ptid))
5575 set_continue_thread (any_thread_ptid);
5577 set_continue_thread (ptid);
5579 ALL_NON_EXITED_THREADS (thread)
5580 resume_clear_thread_private_info (thread);
5583 if (execution_direction == EXEC_REVERSE)
5585 /* We don't pass signals to the target in reverse exec mode. */
5586 if (info_verbose && siggnal != GDB_SIGNAL_0)
5587 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
5590 if (step && packet_support (PACKET_bs) == PACKET_DISABLE)
5591 error (_("Remote reverse-step not supported."));
5592 if (!step && packet_support (PACKET_bc) == PACKET_DISABLE)
5593 error (_("Remote reverse-continue not supported."));
5595 strcpy (buf, step ? "bs" : "bc");
5597 else if (siggnal != GDB_SIGNAL_0)
5599 buf[0] = step ? 'S' : 'C';
5600 buf[1] = tohex (((int) siggnal >> 4) & 0xf);
5601 buf[2] = tohex (((int) siggnal) & 0xf);
5605 strcpy (buf, step ? "s" : "c");
5610 /* We are about to start executing the inferior, let's register it
5611 with the event loop. NOTE: this is the one place where all the
5612 execution commands end up. We could alternatively do this in each
5613 of the execution commands in infcmd.c. */
5614 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
5615 into infcmd.c in order to allow inferior function calls to work
5616 NOT asynchronously. */
5617 if (target_can_async_p ())
5620 /* We've just told the target to resume. The remote server will
5621 wait for the inferior to stop, and then send a stop reply. In
5622 the mean time, we can't start another command/query ourselves
5623 because the stub wouldn't be ready to process it. This applies
5624 only to the base all-stop protocol, however. In non-stop (which
5625 only supports vCont), the stub replies with an "OK", and is
5626 immediate able to process further serial input. */
5627 if (!target_is_non_stop_p ())
5628 rs->waiting_for_stop_reply = 1;
5632 /* Set up the signal handler for SIGINT, while the target is
5633 executing, ovewriting the 'regular' SIGINT signal handler. */
5635 async_initialize_sigint_signal_handler (void)
5637 signal (SIGINT, async_handle_remote_sigint);
5640 /* Signal handler for SIGINT, while the target is executing. */
5642 async_handle_remote_sigint (int sig)
5644 signal (sig, async_handle_remote_sigint_twice);
5645 /* Note we need to go through gdb_call_async_signal_handler in order
5646 to wake up the event loop on Windows. */
5647 gdb_call_async_signal_handler (async_sigint_remote_token, 0);
5650 /* Signal handler for SIGINT, installed after SIGINT has already been
5651 sent once. It will take effect the second time that the user sends
5654 async_handle_remote_sigint_twice (int sig)
5656 signal (sig, async_handle_remote_sigint);
5657 /* See note in async_handle_remote_sigint. */
5658 gdb_call_async_signal_handler (async_sigint_remote_twice_token, 0);
5661 /* Implementation of to_check_pending_interrupt. */
5664 remote_check_pending_interrupt (struct target_ops *self)
5666 struct async_signal_handler *token = async_sigint_remote_twice_token;
5668 if (async_signal_handler_is_marked (token))
5670 clear_async_signal_handler (token);
5671 call_async_signal_handler (token);
5675 /* Perform the real interruption of the target execution, in response
5678 async_remote_interrupt (gdb_client_data arg)
5681 fprintf_unfiltered (gdb_stdlog, "async_remote_interrupt called\n");
5683 target_interrupt (inferior_ptid);
5686 /* Perform interrupt, if the first attempt did not succeed. Just give
5687 up on the target alltogether. */
5689 async_remote_interrupt_twice (gdb_client_data arg)
5692 fprintf_unfiltered (gdb_stdlog, "async_remote_interrupt_twice called\n");
5697 /* Reinstall the usual SIGINT handlers, after the target has
5700 async_cleanup_sigint_signal_handler (void *dummy)
5702 signal (SIGINT, handle_sigint);
5705 /* Send ^C to target to halt it. Target will respond, and send us a
5707 static void (*ofunc) (int);
5709 /* The command line interface's interrupt routine. This function is installed
5710 as a signal handler for SIGINT. The first time a user requests an
5711 interrupt, we call remote_interrupt to send a break or ^C. If there is no
5712 response from the target (it didn't stop when the user requested it),
5713 we ask the user if he'd like to detach from the target. */
5716 sync_remote_interrupt (int signo)
5718 /* If this doesn't work, try more severe steps. */
5719 signal (signo, sync_remote_interrupt_twice);
5721 gdb_call_async_signal_handler (async_sigint_remote_token, 1);
5724 /* The user typed ^C twice. */
5727 sync_remote_interrupt_twice (int signo)
5729 signal (signo, ofunc);
5730 gdb_call_async_signal_handler (async_sigint_remote_twice_token, 1);
5731 signal (signo, sync_remote_interrupt);
5734 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
5735 thread, all threads of a remote process, or all threads of all
5739 remote_stop_ns (ptid_t ptid)
5741 struct remote_state *rs = get_remote_state ();
5743 char *endp = rs->buf + get_remote_packet_size ();
5745 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
5746 remote_vcont_probe (rs);
5748 if (!rs->supports_vCont.t)
5749 error (_("Remote server does not support stopping threads"));
5751 if (ptid_equal (ptid, minus_one_ptid)
5752 || (!remote_multi_process_p (rs) && ptid_is_pid (ptid)))
5753 p += xsnprintf (p, endp - p, "vCont;t");
5758 p += xsnprintf (p, endp - p, "vCont;t:");
5760 if (ptid_is_pid (ptid))
5761 /* All (-1) threads of process. */
5762 nptid = ptid_build (ptid_get_pid (ptid), -1, 0);
5765 /* Small optimization: if we already have a stop reply for
5766 this thread, no use in telling the stub we want this
5768 if (peek_stop_reply (ptid))
5774 write_ptid (p, endp, nptid);
5777 /* In non-stop, we get an immediate OK reply. The stop reply will
5778 come in asynchronously by notification. */
5780 getpkt (&rs->buf, &rs->buf_size, 0);
5781 if (strcmp (rs->buf, "OK") != 0)
5782 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid), rs->buf);
5785 /* All-stop version of target_interrupt. Sends a break or a ^C to
5786 interrupt the remote target. It is undefined which thread of which
5787 process reports the interrupt. */
5790 remote_interrupt_as (void)
5792 struct remote_state *rs = get_remote_state ();
5794 rs->ctrlc_pending_p = 1;
5796 /* If the inferior is stopped already, but the core didn't know
5797 about it yet, just ignore the request. The cached wait status
5798 will be collected in remote_wait. */
5799 if (rs->cached_wait_status)
5802 /* Send interrupt_sequence to remote target. */
5803 send_interrupt_sequence ();
5806 /* Non-stop version of target_interrupt. Uses `vCtrlC' to interrupt
5807 the remote target. It is undefined which thread of which process
5808 reports the interrupt. Returns true if the packet is supported by
5809 the server, false otherwise. */
5812 remote_interrupt_ns (void)
5814 struct remote_state *rs = get_remote_state ();
5816 char *endp = rs->buf + get_remote_packet_size ();
5818 xsnprintf (p, endp - p, "vCtrlC");
5820 /* In non-stop, we get an immediate OK reply. The stop reply will
5821 come in asynchronously by notification. */
5823 getpkt (&rs->buf, &rs->buf_size, 0);
5825 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_vCtrlC]))
5829 case PACKET_UNKNOWN:
5832 error (_("Interrupting target failed: %s"), rs->buf);
5838 /* Implement the to_stop function for the remote targets. */
5841 remote_stop (struct target_ops *self, ptid_t ptid)
5844 fprintf_unfiltered (gdb_stdlog, "remote_stop called\n");
5846 if (target_is_non_stop_p ())
5847 remote_stop_ns (ptid);
5850 /* We don't currently have a way to transparently pause the
5851 remote target in all-stop mode. Interrupt it instead. */
5852 remote_interrupt_as ();
5856 /* Implement the to_interrupt function for the remote targets. */
5859 remote_interrupt (struct target_ops *self, ptid_t ptid)
5862 fprintf_unfiltered (gdb_stdlog, "remote_interrupt called\n");
5866 /* In non-stop mode, we always stop with no signal instead. */
5867 remote_stop_ns (ptid);
5871 /* In all-stop, we emulate ^C-ing the remote target's
5873 if (target_is_non_stop_p ())
5875 if (!remote_interrupt_ns ())
5877 /* No support for ^C-ing the remote target. Stop it
5878 (with no signal) instead. */
5879 remote_stop_ns (ptid);
5883 remote_interrupt_as ();
5887 /* Ask the user what to do when an interrupt is received. */
5890 interrupt_query (void)
5892 struct remote_state *rs = get_remote_state ();
5893 struct cleanup *old_chain;
5895 old_chain = make_cleanup_restore_target_terminal ();
5896 target_terminal_ours ();
5898 if (rs->waiting_for_stop_reply && rs->ctrlc_pending_p)
5900 if (query (_("The target is not responding to interrupt requests.\n"
5901 "Stop debugging it? ")))
5903 remote_unpush_target ();
5904 throw_error (TARGET_CLOSE_ERROR, _("Disconnected from target."));
5909 if (query (_("Interrupted while waiting for the program.\n"
5910 "Give up waiting? ")))
5914 do_cleanups (old_chain);
5917 /* Enable/disable target terminal ownership. Most targets can use
5918 terminal groups to control terminal ownership. Remote targets are
5919 different in that explicit transfer of ownership to/from GDB/target
5923 remote_terminal_inferior (struct target_ops *self)
5925 if (!target_async_permitted)
5926 /* Nothing to do. */
5929 /* FIXME: cagney/1999-09-27: Make calls to target_terminal_*()
5930 idempotent. The event-loop GDB talking to an asynchronous target
5931 with a synchronous command calls this function from both
5932 event-top.c and infrun.c/infcmd.c. Once GDB stops trying to
5933 transfer the terminal to the target when it shouldn't this guard
5935 if (!remote_async_terminal_ours_p)
5937 delete_file_handler (input_fd);
5938 remote_async_terminal_ours_p = 0;
5939 async_initialize_sigint_signal_handler ();
5940 /* NOTE: At this point we could also register our selves as the
5941 recipient of all input. Any characters typed could then be
5942 passed on down to the target. */
5946 remote_terminal_ours (struct target_ops *self)
5948 if (!target_async_permitted)
5949 /* Nothing to do. */
5952 /* See FIXME in remote_terminal_inferior. */
5953 if (remote_async_terminal_ours_p)
5955 async_cleanup_sigint_signal_handler (NULL);
5956 add_file_handler (input_fd, stdin_event_handler, 0);
5957 remote_async_terminal_ours_p = 1;
5961 remote_console_output (char *msg)
5965 for (p = msg; p[0] && p[1]; p += 2)
5968 char c = fromhex (p[0]) * 16 + fromhex (p[1]);
5972 fputs_unfiltered (tb, gdb_stdtarg);
5974 gdb_flush (gdb_stdtarg);
5977 typedef struct cached_reg
5980 gdb_byte data[MAX_REGISTER_SIZE];
5983 DEF_VEC_O(cached_reg_t);
5985 typedef struct stop_reply
5987 struct notif_event base;
5989 /* The identifier of the thread about this event */
5992 /* The remote state this event is associated with. When the remote
5993 connection, represented by a remote_state object, is closed,
5994 all the associated stop_reply events should be released. */
5995 struct remote_state *rs;
5997 struct target_waitstatus ws;
5999 /* Expedited registers. This makes remote debugging a bit more
6000 efficient for those targets that provide critical registers as
6001 part of their normal status mechanism (as another roundtrip to
6002 fetch them is avoided). */
6003 VEC(cached_reg_t) *regcache;
6005 enum target_stop_reason stop_reason;
6007 CORE_ADDR watch_data_address;
6012 DECLARE_QUEUE_P (stop_reply_p);
6013 DEFINE_QUEUE_P (stop_reply_p);
6014 /* The list of already fetched and acknowledged stop events. This
6015 queue is used for notification Stop, and other notifications
6016 don't need queue for their events, because the notification events
6017 of Stop can't be consumed immediately, so that events should be
6018 queued first, and be consumed by remote_wait_{ns,as} one per
6019 time. Other notifications can consume their events immediately,
6020 so queue is not needed for them. */
6021 static QUEUE (stop_reply_p) *stop_reply_queue;
6024 stop_reply_xfree (struct stop_reply *r)
6026 notif_event_xfree ((struct notif_event *) r);
6029 /* Return the length of the stop reply queue. */
6032 stop_reply_queue_length (void)
6034 return QUEUE_length (stop_reply_p, stop_reply_queue);
6038 remote_notif_stop_parse (struct notif_client *self, char *buf,
6039 struct notif_event *event)
6041 remote_parse_stop_reply (buf, (struct stop_reply *) event);
6045 remote_notif_stop_ack (struct notif_client *self, char *buf,
6046 struct notif_event *event)
6048 struct stop_reply *stop_reply = (struct stop_reply *) event;
6051 putpkt ((char *) self->ack_command);
6053 if (stop_reply->ws.kind == TARGET_WAITKIND_IGNORE)
6054 /* We got an unknown stop reply. */
6055 error (_("Unknown stop reply"));
6057 push_stop_reply (stop_reply);
6061 remote_notif_stop_can_get_pending_events (struct notif_client *self)
6063 /* We can't get pending events in remote_notif_process for
6064 notification stop, and we have to do this in remote_wait_ns
6065 instead. If we fetch all queued events from stub, remote stub
6066 may exit and we have no chance to process them back in
6068 mark_async_event_handler (remote_async_inferior_event_token);
6073 stop_reply_dtr (struct notif_event *event)
6075 struct stop_reply *r = (struct stop_reply *) event;
6077 VEC_free (cached_reg_t, r->regcache);
6080 static struct notif_event *
6081 remote_notif_stop_alloc_reply (void)
6083 /* We cast to a pointer to the "base class". */
6084 struct notif_event *r = (struct notif_event *) XNEW (struct stop_reply);
6086 r->dtr = stop_reply_dtr;
6091 /* A client of notification Stop. */
6093 struct notif_client notif_client_stop =
6097 remote_notif_stop_parse,
6098 remote_notif_stop_ack,
6099 remote_notif_stop_can_get_pending_events,
6100 remote_notif_stop_alloc_reply,
6104 /* A parameter to pass data in and out. */
6106 struct queue_iter_param
6109 struct stop_reply *output;
6112 /* Determine if THREAD is a pending fork parent thread. ARG contains
6113 the pid of the process that owns the threads we want to check, or
6114 -1 if we want to check all threads. */
6117 is_pending_fork_parent (struct target_waitstatus *ws, int event_pid,
6120 if (ws->kind == TARGET_WAITKIND_FORKED
6121 || ws->kind == TARGET_WAITKIND_VFORKED)
6123 if (event_pid == -1 || event_pid == ptid_get_pid (thread_ptid))
6130 /* Check whether EVENT is a fork event, and if it is, remove the
6131 fork child from the context list passed in DATA. */
6134 remove_child_of_pending_fork (QUEUE (stop_reply_p) *q,
6135 QUEUE_ITER (stop_reply_p) *iter,
6139 struct queue_iter_param *param = (struct queue_iter_param *) data;
6140 struct threads_listing_context *context
6141 = (struct threads_listing_context *) param->input;
6143 if (event->ws.kind == TARGET_WAITKIND_FORKED
6144 || event->ws.kind == TARGET_WAITKIND_VFORKED
6145 || event->ws.kind == TARGET_WAITKIND_THREAD_EXITED)
6146 threads_listing_context_remove (&event->ws, context);
6151 /* If CONTEXT contains any fork child threads that have not been
6152 reported yet, remove them from the CONTEXT list. If such a
6153 thread exists it is because we are stopped at a fork catchpoint
6154 and have not yet called follow_fork, which will set up the
6155 host-side data structures for the new process. */
6158 remove_new_fork_children (struct threads_listing_context *context)
6160 struct thread_info * thread;
6162 struct notif_client *notif = ¬if_client_stop;
6163 struct queue_iter_param param;
6165 /* For any threads stopped at a fork event, remove the corresponding
6166 fork child threads from the CONTEXT list. */
6167 ALL_NON_EXITED_THREADS (thread)
6169 struct target_waitstatus *ws = &thread->pending_follow;
6171 if (is_pending_fork_parent (ws, pid, thread->ptid))
6173 threads_listing_context_remove (ws, context);
6177 /* Check for any pending fork events (not reported or processed yet)
6178 in process PID and remove those fork child threads from the
6179 CONTEXT list as well. */
6180 remote_notif_get_pending_events (notif);
6181 param.input = context;
6182 param.output = NULL;
6183 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6184 remove_child_of_pending_fork, ¶m);
6187 /* Remove stop replies in the queue if its pid is equal to the given
6191 remove_stop_reply_for_inferior (QUEUE (stop_reply_p) *q,
6192 QUEUE_ITER (stop_reply_p) *iter,
6196 struct queue_iter_param *param = (struct queue_iter_param *) data;
6197 struct inferior *inf = (struct inferior *) param->input;
6199 if (ptid_get_pid (event->ptid) == inf->pid)
6201 stop_reply_xfree (event);
6202 QUEUE_remove_elem (stop_reply_p, q, iter);
6208 /* Discard all pending stop replies of inferior INF. */
6211 discard_pending_stop_replies (struct inferior *inf)
6213 struct queue_iter_param param;
6214 struct stop_reply *reply;
6215 struct remote_state *rs = get_remote_state ();
6216 struct remote_notif_state *rns = rs->notif_state;
6218 /* This function can be notified when an inferior exists. When the
6219 target is not remote, the notification state is NULL. */
6220 if (rs->remote_desc == NULL)
6223 reply = (struct stop_reply *) rns->pending_event[notif_client_stop.id];
6225 /* Discard the in-flight notification. */
6226 if (reply != NULL && ptid_get_pid (reply->ptid) == inf->pid)
6228 stop_reply_xfree (reply);
6229 rns->pending_event[notif_client_stop.id] = NULL;
6233 param.output = NULL;
6234 /* Discard the stop replies we have already pulled with
6236 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6237 remove_stop_reply_for_inferior, ¶m);
6240 /* If its remote state is equal to the given remote state,
6241 remove EVENT from the stop reply queue. */
6244 remove_stop_reply_of_remote_state (QUEUE (stop_reply_p) *q,
6245 QUEUE_ITER (stop_reply_p) *iter,
6249 struct queue_iter_param *param = (struct queue_iter_param *) data;
6250 struct remote_state *rs = (struct remote_state *) param->input;
6252 if (event->rs == rs)
6254 stop_reply_xfree (event);
6255 QUEUE_remove_elem (stop_reply_p, q, iter);
6261 /* Discard the stop replies for RS in stop_reply_queue. */
6264 discard_pending_stop_replies_in_queue (struct remote_state *rs)
6266 struct queue_iter_param param;
6269 param.output = NULL;
6270 /* Discard the stop replies we have already pulled with
6272 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6273 remove_stop_reply_of_remote_state, ¶m);
6276 /* A parameter to pass data in and out. */
6279 remote_notif_remove_once_on_match (QUEUE (stop_reply_p) *q,
6280 QUEUE_ITER (stop_reply_p) *iter,
6284 struct queue_iter_param *param = (struct queue_iter_param *) data;
6285 ptid_t *ptid = (ptid_t *) param->input;
6287 if (ptid_match (event->ptid, *ptid))
6289 param->output = event;
6290 QUEUE_remove_elem (stop_reply_p, q, iter);
6297 /* Remove the first reply in 'stop_reply_queue' which matches
6300 static struct stop_reply *
6301 remote_notif_remove_queued_reply (ptid_t ptid)
6303 struct queue_iter_param param;
6305 param.input = &ptid;
6306 param.output = NULL;
6308 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6309 remote_notif_remove_once_on_match, ¶m);
6311 fprintf_unfiltered (gdb_stdlog,
6312 "notif: discard queued event: 'Stop' in %s\n",
6313 target_pid_to_str (ptid));
6315 return param.output;
6318 /* Look for a queued stop reply belonging to PTID. If one is found,
6319 remove it from the queue, and return it. Returns NULL if none is
6320 found. If there are still queued events left to process, tell the
6321 event loop to get back to target_wait soon. */
6323 static struct stop_reply *
6324 queued_stop_reply (ptid_t ptid)
6326 struct stop_reply *r = remote_notif_remove_queued_reply (ptid);
6328 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
6329 /* There's still at least an event left. */
6330 mark_async_event_handler (remote_async_inferior_event_token);
6335 /* Push a fully parsed stop reply in the stop reply queue. Since we
6336 know that we now have at least one queued event left to pass to the
6337 core side, tell the event loop to get back to target_wait soon. */
6340 push_stop_reply (struct stop_reply *new_event)
6342 QUEUE_enque (stop_reply_p, stop_reply_queue, new_event);
6345 fprintf_unfiltered (gdb_stdlog,
6346 "notif: push 'Stop' %s to queue %d\n",
6347 target_pid_to_str (new_event->ptid),
6348 QUEUE_length (stop_reply_p,
6351 mark_async_event_handler (remote_async_inferior_event_token);
6355 stop_reply_match_ptid_and_ws (QUEUE (stop_reply_p) *q,
6356 QUEUE_ITER (stop_reply_p) *iter,
6357 struct stop_reply *event,
6360 ptid_t *ptid = (ptid_t *) data;
6362 return !(ptid_equal (*ptid, event->ptid)
6363 && event->ws.kind == TARGET_WAITKIND_STOPPED);
6366 /* Returns true if we have a stop reply for PTID. */
6369 peek_stop_reply (ptid_t ptid)
6371 return !QUEUE_iterate (stop_reply_p, stop_reply_queue,
6372 stop_reply_match_ptid_and_ws, &ptid);
6375 /* Helper for remote_parse_stop_reply. Return nonzero if the substring
6376 starting with P and ending with PEND matches PREFIX. */
6379 strprefix (const char *p, const char *pend, const char *prefix)
6381 for ( ; p < pend; p++, prefix++)
6384 return *prefix == '\0';
6387 /* Parse the stop reply in BUF. Either the function succeeds, and the
6388 result is stored in EVENT, or throws an error. */
6391 remote_parse_stop_reply (char *buf, struct stop_reply *event)
6393 struct remote_arch_state *rsa = get_remote_arch_state ();
6398 event->ptid = null_ptid;
6399 event->rs = get_remote_state ();
6400 event->ws.kind = TARGET_WAITKIND_IGNORE;
6401 event->ws.value.integer = 0;
6402 event->stop_reason = TARGET_STOPPED_BY_NO_REASON;
6403 event->regcache = NULL;
6408 case 'T': /* Status with PC, SP, FP, ... */
6409 /* Expedited reply, containing Signal, {regno, reg} repeat. */
6410 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
6412 n... = register number
6413 r... = register contents
6416 p = &buf[3]; /* after Txx */
6422 p1 = strchr (p, ':');
6424 error (_("Malformed packet(a) (missing colon): %s\n\
6428 error (_("Malformed packet(a) (missing register number): %s\n\
6432 /* Some "registers" are actually extended stop information.
6433 Note if you're adding a new entry here: GDB 7.9 and
6434 earlier assume that all register "numbers" that start
6435 with an hex digit are real register numbers. Make sure
6436 the server only sends such a packet if it knows the
6437 client understands it. */
6439 if (strprefix (p, p1, "thread"))
6440 event->ptid = read_ptid (++p1, &p);
6441 else if (strprefix (p, p1, "syscall_entry"))
6445 event->ws.kind = TARGET_WAITKIND_SYSCALL_ENTRY;
6446 p = unpack_varlen_hex (++p1, &sysno);
6447 event->ws.value.syscall_number = (int) sysno;
6449 else if (strprefix (p, p1, "syscall_return"))
6453 event->ws.kind = TARGET_WAITKIND_SYSCALL_RETURN;
6454 p = unpack_varlen_hex (++p1, &sysno);
6455 event->ws.value.syscall_number = (int) sysno;
6457 else if (strprefix (p, p1, "watch")
6458 || strprefix (p, p1, "rwatch")
6459 || strprefix (p, p1, "awatch"))
6461 event->stop_reason = TARGET_STOPPED_BY_WATCHPOINT;
6462 p = unpack_varlen_hex (++p1, &addr);
6463 event->watch_data_address = (CORE_ADDR) addr;
6465 else if (strprefix (p, p1, "swbreak"))
6467 event->stop_reason = TARGET_STOPPED_BY_SW_BREAKPOINT;
6469 /* Make sure the stub doesn't forget to indicate support
6471 if (packet_support (PACKET_swbreak_feature) != PACKET_ENABLE)
6472 error (_("Unexpected swbreak stop reason"));
6474 /* The value part is documented as "must be empty",
6475 though we ignore it, in case we ever decide to make
6476 use of it in a backward compatible way. */
6477 p = strchrnul (p1 + 1, ';');
6479 else if (strprefix (p, p1, "hwbreak"))
6481 event->stop_reason = TARGET_STOPPED_BY_HW_BREAKPOINT;
6483 /* Make sure the stub doesn't forget to indicate support
6485 if (packet_support (PACKET_hwbreak_feature) != PACKET_ENABLE)
6486 error (_("Unexpected hwbreak stop reason"));
6489 p = strchrnul (p1 + 1, ';');
6491 else if (strprefix (p, p1, "library"))
6493 event->ws.kind = TARGET_WAITKIND_LOADED;
6494 p = strchrnul (p1 + 1, ';');
6496 else if (strprefix (p, p1, "replaylog"))
6498 event->ws.kind = TARGET_WAITKIND_NO_HISTORY;
6499 /* p1 will indicate "begin" or "end", but it makes
6500 no difference for now, so ignore it. */
6501 p = strchrnul (p1 + 1, ';');
6503 else if (strprefix (p, p1, "core"))
6507 p = unpack_varlen_hex (++p1, &c);
6510 else if (strprefix (p, p1, "fork"))
6512 event->ws.value.related_pid = read_ptid (++p1, &p);
6513 event->ws.kind = TARGET_WAITKIND_FORKED;
6515 else if (strprefix (p, p1, "vfork"))
6517 event->ws.value.related_pid = read_ptid (++p1, &p);
6518 event->ws.kind = TARGET_WAITKIND_VFORKED;
6520 else if (strprefix (p, p1, "vforkdone"))
6522 event->ws.kind = TARGET_WAITKIND_VFORK_DONE;
6523 p = strchrnul (p1 + 1, ';');
6525 else if (strprefix (p, p1, "exec"))
6528 char pathname[PATH_MAX];
6531 /* Determine the length of the execd pathname. */
6532 p = unpack_varlen_hex (++p1, &ignored);
6533 pathlen = (p - p1) / 2;
6535 /* Save the pathname for event reporting and for
6536 the next run command. */
6537 hex2bin (p1, (gdb_byte *) pathname, pathlen);
6538 pathname[pathlen] = '\0';
6540 /* This is freed during event handling. */
6541 event->ws.value.execd_pathname = xstrdup (pathname);
6542 event->ws.kind = TARGET_WAITKIND_EXECD;
6544 /* Skip the registers included in this packet, since
6545 they may be for an architecture different from the
6546 one used by the original program. */
6549 else if (strprefix (p, p1, "create"))
6551 event->ws.kind = TARGET_WAITKIND_THREAD_CREATED;
6552 p = strchrnul (p1 + 1, ';');
6561 p = strchrnul (p1 + 1, ';');
6566 /* Maybe a real ``P'' register number. */
6567 p_temp = unpack_varlen_hex (p, &pnum);
6568 /* If the first invalid character is the colon, we got a
6569 register number. Otherwise, it's an unknown stop
6573 struct packet_reg *reg = packet_reg_from_pnum (rsa, pnum);
6574 cached_reg_t cached_reg;
6577 error (_("Remote sent bad register number %s: %s\n\
6579 hex_string (pnum), p, buf);
6581 cached_reg.num = reg->regnum;
6584 fieldsize = hex2bin (p, cached_reg.data,
6585 register_size (target_gdbarch (),
6588 if (fieldsize < register_size (target_gdbarch (),
6590 warning (_("Remote reply is too short: %s"), buf);
6592 VEC_safe_push (cached_reg_t, event->regcache, &cached_reg);
6596 /* Not a number. Silently skip unknown optional
6598 p = strchrnul (p1 + 1, ';');
6603 error (_("Remote register badly formatted: %s\nhere: %s"),
6608 if (event->ws.kind != TARGET_WAITKIND_IGNORE)
6612 case 'S': /* Old style status, just signal only. */
6616 event->ws.kind = TARGET_WAITKIND_STOPPED;
6617 sig = (fromhex (buf[1]) << 4) + fromhex (buf[2]);
6618 if (GDB_SIGNAL_FIRST <= sig && sig < GDB_SIGNAL_LAST)
6619 event->ws.value.sig = (enum gdb_signal) sig;
6621 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
6624 case 'w': /* Thread exited. */
6629 event->ws.kind = TARGET_WAITKIND_THREAD_EXITED;
6630 p = unpack_varlen_hex (&buf[1], &value);
6631 event->ws.value.integer = value;
6633 error (_("stop reply packet badly formatted: %s"), buf);
6634 event->ptid = read_ptid (++p, NULL);
6637 case 'W': /* Target exited. */
6644 /* GDB used to accept only 2 hex chars here. Stubs should
6645 only send more if they detect GDB supports multi-process
6647 p = unpack_varlen_hex (&buf[1], &value);
6651 /* The remote process exited. */
6652 event->ws.kind = TARGET_WAITKIND_EXITED;
6653 event->ws.value.integer = value;
6657 /* The remote process exited with a signal. */
6658 event->ws.kind = TARGET_WAITKIND_SIGNALLED;
6659 if (GDB_SIGNAL_FIRST <= value && value < GDB_SIGNAL_LAST)
6660 event->ws.value.sig = (enum gdb_signal) value;
6662 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
6665 /* If no process is specified, assume inferior_ptid. */
6666 pid = ptid_get_pid (inferior_ptid);
6675 else if (startswith (p, "process:"))
6679 p += sizeof ("process:") - 1;
6680 unpack_varlen_hex (p, &upid);
6684 error (_("unknown stop reply packet: %s"), buf);
6687 error (_("unknown stop reply packet: %s"), buf);
6688 event->ptid = pid_to_ptid (pid);
6692 event->ws.kind = TARGET_WAITKIND_NO_RESUMED;
6693 event->ptid = minus_one_ptid;
6697 if (target_is_non_stop_p () && ptid_equal (event->ptid, null_ptid))
6698 error (_("No process or thread specified in stop reply: %s"), buf);
6701 /* When the stub wants to tell GDB about a new notification reply, it
6702 sends a notification (%Stop, for example). Those can come it at
6703 any time, hence, we have to make sure that any pending
6704 putpkt/getpkt sequence we're making is finished, before querying
6705 the stub for more events with the corresponding ack command
6706 (vStopped, for example). E.g., if we started a vStopped sequence
6707 immediately upon receiving the notification, something like this
6715 1.6) <-- (registers reply to step #1.3)
6717 Obviously, the reply in step #1.6 would be unexpected to a vStopped
6720 To solve this, whenever we parse a %Stop notification successfully,
6721 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
6722 doing whatever we were doing:
6728 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
6729 2.5) <-- (registers reply to step #2.3)
6731 Eventualy after step #2.5, we return to the event loop, which
6732 notices there's an event on the
6733 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
6734 associated callback --- the function below. At this point, we're
6735 always safe to start a vStopped sequence. :
6738 2.7) <-- T05 thread:2
6744 remote_notif_get_pending_events (struct notif_client *nc)
6746 struct remote_state *rs = get_remote_state ();
6748 if (rs->notif_state->pending_event[nc->id] != NULL)
6751 fprintf_unfiltered (gdb_stdlog,
6752 "notif: process: '%s' ack pending event\n",
6756 nc->ack (nc, rs->buf, rs->notif_state->pending_event[nc->id]);
6757 rs->notif_state->pending_event[nc->id] = NULL;
6761 getpkt (&rs->buf, &rs->buf_size, 0);
6762 if (strcmp (rs->buf, "OK") == 0)
6765 remote_notif_ack (nc, rs->buf);
6771 fprintf_unfiltered (gdb_stdlog,
6772 "notif: process: '%s' no pending reply\n",
6777 /* Called when it is decided that STOP_REPLY holds the info of the
6778 event that is to be returned to the core. This function always
6779 destroys STOP_REPLY. */
6782 process_stop_reply (struct stop_reply *stop_reply,
6783 struct target_waitstatus *status)
6787 *status = stop_reply->ws;
6788 ptid = stop_reply->ptid;
6790 /* If no thread/process was reported by the stub, assume the current
6792 if (ptid_equal (ptid, null_ptid))
6793 ptid = inferior_ptid;
6795 if (status->kind != TARGET_WAITKIND_EXITED
6796 && status->kind != TARGET_WAITKIND_SIGNALLED
6797 && status->kind != TARGET_WAITKIND_NO_RESUMED)
6799 struct private_thread_info *remote_thr;
6801 /* Expedited registers. */
6802 if (stop_reply->regcache)
6804 struct regcache *regcache
6805 = get_thread_arch_regcache (ptid, target_gdbarch ());
6810 VEC_iterate(cached_reg_t, stop_reply->regcache, ix, reg);
6812 regcache_raw_supply (regcache, reg->num, reg->data);
6813 VEC_free (cached_reg_t, stop_reply->regcache);
6816 remote_notice_new_inferior (ptid, 0);
6817 remote_thr = demand_private_info (ptid);
6818 remote_thr->core = stop_reply->core;
6819 remote_thr->stop_reason = stop_reply->stop_reason;
6820 remote_thr->watch_data_address = stop_reply->watch_data_address;
6823 stop_reply_xfree (stop_reply);
6827 /* The non-stop mode version of target_wait. */
6830 remote_wait_ns (ptid_t ptid, struct target_waitstatus *status, int options)
6832 struct remote_state *rs = get_remote_state ();
6833 struct stop_reply *stop_reply;
6837 /* If in non-stop mode, get out of getpkt even if a
6838 notification is received. */
6840 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
6841 0 /* forever */, &is_notif);
6844 if (ret != -1 && !is_notif)
6847 case 'E': /* Error of some sort. */
6848 /* We're out of sync with the target now. Did it continue
6849 or not? We can't tell which thread it was in non-stop,
6850 so just ignore this. */
6851 warning (_("Remote failure reply: %s"), rs->buf);
6853 case 'O': /* Console output. */
6854 remote_console_output (rs->buf + 1);
6857 warning (_("Invalid remote reply: %s"), rs->buf);
6861 /* Acknowledge a pending stop reply that may have arrived in the
6863 if (rs->notif_state->pending_event[notif_client_stop.id] != NULL)
6864 remote_notif_get_pending_events (¬if_client_stop);
6866 /* If indeed we noticed a stop reply, we're done. */
6867 stop_reply = queued_stop_reply (ptid);
6868 if (stop_reply != NULL)
6869 return process_stop_reply (stop_reply, status);
6871 /* Still no event. If we're just polling for an event, then
6872 return to the event loop. */
6873 if (options & TARGET_WNOHANG)
6875 status->kind = TARGET_WAITKIND_IGNORE;
6876 return minus_one_ptid;
6879 /* Otherwise do a blocking wait. */
6880 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
6881 1 /* forever */, &is_notif);
6885 /* Wait until the remote machine stops, then return, storing status in
6886 STATUS just as `wait' would. */
6889 remote_wait_as (ptid_t ptid, struct target_waitstatus *status, int options)
6891 struct remote_state *rs = get_remote_state ();
6892 ptid_t event_ptid = null_ptid;
6894 struct stop_reply *stop_reply;
6898 status->kind = TARGET_WAITKIND_IGNORE;
6899 status->value.integer = 0;
6901 stop_reply = queued_stop_reply (ptid);
6902 if (stop_reply != NULL)
6903 return process_stop_reply (stop_reply, status);
6905 if (rs->cached_wait_status)
6906 /* Use the cached wait status, but only once. */
6907 rs->cached_wait_status = 0;
6912 int forever = ((options & TARGET_WNOHANG) == 0
6913 && wait_forever_enabled_p);
6915 if (!rs->waiting_for_stop_reply)
6917 status->kind = TARGET_WAITKIND_NO_RESUMED;
6918 return minus_one_ptid;
6921 if (!target_is_async_p ())
6923 ofunc = signal (SIGINT, sync_remote_interrupt);
6924 /* If the user hit C-c before this packet, or between packets,
6925 pretend that it was hit right here. */
6926 if (check_quit_flag ())
6929 sync_remote_interrupt (SIGINT);
6933 /* FIXME: cagney/1999-09-27: If we're in async mode we should
6934 _never_ wait for ever -> test on target_is_async_p().
6935 However, before we do that we need to ensure that the caller
6936 knows how to take the target into/out of async mode. */
6937 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
6938 forever, &is_notif);
6940 if (!target_is_async_p ())
6941 signal (SIGINT, ofunc);
6943 /* GDB gets a notification. Return to core as this event is
6945 if (ret != -1 && is_notif)
6946 return minus_one_ptid;
6948 if (ret == -1 && (options & TARGET_WNOHANG) != 0)
6949 return minus_one_ptid;
6954 /* Assume that the target has acknowledged Ctrl-C unless we receive
6955 an 'F' or 'O' packet. */
6956 if (buf[0] != 'F' && buf[0] != 'O')
6957 rs->ctrlc_pending_p = 0;
6961 case 'E': /* Error of some sort. */
6962 /* We're out of sync with the target now. Did it continue or
6963 not? Not is more likely, so report a stop. */
6964 rs->waiting_for_stop_reply = 0;
6966 warning (_("Remote failure reply: %s"), buf);
6967 status->kind = TARGET_WAITKIND_STOPPED;
6968 status->value.sig = GDB_SIGNAL_0;
6970 case 'F': /* File-I/O request. */
6971 /* GDB may access the inferior memory while handling the File-I/O
6972 request, but we don't want GDB accessing memory while waiting
6973 for a stop reply. See the comments in putpkt_binary. Set
6974 waiting_for_stop_reply to 0 temporarily. */
6975 rs->waiting_for_stop_reply = 0;
6976 remote_fileio_request (buf, rs->ctrlc_pending_p);
6977 rs->ctrlc_pending_p = 0;
6978 /* GDB handled the File-I/O request, and the target is running
6979 again. Keep waiting for events. */
6980 rs->waiting_for_stop_reply = 1;
6982 case 'N': case 'T': case 'S': case 'X': case 'W':
6984 struct stop_reply *stop_reply;
6986 /* There is a stop reply to handle. */
6987 rs->waiting_for_stop_reply = 0;
6990 = (struct stop_reply *) remote_notif_parse (¬if_client_stop,
6993 event_ptid = process_stop_reply (stop_reply, status);
6996 case 'O': /* Console output. */
6997 remote_console_output (buf + 1);
7000 if (rs->last_sent_signal != GDB_SIGNAL_0)
7002 /* Zero length reply means that we tried 'S' or 'C' and the
7003 remote system doesn't support it. */
7004 target_terminal_ours_for_output ();
7006 ("Can't send signals to this remote system. %s not sent.\n",
7007 gdb_signal_to_name (rs->last_sent_signal));
7008 rs->last_sent_signal = GDB_SIGNAL_0;
7009 target_terminal_inferior ();
7011 strcpy ((char *) buf, rs->last_sent_step ? "s" : "c");
7012 putpkt ((char *) buf);
7015 /* else fallthrough */
7017 warning (_("Invalid remote reply: %s"), buf);
7021 if (status->kind == TARGET_WAITKIND_NO_RESUMED)
7022 return minus_one_ptid;
7023 else if (status->kind == TARGET_WAITKIND_IGNORE)
7025 /* Nothing interesting happened. If we're doing a non-blocking
7026 poll, we're done. Otherwise, go back to waiting. */
7027 if (options & TARGET_WNOHANG)
7028 return minus_one_ptid;
7032 else if (status->kind != TARGET_WAITKIND_EXITED
7033 && status->kind != TARGET_WAITKIND_SIGNALLED)
7035 if (!ptid_equal (event_ptid, null_ptid))
7036 record_currthread (rs, event_ptid);
7038 event_ptid = inferior_ptid;
7041 /* A process exit. Invalidate our notion of current thread. */
7042 record_currthread (rs, minus_one_ptid);
7047 /* Wait until the remote machine stops, then return, storing status in
7048 STATUS just as `wait' would. */
7051 remote_wait (struct target_ops *ops,
7052 ptid_t ptid, struct target_waitstatus *status, int options)
7056 if (target_is_non_stop_p ())
7057 event_ptid = remote_wait_ns (ptid, status, options);
7059 event_ptid = remote_wait_as (ptid, status, options);
7061 if (target_is_async_p ())
7063 /* If there are are events left in the queue tell the event loop
7065 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
7066 mark_async_event_handler (remote_async_inferior_event_token);
7072 /* Fetch a single register using a 'p' packet. */
7075 fetch_register_using_p (struct regcache *regcache, struct packet_reg *reg)
7077 struct remote_state *rs = get_remote_state ();
7079 char regp[MAX_REGISTER_SIZE];
7082 if (packet_support (PACKET_p) == PACKET_DISABLE)
7085 if (reg->pnum == -1)
7090 p += hexnumstr (p, reg->pnum);
7093 getpkt (&rs->buf, &rs->buf_size, 0);
7097 switch (packet_ok (buf, &remote_protocol_packets[PACKET_p]))
7101 case PACKET_UNKNOWN:
7104 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
7105 gdbarch_register_name (get_regcache_arch (regcache),
7110 /* If this register is unfetchable, tell the regcache. */
7113 regcache_raw_supply (regcache, reg->regnum, NULL);
7117 /* Otherwise, parse and supply the value. */
7123 error (_("fetch_register_using_p: early buf termination"));
7125 regp[i++] = fromhex (p[0]) * 16 + fromhex (p[1]);
7128 regcache_raw_supply (regcache, reg->regnum, regp);
7132 /* Fetch the registers included in the target's 'g' packet. */
7135 send_g_packet (void)
7137 struct remote_state *rs = get_remote_state ();
7140 xsnprintf (rs->buf, get_remote_packet_size (), "g");
7141 remote_send (&rs->buf, &rs->buf_size);
7143 /* We can get out of synch in various cases. If the first character
7144 in the buffer is not a hex character, assume that has happened
7145 and try to fetch another packet to read. */
7146 while ((rs->buf[0] < '0' || rs->buf[0] > '9')
7147 && (rs->buf[0] < 'A' || rs->buf[0] > 'F')
7148 && (rs->buf[0] < 'a' || rs->buf[0] > 'f')
7149 && rs->buf[0] != 'x') /* New: unavailable register value. */
7152 fprintf_unfiltered (gdb_stdlog,
7153 "Bad register packet; fetching a new packet\n");
7154 getpkt (&rs->buf, &rs->buf_size, 0);
7157 buf_len = strlen (rs->buf);
7159 /* Sanity check the received packet. */
7160 if (buf_len % 2 != 0)
7161 error (_("Remote 'g' packet reply is of odd length: %s"), rs->buf);
7167 process_g_packet (struct regcache *regcache)
7169 struct gdbarch *gdbarch = get_regcache_arch (regcache);
7170 struct remote_state *rs = get_remote_state ();
7171 struct remote_arch_state *rsa = get_remote_arch_state ();
7176 buf_len = strlen (rs->buf);
7178 /* Further sanity checks, with knowledge of the architecture. */
7179 if (buf_len > 2 * rsa->sizeof_g_packet)
7180 error (_("Remote 'g' packet reply is too long: %s"), rs->buf);
7182 /* Save the size of the packet sent to us by the target. It is used
7183 as a heuristic when determining the max size of packets that the
7184 target can safely receive. */
7185 if (rsa->actual_register_packet_size == 0)
7186 rsa->actual_register_packet_size = buf_len;
7188 /* If this is smaller than we guessed the 'g' packet would be,
7189 update our records. A 'g' reply that doesn't include a register's
7190 value implies either that the register is not available, or that
7191 the 'p' packet must be used. */
7192 if (buf_len < 2 * rsa->sizeof_g_packet)
7194 rsa->sizeof_g_packet = buf_len / 2;
7196 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
7198 if (rsa->regs[i].pnum == -1)
7201 if (rsa->regs[i].offset >= rsa->sizeof_g_packet)
7202 rsa->regs[i].in_g_packet = 0;
7204 rsa->regs[i].in_g_packet = 1;
7208 regs = (char *) alloca (rsa->sizeof_g_packet);
7210 /* Unimplemented registers read as all bits zero. */
7211 memset (regs, 0, rsa->sizeof_g_packet);
7213 /* Reply describes registers byte by byte, each byte encoded as two
7214 hex characters. Suck them all up, then supply them to the
7215 register cacheing/storage mechanism. */
7218 for (i = 0; i < rsa->sizeof_g_packet; i++)
7220 if (p[0] == 0 || p[1] == 0)
7221 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
7222 internal_error (__FILE__, __LINE__,
7223 _("unexpected end of 'g' packet reply"));
7225 if (p[0] == 'x' && p[1] == 'x')
7226 regs[i] = 0; /* 'x' */
7228 regs[i] = fromhex (p[0]) * 16 + fromhex (p[1]);
7232 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
7234 struct packet_reg *r = &rsa->regs[i];
7238 if (r->offset * 2 >= strlen (rs->buf))
7239 /* This shouldn't happen - we adjusted in_g_packet above. */
7240 internal_error (__FILE__, __LINE__,
7241 _("unexpected end of 'g' packet reply"));
7242 else if (rs->buf[r->offset * 2] == 'x')
7244 gdb_assert (r->offset * 2 < strlen (rs->buf));
7245 /* The register isn't available, mark it as such (at
7246 the same time setting the value to zero). */
7247 regcache_raw_supply (regcache, r->regnum, NULL);
7250 regcache_raw_supply (regcache, r->regnum,
7257 fetch_registers_using_g (struct regcache *regcache)
7260 process_g_packet (regcache);
7263 /* Make the remote selected traceframe match GDB's selected
7267 set_remote_traceframe (void)
7270 struct remote_state *rs = get_remote_state ();
7272 if (rs->remote_traceframe_number == get_traceframe_number ())
7275 /* Avoid recursion, remote_trace_find calls us again. */
7276 rs->remote_traceframe_number = get_traceframe_number ();
7278 newnum = target_trace_find (tfind_number,
7279 get_traceframe_number (), 0, 0, NULL);
7281 /* Should not happen. If it does, all bets are off. */
7282 if (newnum != get_traceframe_number ())
7283 warning (_("could not set remote traceframe"));
7287 remote_fetch_registers (struct target_ops *ops,
7288 struct regcache *regcache, int regnum)
7290 struct remote_arch_state *rsa = get_remote_arch_state ();
7293 set_remote_traceframe ();
7294 set_general_thread (inferior_ptid);
7298 struct packet_reg *reg = packet_reg_from_regnum (rsa, regnum);
7300 gdb_assert (reg != NULL);
7302 /* If this register might be in the 'g' packet, try that first -
7303 we are likely to read more than one register. If this is the
7304 first 'g' packet, we might be overly optimistic about its
7305 contents, so fall back to 'p'. */
7306 if (reg->in_g_packet)
7308 fetch_registers_using_g (regcache);
7309 if (reg->in_g_packet)
7313 if (fetch_register_using_p (regcache, reg))
7316 /* This register is not available. */
7317 regcache_raw_supply (regcache, reg->regnum, NULL);
7322 fetch_registers_using_g (regcache);
7324 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
7325 if (!rsa->regs[i].in_g_packet)
7326 if (!fetch_register_using_p (regcache, &rsa->regs[i]))
7328 /* This register is not available. */
7329 regcache_raw_supply (regcache, i, NULL);
7333 /* Prepare to store registers. Since we may send them all (using a
7334 'G' request), we have to read out the ones we don't want to change
7338 remote_prepare_to_store (struct target_ops *self, struct regcache *regcache)
7340 struct remote_arch_state *rsa = get_remote_arch_state ();
7342 gdb_byte buf[MAX_REGISTER_SIZE];
7344 /* Make sure the entire registers array is valid. */
7345 switch (packet_support (PACKET_P))
7347 case PACKET_DISABLE:
7348 case PACKET_SUPPORT_UNKNOWN:
7349 /* Make sure all the necessary registers are cached. */
7350 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
7351 if (rsa->regs[i].in_g_packet)
7352 regcache_raw_read (regcache, rsa->regs[i].regnum, buf);
7359 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
7360 packet was not recognized. */
7363 store_register_using_P (const struct regcache *regcache,
7364 struct packet_reg *reg)
7366 struct gdbarch *gdbarch = get_regcache_arch (regcache);
7367 struct remote_state *rs = get_remote_state ();
7368 /* Try storing a single register. */
7369 char *buf = rs->buf;
7370 gdb_byte regp[MAX_REGISTER_SIZE];
7373 if (packet_support (PACKET_P) == PACKET_DISABLE)
7376 if (reg->pnum == -1)
7379 xsnprintf (buf, get_remote_packet_size (), "P%s=", phex_nz (reg->pnum, 0));
7380 p = buf + strlen (buf);
7381 regcache_raw_collect (regcache, reg->regnum, regp);
7382 bin2hex (regp, p, register_size (gdbarch, reg->regnum));
7384 getpkt (&rs->buf, &rs->buf_size, 0);
7386 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_P]))
7391 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
7392 gdbarch_register_name (gdbarch, reg->regnum), rs->buf);
7393 case PACKET_UNKNOWN:
7396 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
7400 /* Store register REGNUM, or all registers if REGNUM == -1, from the
7401 contents of the register cache buffer. FIXME: ignores errors. */
7404 store_registers_using_G (const struct regcache *regcache)
7406 struct remote_state *rs = get_remote_state ();
7407 struct remote_arch_state *rsa = get_remote_arch_state ();
7411 /* Extract all the registers in the regcache copying them into a
7416 regs = (gdb_byte *) alloca (rsa->sizeof_g_packet);
7417 memset (regs, 0, rsa->sizeof_g_packet);
7418 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
7420 struct packet_reg *r = &rsa->regs[i];
7423 regcache_raw_collect (regcache, r->regnum, regs + r->offset);
7427 /* Command describes registers byte by byte,
7428 each byte encoded as two hex characters. */
7431 /* remote_prepare_to_store insures that rsa->sizeof_g_packet gets
7433 bin2hex (regs, p, rsa->sizeof_g_packet);
7435 getpkt (&rs->buf, &rs->buf_size, 0);
7436 if (packet_check_result (rs->buf) == PACKET_ERROR)
7437 error (_("Could not write registers; remote failure reply '%s'"),
7441 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
7442 of the register cache buffer. FIXME: ignores errors. */
7445 remote_store_registers (struct target_ops *ops,
7446 struct regcache *regcache, int regnum)
7448 struct remote_arch_state *rsa = get_remote_arch_state ();
7451 set_remote_traceframe ();
7452 set_general_thread (inferior_ptid);
7456 struct packet_reg *reg = packet_reg_from_regnum (rsa, regnum);
7458 gdb_assert (reg != NULL);
7460 /* Always prefer to store registers using the 'P' packet if
7461 possible; we often change only a small number of registers.
7462 Sometimes we change a larger number; we'd need help from a
7463 higher layer to know to use 'G'. */
7464 if (store_register_using_P (regcache, reg))
7467 /* For now, don't complain if we have no way to write the
7468 register. GDB loses track of unavailable registers too
7469 easily. Some day, this may be an error. We don't have
7470 any way to read the register, either... */
7471 if (!reg->in_g_packet)
7474 store_registers_using_G (regcache);
7478 store_registers_using_G (regcache);
7480 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
7481 if (!rsa->regs[i].in_g_packet)
7482 if (!store_register_using_P (regcache, &rsa->regs[i]))
7483 /* See above for why we do not issue an error here. */
7488 /* Return the number of hex digits in num. */
7491 hexnumlen (ULONGEST num)
7495 for (i = 0; num != 0; i++)
7501 /* Set BUF to the minimum number of hex digits representing NUM. */
7504 hexnumstr (char *buf, ULONGEST num)
7506 int len = hexnumlen (num);
7508 return hexnumnstr (buf, num, len);
7512 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
7515 hexnumnstr (char *buf, ULONGEST num, int width)
7521 for (i = width - 1; i >= 0; i--)
7523 buf[i] = "0123456789abcdef"[(num & 0xf)];
7530 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
7533 remote_address_masked (CORE_ADDR addr)
7535 unsigned int address_size = remote_address_size;
7537 /* If "remoteaddresssize" was not set, default to target address size. */
7539 address_size = gdbarch_addr_bit (target_gdbarch ());
7541 if (address_size > 0
7542 && address_size < (sizeof (ULONGEST) * 8))
7544 /* Only create a mask when that mask can safely be constructed
7545 in a ULONGEST variable. */
7548 mask = (mask << address_size) - 1;
7554 /* Determine whether the remote target supports binary downloading.
7555 This is accomplished by sending a no-op memory write of zero length
7556 to the target at the specified address. It does not suffice to send
7557 the whole packet, since many stubs strip the eighth bit and
7558 subsequently compute a wrong checksum, which causes real havoc with
7561 NOTE: This can still lose if the serial line is not eight-bit
7562 clean. In cases like this, the user should clear "remote
7566 check_binary_download (CORE_ADDR addr)
7568 struct remote_state *rs = get_remote_state ();
7570 switch (packet_support (PACKET_X))
7572 case PACKET_DISABLE:
7576 case PACKET_SUPPORT_UNKNOWN:
7582 p += hexnumstr (p, (ULONGEST) addr);
7584 p += hexnumstr (p, (ULONGEST) 0);
7588 putpkt_binary (rs->buf, (int) (p - rs->buf));
7589 getpkt (&rs->buf, &rs->buf_size, 0);
7591 if (rs->buf[0] == '\0')
7594 fprintf_unfiltered (gdb_stdlog,
7595 "binary downloading NOT "
7596 "supported by target\n");
7597 remote_protocol_packets[PACKET_X].support = PACKET_DISABLE;
7602 fprintf_unfiltered (gdb_stdlog,
7603 "binary downloading supported by target\n");
7604 remote_protocol_packets[PACKET_X].support = PACKET_ENABLE;
7611 /* Helper function to resize the payload in order to try to get a good
7612 alignment. We try to write an amount of data such that the next write will
7613 start on an address aligned on REMOTE_ALIGN_WRITES. */
7616 align_for_efficient_write (int todo, CORE_ADDR memaddr)
7618 return ((memaddr + todo) & ~(REMOTE_ALIGN_WRITES - 1)) - memaddr;
7621 /* Write memory data directly to the remote machine.
7622 This does not inform the data cache; the data cache uses this.
7623 HEADER is the starting part of the packet.
7624 MEMADDR is the address in the remote memory space.
7625 MYADDR is the address of the buffer in our space.
7626 LEN_UNITS is the number of addressable units to write.
7627 UNIT_SIZE is the length in bytes of an addressable unit.
7628 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
7629 should send data as binary ('X'), or hex-encoded ('M').
7631 The function creates packet of the form
7632 <HEADER><ADDRESS>,<LENGTH>:<DATA>
7634 where encoding of <DATA> is terminated by PACKET_FORMAT.
7636 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
7639 Return the transferred status, error or OK (an
7640 'enum target_xfer_status' value). Save the number of addressable units
7641 transferred in *XFERED_LEN_UNITS. Only transfer a single packet.
7643 On a platform with an addressable memory size of 2 bytes (UNIT_SIZE == 2), an
7644 exchange between gdb and the stub could look like (?? in place of the
7650 -> $M1000,3:eeeeffffeeee#??
7654 <- eeeeffffeeeedddd */
7656 static enum target_xfer_status
7657 remote_write_bytes_aux (const char *header, CORE_ADDR memaddr,
7658 const gdb_byte *myaddr, ULONGEST len_units,
7659 int unit_size, ULONGEST *xfered_len_units,
7660 char packet_format, int use_length)
7662 struct remote_state *rs = get_remote_state ();
7668 int payload_capacity_bytes;
7669 int payload_length_bytes;
7671 if (packet_format != 'X' && packet_format != 'M')
7672 internal_error (__FILE__, __LINE__,
7673 _("remote_write_bytes_aux: bad packet format"));
7676 return TARGET_XFER_EOF;
7678 payload_capacity_bytes = get_memory_write_packet_size ();
7680 /* The packet buffer will be large enough for the payload;
7681 get_memory_packet_size ensures this. */
7684 /* Compute the size of the actual payload by subtracting out the
7685 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
7687 payload_capacity_bytes -= strlen ("$,:#NN");
7689 /* The comma won't be used. */
7690 payload_capacity_bytes += 1;
7691 payload_capacity_bytes -= strlen (header);
7692 payload_capacity_bytes -= hexnumlen (memaddr);
7694 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
7696 strcat (rs->buf, header);
7697 p = rs->buf + strlen (header);
7699 /* Compute a best guess of the number of bytes actually transfered. */
7700 if (packet_format == 'X')
7702 /* Best guess at number of bytes that will fit. */
7703 todo_units = min (len_units, payload_capacity_bytes / unit_size);
7705 payload_capacity_bytes -= hexnumlen (todo_units);
7706 todo_units = min (todo_units, payload_capacity_bytes / unit_size);
7710 /* Number of bytes that will fit. */
7711 todo_units = min (len_units, (payload_capacity_bytes / unit_size) / 2);
7713 payload_capacity_bytes -= hexnumlen (todo_units);
7714 todo_units = min (todo_units, (payload_capacity_bytes / unit_size) / 2);
7717 if (todo_units <= 0)
7718 internal_error (__FILE__, __LINE__,
7719 _("minimum packet size too small to write data"));
7721 /* If we already need another packet, then try to align the end
7722 of this packet to a useful boundary. */
7723 if (todo_units > 2 * REMOTE_ALIGN_WRITES && todo_units < len_units)
7724 todo_units = align_for_efficient_write (todo_units, memaddr);
7726 /* Append "<memaddr>". */
7727 memaddr = remote_address_masked (memaddr);
7728 p += hexnumstr (p, (ULONGEST) memaddr);
7735 /* Append the length and retain its location and size. It may need to be
7736 adjusted once the packet body has been created. */
7738 plenlen = hexnumstr (p, (ULONGEST) todo_units);
7746 /* Append the packet body. */
7747 if (packet_format == 'X')
7749 /* Binary mode. Send target system values byte by byte, in
7750 increasing byte addresses. Only escape certain critical
7752 payload_length_bytes =
7753 remote_escape_output (myaddr, todo_units, unit_size, (gdb_byte *) p,
7754 &units_written, payload_capacity_bytes);
7756 /* If not all TODO units fit, then we'll need another packet. Make
7757 a second try to keep the end of the packet aligned. Don't do
7758 this if the packet is tiny. */
7759 if (units_written < todo_units && units_written > 2 * REMOTE_ALIGN_WRITES)
7763 new_todo_units = align_for_efficient_write (units_written, memaddr);
7765 if (new_todo_units != units_written)
7766 payload_length_bytes =
7767 remote_escape_output (myaddr, new_todo_units, unit_size,
7768 (gdb_byte *) p, &units_written,
7769 payload_capacity_bytes);
7772 p += payload_length_bytes;
7773 if (use_length && units_written < todo_units)
7775 /* Escape chars have filled up the buffer prematurely,
7776 and we have actually sent fewer units than planned.
7777 Fix-up the length field of the packet. Use the same
7778 number of characters as before. */
7779 plen += hexnumnstr (plen, (ULONGEST) units_written,
7781 *plen = ':'; /* overwrite \0 from hexnumnstr() */
7786 /* Normal mode: Send target system values byte by byte, in
7787 increasing byte addresses. Each byte is encoded as a two hex
7789 p += 2 * bin2hex (myaddr, p, todo_units * unit_size);
7790 units_written = todo_units;
7793 putpkt_binary (rs->buf, (int) (p - rs->buf));
7794 getpkt (&rs->buf, &rs->buf_size, 0);
7796 if (rs->buf[0] == 'E')
7797 return TARGET_XFER_E_IO;
7799 /* Return UNITS_WRITTEN, not TODO_UNITS, in case escape chars caused us to
7800 send fewer units than we'd planned. */
7801 *xfered_len_units = (ULONGEST) units_written;
7802 return TARGET_XFER_OK;
7805 /* Write memory data directly to the remote machine.
7806 This does not inform the data cache; the data cache uses this.
7807 MEMADDR is the address in the remote memory space.
7808 MYADDR is the address of the buffer in our space.
7809 LEN is the number of bytes.
7811 Return the transferred status, error or OK (an
7812 'enum target_xfer_status' value). Save the number of bytes
7813 transferred in *XFERED_LEN. Only transfer a single packet. */
7815 static enum target_xfer_status
7816 remote_write_bytes (CORE_ADDR memaddr, const gdb_byte *myaddr, ULONGEST len,
7817 int unit_size, ULONGEST *xfered_len)
7819 char *packet_format = 0;
7821 /* Check whether the target supports binary download. */
7822 check_binary_download (memaddr);
7824 switch (packet_support (PACKET_X))
7827 packet_format = "X";
7829 case PACKET_DISABLE:
7830 packet_format = "M";
7832 case PACKET_SUPPORT_UNKNOWN:
7833 internal_error (__FILE__, __LINE__,
7834 _("remote_write_bytes: bad internal state"));
7836 internal_error (__FILE__, __LINE__, _("bad switch"));
7839 return remote_write_bytes_aux (packet_format,
7840 memaddr, myaddr, len, unit_size, xfered_len,
7841 packet_format[0], 1);
7844 /* Read memory data directly from the remote machine.
7845 This does not use the data cache; the data cache uses this.
7846 MEMADDR is the address in the remote memory space.
7847 MYADDR is the address of the buffer in our space.
7848 LEN_UNITS is the number of addressable memory units to read..
7849 UNIT_SIZE is the length in bytes of an addressable unit.
7851 Return the transferred status, error or OK (an
7852 'enum target_xfer_status' value). Save the number of bytes
7853 transferred in *XFERED_LEN_UNITS.
7855 See the comment of remote_write_bytes_aux for an example of
7856 memory read/write exchange between gdb and the stub. */
7858 static enum target_xfer_status
7859 remote_read_bytes_1 (CORE_ADDR memaddr, gdb_byte *myaddr, ULONGEST len_units,
7860 int unit_size, ULONGEST *xfered_len_units)
7862 struct remote_state *rs = get_remote_state ();
7863 int buf_size_bytes; /* Max size of packet output buffer. */
7868 buf_size_bytes = get_memory_read_packet_size ();
7869 /* The packet buffer will be large enough for the payload;
7870 get_memory_packet_size ensures this. */
7872 /* Number of units that will fit. */
7873 todo_units = min (len_units, (buf_size_bytes / unit_size) / 2);
7875 /* Construct "m"<memaddr>","<len>". */
7876 memaddr = remote_address_masked (memaddr);
7879 p += hexnumstr (p, (ULONGEST) memaddr);
7881 p += hexnumstr (p, (ULONGEST) todo_units);
7884 getpkt (&rs->buf, &rs->buf_size, 0);
7885 if (rs->buf[0] == 'E'
7886 && isxdigit (rs->buf[1]) && isxdigit (rs->buf[2])
7887 && rs->buf[3] == '\0')
7888 return TARGET_XFER_E_IO;
7889 /* Reply describes memory byte by byte, each byte encoded as two hex
7892 decoded_bytes = hex2bin (p, myaddr, todo_units * unit_size);
7893 /* Return what we have. Let higher layers handle partial reads. */
7894 *xfered_len_units = (ULONGEST) (decoded_bytes / unit_size);
7895 return TARGET_XFER_OK;
7898 /* Using the set of read-only target sections of remote, read live
7901 For interface/parameters/return description see target.h,
7904 static enum target_xfer_status
7905 remote_xfer_live_readonly_partial (struct target_ops *ops, gdb_byte *readbuf,
7906 ULONGEST memaddr, ULONGEST len,
7907 int unit_size, ULONGEST *xfered_len)
7909 struct target_section *secp;
7910 struct target_section_table *table;
7912 secp = target_section_by_addr (ops, memaddr);
7914 && (bfd_get_section_flags (secp->the_bfd_section->owner,
7915 secp->the_bfd_section)
7918 struct target_section *p;
7919 ULONGEST memend = memaddr + len;
7921 table = target_get_section_table (ops);
7923 for (p = table->sections; p < table->sections_end; p++)
7925 if (memaddr >= p->addr)
7927 if (memend <= p->endaddr)
7929 /* Entire transfer is within this section. */
7930 return remote_read_bytes_1 (memaddr, readbuf, len, unit_size,
7933 else if (memaddr >= p->endaddr)
7935 /* This section ends before the transfer starts. */
7940 /* This section overlaps the transfer. Just do half. */
7941 len = p->endaddr - memaddr;
7942 return remote_read_bytes_1 (memaddr, readbuf, len, unit_size,
7949 return TARGET_XFER_EOF;
7952 /* Similar to remote_read_bytes_1, but it reads from the remote stub
7953 first if the requested memory is unavailable in traceframe.
7954 Otherwise, fall back to remote_read_bytes_1. */
7956 static enum target_xfer_status
7957 remote_read_bytes (struct target_ops *ops, CORE_ADDR memaddr,
7958 gdb_byte *myaddr, ULONGEST len, int unit_size,
7959 ULONGEST *xfered_len)
7962 return TARGET_XFER_EOF;
7964 if (get_traceframe_number () != -1)
7966 VEC(mem_range_s) *available;
7968 /* If we fail to get the set of available memory, then the
7969 target does not support querying traceframe info, and so we
7970 attempt reading from the traceframe anyway (assuming the
7971 target implements the old QTro packet then). */
7972 if (traceframe_available_memory (&available, memaddr, len))
7974 struct cleanup *old_chain;
7976 old_chain = make_cleanup (VEC_cleanup(mem_range_s), &available);
7978 if (VEC_empty (mem_range_s, available)
7979 || VEC_index (mem_range_s, available, 0)->start != memaddr)
7981 enum target_xfer_status res;
7983 /* Don't read into the traceframe's available
7985 if (!VEC_empty (mem_range_s, available))
7987 LONGEST oldlen = len;
7989 len = VEC_index (mem_range_s, available, 0)->start - memaddr;
7990 gdb_assert (len <= oldlen);
7993 do_cleanups (old_chain);
7995 /* This goes through the topmost target again. */
7996 res = remote_xfer_live_readonly_partial (ops, myaddr, memaddr,
7997 len, unit_size, xfered_len);
7998 if (res == TARGET_XFER_OK)
7999 return TARGET_XFER_OK;
8002 /* No use trying further, we know some memory starting
8003 at MEMADDR isn't available. */
8005 return TARGET_XFER_UNAVAILABLE;
8009 /* Don't try to read more than how much is available, in
8010 case the target implements the deprecated QTro packet to
8011 cater for older GDBs (the target's knowledge of read-only
8012 sections may be outdated by now). */
8013 len = VEC_index (mem_range_s, available, 0)->length;
8015 do_cleanups (old_chain);
8019 return remote_read_bytes_1 (memaddr, myaddr, len, unit_size, xfered_len);
8024 /* Sends a packet with content determined by the printf format string
8025 FORMAT and the remaining arguments, then gets the reply. Returns
8026 whether the packet was a success, a failure, or unknown. */
8028 static enum packet_result remote_send_printf (const char *format, ...)
8029 ATTRIBUTE_PRINTF (1, 2);
8031 static enum packet_result
8032 remote_send_printf (const char *format, ...)
8034 struct remote_state *rs = get_remote_state ();
8035 int max_size = get_remote_packet_size ();
8038 va_start (ap, format);
8041 if (vsnprintf (rs->buf, max_size, format, ap) >= max_size)
8042 internal_error (__FILE__, __LINE__, _("Too long remote packet."));
8044 if (putpkt (rs->buf) < 0)
8045 error (_("Communication problem with target."));
8048 getpkt (&rs->buf, &rs->buf_size, 0);
8050 return packet_check_result (rs->buf);
8054 restore_remote_timeout (void *p)
8056 int value = *(int *)p;
8058 remote_timeout = value;
8061 /* Flash writing can take quite some time. We'll set
8062 effectively infinite timeout for flash operations.
8063 In future, we'll need to decide on a better approach. */
8064 static const int remote_flash_timeout = 1000;
8067 remote_flash_erase (struct target_ops *ops,
8068 ULONGEST address, LONGEST length)
8070 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
8071 int saved_remote_timeout = remote_timeout;
8072 enum packet_result ret;
8073 struct cleanup *back_to = make_cleanup (restore_remote_timeout,
8074 &saved_remote_timeout);
8076 remote_timeout = remote_flash_timeout;
8078 ret = remote_send_printf ("vFlashErase:%s,%s",
8079 phex (address, addr_size),
8083 case PACKET_UNKNOWN:
8084 error (_("Remote target does not support flash erase"));
8086 error (_("Error erasing flash with vFlashErase packet"));
8091 do_cleanups (back_to);
8094 static enum target_xfer_status
8095 remote_flash_write (struct target_ops *ops, ULONGEST address,
8096 ULONGEST length, ULONGEST *xfered_len,
8097 const gdb_byte *data)
8099 int saved_remote_timeout = remote_timeout;
8100 enum target_xfer_status ret;
8101 struct cleanup *back_to = make_cleanup (restore_remote_timeout,
8102 &saved_remote_timeout);
8104 remote_timeout = remote_flash_timeout;
8105 ret = remote_write_bytes_aux ("vFlashWrite:", address, data, length, 1,
8107 do_cleanups (back_to);
8113 remote_flash_done (struct target_ops *ops)
8115 int saved_remote_timeout = remote_timeout;
8117 struct cleanup *back_to = make_cleanup (restore_remote_timeout,
8118 &saved_remote_timeout);
8120 remote_timeout = remote_flash_timeout;
8121 ret = remote_send_printf ("vFlashDone");
8122 do_cleanups (back_to);
8126 case PACKET_UNKNOWN:
8127 error (_("Remote target does not support vFlashDone"));
8129 error (_("Error finishing flash operation"));
8136 remote_files_info (struct target_ops *ignore)
8138 puts_filtered ("Debugging a target over a serial line.\n");
8141 /* Stuff for dealing with the packets which are part of this protocol.
8142 See comment at top of file for details. */
8144 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
8145 error to higher layers. Called when a serial error is detected.
8146 The exception message is STRING, followed by a colon and a blank,
8147 the system error message for errno at function entry and final dot
8148 for output compatibility with throw_perror_with_name. */
8151 unpush_and_perror (const char *string)
8153 int saved_errno = errno;
8155 remote_unpush_target ();
8156 throw_error (TARGET_CLOSE_ERROR, "%s: %s.", string,
8157 safe_strerror (saved_errno));
8160 /* Read a single character from the remote end. */
8163 readchar (int timeout)
8166 struct remote_state *rs = get_remote_state ();
8168 ch = serial_readchar (rs->remote_desc, timeout);
8173 switch ((enum serial_rc) ch)
8176 remote_unpush_target ();
8177 throw_error (TARGET_CLOSE_ERROR, _("Remote connection closed"));
8180 unpush_and_perror (_("Remote communication error. "
8181 "Target disconnected."));
8183 case SERIAL_TIMEOUT:
8189 /* Wrapper for serial_write that closes the target and throws if
8193 remote_serial_write (const char *str, int len)
8195 struct remote_state *rs = get_remote_state ();
8197 if (serial_write (rs->remote_desc, str, len))
8199 unpush_and_perror (_("Remote communication error. "
8200 "Target disconnected."));
8204 /* Send the command in *BUF to the remote machine, and read the reply
8205 into *BUF. Report an error if we get an error reply. Resize
8206 *BUF using xrealloc if necessary to hold the result, and update
8210 remote_send (char **buf,
8214 getpkt (buf, sizeof_buf, 0);
8216 if ((*buf)[0] == 'E')
8217 error (_("Remote failure reply: %s"), *buf);
8220 /* Return a pointer to an xmalloc'ed string representing an escaped
8221 version of BUF, of len N. E.g. \n is converted to \\n, \t to \\t,
8222 etc. The caller is responsible for releasing the returned
8226 escape_buffer (const char *buf, int n)
8228 struct cleanup *old_chain;
8229 struct ui_file *stb;
8232 stb = mem_fileopen ();
8233 old_chain = make_cleanup_ui_file_delete (stb);
8235 fputstrn_unfiltered (buf, n, '\\', stb);
8236 str = ui_file_xstrdup (stb, NULL);
8237 do_cleanups (old_chain);
8241 /* Display a null-terminated packet on stdout, for debugging, using C
8245 print_packet (const char *buf)
8247 puts_filtered ("\"");
8248 fputstr_filtered (buf, '"', gdb_stdout);
8249 puts_filtered ("\"");
8253 putpkt (const char *buf)
8255 return putpkt_binary (buf, strlen (buf));
8258 /* Send a packet to the remote machine, with error checking. The data
8259 of the packet is in BUF. The string in BUF can be at most
8260 get_remote_packet_size () - 5 to account for the $, # and checksum,
8261 and for a possible /0 if we are debugging (remote_debug) and want
8262 to print the sent packet as a string. */
8265 putpkt_binary (const char *buf, int cnt)
8267 struct remote_state *rs = get_remote_state ();
8269 unsigned char csum = 0;
8270 char *buf2 = (char *) xmalloc (cnt + 6);
8271 struct cleanup *old_chain = make_cleanup (xfree, buf2);
8277 /* Catch cases like trying to read memory or listing threads while
8278 we're waiting for a stop reply. The remote server wouldn't be
8279 ready to handle this request, so we'd hang and timeout. We don't
8280 have to worry about this in synchronous mode, because in that
8281 case it's not possible to issue a command while the target is
8282 running. This is not a problem in non-stop mode, because in that
8283 case, the stub is always ready to process serial input. */
8284 if (!target_is_non_stop_p ()
8285 && target_is_async_p ()
8286 && rs->waiting_for_stop_reply)
8288 error (_("Cannot execute this command while the target is running.\n"
8289 "Use the \"interrupt\" command to stop the target\n"
8290 "and then try again."));
8293 /* We're sending out a new packet. Make sure we don't look at a
8294 stale cached response. */
8295 rs->cached_wait_status = 0;
8297 /* Copy the packet into buffer BUF2, encapsulating it
8298 and giving it a checksum. */
8303 for (i = 0; i < cnt; i++)
8309 *p++ = tohex ((csum >> 4) & 0xf);
8310 *p++ = tohex (csum & 0xf);
8312 /* Send it over and over until we get a positive ack. */
8316 int started_error_output = 0;
8320 struct cleanup *old_chain;
8324 str = escape_buffer (buf2, p - buf2);
8325 old_chain = make_cleanup (xfree, str);
8326 fprintf_unfiltered (gdb_stdlog, "Sending packet: %s...", str);
8327 gdb_flush (gdb_stdlog);
8328 do_cleanups (old_chain);
8330 remote_serial_write (buf2, p - buf2);
8332 /* If this is a no acks version of the remote protocol, send the
8333 packet and move on. */
8337 /* Read until either a timeout occurs (-2) or '+' is read.
8338 Handle any notification that arrives in the mean time. */
8341 ch = readchar (remote_timeout);
8349 case SERIAL_TIMEOUT:
8352 if (started_error_output)
8354 putchar_unfiltered ('\n');
8355 started_error_output = 0;
8364 fprintf_unfiltered (gdb_stdlog, "Ack\n");
8365 do_cleanups (old_chain);
8369 fprintf_unfiltered (gdb_stdlog, "Nak\n");
8371 case SERIAL_TIMEOUT:
8375 do_cleanups (old_chain);
8378 break; /* Retransmit buffer. */
8382 fprintf_unfiltered (gdb_stdlog,
8383 "Packet instead of Ack, ignoring it\n");
8384 /* It's probably an old response sent because an ACK
8385 was lost. Gobble up the packet and ack it so it
8386 doesn't get retransmitted when we resend this
8389 remote_serial_write ("+", 1);
8390 continue; /* Now, go look for +. */
8397 /* If we got a notification, handle it, and go back to looking
8399 /* We've found the start of a notification. Now
8400 collect the data. */
8401 val = read_frame (&rs->buf, &rs->buf_size);
8406 struct cleanup *old_chain;
8409 str = escape_buffer (rs->buf, val);
8410 old_chain = make_cleanup (xfree, str);
8411 fprintf_unfiltered (gdb_stdlog,
8412 " Notification received: %s\n",
8414 do_cleanups (old_chain);
8416 handle_notification (rs->notif_state, rs->buf);
8417 /* We're in sync now, rewait for the ack. */
8424 if (!started_error_output)
8426 started_error_output = 1;
8427 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
8429 fputc_unfiltered (ch & 0177, gdb_stdlog);
8430 fprintf_unfiltered (gdb_stdlog, "%s", rs->buf);
8439 if (!started_error_output)
8441 started_error_output = 1;
8442 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
8444 fputc_unfiltered (ch & 0177, gdb_stdlog);
8448 break; /* Here to retransmit. */
8452 /* This is wrong. If doing a long backtrace, the user should be
8453 able to get out next time we call QUIT, without anything as
8454 violent as interrupt_query. If we want to provide a way out of
8455 here without getting to the next QUIT, it should be based on
8456 hitting ^C twice as in remote_wait. */
8465 do_cleanups (old_chain);
8469 /* Come here after finding the start of a frame when we expected an
8470 ack. Do our best to discard the rest of this packet. */
8479 c = readchar (remote_timeout);
8482 case SERIAL_TIMEOUT:
8483 /* Nothing we can do. */
8486 /* Discard the two bytes of checksum and stop. */
8487 c = readchar (remote_timeout);
8489 c = readchar (remote_timeout);
8492 case '*': /* Run length encoding. */
8493 /* Discard the repeat count. */
8494 c = readchar (remote_timeout);
8499 /* A regular character. */
8505 /* Come here after finding the start of the frame. Collect the rest
8506 into *BUF, verifying the checksum, length, and handling run-length
8507 compression. NUL terminate the buffer. If there is not enough room,
8508 expand *BUF using xrealloc.
8510 Returns -1 on error, number of characters in buffer (ignoring the
8511 trailing NULL) on success. (could be extended to return one of the
8512 SERIAL status indications). */
8515 read_frame (char **buf_p,
8522 struct remote_state *rs = get_remote_state ();
8529 c = readchar (remote_timeout);
8532 case SERIAL_TIMEOUT:
8534 fputs_filtered ("Timeout in mid-packet, retrying\n", gdb_stdlog);
8538 fputs_filtered ("Saw new packet start in middle of old one\n",
8540 return -1; /* Start a new packet, count retries. */
8543 unsigned char pktcsum;
8549 check_0 = readchar (remote_timeout);
8551 check_1 = readchar (remote_timeout);
8553 if (check_0 == SERIAL_TIMEOUT || check_1 == SERIAL_TIMEOUT)
8556 fputs_filtered ("Timeout in checksum, retrying\n",
8560 else if (check_0 < 0 || check_1 < 0)
8563 fputs_filtered ("Communication error in checksum\n",
8568 /* Don't recompute the checksum; with no ack packets we
8569 don't have any way to indicate a packet retransmission
8574 pktcsum = (fromhex (check_0) << 4) | fromhex (check_1);
8575 if (csum == pktcsum)
8580 struct cleanup *old_chain;
8583 str = escape_buffer (buf, bc);
8584 old_chain = make_cleanup (xfree, str);
8585 fprintf_unfiltered (gdb_stdlog,
8586 "Bad checksum, sentsum=0x%x, "
8587 "csum=0x%x, buf=%s\n",
8588 pktcsum, csum, str);
8589 do_cleanups (old_chain);
8591 /* Number of characters in buffer ignoring trailing
8595 case '*': /* Run length encoding. */
8600 c = readchar (remote_timeout);
8602 repeat = c - ' ' + 3; /* Compute repeat count. */
8604 /* The character before ``*'' is repeated. */
8606 if (repeat > 0 && repeat <= 255 && bc > 0)
8608 if (bc + repeat - 1 >= *sizeof_buf - 1)
8610 /* Make some more room in the buffer. */
8611 *sizeof_buf += repeat;
8612 *buf_p = (char *) xrealloc (*buf_p, *sizeof_buf);
8616 memset (&buf[bc], buf[bc - 1], repeat);
8622 printf_filtered (_("Invalid run length encoding: %s\n"), buf);
8626 if (bc >= *sizeof_buf - 1)
8628 /* Make some more room in the buffer. */
8630 *buf_p = (char *) xrealloc (*buf_p, *sizeof_buf);
8641 /* Read a packet from the remote machine, with error checking, and
8642 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
8643 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
8644 rather than timing out; this is used (in synchronous mode) to wait
8645 for a target that is is executing user code to stop. */
8646 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
8647 don't have to change all the calls to getpkt to deal with the
8648 return value, because at the moment I don't know what the right
8649 thing to do it for those. */
8655 getpkt_sane (buf, sizeof_buf, forever);
8659 /* Read a packet from the remote machine, with error checking, and
8660 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
8661 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
8662 rather than timing out; this is used (in synchronous mode) to wait
8663 for a target that is is executing user code to stop. If FOREVER ==
8664 0, this function is allowed to time out gracefully and return an
8665 indication of this to the caller. Otherwise return the number of
8666 bytes read. If EXPECTING_NOTIF, consider receiving a notification
8667 enough reason to return to the caller. *IS_NOTIF is an output
8668 boolean that indicates whether *BUF holds a notification or not
8669 (a regular packet). */
8672 getpkt_or_notif_sane_1 (char **buf, long *sizeof_buf, int forever,
8673 int expecting_notif, int *is_notif)
8675 struct remote_state *rs = get_remote_state ();
8681 /* We're reading a new response. Make sure we don't look at a
8682 previously cached response. */
8683 rs->cached_wait_status = 0;
8685 strcpy (*buf, "timeout");
8688 timeout = watchdog > 0 ? watchdog : -1;
8689 else if (expecting_notif)
8690 timeout = 0; /* There should already be a char in the buffer. If
8693 timeout = remote_timeout;
8697 /* Process any number of notifications, and then return when
8701 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
8703 for (tries = 1; tries <= MAX_TRIES; tries++)
8705 /* This can loop forever if the remote side sends us
8706 characters continuously, but if it pauses, we'll get
8707 SERIAL_TIMEOUT from readchar because of timeout. Then
8708 we'll count that as a retry.
8710 Note that even when forever is set, we will only wait
8711 forever prior to the start of a packet. After that, we
8712 expect characters to arrive at a brisk pace. They should
8713 show up within remote_timeout intervals. */
8715 c = readchar (timeout);
8716 while (c != SERIAL_TIMEOUT && c != '$' && c != '%');
8718 if (c == SERIAL_TIMEOUT)
8720 if (expecting_notif)
8721 return -1; /* Don't complain, it's normal to not get
8722 anything in this case. */
8724 if (forever) /* Watchdog went off? Kill the target. */
8727 remote_unpush_target ();
8728 throw_error (TARGET_CLOSE_ERROR,
8729 _("Watchdog timeout has expired. "
8730 "Target detached."));
8733 fputs_filtered ("Timed out.\n", gdb_stdlog);
8737 /* We've found the start of a packet or notification.
8738 Now collect the data. */
8739 val = read_frame (buf, sizeof_buf);
8744 remote_serial_write ("-", 1);
8747 if (tries > MAX_TRIES)
8749 /* We have tried hard enough, and just can't receive the
8750 packet/notification. Give up. */
8751 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
8753 /* Skip the ack char if we're in no-ack mode. */
8754 if (!rs->noack_mode)
8755 remote_serial_write ("+", 1);
8759 /* If we got an ordinary packet, return that to our caller. */
8764 struct cleanup *old_chain;
8767 str = escape_buffer (*buf, val);
8768 old_chain = make_cleanup (xfree, str);
8769 fprintf_unfiltered (gdb_stdlog, "Packet received: %s\n", str);
8770 do_cleanups (old_chain);
8773 /* Skip the ack char if we're in no-ack mode. */
8774 if (!rs->noack_mode)
8775 remote_serial_write ("+", 1);
8776 if (is_notif != NULL)
8781 /* If we got a notification, handle it, and go back to looking
8785 gdb_assert (c == '%');
8789 struct cleanup *old_chain;
8792 str = escape_buffer (*buf, val);
8793 old_chain = make_cleanup (xfree, str);
8794 fprintf_unfiltered (gdb_stdlog,
8795 " Notification received: %s\n",
8797 do_cleanups (old_chain);
8799 if (is_notif != NULL)
8802 handle_notification (rs->notif_state, *buf);
8804 /* Notifications require no acknowledgement. */
8806 if (expecting_notif)
8813 getpkt_sane (char **buf, long *sizeof_buf, int forever)
8815 return getpkt_or_notif_sane_1 (buf, sizeof_buf, forever, 0, NULL);
8819 getpkt_or_notif_sane (char **buf, long *sizeof_buf, int forever,
8822 return getpkt_or_notif_sane_1 (buf, sizeof_buf, forever, 1,
8826 /* Check whether EVENT is a fork event for the process specified
8827 by the pid passed in DATA, and if it is, kill the fork child. */
8830 kill_child_of_pending_fork (QUEUE (stop_reply_p) *q,
8831 QUEUE_ITER (stop_reply_p) *iter,
8835 struct queue_iter_param *param = (struct queue_iter_param *) data;
8836 int parent_pid = *(int *) param->input;
8838 if (is_pending_fork_parent (&event->ws, parent_pid, event->ptid))
8840 struct remote_state *rs = get_remote_state ();
8841 int child_pid = ptid_get_pid (event->ws.value.related_pid);
8844 res = remote_vkill (child_pid, rs);
8846 error (_("Can't kill fork child process %d"), child_pid);
8852 /* Kill any new fork children of process PID that haven't been
8853 processed by follow_fork. */
8856 kill_new_fork_children (int pid, struct remote_state *rs)
8858 struct thread_info *thread;
8859 struct notif_client *notif = ¬if_client_stop;
8860 struct queue_iter_param param;
8862 /* Kill the fork child threads of any threads in process PID
8863 that are stopped at a fork event. */
8864 ALL_NON_EXITED_THREADS (thread)
8866 struct target_waitstatus *ws = &thread->pending_follow;
8868 if (is_pending_fork_parent (ws, pid, thread->ptid))
8870 struct remote_state *rs = get_remote_state ();
8871 int child_pid = ptid_get_pid (ws->value.related_pid);
8874 res = remote_vkill (child_pid, rs);
8876 error (_("Can't kill fork child process %d"), child_pid);
8880 /* Check for any pending fork events (not reported or processed yet)
8881 in process PID and kill those fork child threads as well. */
8882 remote_notif_get_pending_events (notif);
8884 param.output = NULL;
8885 QUEUE_iterate (stop_reply_p, stop_reply_queue,
8886 kill_child_of_pending_fork, ¶m);
8890 /* Target hook to kill the current inferior. */
8893 remote_kill (struct target_ops *ops)
8896 int pid = ptid_get_pid (inferior_ptid);
8897 struct remote_state *rs = get_remote_state ();
8899 if (packet_support (PACKET_vKill) != PACKET_DISABLE)
8901 /* If we're stopped while forking and we haven't followed yet,
8902 kill the child task. We need to do this before killing the
8903 parent task because if this is a vfork then the parent will
8905 kill_new_fork_children (pid, rs);
8907 res = remote_vkill (pid, rs);
8910 target_mourn_inferior ();
8915 /* If we are in 'target remote' mode and we are killing the only
8916 inferior, then we will tell gdbserver to exit and unpush the
8918 if (res == -1 && !remote_multi_process_p (rs)
8919 && number_of_live_inferiors () == 1)
8923 /* We've killed the remote end, we get to mourn it. If we are
8924 not in extended mode, mourning the inferior also unpushes
8925 remote_ops from the target stack, which closes the remote
8927 target_mourn_inferior ();
8932 error (_("Can't kill process"));
8935 /* Send a kill request to the target using the 'vKill' packet. */
8938 remote_vkill (int pid, struct remote_state *rs)
8940 if (packet_support (PACKET_vKill) == PACKET_DISABLE)
8943 /* Tell the remote target to detach. */
8944 xsnprintf (rs->buf, get_remote_packet_size (), "vKill;%x", pid);
8946 getpkt (&rs->buf, &rs->buf_size, 0);
8948 switch (packet_ok (rs->buf,
8949 &remote_protocol_packets[PACKET_vKill]))
8955 case PACKET_UNKNOWN:
8958 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
8962 /* Send a kill request to the target using the 'k' packet. */
8965 remote_kill_k (void)
8967 /* Catch errors so the user can quit from gdb even when we
8968 aren't on speaking terms with the remote system. */
8973 CATCH (ex, RETURN_MASK_ERROR)
8975 if (ex.error == TARGET_CLOSE_ERROR)
8977 /* If we got an (EOF) error that caused the target
8978 to go away, then we're done, that's what we wanted.
8979 "k" is susceptible to cause a premature EOF, given
8980 that the remote server isn't actually required to
8981 reply to "k", and it can happen that it doesn't
8982 even get to reply ACK to the "k". */
8986 /* Otherwise, something went wrong. We didn't actually kill
8987 the target. Just propagate the exception, and let the
8988 user or higher layers decide what to do. */
8989 throw_exception (ex);
8995 remote_mourn (struct target_ops *target)
8997 struct remote_state *rs = get_remote_state ();
8999 /* In 'target remote' mode with one inferior, we close the connection. */
9000 if (!rs->extended && number_of_live_inferiors () <= 1)
9002 unpush_target (target);
9004 /* remote_close takes care of doing most of the clean up. */
9005 generic_mourn_inferior ();
9009 /* In case we got here due to an error, but we're going to stay
9011 rs->waiting_for_stop_reply = 0;
9013 /* If the current general thread belonged to the process we just
9014 detached from or has exited, the remote side current general
9015 thread becomes undefined. Considering a case like this:
9017 - We just got here due to a detach.
9018 - The process that we're detaching from happens to immediately
9019 report a global breakpoint being hit in non-stop mode, in the
9020 same thread we had selected before.
9021 - GDB attaches to this process again.
9022 - This event happens to be the next event we handle.
9024 GDB would consider that the current general thread didn't need to
9025 be set on the stub side (with Hg), since for all it knew,
9026 GENERAL_THREAD hadn't changed.
9028 Notice that although in all-stop mode, the remote server always
9029 sets the current thread to the thread reporting the stop event,
9030 that doesn't happen in non-stop mode; in non-stop, the stub *must
9031 not* change the current thread when reporting a breakpoint hit,
9032 due to the decoupling of event reporting and event handling.
9034 To keep things simple, we always invalidate our notion of the
9036 record_currthread (rs, minus_one_ptid);
9038 /* Call common code to mark the inferior as not running. */
9039 generic_mourn_inferior ();
9041 if (!have_inferiors ())
9043 if (!remote_multi_process_p (rs))
9045 /* Check whether the target is running now - some remote stubs
9046 automatically restart after kill. */
9048 getpkt (&rs->buf, &rs->buf_size, 0);
9050 if (rs->buf[0] == 'S' || rs->buf[0] == 'T')
9052 /* Assume that the target has been restarted. Set
9053 inferior_ptid so that bits of core GDB realizes
9054 there's something here, e.g., so that the user can
9055 say "kill" again. */
9056 inferior_ptid = magic_null_ptid;
9063 extended_remote_supports_disable_randomization (struct target_ops *self)
9065 return packet_support (PACKET_QDisableRandomization) == PACKET_ENABLE;
9069 extended_remote_disable_randomization (int val)
9071 struct remote_state *rs = get_remote_state ();
9074 xsnprintf (rs->buf, get_remote_packet_size (), "QDisableRandomization:%x",
9077 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
9079 error (_("Target does not support QDisableRandomization."));
9080 if (strcmp (reply, "OK") != 0)
9081 error (_("Bogus QDisableRandomization reply from target: %s"), reply);
9085 extended_remote_run (char *args)
9087 struct remote_state *rs = get_remote_state ();
9089 const char *remote_exec_file = get_remote_exec_file ();
9091 /* If the user has disabled vRun support, or we have detected that
9092 support is not available, do not try it. */
9093 if (packet_support (PACKET_vRun) == PACKET_DISABLE)
9096 strcpy (rs->buf, "vRun;");
9097 len = strlen (rs->buf);
9099 if (strlen (remote_exec_file) * 2 + len >= get_remote_packet_size ())
9100 error (_("Remote file name too long for run packet"));
9101 len += 2 * bin2hex ((gdb_byte *) remote_exec_file, rs->buf + len,
9102 strlen (remote_exec_file));
9104 gdb_assert (args != NULL);
9107 struct cleanup *back_to;
9111 argv = gdb_buildargv (args);
9112 back_to = make_cleanup_freeargv (argv);
9113 for (i = 0; argv[i] != NULL; i++)
9115 if (strlen (argv[i]) * 2 + 1 + len >= get_remote_packet_size ())
9116 error (_("Argument list too long for run packet"));
9117 rs->buf[len++] = ';';
9118 len += 2 * bin2hex ((gdb_byte *) argv[i], rs->buf + len,
9121 do_cleanups (back_to);
9124 rs->buf[len++] = '\0';
9127 getpkt (&rs->buf, &rs->buf_size, 0);
9129 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_vRun]))
9132 /* We have a wait response. All is well. */
9134 case PACKET_UNKNOWN:
9137 if (remote_exec_file[0] == '\0')
9138 error (_("Running the default executable on the remote target failed; "
9139 "try \"set remote exec-file\"?"));
9141 error (_("Running \"%s\" on the remote target failed"),
9144 gdb_assert_not_reached (_("bad switch"));
9148 /* In the extended protocol we want to be able to do things like
9149 "run" and have them basically work as expected. So we need
9150 a special create_inferior function. We support changing the
9151 executable file and the command line arguments, but not the
9155 extended_remote_create_inferior (struct target_ops *ops,
9156 char *exec_file, char *args,
9157 char **env, int from_tty)
9161 struct remote_state *rs = get_remote_state ();
9162 const char *remote_exec_file = get_remote_exec_file ();
9164 /* If running asynchronously, register the target file descriptor
9165 with the event loop. */
9166 if (target_can_async_p ())
9169 /* Disable address space randomization if requested (and supported). */
9170 if (extended_remote_supports_disable_randomization (ops))
9171 extended_remote_disable_randomization (disable_randomization);
9173 /* Now restart the remote server. */
9174 run_worked = extended_remote_run (args) != -1;
9177 /* vRun was not supported. Fail if we need it to do what the
9179 if (remote_exec_file[0])
9180 error (_("Remote target does not support \"set remote exec-file\""));
9182 error (_("Remote target does not support \"set args\" or run <ARGS>"));
9184 /* Fall back to "R". */
9185 extended_remote_restart ();
9188 if (!have_inferiors ())
9190 /* Clean up from the last time we ran, before we mark the target
9191 running again. This will mark breakpoints uninserted, and
9192 get_offsets may insert breakpoints. */
9193 init_thread_list ();
9194 init_wait_for_inferior ();
9197 /* vRun's success return is a stop reply. */
9198 stop_reply = run_worked ? rs->buf : NULL;
9199 add_current_inferior_and_thread (stop_reply);
9201 /* Get updated offsets, if the stub uses qOffsets. */
9206 /* Given a location's target info BP_TGT and the packet buffer BUF, output
9207 the list of conditions (in agent expression bytecode format), if any, the
9208 target needs to evaluate. The output is placed into the packet buffer
9209 started from BUF and ended at BUF_END. */
9212 remote_add_target_side_condition (struct gdbarch *gdbarch,
9213 struct bp_target_info *bp_tgt, char *buf,
9216 struct agent_expr *aexpr = NULL;
9219 if (VEC_empty (agent_expr_p, bp_tgt->conditions))
9222 buf += strlen (buf);
9223 xsnprintf (buf, buf_end - buf, "%s", ";");
9226 /* Send conditions to the target and free the vector. */
9228 VEC_iterate (agent_expr_p, bp_tgt->conditions, ix, aexpr);
9231 xsnprintf (buf, buf_end - buf, "X%x,", aexpr->len);
9232 buf += strlen (buf);
9233 for (i = 0; i < aexpr->len; ++i)
9234 buf = pack_hex_byte (buf, aexpr->buf[i]);
9241 remote_add_target_side_commands (struct gdbarch *gdbarch,
9242 struct bp_target_info *bp_tgt, char *buf)
9244 struct agent_expr *aexpr = NULL;
9247 if (VEC_empty (agent_expr_p, bp_tgt->tcommands))
9250 buf += strlen (buf);
9252 sprintf (buf, ";cmds:%x,", bp_tgt->persist);
9253 buf += strlen (buf);
9255 /* Concatenate all the agent expressions that are commands into the
9258 VEC_iterate (agent_expr_p, bp_tgt->tcommands, ix, aexpr);
9261 sprintf (buf, "X%x,", aexpr->len);
9262 buf += strlen (buf);
9263 for (i = 0; i < aexpr->len; ++i)
9264 buf = pack_hex_byte (buf, aexpr->buf[i]);
9269 /* Insert a breakpoint. On targets that have software breakpoint
9270 support, we ask the remote target to do the work; on targets
9271 which don't, we insert a traditional memory breakpoint. */
9274 remote_insert_breakpoint (struct target_ops *ops,
9275 struct gdbarch *gdbarch,
9276 struct bp_target_info *bp_tgt)
9278 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
9279 If it succeeds, then set the support to PACKET_ENABLE. If it
9280 fails, and the user has explicitly requested the Z support then
9281 report an error, otherwise, mark it disabled and go on. */
9283 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
9285 CORE_ADDR addr = bp_tgt->reqstd_address;
9286 struct remote_state *rs;
9290 /* Make sure the remote is pointing at the right process, if
9292 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9293 set_general_process ();
9295 gdbarch_remote_breakpoint_from_pc (gdbarch, &addr, &bpsize);
9297 rs = get_remote_state ();
9299 endbuf = rs->buf + get_remote_packet_size ();
9304 addr = (ULONGEST) remote_address_masked (addr);
9305 p += hexnumstr (p, addr);
9306 xsnprintf (p, endbuf - p, ",%d", bpsize);
9308 if (remote_supports_cond_breakpoints (ops))
9309 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
9311 if (remote_can_run_breakpoint_commands (ops))
9312 remote_add_target_side_commands (gdbarch, bp_tgt, p);
9315 getpkt (&rs->buf, &rs->buf_size, 0);
9317 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0]))
9322 bp_tgt->placed_address = addr;
9323 bp_tgt->placed_size = bpsize;
9325 case PACKET_UNKNOWN:
9330 /* If this breakpoint has target-side commands but this stub doesn't
9331 support Z0 packets, throw error. */
9332 if (!VEC_empty (agent_expr_p, bp_tgt->tcommands))
9333 throw_error (NOT_SUPPORTED_ERROR, _("\
9334 Target doesn't support breakpoints that have target side commands."));
9336 return memory_insert_breakpoint (ops, gdbarch, bp_tgt);
9340 remote_remove_breakpoint (struct target_ops *ops,
9341 struct gdbarch *gdbarch,
9342 struct bp_target_info *bp_tgt)
9344 CORE_ADDR addr = bp_tgt->placed_address;
9345 struct remote_state *rs = get_remote_state ();
9347 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
9350 char *endbuf = rs->buf + get_remote_packet_size ();
9352 /* Make sure the remote is pointing at the right process, if
9354 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9355 set_general_process ();
9361 addr = (ULONGEST) remote_address_masked (bp_tgt->placed_address);
9362 p += hexnumstr (p, addr);
9363 xsnprintf (p, endbuf - p, ",%d", bp_tgt->placed_size);
9366 getpkt (&rs->buf, &rs->buf_size, 0);
9368 return (rs->buf[0] == 'E');
9371 return memory_remove_breakpoint (ops, gdbarch, bp_tgt);
9374 static enum Z_packet_type
9375 watchpoint_to_Z_packet (int type)
9380 return Z_PACKET_WRITE_WP;
9383 return Z_PACKET_READ_WP;
9386 return Z_PACKET_ACCESS_WP;
9389 internal_error (__FILE__, __LINE__,
9390 _("hw_bp_to_z: bad watchpoint type %d"), type);
9395 remote_insert_watchpoint (struct target_ops *self, CORE_ADDR addr, int len,
9396 enum target_hw_bp_type type, struct expression *cond)
9398 struct remote_state *rs = get_remote_state ();
9399 char *endbuf = rs->buf + get_remote_packet_size ();
9401 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
9403 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
9406 /* Make sure the remote is pointing at the right process, if
9408 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9409 set_general_process ();
9411 xsnprintf (rs->buf, endbuf - rs->buf, "Z%x,", packet);
9412 p = strchr (rs->buf, '\0');
9413 addr = remote_address_masked (addr);
9414 p += hexnumstr (p, (ULONGEST) addr);
9415 xsnprintf (p, endbuf - p, ",%x", len);
9418 getpkt (&rs->buf, &rs->buf_size, 0);
9420 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
9424 case PACKET_UNKNOWN:
9429 internal_error (__FILE__, __LINE__,
9430 _("remote_insert_watchpoint: reached end of function"));
9434 remote_watchpoint_addr_within_range (struct target_ops *target, CORE_ADDR addr,
9435 CORE_ADDR start, int length)
9437 CORE_ADDR diff = remote_address_masked (addr - start);
9439 return diff < length;
9444 remote_remove_watchpoint (struct target_ops *self, CORE_ADDR addr, int len,
9445 enum target_hw_bp_type type, struct expression *cond)
9447 struct remote_state *rs = get_remote_state ();
9448 char *endbuf = rs->buf + get_remote_packet_size ();
9450 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
9452 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
9455 /* Make sure the remote is pointing at the right process, if
9457 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9458 set_general_process ();
9460 xsnprintf (rs->buf, endbuf - rs->buf, "z%x,", packet);
9461 p = strchr (rs->buf, '\0');
9462 addr = remote_address_masked (addr);
9463 p += hexnumstr (p, (ULONGEST) addr);
9464 xsnprintf (p, endbuf - p, ",%x", len);
9466 getpkt (&rs->buf, &rs->buf_size, 0);
9468 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
9471 case PACKET_UNKNOWN:
9476 internal_error (__FILE__, __LINE__,
9477 _("remote_remove_watchpoint: reached end of function"));
9481 int remote_hw_watchpoint_limit = -1;
9482 int remote_hw_watchpoint_length_limit = -1;
9483 int remote_hw_breakpoint_limit = -1;
9486 remote_region_ok_for_hw_watchpoint (struct target_ops *self,
9487 CORE_ADDR addr, int len)
9489 if (remote_hw_watchpoint_length_limit == 0)
9491 else if (remote_hw_watchpoint_length_limit < 0)
9493 else if (len <= remote_hw_watchpoint_length_limit)
9500 remote_check_watch_resources (struct target_ops *self,
9501 enum bptype type, int cnt, int ot)
9503 if (type == bp_hardware_breakpoint)
9505 if (remote_hw_breakpoint_limit == 0)
9507 else if (remote_hw_breakpoint_limit < 0)
9509 else if (cnt <= remote_hw_breakpoint_limit)
9514 if (remote_hw_watchpoint_limit == 0)
9516 else if (remote_hw_watchpoint_limit < 0)
9520 else if (cnt <= remote_hw_watchpoint_limit)
9526 /* The to_stopped_by_sw_breakpoint method of target remote. */
9529 remote_stopped_by_sw_breakpoint (struct target_ops *ops)
9531 struct thread_info *thread = inferior_thread ();
9533 return (thread->priv != NULL
9534 && thread->priv->stop_reason == TARGET_STOPPED_BY_SW_BREAKPOINT);
9537 /* The to_supports_stopped_by_sw_breakpoint method of target
9541 remote_supports_stopped_by_sw_breakpoint (struct target_ops *ops)
9543 return (packet_support (PACKET_swbreak_feature) == PACKET_ENABLE);
9546 /* The to_stopped_by_hw_breakpoint method of target remote. */
9549 remote_stopped_by_hw_breakpoint (struct target_ops *ops)
9551 struct thread_info *thread = inferior_thread ();
9553 return (thread->priv != NULL
9554 && thread->priv->stop_reason == TARGET_STOPPED_BY_HW_BREAKPOINT);
9557 /* The to_supports_stopped_by_hw_breakpoint method of target
9561 remote_supports_stopped_by_hw_breakpoint (struct target_ops *ops)
9563 return (packet_support (PACKET_hwbreak_feature) == PACKET_ENABLE);
9567 remote_stopped_by_watchpoint (struct target_ops *ops)
9569 struct thread_info *thread = inferior_thread ();
9571 return (thread->priv != NULL
9572 && thread->priv->stop_reason == TARGET_STOPPED_BY_WATCHPOINT);
9576 remote_stopped_data_address (struct target_ops *target, CORE_ADDR *addr_p)
9578 struct thread_info *thread = inferior_thread ();
9580 if (thread->priv != NULL
9581 && thread->priv->stop_reason == TARGET_STOPPED_BY_WATCHPOINT)
9583 *addr_p = thread->priv->watch_data_address;
9592 remote_insert_hw_breakpoint (struct target_ops *self, struct gdbarch *gdbarch,
9593 struct bp_target_info *bp_tgt)
9595 CORE_ADDR addr = bp_tgt->reqstd_address;
9596 struct remote_state *rs;
9601 /* The length field should be set to the size of a breakpoint
9602 instruction, even though we aren't inserting one ourselves. */
9604 gdbarch_remote_breakpoint_from_pc (gdbarch, &addr, &bpsize);
9606 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
9609 /* Make sure the remote is pointing at the right process, if
9611 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9612 set_general_process ();
9614 rs = get_remote_state ();
9616 endbuf = rs->buf + get_remote_packet_size ();
9622 addr = remote_address_masked (addr);
9623 p += hexnumstr (p, (ULONGEST) addr);
9624 xsnprintf (p, endbuf - p, ",%x", bpsize);
9626 if (remote_supports_cond_breakpoints (self))
9627 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
9629 if (remote_can_run_breakpoint_commands (self))
9630 remote_add_target_side_commands (gdbarch, bp_tgt, p);
9633 getpkt (&rs->buf, &rs->buf_size, 0);
9635 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
9638 if (rs->buf[1] == '.')
9640 message = strchr (rs->buf + 2, '.');
9642 error (_("Remote failure reply: %s"), message + 1);
9645 case PACKET_UNKNOWN:
9648 bp_tgt->placed_address = addr;
9649 bp_tgt->placed_size = bpsize;
9652 internal_error (__FILE__, __LINE__,
9653 _("remote_insert_hw_breakpoint: reached end of function"));
9658 remote_remove_hw_breakpoint (struct target_ops *self, struct gdbarch *gdbarch,
9659 struct bp_target_info *bp_tgt)
9662 struct remote_state *rs = get_remote_state ();
9664 char *endbuf = rs->buf + get_remote_packet_size ();
9666 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
9669 /* Make sure the remote is pointing at the right process, if
9671 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9672 set_general_process ();
9678 addr = remote_address_masked (bp_tgt->placed_address);
9679 p += hexnumstr (p, (ULONGEST) addr);
9680 xsnprintf (p, endbuf - p, ",%x", bp_tgt->placed_size);
9683 getpkt (&rs->buf, &rs->buf_size, 0);
9685 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
9688 case PACKET_UNKNOWN:
9693 internal_error (__FILE__, __LINE__,
9694 _("remote_remove_hw_breakpoint: reached end of function"));
9697 /* Verify memory using the "qCRC:" request. */
9700 remote_verify_memory (struct target_ops *ops,
9701 const gdb_byte *data, CORE_ADDR lma, ULONGEST size)
9703 struct remote_state *rs = get_remote_state ();
9704 unsigned long host_crc, target_crc;
9707 /* It doesn't make sense to use qCRC if the remote target is
9708 connected but not running. */
9709 if (target_has_execution && packet_support (PACKET_qCRC) != PACKET_DISABLE)
9711 enum packet_result result;
9713 /* Make sure the remote is pointing at the right process. */
9714 set_general_process ();
9716 /* FIXME: assumes lma can fit into long. */
9717 xsnprintf (rs->buf, get_remote_packet_size (), "qCRC:%lx,%lx",
9718 (long) lma, (long) size);
9721 /* Be clever; compute the host_crc before waiting for target
9723 host_crc = xcrc32 (data, size, 0xffffffff);
9725 getpkt (&rs->buf, &rs->buf_size, 0);
9727 result = packet_ok (rs->buf,
9728 &remote_protocol_packets[PACKET_qCRC]);
9729 if (result == PACKET_ERROR)
9731 else if (result == PACKET_OK)
9733 for (target_crc = 0, tmp = &rs->buf[1]; *tmp; tmp++)
9734 target_crc = target_crc * 16 + fromhex (*tmp);
9736 return (host_crc == target_crc);
9740 return simple_verify_memory (ops, data, lma, size);
9743 /* compare-sections command
9745 With no arguments, compares each loadable section in the exec bfd
9746 with the same memory range on the target, and reports mismatches.
9747 Useful for verifying the image on the target against the exec file. */
9750 compare_sections_command (char *args, int from_tty)
9753 struct cleanup *old_chain;
9755 const char *sectname;
9764 error (_("command cannot be used without an exec file"));
9766 /* Make sure the remote is pointing at the right process. */
9767 set_general_process ();
9769 if (args != NULL && strcmp (args, "-r") == 0)
9775 for (s = exec_bfd->sections; s; s = s->next)
9777 if (!(s->flags & SEC_LOAD))
9778 continue; /* Skip non-loadable section. */
9780 if (read_only && (s->flags & SEC_READONLY) == 0)
9781 continue; /* Skip writeable sections */
9783 size = bfd_get_section_size (s);
9785 continue; /* Skip zero-length section. */
9787 sectname = bfd_get_section_name (exec_bfd, s);
9788 if (args && strcmp (args, sectname) != 0)
9789 continue; /* Not the section selected by user. */
9791 matched = 1; /* Do this section. */
9794 sectdata = (gdb_byte *) xmalloc (size);
9795 old_chain = make_cleanup (xfree, sectdata);
9796 bfd_get_section_contents (exec_bfd, s, sectdata, 0, size);
9798 res = target_verify_memory (sectdata, lma, size);
9801 error (_("target memory fault, section %s, range %s -- %s"), sectname,
9802 paddress (target_gdbarch (), lma),
9803 paddress (target_gdbarch (), lma + size));
9805 printf_filtered ("Section %s, range %s -- %s: ", sectname,
9806 paddress (target_gdbarch (), lma),
9807 paddress (target_gdbarch (), lma + size));
9809 printf_filtered ("matched.\n");
9812 printf_filtered ("MIS-MATCHED!\n");
9816 do_cleanups (old_chain);
9819 warning (_("One or more sections of the target image does not match\n\
9820 the loaded file\n"));
9821 if (args && !matched)
9822 printf_filtered (_("No loaded section named '%s'.\n"), args);
9825 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
9826 into remote target. The number of bytes written to the remote
9827 target is returned, or -1 for error. */
9829 static enum target_xfer_status
9830 remote_write_qxfer (struct target_ops *ops, const char *object_name,
9831 const char *annex, const gdb_byte *writebuf,
9832 ULONGEST offset, LONGEST len, ULONGEST *xfered_len,
9833 struct packet_config *packet)
9837 struct remote_state *rs = get_remote_state ();
9838 int max_size = get_memory_write_packet_size ();
9840 if (packet->support == PACKET_DISABLE)
9841 return TARGET_XFER_E_IO;
9843 /* Insert header. */
9844 i = snprintf (rs->buf, max_size,
9845 "qXfer:%s:write:%s:%s:",
9846 object_name, annex ? annex : "",
9847 phex_nz (offset, sizeof offset));
9848 max_size -= (i + 1);
9850 /* Escape as much data as fits into rs->buf. */
9851 buf_len = remote_escape_output
9852 (writebuf, len, 1, (gdb_byte *) rs->buf + i, &max_size, max_size);
9854 if (putpkt_binary (rs->buf, i + buf_len) < 0
9855 || getpkt_sane (&rs->buf, &rs->buf_size, 0) < 0
9856 || packet_ok (rs->buf, packet) != PACKET_OK)
9857 return TARGET_XFER_E_IO;
9859 unpack_varlen_hex (rs->buf, &n);
9862 return TARGET_XFER_OK;
9865 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
9866 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
9867 number of bytes read is returned, or 0 for EOF, or -1 for error.
9868 The number of bytes read may be less than LEN without indicating an
9869 EOF. PACKET is checked and updated to indicate whether the remote
9870 target supports this object. */
9872 static enum target_xfer_status
9873 remote_read_qxfer (struct target_ops *ops, const char *object_name,
9875 gdb_byte *readbuf, ULONGEST offset, LONGEST len,
9876 ULONGEST *xfered_len,
9877 struct packet_config *packet)
9879 struct remote_state *rs = get_remote_state ();
9880 LONGEST i, n, packet_len;
9882 if (packet->support == PACKET_DISABLE)
9883 return TARGET_XFER_E_IO;
9885 /* Check whether we've cached an end-of-object packet that matches
9887 if (rs->finished_object)
9889 if (strcmp (object_name, rs->finished_object) == 0
9890 && strcmp (annex ? annex : "", rs->finished_annex) == 0
9891 && offset == rs->finished_offset)
9892 return TARGET_XFER_EOF;
9895 /* Otherwise, we're now reading something different. Discard
9897 xfree (rs->finished_object);
9898 xfree (rs->finished_annex);
9899 rs->finished_object = NULL;
9900 rs->finished_annex = NULL;
9903 /* Request only enough to fit in a single packet. The actual data
9904 may not, since we don't know how much of it will need to be escaped;
9905 the target is free to respond with slightly less data. We subtract
9906 five to account for the response type and the protocol frame. */
9907 n = min (get_remote_packet_size () - 5, len);
9908 snprintf (rs->buf, get_remote_packet_size () - 4, "qXfer:%s:read:%s:%s,%s",
9909 object_name, annex ? annex : "",
9910 phex_nz (offset, sizeof offset),
9911 phex_nz (n, sizeof n));
9912 i = putpkt (rs->buf);
9914 return TARGET_XFER_E_IO;
9917 packet_len = getpkt_sane (&rs->buf, &rs->buf_size, 0);
9918 if (packet_len < 0 || packet_ok (rs->buf, packet) != PACKET_OK)
9919 return TARGET_XFER_E_IO;
9921 if (rs->buf[0] != 'l' && rs->buf[0] != 'm')
9922 error (_("Unknown remote qXfer reply: %s"), rs->buf);
9924 /* 'm' means there is (or at least might be) more data after this
9925 batch. That does not make sense unless there's at least one byte
9926 of data in this reply. */
9927 if (rs->buf[0] == 'm' && packet_len == 1)
9928 error (_("Remote qXfer reply contained no data."));
9930 /* Got some data. */
9931 i = remote_unescape_input ((gdb_byte *) rs->buf + 1,
9932 packet_len - 1, readbuf, n);
9934 /* 'l' is an EOF marker, possibly including a final block of data,
9935 or possibly empty. If we have the final block of a non-empty
9936 object, record this fact to bypass a subsequent partial read. */
9937 if (rs->buf[0] == 'l' && offset + i > 0)
9939 rs->finished_object = xstrdup (object_name);
9940 rs->finished_annex = xstrdup (annex ? annex : "");
9941 rs->finished_offset = offset + i;
9945 return TARGET_XFER_EOF;
9949 return TARGET_XFER_OK;
9953 static enum target_xfer_status
9954 remote_xfer_partial (struct target_ops *ops, enum target_object object,
9955 const char *annex, gdb_byte *readbuf,
9956 const gdb_byte *writebuf, ULONGEST offset, ULONGEST len,
9957 ULONGEST *xfered_len)
9959 struct remote_state *rs;
9963 int unit_size = gdbarch_addressable_memory_unit_size (target_gdbarch ());
9965 set_remote_traceframe ();
9966 set_general_thread (inferior_ptid);
9968 rs = get_remote_state ();
9970 /* Handle memory using the standard memory routines. */
9971 if (object == TARGET_OBJECT_MEMORY)
9973 /* If the remote target is connected but not running, we should
9974 pass this request down to a lower stratum (e.g. the executable
9976 if (!target_has_execution)
9977 return TARGET_XFER_EOF;
9979 if (writebuf != NULL)
9980 return remote_write_bytes (offset, writebuf, len, unit_size,
9983 return remote_read_bytes (ops, offset, readbuf, len, unit_size,
9987 /* Handle SPU memory using qxfer packets. */
9988 if (object == TARGET_OBJECT_SPU)
9991 return remote_read_qxfer (ops, "spu", annex, readbuf, offset, len,
9992 xfered_len, &remote_protocol_packets
9993 [PACKET_qXfer_spu_read]);
9995 return remote_write_qxfer (ops, "spu", annex, writebuf, offset, len,
9996 xfered_len, &remote_protocol_packets
9997 [PACKET_qXfer_spu_write]);
10000 /* Handle extra signal info using qxfer packets. */
10001 if (object == TARGET_OBJECT_SIGNAL_INFO)
10004 return remote_read_qxfer (ops, "siginfo", annex, readbuf, offset, len,
10005 xfered_len, &remote_protocol_packets
10006 [PACKET_qXfer_siginfo_read]);
10008 return remote_write_qxfer (ops, "siginfo", annex,
10009 writebuf, offset, len, xfered_len,
10010 &remote_protocol_packets
10011 [PACKET_qXfer_siginfo_write]);
10014 if (object == TARGET_OBJECT_STATIC_TRACE_DATA)
10017 return remote_read_qxfer (ops, "statictrace", annex,
10018 readbuf, offset, len, xfered_len,
10019 &remote_protocol_packets
10020 [PACKET_qXfer_statictrace_read]);
10022 return TARGET_XFER_E_IO;
10025 /* Only handle flash writes. */
10026 if (writebuf != NULL)
10030 case TARGET_OBJECT_FLASH:
10031 return remote_flash_write (ops, offset, len, xfered_len,
10035 return TARGET_XFER_E_IO;
10039 /* Map pre-existing objects onto letters. DO NOT do this for new
10040 objects!!! Instead specify new query packets. */
10043 case TARGET_OBJECT_AVR:
10047 case TARGET_OBJECT_AUXV:
10048 gdb_assert (annex == NULL);
10049 return remote_read_qxfer (ops, "auxv", annex, readbuf, offset, len,
10051 &remote_protocol_packets[PACKET_qXfer_auxv]);
10053 case TARGET_OBJECT_AVAILABLE_FEATURES:
10054 return remote_read_qxfer
10055 (ops, "features", annex, readbuf, offset, len, xfered_len,
10056 &remote_protocol_packets[PACKET_qXfer_features]);
10058 case TARGET_OBJECT_LIBRARIES:
10059 return remote_read_qxfer
10060 (ops, "libraries", annex, readbuf, offset, len, xfered_len,
10061 &remote_protocol_packets[PACKET_qXfer_libraries]);
10063 case TARGET_OBJECT_LIBRARIES_SVR4:
10064 return remote_read_qxfer
10065 (ops, "libraries-svr4", annex, readbuf, offset, len, xfered_len,
10066 &remote_protocol_packets[PACKET_qXfer_libraries_svr4]);
10068 case TARGET_OBJECT_MEMORY_MAP:
10069 gdb_assert (annex == NULL);
10070 return remote_read_qxfer (ops, "memory-map", annex, readbuf, offset, len,
10072 &remote_protocol_packets[PACKET_qXfer_memory_map]);
10074 case TARGET_OBJECT_OSDATA:
10075 /* Should only get here if we're connected. */
10076 gdb_assert (rs->remote_desc);
10077 return remote_read_qxfer
10078 (ops, "osdata", annex, readbuf, offset, len, xfered_len,
10079 &remote_protocol_packets[PACKET_qXfer_osdata]);
10081 case TARGET_OBJECT_THREADS:
10082 gdb_assert (annex == NULL);
10083 return remote_read_qxfer (ops, "threads", annex, readbuf, offset, len,
10085 &remote_protocol_packets[PACKET_qXfer_threads]);
10087 case TARGET_OBJECT_TRACEFRAME_INFO:
10088 gdb_assert (annex == NULL);
10089 return remote_read_qxfer
10090 (ops, "traceframe-info", annex, readbuf, offset, len, xfered_len,
10091 &remote_protocol_packets[PACKET_qXfer_traceframe_info]);
10093 case TARGET_OBJECT_FDPIC:
10094 return remote_read_qxfer (ops, "fdpic", annex, readbuf, offset, len,
10096 &remote_protocol_packets[PACKET_qXfer_fdpic]);
10098 case TARGET_OBJECT_OPENVMS_UIB:
10099 return remote_read_qxfer (ops, "uib", annex, readbuf, offset, len,
10101 &remote_protocol_packets[PACKET_qXfer_uib]);
10103 case TARGET_OBJECT_BTRACE:
10104 return remote_read_qxfer (ops, "btrace", annex, readbuf, offset, len,
10106 &remote_protocol_packets[PACKET_qXfer_btrace]);
10108 case TARGET_OBJECT_BTRACE_CONF:
10109 return remote_read_qxfer (ops, "btrace-conf", annex, readbuf, offset,
10111 &remote_protocol_packets[PACKET_qXfer_btrace_conf]);
10113 case TARGET_OBJECT_EXEC_FILE:
10114 return remote_read_qxfer (ops, "exec-file", annex, readbuf, offset,
10116 &remote_protocol_packets[PACKET_qXfer_exec_file]);
10119 return TARGET_XFER_E_IO;
10122 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
10123 large enough let the caller deal with it. */
10124 if (len < get_remote_packet_size ())
10125 return TARGET_XFER_E_IO;
10126 len = get_remote_packet_size ();
10128 /* Except for querying the minimum buffer size, target must be open. */
10129 if (!rs->remote_desc)
10130 error (_("remote query is only available after target open"));
10132 gdb_assert (annex != NULL);
10133 gdb_assert (readbuf != NULL);
10137 *p2++ = query_type;
10139 /* We used one buffer char for the remote protocol q command and
10140 another for the query type. As the remote protocol encapsulation
10141 uses 4 chars plus one extra in case we are debugging
10142 (remote_debug), we have PBUFZIZ - 7 left to pack the query
10145 while (annex[i] && (i < (get_remote_packet_size () - 8)))
10147 /* Bad caller may have sent forbidden characters. */
10148 gdb_assert (isprint (annex[i]) && annex[i] != '$' && annex[i] != '#');
10153 gdb_assert (annex[i] == '\0');
10155 i = putpkt (rs->buf);
10157 return TARGET_XFER_E_IO;
10159 getpkt (&rs->buf, &rs->buf_size, 0);
10160 strcpy ((char *) readbuf, rs->buf);
10162 *xfered_len = strlen ((char *) readbuf);
10163 return TARGET_XFER_OK;
10167 remote_search_memory (struct target_ops* ops,
10168 CORE_ADDR start_addr, ULONGEST search_space_len,
10169 const gdb_byte *pattern, ULONGEST pattern_len,
10170 CORE_ADDR *found_addrp)
10172 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
10173 struct remote_state *rs = get_remote_state ();
10174 int max_size = get_memory_write_packet_size ();
10175 struct packet_config *packet =
10176 &remote_protocol_packets[PACKET_qSearch_memory];
10177 /* Number of packet bytes used to encode the pattern;
10178 this could be more than PATTERN_LEN due to escape characters. */
10179 int escaped_pattern_len;
10180 /* Amount of pattern that was encodable in the packet. */
10181 int used_pattern_len;
10184 ULONGEST found_addr;
10186 /* Don't go to the target if we don't have to.
10187 This is done before checking packet->support to avoid the possibility that
10188 a success for this edge case means the facility works in general. */
10189 if (pattern_len > search_space_len)
10191 if (pattern_len == 0)
10193 *found_addrp = start_addr;
10197 /* If we already know the packet isn't supported, fall back to the simple
10198 way of searching memory. */
10200 if (packet_config_support (packet) == PACKET_DISABLE)
10202 /* Target doesn't provided special support, fall back and use the
10203 standard support (copy memory and do the search here). */
10204 return simple_search_memory (ops, start_addr, search_space_len,
10205 pattern, pattern_len, found_addrp);
10208 /* Make sure the remote is pointing at the right process. */
10209 set_general_process ();
10211 /* Insert header. */
10212 i = snprintf (rs->buf, max_size,
10213 "qSearch:memory:%s;%s;",
10214 phex_nz (start_addr, addr_size),
10215 phex_nz (search_space_len, sizeof (search_space_len)));
10216 max_size -= (i + 1);
10218 /* Escape as much data as fits into rs->buf. */
10219 escaped_pattern_len =
10220 remote_escape_output (pattern, pattern_len, 1, (gdb_byte *) rs->buf + i,
10221 &used_pattern_len, max_size);
10223 /* Bail if the pattern is too large. */
10224 if (used_pattern_len != pattern_len)
10225 error (_("Pattern is too large to transmit to remote target."));
10227 if (putpkt_binary (rs->buf, i + escaped_pattern_len) < 0
10228 || getpkt_sane (&rs->buf, &rs->buf_size, 0) < 0
10229 || packet_ok (rs->buf, packet) != PACKET_OK)
10231 /* The request may not have worked because the command is not
10232 supported. If so, fall back to the simple way. */
10233 if (packet->support == PACKET_DISABLE)
10235 return simple_search_memory (ops, start_addr, search_space_len,
10236 pattern, pattern_len, found_addrp);
10241 if (rs->buf[0] == '0')
10243 else if (rs->buf[0] == '1')
10246 if (rs->buf[1] != ',')
10247 error (_("Unknown qSearch:memory reply: %s"), rs->buf);
10248 unpack_varlen_hex (rs->buf + 2, &found_addr);
10249 *found_addrp = found_addr;
10252 error (_("Unknown qSearch:memory reply: %s"), rs->buf);
10258 remote_rcmd (struct target_ops *self, const char *command,
10259 struct ui_file *outbuf)
10261 struct remote_state *rs = get_remote_state ();
10264 if (!rs->remote_desc)
10265 error (_("remote rcmd is only available after target open"));
10267 /* Send a NULL command across as an empty command. */
10268 if (command == NULL)
10271 /* The query prefix. */
10272 strcpy (rs->buf, "qRcmd,");
10273 p = strchr (rs->buf, '\0');
10275 if ((strlen (rs->buf) + strlen (command) * 2 + 8/*misc*/)
10276 > get_remote_packet_size ())
10277 error (_("\"monitor\" command ``%s'' is too long."), command);
10279 /* Encode the actual command. */
10280 bin2hex ((const gdb_byte *) command, p, strlen (command));
10282 if (putpkt (rs->buf) < 0)
10283 error (_("Communication problem with target."));
10285 /* get/display the response */
10290 /* XXX - see also remote_get_noisy_reply(). */
10291 QUIT; /* Allow user to bail out with ^C. */
10293 if (getpkt_sane (&rs->buf, &rs->buf_size, 0) == -1)
10295 /* Timeout. Continue to (try to) read responses.
10296 This is better than stopping with an error, assuming the stub
10297 is still executing the (long) monitor command.
10298 If needed, the user can interrupt gdb using C-c, obtaining
10299 an effect similar to stop on timeout. */
10303 if (buf[0] == '\0')
10304 error (_("Target does not support this command."));
10305 if (buf[0] == 'O' && buf[1] != 'K')
10307 remote_console_output (buf + 1); /* 'O' message from stub. */
10310 if (strcmp (buf, "OK") == 0)
10312 if (strlen (buf) == 3 && buf[0] == 'E'
10313 && isdigit (buf[1]) && isdigit (buf[2]))
10315 error (_("Protocol error with Rcmd"));
10317 for (p = buf; p[0] != '\0' && p[1] != '\0'; p += 2)
10319 char c = (fromhex (p[0]) << 4) + fromhex (p[1]);
10321 fputc_unfiltered (c, outbuf);
10327 static VEC(mem_region_s) *
10328 remote_memory_map (struct target_ops *ops)
10330 VEC(mem_region_s) *result = NULL;
10331 char *text = target_read_stralloc (¤t_target,
10332 TARGET_OBJECT_MEMORY_MAP, NULL);
10336 struct cleanup *back_to = make_cleanup (xfree, text);
10338 result = parse_memory_map (text);
10339 do_cleanups (back_to);
10346 packet_command (char *args, int from_tty)
10348 struct remote_state *rs = get_remote_state ();
10350 if (!rs->remote_desc)
10351 error (_("command can only be used with remote target"));
10354 error (_("remote-packet command requires packet text as argument"));
10356 puts_filtered ("sending: ");
10357 print_packet (args);
10358 puts_filtered ("\n");
10361 getpkt (&rs->buf, &rs->buf_size, 0);
10362 puts_filtered ("received: ");
10363 print_packet (rs->buf);
10364 puts_filtered ("\n");
10368 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
10370 static void display_thread_info (struct gdb_ext_thread_info *info);
10372 static void threadset_test_cmd (char *cmd, int tty);
10374 static void threadalive_test (char *cmd, int tty);
10376 static void threadlist_test_cmd (char *cmd, int tty);
10378 int get_and_display_threadinfo (threadref *ref);
10380 static void threadinfo_test_cmd (char *cmd, int tty);
10382 static int thread_display_step (threadref *ref, void *context);
10384 static void threadlist_update_test_cmd (char *cmd, int tty);
10386 static void init_remote_threadtests (void);
10388 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
10391 threadset_test_cmd (char *cmd, int tty)
10393 int sample_thread = SAMPLE_THREAD;
10395 printf_filtered (_("Remote threadset test\n"));
10396 set_general_thread (sample_thread);
10401 threadalive_test (char *cmd, int tty)
10403 int sample_thread = SAMPLE_THREAD;
10404 int pid = ptid_get_pid (inferior_ptid);
10405 ptid_t ptid = ptid_build (pid, sample_thread, 0);
10407 if (remote_thread_alive (ptid))
10408 printf_filtered ("PASS: Thread alive test\n");
10410 printf_filtered ("FAIL: Thread alive test\n");
10413 void output_threadid (char *title, threadref *ref);
10416 output_threadid (char *title, threadref *ref)
10420 pack_threadid (&hexid[0], ref); /* Convert threead id into hex. */
10422 printf_filtered ("%s %s\n", title, (&hexid[0]));
10426 threadlist_test_cmd (char *cmd, int tty)
10429 threadref nextthread;
10430 int done, result_count;
10431 threadref threadlist[3];
10433 printf_filtered ("Remote Threadlist test\n");
10434 if (!remote_get_threadlist (startflag, &nextthread, 3, &done,
10435 &result_count, &threadlist[0]))
10436 printf_filtered ("FAIL: threadlist test\n");
10439 threadref *scan = threadlist;
10440 threadref *limit = scan + result_count;
10442 while (scan < limit)
10443 output_threadid (" thread ", scan++);
10448 display_thread_info (struct gdb_ext_thread_info *info)
10450 output_threadid ("Threadid: ", &info->threadid);
10451 printf_filtered ("Name: %s\n ", info->shortname);
10452 printf_filtered ("State: %s\n", info->display);
10453 printf_filtered ("other: %s\n\n", info->more_display);
10457 get_and_display_threadinfo (threadref *ref)
10461 struct gdb_ext_thread_info threadinfo;
10463 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
10464 | TAG_MOREDISPLAY | TAG_DISPLAY;
10465 if (0 != (result = remote_get_threadinfo (ref, set, &threadinfo)))
10466 display_thread_info (&threadinfo);
10471 threadinfo_test_cmd (char *cmd, int tty)
10473 int athread = SAMPLE_THREAD;
10477 int_to_threadref (&thread, athread);
10478 printf_filtered ("Remote Threadinfo test\n");
10479 if (!get_and_display_threadinfo (&thread))
10480 printf_filtered ("FAIL cannot get thread info\n");
10484 thread_display_step (threadref *ref, void *context)
10486 /* output_threadid(" threadstep ",ref); *//* simple test */
10487 return get_and_display_threadinfo (ref);
10491 threadlist_update_test_cmd (char *cmd, int tty)
10493 printf_filtered ("Remote Threadlist update test\n");
10494 remote_threadlist_iterator (thread_display_step, 0, CRAZY_MAX_THREADS);
10498 init_remote_threadtests (void)
10500 add_com ("tlist", class_obscure, threadlist_test_cmd,
10501 _("Fetch and print the remote list of "
10502 "thread identifiers, one pkt only"));
10503 add_com ("tinfo", class_obscure, threadinfo_test_cmd,
10504 _("Fetch and display info about one thread"));
10505 add_com ("tset", class_obscure, threadset_test_cmd,
10506 _("Test setting to a different thread"));
10507 add_com ("tupd", class_obscure, threadlist_update_test_cmd,
10508 _("Iterate through updating all remote thread info"));
10509 add_com ("talive", class_obscure, threadalive_test,
10510 _(" Remote thread alive test "));
10515 /* Convert a thread ID to a string. Returns the string in a static
10519 remote_pid_to_str (struct target_ops *ops, ptid_t ptid)
10521 static char buf[64];
10522 struct remote_state *rs = get_remote_state ();
10524 if (ptid_equal (ptid, null_ptid))
10525 return normal_pid_to_str (ptid);
10526 else if (ptid_is_pid (ptid))
10528 /* Printing an inferior target id. */
10530 /* When multi-process extensions are off, there's no way in the
10531 remote protocol to know the remote process id, if there's any
10532 at all. There's one exception --- when we're connected with
10533 target extended-remote, and we manually attached to a process
10534 with "attach PID". We don't record anywhere a flag that
10535 allows us to distinguish that case from the case of
10536 connecting with extended-remote and the stub already being
10537 attached to a process, and reporting yes to qAttached, hence
10538 no smart special casing here. */
10539 if (!remote_multi_process_p (rs))
10541 xsnprintf (buf, sizeof buf, "Remote target");
10545 return normal_pid_to_str (ptid);
10549 if (ptid_equal (magic_null_ptid, ptid))
10550 xsnprintf (buf, sizeof buf, "Thread <main>");
10551 else if (remote_multi_process_p (rs))
10552 if (ptid_get_lwp (ptid) == 0)
10553 return normal_pid_to_str (ptid);
10555 xsnprintf (buf, sizeof buf, "Thread %d.%ld",
10556 ptid_get_pid (ptid), ptid_get_lwp (ptid));
10558 xsnprintf (buf, sizeof buf, "Thread %ld",
10559 ptid_get_lwp (ptid));
10564 /* Get the address of the thread local variable in OBJFILE which is
10565 stored at OFFSET within the thread local storage for thread PTID. */
10568 remote_get_thread_local_address (struct target_ops *ops,
10569 ptid_t ptid, CORE_ADDR lm, CORE_ADDR offset)
10571 if (packet_support (PACKET_qGetTLSAddr) != PACKET_DISABLE)
10573 struct remote_state *rs = get_remote_state ();
10575 char *endp = rs->buf + get_remote_packet_size ();
10576 enum packet_result result;
10578 strcpy (p, "qGetTLSAddr:");
10580 p = write_ptid (p, endp, ptid);
10582 p += hexnumstr (p, offset);
10584 p += hexnumstr (p, lm);
10588 getpkt (&rs->buf, &rs->buf_size, 0);
10589 result = packet_ok (rs->buf,
10590 &remote_protocol_packets[PACKET_qGetTLSAddr]);
10591 if (result == PACKET_OK)
10595 unpack_varlen_hex (rs->buf, &result);
10598 else if (result == PACKET_UNKNOWN)
10599 throw_error (TLS_GENERIC_ERROR,
10600 _("Remote target doesn't support qGetTLSAddr packet"));
10602 throw_error (TLS_GENERIC_ERROR,
10603 _("Remote target failed to process qGetTLSAddr request"));
10606 throw_error (TLS_GENERIC_ERROR,
10607 _("TLS not supported or disabled on this target"));
10612 /* Provide thread local base, i.e. Thread Information Block address.
10613 Returns 1 if ptid is found and thread_local_base is non zero. */
10616 remote_get_tib_address (struct target_ops *self, ptid_t ptid, CORE_ADDR *addr)
10618 if (packet_support (PACKET_qGetTIBAddr) != PACKET_DISABLE)
10620 struct remote_state *rs = get_remote_state ();
10622 char *endp = rs->buf + get_remote_packet_size ();
10623 enum packet_result result;
10625 strcpy (p, "qGetTIBAddr:");
10627 p = write_ptid (p, endp, ptid);
10631 getpkt (&rs->buf, &rs->buf_size, 0);
10632 result = packet_ok (rs->buf,
10633 &remote_protocol_packets[PACKET_qGetTIBAddr]);
10634 if (result == PACKET_OK)
10638 unpack_varlen_hex (rs->buf, &result);
10640 *addr = (CORE_ADDR) result;
10643 else if (result == PACKET_UNKNOWN)
10644 error (_("Remote target doesn't support qGetTIBAddr packet"));
10646 error (_("Remote target failed to process qGetTIBAddr request"));
10649 error (_("qGetTIBAddr not supported or disabled on this target"));
10654 /* Support for inferring a target description based on the current
10655 architecture and the size of a 'g' packet. While the 'g' packet
10656 can have any size (since optional registers can be left off the
10657 end), some sizes are easily recognizable given knowledge of the
10658 approximate architecture. */
10660 struct remote_g_packet_guess
10663 const struct target_desc *tdesc;
10665 typedef struct remote_g_packet_guess remote_g_packet_guess_s;
10666 DEF_VEC_O(remote_g_packet_guess_s);
10668 struct remote_g_packet_data
10670 VEC(remote_g_packet_guess_s) *guesses;
10673 static struct gdbarch_data *remote_g_packet_data_handle;
10676 remote_g_packet_data_init (struct obstack *obstack)
10678 return OBSTACK_ZALLOC (obstack, struct remote_g_packet_data);
10682 register_remote_g_packet_guess (struct gdbarch *gdbarch, int bytes,
10683 const struct target_desc *tdesc)
10685 struct remote_g_packet_data *data
10686 = ((struct remote_g_packet_data *)
10687 gdbarch_data (gdbarch, remote_g_packet_data_handle));
10688 struct remote_g_packet_guess new_guess, *guess;
10691 gdb_assert (tdesc != NULL);
10694 VEC_iterate (remote_g_packet_guess_s, data->guesses, ix, guess);
10696 if (guess->bytes == bytes)
10697 internal_error (__FILE__, __LINE__,
10698 _("Duplicate g packet description added for size %d"),
10701 new_guess.bytes = bytes;
10702 new_guess.tdesc = tdesc;
10703 VEC_safe_push (remote_g_packet_guess_s, data->guesses, &new_guess);
10706 /* Return 1 if remote_read_description would do anything on this target
10707 and architecture, 0 otherwise. */
10710 remote_read_description_p (struct target_ops *target)
10712 struct remote_g_packet_data *data
10713 = ((struct remote_g_packet_data *)
10714 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle));
10716 if (!VEC_empty (remote_g_packet_guess_s, data->guesses))
10722 static const struct target_desc *
10723 remote_read_description (struct target_ops *target)
10725 struct remote_g_packet_data *data
10726 = ((struct remote_g_packet_data *)
10727 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle));
10729 /* Do not try this during initial connection, when we do not know
10730 whether there is a running but stopped thread. */
10731 if (!target_has_execution || ptid_equal (inferior_ptid, null_ptid))
10732 return target->beneath->to_read_description (target->beneath);
10734 if (!VEC_empty (remote_g_packet_guess_s, data->guesses))
10736 struct remote_g_packet_guess *guess;
10738 int bytes = send_g_packet ();
10741 VEC_iterate (remote_g_packet_guess_s, data->guesses, ix, guess);
10743 if (guess->bytes == bytes)
10744 return guess->tdesc;
10746 /* We discard the g packet. A minor optimization would be to
10747 hold on to it, and fill the register cache once we have selected
10748 an architecture, but it's too tricky to do safely. */
10751 return target->beneath->to_read_description (target->beneath);
10754 /* Remote file transfer support. This is host-initiated I/O, not
10755 target-initiated; for target-initiated, see remote-fileio.c. */
10757 /* If *LEFT is at least the length of STRING, copy STRING to
10758 *BUFFER, update *BUFFER to point to the new end of the buffer, and
10759 decrease *LEFT. Otherwise raise an error. */
10762 remote_buffer_add_string (char **buffer, int *left, char *string)
10764 int len = strlen (string);
10767 error (_("Packet too long for target."));
10769 memcpy (*buffer, string, len);
10773 /* NUL-terminate the buffer as a convenience, if there is
10779 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
10780 *BUFFER, update *BUFFER to point to the new end of the buffer, and
10781 decrease *LEFT. Otherwise raise an error. */
10784 remote_buffer_add_bytes (char **buffer, int *left, const gdb_byte *bytes,
10787 if (2 * len > *left)
10788 error (_("Packet too long for target."));
10790 bin2hex (bytes, *buffer, len);
10791 *buffer += 2 * len;
10794 /* NUL-terminate the buffer as a convenience, if there is
10800 /* If *LEFT is large enough, convert VALUE to hex and add it to
10801 *BUFFER, update *BUFFER to point to the new end of the buffer, and
10802 decrease *LEFT. Otherwise raise an error. */
10805 remote_buffer_add_int (char **buffer, int *left, ULONGEST value)
10807 int len = hexnumlen (value);
10810 error (_("Packet too long for target."));
10812 hexnumstr (*buffer, value);
10816 /* NUL-terminate the buffer as a convenience, if there is
10822 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
10823 value, *REMOTE_ERRNO to the remote error number or zero if none
10824 was included, and *ATTACHMENT to point to the start of the annex
10825 if any. The length of the packet isn't needed here; there may
10826 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
10828 Return 0 if the packet could be parsed, -1 if it could not. If
10829 -1 is returned, the other variables may not be initialized. */
10832 remote_hostio_parse_result (char *buffer, int *retcode,
10833 int *remote_errno, char **attachment)
10838 *attachment = NULL;
10840 if (buffer[0] != 'F')
10844 *retcode = strtol (&buffer[1], &p, 16);
10845 if (errno != 0 || p == &buffer[1])
10848 /* Check for ",errno". */
10852 *remote_errno = strtol (p + 1, &p2, 16);
10853 if (errno != 0 || p + 1 == p2)
10858 /* Check for ";attachment". If there is no attachment, the
10859 packet should end here. */
10862 *attachment = p + 1;
10865 else if (*p == '\0')
10871 /* Send a prepared I/O packet to the target and read its response.
10872 The prepared packet is in the global RS->BUF before this function
10873 is called, and the answer is there when we return.
10875 COMMAND_BYTES is the length of the request to send, which may include
10876 binary data. WHICH_PACKET is the packet configuration to check
10877 before attempting a packet. If an error occurs, *REMOTE_ERRNO
10878 is set to the error number and -1 is returned. Otherwise the value
10879 returned by the function is returned.
10881 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
10882 attachment is expected; an error will be reported if there's a
10883 mismatch. If one is found, *ATTACHMENT will be set to point into
10884 the packet buffer and *ATTACHMENT_LEN will be set to the
10885 attachment's length. */
10888 remote_hostio_send_command (int command_bytes, int which_packet,
10889 int *remote_errno, char **attachment,
10890 int *attachment_len)
10892 struct remote_state *rs = get_remote_state ();
10893 int ret, bytes_read;
10894 char *attachment_tmp;
10896 if (!rs->remote_desc
10897 || packet_support (which_packet) == PACKET_DISABLE)
10899 *remote_errno = FILEIO_ENOSYS;
10903 putpkt_binary (rs->buf, command_bytes);
10904 bytes_read = getpkt_sane (&rs->buf, &rs->buf_size, 0);
10906 /* If it timed out, something is wrong. Don't try to parse the
10908 if (bytes_read < 0)
10910 *remote_errno = FILEIO_EINVAL;
10914 switch (packet_ok (rs->buf, &remote_protocol_packets[which_packet]))
10917 *remote_errno = FILEIO_EINVAL;
10919 case PACKET_UNKNOWN:
10920 *remote_errno = FILEIO_ENOSYS;
10926 if (remote_hostio_parse_result (rs->buf, &ret, remote_errno,
10929 *remote_errno = FILEIO_EINVAL;
10933 /* Make sure we saw an attachment if and only if we expected one. */
10934 if ((attachment_tmp == NULL && attachment != NULL)
10935 || (attachment_tmp != NULL && attachment == NULL))
10937 *remote_errno = FILEIO_EINVAL;
10941 /* If an attachment was found, it must point into the packet buffer;
10942 work out how many bytes there were. */
10943 if (attachment_tmp != NULL)
10945 *attachment = attachment_tmp;
10946 *attachment_len = bytes_read - (*attachment - rs->buf);
10952 /* Invalidate the readahead cache. */
10955 readahead_cache_invalidate (void)
10957 struct remote_state *rs = get_remote_state ();
10959 rs->readahead_cache.fd = -1;
10962 /* Invalidate the readahead cache if it is holding data for FD. */
10965 readahead_cache_invalidate_fd (int fd)
10967 struct remote_state *rs = get_remote_state ();
10969 if (rs->readahead_cache.fd == fd)
10970 rs->readahead_cache.fd = -1;
10973 /* Set the filesystem remote_hostio functions that take FILENAME
10974 arguments will use. Return 0 on success, or -1 if an error
10975 occurs (and set *REMOTE_ERRNO). */
10978 remote_hostio_set_filesystem (struct inferior *inf, int *remote_errno)
10980 struct remote_state *rs = get_remote_state ();
10981 int required_pid = (inf == NULL || inf->fake_pid_p) ? 0 : inf->pid;
10983 int left = get_remote_packet_size () - 1;
10987 if (packet_support (PACKET_vFile_setfs) == PACKET_DISABLE)
10990 if (rs->fs_pid != -1 && required_pid == rs->fs_pid)
10993 remote_buffer_add_string (&p, &left, "vFile:setfs:");
10995 xsnprintf (arg, sizeof (arg), "%x", required_pid);
10996 remote_buffer_add_string (&p, &left, arg);
10998 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_setfs,
10999 remote_errno, NULL, NULL);
11001 if (packet_support (PACKET_vFile_setfs) == PACKET_DISABLE)
11005 rs->fs_pid = required_pid;
11010 /* Implementation of to_fileio_open. */
11013 remote_hostio_open (struct target_ops *self,
11014 struct inferior *inf, const char *filename,
11015 int flags, int mode, int warn_if_slow,
11018 struct remote_state *rs = get_remote_state ();
11020 int left = get_remote_packet_size () - 1;
11024 static int warning_issued = 0;
11026 printf_unfiltered (_("Reading %s from remote target...\n"),
11029 if (!warning_issued)
11031 warning (_("File transfers from remote targets can be slow."
11032 " Use \"set sysroot\" to access files locally"
11034 warning_issued = 1;
11038 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
11041 remote_buffer_add_string (&p, &left, "vFile:open:");
11043 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
11044 strlen (filename));
11045 remote_buffer_add_string (&p, &left, ",");
11047 remote_buffer_add_int (&p, &left, flags);
11048 remote_buffer_add_string (&p, &left, ",");
11050 remote_buffer_add_int (&p, &left, mode);
11052 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_open,
11053 remote_errno, NULL, NULL);
11056 /* Implementation of to_fileio_pwrite. */
11059 remote_hostio_pwrite (struct target_ops *self,
11060 int fd, const gdb_byte *write_buf, int len,
11061 ULONGEST offset, int *remote_errno)
11063 struct remote_state *rs = get_remote_state ();
11065 int left = get_remote_packet_size ();
11068 readahead_cache_invalidate_fd (fd);
11070 remote_buffer_add_string (&p, &left, "vFile:pwrite:");
11072 remote_buffer_add_int (&p, &left, fd);
11073 remote_buffer_add_string (&p, &left, ",");
11075 remote_buffer_add_int (&p, &left, offset);
11076 remote_buffer_add_string (&p, &left, ",");
11078 p += remote_escape_output (write_buf, len, 1, (gdb_byte *) p, &out_len,
11079 get_remote_packet_size () - (p - rs->buf));
11081 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_pwrite,
11082 remote_errno, NULL, NULL);
11085 /* Helper for the implementation of to_fileio_pread. Read the file
11086 from the remote side with vFile:pread. */
11089 remote_hostio_pread_vFile (struct target_ops *self,
11090 int fd, gdb_byte *read_buf, int len,
11091 ULONGEST offset, int *remote_errno)
11093 struct remote_state *rs = get_remote_state ();
11096 int left = get_remote_packet_size ();
11097 int ret, attachment_len;
11100 remote_buffer_add_string (&p, &left, "vFile:pread:");
11102 remote_buffer_add_int (&p, &left, fd);
11103 remote_buffer_add_string (&p, &left, ",");
11105 remote_buffer_add_int (&p, &left, len);
11106 remote_buffer_add_string (&p, &left, ",");
11108 remote_buffer_add_int (&p, &left, offset);
11110 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_pread,
11111 remote_errno, &attachment,
11117 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
11119 if (read_len != ret)
11120 error (_("Read returned %d, but %d bytes."), ret, (int) read_len);
11125 /* Serve pread from the readahead cache. Returns number of bytes
11126 read, or 0 if the request can't be served from the cache. */
11129 remote_hostio_pread_from_cache (struct remote_state *rs,
11130 int fd, gdb_byte *read_buf, size_t len,
11133 struct readahead_cache *cache = &rs->readahead_cache;
11135 if (cache->fd == fd
11136 && cache->offset <= offset
11137 && offset < cache->offset + cache->bufsize)
11139 ULONGEST max = cache->offset + cache->bufsize;
11141 if (offset + len > max)
11142 len = max - offset;
11144 memcpy (read_buf, cache->buf + offset - cache->offset, len);
11151 /* Implementation of to_fileio_pread. */
11154 remote_hostio_pread (struct target_ops *self,
11155 int fd, gdb_byte *read_buf, int len,
11156 ULONGEST offset, int *remote_errno)
11159 struct remote_state *rs = get_remote_state ();
11160 struct readahead_cache *cache = &rs->readahead_cache;
11162 ret = remote_hostio_pread_from_cache (rs, fd, read_buf, len, offset);
11165 cache->hit_count++;
11168 fprintf_unfiltered (gdb_stdlog, "readahead cache hit %s\n",
11169 pulongest (cache->hit_count));
11173 cache->miss_count++;
11175 fprintf_unfiltered (gdb_stdlog, "readahead cache miss %s\n",
11176 pulongest (cache->miss_count));
11179 cache->offset = offset;
11180 cache->bufsize = get_remote_packet_size ();
11181 cache->buf = (gdb_byte *) xrealloc (cache->buf, cache->bufsize);
11183 ret = remote_hostio_pread_vFile (self, cache->fd, cache->buf, cache->bufsize,
11184 cache->offset, remote_errno);
11187 readahead_cache_invalidate_fd (fd);
11191 cache->bufsize = ret;
11192 return remote_hostio_pread_from_cache (rs, fd, read_buf, len, offset);
11195 /* Implementation of to_fileio_close. */
11198 remote_hostio_close (struct target_ops *self, int fd, int *remote_errno)
11200 struct remote_state *rs = get_remote_state ();
11202 int left = get_remote_packet_size () - 1;
11204 readahead_cache_invalidate_fd (fd);
11206 remote_buffer_add_string (&p, &left, "vFile:close:");
11208 remote_buffer_add_int (&p, &left, fd);
11210 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_close,
11211 remote_errno, NULL, NULL);
11214 /* Implementation of to_fileio_unlink. */
11217 remote_hostio_unlink (struct target_ops *self,
11218 struct inferior *inf, const char *filename,
11221 struct remote_state *rs = get_remote_state ();
11223 int left = get_remote_packet_size () - 1;
11225 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
11228 remote_buffer_add_string (&p, &left, "vFile:unlink:");
11230 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
11231 strlen (filename));
11233 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_unlink,
11234 remote_errno, NULL, NULL);
11237 /* Implementation of to_fileio_readlink. */
11240 remote_hostio_readlink (struct target_ops *self,
11241 struct inferior *inf, const char *filename,
11244 struct remote_state *rs = get_remote_state ();
11247 int left = get_remote_packet_size ();
11248 int len, attachment_len;
11252 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
11255 remote_buffer_add_string (&p, &left, "vFile:readlink:");
11257 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
11258 strlen (filename));
11260 len = remote_hostio_send_command (p - rs->buf, PACKET_vFile_readlink,
11261 remote_errno, &attachment,
11267 ret = (char *) xmalloc (len + 1);
11269 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
11270 (gdb_byte *) ret, len);
11271 if (read_len != len)
11272 error (_("Readlink returned %d, but %d bytes."), len, read_len);
11278 /* Implementation of to_fileio_fstat. */
11281 remote_hostio_fstat (struct target_ops *self,
11282 int fd, struct stat *st,
11285 struct remote_state *rs = get_remote_state ();
11287 int left = get_remote_packet_size ();
11288 int attachment_len, ret;
11290 struct fio_stat fst;
11293 remote_buffer_add_string (&p, &left, "vFile:fstat:");
11295 remote_buffer_add_int (&p, &left, fd);
11297 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_fstat,
11298 remote_errno, &attachment,
11302 if (*remote_errno != FILEIO_ENOSYS)
11305 /* Strictly we should return -1, ENOSYS here, but when
11306 "set sysroot remote:" was implemented in August 2008
11307 BFD's need for a stat function was sidestepped with
11308 this hack. This was not remedied until March 2015
11309 so we retain the previous behavior to avoid breaking
11312 Note that the memset is a March 2015 addition; older
11313 GDBs set st_size *and nothing else* so the structure
11314 would have garbage in all other fields. This might
11315 break something but retaining the previous behavior
11316 here would be just too wrong. */
11318 memset (st, 0, sizeof (struct stat));
11319 st->st_size = INT_MAX;
11323 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
11324 (gdb_byte *) &fst, sizeof (fst));
11326 if (read_len != ret)
11327 error (_("vFile:fstat returned %d, but %d bytes."), ret, read_len);
11329 if (read_len != sizeof (fst))
11330 error (_("vFile:fstat returned %d bytes, but expecting %d."),
11331 read_len, (int) sizeof (fst));
11333 remote_fileio_to_host_stat (&fst, st);
11338 /* Implementation of to_filesystem_is_local. */
11341 remote_filesystem_is_local (struct target_ops *self)
11343 /* Valgrind GDB presents itself as a remote target but works
11344 on the local filesystem: it does not implement remote get
11345 and users are not expected to set a sysroot. To handle
11346 this case we treat the remote filesystem as local if the
11347 sysroot is exactly TARGET_SYSROOT_PREFIX and if the stub
11348 does not support vFile:open. */
11349 if (strcmp (gdb_sysroot, TARGET_SYSROOT_PREFIX) == 0)
11351 enum packet_support ps = packet_support (PACKET_vFile_open);
11353 if (ps == PACKET_SUPPORT_UNKNOWN)
11355 int fd, remote_errno;
11357 /* Try opening a file to probe support. The supplied
11358 filename is irrelevant, we only care about whether
11359 the stub recognizes the packet or not. */
11360 fd = remote_hostio_open (self, NULL, "just probing",
11361 FILEIO_O_RDONLY, 0700, 0,
11365 remote_hostio_close (self, fd, &remote_errno);
11367 ps = packet_support (PACKET_vFile_open);
11370 if (ps == PACKET_DISABLE)
11372 static int warning_issued = 0;
11374 if (!warning_issued)
11376 warning (_("remote target does not support file"
11377 " transfer, attempting to access files"
11378 " from local filesystem."));
11379 warning_issued = 1;
11390 remote_fileio_errno_to_host (int errnum)
11396 case FILEIO_ENOENT:
11404 case FILEIO_EACCES:
11406 case FILEIO_EFAULT:
11410 case FILEIO_EEXIST:
11412 case FILEIO_ENODEV:
11414 case FILEIO_ENOTDIR:
11416 case FILEIO_EISDIR:
11418 case FILEIO_EINVAL:
11420 case FILEIO_ENFILE:
11422 case FILEIO_EMFILE:
11426 case FILEIO_ENOSPC:
11428 case FILEIO_ESPIPE:
11432 case FILEIO_ENOSYS:
11434 case FILEIO_ENAMETOOLONG:
11435 return ENAMETOOLONG;
11441 remote_hostio_error (int errnum)
11443 int host_error = remote_fileio_errno_to_host (errnum);
11445 if (host_error == -1)
11446 error (_("Unknown remote I/O error %d"), errnum);
11448 error (_("Remote I/O error: %s"), safe_strerror (host_error));
11452 remote_hostio_close_cleanup (void *opaque)
11454 int fd = *(int *) opaque;
11457 remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno);
11461 remote_file_put (const char *local_file, const char *remote_file, int from_tty)
11463 struct cleanup *back_to, *close_cleanup;
11464 int retcode, fd, remote_errno, bytes, io_size;
11467 int bytes_in_buffer;
11470 struct remote_state *rs = get_remote_state ();
11472 if (!rs->remote_desc)
11473 error (_("command can only be used with remote target"));
11475 file = gdb_fopen_cloexec (local_file, "rb");
11477 perror_with_name (local_file);
11478 back_to = make_cleanup_fclose (file);
11480 fd = remote_hostio_open (find_target_at (process_stratum), NULL,
11481 remote_file, (FILEIO_O_WRONLY | FILEIO_O_CREAT
11483 0700, 0, &remote_errno);
11485 remote_hostio_error (remote_errno);
11487 /* Send up to this many bytes at once. They won't all fit in the
11488 remote packet limit, so we'll transfer slightly fewer. */
11489 io_size = get_remote_packet_size ();
11490 buffer = (gdb_byte *) xmalloc (io_size);
11491 make_cleanup (xfree, buffer);
11493 close_cleanup = make_cleanup (remote_hostio_close_cleanup, &fd);
11495 bytes_in_buffer = 0;
11498 while (bytes_in_buffer || !saw_eof)
11502 bytes = fread (buffer + bytes_in_buffer, 1,
11503 io_size - bytes_in_buffer,
11508 error (_("Error reading %s."), local_file);
11511 /* EOF. Unless there is something still in the
11512 buffer from the last iteration, we are done. */
11514 if (bytes_in_buffer == 0)
11522 bytes += bytes_in_buffer;
11523 bytes_in_buffer = 0;
11525 retcode = remote_hostio_pwrite (find_target_at (process_stratum),
11527 offset, &remote_errno);
11530 remote_hostio_error (remote_errno);
11531 else if (retcode == 0)
11532 error (_("Remote write of %d bytes returned 0!"), bytes);
11533 else if (retcode < bytes)
11535 /* Short write. Save the rest of the read data for the next
11537 bytes_in_buffer = bytes - retcode;
11538 memmove (buffer, buffer + retcode, bytes_in_buffer);
11544 discard_cleanups (close_cleanup);
11545 if (remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno))
11546 remote_hostio_error (remote_errno);
11549 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file);
11550 do_cleanups (back_to);
11554 remote_file_get (const char *remote_file, const char *local_file, int from_tty)
11556 struct cleanup *back_to, *close_cleanup;
11557 int fd, remote_errno, bytes, io_size;
11561 struct remote_state *rs = get_remote_state ();
11563 if (!rs->remote_desc)
11564 error (_("command can only be used with remote target"));
11566 fd = remote_hostio_open (find_target_at (process_stratum), NULL,
11567 remote_file, FILEIO_O_RDONLY, 0, 0,
11570 remote_hostio_error (remote_errno);
11572 file = gdb_fopen_cloexec (local_file, "wb");
11574 perror_with_name (local_file);
11575 back_to = make_cleanup_fclose (file);
11577 /* Send up to this many bytes at once. They won't all fit in the
11578 remote packet limit, so we'll transfer slightly fewer. */
11579 io_size = get_remote_packet_size ();
11580 buffer = (gdb_byte *) xmalloc (io_size);
11581 make_cleanup (xfree, buffer);
11583 close_cleanup = make_cleanup (remote_hostio_close_cleanup, &fd);
11588 bytes = remote_hostio_pread (find_target_at (process_stratum),
11589 fd, buffer, io_size, offset, &remote_errno);
11591 /* Success, but no bytes, means end-of-file. */
11594 remote_hostio_error (remote_errno);
11598 bytes = fwrite (buffer, 1, bytes, file);
11600 perror_with_name (local_file);
11603 discard_cleanups (close_cleanup);
11604 if (remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno))
11605 remote_hostio_error (remote_errno);
11608 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file);
11609 do_cleanups (back_to);
11613 remote_file_delete (const char *remote_file, int from_tty)
11615 int retcode, remote_errno;
11616 struct remote_state *rs = get_remote_state ();
11618 if (!rs->remote_desc)
11619 error (_("command can only be used with remote target"));
11621 retcode = remote_hostio_unlink (find_target_at (process_stratum),
11622 NULL, remote_file, &remote_errno);
11624 remote_hostio_error (remote_errno);
11627 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file);
11631 remote_put_command (char *args, int from_tty)
11633 struct cleanup *back_to;
11637 error_no_arg (_("file to put"));
11639 argv = gdb_buildargv (args);
11640 back_to = make_cleanup_freeargv (argv);
11641 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
11642 error (_("Invalid parameters to remote put"));
11644 remote_file_put (argv[0], argv[1], from_tty);
11646 do_cleanups (back_to);
11650 remote_get_command (char *args, int from_tty)
11652 struct cleanup *back_to;
11656 error_no_arg (_("file to get"));
11658 argv = gdb_buildargv (args);
11659 back_to = make_cleanup_freeargv (argv);
11660 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
11661 error (_("Invalid parameters to remote get"));
11663 remote_file_get (argv[0], argv[1], from_tty);
11665 do_cleanups (back_to);
11669 remote_delete_command (char *args, int from_tty)
11671 struct cleanup *back_to;
11675 error_no_arg (_("file to delete"));
11677 argv = gdb_buildargv (args);
11678 back_to = make_cleanup_freeargv (argv);
11679 if (argv[0] == NULL || argv[1] != NULL)
11680 error (_("Invalid parameters to remote delete"));
11682 remote_file_delete (argv[0], from_tty);
11684 do_cleanups (back_to);
11688 remote_command (char *args, int from_tty)
11690 help_list (remote_cmdlist, "remote ", all_commands, gdb_stdout);
11694 remote_can_execute_reverse (struct target_ops *self)
11696 if (packet_support (PACKET_bs) == PACKET_ENABLE
11697 || packet_support (PACKET_bc) == PACKET_ENABLE)
11704 remote_supports_non_stop (struct target_ops *self)
11710 remote_supports_disable_randomization (struct target_ops *self)
11712 /* Only supported in extended mode. */
11717 remote_supports_multi_process (struct target_ops *self)
11719 struct remote_state *rs = get_remote_state ();
11721 return remote_multi_process_p (rs);
11725 remote_supports_cond_tracepoints (void)
11727 return packet_support (PACKET_ConditionalTracepoints) == PACKET_ENABLE;
11731 remote_supports_cond_breakpoints (struct target_ops *self)
11733 return packet_support (PACKET_ConditionalBreakpoints) == PACKET_ENABLE;
11737 remote_supports_fast_tracepoints (void)
11739 return packet_support (PACKET_FastTracepoints) == PACKET_ENABLE;
11743 remote_supports_static_tracepoints (void)
11745 return packet_support (PACKET_StaticTracepoints) == PACKET_ENABLE;
11749 remote_supports_install_in_trace (void)
11751 return packet_support (PACKET_InstallInTrace) == PACKET_ENABLE;
11755 remote_supports_enable_disable_tracepoint (struct target_ops *self)
11757 return (packet_support (PACKET_EnableDisableTracepoints_feature)
11762 remote_supports_string_tracing (struct target_ops *self)
11764 return packet_support (PACKET_tracenz_feature) == PACKET_ENABLE;
11768 remote_can_run_breakpoint_commands (struct target_ops *self)
11770 return packet_support (PACKET_BreakpointCommands) == PACKET_ENABLE;
11774 remote_trace_init (struct target_ops *self)
11777 remote_get_noisy_reply (&target_buf, &target_buf_size);
11778 if (strcmp (target_buf, "OK") != 0)
11779 error (_("Target does not support this command."));
11782 static void free_actions_list (char **actions_list);
11783 static void free_actions_list_cleanup_wrapper (void *);
11785 free_actions_list_cleanup_wrapper (void *al)
11787 free_actions_list ((char **) al);
11791 free_actions_list (char **actions_list)
11795 if (actions_list == 0)
11798 for (ndx = 0; actions_list[ndx]; ndx++)
11799 xfree (actions_list[ndx]);
11801 xfree (actions_list);
11804 /* Recursive routine to walk through command list including loops, and
11805 download packets for each command. */
11808 remote_download_command_source (int num, ULONGEST addr,
11809 struct command_line *cmds)
11811 struct remote_state *rs = get_remote_state ();
11812 struct command_line *cmd;
11814 for (cmd = cmds; cmd; cmd = cmd->next)
11816 QUIT; /* Allow user to bail out with ^C. */
11817 strcpy (rs->buf, "QTDPsrc:");
11818 encode_source_string (num, addr, "cmd", cmd->line,
11819 rs->buf + strlen (rs->buf),
11820 rs->buf_size - strlen (rs->buf));
11822 remote_get_noisy_reply (&target_buf, &target_buf_size);
11823 if (strcmp (target_buf, "OK"))
11824 warning (_("Target does not support source download."));
11826 if (cmd->control_type == while_control
11827 || cmd->control_type == while_stepping_control)
11829 remote_download_command_source (num, addr, *cmd->body_list);
11831 QUIT; /* Allow user to bail out with ^C. */
11832 strcpy (rs->buf, "QTDPsrc:");
11833 encode_source_string (num, addr, "cmd", "end",
11834 rs->buf + strlen (rs->buf),
11835 rs->buf_size - strlen (rs->buf));
11837 remote_get_noisy_reply (&target_buf, &target_buf_size);
11838 if (strcmp (target_buf, "OK"))
11839 warning (_("Target does not support source download."));
11845 remote_download_tracepoint (struct target_ops *self, struct bp_location *loc)
11847 #define BUF_SIZE 2048
11851 char buf[BUF_SIZE];
11852 char **tdp_actions;
11853 char **stepping_actions;
11855 struct cleanup *old_chain = NULL;
11856 struct agent_expr *aexpr;
11857 struct cleanup *aexpr_chain = NULL;
11859 struct breakpoint *b = loc->owner;
11860 struct tracepoint *t = (struct tracepoint *) b;
11862 encode_actions_rsp (loc, &tdp_actions, &stepping_actions);
11863 old_chain = make_cleanup (free_actions_list_cleanup_wrapper,
11865 (void) make_cleanup (free_actions_list_cleanup_wrapper,
11868 tpaddr = loc->address;
11869 sprintf_vma (addrbuf, tpaddr);
11870 xsnprintf (buf, BUF_SIZE, "QTDP:%x:%s:%c:%lx:%x", b->number,
11871 addrbuf, /* address */
11872 (b->enable_state == bp_enabled ? 'E' : 'D'),
11873 t->step_count, t->pass_count);
11874 /* Fast tracepoints are mostly handled by the target, but we can
11875 tell the target how big of an instruction block should be moved
11877 if (b->type == bp_fast_tracepoint)
11879 /* Only test for support at download time; we may not know
11880 target capabilities at definition time. */
11881 if (remote_supports_fast_tracepoints ())
11883 if (gdbarch_fast_tracepoint_valid_at (loc->gdbarch, tpaddr,
11885 xsnprintf (buf + strlen (buf), BUF_SIZE - strlen (buf), ":F%x",
11886 gdb_insn_length (loc->gdbarch, tpaddr));
11888 /* If it passed validation at definition but fails now,
11889 something is very wrong. */
11890 internal_error (__FILE__, __LINE__,
11891 _("Fast tracepoint not "
11892 "valid during download"));
11895 /* Fast tracepoints are functionally identical to regular
11896 tracepoints, so don't take lack of support as a reason to
11897 give up on the trace run. */
11898 warning (_("Target does not support fast tracepoints, "
11899 "downloading %d as regular tracepoint"), b->number);
11901 else if (b->type == bp_static_tracepoint)
11903 /* Only test for support at download time; we may not know
11904 target capabilities at definition time. */
11905 if (remote_supports_static_tracepoints ())
11907 struct static_tracepoint_marker marker;
11909 if (target_static_tracepoint_marker_at (tpaddr, &marker))
11910 strcat (buf, ":S");
11912 error (_("Static tracepoint not valid during download"));
11915 /* Fast tracepoints are functionally identical to regular
11916 tracepoints, so don't take lack of support as a reason
11917 to give up on the trace run. */
11918 error (_("Target does not support static tracepoints"));
11920 /* If the tracepoint has a conditional, make it into an agent
11921 expression and append to the definition. */
11924 /* Only test support at download time, we may not know target
11925 capabilities at definition time. */
11926 if (remote_supports_cond_tracepoints ())
11928 aexpr = gen_eval_for_expr (tpaddr, loc->cond);
11929 aexpr_chain = make_cleanup_free_agent_expr (aexpr);
11930 xsnprintf (buf + strlen (buf), BUF_SIZE - strlen (buf), ":X%x,",
11932 pkt = buf + strlen (buf);
11933 for (ndx = 0; ndx < aexpr->len; ++ndx)
11934 pkt = pack_hex_byte (pkt, aexpr->buf[ndx]);
11936 do_cleanups (aexpr_chain);
11939 warning (_("Target does not support conditional tracepoints, "
11940 "ignoring tp %d cond"), b->number);
11943 if (b->commands || *default_collect)
11946 remote_get_noisy_reply (&target_buf, &target_buf_size);
11947 if (strcmp (target_buf, "OK"))
11948 error (_("Target does not support tracepoints."));
11950 /* do_single_steps (t); */
11953 for (ndx = 0; tdp_actions[ndx]; ndx++)
11955 QUIT; /* Allow user to bail out with ^C. */
11956 xsnprintf (buf, BUF_SIZE, "QTDP:-%x:%s:%s%c",
11957 b->number, addrbuf, /* address */
11959 ((tdp_actions[ndx + 1] || stepping_actions)
11962 remote_get_noisy_reply (&target_buf,
11964 if (strcmp (target_buf, "OK"))
11965 error (_("Error on target while setting tracepoints."));
11968 if (stepping_actions)
11970 for (ndx = 0; stepping_actions[ndx]; ndx++)
11972 QUIT; /* Allow user to bail out with ^C. */
11973 xsnprintf (buf, BUF_SIZE, "QTDP:-%x:%s:%s%s%s",
11974 b->number, addrbuf, /* address */
11975 ((ndx == 0) ? "S" : ""),
11976 stepping_actions[ndx],
11977 (stepping_actions[ndx + 1] ? "-" : ""));
11979 remote_get_noisy_reply (&target_buf,
11981 if (strcmp (target_buf, "OK"))
11982 error (_("Error on target while setting tracepoints."));
11986 if (packet_support (PACKET_TracepointSource) == PACKET_ENABLE)
11988 if (b->location != NULL)
11990 strcpy (buf, "QTDPsrc:");
11991 encode_source_string (b->number, loc->address, "at",
11992 event_location_to_string (b->location),
11993 buf + strlen (buf), 2048 - strlen (buf));
11995 remote_get_noisy_reply (&target_buf, &target_buf_size);
11996 if (strcmp (target_buf, "OK"))
11997 warning (_("Target does not support source download."));
11999 if (b->cond_string)
12001 strcpy (buf, "QTDPsrc:");
12002 encode_source_string (b->number, loc->address,
12003 "cond", b->cond_string, buf + strlen (buf),
12004 2048 - strlen (buf));
12006 remote_get_noisy_reply (&target_buf, &target_buf_size);
12007 if (strcmp (target_buf, "OK"))
12008 warning (_("Target does not support source download."));
12010 remote_download_command_source (b->number, loc->address,
12011 breakpoint_commands (b));
12014 do_cleanups (old_chain);
12018 remote_can_download_tracepoint (struct target_ops *self)
12020 struct remote_state *rs = get_remote_state ();
12021 struct trace_status *ts;
12024 /* Don't try to install tracepoints until we've relocated our
12025 symbols, and fetched and merged the target's tracepoint list with
12027 if (rs->starting_up)
12030 ts = current_trace_status ();
12031 status = remote_get_trace_status (self, ts);
12033 if (status == -1 || !ts->running_known || !ts->running)
12036 /* If we are in a tracing experiment, but remote stub doesn't support
12037 installing tracepoint in trace, we have to return. */
12038 if (!remote_supports_install_in_trace ())
12046 remote_download_trace_state_variable (struct target_ops *self,
12047 struct trace_state_variable *tsv)
12049 struct remote_state *rs = get_remote_state ();
12052 xsnprintf (rs->buf, get_remote_packet_size (), "QTDV:%x:%s:%x:",
12053 tsv->number, phex ((ULONGEST) tsv->initial_value, 8),
12055 p = rs->buf + strlen (rs->buf);
12056 if ((p - rs->buf) + strlen (tsv->name) * 2 >= get_remote_packet_size ())
12057 error (_("Trace state variable name too long for tsv definition packet"));
12058 p += 2 * bin2hex ((gdb_byte *) (tsv->name), p, strlen (tsv->name));
12061 remote_get_noisy_reply (&target_buf, &target_buf_size);
12062 if (*target_buf == '\0')
12063 error (_("Target does not support this command."));
12064 if (strcmp (target_buf, "OK") != 0)
12065 error (_("Error on target while downloading trace state variable."));
12069 remote_enable_tracepoint (struct target_ops *self,
12070 struct bp_location *location)
12072 struct remote_state *rs = get_remote_state ();
12075 sprintf_vma (addr_buf, location->address);
12076 xsnprintf (rs->buf, get_remote_packet_size (), "QTEnable:%x:%s",
12077 location->owner->number, addr_buf);
12079 remote_get_noisy_reply (&rs->buf, &rs->buf_size);
12080 if (*rs->buf == '\0')
12081 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
12082 if (strcmp (rs->buf, "OK") != 0)
12083 error (_("Error on target while enabling tracepoint."));
12087 remote_disable_tracepoint (struct target_ops *self,
12088 struct bp_location *location)
12090 struct remote_state *rs = get_remote_state ();
12093 sprintf_vma (addr_buf, location->address);
12094 xsnprintf (rs->buf, get_remote_packet_size (), "QTDisable:%x:%s",
12095 location->owner->number, addr_buf);
12097 remote_get_noisy_reply (&rs->buf, &rs->buf_size);
12098 if (*rs->buf == '\0')
12099 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
12100 if (strcmp (rs->buf, "OK") != 0)
12101 error (_("Error on target while disabling tracepoint."));
12105 remote_trace_set_readonly_regions (struct target_ops *self)
12109 bfd_size_type size;
12115 return; /* No information to give. */
12117 strcpy (target_buf, "QTro");
12118 offset = strlen (target_buf);
12119 for (s = exec_bfd->sections; s; s = s->next)
12121 char tmp1[40], tmp2[40];
12124 if ((s->flags & SEC_LOAD) == 0 ||
12125 /* (s->flags & SEC_CODE) == 0 || */
12126 (s->flags & SEC_READONLY) == 0)
12130 vma = bfd_get_section_vma (abfd, s);
12131 size = bfd_get_section_size (s);
12132 sprintf_vma (tmp1, vma);
12133 sprintf_vma (tmp2, vma + size);
12134 sec_length = 1 + strlen (tmp1) + 1 + strlen (tmp2);
12135 if (offset + sec_length + 1 > target_buf_size)
12137 if (packet_support (PACKET_qXfer_traceframe_info) != PACKET_ENABLE)
12139 Too many sections for read-only sections definition packet."));
12142 xsnprintf (target_buf + offset, target_buf_size - offset, ":%s,%s",
12144 offset += sec_length;
12148 putpkt (target_buf);
12149 getpkt (&target_buf, &target_buf_size, 0);
12154 remote_trace_start (struct target_ops *self)
12156 putpkt ("QTStart");
12157 remote_get_noisy_reply (&target_buf, &target_buf_size);
12158 if (*target_buf == '\0')
12159 error (_("Target does not support this command."));
12160 if (strcmp (target_buf, "OK") != 0)
12161 error (_("Bogus reply from target: %s"), target_buf);
12165 remote_get_trace_status (struct target_ops *self, struct trace_status *ts)
12167 /* Initialize it just to avoid a GCC false warning. */
12169 /* FIXME we need to get register block size some other way. */
12170 extern int trace_regblock_size;
12171 enum packet_result result;
12173 if (packet_support (PACKET_qTStatus) == PACKET_DISABLE)
12176 trace_regblock_size = get_remote_arch_state ()->sizeof_g_packet;
12178 putpkt ("qTStatus");
12182 p = remote_get_noisy_reply (&target_buf, &target_buf_size);
12184 CATCH (ex, RETURN_MASK_ERROR)
12186 if (ex.error != TARGET_CLOSE_ERROR)
12188 exception_fprintf (gdb_stderr, ex, "qTStatus: ");
12191 throw_exception (ex);
12195 result = packet_ok (p, &remote_protocol_packets[PACKET_qTStatus]);
12197 /* If the remote target doesn't do tracing, flag it. */
12198 if (result == PACKET_UNKNOWN)
12201 /* We're working with a live target. */
12202 ts->filename = NULL;
12205 error (_("Bogus trace status reply from target: %s"), target_buf);
12207 /* Function 'parse_trace_status' sets default value of each field of
12208 'ts' at first, so we don't have to do it here. */
12209 parse_trace_status (p, ts);
12211 return ts->running;
12215 remote_get_tracepoint_status (struct target_ops *self, struct breakpoint *bp,
12216 struct uploaded_tp *utp)
12218 struct remote_state *rs = get_remote_state ();
12220 struct bp_location *loc;
12221 struct tracepoint *tp = (struct tracepoint *) bp;
12222 size_t size = get_remote_packet_size ();
12226 tp->base.hit_count = 0;
12227 tp->traceframe_usage = 0;
12228 for (loc = tp->base.loc; loc; loc = loc->next)
12230 /* If the tracepoint was never downloaded, don't go asking for
12232 if (tp->number_on_target == 0)
12234 xsnprintf (rs->buf, size, "qTP:%x:%s", tp->number_on_target,
12235 phex_nz (loc->address, 0));
12237 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12238 if (reply && *reply)
12241 parse_tracepoint_status (reply + 1, bp, utp);
12247 utp->hit_count = 0;
12248 utp->traceframe_usage = 0;
12249 xsnprintf (rs->buf, size, "qTP:%x:%s", utp->number,
12250 phex_nz (utp->addr, 0));
12252 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12253 if (reply && *reply)
12256 parse_tracepoint_status (reply + 1, bp, utp);
12262 remote_trace_stop (struct target_ops *self)
12265 remote_get_noisy_reply (&target_buf, &target_buf_size);
12266 if (*target_buf == '\0')
12267 error (_("Target does not support this command."));
12268 if (strcmp (target_buf, "OK") != 0)
12269 error (_("Bogus reply from target: %s"), target_buf);
12273 remote_trace_find (struct target_ops *self,
12274 enum trace_find_type type, int num,
12275 CORE_ADDR addr1, CORE_ADDR addr2,
12278 struct remote_state *rs = get_remote_state ();
12279 char *endbuf = rs->buf + get_remote_packet_size ();
12281 int target_frameno = -1, target_tracept = -1;
12283 /* Lookups other than by absolute frame number depend on the current
12284 trace selected, so make sure it is correct on the remote end
12286 if (type != tfind_number)
12287 set_remote_traceframe ();
12290 strcpy (p, "QTFrame:");
12291 p = strchr (p, '\0');
12295 xsnprintf (p, endbuf - p, "%x", num);
12298 xsnprintf (p, endbuf - p, "pc:%s", phex_nz (addr1, 0));
12301 xsnprintf (p, endbuf - p, "tdp:%x", num);
12304 xsnprintf (p, endbuf - p, "range:%s:%s", phex_nz (addr1, 0),
12305 phex_nz (addr2, 0));
12307 case tfind_outside:
12308 xsnprintf (p, endbuf - p, "outside:%s:%s", phex_nz (addr1, 0),
12309 phex_nz (addr2, 0));
12312 error (_("Unknown trace find type %d"), type);
12316 reply = remote_get_noisy_reply (&(rs->buf), &rs->buf_size);
12317 if (*reply == '\0')
12318 error (_("Target does not support this command."));
12320 while (reply && *reply)
12325 target_frameno = (int) strtol (p, &reply, 16);
12327 error (_("Unable to parse trace frame number"));
12328 /* Don't update our remote traceframe number cache on failure
12329 to select a remote traceframe. */
12330 if (target_frameno == -1)
12335 target_tracept = (int) strtol (p, &reply, 16);
12337 error (_("Unable to parse tracepoint number"));
12339 case 'O': /* "OK"? */
12340 if (reply[1] == 'K' && reply[2] == '\0')
12343 error (_("Bogus reply from target: %s"), reply);
12346 error (_("Bogus reply from target: %s"), reply);
12349 *tpp = target_tracept;
12351 rs->remote_traceframe_number = target_frameno;
12352 return target_frameno;
12356 remote_get_trace_state_variable_value (struct target_ops *self,
12357 int tsvnum, LONGEST *val)
12359 struct remote_state *rs = get_remote_state ();
12363 set_remote_traceframe ();
12365 xsnprintf (rs->buf, get_remote_packet_size (), "qTV:%x", tsvnum);
12367 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12368 if (reply && *reply)
12372 unpack_varlen_hex (reply + 1, &uval);
12373 *val = (LONGEST) uval;
12381 remote_save_trace_data (struct target_ops *self, const char *filename)
12383 struct remote_state *rs = get_remote_state ();
12387 strcpy (p, "QTSave:");
12389 if ((p - rs->buf) + strlen (filename) * 2 >= get_remote_packet_size ())
12390 error (_("Remote file name too long for trace save packet"));
12391 p += 2 * bin2hex ((gdb_byte *) filename, p, strlen (filename));
12394 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12395 if (*reply == '\0')
12396 error (_("Target does not support this command."));
12397 if (strcmp (reply, "OK") != 0)
12398 error (_("Bogus reply from target: %s"), reply);
12402 /* This is basically a memory transfer, but needs to be its own packet
12403 because we don't know how the target actually organizes its trace
12404 memory, plus we want to be able to ask for as much as possible, but
12405 not be unhappy if we don't get as much as we ask for. */
12408 remote_get_raw_trace_data (struct target_ops *self,
12409 gdb_byte *buf, ULONGEST offset, LONGEST len)
12411 struct remote_state *rs = get_remote_state ();
12417 strcpy (p, "qTBuffer:");
12419 p += hexnumstr (p, offset);
12421 p += hexnumstr (p, len);
12425 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12426 if (reply && *reply)
12428 /* 'l' by itself means we're at the end of the buffer and
12429 there is nothing more to get. */
12433 /* Convert the reply into binary. Limit the number of bytes to
12434 convert according to our passed-in buffer size, rather than
12435 what was returned in the packet; if the target is
12436 unexpectedly generous and gives us a bigger reply than we
12437 asked for, we don't want to crash. */
12438 rslt = hex2bin (target_buf, buf, len);
12442 /* Something went wrong, flag as an error. */
12447 remote_set_disconnected_tracing (struct target_ops *self, int val)
12449 struct remote_state *rs = get_remote_state ();
12451 if (packet_support (PACKET_DisconnectedTracing_feature) == PACKET_ENABLE)
12455 xsnprintf (rs->buf, get_remote_packet_size (), "QTDisconnected:%x", val);
12457 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12458 if (*reply == '\0')
12459 error (_("Target does not support this command."));
12460 if (strcmp (reply, "OK") != 0)
12461 error (_("Bogus reply from target: %s"), reply);
12464 warning (_("Target does not support disconnected tracing."));
12468 remote_core_of_thread (struct target_ops *ops, ptid_t ptid)
12470 struct thread_info *info = find_thread_ptid (ptid);
12472 if (info && info->priv)
12473 return info->priv->core;
12478 remote_set_circular_trace_buffer (struct target_ops *self, int val)
12480 struct remote_state *rs = get_remote_state ();
12483 xsnprintf (rs->buf, get_remote_packet_size (), "QTBuffer:circular:%x", val);
12485 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12486 if (*reply == '\0')
12487 error (_("Target does not support this command."));
12488 if (strcmp (reply, "OK") != 0)
12489 error (_("Bogus reply from target: %s"), reply);
12492 static struct traceframe_info *
12493 remote_traceframe_info (struct target_ops *self)
12497 text = target_read_stralloc (¤t_target,
12498 TARGET_OBJECT_TRACEFRAME_INFO, NULL);
12501 struct traceframe_info *info;
12502 struct cleanup *back_to = make_cleanup (xfree, text);
12504 info = parse_traceframe_info (text);
12505 do_cleanups (back_to);
12512 /* Handle the qTMinFTPILen packet. Returns the minimum length of
12513 instruction on which a fast tracepoint may be placed. Returns -1
12514 if the packet is not supported, and 0 if the minimum instruction
12515 length is unknown. */
12518 remote_get_min_fast_tracepoint_insn_len (struct target_ops *self)
12520 struct remote_state *rs = get_remote_state ();
12523 /* If we're not debugging a process yet, the IPA can't be
12525 if (!target_has_execution)
12528 /* Make sure the remote is pointing at the right process. */
12529 set_general_process ();
12531 xsnprintf (rs->buf, get_remote_packet_size (), "qTMinFTPILen");
12533 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12534 if (*reply == '\0')
12538 ULONGEST min_insn_len;
12540 unpack_varlen_hex (reply, &min_insn_len);
12542 return (int) min_insn_len;
12547 remote_set_trace_buffer_size (struct target_ops *self, LONGEST val)
12549 if (packet_support (PACKET_QTBuffer_size) != PACKET_DISABLE)
12551 struct remote_state *rs = get_remote_state ();
12552 char *buf = rs->buf;
12553 char *endbuf = rs->buf + get_remote_packet_size ();
12554 enum packet_result result;
12556 gdb_assert (val >= 0 || val == -1);
12557 buf += xsnprintf (buf, endbuf - buf, "QTBuffer:size:");
12558 /* Send -1 as literal "-1" to avoid host size dependency. */
12562 buf += hexnumstr (buf, (ULONGEST) -val);
12565 buf += hexnumstr (buf, (ULONGEST) val);
12568 remote_get_noisy_reply (&rs->buf, &rs->buf_size);
12569 result = packet_ok (rs->buf,
12570 &remote_protocol_packets[PACKET_QTBuffer_size]);
12572 if (result != PACKET_OK)
12573 warning (_("Bogus reply from target: %s"), rs->buf);
12578 remote_set_trace_notes (struct target_ops *self,
12579 const char *user, const char *notes,
12580 const char *stop_notes)
12582 struct remote_state *rs = get_remote_state ();
12584 char *buf = rs->buf;
12585 char *endbuf = rs->buf + get_remote_packet_size ();
12588 buf += xsnprintf (buf, endbuf - buf, "QTNotes:");
12591 buf += xsnprintf (buf, endbuf - buf, "user:");
12592 nbytes = bin2hex ((gdb_byte *) user, buf, strlen (user));
12598 buf += xsnprintf (buf, endbuf - buf, "notes:");
12599 nbytes = bin2hex ((gdb_byte *) notes, buf, strlen (notes));
12605 buf += xsnprintf (buf, endbuf - buf, "tstop:");
12606 nbytes = bin2hex ((gdb_byte *) stop_notes, buf, strlen (stop_notes));
12610 /* Ensure the buffer is terminated. */
12614 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12615 if (*reply == '\0')
12618 if (strcmp (reply, "OK") != 0)
12619 error (_("Bogus reply from target: %s"), reply);
12625 remote_use_agent (struct target_ops *self, int use)
12627 if (packet_support (PACKET_QAgent) != PACKET_DISABLE)
12629 struct remote_state *rs = get_remote_state ();
12631 /* If the stub supports QAgent. */
12632 xsnprintf (rs->buf, get_remote_packet_size (), "QAgent:%d", use);
12634 getpkt (&rs->buf, &rs->buf_size, 0);
12636 if (strcmp (rs->buf, "OK") == 0)
12647 remote_can_use_agent (struct target_ops *self)
12649 return (packet_support (PACKET_QAgent) != PACKET_DISABLE);
12652 struct btrace_target_info
12654 /* The ptid of the traced thread. */
12657 /* The obtained branch trace configuration. */
12658 struct btrace_config conf;
12661 /* Reset our idea of our target's btrace configuration. */
12664 remote_btrace_reset (void)
12666 struct remote_state *rs = get_remote_state ();
12668 memset (&rs->btrace_config, 0, sizeof (rs->btrace_config));
12671 /* Check whether the target supports branch tracing. */
12674 remote_supports_btrace (struct target_ops *self, enum btrace_format format)
12676 if (packet_support (PACKET_Qbtrace_off) != PACKET_ENABLE)
12678 if (packet_support (PACKET_qXfer_btrace) != PACKET_ENABLE)
12683 case BTRACE_FORMAT_NONE:
12686 case BTRACE_FORMAT_BTS:
12687 return (packet_support (PACKET_Qbtrace_bts) == PACKET_ENABLE);
12689 case BTRACE_FORMAT_PT:
12690 /* The trace is decoded on the host. Even if our target supports it,
12691 we still need to have libipt to decode the trace. */
12692 #if defined (HAVE_LIBIPT)
12693 return (packet_support (PACKET_Qbtrace_pt) == PACKET_ENABLE);
12694 #else /* !defined (HAVE_LIBIPT) */
12696 #endif /* !defined (HAVE_LIBIPT) */
12699 internal_error (__FILE__, __LINE__, _("Unknown branch trace format"));
12702 /* Synchronize the configuration with the target. */
12705 btrace_sync_conf (const struct btrace_config *conf)
12707 struct packet_config *packet;
12708 struct remote_state *rs;
12709 char *buf, *pos, *endbuf;
12711 rs = get_remote_state ();
12713 endbuf = buf + get_remote_packet_size ();
12715 packet = &remote_protocol_packets[PACKET_Qbtrace_conf_bts_size];
12716 if (packet_config_support (packet) == PACKET_ENABLE
12717 && conf->bts.size != rs->btrace_config.bts.size)
12720 pos += xsnprintf (pos, endbuf - pos, "%s=0x%x", packet->name,
12724 getpkt (&buf, &rs->buf_size, 0);
12726 if (packet_ok (buf, packet) == PACKET_ERROR)
12728 if (buf[0] == 'E' && buf[1] == '.')
12729 error (_("Failed to configure the BTS buffer size: %s"), buf + 2);
12731 error (_("Failed to configure the BTS buffer size."));
12734 rs->btrace_config.bts.size = conf->bts.size;
12737 packet = &remote_protocol_packets[PACKET_Qbtrace_conf_pt_size];
12738 if (packet_config_support (packet) == PACKET_ENABLE
12739 && conf->pt.size != rs->btrace_config.pt.size)
12742 pos += xsnprintf (pos, endbuf - pos, "%s=0x%x", packet->name,
12746 getpkt (&buf, &rs->buf_size, 0);
12748 if (packet_ok (buf, packet) == PACKET_ERROR)
12750 if (buf[0] == 'E' && buf[1] == '.')
12751 error (_("Failed to configure the trace buffer size: %s"), buf + 2);
12753 error (_("Failed to configure the trace buffer size."));
12756 rs->btrace_config.pt.size = conf->pt.size;
12760 /* Read the current thread's btrace configuration from the target and
12761 store it into CONF. */
12764 btrace_read_config (struct btrace_config *conf)
12768 xml = target_read_stralloc (¤t_target,
12769 TARGET_OBJECT_BTRACE_CONF, "");
12772 struct cleanup *cleanup;
12774 cleanup = make_cleanup (xfree, xml);
12775 parse_xml_btrace_conf (conf, xml);
12776 do_cleanups (cleanup);
12780 /* Enable branch tracing. */
12782 static struct btrace_target_info *
12783 remote_enable_btrace (struct target_ops *self, ptid_t ptid,
12784 const struct btrace_config *conf)
12786 struct btrace_target_info *tinfo = NULL;
12787 struct packet_config *packet = NULL;
12788 struct remote_state *rs = get_remote_state ();
12789 char *buf = rs->buf;
12790 char *endbuf = rs->buf + get_remote_packet_size ();
12792 switch (conf->format)
12794 case BTRACE_FORMAT_BTS:
12795 packet = &remote_protocol_packets[PACKET_Qbtrace_bts];
12798 case BTRACE_FORMAT_PT:
12799 packet = &remote_protocol_packets[PACKET_Qbtrace_pt];
12803 if (packet == NULL || packet_config_support (packet) != PACKET_ENABLE)
12804 error (_("Target does not support branch tracing."));
12806 btrace_sync_conf (conf);
12808 set_general_thread (ptid);
12810 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
12812 getpkt (&rs->buf, &rs->buf_size, 0);
12814 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
12816 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
12817 error (_("Could not enable branch tracing for %s: %s"),
12818 target_pid_to_str (ptid), rs->buf + 2);
12820 error (_("Could not enable branch tracing for %s."),
12821 target_pid_to_str (ptid));
12824 tinfo = XCNEW (struct btrace_target_info);
12825 tinfo->ptid = ptid;
12827 /* If we fail to read the configuration, we lose some information, but the
12828 tracing itself is not impacted. */
12831 btrace_read_config (&tinfo->conf);
12833 CATCH (err, RETURN_MASK_ERROR)
12835 if (err.message != NULL)
12836 warning ("%s", err.message);
12843 /* Disable branch tracing. */
12846 remote_disable_btrace (struct target_ops *self,
12847 struct btrace_target_info *tinfo)
12849 struct packet_config *packet = &remote_protocol_packets[PACKET_Qbtrace_off];
12850 struct remote_state *rs = get_remote_state ();
12851 char *buf = rs->buf;
12852 char *endbuf = rs->buf + get_remote_packet_size ();
12854 if (packet_config_support (packet) != PACKET_ENABLE)
12855 error (_("Target does not support branch tracing."));
12857 set_general_thread (tinfo->ptid);
12859 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
12861 getpkt (&rs->buf, &rs->buf_size, 0);
12863 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
12865 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
12866 error (_("Could not disable branch tracing for %s: %s"),
12867 target_pid_to_str (tinfo->ptid), rs->buf + 2);
12869 error (_("Could not disable branch tracing for %s."),
12870 target_pid_to_str (tinfo->ptid));
12876 /* Teardown branch tracing. */
12879 remote_teardown_btrace (struct target_ops *self,
12880 struct btrace_target_info *tinfo)
12882 /* We must not talk to the target during teardown. */
12886 /* Read the branch trace. */
12888 static enum btrace_error
12889 remote_read_btrace (struct target_ops *self,
12890 struct btrace_data *btrace,
12891 struct btrace_target_info *tinfo,
12892 enum btrace_read_type type)
12894 struct packet_config *packet = &remote_protocol_packets[PACKET_qXfer_btrace];
12895 struct cleanup *cleanup;
12899 if (packet_config_support (packet) != PACKET_ENABLE)
12900 error (_("Target does not support branch tracing."));
12902 #if !defined(HAVE_LIBEXPAT)
12903 error (_("Cannot process branch tracing result. XML parsing not supported."));
12908 case BTRACE_READ_ALL:
12911 case BTRACE_READ_NEW:
12914 case BTRACE_READ_DELTA:
12918 internal_error (__FILE__, __LINE__,
12919 _("Bad branch tracing read type: %u."),
12920 (unsigned int) type);
12923 xml = target_read_stralloc (¤t_target,
12924 TARGET_OBJECT_BTRACE, annex);
12926 return BTRACE_ERR_UNKNOWN;
12928 cleanup = make_cleanup (xfree, xml);
12929 parse_xml_btrace (btrace, xml);
12930 do_cleanups (cleanup);
12932 return BTRACE_ERR_NONE;
12935 static const struct btrace_config *
12936 remote_btrace_conf (struct target_ops *self,
12937 const struct btrace_target_info *tinfo)
12939 return &tinfo->conf;
12943 remote_augmented_libraries_svr4_read (struct target_ops *self)
12945 return (packet_support (PACKET_augmented_libraries_svr4_read_feature)
12949 /* Implementation of to_load. */
12952 remote_load (struct target_ops *self, const char *name, int from_tty)
12954 generic_load (name, from_tty);
12957 /* Accepts an integer PID; returns a string representing a file that
12958 can be opened on the remote side to get the symbols for the child
12959 process. Returns NULL if the operation is not supported. */
12962 remote_pid_to_exec_file (struct target_ops *self, int pid)
12964 static char *filename = NULL;
12965 struct inferior *inf;
12966 char *annex = NULL;
12968 if (packet_support (PACKET_qXfer_exec_file) != PACKET_ENABLE)
12971 if (filename != NULL)
12974 inf = find_inferior_pid (pid);
12976 internal_error (__FILE__, __LINE__,
12977 _("not currently attached to process %d"), pid);
12979 if (!inf->fake_pid_p)
12981 const int annex_size = 9;
12983 annex = (char *) alloca (annex_size);
12984 xsnprintf (annex, annex_size, "%x", pid);
12987 filename = target_read_stralloc (¤t_target,
12988 TARGET_OBJECT_EXEC_FILE, annex);
12993 /* Implement the to_can_do_single_step target_ops method. */
12996 remote_can_do_single_step (struct target_ops *ops)
12998 /* We can only tell whether target supports single step or not by
12999 supported s and S vCont actions if the stub supports vContSupported
13000 feature. If the stub doesn't support vContSupported feature,
13001 we have conservatively to think target doesn't supports single
13003 if (packet_support (PACKET_vContSupported) == PACKET_ENABLE)
13005 struct remote_state *rs = get_remote_state ();
13007 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
13008 remote_vcont_probe (rs);
13010 return rs->supports_vCont.s && rs->supports_vCont.S;
13017 init_remote_ops (void)
13019 remote_ops.to_shortname = "remote";
13020 remote_ops.to_longname = "Remote serial target in gdb-specific protocol";
13021 remote_ops.to_doc =
13022 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
13023 Specify the serial device it is connected to\n\
13024 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).";
13025 remote_ops.to_open = remote_open;
13026 remote_ops.to_close = remote_close;
13027 remote_ops.to_detach = remote_detach;
13028 remote_ops.to_disconnect = remote_disconnect;
13029 remote_ops.to_resume = remote_resume;
13030 remote_ops.to_wait = remote_wait;
13031 remote_ops.to_fetch_registers = remote_fetch_registers;
13032 remote_ops.to_store_registers = remote_store_registers;
13033 remote_ops.to_prepare_to_store = remote_prepare_to_store;
13034 remote_ops.to_files_info = remote_files_info;
13035 remote_ops.to_insert_breakpoint = remote_insert_breakpoint;
13036 remote_ops.to_remove_breakpoint = remote_remove_breakpoint;
13037 remote_ops.to_stopped_by_sw_breakpoint = remote_stopped_by_sw_breakpoint;
13038 remote_ops.to_supports_stopped_by_sw_breakpoint = remote_supports_stopped_by_sw_breakpoint;
13039 remote_ops.to_stopped_by_hw_breakpoint = remote_stopped_by_hw_breakpoint;
13040 remote_ops.to_supports_stopped_by_hw_breakpoint = remote_supports_stopped_by_hw_breakpoint;
13041 remote_ops.to_stopped_by_watchpoint = remote_stopped_by_watchpoint;
13042 remote_ops.to_stopped_data_address = remote_stopped_data_address;
13043 remote_ops.to_watchpoint_addr_within_range =
13044 remote_watchpoint_addr_within_range;
13045 remote_ops.to_can_use_hw_breakpoint = remote_check_watch_resources;
13046 remote_ops.to_insert_hw_breakpoint = remote_insert_hw_breakpoint;
13047 remote_ops.to_remove_hw_breakpoint = remote_remove_hw_breakpoint;
13048 remote_ops.to_region_ok_for_hw_watchpoint
13049 = remote_region_ok_for_hw_watchpoint;
13050 remote_ops.to_insert_watchpoint = remote_insert_watchpoint;
13051 remote_ops.to_remove_watchpoint = remote_remove_watchpoint;
13052 remote_ops.to_kill = remote_kill;
13053 remote_ops.to_load = remote_load;
13054 remote_ops.to_mourn_inferior = remote_mourn;
13055 remote_ops.to_pass_signals = remote_pass_signals;
13056 remote_ops.to_set_syscall_catchpoint = remote_set_syscall_catchpoint;
13057 remote_ops.to_program_signals = remote_program_signals;
13058 remote_ops.to_thread_alive = remote_thread_alive;
13059 remote_ops.to_thread_name = remote_thread_name;
13060 remote_ops.to_update_thread_list = remote_update_thread_list;
13061 remote_ops.to_pid_to_str = remote_pid_to_str;
13062 remote_ops.to_extra_thread_info = remote_threads_extra_info;
13063 remote_ops.to_get_ada_task_ptid = remote_get_ada_task_ptid;
13064 remote_ops.to_stop = remote_stop;
13065 remote_ops.to_interrupt = remote_interrupt;
13066 remote_ops.to_check_pending_interrupt = remote_check_pending_interrupt;
13067 remote_ops.to_xfer_partial = remote_xfer_partial;
13068 remote_ops.to_rcmd = remote_rcmd;
13069 remote_ops.to_pid_to_exec_file = remote_pid_to_exec_file;
13070 remote_ops.to_log_command = serial_log_command;
13071 remote_ops.to_get_thread_local_address = remote_get_thread_local_address;
13072 remote_ops.to_stratum = process_stratum;
13073 remote_ops.to_has_all_memory = default_child_has_all_memory;
13074 remote_ops.to_has_memory = default_child_has_memory;
13075 remote_ops.to_has_stack = default_child_has_stack;
13076 remote_ops.to_has_registers = default_child_has_registers;
13077 remote_ops.to_has_execution = default_child_has_execution;
13078 remote_ops.to_has_thread_control = tc_schedlock; /* can lock scheduler */
13079 remote_ops.to_can_execute_reverse = remote_can_execute_reverse;
13080 remote_ops.to_magic = OPS_MAGIC;
13081 remote_ops.to_memory_map = remote_memory_map;
13082 remote_ops.to_flash_erase = remote_flash_erase;
13083 remote_ops.to_flash_done = remote_flash_done;
13084 remote_ops.to_read_description = remote_read_description;
13085 remote_ops.to_search_memory = remote_search_memory;
13086 remote_ops.to_can_async_p = remote_can_async_p;
13087 remote_ops.to_is_async_p = remote_is_async_p;
13088 remote_ops.to_async = remote_async;
13089 remote_ops.to_thread_events = remote_thread_events;
13090 remote_ops.to_can_do_single_step = remote_can_do_single_step;
13091 remote_ops.to_terminal_inferior = remote_terminal_inferior;
13092 remote_ops.to_terminal_ours = remote_terminal_ours;
13093 remote_ops.to_supports_non_stop = remote_supports_non_stop;
13094 remote_ops.to_supports_multi_process = remote_supports_multi_process;
13095 remote_ops.to_supports_disable_randomization
13096 = remote_supports_disable_randomization;
13097 remote_ops.to_filesystem_is_local = remote_filesystem_is_local;
13098 remote_ops.to_fileio_open = remote_hostio_open;
13099 remote_ops.to_fileio_pwrite = remote_hostio_pwrite;
13100 remote_ops.to_fileio_pread = remote_hostio_pread;
13101 remote_ops.to_fileio_fstat = remote_hostio_fstat;
13102 remote_ops.to_fileio_close = remote_hostio_close;
13103 remote_ops.to_fileio_unlink = remote_hostio_unlink;
13104 remote_ops.to_fileio_readlink = remote_hostio_readlink;
13105 remote_ops.to_supports_enable_disable_tracepoint = remote_supports_enable_disable_tracepoint;
13106 remote_ops.to_supports_string_tracing = remote_supports_string_tracing;
13107 remote_ops.to_supports_evaluation_of_breakpoint_conditions = remote_supports_cond_breakpoints;
13108 remote_ops.to_can_run_breakpoint_commands = remote_can_run_breakpoint_commands;
13109 remote_ops.to_trace_init = remote_trace_init;
13110 remote_ops.to_download_tracepoint = remote_download_tracepoint;
13111 remote_ops.to_can_download_tracepoint = remote_can_download_tracepoint;
13112 remote_ops.to_download_trace_state_variable
13113 = remote_download_trace_state_variable;
13114 remote_ops.to_enable_tracepoint = remote_enable_tracepoint;
13115 remote_ops.to_disable_tracepoint = remote_disable_tracepoint;
13116 remote_ops.to_trace_set_readonly_regions = remote_trace_set_readonly_regions;
13117 remote_ops.to_trace_start = remote_trace_start;
13118 remote_ops.to_get_trace_status = remote_get_trace_status;
13119 remote_ops.to_get_tracepoint_status = remote_get_tracepoint_status;
13120 remote_ops.to_trace_stop = remote_trace_stop;
13121 remote_ops.to_trace_find = remote_trace_find;
13122 remote_ops.to_get_trace_state_variable_value
13123 = remote_get_trace_state_variable_value;
13124 remote_ops.to_save_trace_data = remote_save_trace_data;
13125 remote_ops.to_upload_tracepoints = remote_upload_tracepoints;
13126 remote_ops.to_upload_trace_state_variables
13127 = remote_upload_trace_state_variables;
13128 remote_ops.to_get_raw_trace_data = remote_get_raw_trace_data;
13129 remote_ops.to_get_min_fast_tracepoint_insn_len = remote_get_min_fast_tracepoint_insn_len;
13130 remote_ops.to_set_disconnected_tracing = remote_set_disconnected_tracing;
13131 remote_ops.to_set_circular_trace_buffer = remote_set_circular_trace_buffer;
13132 remote_ops.to_set_trace_buffer_size = remote_set_trace_buffer_size;
13133 remote_ops.to_set_trace_notes = remote_set_trace_notes;
13134 remote_ops.to_core_of_thread = remote_core_of_thread;
13135 remote_ops.to_verify_memory = remote_verify_memory;
13136 remote_ops.to_get_tib_address = remote_get_tib_address;
13137 remote_ops.to_set_permissions = remote_set_permissions;
13138 remote_ops.to_static_tracepoint_marker_at
13139 = remote_static_tracepoint_marker_at;
13140 remote_ops.to_static_tracepoint_markers_by_strid
13141 = remote_static_tracepoint_markers_by_strid;
13142 remote_ops.to_traceframe_info = remote_traceframe_info;
13143 remote_ops.to_use_agent = remote_use_agent;
13144 remote_ops.to_can_use_agent = remote_can_use_agent;
13145 remote_ops.to_supports_btrace = remote_supports_btrace;
13146 remote_ops.to_enable_btrace = remote_enable_btrace;
13147 remote_ops.to_disable_btrace = remote_disable_btrace;
13148 remote_ops.to_teardown_btrace = remote_teardown_btrace;
13149 remote_ops.to_read_btrace = remote_read_btrace;
13150 remote_ops.to_btrace_conf = remote_btrace_conf;
13151 remote_ops.to_augmented_libraries_svr4_read =
13152 remote_augmented_libraries_svr4_read;
13153 remote_ops.to_follow_fork = remote_follow_fork;
13154 remote_ops.to_follow_exec = remote_follow_exec;
13155 remote_ops.to_insert_fork_catchpoint = remote_insert_fork_catchpoint;
13156 remote_ops.to_remove_fork_catchpoint = remote_remove_fork_catchpoint;
13157 remote_ops.to_insert_vfork_catchpoint = remote_insert_vfork_catchpoint;
13158 remote_ops.to_remove_vfork_catchpoint = remote_remove_vfork_catchpoint;
13159 remote_ops.to_insert_exec_catchpoint = remote_insert_exec_catchpoint;
13160 remote_ops.to_remove_exec_catchpoint = remote_remove_exec_catchpoint;
13163 /* Set up the extended remote vector by making a copy of the standard
13164 remote vector and adding to it. */
13167 init_extended_remote_ops (void)
13169 extended_remote_ops = remote_ops;
13171 extended_remote_ops.to_shortname = "extended-remote";
13172 extended_remote_ops.to_longname =
13173 "Extended remote serial target in gdb-specific protocol";
13174 extended_remote_ops.to_doc =
13175 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
13176 Specify the serial device it is connected to (e.g. /dev/ttya).";
13177 extended_remote_ops.to_open = extended_remote_open;
13178 extended_remote_ops.to_create_inferior = extended_remote_create_inferior;
13179 extended_remote_ops.to_detach = extended_remote_detach;
13180 extended_remote_ops.to_attach = extended_remote_attach;
13181 extended_remote_ops.to_post_attach = extended_remote_post_attach;
13182 extended_remote_ops.to_supports_disable_randomization
13183 = extended_remote_supports_disable_randomization;
13187 remote_can_async_p (struct target_ops *ops)
13189 struct remote_state *rs = get_remote_state ();
13191 if (!target_async_permitted)
13192 /* We only enable async when the user specifically asks for it. */
13195 /* We're async whenever the serial device is. */
13196 return serial_can_async_p (rs->remote_desc);
13200 remote_is_async_p (struct target_ops *ops)
13202 struct remote_state *rs = get_remote_state ();
13204 if (!target_async_permitted)
13205 /* We only enable async when the user specifically asks for it. */
13208 /* We're async whenever the serial device is. */
13209 return serial_is_async_p (rs->remote_desc);
13212 /* Pass the SERIAL event on and up to the client. One day this code
13213 will be able to delay notifying the client of an event until the
13214 point where an entire packet has been received. */
13216 static serial_event_ftype remote_async_serial_handler;
13219 remote_async_serial_handler (struct serial *scb, void *context)
13221 /* Don't propogate error information up to the client. Instead let
13222 the client find out about the error by querying the target. */
13223 inferior_event_handler (INF_REG_EVENT, NULL);
13227 remote_async_inferior_event_handler (gdb_client_data data)
13229 inferior_event_handler (INF_REG_EVENT, NULL);
13233 remote_async (struct target_ops *ops, int enable)
13235 struct remote_state *rs = get_remote_state ();
13239 serial_async (rs->remote_desc, remote_async_serial_handler, rs);
13241 /* If there are pending events in the stop reply queue tell the
13242 event loop to process them. */
13243 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
13244 mark_async_event_handler (remote_async_inferior_event_token);
13245 /* For simplicity, below we clear the pending events token
13246 without remembering whether it is marked, so here we always
13247 mark it. If there's actually no pending notification to
13248 process, this ends up being a no-op (other than a spurious
13249 event-loop wakeup). */
13250 if (target_is_non_stop_p ())
13251 mark_async_event_handler (rs->notif_state->get_pending_events_token);
13255 serial_async (rs->remote_desc, NULL, NULL);
13256 /* If the core is disabling async, it doesn't want to be
13257 disturbed with target events. Clear all async event sources
13259 clear_async_event_handler (remote_async_inferior_event_token);
13260 if (target_is_non_stop_p ())
13261 clear_async_event_handler (rs->notif_state->get_pending_events_token);
13265 /* Implementation of the to_thread_events method. */
13268 remote_thread_events (struct target_ops *ops, int enable)
13270 struct remote_state *rs = get_remote_state ();
13271 size_t size = get_remote_packet_size ();
13273 if (packet_support (PACKET_QThreadEvents) == PACKET_DISABLE)
13276 xsnprintf (rs->buf, size, "QThreadEvents:%x", enable ? 1 : 0);
13278 getpkt (&rs->buf, &rs->buf_size, 0);
13280 switch (packet_ok (rs->buf,
13281 &remote_protocol_packets[PACKET_QThreadEvents]))
13284 if (strcmp (rs->buf, "OK") != 0)
13285 error (_("Remote refused setting thread events: %s"), rs->buf);
13288 warning (_("Remote failure reply: %s"), rs->buf);
13290 case PACKET_UNKNOWN:
13296 set_remote_cmd (char *args, int from_tty)
13298 help_list (remote_set_cmdlist, "set remote ", all_commands, gdb_stdout);
13302 show_remote_cmd (char *args, int from_tty)
13304 /* We can't just use cmd_show_list here, because we want to skip
13305 the redundant "show remote Z-packet" and the legacy aliases. */
13306 struct cleanup *showlist_chain;
13307 struct cmd_list_element *list = remote_show_cmdlist;
13308 struct ui_out *uiout = current_uiout;
13310 showlist_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "showlist");
13311 for (; list != NULL; list = list->next)
13312 if (strcmp (list->name, "Z-packet") == 0)
13314 else if (list->type == not_set_cmd)
13315 /* Alias commands are exactly like the original, except they
13316 don't have the normal type. */
13320 struct cleanup *option_chain
13321 = make_cleanup_ui_out_tuple_begin_end (uiout, "option");
13323 ui_out_field_string (uiout, "name", list->name);
13324 ui_out_text (uiout, ": ");
13325 if (list->type == show_cmd)
13326 do_show_command ((char *) NULL, from_tty, list);
13328 cmd_func (list, NULL, from_tty);
13329 /* Close the tuple. */
13330 do_cleanups (option_chain);
13333 /* Close the tuple. */
13334 do_cleanups (showlist_chain);
13338 /* Function to be called whenever a new objfile (shlib) is detected. */
13340 remote_new_objfile (struct objfile *objfile)
13342 struct remote_state *rs = get_remote_state ();
13344 if (rs->remote_desc != 0) /* Have a remote connection. */
13345 remote_check_symbols ();
13348 /* Pull all the tracepoints defined on the target and create local
13349 data structures representing them. We don't want to create real
13350 tracepoints yet, we don't want to mess up the user's existing
13354 remote_upload_tracepoints (struct target_ops *self, struct uploaded_tp **utpp)
13356 struct remote_state *rs = get_remote_state ();
13359 /* Ask for a first packet of tracepoint definition. */
13361 getpkt (&rs->buf, &rs->buf_size, 0);
13363 while (*p && *p != 'l')
13365 parse_tracepoint_definition (p, utpp);
13366 /* Ask for another packet of tracepoint definition. */
13368 getpkt (&rs->buf, &rs->buf_size, 0);
13375 remote_upload_trace_state_variables (struct target_ops *self,
13376 struct uploaded_tsv **utsvp)
13378 struct remote_state *rs = get_remote_state ();
13381 /* Ask for a first packet of variable definition. */
13383 getpkt (&rs->buf, &rs->buf_size, 0);
13385 while (*p && *p != 'l')
13387 parse_tsv_definition (p, utsvp);
13388 /* Ask for another packet of variable definition. */
13390 getpkt (&rs->buf, &rs->buf_size, 0);
13396 /* The "set/show range-stepping" show hook. */
13399 show_range_stepping (struct ui_file *file, int from_tty,
13400 struct cmd_list_element *c,
13403 fprintf_filtered (file,
13404 _("Debugger's willingness to use range stepping "
13405 "is %s.\n"), value);
13408 /* The "set/show range-stepping" set hook. */
13411 set_range_stepping (char *ignore_args, int from_tty,
13412 struct cmd_list_element *c)
13414 struct remote_state *rs = get_remote_state ();
13416 /* Whene enabling, check whether range stepping is actually
13417 supported by the target, and warn if not. */
13418 if (use_range_stepping)
13420 if (rs->remote_desc != NULL)
13422 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
13423 remote_vcont_probe (rs);
13425 if (packet_support (PACKET_vCont) == PACKET_ENABLE
13426 && rs->supports_vCont.r)
13430 warning (_("Range stepping is not supported by the current target"));
13435 _initialize_remote (void)
13437 struct cmd_list_element *cmd;
13438 const char *cmd_name;
13440 /* architecture specific data */
13441 remote_gdbarch_data_handle =
13442 gdbarch_data_register_post_init (init_remote_state);
13443 remote_g_packet_data_handle =
13444 gdbarch_data_register_pre_init (remote_g_packet_data_init);
13447 = register_program_space_data_with_cleanup (NULL,
13448 remote_pspace_data_cleanup);
13450 /* Initialize the per-target state. At the moment there is only one
13451 of these, not one per target. Only one target is active at a
13453 remote_state = new_remote_state ();
13455 init_remote_ops ();
13456 add_target (&remote_ops);
13458 init_extended_remote_ops ();
13459 add_target (&extended_remote_ops);
13461 /* Hook into new objfile notification. */
13462 observer_attach_new_objfile (remote_new_objfile);
13463 /* We're no longer interested in notification events of an inferior
13465 observer_attach_inferior_exit (discard_pending_stop_replies);
13467 /* Set up signal handlers. */
13468 async_sigint_remote_token =
13469 create_async_signal_handler (async_remote_interrupt, NULL);
13470 async_sigint_remote_twice_token =
13471 create_async_signal_handler (async_remote_interrupt_twice, NULL);
13474 init_remote_threadtests ();
13477 stop_reply_queue = QUEUE_alloc (stop_reply_p, stop_reply_xfree);
13478 /* set/show remote ... */
13480 add_prefix_cmd ("remote", class_maintenance, set_remote_cmd, _("\
13481 Remote protocol specific variables\n\
13482 Configure various remote-protocol specific variables such as\n\
13483 the packets being used"),
13484 &remote_set_cmdlist, "set remote ",
13485 0 /* allow-unknown */, &setlist);
13486 add_prefix_cmd ("remote", class_maintenance, show_remote_cmd, _("\
13487 Remote protocol specific variables\n\
13488 Configure various remote-protocol specific variables such as\n\
13489 the packets being used"),
13490 &remote_show_cmdlist, "show remote ",
13491 0 /* allow-unknown */, &showlist);
13493 add_cmd ("compare-sections", class_obscure, compare_sections_command, _("\
13494 Compare section data on target to the exec file.\n\
13495 Argument is a single section name (default: all loaded sections).\n\
13496 To compare only read-only loaded sections, specify the -r option."),
13499 add_cmd ("packet", class_maintenance, packet_command, _("\
13500 Send an arbitrary packet to a remote target.\n\
13501 maintenance packet TEXT\n\
13502 If GDB is talking to an inferior via the GDB serial protocol, then\n\
13503 this command sends the string TEXT to the inferior, and displays the\n\
13504 response packet. GDB supplies the initial `$' character, and the\n\
13505 terminating `#' character and checksum."),
13508 add_setshow_boolean_cmd ("remotebreak", no_class, &remote_break, _("\
13509 Set whether to send break if interrupted."), _("\
13510 Show whether to send break if interrupted."), _("\
13511 If set, a break, instead of a cntrl-c, is sent to the remote target."),
13512 set_remotebreak, show_remotebreak,
13513 &setlist, &showlist);
13514 cmd_name = "remotebreak";
13515 cmd = lookup_cmd (&cmd_name, setlist, "", -1, 1);
13516 deprecate_cmd (cmd, "set remote interrupt-sequence");
13517 cmd_name = "remotebreak"; /* needed because lookup_cmd updates the pointer */
13518 cmd = lookup_cmd (&cmd_name, showlist, "", -1, 1);
13519 deprecate_cmd (cmd, "show remote interrupt-sequence");
13521 add_setshow_enum_cmd ("interrupt-sequence", class_support,
13522 interrupt_sequence_modes, &interrupt_sequence_mode,
13524 Set interrupt sequence to remote target."), _("\
13525 Show interrupt sequence to remote target."), _("\
13526 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
13527 NULL, show_interrupt_sequence,
13528 &remote_set_cmdlist,
13529 &remote_show_cmdlist);
13531 add_setshow_boolean_cmd ("interrupt-on-connect", class_support,
13532 &interrupt_on_connect, _("\
13533 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
13534 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
13535 If set, interrupt sequence is sent to remote target."),
13537 &remote_set_cmdlist, &remote_show_cmdlist);
13539 /* Install commands for configuring memory read/write packets. */
13541 add_cmd ("remotewritesize", no_class, set_memory_write_packet_size, _("\
13542 Set the maximum number of bytes per memory write packet (deprecated)."),
13544 add_cmd ("remotewritesize", no_class, show_memory_write_packet_size, _("\
13545 Show the maximum number of bytes per memory write packet (deprecated)."),
13547 add_cmd ("memory-write-packet-size", no_class,
13548 set_memory_write_packet_size, _("\
13549 Set the maximum number of bytes per memory-write packet.\n\
13550 Specify the number of bytes in a packet or 0 (zero) for the\n\
13551 default packet size. The actual limit is further reduced\n\
13552 dependent on the target. Specify ``fixed'' to disable the\n\
13553 further restriction and ``limit'' to enable that restriction."),
13554 &remote_set_cmdlist);
13555 add_cmd ("memory-read-packet-size", no_class,
13556 set_memory_read_packet_size, _("\
13557 Set the maximum number of bytes per memory-read packet.\n\
13558 Specify the number of bytes in a packet or 0 (zero) for the\n\
13559 default packet size. The actual limit is further reduced\n\
13560 dependent on the target. Specify ``fixed'' to disable the\n\
13561 further restriction and ``limit'' to enable that restriction."),
13562 &remote_set_cmdlist);
13563 add_cmd ("memory-write-packet-size", no_class,
13564 show_memory_write_packet_size,
13565 _("Show the maximum number of bytes per memory-write packet."),
13566 &remote_show_cmdlist);
13567 add_cmd ("memory-read-packet-size", no_class,
13568 show_memory_read_packet_size,
13569 _("Show the maximum number of bytes per memory-read packet."),
13570 &remote_show_cmdlist);
13572 add_setshow_zinteger_cmd ("hardware-watchpoint-limit", no_class,
13573 &remote_hw_watchpoint_limit, _("\
13574 Set the maximum number of target hardware watchpoints."), _("\
13575 Show the maximum number of target hardware watchpoints."), _("\
13576 Specify a negative limit for unlimited."),
13577 NULL, NULL, /* FIXME: i18n: The maximum
13578 number of target hardware
13579 watchpoints is %s. */
13580 &remote_set_cmdlist, &remote_show_cmdlist);
13581 add_setshow_zinteger_cmd ("hardware-watchpoint-length-limit", no_class,
13582 &remote_hw_watchpoint_length_limit, _("\
13583 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
13584 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
13585 Specify a negative limit for unlimited."),
13586 NULL, NULL, /* FIXME: i18n: The maximum
13587 length (in bytes) of a target
13588 hardware watchpoint is %s. */
13589 &remote_set_cmdlist, &remote_show_cmdlist);
13590 add_setshow_zinteger_cmd ("hardware-breakpoint-limit", no_class,
13591 &remote_hw_breakpoint_limit, _("\
13592 Set the maximum number of target hardware breakpoints."), _("\
13593 Show the maximum number of target hardware breakpoints."), _("\
13594 Specify a negative limit for unlimited."),
13595 NULL, NULL, /* FIXME: i18n: The maximum
13596 number of target hardware
13597 breakpoints is %s. */
13598 &remote_set_cmdlist, &remote_show_cmdlist);
13600 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure,
13601 &remote_address_size, _("\
13602 Set the maximum size of the address (in bits) in a memory packet."), _("\
13603 Show the maximum size of the address (in bits) in a memory packet."), NULL,
13605 NULL, /* FIXME: i18n: */
13606 &setlist, &showlist);
13608 init_all_packet_configs ();
13610 add_packet_config_cmd (&remote_protocol_packets[PACKET_X],
13611 "X", "binary-download", 1);
13613 add_packet_config_cmd (&remote_protocol_packets[PACKET_vCont],
13614 "vCont", "verbose-resume", 0);
13616 add_packet_config_cmd (&remote_protocol_packets[PACKET_QPassSignals],
13617 "QPassSignals", "pass-signals", 0);
13619 add_packet_config_cmd (&remote_protocol_packets[PACKET_QCatchSyscalls],
13620 "QCatchSyscalls", "catch-syscalls", 0);
13622 add_packet_config_cmd (&remote_protocol_packets[PACKET_QProgramSignals],
13623 "QProgramSignals", "program-signals", 0);
13625 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSymbol],
13626 "qSymbol", "symbol-lookup", 0);
13628 add_packet_config_cmd (&remote_protocol_packets[PACKET_P],
13629 "P", "set-register", 1);
13631 add_packet_config_cmd (&remote_protocol_packets[PACKET_p],
13632 "p", "fetch-register", 1);
13634 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z0],
13635 "Z0", "software-breakpoint", 0);
13637 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z1],
13638 "Z1", "hardware-breakpoint", 0);
13640 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z2],
13641 "Z2", "write-watchpoint", 0);
13643 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z3],
13644 "Z3", "read-watchpoint", 0);
13646 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z4],
13647 "Z4", "access-watchpoint", 0);
13649 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_auxv],
13650 "qXfer:auxv:read", "read-aux-vector", 0);
13652 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_exec_file],
13653 "qXfer:exec-file:read", "pid-to-exec-file", 0);
13655 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_features],
13656 "qXfer:features:read", "target-features", 0);
13658 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries],
13659 "qXfer:libraries:read", "library-info", 0);
13661 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries_svr4],
13662 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
13664 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_memory_map],
13665 "qXfer:memory-map:read", "memory-map", 0);
13667 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_read],
13668 "qXfer:spu:read", "read-spu-object", 0);
13670 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_write],
13671 "qXfer:spu:write", "write-spu-object", 0);
13673 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_osdata],
13674 "qXfer:osdata:read", "osdata", 0);
13676 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_threads],
13677 "qXfer:threads:read", "threads", 0);
13679 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_read],
13680 "qXfer:siginfo:read", "read-siginfo-object", 0);
13682 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_write],
13683 "qXfer:siginfo:write", "write-siginfo-object", 0);
13685 add_packet_config_cmd
13686 (&remote_protocol_packets[PACKET_qXfer_traceframe_info],
13687 "qXfer:traceframe-info:read", "traceframe-info", 0);
13689 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_uib],
13690 "qXfer:uib:read", "unwind-info-block", 0);
13692 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTLSAddr],
13693 "qGetTLSAddr", "get-thread-local-storage-address",
13696 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTIBAddr],
13697 "qGetTIBAddr", "get-thread-information-block-address",
13700 add_packet_config_cmd (&remote_protocol_packets[PACKET_bc],
13701 "bc", "reverse-continue", 0);
13703 add_packet_config_cmd (&remote_protocol_packets[PACKET_bs],
13704 "bs", "reverse-step", 0);
13706 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSupported],
13707 "qSupported", "supported-packets", 0);
13709 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSearch_memory],
13710 "qSearch:memory", "search-memory", 0);
13712 add_packet_config_cmd (&remote_protocol_packets[PACKET_qTStatus],
13713 "qTStatus", "trace-status", 0);
13715 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_setfs],
13716 "vFile:setfs", "hostio-setfs", 0);
13718 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_open],
13719 "vFile:open", "hostio-open", 0);
13721 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pread],
13722 "vFile:pread", "hostio-pread", 0);
13724 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pwrite],
13725 "vFile:pwrite", "hostio-pwrite", 0);
13727 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_close],
13728 "vFile:close", "hostio-close", 0);
13730 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_unlink],
13731 "vFile:unlink", "hostio-unlink", 0);
13733 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_readlink],
13734 "vFile:readlink", "hostio-readlink", 0);
13736 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_fstat],
13737 "vFile:fstat", "hostio-fstat", 0);
13739 add_packet_config_cmd (&remote_protocol_packets[PACKET_vAttach],
13740 "vAttach", "attach", 0);
13742 add_packet_config_cmd (&remote_protocol_packets[PACKET_vRun],
13745 add_packet_config_cmd (&remote_protocol_packets[PACKET_QStartNoAckMode],
13746 "QStartNoAckMode", "noack", 0);
13748 add_packet_config_cmd (&remote_protocol_packets[PACKET_vKill],
13749 "vKill", "kill", 0);
13751 add_packet_config_cmd (&remote_protocol_packets[PACKET_qAttached],
13752 "qAttached", "query-attached", 0);
13754 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalTracepoints],
13755 "ConditionalTracepoints",
13756 "conditional-tracepoints", 0);
13758 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalBreakpoints],
13759 "ConditionalBreakpoints",
13760 "conditional-breakpoints", 0);
13762 add_packet_config_cmd (&remote_protocol_packets[PACKET_BreakpointCommands],
13763 "BreakpointCommands",
13764 "breakpoint-commands", 0);
13766 add_packet_config_cmd (&remote_protocol_packets[PACKET_FastTracepoints],
13767 "FastTracepoints", "fast-tracepoints", 0);
13769 add_packet_config_cmd (&remote_protocol_packets[PACKET_TracepointSource],
13770 "TracepointSource", "TracepointSource", 0);
13772 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAllow],
13773 "QAllow", "allow", 0);
13775 add_packet_config_cmd (&remote_protocol_packets[PACKET_StaticTracepoints],
13776 "StaticTracepoints", "static-tracepoints", 0);
13778 add_packet_config_cmd (&remote_protocol_packets[PACKET_InstallInTrace],
13779 "InstallInTrace", "install-in-trace", 0);
13781 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_statictrace_read],
13782 "qXfer:statictrace:read", "read-sdata-object", 0);
13784 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_fdpic],
13785 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
13787 add_packet_config_cmd (&remote_protocol_packets[PACKET_QDisableRandomization],
13788 "QDisableRandomization", "disable-randomization", 0);
13790 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAgent],
13791 "QAgent", "agent", 0);
13793 add_packet_config_cmd (&remote_protocol_packets[PACKET_QTBuffer_size],
13794 "QTBuffer:size", "trace-buffer-size", 0);
13796 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_off],
13797 "Qbtrace:off", "disable-btrace", 0);
13799 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_bts],
13800 "Qbtrace:bts", "enable-btrace-bts", 0);
13802 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_pt],
13803 "Qbtrace:pt", "enable-btrace-pt", 0);
13805 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace],
13806 "qXfer:btrace", "read-btrace", 0);
13808 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace_conf],
13809 "qXfer:btrace-conf", "read-btrace-conf", 0);
13811 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_conf_bts_size],
13812 "Qbtrace-conf:bts:size", "btrace-conf-bts-size", 0);
13814 add_packet_config_cmd (&remote_protocol_packets[PACKET_multiprocess_feature],
13815 "multiprocess-feature", "multiprocess-feature", 0);
13817 add_packet_config_cmd (&remote_protocol_packets[PACKET_swbreak_feature],
13818 "swbreak-feature", "swbreak-feature", 0);
13820 add_packet_config_cmd (&remote_protocol_packets[PACKET_hwbreak_feature],
13821 "hwbreak-feature", "hwbreak-feature", 0);
13823 add_packet_config_cmd (&remote_protocol_packets[PACKET_fork_event_feature],
13824 "fork-event-feature", "fork-event-feature", 0);
13826 add_packet_config_cmd (&remote_protocol_packets[PACKET_vfork_event_feature],
13827 "vfork-event-feature", "vfork-event-feature", 0);
13829 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_conf_pt_size],
13830 "Qbtrace-conf:pt:size", "btrace-conf-pt-size", 0);
13832 add_packet_config_cmd (&remote_protocol_packets[PACKET_vContSupported],
13833 "vContSupported", "verbose-resume-supported", 0);
13835 add_packet_config_cmd (&remote_protocol_packets[PACKET_exec_event_feature],
13836 "exec-event-feature", "exec-event-feature", 0);
13838 add_packet_config_cmd (&remote_protocol_packets[PACKET_vCtrlC],
13839 "vCtrlC", "ctrl-c", 0);
13841 add_packet_config_cmd (&remote_protocol_packets[PACKET_QThreadEvents],
13842 "QThreadEvents", "thread-events", 0);
13844 add_packet_config_cmd (&remote_protocol_packets[PACKET_no_resumed],
13845 "N stop reply", "no-resumed-stop-reply", 0);
13847 /* Assert that we've registered "set remote foo-packet" commands
13848 for all packet configs. */
13852 for (i = 0; i < PACKET_MAX; i++)
13854 /* Ideally all configs would have a command associated. Some
13855 still don't though. */
13860 case PACKET_QNonStop:
13861 case PACKET_EnableDisableTracepoints_feature:
13862 case PACKET_tracenz_feature:
13863 case PACKET_DisconnectedTracing_feature:
13864 case PACKET_augmented_libraries_svr4_read_feature:
13866 /* Additions to this list need to be well justified:
13867 pre-existing packets are OK; new packets are not. */
13875 /* This catches both forgetting to add a config command, and
13876 forgetting to remove a packet from the exception list. */
13877 gdb_assert (excepted == (remote_protocol_packets[i].name == NULL));
13881 /* Keep the old ``set remote Z-packet ...'' working. Each individual
13882 Z sub-packet has its own set and show commands, but users may
13883 have sets to this variable in their .gdbinit files (or in their
13885 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure,
13886 &remote_Z_packet_detect, _("\
13887 Set use of remote protocol `Z' packets"), _("\
13888 Show use of remote protocol `Z' packets "), _("\
13889 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
13891 set_remote_protocol_Z_packet_cmd,
13892 show_remote_protocol_Z_packet_cmd,
13893 /* FIXME: i18n: Use of remote protocol
13894 `Z' packets is %s. */
13895 &remote_set_cmdlist, &remote_show_cmdlist);
13897 add_prefix_cmd ("remote", class_files, remote_command, _("\
13898 Manipulate files on the remote system\n\
13899 Transfer files to and from the remote target system."),
13900 &remote_cmdlist, "remote ",
13901 0 /* allow-unknown */, &cmdlist);
13903 add_cmd ("put", class_files, remote_put_command,
13904 _("Copy a local file to the remote system."),
13907 add_cmd ("get", class_files, remote_get_command,
13908 _("Copy a remote file to the local system."),
13911 add_cmd ("delete", class_files, remote_delete_command,
13912 _("Delete a remote file."),
13915 add_setshow_string_noescape_cmd ("exec-file", class_files,
13916 &remote_exec_file_var, _("\
13917 Set the remote pathname for \"run\""), _("\
13918 Show the remote pathname for \"run\""), NULL,
13919 set_remote_exec_file,
13920 show_remote_exec_file,
13921 &remote_set_cmdlist,
13922 &remote_show_cmdlist);
13924 add_setshow_boolean_cmd ("range-stepping", class_run,
13925 &use_range_stepping, _("\
13926 Enable or disable range stepping."), _("\
13927 Show whether target-assisted range stepping is enabled."), _("\
13928 If on, and the target supports it, when stepping a source line, GDB\n\
13929 tells the target to step the corresponding range of addresses itself instead\n\
13930 of issuing multiple single-steps. This speeds up source level\n\
13931 stepping. If off, GDB always issues single-steps, even if range\n\
13932 stepping is supported by the target. The default is on."),
13933 set_range_stepping,
13934 show_range_stepping,
13938 /* Eventually initialize fileio. See fileio.c */
13939 initialize_remote_fileio (remote_set_cmdlist, remote_show_cmdlist);
13941 /* Take advantage of the fact that the TID field is not used, to tag
13942 special ptids with it set to != 0. */
13943 magic_null_ptid = ptid_build (42000, -1, 1);
13944 not_sent_ptid = ptid_build (42000, -2, 1);
13945 any_thread_ptid = ptid_build (42000, 0, 1);
13947 target_buf_size = 2048;
13948 target_buf = (char *) xmalloc (target_buf_size);