1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2017 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
20 /* See the GDB User Guide for details of the GDB remote protocol. */
30 /*#include "terminal.h" */
33 #include "gdb-stabs.h"
34 #include "gdbthread.h"
36 #include "remote-notif.h"
41 #include "cli/cli-decode.h"
42 #include "cli/cli-setshow.h"
43 #include "target-descriptions.h"
45 #include "filestuff.h"
50 #include "gdb_sys_time.h"
52 #include "event-loop.h"
53 #include "event-top.h"
59 #include "gdbcore.h" /* for exec_bfd */
61 #include "remote-fileio.h"
62 #include "gdb/fileio.h"
64 #include "xml-support.h"
66 #include "memory-map.h"
68 #include "tracepoint.h"
73 #include "record-btrace.h"
75 #include "common/scoped_restore.h"
78 /* Temp hacks for tracepoint encoding migration. */
79 static char *target_buf;
80 static long target_buf_size;
82 /* Per-program-space data key. */
83 static const struct program_space_data *remote_pspace_data;
85 /* The variable registered as the control variable used by the
86 remote exec-file commands. While the remote exec-file setting is
87 per-program-space, the set/show machinery uses this as the
88 location of the remote exec-file value. */
89 static char *remote_exec_file_var;
91 /* The size to align memory write packets, when practical. The protocol
92 does not guarantee any alignment, and gdb will generate short
93 writes and unaligned writes, but even as a best-effort attempt this
94 can improve bulk transfers. For instance, if a write is misaligned
95 relative to the target's data bus, the stub may need to make an extra
96 round trip fetching data from the target. This doesn't make a
97 huge difference, but it's easy to do, so we try to be helpful.
99 The alignment chosen is arbitrary; usually data bus width is
100 important here, not the possibly larger cache line size. */
101 enum { REMOTE_ALIGN_WRITES = 16 };
103 /* Prototypes for local functions. */
104 static int getpkt_sane (char **buf, long *sizeof_buf, int forever);
105 static int getpkt_or_notif_sane (char **buf, long *sizeof_buf,
106 int forever, int *is_notif);
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 interrupt_query (void);
146 static void set_general_thread (ptid_t ptid);
147 static void set_continue_thread (ptid_t ptid);
149 static void get_offsets (void);
151 static void skip_frame (void);
153 static long read_frame (char **buf_p, long *sizeof_buf);
155 static int hexnumlen (ULONGEST num);
157 static void init_remote_ops (void);
159 static void init_extended_remote_ops (void);
161 static void remote_stop (struct target_ops *self, ptid_t);
163 static int stubhex (int ch);
165 static int hexnumstr (char *, ULONGEST);
167 static int hexnumnstr (char *, ULONGEST, int);
169 static CORE_ADDR remote_address_masked (CORE_ADDR);
171 static void print_packet (const char *);
173 static void compare_sections_command (char *, int);
175 static void packet_command (char *, int);
177 static int stub_unpack_int (char *buff, int fieldlength);
179 static ptid_t remote_current_thread (ptid_t oldptid);
181 static int putpkt_binary (const char *buf, int cnt);
183 static void check_binary_download (CORE_ADDR addr);
185 struct packet_config;
187 static void show_packet_config_cmd (struct packet_config *config);
189 static void show_remote_protocol_packet_cmd (struct ui_file *file,
191 struct cmd_list_element *c,
194 static char *write_ptid (char *buf, const char *endbuf, ptid_t ptid);
195 static ptid_t read_ptid (char *buf, char **obuf);
197 static void remote_set_permissions (struct target_ops *self);
199 static int remote_get_trace_status (struct target_ops *self,
200 struct trace_status *ts);
202 static int remote_upload_tracepoints (struct target_ops *self,
203 struct uploaded_tp **utpp);
205 static int remote_upload_trace_state_variables (struct target_ops *self,
206 struct uploaded_tsv **utsvp);
208 static void remote_query_supported (void);
210 static void remote_check_symbols (void);
213 static void stop_reply_xfree (struct stop_reply *);
214 static void remote_parse_stop_reply (char *, struct stop_reply *);
215 static void push_stop_reply (struct stop_reply *);
216 static void discard_pending_stop_replies_in_queue (struct remote_state *);
217 static int peek_stop_reply (ptid_t ptid);
219 struct threads_listing_context;
220 static void remove_new_fork_children (struct threads_listing_context *);
222 static void remote_async_inferior_event_handler (gdb_client_data);
224 static void remote_terminal_ours (struct target_ops *self);
226 static int remote_read_description_p (struct target_ops *target);
228 static void remote_console_output (char *msg);
230 static int remote_supports_cond_breakpoints (struct target_ops *self);
232 static int remote_can_run_breakpoint_commands (struct target_ops *self);
234 static void remote_btrace_reset (void);
236 static void remote_btrace_maybe_reopen (void);
238 static int stop_reply_queue_length (void);
240 static void readahead_cache_invalidate (void);
242 static void remote_unpush_and_throw (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 /* The max number of chars in debug output. The rest of chars are
289 #define REMOTE_DEBUG_MAX_CHAR 512
291 /* Data for the vFile:pread readahead cache. */
293 struct readahead_cache
295 /* The file descriptor for the file that is being cached. -1 if the
299 /* The offset into the file that the cache buffer corresponds
303 /* The buffer holding the cache contents. */
305 /* The buffer's size. We try to read as much as fits into a packet
309 /* Cache hit and miss counters. */
314 /* Description of the remote protocol state for the currently
315 connected target. This is per-target state, and independent of the
316 selected architecture. */
320 /* A buffer to use for incoming packets, and its current size. The
321 buffer is grown dynamically for larger incoming packets.
322 Outgoing packets may also be constructed in this buffer.
323 BUF_SIZE is always at least REMOTE_PACKET_SIZE;
324 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
329 /* True if we're going through initial connection setup (finding out
330 about the remote side's threads, relocating symbols, etc.). */
333 /* If we negotiated packet size explicitly (and thus can bypass
334 heuristics for the largest packet size that will not overflow
335 a buffer in the stub), this will be set to that packet size.
336 Otherwise zero, meaning to use the guessed size. */
337 long explicit_packet_size;
339 /* remote_wait is normally called when the target is running and
340 waits for a stop reply packet. But sometimes we need to call it
341 when the target is already stopped. We can send a "?" packet
342 and have remote_wait read the response. Or, if we already have
343 the response, we can stash it in BUF and tell remote_wait to
344 skip calling getpkt. This flag is set when BUF contains a
345 stop reply packet and the target is not waiting. */
346 int cached_wait_status;
348 /* True, if in no ack mode. That is, neither GDB nor the stub will
349 expect acks from each other. The connection is assumed to be
353 /* True if we're connected in extended remote mode. */
356 /* True if we resumed the target and we're waiting for the target to
357 stop. In the mean time, we can't start another command/query.
358 The remote server wouldn't be ready to process it, so we'd
359 timeout waiting for a reply that would never come and eventually
360 we'd close the connection. This can happen in asynchronous mode
361 because we allow GDB commands while the target is running. */
362 int waiting_for_stop_reply;
364 /* The status of the stub support for the various vCont actions. */
365 struct vCont_action_support supports_vCont;
367 /* Nonzero if the user has pressed Ctrl-C, but the target hasn't
368 responded to that. */
371 /* True if we saw a Ctrl-C while reading or writing from/to the
372 remote descriptor. At that point it is not safe to send a remote
373 interrupt packet, so we instead remember we saw the Ctrl-C and
374 process it once we're done with sending/receiving the current
375 packet, which should be shortly. If however that takes too long,
376 and the user presses Ctrl-C again, we offer to disconnect. */
377 int got_ctrlc_during_io;
379 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
380 remote_open knows that we don't have a file open when the program
382 struct serial *remote_desc;
384 /* These are the threads which we last sent to the remote system. The
385 TID member will be -1 for all or -2 for not sent yet. */
386 ptid_t general_thread;
387 ptid_t continue_thread;
389 /* This is the traceframe which we last selected on the remote system.
390 It will be -1 if no traceframe is selected. */
391 int remote_traceframe_number;
393 char *last_pass_packet;
395 /* The last QProgramSignals packet sent to the target. We bypass
396 sending a new program signals list down to the target if the new
397 packet is exactly the same as the last we sent. IOW, we only let
398 the target know about program signals list changes. */
399 char *last_program_signals_packet;
401 enum gdb_signal last_sent_signal;
405 /* The execution direction of the last resume we got. */
406 enum exec_direction_kind last_resume_exec_dir;
408 char *finished_object;
409 char *finished_annex;
410 ULONGEST finished_offset;
412 /* Should we try the 'ThreadInfo' query packet?
414 This variable (NOT available to the user: auto-detect only!)
415 determines whether GDB will use the new, simpler "ThreadInfo"
416 query or the older, more complex syntax for thread queries.
417 This is an auto-detect variable (set to true at each connect,
418 and set to false when the target fails to recognize it). */
419 int use_threadinfo_query;
420 int use_threadextra_query;
422 threadref echo_nextthread;
423 threadref nextthread;
424 threadref resultthreadlist[MAXTHREADLISTRESULTS];
426 /* The state of remote notification. */
427 struct remote_notif_state *notif_state;
429 /* The branch trace configuration. */
430 struct btrace_config btrace_config;
432 /* The argument to the last "vFile:setfs:" packet we sent, used
433 to avoid sending repeated unnecessary "vFile:setfs:" packets.
434 Initialized to -1 to indicate that no "vFile:setfs:" packet
435 has yet been sent. */
438 /* A readahead cache for vFile:pread. Often, reading a binary
439 involves a sequence of small reads. E.g., when parsing an ELF
440 file. A readahead cache helps mostly the case of remote
441 debugging on a connection with higher latency, due to the
442 request/reply nature of the RSP. We only cache data for a single
443 file descriptor at a time. */
444 struct readahead_cache readahead_cache;
447 /* Private data that we'll store in (struct thread_info)->private. */
448 struct private_thread_info
454 /* Whether the target stopped for a breakpoint/watchpoint. */
455 enum target_stop_reason stop_reason;
457 /* This is set to the data address of the access causing the target
458 to stop for a watchpoint. */
459 CORE_ADDR watch_data_address;
461 /* Fields used by the vCont action coalescing implemented in
462 remote_resume / remote_commit_resume. remote_resume stores each
463 thread's last resume request in these fields, so that a later
464 remote_commit_resume knows which is the proper action for this
465 thread to include in the vCont packet. */
467 /* True if the last target_resume call for this thread was a step
468 request, false if a continue request. */
469 int last_resume_step;
471 /* The signal specified in the last target_resume call for this
473 enum gdb_signal last_resume_sig;
475 /* Whether this thread was already vCont-resumed on the remote
481 free_private_thread_info (struct private_thread_info *info)
488 /* This data could be associated with a target, but we do not always
489 have access to the current target when we need it, so for now it is
490 static. This will be fine for as long as only one target is in use
492 static struct remote_state *remote_state;
494 static struct remote_state *
495 get_remote_state_raw (void)
500 /* Allocate a new struct remote_state with xmalloc, initialize it, and
503 static struct remote_state *
504 new_remote_state (void)
506 struct remote_state *result = XCNEW (struct remote_state);
508 /* The default buffer size is unimportant; it will be expanded
509 whenever a larger buffer is needed. */
510 result->buf_size = 400;
511 result->buf = (char *) xmalloc (result->buf_size);
512 result->remote_traceframe_number = -1;
513 result->last_sent_signal = GDB_SIGNAL_0;
514 result->last_resume_exec_dir = EXEC_FORWARD;
520 /* Description of the remote protocol for a given architecture. */
524 long offset; /* Offset into G packet. */
525 long regnum; /* GDB's internal register number. */
526 LONGEST pnum; /* Remote protocol register number. */
527 int in_g_packet; /* Always part of G packet. */
528 /* long size in bytes; == register_size (target_gdbarch (), regnum);
530 /* char *name; == gdbarch_register_name (target_gdbarch (), regnum);
534 struct remote_arch_state
536 /* Description of the remote protocol registers. */
537 long sizeof_g_packet;
539 /* Description of the remote protocol registers indexed by REGNUM
540 (making an array gdbarch_num_regs in size). */
541 struct packet_reg *regs;
543 /* This is the size (in chars) of the first response to the ``g''
544 packet. It is used as a heuristic when determining the maximum
545 size of memory-read and memory-write packets. A target will
546 typically only reserve a buffer large enough to hold the ``g''
547 packet. The size does not include packet overhead (headers and
549 long actual_register_packet_size;
551 /* This is the maximum size (in chars) of a non read/write packet.
552 It is also used as a cap on the size of read/write packets. */
553 long remote_packet_size;
556 /* Utility: generate error from an incoming stub packet. */
558 trace_error (char *buf)
561 return; /* not an error msg */
564 case '1': /* malformed packet error */
565 if (*++buf == '0') /* general case: */
566 error (_("remote.c: error in outgoing packet."));
568 error (_("remote.c: error in outgoing packet at field #%ld."),
569 strtol (buf, NULL, 16));
571 error (_("Target returns error code '%s'."), buf);
575 /* Utility: wait for reply from stub, while accepting "O" packets. */
577 remote_get_noisy_reply (char **buf_p,
580 do /* Loop on reply from remote stub. */
584 QUIT; /* Allow user to bail out with ^C. */
585 getpkt (buf_p, sizeof_buf, 0);
589 else if (startswith (buf, "qRelocInsn:"))
592 CORE_ADDR from, to, org_to;
594 int adjusted_size = 0;
597 p = buf + strlen ("qRelocInsn:");
598 pp = unpack_varlen_hex (p, &ul);
600 error (_("invalid qRelocInsn packet: %s"), buf);
604 unpack_varlen_hex (p, &ul);
611 gdbarch_relocate_instruction (target_gdbarch (), &to, from);
614 CATCH (ex, RETURN_MASK_ALL)
616 if (ex.error == MEMORY_ERROR)
618 /* Propagate memory errors silently back to the
619 target. The stub may have limited the range of
620 addresses we can write to, for example. */
624 /* Something unexpectedly bad happened. Be verbose
625 so we can tell what, and propagate the error back
626 to the stub, so it doesn't get stuck waiting for
628 exception_fprintf (gdb_stderr, ex,
629 _("warning: relocating instruction: "));
637 adjusted_size = to - org_to;
639 xsnprintf (buf, *sizeof_buf, "qRelocInsn:%x", adjusted_size);
643 else if (buf[0] == 'O' && buf[1] != 'K')
644 remote_console_output (buf + 1); /* 'O' message from stub */
646 return buf; /* Here's the actual reply. */
651 /* Handle for retreving the remote protocol data from gdbarch. */
652 static struct gdbarch_data *remote_gdbarch_data_handle;
654 static struct remote_arch_state *
655 get_remote_arch_state (void)
657 gdb_assert (target_gdbarch () != NULL);
658 return ((struct remote_arch_state *)
659 gdbarch_data (target_gdbarch (), remote_gdbarch_data_handle));
662 /* Fetch the global remote target state. */
664 static struct remote_state *
665 get_remote_state (void)
667 /* Make sure that the remote architecture state has been
668 initialized, because doing so might reallocate rs->buf. Any
669 function which calls getpkt also needs to be mindful of changes
670 to rs->buf, but this call limits the number of places which run
672 get_remote_arch_state ();
674 return get_remote_state_raw ();
677 /* Cleanup routine for the remote module's pspace data. */
680 remote_pspace_data_cleanup (struct program_space *pspace, void *arg)
682 char *remote_exec_file = (char *) arg;
684 xfree (remote_exec_file);
687 /* Fetch the remote exec-file from the current program space. */
690 get_remote_exec_file (void)
692 char *remote_exec_file;
695 = (char *) program_space_data (current_program_space,
697 if (remote_exec_file == NULL)
700 return remote_exec_file;
703 /* Set the remote exec file for PSPACE. */
706 set_pspace_remote_exec_file (struct program_space *pspace,
707 char *remote_exec_file)
709 char *old_file = (char *) program_space_data (pspace, remote_pspace_data);
712 set_program_space_data (pspace, remote_pspace_data,
713 xstrdup (remote_exec_file));
716 /* The "set/show remote exec-file" set command hook. */
719 set_remote_exec_file (char *ignored, int from_tty,
720 struct cmd_list_element *c)
722 gdb_assert (remote_exec_file_var != NULL);
723 set_pspace_remote_exec_file (current_program_space, remote_exec_file_var);
726 /* The "set/show remote exec-file" show command hook. */
729 show_remote_exec_file (struct ui_file *file, int from_tty,
730 struct cmd_list_element *cmd, const char *value)
732 fprintf_filtered (file, "%s\n", remote_exec_file_var);
736 compare_pnums (const void *lhs_, const void *rhs_)
738 const struct packet_reg * const *lhs
739 = (const struct packet_reg * const *) lhs_;
740 const struct packet_reg * const *rhs
741 = (const struct packet_reg * const *) rhs_;
743 if ((*lhs)->pnum < (*rhs)->pnum)
745 else if ((*lhs)->pnum == (*rhs)->pnum)
752 map_regcache_remote_table (struct gdbarch *gdbarch, struct packet_reg *regs)
754 int regnum, num_remote_regs, offset;
755 struct packet_reg **remote_regs;
757 for (regnum = 0; regnum < gdbarch_num_regs (gdbarch); regnum++)
759 struct packet_reg *r = ®s[regnum];
761 if (register_size (gdbarch, regnum) == 0)
762 /* Do not try to fetch zero-sized (placeholder) registers. */
765 r->pnum = gdbarch_remote_register_number (gdbarch, regnum);
770 /* Define the g/G packet format as the contents of each register
771 with a remote protocol number, in order of ascending protocol
774 remote_regs = XALLOCAVEC (struct packet_reg *, gdbarch_num_regs (gdbarch));
775 for (num_remote_regs = 0, regnum = 0;
776 regnum < gdbarch_num_regs (gdbarch);
778 if (regs[regnum].pnum != -1)
779 remote_regs[num_remote_regs++] = ®s[regnum];
781 qsort (remote_regs, num_remote_regs, sizeof (struct packet_reg *),
784 for (regnum = 0, offset = 0; regnum < num_remote_regs; regnum++)
786 remote_regs[regnum]->in_g_packet = 1;
787 remote_regs[regnum]->offset = offset;
788 offset += register_size (gdbarch, remote_regs[regnum]->regnum);
794 /* Given the architecture described by GDBARCH, return the remote
795 protocol register's number and the register's offset in the g/G
796 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
797 If the target does not have a mapping for REGNUM, return false,
798 otherwise, return true. */
801 remote_register_number_and_offset (struct gdbarch *gdbarch, int regnum,
802 int *pnum, int *poffset)
804 struct packet_reg *regs;
805 struct cleanup *old_chain;
807 gdb_assert (regnum < gdbarch_num_regs (gdbarch));
809 regs = XCNEWVEC (struct packet_reg, gdbarch_num_regs (gdbarch));
810 old_chain = make_cleanup (xfree, regs);
812 map_regcache_remote_table (gdbarch, regs);
814 *pnum = regs[regnum].pnum;
815 *poffset = regs[regnum].offset;
817 do_cleanups (old_chain);
823 init_remote_state (struct gdbarch *gdbarch)
825 struct remote_state *rs = get_remote_state_raw ();
826 struct remote_arch_state *rsa;
828 rsa = GDBARCH_OBSTACK_ZALLOC (gdbarch, struct remote_arch_state);
830 /* Use the architecture to build a regnum<->pnum table, which will be
831 1:1 unless a feature set specifies otherwise. */
832 rsa->regs = GDBARCH_OBSTACK_CALLOC (gdbarch,
833 gdbarch_num_regs (gdbarch),
836 /* Record the maximum possible size of the g packet - it may turn out
838 rsa->sizeof_g_packet = map_regcache_remote_table (gdbarch, rsa->regs);
840 /* Default maximum number of characters in a packet body. Many
841 remote stubs have a hardwired buffer size of 400 bytes
842 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
843 as the maximum packet-size to ensure that the packet and an extra
844 NUL character can always fit in the buffer. This stops GDB
845 trashing stubs that try to squeeze an extra NUL into what is
846 already a full buffer (As of 1999-12-04 that was most stubs). */
847 rsa->remote_packet_size = 400 - 1;
849 /* This one is filled in when a ``g'' packet is received. */
850 rsa->actual_register_packet_size = 0;
852 /* Should rsa->sizeof_g_packet needs more space than the
853 default, adjust the size accordingly. Remember that each byte is
854 encoded as two characters. 32 is the overhead for the packet
855 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
856 (``$NN:G...#NN'') is a better guess, the below has been padded a
858 if (rsa->sizeof_g_packet > ((rsa->remote_packet_size - 32) / 2))
859 rsa->remote_packet_size = (rsa->sizeof_g_packet * 2 + 32);
861 /* Make sure that the packet buffer is plenty big enough for
862 this architecture. */
863 if (rs->buf_size < rsa->remote_packet_size)
865 rs->buf_size = 2 * rsa->remote_packet_size;
866 rs->buf = (char *) xrealloc (rs->buf, rs->buf_size);
872 /* Return the current allowed size of a remote packet. This is
873 inferred from the current architecture, and should be used to
874 limit the length of outgoing packets. */
876 get_remote_packet_size (void)
878 struct remote_state *rs = get_remote_state ();
879 struct remote_arch_state *rsa = get_remote_arch_state ();
881 if (rs->explicit_packet_size)
882 return rs->explicit_packet_size;
884 return rsa->remote_packet_size;
887 static struct packet_reg *
888 packet_reg_from_regnum (struct remote_arch_state *rsa, long regnum)
890 if (regnum < 0 && regnum >= gdbarch_num_regs (target_gdbarch ()))
894 struct packet_reg *r = &rsa->regs[regnum];
896 gdb_assert (r->regnum == regnum);
901 static struct packet_reg *
902 packet_reg_from_pnum (struct remote_arch_state *rsa, LONGEST pnum)
906 for (i = 0; i < gdbarch_num_regs (target_gdbarch ()); i++)
908 struct packet_reg *r = &rsa->regs[i];
916 static struct target_ops remote_ops;
918 static struct target_ops extended_remote_ops;
920 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
921 ``forever'' still use the normal timeout mechanism. This is
922 currently used by the ASYNC code to guarentee that target reads
923 during the initial connect always time-out. Once getpkt has been
924 modified to return a timeout indication and, in turn
925 remote_wait()/wait_for_inferior() have gained a timeout parameter
927 static int wait_forever_enabled_p = 1;
929 /* Allow the user to specify what sequence to send to the remote
930 when he requests a program interruption: Although ^C is usually
931 what remote systems expect (this is the default, here), it is
932 sometimes preferable to send a break. On other systems such
933 as the Linux kernel, a break followed by g, which is Magic SysRq g
934 is required in order to interrupt the execution. */
935 const char interrupt_sequence_control_c[] = "Ctrl-C";
936 const char interrupt_sequence_break[] = "BREAK";
937 const char interrupt_sequence_break_g[] = "BREAK-g";
938 static const char *const interrupt_sequence_modes[] =
940 interrupt_sequence_control_c,
941 interrupt_sequence_break,
942 interrupt_sequence_break_g,
945 static const char *interrupt_sequence_mode = interrupt_sequence_control_c;
948 show_interrupt_sequence (struct ui_file *file, int from_tty,
949 struct cmd_list_element *c,
952 if (interrupt_sequence_mode == interrupt_sequence_control_c)
953 fprintf_filtered (file,
954 _("Send the ASCII ETX character (Ctrl-c) "
955 "to the remote target to interrupt the "
956 "execution of the program.\n"));
957 else if (interrupt_sequence_mode == interrupt_sequence_break)
958 fprintf_filtered (file,
959 _("send a break signal to the remote target "
960 "to interrupt the execution of the program.\n"));
961 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
962 fprintf_filtered (file,
963 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
964 "the remote target to interrupt the execution "
965 "of Linux kernel.\n"));
967 internal_error (__FILE__, __LINE__,
968 _("Invalid value for interrupt_sequence_mode: %s."),
969 interrupt_sequence_mode);
972 /* This boolean variable specifies whether interrupt_sequence is sent
973 to the remote target when gdb connects to it.
974 This is mostly needed when you debug the Linux kernel: The Linux kernel
975 expects BREAK g which is Magic SysRq g for connecting gdb. */
976 static int interrupt_on_connect = 0;
978 /* This variable is used to implement the "set/show remotebreak" commands.
979 Since these commands are now deprecated in favor of "set/show remote
980 interrupt-sequence", it no longer has any effect on the code. */
981 static int remote_break;
984 set_remotebreak (char *args, int from_tty, struct cmd_list_element *c)
987 interrupt_sequence_mode = interrupt_sequence_break;
989 interrupt_sequence_mode = interrupt_sequence_control_c;
993 show_remotebreak (struct ui_file *file, int from_tty,
994 struct cmd_list_element *c,
999 /* This variable sets the number of bits in an address that are to be
1000 sent in a memory ("M" or "m") packet. Normally, after stripping
1001 leading zeros, the entire address would be sent. This variable
1002 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
1003 initial implementation of remote.c restricted the address sent in
1004 memory packets to ``host::sizeof long'' bytes - (typically 32
1005 bits). Consequently, for 64 bit targets, the upper 32 bits of an
1006 address was never sent. Since fixing this bug may cause a break in
1007 some remote targets this variable is principly provided to
1008 facilitate backward compatibility. */
1010 static unsigned int remote_address_size;
1012 /* Temporary to track who currently owns the terminal. See
1013 remote_terminal_* for more details. */
1015 static int remote_async_terminal_ours_p;
1018 /* User configurable variables for the number of characters in a
1019 memory read/write packet. MIN (rsa->remote_packet_size,
1020 rsa->sizeof_g_packet) is the default. Some targets need smaller
1021 values (fifo overruns, et.al.) and some users need larger values
1022 (speed up transfers). The variables ``preferred_*'' (the user
1023 request), ``current_*'' (what was actually set) and ``forced_*''
1024 (Positive - a soft limit, negative - a hard limit). */
1026 struct memory_packet_config
1033 /* The default max memory-write-packet-size. The 16k is historical.
1034 (It came from older GDB's using alloca for buffers and the
1035 knowledge (folklore?) that some hosts don't cope very well with
1036 large alloca calls.) */
1037 #define DEFAULT_MAX_MEMORY_PACKET_SIZE 16384
1039 /* The minimum remote packet size for memory transfers. Ensures we
1040 can write at least one byte. */
1041 #define MIN_MEMORY_PACKET_SIZE 20
1043 /* Compute the current size of a read/write packet. Since this makes
1044 use of ``actual_register_packet_size'' the computation is dynamic. */
1047 get_memory_packet_size (struct memory_packet_config *config)
1049 struct remote_state *rs = get_remote_state ();
1050 struct remote_arch_state *rsa = get_remote_arch_state ();
1053 if (config->fixed_p)
1055 if (config->size <= 0)
1056 what_they_get = DEFAULT_MAX_MEMORY_PACKET_SIZE;
1058 what_they_get = config->size;
1062 what_they_get = get_remote_packet_size ();
1063 /* Limit the packet to the size specified by the user. */
1064 if (config->size > 0
1065 && what_they_get > config->size)
1066 what_they_get = config->size;
1068 /* Limit it to the size of the targets ``g'' response unless we have
1069 permission from the stub to use a larger packet size. */
1070 if (rs->explicit_packet_size == 0
1071 && rsa->actual_register_packet_size > 0
1072 && what_they_get > rsa->actual_register_packet_size)
1073 what_they_get = rsa->actual_register_packet_size;
1075 if (what_they_get < MIN_MEMORY_PACKET_SIZE)
1076 what_they_get = MIN_MEMORY_PACKET_SIZE;
1078 /* Make sure there is room in the global buffer for this packet
1079 (including its trailing NUL byte). */
1080 if (rs->buf_size < what_they_get + 1)
1082 rs->buf_size = 2 * what_they_get;
1083 rs->buf = (char *) xrealloc (rs->buf, 2 * what_they_get);
1086 return what_they_get;
1089 /* Update the size of a read/write packet. If they user wants
1090 something really big then do a sanity check. */
1093 set_memory_packet_size (char *args, struct memory_packet_config *config)
1095 int fixed_p = config->fixed_p;
1096 long size = config->size;
1099 error (_("Argument required (integer, `fixed' or `limited')."));
1100 else if (strcmp (args, "hard") == 0
1101 || strcmp (args, "fixed") == 0)
1103 else if (strcmp (args, "soft") == 0
1104 || strcmp (args, "limit") == 0)
1110 size = strtoul (args, &end, 0);
1112 error (_("Invalid %s (bad syntax)."), config->name);
1114 /* Instead of explicitly capping the size of a packet to or
1115 disallowing it, the user is allowed to set the size to
1116 something arbitrarily large. */
1119 /* So that the query shows the correct value. */
1121 size = DEFAULT_MAX_MEMORY_PACKET_SIZE;
1124 if (fixed_p && !config->fixed_p)
1126 if (! query (_("The target may not be able to correctly handle a %s\n"
1127 "of %ld bytes. Change the packet size? "),
1128 config->name, size))
1129 error (_("Packet size not changed."));
1131 /* Update the config. */
1132 config->fixed_p = fixed_p;
1133 config->size = size;
1137 show_memory_packet_size (struct memory_packet_config *config)
1139 printf_filtered (_("The %s is %ld. "), config->name, config->size);
1140 if (config->fixed_p)
1141 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
1142 get_memory_packet_size (config));
1144 printf_filtered (_("Packets are limited to %ld bytes.\n"),
1145 get_memory_packet_size (config));
1148 static struct memory_packet_config memory_write_packet_config =
1150 "memory-write-packet-size",
1154 set_memory_write_packet_size (char *args, int from_tty)
1156 set_memory_packet_size (args, &memory_write_packet_config);
1160 show_memory_write_packet_size (char *args, int from_tty)
1162 show_memory_packet_size (&memory_write_packet_config);
1166 get_memory_write_packet_size (void)
1168 return get_memory_packet_size (&memory_write_packet_config);
1171 static struct memory_packet_config memory_read_packet_config =
1173 "memory-read-packet-size",
1177 set_memory_read_packet_size (char *args, int from_tty)
1179 set_memory_packet_size (args, &memory_read_packet_config);
1183 show_memory_read_packet_size (char *args, int from_tty)
1185 show_memory_packet_size (&memory_read_packet_config);
1189 get_memory_read_packet_size (void)
1191 long size = get_memory_packet_size (&memory_read_packet_config);
1193 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1194 extra buffer size argument before the memory read size can be
1195 increased beyond this. */
1196 if (size > get_remote_packet_size ())
1197 size = get_remote_packet_size ();
1202 /* Generic configuration support for packets the stub optionally
1203 supports. Allows the user to specify the use of the packet as well
1204 as allowing GDB to auto-detect support in the remote stub. */
1208 PACKET_SUPPORT_UNKNOWN = 0,
1213 struct packet_config
1218 /* If auto, GDB auto-detects support for this packet or feature,
1219 either through qSupported, or by trying the packet and looking
1220 at the response. If true, GDB assumes the target supports this
1221 packet. If false, the packet is disabled. Configs that don't
1222 have an associated command always have this set to auto. */
1223 enum auto_boolean detect;
1225 /* Does the target support this packet? */
1226 enum packet_support support;
1229 /* Analyze a packet's return value and update the packet config
1239 static enum packet_support packet_config_support (struct packet_config *config);
1240 static enum packet_support packet_support (int packet);
1243 show_packet_config_cmd (struct packet_config *config)
1245 const char *support = "internal-error";
1247 switch (packet_config_support (config))
1250 support = "enabled";
1252 case PACKET_DISABLE:
1253 support = "disabled";
1255 case PACKET_SUPPORT_UNKNOWN:
1256 support = "unknown";
1259 switch (config->detect)
1261 case AUTO_BOOLEAN_AUTO:
1262 printf_filtered (_("Support for the `%s' packet "
1263 "is auto-detected, currently %s.\n"),
1264 config->name, support);
1266 case AUTO_BOOLEAN_TRUE:
1267 case AUTO_BOOLEAN_FALSE:
1268 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1269 config->name, support);
1275 add_packet_config_cmd (struct packet_config *config, const char *name,
1276 const char *title, int legacy)
1282 config->name = name;
1283 config->title = title;
1284 set_doc = xstrprintf ("Set use of remote protocol `%s' (%s) packet",
1286 show_doc = xstrprintf ("Show current use of remote "
1287 "protocol `%s' (%s) packet",
1289 /* set/show TITLE-packet {auto,on,off} */
1290 cmd_name = xstrprintf ("%s-packet", title);
1291 add_setshow_auto_boolean_cmd (cmd_name, class_obscure,
1292 &config->detect, set_doc,
1293 show_doc, NULL, /* help_doc */
1295 show_remote_protocol_packet_cmd,
1296 &remote_set_cmdlist, &remote_show_cmdlist);
1297 /* The command code copies the documentation strings. */
1300 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1305 legacy_name = xstrprintf ("%s-packet", name);
1306 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1307 &remote_set_cmdlist);
1308 add_alias_cmd (legacy_name, cmd_name, class_obscure, 0,
1309 &remote_show_cmdlist);
1313 static enum packet_result
1314 packet_check_result (const char *buf)
1318 /* The stub recognized the packet request. Check that the
1319 operation succeeded. */
1321 && isxdigit (buf[1]) && isxdigit (buf[2])
1323 /* "Enn" - definitly an error. */
1324 return PACKET_ERROR;
1326 /* Always treat "E." as an error. This will be used for
1327 more verbose error messages, such as E.memtypes. */
1328 if (buf[0] == 'E' && buf[1] == '.')
1329 return PACKET_ERROR;
1331 /* The packet may or may not be OK. Just assume it is. */
1335 /* The stub does not support the packet. */
1336 return PACKET_UNKNOWN;
1339 static enum packet_result
1340 packet_ok (const char *buf, struct packet_config *config)
1342 enum packet_result result;
1344 if (config->detect != AUTO_BOOLEAN_TRUE
1345 && config->support == PACKET_DISABLE)
1346 internal_error (__FILE__, __LINE__,
1347 _("packet_ok: attempt to use a disabled packet"));
1349 result = packet_check_result (buf);
1354 /* The stub recognized the packet request. */
1355 if (config->support == PACKET_SUPPORT_UNKNOWN)
1358 fprintf_unfiltered (gdb_stdlog,
1359 "Packet %s (%s) is supported\n",
1360 config->name, config->title);
1361 config->support = PACKET_ENABLE;
1364 case PACKET_UNKNOWN:
1365 /* The stub does not support the packet. */
1366 if (config->detect == AUTO_BOOLEAN_AUTO
1367 && config->support == PACKET_ENABLE)
1369 /* If the stub previously indicated that the packet was
1370 supported then there is a protocol error. */
1371 error (_("Protocol error: %s (%s) conflicting enabled responses."),
1372 config->name, config->title);
1374 else if (config->detect == AUTO_BOOLEAN_TRUE)
1376 /* The user set it wrong. */
1377 error (_("Enabled packet %s (%s) not recognized by stub"),
1378 config->name, config->title);
1382 fprintf_unfiltered (gdb_stdlog,
1383 "Packet %s (%s) is NOT supported\n",
1384 config->name, config->title);
1385 config->support = PACKET_DISABLE;
1406 PACKET_vFile_pwrite,
1408 PACKET_vFile_unlink,
1409 PACKET_vFile_readlink,
1412 PACKET_qXfer_features,
1413 PACKET_qXfer_exec_file,
1414 PACKET_qXfer_libraries,
1415 PACKET_qXfer_libraries_svr4,
1416 PACKET_qXfer_memory_map,
1417 PACKET_qXfer_spu_read,
1418 PACKET_qXfer_spu_write,
1419 PACKET_qXfer_osdata,
1420 PACKET_qXfer_threads,
1421 PACKET_qXfer_statictrace_read,
1422 PACKET_qXfer_traceframe_info,
1428 PACKET_QPassSignals,
1429 PACKET_QCatchSyscalls,
1430 PACKET_QProgramSignals,
1431 PACKET_QStartupWithShell,
1432 PACKET_QEnvironmentHexEncoded,
1433 PACKET_QEnvironmentReset,
1434 PACKET_QEnvironmentUnset,
1436 PACKET_qSearch_memory,
1439 PACKET_QStartNoAckMode,
1441 PACKET_qXfer_siginfo_read,
1442 PACKET_qXfer_siginfo_write,
1445 /* Support for conditional tracepoints. */
1446 PACKET_ConditionalTracepoints,
1448 /* Support for target-side breakpoint conditions. */
1449 PACKET_ConditionalBreakpoints,
1451 /* Support for target-side breakpoint commands. */
1452 PACKET_BreakpointCommands,
1454 /* Support for fast tracepoints. */
1455 PACKET_FastTracepoints,
1457 /* Support for static tracepoints. */
1458 PACKET_StaticTracepoints,
1460 /* Support for installing tracepoints while a trace experiment is
1462 PACKET_InstallInTrace,
1466 PACKET_TracepointSource,
1469 PACKET_QDisableRandomization,
1471 PACKET_QTBuffer_size,
1475 PACKET_qXfer_btrace,
1477 /* Support for the QNonStop packet. */
1480 /* Support for the QThreadEvents packet. */
1481 PACKET_QThreadEvents,
1483 /* Support for multi-process extensions. */
1484 PACKET_multiprocess_feature,
1486 /* Support for enabling and disabling tracepoints while a trace
1487 experiment is running. */
1488 PACKET_EnableDisableTracepoints_feature,
1490 /* Support for collecting strings using the tracenz bytecode. */
1491 PACKET_tracenz_feature,
1493 /* Support for continuing to run a trace experiment while GDB is
1495 PACKET_DisconnectedTracing_feature,
1497 /* Support for qXfer:libraries-svr4:read with a non-empty annex. */
1498 PACKET_augmented_libraries_svr4_read_feature,
1500 /* Support for the qXfer:btrace-conf:read packet. */
1501 PACKET_qXfer_btrace_conf,
1503 /* Support for the Qbtrace-conf:bts:size packet. */
1504 PACKET_Qbtrace_conf_bts_size,
1506 /* Support for swbreak+ feature. */
1507 PACKET_swbreak_feature,
1509 /* Support for hwbreak+ feature. */
1510 PACKET_hwbreak_feature,
1512 /* Support for fork events. */
1513 PACKET_fork_event_feature,
1515 /* Support for vfork events. */
1516 PACKET_vfork_event_feature,
1518 /* Support for the Qbtrace-conf:pt:size packet. */
1519 PACKET_Qbtrace_conf_pt_size,
1521 /* Support for exec events. */
1522 PACKET_exec_event_feature,
1524 /* Support for query supported vCont actions. */
1525 PACKET_vContSupported,
1527 /* Support remote CTRL-C. */
1530 /* Support TARGET_WAITKIND_NO_RESUMED. */
1536 static struct packet_config remote_protocol_packets[PACKET_MAX];
1538 /* Returns the packet's corresponding "set remote foo-packet" command
1539 state. See struct packet_config for more details. */
1541 static enum auto_boolean
1542 packet_set_cmd_state (int packet)
1544 return remote_protocol_packets[packet].detect;
1547 /* Returns whether a given packet or feature is supported. This takes
1548 into account the state of the corresponding "set remote foo-packet"
1549 command, which may be used to bypass auto-detection. */
1551 static enum packet_support
1552 packet_config_support (struct packet_config *config)
1554 switch (config->detect)
1556 case AUTO_BOOLEAN_TRUE:
1557 return PACKET_ENABLE;
1558 case AUTO_BOOLEAN_FALSE:
1559 return PACKET_DISABLE;
1560 case AUTO_BOOLEAN_AUTO:
1561 return config->support;
1563 gdb_assert_not_reached (_("bad switch"));
1567 /* Same as packet_config_support, but takes the packet's enum value as
1570 static enum packet_support
1571 packet_support (int packet)
1573 struct packet_config *config = &remote_protocol_packets[packet];
1575 return packet_config_support (config);
1579 show_remote_protocol_packet_cmd (struct ui_file *file, int from_tty,
1580 struct cmd_list_element *c,
1583 struct packet_config *packet;
1585 for (packet = remote_protocol_packets;
1586 packet < &remote_protocol_packets[PACKET_MAX];
1589 if (&packet->detect == c->var)
1591 show_packet_config_cmd (packet);
1595 internal_error (__FILE__, __LINE__, _("Could not find config for %s"),
1599 /* Should we try one of the 'Z' requests? */
1603 Z_PACKET_SOFTWARE_BP,
1604 Z_PACKET_HARDWARE_BP,
1611 /* For compatibility with older distributions. Provide a ``set remote
1612 Z-packet ...'' command that updates all the Z packet types. */
1614 static enum auto_boolean remote_Z_packet_detect;
1617 set_remote_protocol_Z_packet_cmd (char *args, int from_tty,
1618 struct cmd_list_element *c)
1622 for (i = 0; i < NR_Z_PACKET_TYPES; i++)
1623 remote_protocol_packets[PACKET_Z0 + i].detect = remote_Z_packet_detect;
1627 show_remote_protocol_Z_packet_cmd (struct ui_file *file, int from_tty,
1628 struct cmd_list_element *c,
1633 for (i = 0; i < NR_Z_PACKET_TYPES; i++)
1635 show_packet_config_cmd (&remote_protocol_packets[PACKET_Z0 + i]);
1639 /* Returns true if the multi-process extensions are in effect. */
1642 remote_multi_process_p (struct remote_state *rs)
1644 return packet_support (PACKET_multiprocess_feature) == PACKET_ENABLE;
1647 /* Returns true if fork events are supported. */
1650 remote_fork_event_p (struct remote_state *rs)
1652 return packet_support (PACKET_fork_event_feature) == PACKET_ENABLE;
1655 /* Returns true if vfork events are supported. */
1658 remote_vfork_event_p (struct remote_state *rs)
1660 return packet_support (PACKET_vfork_event_feature) == PACKET_ENABLE;
1663 /* Returns true if exec events are supported. */
1666 remote_exec_event_p (struct remote_state *rs)
1668 return packet_support (PACKET_exec_event_feature) == PACKET_ENABLE;
1671 /* Insert fork catchpoint target routine. If fork events are enabled
1672 then return success, nothing more to do. */
1675 remote_insert_fork_catchpoint (struct target_ops *ops, int pid)
1677 struct remote_state *rs = get_remote_state ();
1679 return !remote_fork_event_p (rs);
1682 /* Remove fork catchpoint target routine. Nothing to do, just
1686 remote_remove_fork_catchpoint (struct target_ops *ops, int pid)
1691 /* Insert vfork catchpoint target routine. If vfork events are enabled
1692 then return success, nothing more to do. */
1695 remote_insert_vfork_catchpoint (struct target_ops *ops, int pid)
1697 struct remote_state *rs = get_remote_state ();
1699 return !remote_vfork_event_p (rs);
1702 /* Remove vfork catchpoint target routine. Nothing to do, just
1706 remote_remove_vfork_catchpoint (struct target_ops *ops, int pid)
1711 /* Insert exec catchpoint target routine. If exec events are
1712 enabled, just return success. */
1715 remote_insert_exec_catchpoint (struct target_ops *ops, int pid)
1717 struct remote_state *rs = get_remote_state ();
1719 return !remote_exec_event_p (rs);
1722 /* Remove exec catchpoint target routine. Nothing to do, just
1726 remote_remove_exec_catchpoint (struct target_ops *ops, int pid)
1732 /* Asynchronous signal handle registered as event loop source for
1733 when we have pending events ready to be passed to the core. */
1735 static struct async_event_handler *remote_async_inferior_event_token;
1739 static ptid_t magic_null_ptid;
1740 static ptid_t not_sent_ptid;
1741 static ptid_t any_thread_ptid;
1743 /* Find out if the stub attached to PID (and hence GDB should offer to
1744 detach instead of killing it when bailing out). */
1747 remote_query_attached (int pid)
1749 struct remote_state *rs = get_remote_state ();
1750 size_t size = get_remote_packet_size ();
1752 if (packet_support (PACKET_qAttached) == PACKET_DISABLE)
1755 if (remote_multi_process_p (rs))
1756 xsnprintf (rs->buf, size, "qAttached:%x", pid);
1758 xsnprintf (rs->buf, size, "qAttached");
1761 getpkt (&rs->buf, &rs->buf_size, 0);
1763 switch (packet_ok (rs->buf,
1764 &remote_protocol_packets[PACKET_qAttached]))
1767 if (strcmp (rs->buf, "1") == 0)
1771 warning (_("Remote failure reply: %s"), rs->buf);
1773 case PACKET_UNKNOWN:
1780 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
1781 has been invented by GDB, instead of reported by the target. Since
1782 we can be connected to a remote system before before knowing about
1783 any inferior, mark the target with execution when we find the first
1784 inferior. If ATTACHED is 1, then we had just attached to this
1785 inferior. If it is 0, then we just created this inferior. If it
1786 is -1, then try querying the remote stub to find out if it had
1787 attached to the inferior or not. If TRY_OPEN_EXEC is true then
1788 attempt to open this inferior's executable as the main executable
1789 if no main executable is open already. */
1791 static struct inferior *
1792 remote_add_inferior (int fake_pid_p, int pid, int attached,
1795 struct inferior *inf;
1797 /* Check whether this process we're learning about is to be
1798 considered attached, or if is to be considered to have been
1799 spawned by the stub. */
1801 attached = remote_query_attached (pid);
1803 if (gdbarch_has_global_solist (target_gdbarch ()))
1805 /* If the target shares code across all inferiors, then every
1806 attach adds a new inferior. */
1807 inf = add_inferior (pid);
1809 /* ... and every inferior is bound to the same program space.
1810 However, each inferior may still have its own address
1812 inf->aspace = maybe_new_address_space ();
1813 inf->pspace = current_program_space;
1817 /* In the traditional debugging scenario, there's a 1-1 match
1818 between program/address spaces. We simply bind the inferior
1819 to the program space's address space. */
1820 inf = current_inferior ();
1821 inferior_appeared (inf, pid);
1824 inf->attach_flag = attached;
1825 inf->fake_pid_p = fake_pid_p;
1827 /* If no main executable is currently open then attempt to
1828 open the file that was executed to create this inferior. */
1829 if (try_open_exec && get_exec_file (0) == NULL)
1830 exec_file_locate_attach (pid, 0, 1);
1835 static struct private_thread_info *
1836 get_private_info_thread (struct thread_info *info);
1838 /* Add thread PTID to GDB's thread list. Tag it as executing/running
1839 according to RUNNING. */
1842 remote_add_thread (ptid_t ptid, int running, int executing)
1844 struct remote_state *rs = get_remote_state ();
1845 struct thread_info *thread;
1847 /* GDB historically didn't pull threads in the initial connection
1848 setup. If the remote target doesn't even have a concept of
1849 threads (e.g., a bare-metal target), even if internally we
1850 consider that a single-threaded target, mentioning a new thread
1851 might be confusing to the user. Be silent then, preserving the
1852 age old behavior. */
1853 if (rs->starting_up)
1854 thread = add_thread_silent (ptid);
1856 thread = add_thread (ptid);
1858 get_private_info_thread (thread)->vcont_resumed = executing;
1859 set_executing (ptid, executing);
1860 set_running (ptid, running);
1863 /* Come here when we learn about a thread id from the remote target.
1864 It may be the first time we hear about such thread, so take the
1865 opportunity to add it to GDB's thread list. In case this is the
1866 first time we're noticing its corresponding inferior, add it to
1867 GDB's inferior list as well. EXECUTING indicates whether the
1868 thread is (internally) executing or stopped. */
1871 remote_notice_new_inferior (ptid_t currthread, int executing)
1873 /* In non-stop mode, we assume new found threads are (externally)
1874 running until proven otherwise with a stop reply. In all-stop,
1875 we can only get here if all threads are stopped. */
1876 int running = target_is_non_stop_p () ? 1 : 0;
1878 /* If this is a new thread, add it to GDB's thread list.
1879 If we leave it up to WFI to do this, bad things will happen. */
1881 if (in_thread_list (currthread) && is_exited (currthread))
1883 /* We're seeing an event on a thread id we knew had exited.
1884 This has to be a new thread reusing the old id. Add it. */
1885 remote_add_thread (currthread, running, executing);
1889 if (!in_thread_list (currthread))
1891 struct inferior *inf = NULL;
1892 int pid = ptid_get_pid (currthread);
1894 if (ptid_is_pid (inferior_ptid)
1895 && pid == ptid_get_pid (inferior_ptid))
1897 /* inferior_ptid has no thread member yet. This can happen
1898 with the vAttach -> remote_wait,"TAAthread:" path if the
1899 stub doesn't support qC. This is the first stop reported
1900 after an attach, so this is the main thread. Update the
1901 ptid in the thread list. */
1902 if (in_thread_list (pid_to_ptid (pid)))
1903 thread_change_ptid (inferior_ptid, currthread);
1906 remote_add_thread (currthread, running, executing);
1907 inferior_ptid = currthread;
1912 if (ptid_equal (magic_null_ptid, inferior_ptid))
1914 /* inferior_ptid is not set yet. This can happen with the
1915 vRun -> remote_wait,"TAAthread:" path if the stub
1916 doesn't support qC. This is the first stop reported
1917 after an attach, so this is the main thread. Update the
1918 ptid in the thread list. */
1919 thread_change_ptid (inferior_ptid, currthread);
1923 /* When connecting to a target remote, or to a target
1924 extended-remote which already was debugging an inferior, we
1925 may not know about it yet. Add it before adding its child
1926 thread, so notifications are emitted in a sensible order. */
1927 if (!in_inferior_list (ptid_get_pid (currthread)))
1929 struct remote_state *rs = get_remote_state ();
1930 int fake_pid_p = !remote_multi_process_p (rs);
1932 inf = remote_add_inferior (fake_pid_p,
1933 ptid_get_pid (currthread), -1, 1);
1936 /* This is really a new thread. Add it. */
1937 remote_add_thread (currthread, running, executing);
1939 /* If we found a new inferior, let the common code do whatever
1940 it needs to with it (e.g., read shared libraries, insert
1941 breakpoints), unless we're just setting up an all-stop
1945 struct remote_state *rs = get_remote_state ();
1947 if (!rs->starting_up)
1948 notice_new_inferior (currthread, executing, 0);
1953 /* Return THREAD's private thread data, creating it if necessary. */
1955 static struct private_thread_info *
1956 get_private_info_thread (struct thread_info *thread)
1958 gdb_assert (thread != NULL);
1960 if (thread->priv == NULL)
1962 struct private_thread_info *priv = XNEW (struct private_thread_info);
1964 thread->private_dtor = free_private_thread_info;
1965 thread->priv = priv;
1971 priv->last_resume_step = 0;
1972 priv->last_resume_sig = GDB_SIGNAL_0;
1973 priv->vcont_resumed = 0;
1976 return thread->priv;
1979 /* Return PTID's private thread data, creating it if necessary. */
1981 static struct private_thread_info *
1982 get_private_info_ptid (ptid_t ptid)
1984 struct thread_info *info = find_thread_ptid (ptid);
1986 return get_private_info_thread (info);
1989 /* Call this function as a result of
1990 1) A halt indication (T packet) containing a thread id
1991 2) A direct query of currthread
1992 3) Successful execution of set thread */
1995 record_currthread (struct remote_state *rs, ptid_t currthread)
1997 rs->general_thread = currthread;
2000 /* If 'QPassSignals' is supported, tell the remote stub what signals
2001 it can simply pass through to the inferior without reporting. */
2004 remote_pass_signals (struct target_ops *self,
2005 int numsigs, unsigned char *pass_signals)
2007 if (packet_support (PACKET_QPassSignals) != PACKET_DISABLE)
2009 char *pass_packet, *p;
2011 struct remote_state *rs = get_remote_state ();
2013 gdb_assert (numsigs < 256);
2014 for (i = 0; i < numsigs; i++)
2016 if (pass_signals[i])
2019 pass_packet = (char *) xmalloc (count * 3 + strlen ("QPassSignals:") + 1);
2020 strcpy (pass_packet, "QPassSignals:");
2021 p = pass_packet + strlen (pass_packet);
2022 for (i = 0; i < numsigs; i++)
2024 if (pass_signals[i])
2027 *p++ = tohex (i >> 4);
2028 *p++ = tohex (i & 15);
2037 if (!rs->last_pass_packet || strcmp (rs->last_pass_packet, pass_packet))
2039 putpkt (pass_packet);
2040 getpkt (&rs->buf, &rs->buf_size, 0);
2041 packet_ok (rs->buf, &remote_protocol_packets[PACKET_QPassSignals]);
2042 if (rs->last_pass_packet)
2043 xfree (rs->last_pass_packet);
2044 rs->last_pass_packet = pass_packet;
2047 xfree (pass_packet);
2051 /* If 'QCatchSyscalls' is supported, tell the remote stub
2052 to report syscalls to GDB. */
2055 remote_set_syscall_catchpoint (struct target_ops *self,
2056 int pid, int needed, int any_count,
2057 int table_size, int *table)
2060 enum packet_result result;
2063 if (packet_support (PACKET_QCatchSyscalls) == PACKET_DISABLE)
2065 /* Not supported. */
2069 if (needed && !any_count)
2073 /* Count how many syscalls are to be caught (table[sysno] != 0). */
2074 for (i = 0; i < table_size; i++)
2083 fprintf_unfiltered (gdb_stdlog,
2084 "remote_set_syscall_catchpoint "
2085 "pid %d needed %d any_count %d n_sysno %d\n",
2086 pid, needed, any_count, n_sysno);
2091 /* Prepare a packet with the sysno list, assuming max 8+1
2092 characters for a sysno. If the resulting packet size is too
2093 big, fallback on the non-selective packet. */
2094 const int maxpktsz = strlen ("QCatchSyscalls:1") + n_sysno * 9 + 1;
2096 catch_packet = (char *) xmalloc (maxpktsz);
2097 strcpy (catch_packet, "QCatchSyscalls:1");
2106 /* Add in catch_packet each syscall to be caught (table[i] != 0). */
2107 for (i = 0; i < table_size; i++)
2110 p += xsnprintf (p, catch_packet + maxpktsz - p, ";%x", i);
2113 if (strlen (catch_packet) > get_remote_packet_size ())
2115 /* catch_packet too big. Fallback to less efficient
2116 non selective mode, with GDB doing the filtering. */
2117 catch_packet[sizeof ("QCatchSyscalls:1") - 1] = 0;
2121 catch_packet = xstrdup ("QCatchSyscalls:0");
2124 struct cleanup *old_chain = make_cleanup (xfree, catch_packet);
2125 struct remote_state *rs = get_remote_state ();
2127 putpkt (catch_packet);
2128 getpkt (&rs->buf, &rs->buf_size, 0);
2129 result = packet_ok (rs->buf, &remote_protocol_packets[PACKET_QCatchSyscalls]);
2130 do_cleanups (old_chain);
2131 if (result == PACKET_OK)
2138 /* If 'QProgramSignals' is supported, tell the remote stub what
2139 signals it should pass through to the inferior when detaching. */
2142 remote_program_signals (struct target_ops *self,
2143 int numsigs, unsigned char *signals)
2145 if (packet_support (PACKET_QProgramSignals) != PACKET_DISABLE)
2149 struct remote_state *rs = get_remote_state ();
2151 gdb_assert (numsigs < 256);
2152 for (i = 0; i < numsigs; i++)
2157 packet = (char *) xmalloc (count * 3 + strlen ("QProgramSignals:") + 1);
2158 strcpy (packet, "QProgramSignals:");
2159 p = packet + strlen (packet);
2160 for (i = 0; i < numsigs; i++)
2162 if (signal_pass_state (i))
2165 *p++ = tohex (i >> 4);
2166 *p++ = tohex (i & 15);
2175 if (!rs->last_program_signals_packet
2176 || strcmp (rs->last_program_signals_packet, packet) != 0)
2179 getpkt (&rs->buf, &rs->buf_size, 0);
2180 packet_ok (rs->buf, &remote_protocol_packets[PACKET_QProgramSignals]);
2181 xfree (rs->last_program_signals_packet);
2182 rs->last_program_signals_packet = packet;
2189 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
2190 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
2191 thread. If GEN is set, set the general thread, if not, then set
2192 the step/continue thread. */
2194 set_thread (ptid_t ptid, int gen)
2196 struct remote_state *rs = get_remote_state ();
2197 ptid_t state = gen ? rs->general_thread : rs->continue_thread;
2198 char *buf = rs->buf;
2199 char *endbuf = rs->buf + get_remote_packet_size ();
2201 if (ptid_equal (state, ptid))
2205 *buf++ = gen ? 'g' : 'c';
2206 if (ptid_equal (ptid, magic_null_ptid))
2207 xsnprintf (buf, endbuf - buf, "0");
2208 else if (ptid_equal (ptid, any_thread_ptid))
2209 xsnprintf (buf, endbuf - buf, "0");
2210 else if (ptid_equal (ptid, minus_one_ptid))
2211 xsnprintf (buf, endbuf - buf, "-1");
2213 write_ptid (buf, endbuf, ptid);
2215 getpkt (&rs->buf, &rs->buf_size, 0);
2217 rs->general_thread = ptid;
2219 rs->continue_thread = ptid;
2223 set_general_thread (ptid_t ptid)
2225 set_thread (ptid, 1);
2229 set_continue_thread (ptid_t ptid)
2231 set_thread (ptid, 0);
2234 /* Change the remote current process. Which thread within the process
2235 ends up selected isn't important, as long as it is the same process
2236 as what INFERIOR_PTID points to.
2238 This comes from that fact that there is no explicit notion of
2239 "selected process" in the protocol. The selected process for
2240 general operations is the process the selected general thread
2244 set_general_process (void)
2246 struct remote_state *rs = get_remote_state ();
2248 /* If the remote can't handle multiple processes, don't bother. */
2249 if (!remote_multi_process_p (rs))
2252 /* We only need to change the remote current thread if it's pointing
2253 at some other process. */
2254 if (ptid_get_pid (rs->general_thread) != ptid_get_pid (inferior_ptid))
2255 set_general_thread (inferior_ptid);
2259 /* Return nonzero if this is the main thread that we made up ourselves
2260 to model non-threaded targets as single-threaded. */
2263 remote_thread_always_alive (struct target_ops *ops, ptid_t ptid)
2265 if (ptid_equal (ptid, magic_null_ptid))
2266 /* The main thread is always alive. */
2269 if (ptid_get_pid (ptid) != 0 && ptid_get_lwp (ptid) == 0)
2270 /* The main thread is always alive. This can happen after a
2271 vAttach, if the remote side doesn't support
2278 /* Return nonzero if the thread PTID is still alive on the remote
2282 remote_thread_alive (struct target_ops *ops, ptid_t ptid)
2284 struct remote_state *rs = get_remote_state ();
2287 /* Check if this is a thread that we made up ourselves to model
2288 non-threaded targets as single-threaded. */
2289 if (remote_thread_always_alive (ops, ptid))
2293 endp = rs->buf + get_remote_packet_size ();
2296 write_ptid (p, endp, ptid);
2299 getpkt (&rs->buf, &rs->buf_size, 0);
2300 return (rs->buf[0] == 'O' && rs->buf[1] == 'K');
2303 /* Return a pointer to a thread name if we know it and NULL otherwise.
2304 The thread_info object owns the memory for the name. */
2307 remote_thread_name (struct target_ops *ops, struct thread_info *info)
2309 if (info->priv != NULL)
2310 return info->priv->name;
2315 /* About these extended threadlist and threadinfo packets. They are
2316 variable length packets but, the fields within them are often fixed
2317 length. They are redundent enough to send over UDP as is the
2318 remote protocol in general. There is a matching unit test module
2321 /* WARNING: This threadref data structure comes from the remote O.S.,
2322 libstub protocol encoding, and remote.c. It is not particularly
2325 /* Right now, the internal structure is int. We want it to be bigger.
2326 Plan to fix this. */
2328 typedef int gdb_threadref; /* Internal GDB thread reference. */
2330 /* gdb_ext_thread_info is an internal GDB data structure which is
2331 equivalent to the reply of the remote threadinfo packet. */
2333 struct gdb_ext_thread_info
2335 threadref threadid; /* External form of thread reference. */
2336 int active; /* Has state interesting to GDB?
2338 char display[256]; /* Brief state display, name,
2339 blocked/suspended. */
2340 char shortname[32]; /* To be used to name threads. */
2341 char more_display[256]; /* Long info, statistics, queue depth,
2345 /* The volume of remote transfers can be limited by submitting
2346 a mask containing bits specifying the desired information.
2347 Use a union of these values as the 'selection' parameter to
2348 get_thread_info. FIXME: Make these TAG names more thread specific. */
2350 #define TAG_THREADID 1
2351 #define TAG_EXISTS 2
2352 #define TAG_DISPLAY 4
2353 #define TAG_THREADNAME 8
2354 #define TAG_MOREDISPLAY 16
2356 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
2358 static char *unpack_nibble (char *buf, int *val);
2360 static char *unpack_byte (char *buf, int *value);
2362 static char *pack_int (char *buf, int value);
2364 static char *unpack_int (char *buf, int *value);
2366 static char *unpack_string (char *src, char *dest, int length);
2368 static char *pack_threadid (char *pkt, threadref *id);
2370 static char *unpack_threadid (char *inbuf, threadref *id);
2372 void int_to_threadref (threadref *id, int value);
2374 static int threadref_to_int (threadref *ref);
2376 static void copy_threadref (threadref *dest, threadref *src);
2378 static int threadmatch (threadref *dest, threadref *src);
2380 static char *pack_threadinfo_request (char *pkt, int mode,
2383 static int remote_unpack_thread_info_response (char *pkt,
2384 threadref *expectedref,
2385 struct gdb_ext_thread_info
2389 static int remote_get_threadinfo (threadref *threadid,
2390 int fieldset, /*TAG mask */
2391 struct gdb_ext_thread_info *info);
2393 static char *pack_threadlist_request (char *pkt, int startflag,
2395 threadref *nextthread);
2397 static int parse_threadlist_response (char *pkt,
2399 threadref *original_echo,
2400 threadref *resultlist,
2403 static int remote_get_threadlist (int startflag,
2404 threadref *nextthread,
2408 threadref *threadlist);
2410 typedef int (*rmt_thread_action) (threadref *ref, void *context);
2412 static int remote_threadlist_iterator (rmt_thread_action stepfunction,
2413 void *context, int looplimit);
2415 static int remote_newthread_step (threadref *ref, void *context);
2418 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
2419 buffer we're allowed to write to. Returns
2420 BUF+CHARACTERS_WRITTEN. */
2423 write_ptid (char *buf, const char *endbuf, ptid_t ptid)
2426 struct remote_state *rs = get_remote_state ();
2428 if (remote_multi_process_p (rs))
2430 pid = ptid_get_pid (ptid);
2432 buf += xsnprintf (buf, endbuf - buf, "p-%x.", -pid);
2434 buf += xsnprintf (buf, endbuf - buf, "p%x.", pid);
2436 tid = ptid_get_lwp (ptid);
2438 buf += xsnprintf (buf, endbuf - buf, "-%x", -tid);
2440 buf += xsnprintf (buf, endbuf - buf, "%x", tid);
2445 /* Extract a PTID from BUF. If non-null, OBUF is set to the to one
2446 passed the last parsed char. Returns null_ptid on error. */
2449 read_ptid (char *buf, char **obuf)
2453 ULONGEST pid = 0, tid = 0;
2457 /* Multi-process ptid. */
2458 pp = unpack_varlen_hex (p + 1, &pid);
2460 error (_("invalid remote ptid: %s"), p);
2463 pp = unpack_varlen_hex (p + 1, &tid);
2466 return ptid_build (pid, tid, 0);
2469 /* No multi-process. Just a tid. */
2470 pp = unpack_varlen_hex (p, &tid);
2472 /* Return null_ptid when no thread id is found. */
2480 /* Since the stub is not sending a process id, then default to
2481 what's in inferior_ptid, unless it's null at this point. If so,
2482 then since there's no way to know the pid of the reported
2483 threads, use the magic number. */
2484 if (ptid_equal (inferior_ptid, null_ptid))
2485 pid = ptid_get_pid (magic_null_ptid);
2487 pid = ptid_get_pid (inferior_ptid);
2491 return ptid_build (pid, tid, 0);
2497 if (ch >= 'a' && ch <= 'f')
2498 return ch - 'a' + 10;
2499 if (ch >= '0' && ch <= '9')
2501 if (ch >= 'A' && ch <= 'F')
2502 return ch - 'A' + 10;
2507 stub_unpack_int (char *buff, int fieldlength)
2514 nibble = stubhex (*buff++);
2518 retval = retval << 4;
2524 unpack_nibble (char *buf, int *val)
2526 *val = fromhex (*buf++);
2531 unpack_byte (char *buf, int *value)
2533 *value = stub_unpack_int (buf, 2);
2538 pack_int (char *buf, int value)
2540 buf = pack_hex_byte (buf, (value >> 24) & 0xff);
2541 buf = pack_hex_byte (buf, (value >> 16) & 0xff);
2542 buf = pack_hex_byte (buf, (value >> 8) & 0x0ff);
2543 buf = pack_hex_byte (buf, (value & 0xff));
2548 unpack_int (char *buf, int *value)
2550 *value = stub_unpack_int (buf, 8);
2554 #if 0 /* Currently unused, uncomment when needed. */
2555 static char *pack_string (char *pkt, char *string);
2558 pack_string (char *pkt, char *string)
2563 len = strlen (string);
2565 len = 200; /* Bigger than most GDB packets, junk??? */
2566 pkt = pack_hex_byte (pkt, len);
2570 if ((ch == '\0') || (ch == '#'))
2571 ch = '*'; /* Protect encapsulation. */
2576 #endif /* 0 (unused) */
2579 unpack_string (char *src, char *dest, int length)
2588 pack_threadid (char *pkt, threadref *id)
2591 unsigned char *altid;
2593 altid = (unsigned char *) id;
2594 limit = pkt + BUF_THREAD_ID_SIZE;
2596 pkt = pack_hex_byte (pkt, *altid++);
2602 unpack_threadid (char *inbuf, threadref *id)
2605 char *limit = inbuf + BUF_THREAD_ID_SIZE;
2608 altref = (char *) id;
2610 while (inbuf < limit)
2612 x = stubhex (*inbuf++);
2613 y = stubhex (*inbuf++);
2614 *altref++ = (x << 4) | y;
2619 /* Externally, threadrefs are 64 bits but internally, they are still
2620 ints. This is due to a mismatch of specifications. We would like
2621 to use 64bit thread references internally. This is an adapter
2625 int_to_threadref (threadref *id, int value)
2627 unsigned char *scan;
2629 scan = (unsigned char *) id;
2635 *scan++ = (value >> 24) & 0xff;
2636 *scan++ = (value >> 16) & 0xff;
2637 *scan++ = (value >> 8) & 0xff;
2638 *scan++ = (value & 0xff);
2642 threadref_to_int (threadref *ref)
2645 unsigned char *scan;
2651 value = (value << 8) | ((*scan++) & 0xff);
2656 copy_threadref (threadref *dest, threadref *src)
2659 unsigned char *csrc, *cdest;
2661 csrc = (unsigned char *) src;
2662 cdest = (unsigned char *) dest;
2669 threadmatch (threadref *dest, threadref *src)
2671 /* Things are broken right now, so just assume we got a match. */
2673 unsigned char *srcp, *destp;
2675 srcp = (char *) src;
2676 destp = (char *) dest;
2680 result &= (*srcp++ == *destp++) ? 1 : 0;
2687 threadid:1, # always request threadid
2694 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
2697 pack_threadinfo_request (char *pkt, int mode, threadref *id)
2699 *pkt++ = 'q'; /* Info Query */
2700 *pkt++ = 'P'; /* process or thread info */
2701 pkt = pack_int (pkt, mode); /* mode */
2702 pkt = pack_threadid (pkt, id); /* threadid */
2703 *pkt = '\0'; /* terminate */
2707 /* These values tag the fields in a thread info response packet. */
2708 /* Tagging the fields allows us to request specific fields and to
2709 add more fields as time goes by. */
2711 #define TAG_THREADID 1 /* Echo the thread identifier. */
2712 #define TAG_EXISTS 2 /* Is this process defined enough to
2713 fetch registers and its stack? */
2714 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
2715 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
2716 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
2720 remote_unpack_thread_info_response (char *pkt, threadref *expectedref,
2721 struct gdb_ext_thread_info *info)
2723 struct remote_state *rs = get_remote_state ();
2727 char *limit = pkt + rs->buf_size; /* Plausible parsing limit. */
2730 /* info->threadid = 0; FIXME: implement zero_threadref. */
2732 info->display[0] = '\0';
2733 info->shortname[0] = '\0';
2734 info->more_display[0] = '\0';
2736 /* Assume the characters indicating the packet type have been
2738 pkt = unpack_int (pkt, &mask); /* arg mask */
2739 pkt = unpack_threadid (pkt, &ref);
2742 warning (_("Incomplete response to threadinfo request."));
2743 if (!threadmatch (&ref, expectedref))
2744 { /* This is an answer to a different request. */
2745 warning (_("ERROR RMT Thread info mismatch."));
2748 copy_threadref (&info->threadid, &ref);
2750 /* Loop on tagged fields , try to bail if somthing goes wrong. */
2752 /* Packets are terminated with nulls. */
2753 while ((pkt < limit) && mask && *pkt)
2755 pkt = unpack_int (pkt, &tag); /* tag */
2756 pkt = unpack_byte (pkt, &length); /* length */
2757 if (!(tag & mask)) /* Tags out of synch with mask. */
2759 warning (_("ERROR RMT: threadinfo tag mismatch."));
2763 if (tag == TAG_THREADID)
2767 warning (_("ERROR RMT: length of threadid is not 16."));
2771 pkt = unpack_threadid (pkt, &ref);
2772 mask = mask & ~TAG_THREADID;
2775 if (tag == TAG_EXISTS)
2777 info->active = stub_unpack_int (pkt, length);
2779 mask = mask & ~(TAG_EXISTS);
2782 warning (_("ERROR RMT: 'exists' length too long."));
2788 if (tag == TAG_THREADNAME)
2790 pkt = unpack_string (pkt, &info->shortname[0], length);
2791 mask = mask & ~TAG_THREADNAME;
2794 if (tag == TAG_DISPLAY)
2796 pkt = unpack_string (pkt, &info->display[0], length);
2797 mask = mask & ~TAG_DISPLAY;
2800 if (tag == TAG_MOREDISPLAY)
2802 pkt = unpack_string (pkt, &info->more_display[0], length);
2803 mask = mask & ~TAG_MOREDISPLAY;
2806 warning (_("ERROR RMT: unknown thread info tag."));
2807 break; /* Not a tag we know about. */
2813 remote_get_threadinfo (threadref *threadid, int fieldset, /* TAG mask */
2814 struct gdb_ext_thread_info *info)
2816 struct remote_state *rs = get_remote_state ();
2819 pack_threadinfo_request (rs->buf, fieldset, threadid);
2821 getpkt (&rs->buf, &rs->buf_size, 0);
2823 if (rs->buf[0] == '\0')
2826 result = remote_unpack_thread_info_response (rs->buf + 2,
2831 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
2834 pack_threadlist_request (char *pkt, int startflag, int threadcount,
2835 threadref *nextthread)
2837 *pkt++ = 'q'; /* info query packet */
2838 *pkt++ = 'L'; /* Process LIST or threadLIST request */
2839 pkt = pack_nibble (pkt, startflag); /* initflag 1 bytes */
2840 pkt = pack_hex_byte (pkt, threadcount); /* threadcount 2 bytes */
2841 pkt = pack_threadid (pkt, nextthread); /* 64 bit thread identifier */
2846 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
2849 parse_threadlist_response (char *pkt, int result_limit,
2850 threadref *original_echo, threadref *resultlist,
2853 struct remote_state *rs = get_remote_state ();
2855 int count, resultcount, done;
2858 /* Assume the 'q' and 'M chars have been stripped. */
2859 limit = pkt + (rs->buf_size - BUF_THREAD_ID_SIZE);
2860 /* done parse past here */
2861 pkt = unpack_byte (pkt, &count); /* count field */
2862 pkt = unpack_nibble (pkt, &done);
2863 /* The first threadid is the argument threadid. */
2864 pkt = unpack_threadid (pkt, original_echo); /* should match query packet */
2865 while ((count-- > 0) && (pkt < limit))
2867 pkt = unpack_threadid (pkt, resultlist++);
2868 if (resultcount++ >= result_limit)
2876 /* Fetch the next batch of threads from the remote. Returns -1 if the
2877 qL packet is not supported, 0 on error and 1 on success. */
2880 remote_get_threadlist (int startflag, threadref *nextthread, int result_limit,
2881 int *done, int *result_count, threadref *threadlist)
2883 struct remote_state *rs = get_remote_state ();
2886 /* Trancate result limit to be smaller than the packet size. */
2887 if ((((result_limit + 1) * BUF_THREAD_ID_SIZE) + 10)
2888 >= get_remote_packet_size ())
2889 result_limit = (get_remote_packet_size () / BUF_THREAD_ID_SIZE) - 2;
2891 pack_threadlist_request (rs->buf, startflag, result_limit, nextthread);
2893 getpkt (&rs->buf, &rs->buf_size, 0);
2894 if (*rs->buf == '\0')
2896 /* Packet not supported. */
2901 parse_threadlist_response (rs->buf + 2, result_limit,
2902 &rs->echo_nextthread, threadlist, done);
2904 if (!threadmatch (&rs->echo_nextthread, nextthread))
2906 /* FIXME: This is a good reason to drop the packet. */
2907 /* Possably, there is a duplicate response. */
2909 retransmit immediatly - race conditions
2910 retransmit after timeout - yes
2912 wait for packet, then exit
2914 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
2915 return 0; /* I choose simply exiting. */
2917 if (*result_count <= 0)
2921 warning (_("RMT ERROR : failed to get remote thread list."));
2924 return result; /* break; */
2926 if (*result_count > result_limit)
2929 warning (_("RMT ERROR: threadlist response longer than requested."));
2935 /* Fetch the list of remote threads, with the qL packet, and call
2936 STEPFUNCTION for each thread found. Stops iterating and returns 1
2937 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
2938 STEPFUNCTION returns false. If the packet is not supported,
2942 remote_threadlist_iterator (rmt_thread_action stepfunction, void *context,
2945 struct remote_state *rs = get_remote_state ();
2946 int done, i, result_count;
2954 if (loopcount++ > looplimit)
2957 warning (_("Remote fetch threadlist -infinite loop-."));
2960 result = remote_get_threadlist (startflag, &rs->nextthread,
2961 MAXTHREADLISTRESULTS,
2962 &done, &result_count,
2963 rs->resultthreadlist);
2966 /* Clear for later iterations. */
2968 /* Setup to resume next batch of thread references, set nextthread. */
2969 if (result_count >= 1)
2970 copy_threadref (&rs->nextthread,
2971 &rs->resultthreadlist[result_count - 1]);
2973 while (result_count--)
2975 if (!(*stepfunction) (&rs->resultthreadlist[i++], context))
2985 /* A thread found on the remote target. */
2987 typedef struct thread_item
2989 /* The thread's PTID. */
2992 /* The thread's extra info. May be NULL. */
2995 /* The thread's name. May be NULL. */
2998 /* The core the thread was running on. -1 if not known. */
3001 DEF_VEC_O(thread_item_t);
3003 /* Context passed around to the various methods listing remote
3004 threads. As new threads are found, they're added to the ITEMS
3007 struct threads_listing_context
3009 /* The threads found on the remote target. */
3010 VEC (thread_item_t) *items;
3013 /* Discard the contents of the constructed thread listing context. */
3016 clear_threads_listing_context (void *p)
3018 struct threads_listing_context *context
3019 = (struct threads_listing_context *) p;
3021 struct thread_item *item;
3023 for (i = 0; VEC_iterate (thread_item_t, context->items, i, item); ++i)
3025 xfree (item->extra);
3029 VEC_free (thread_item_t, context->items);
3032 /* Remove the thread specified as the related_pid field of WS
3033 from the CONTEXT list. */
3036 threads_listing_context_remove (struct target_waitstatus *ws,
3037 struct threads_listing_context *context)
3039 struct thread_item *item;
3041 ptid_t child_ptid = ws->value.related_pid;
3043 for (i = 0; VEC_iterate (thread_item_t, context->items, i, item); ++i)
3045 if (ptid_equal (item->ptid, child_ptid))
3047 VEC_ordered_remove (thread_item_t, context->items, i);
3054 remote_newthread_step (threadref *ref, void *data)
3056 struct threads_listing_context *context
3057 = (struct threads_listing_context *) data;
3058 struct thread_item item;
3059 int pid = ptid_get_pid (inferior_ptid);
3061 item.ptid = ptid_build (pid, threadref_to_int (ref), 0);
3066 VEC_safe_push (thread_item_t, context->items, &item);
3068 return 1; /* continue iterator */
3071 #define CRAZY_MAX_THREADS 1000
3074 remote_current_thread (ptid_t oldpid)
3076 struct remote_state *rs = get_remote_state ();
3079 getpkt (&rs->buf, &rs->buf_size, 0);
3080 if (rs->buf[0] == 'Q' && rs->buf[1] == 'C')
3085 result = read_ptid (&rs->buf[2], &obuf);
3086 if (*obuf != '\0' && remote_debug)
3087 fprintf_unfiltered (gdb_stdlog,
3088 "warning: garbage in qC reply\n");
3096 /* List remote threads using the deprecated qL packet. */
3099 remote_get_threads_with_ql (struct target_ops *ops,
3100 struct threads_listing_context *context)
3102 if (remote_threadlist_iterator (remote_newthread_step, context,
3103 CRAZY_MAX_THREADS) >= 0)
3109 #if defined(HAVE_LIBEXPAT)
3112 start_thread (struct gdb_xml_parser *parser,
3113 const struct gdb_xml_element *element,
3114 void *user_data, VEC(gdb_xml_value_s) *attributes)
3116 struct threads_listing_context *data
3117 = (struct threads_listing_context *) user_data;
3119 struct thread_item item;
3121 struct gdb_xml_value *attr;
3123 id = (char *) xml_find_attribute (attributes, "id")->value;
3124 item.ptid = read_ptid (id, NULL);
3126 attr = xml_find_attribute (attributes, "core");
3128 item.core = *(ULONGEST *) attr->value;
3132 attr = xml_find_attribute (attributes, "name");
3133 item.name = attr != NULL ? xstrdup ((const char *) attr->value) : NULL;
3137 VEC_safe_push (thread_item_t, data->items, &item);
3141 end_thread (struct gdb_xml_parser *parser,
3142 const struct gdb_xml_element *element,
3143 void *user_data, const char *body_text)
3145 struct threads_listing_context *data
3146 = (struct threads_listing_context *) user_data;
3148 if (body_text && *body_text)
3149 VEC_last (thread_item_t, data->items)->extra = xstrdup (body_text);
3152 const struct gdb_xml_attribute thread_attributes[] = {
3153 { "id", GDB_XML_AF_NONE, NULL, NULL },
3154 { "core", GDB_XML_AF_OPTIONAL, gdb_xml_parse_attr_ulongest, NULL },
3155 { "name", GDB_XML_AF_OPTIONAL, NULL, NULL },
3156 { NULL, GDB_XML_AF_NONE, NULL, NULL }
3159 const struct gdb_xml_element thread_children[] = {
3160 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3163 const struct gdb_xml_element threads_children[] = {
3164 { "thread", thread_attributes, thread_children,
3165 GDB_XML_EF_REPEATABLE | GDB_XML_EF_OPTIONAL,
3166 start_thread, end_thread },
3167 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3170 const struct gdb_xml_element threads_elements[] = {
3171 { "threads", NULL, threads_children,
3172 GDB_XML_EF_NONE, NULL, NULL },
3173 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
3178 /* List remote threads using qXfer:threads:read. */
3181 remote_get_threads_with_qxfer (struct target_ops *ops,
3182 struct threads_listing_context *context)
3184 #if defined(HAVE_LIBEXPAT)
3185 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
3187 char *xml = target_read_stralloc (ops, TARGET_OBJECT_THREADS, NULL);
3188 struct cleanup *back_to = make_cleanup (xfree, xml);
3190 if (xml != NULL && *xml != '\0')
3192 gdb_xml_parse_quick (_("threads"), "threads.dtd",
3193 threads_elements, xml, context);
3196 do_cleanups (back_to);
3204 /* List remote threads using qfThreadInfo/qsThreadInfo. */
3207 remote_get_threads_with_qthreadinfo (struct target_ops *ops,
3208 struct threads_listing_context *context)
3210 struct remote_state *rs = get_remote_state ();
3212 if (rs->use_threadinfo_query)
3216 putpkt ("qfThreadInfo");
3217 getpkt (&rs->buf, &rs->buf_size, 0);
3219 if (bufp[0] != '\0') /* q packet recognized */
3221 while (*bufp++ == 'm') /* reply contains one or more TID */
3225 struct thread_item item;
3227 item.ptid = read_ptid (bufp, &bufp);
3232 VEC_safe_push (thread_item_t, context->items, &item);
3234 while (*bufp++ == ','); /* comma-separated list */
3235 putpkt ("qsThreadInfo");
3236 getpkt (&rs->buf, &rs->buf_size, 0);
3243 /* Packet not recognized. */
3244 rs->use_threadinfo_query = 0;
3251 /* Implement the to_update_thread_list function for the remote
3255 remote_update_thread_list (struct target_ops *ops)
3257 struct threads_listing_context context;
3258 struct cleanup *old_chain;
3261 context.items = NULL;
3262 old_chain = make_cleanup (clear_threads_listing_context, &context);
3264 /* We have a few different mechanisms to fetch the thread list. Try
3265 them all, starting with the most preferred one first, falling
3266 back to older methods. */
3267 if (remote_get_threads_with_qxfer (ops, &context)
3268 || remote_get_threads_with_qthreadinfo (ops, &context)
3269 || remote_get_threads_with_ql (ops, &context))
3272 struct thread_item *item;
3273 struct thread_info *tp, *tmp;
3277 if (VEC_empty (thread_item_t, context.items)
3278 && remote_thread_always_alive (ops, inferior_ptid))
3280 /* Some targets don't really support threads, but still
3281 reply an (empty) thread list in response to the thread
3282 listing packets, instead of replying "packet not
3283 supported". Exit early so we don't delete the main
3285 do_cleanups (old_chain);
3289 /* CONTEXT now holds the current thread list on the remote
3290 target end. Delete GDB-side threads no longer found on the
3292 ALL_THREADS_SAFE (tp, tmp)
3295 VEC_iterate (thread_item_t, context.items, i, item);
3298 if (ptid_equal (item->ptid, tp->ptid))
3302 if (i == VEC_length (thread_item_t, context.items))
3305 delete_thread (tp->ptid);
3309 /* Remove any unreported fork child threads from CONTEXT so
3310 that we don't interfere with follow fork, which is where
3311 creation of such threads is handled. */
3312 remove_new_fork_children (&context);
3314 /* And now add threads we don't know about yet to our list. */
3316 VEC_iterate (thread_item_t, context.items, i, item);
3319 if (!ptid_equal (item->ptid, null_ptid))
3321 struct private_thread_info *info;
3322 /* In non-stop mode, we assume new found threads are
3323 executing until proven otherwise with a stop reply.
3324 In all-stop, we can only get here if all threads are
3326 int executing = target_is_non_stop_p () ? 1 : 0;
3328 remote_notice_new_inferior (item->ptid, executing);
3330 info = get_private_info_ptid (item->ptid);
3331 info->core = item->core;
3332 info->extra = item->extra;
3334 info->name = item->name;
3342 /* If no thread listing method is supported, then query whether
3343 each known thread is alive, one by one, with the T packet.
3344 If the target doesn't support threads at all, then this is a
3345 no-op. See remote_thread_alive. */
3349 do_cleanups (old_chain);
3353 * Collect a descriptive string about the given thread.
3354 * The target may say anything it wants to about the thread
3355 * (typically info about its blocked / runnable state, name, etc.).
3356 * This string will appear in the info threads display.
3358 * Optional: targets are not required to implement this function.
3362 remote_threads_extra_info (struct target_ops *self, struct thread_info *tp)
3364 struct remote_state *rs = get_remote_state ();
3368 struct gdb_ext_thread_info threadinfo;
3369 static char display_buf[100]; /* arbitrary... */
3370 int n = 0; /* position in display_buf */
3372 if (rs->remote_desc == 0) /* paranoia */
3373 internal_error (__FILE__, __LINE__,
3374 _("remote_threads_extra_info"));
3376 if (ptid_equal (tp->ptid, magic_null_ptid)
3377 || (ptid_get_pid (tp->ptid) != 0 && ptid_get_lwp (tp->ptid) == 0))
3378 /* This is the main thread which was added by GDB. The remote
3379 server doesn't know about it. */
3382 if (packet_support (PACKET_qXfer_threads) == PACKET_ENABLE)
3384 struct thread_info *info = find_thread_ptid (tp->ptid);
3386 if (info && info->priv)
3387 return info->priv->extra;
3392 if (rs->use_threadextra_query)
3395 char *endb = rs->buf + get_remote_packet_size ();
3397 xsnprintf (b, endb - b, "qThreadExtraInfo,");
3399 write_ptid (b, endb, tp->ptid);
3402 getpkt (&rs->buf, &rs->buf_size, 0);
3403 if (rs->buf[0] != 0)
3405 n = std::min (strlen (rs->buf) / 2, sizeof (display_buf));
3406 result = hex2bin (rs->buf, (gdb_byte *) display_buf, n);
3407 display_buf [result] = '\0';
3412 /* If the above query fails, fall back to the old method. */
3413 rs->use_threadextra_query = 0;
3414 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
3415 | TAG_MOREDISPLAY | TAG_DISPLAY;
3416 int_to_threadref (&id, ptid_get_lwp (tp->ptid));
3417 if (remote_get_threadinfo (&id, set, &threadinfo))
3418 if (threadinfo.active)
3420 if (*threadinfo.shortname)
3421 n += xsnprintf (&display_buf[0], sizeof (display_buf) - n,
3422 " Name: %s,", threadinfo.shortname);
3423 if (*threadinfo.display)
3424 n += xsnprintf (&display_buf[n], sizeof (display_buf) - n,
3425 " State: %s,", threadinfo.display);
3426 if (*threadinfo.more_display)
3427 n += xsnprintf (&display_buf[n], sizeof (display_buf) - n,
3428 " Priority: %s", threadinfo.more_display);
3432 /* For purely cosmetic reasons, clear up trailing commas. */
3433 if (',' == display_buf[n-1])
3434 display_buf[n-1] = ' ';
3443 remote_static_tracepoint_marker_at (struct target_ops *self, CORE_ADDR addr,
3444 struct static_tracepoint_marker *marker)
3446 struct remote_state *rs = get_remote_state ();
3449 xsnprintf (p, get_remote_packet_size (), "qTSTMat:");
3451 p += hexnumstr (p, addr);
3453 getpkt (&rs->buf, &rs->buf_size, 0);
3457 error (_("Remote failure reply: %s"), p);
3461 parse_static_tracepoint_marker_definition (p, &p, marker);
3468 static VEC(static_tracepoint_marker_p) *
3469 remote_static_tracepoint_markers_by_strid (struct target_ops *self,
3472 struct remote_state *rs = get_remote_state ();
3473 VEC(static_tracepoint_marker_p) *markers = NULL;
3474 struct static_tracepoint_marker *marker = NULL;
3475 struct cleanup *old_chain;
3478 /* Ask for a first packet of static tracepoint marker
3481 getpkt (&rs->buf, &rs->buf_size, 0);
3484 error (_("Remote failure reply: %s"), p);
3486 old_chain = make_cleanup (free_current_marker, &marker);
3491 marker = XCNEW (struct static_tracepoint_marker);
3495 parse_static_tracepoint_marker_definition (p, &p, marker);
3497 if (strid == NULL || strcmp (strid, marker->str_id) == 0)
3499 VEC_safe_push (static_tracepoint_marker_p,
3505 release_static_tracepoint_marker (marker);
3506 memset (marker, 0, sizeof (*marker));
3509 while (*p++ == ','); /* comma-separated list */
3510 /* Ask for another packet of static tracepoint definition. */
3512 getpkt (&rs->buf, &rs->buf_size, 0);
3516 do_cleanups (old_chain);
3521 /* Implement the to_get_ada_task_ptid function for the remote targets. */
3524 remote_get_ada_task_ptid (struct target_ops *self, long lwp, long thread)
3526 return ptid_build (ptid_get_pid (inferior_ptid), lwp, 0);
3530 /* Restart the remote side; this is an extended protocol operation. */
3533 extended_remote_restart (void)
3535 struct remote_state *rs = get_remote_state ();
3537 /* Send the restart command; for reasons I don't understand the
3538 remote side really expects a number after the "R". */
3539 xsnprintf (rs->buf, get_remote_packet_size (), "R%x", 0);
3542 remote_fileio_reset ();
3545 /* Clean up connection to a remote debugger. */
3548 remote_close (struct target_ops *self)
3550 struct remote_state *rs = get_remote_state ();
3552 if (rs->remote_desc == NULL)
3553 return; /* already closed */
3555 /* Make sure we leave stdin registered in the event loop. */
3556 remote_terminal_ours (self);
3558 serial_close (rs->remote_desc);
3559 rs->remote_desc = NULL;
3561 /* We don't have a connection to the remote stub anymore. Get rid
3562 of all the inferiors and their threads we were controlling.
3563 Reset inferior_ptid to null_ptid first, as otherwise has_stack_frame
3564 will be unable to find the thread corresponding to (pid, 0, 0). */
3565 inferior_ptid = null_ptid;
3566 discard_all_inferiors ();
3568 /* We are closing the remote target, so we should discard
3569 everything of this target. */
3570 discard_pending_stop_replies_in_queue (rs);
3572 if (remote_async_inferior_event_token)
3573 delete_async_event_handler (&remote_async_inferior_event_token);
3575 remote_notif_state_xfree (rs->notif_state);
3577 trace_reset_local_state ();
3580 /* Query the remote side for the text, data and bss offsets. */
3585 struct remote_state *rs = get_remote_state ();
3588 int lose, num_segments = 0, do_sections, do_segments;
3589 CORE_ADDR text_addr, data_addr, bss_addr, segments[2];
3590 struct section_offsets *offs;
3591 struct symfile_segment_data *data;
3593 if (symfile_objfile == NULL)
3596 putpkt ("qOffsets");
3597 getpkt (&rs->buf, &rs->buf_size, 0);
3600 if (buf[0] == '\000')
3601 return; /* Return silently. Stub doesn't support
3605 warning (_("Remote failure reply: %s"), buf);
3609 /* Pick up each field in turn. This used to be done with scanf, but
3610 scanf will make trouble if CORE_ADDR size doesn't match
3611 conversion directives correctly. The following code will work
3612 with any size of CORE_ADDR. */
3613 text_addr = data_addr = bss_addr = 0;
3617 if (startswith (ptr, "Text="))
3620 /* Don't use strtol, could lose on big values. */
3621 while (*ptr && *ptr != ';')
3622 text_addr = (text_addr << 4) + fromhex (*ptr++);
3624 if (startswith (ptr, ";Data="))
3627 while (*ptr && *ptr != ';')
3628 data_addr = (data_addr << 4) + fromhex (*ptr++);
3633 if (!lose && startswith (ptr, ";Bss="))
3636 while (*ptr && *ptr != ';')
3637 bss_addr = (bss_addr << 4) + fromhex (*ptr++);
3639 if (bss_addr != data_addr)
3640 warning (_("Target reported unsupported offsets: %s"), buf);
3645 else if (startswith (ptr, "TextSeg="))
3648 /* Don't use strtol, could lose on big values. */
3649 while (*ptr && *ptr != ';')
3650 text_addr = (text_addr << 4) + fromhex (*ptr++);
3653 if (startswith (ptr, ";DataSeg="))
3656 while (*ptr && *ptr != ';')
3657 data_addr = (data_addr << 4) + fromhex (*ptr++);
3665 error (_("Malformed response to offset query, %s"), buf);
3666 else if (*ptr != '\0')
3667 warning (_("Target reported unsupported offsets: %s"), buf);
3669 offs = ((struct section_offsets *)
3670 alloca (SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections)));
3671 memcpy (offs, symfile_objfile->section_offsets,
3672 SIZEOF_N_SECTION_OFFSETS (symfile_objfile->num_sections));
3674 data = get_symfile_segment_data (symfile_objfile->obfd);
3675 do_segments = (data != NULL);
3676 do_sections = num_segments == 0;
3678 if (num_segments > 0)
3680 segments[0] = text_addr;
3681 segments[1] = data_addr;
3683 /* If we have two segments, we can still try to relocate everything
3684 by assuming that the .text and .data offsets apply to the whole
3685 text and data segments. Convert the offsets given in the packet
3686 to base addresses for symfile_map_offsets_to_segments. */
3687 else if (data && data->num_segments == 2)
3689 segments[0] = data->segment_bases[0] + text_addr;
3690 segments[1] = data->segment_bases[1] + data_addr;
3693 /* If the object file has only one segment, assume that it is text
3694 rather than data; main programs with no writable data are rare,
3695 but programs with no code are useless. Of course the code might
3696 have ended up in the data segment... to detect that we would need
3697 the permissions here. */
3698 else if (data && data->num_segments == 1)
3700 segments[0] = data->segment_bases[0] + text_addr;
3703 /* There's no way to relocate by segment. */
3709 int ret = symfile_map_offsets_to_segments (symfile_objfile->obfd, data,
3710 offs, num_segments, segments);
3712 if (ret == 0 && !do_sections)
3713 error (_("Can not handle qOffsets TextSeg "
3714 "response with this symbol file"));
3721 free_symfile_segment_data (data);
3725 offs->offsets[SECT_OFF_TEXT (symfile_objfile)] = text_addr;
3727 /* This is a temporary kludge to force data and bss to use the
3728 same offsets because that's what nlmconv does now. The real
3729 solution requires changes to the stub and remote.c that I
3730 don't have time to do right now. */
3732 offs->offsets[SECT_OFF_DATA (symfile_objfile)] = data_addr;
3733 offs->offsets[SECT_OFF_BSS (symfile_objfile)] = data_addr;
3736 objfile_relocate (symfile_objfile, offs);
3739 /* Send interrupt_sequence to remote target. */
3741 send_interrupt_sequence (void)
3743 struct remote_state *rs = get_remote_state ();
3745 if (interrupt_sequence_mode == interrupt_sequence_control_c)
3746 remote_serial_write ("\x03", 1);
3747 else if (interrupt_sequence_mode == interrupt_sequence_break)
3748 serial_send_break (rs->remote_desc);
3749 else if (interrupt_sequence_mode == interrupt_sequence_break_g)
3751 serial_send_break (rs->remote_desc);
3752 remote_serial_write ("g", 1);
3755 internal_error (__FILE__, __LINE__,
3756 _("Invalid value for interrupt_sequence_mode: %s."),
3757 interrupt_sequence_mode);
3761 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
3762 and extract the PTID. Returns NULL_PTID if not found. */
3765 stop_reply_extract_thread (char *stop_reply)
3767 if (stop_reply[0] == 'T' && strlen (stop_reply) > 3)
3771 /* Txx r:val ; r:val (...) */
3774 /* Look for "register" named "thread". */
3779 p1 = strchr (p, ':');
3783 if (strncmp (p, "thread", p1 - p) == 0)
3784 return read_ptid (++p1, &p);
3786 p1 = strchr (p, ';');
3798 /* Determine the remote side's current thread. If we have a stop
3799 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
3800 "thread" register we can extract the current thread from. If not,
3801 ask the remote which is the current thread with qC. The former
3802 method avoids a roundtrip. */
3805 get_current_thread (char *wait_status)
3807 ptid_t ptid = null_ptid;
3809 /* Note we don't use remote_parse_stop_reply as that makes use of
3810 the target architecture, which we haven't yet fully determined at
3812 if (wait_status != NULL)
3813 ptid = stop_reply_extract_thread (wait_status);
3814 if (ptid_equal (ptid, null_ptid))
3815 ptid = remote_current_thread (inferior_ptid);
3820 /* Query the remote target for which is the current thread/process,
3821 add it to our tables, and update INFERIOR_PTID. The caller is
3822 responsible for setting the state such that the remote end is ready
3823 to return the current thread.
3825 This function is called after handling the '?' or 'vRun' packets,
3826 whose response is a stop reply from which we can also try
3827 extracting the thread. If the target doesn't support the explicit
3828 qC query, we infer the current thread from that stop reply, passed
3829 in in WAIT_STATUS, which may be NULL. */
3832 add_current_inferior_and_thread (char *wait_status)
3834 struct remote_state *rs = get_remote_state ();
3837 inferior_ptid = null_ptid;
3839 /* Now, if we have thread information, update inferior_ptid. */
3840 ptid_t curr_ptid = get_current_thread (wait_status);
3842 if (curr_ptid != null_ptid)
3844 if (!remote_multi_process_p (rs))
3849 /* Without this, some commands which require an active target
3850 (such as kill) won't work. This variable serves (at least)
3851 double duty as both the pid of the target process (if it has
3852 such), and as a flag indicating that a target is active. */
3853 curr_ptid = magic_null_ptid;
3857 remote_add_inferior (fake_pid_p, ptid_get_pid (curr_ptid), -1, 1);
3859 /* Add the main thread and switch to it. Don't try reading
3860 registers yet, since we haven't fetched the target description
3862 thread_info *tp = add_thread_silent (curr_ptid);
3863 switch_to_thread_no_regs (tp);
3866 /* Print info about a thread that was found already stopped on
3870 print_one_stopped_thread (struct thread_info *thread)
3872 struct target_waitstatus *ws = &thread->suspend.waitstatus;
3874 switch_to_thread (thread->ptid);
3875 stop_pc = get_frame_pc (get_current_frame ());
3876 set_current_sal_from_frame (get_current_frame ());
3878 thread->suspend.waitstatus_pending_p = 0;
3880 if (ws->kind == TARGET_WAITKIND_STOPPED)
3882 enum gdb_signal sig = ws->value.sig;
3884 if (signal_print_state (sig))
3885 observer_notify_signal_received (sig);
3887 observer_notify_normal_stop (NULL, 1);
3890 /* Process all initial stop replies the remote side sent in response
3891 to the ? packet. These indicate threads that were already stopped
3892 on initial connection. We mark these threads as stopped and print
3893 their current frame before giving the user the prompt. */
3896 process_initial_stop_replies (int from_tty)
3898 int pending_stop_replies = stop_reply_queue_length ();
3899 struct inferior *inf;
3900 struct thread_info *thread;
3901 struct thread_info *selected = NULL;
3902 struct thread_info *lowest_stopped = NULL;
3903 struct thread_info *first = NULL;
3905 /* Consume the initial pending events. */
3906 while (pending_stop_replies-- > 0)
3908 ptid_t waiton_ptid = minus_one_ptid;
3910 struct target_waitstatus ws;
3911 int ignore_event = 0;
3912 struct thread_info *thread;
3914 memset (&ws, 0, sizeof (ws));
3915 event_ptid = target_wait (waiton_ptid, &ws, TARGET_WNOHANG);
3917 print_target_wait_results (waiton_ptid, event_ptid, &ws);
3921 case TARGET_WAITKIND_IGNORE:
3922 case TARGET_WAITKIND_NO_RESUMED:
3923 case TARGET_WAITKIND_SIGNALLED:
3924 case TARGET_WAITKIND_EXITED:
3925 /* We shouldn't see these, but if we do, just ignore. */
3927 fprintf_unfiltered (gdb_stdlog, "remote: event ignored\n");
3931 case TARGET_WAITKIND_EXECD:
3932 xfree (ws.value.execd_pathname);
3941 thread = find_thread_ptid (event_ptid);
3943 if (ws.kind == TARGET_WAITKIND_STOPPED)
3945 enum gdb_signal sig = ws.value.sig;
3947 /* Stubs traditionally report SIGTRAP as initial signal,
3948 instead of signal 0. Suppress it. */
3949 if (sig == GDB_SIGNAL_TRAP)
3951 thread->suspend.stop_signal = sig;
3955 thread->suspend.waitstatus = ws;
3957 if (ws.kind != TARGET_WAITKIND_STOPPED
3958 || ws.value.sig != GDB_SIGNAL_0)
3959 thread->suspend.waitstatus_pending_p = 1;
3961 set_executing (event_ptid, 0);
3962 set_running (event_ptid, 0);
3963 thread->priv->vcont_resumed = 0;
3966 /* "Notice" the new inferiors before anything related to
3967 registers/memory. */
3973 inf->needs_setup = 1;
3977 thread = any_live_thread_of_process (inf->pid);
3978 notice_new_inferior (thread->ptid,
3979 thread->state == THREAD_RUNNING,
3984 /* If all-stop on top of non-stop, pause all threads. Note this
3985 records the threads' stop pc, so must be done after "noticing"
3989 stop_all_threads ();
3991 /* If all threads of an inferior were already stopped, we
3992 haven't setup the inferior yet. */
3998 if (inf->needs_setup)
4000 thread = any_live_thread_of_process (inf->pid);
4001 switch_to_thread_no_regs (thread);
4007 /* Now go over all threads that are stopped, and print their current
4008 frame. If all-stop, then if there's a signalled thread, pick
4010 ALL_NON_EXITED_THREADS (thread)
4016 set_running (thread->ptid, 0);
4017 else if (thread->state != THREAD_STOPPED)
4020 if (selected == NULL
4021 && thread->suspend.waitstatus_pending_p)
4024 if (lowest_stopped == NULL
4025 || thread->inf->num < lowest_stopped->inf->num
4026 || thread->per_inf_num < lowest_stopped->per_inf_num)
4027 lowest_stopped = thread;
4030 print_one_stopped_thread (thread);
4033 /* In all-stop, we only print the status of one thread, and leave
4034 others with their status pending. */
4039 thread = lowest_stopped;
4043 print_one_stopped_thread (thread);
4046 /* For "info program". */
4047 thread = inferior_thread ();
4048 if (thread->state == THREAD_STOPPED)
4049 set_last_target_status (inferior_ptid, thread->suspend.waitstatus);
4052 /* Start the remote connection and sync state. */
4055 remote_start_remote (int from_tty, struct target_ops *target, int extended_p)
4057 struct remote_state *rs = get_remote_state ();
4058 struct packet_config *noack_config;
4059 char *wait_status = NULL;
4061 /* Signal other parts that we're going through the initial setup,
4062 and so things may not be stable yet. E.g., we don't try to
4063 install tracepoints until we've relocated symbols. Also, a
4064 Ctrl-C before we're connected and synced up can't interrupt the
4065 target. Instead, it offers to drop the (potentially wedged)
4067 rs->starting_up = 1;
4071 if (interrupt_on_connect)
4072 send_interrupt_sequence ();
4074 /* Ack any packet which the remote side has already sent. */
4075 remote_serial_write ("+", 1);
4077 /* The first packet we send to the target is the optional "supported
4078 packets" request. If the target can answer this, it will tell us
4079 which later probes to skip. */
4080 remote_query_supported ();
4082 /* If the stub wants to get a QAllow, compose one and send it. */
4083 if (packet_support (PACKET_QAllow) != PACKET_DISABLE)
4084 remote_set_permissions (target);
4086 /* gdbserver < 7.7 (before its fix from 2013-12-11) did reply to any
4087 unknown 'v' packet with string "OK". "OK" gets interpreted by GDB
4088 as a reply to known packet. For packet "vFile:setfs:" it is an
4089 invalid reply and GDB would return error in
4090 remote_hostio_set_filesystem, making remote files access impossible.
4091 Disable "vFile:setfs:" in such case. Do not disable other 'v' packets as
4092 other "vFile" packets get correctly detected even on gdbserver < 7.7. */
4094 const char v_mustreplyempty[] = "vMustReplyEmpty";
4096 putpkt (v_mustreplyempty);
4097 getpkt (&rs->buf, &rs->buf_size, 0);
4098 if (strcmp (rs->buf, "OK") == 0)
4099 remote_protocol_packets[PACKET_vFile_setfs].support = PACKET_DISABLE;
4100 else if (strcmp (rs->buf, "") != 0)
4101 error (_("Remote replied unexpectedly to '%s': %s"), v_mustreplyempty,
4105 /* Next, we possibly activate noack mode.
4107 If the QStartNoAckMode packet configuration is set to AUTO,
4108 enable noack mode if the stub reported a wish for it with
4111 If set to TRUE, then enable noack mode even if the stub didn't
4112 report it in qSupported. If the stub doesn't reply OK, the
4113 session ends with an error.
4115 If FALSE, then don't activate noack mode, regardless of what the
4116 stub claimed should be the default with qSupported. */
4118 noack_config = &remote_protocol_packets[PACKET_QStartNoAckMode];
4119 if (packet_config_support (noack_config) != PACKET_DISABLE)
4121 putpkt ("QStartNoAckMode");
4122 getpkt (&rs->buf, &rs->buf_size, 0);
4123 if (packet_ok (rs->buf, noack_config) == PACKET_OK)
4129 /* Tell the remote that we are using the extended protocol. */
4131 getpkt (&rs->buf, &rs->buf_size, 0);
4134 /* Let the target know which signals it is allowed to pass down to
4136 update_signals_program_target ();
4138 /* Next, if the target can specify a description, read it. We do
4139 this before anything involving memory or registers. */
4140 target_find_description ();
4142 /* Next, now that we know something about the target, update the
4143 address spaces in the program spaces. */
4144 update_address_spaces ();
4146 /* On OSs where the list of libraries is global to all
4147 processes, we fetch them early. */
4148 if (gdbarch_has_global_solist (target_gdbarch ()))
4149 solib_add (NULL, from_tty, auto_solib_add);
4151 if (target_is_non_stop_p ())
4153 if (packet_support (PACKET_QNonStop) != PACKET_ENABLE)
4154 error (_("Non-stop mode requested, but remote "
4155 "does not support non-stop"));
4157 putpkt ("QNonStop:1");
4158 getpkt (&rs->buf, &rs->buf_size, 0);
4160 if (strcmp (rs->buf, "OK") != 0)
4161 error (_("Remote refused setting non-stop mode with: %s"), rs->buf);
4163 /* Find about threads and processes the stub is already
4164 controlling. We default to adding them in the running state.
4165 The '?' query below will then tell us about which threads are
4167 remote_update_thread_list (target);
4169 else if (packet_support (PACKET_QNonStop) == PACKET_ENABLE)
4171 /* Don't assume that the stub can operate in all-stop mode.
4172 Request it explicitly. */
4173 putpkt ("QNonStop:0");
4174 getpkt (&rs->buf, &rs->buf_size, 0);
4176 if (strcmp (rs->buf, "OK") != 0)
4177 error (_("Remote refused setting all-stop mode with: %s"), rs->buf);
4180 /* Upload TSVs regardless of whether the target is running or not. The
4181 remote stub, such as GDBserver, may have some predefined or builtin
4182 TSVs, even if the target is not running. */
4183 if (remote_get_trace_status (target, current_trace_status ()) != -1)
4185 struct uploaded_tsv *uploaded_tsvs = NULL;
4187 remote_upload_trace_state_variables (target, &uploaded_tsvs);
4188 merge_uploaded_trace_state_variables (&uploaded_tsvs);
4191 /* Check whether the target is running now. */
4193 getpkt (&rs->buf, &rs->buf_size, 0);
4195 if (!target_is_non_stop_p ())
4197 if (rs->buf[0] == 'W' || rs->buf[0] == 'X')
4200 error (_("The target is not running (try extended-remote?)"));
4202 /* We're connected, but not running. Drop out before we
4203 call start_remote. */
4204 rs->starting_up = 0;
4209 /* Save the reply for later. */
4210 wait_status = (char *) alloca (strlen (rs->buf) + 1);
4211 strcpy (wait_status, rs->buf);
4214 /* Fetch thread list. */
4215 target_update_thread_list ();
4217 /* Let the stub know that we want it to return the thread. */
4218 set_continue_thread (minus_one_ptid);
4220 if (thread_count () == 0)
4222 /* Target has no concept of threads at all. GDB treats
4223 non-threaded target as single-threaded; add a main
4225 add_current_inferior_and_thread (wait_status);
4229 /* We have thread information; select the thread the target
4230 says should be current. If we're reconnecting to a
4231 multi-threaded program, this will ideally be the thread
4232 that last reported an event before GDB disconnected. */
4233 inferior_ptid = get_current_thread (wait_status);
4234 if (ptid_equal (inferior_ptid, null_ptid))
4236 /* Odd... The target was able to list threads, but not
4237 tell us which thread was current (no "thread"
4238 register in T stop reply?). Just pick the first
4239 thread in the thread list then. */
4242 fprintf_unfiltered (gdb_stdlog,
4243 "warning: couldn't determine remote "
4244 "current thread; picking first in list.\n");
4246 inferior_ptid = thread_list->ptid;
4250 /* init_wait_for_inferior should be called before get_offsets in order
4251 to manage `inserted' flag in bp loc in a correct state.
4252 breakpoint_init_inferior, called from init_wait_for_inferior, set
4253 `inserted' flag to 0, while before breakpoint_re_set, called from
4254 start_remote, set `inserted' flag to 1. In the initialization of
4255 inferior, breakpoint_init_inferior should be called first, and then
4256 breakpoint_re_set can be called. If this order is broken, state of
4257 `inserted' flag is wrong, and cause some problems on breakpoint
4259 init_wait_for_inferior ();
4261 get_offsets (); /* Get text, data & bss offsets. */
4263 /* If we could not find a description using qXfer, and we know
4264 how to do it some other way, try again. This is not
4265 supported for non-stop; it could be, but it is tricky if
4266 there are no stopped threads when we connect. */
4267 if (remote_read_description_p (target)
4268 && gdbarch_target_desc (target_gdbarch ()) == NULL)
4270 target_clear_description ();
4271 target_find_description ();
4274 /* Use the previously fetched status. */
4275 gdb_assert (wait_status != NULL);
4276 strcpy (rs->buf, wait_status);
4277 rs->cached_wait_status = 1;
4279 start_remote (from_tty); /* Initialize gdb process mechanisms. */
4283 /* Clear WFI global state. Do this before finding about new
4284 threads and inferiors, and setting the current inferior.
4285 Otherwise we would clear the proceed status of the current
4286 inferior when we want its stop_soon state to be preserved
4287 (see notice_new_inferior). */
4288 init_wait_for_inferior ();
4290 /* In non-stop, we will either get an "OK", meaning that there
4291 are no stopped threads at this time; or, a regular stop
4292 reply. In the latter case, there may be more than one thread
4293 stopped --- we pull them all out using the vStopped
4295 if (strcmp (rs->buf, "OK") != 0)
4297 struct notif_client *notif = ¬if_client_stop;
4299 /* remote_notif_get_pending_replies acks this one, and gets
4301 rs->notif_state->pending_event[notif_client_stop.id]
4302 = remote_notif_parse (notif, rs->buf);
4303 remote_notif_get_pending_events (notif);
4306 if (thread_count () == 0)
4309 error (_("The target is not running (try extended-remote?)"));
4311 /* We're connected, but not running. Drop out before we
4312 call start_remote. */
4313 rs->starting_up = 0;
4317 /* In non-stop mode, any cached wait status will be stored in
4318 the stop reply queue. */
4319 gdb_assert (wait_status == NULL);
4321 /* Report all signals during attach/startup. */
4322 remote_pass_signals (target, 0, NULL);
4324 /* If there are already stopped threads, mark them stopped and
4325 report their stops before giving the prompt to the user. */
4326 process_initial_stop_replies (from_tty);
4328 if (target_can_async_p ())
4332 /* If we connected to a live target, do some additional setup. */
4333 if (target_has_execution)
4335 if (symfile_objfile) /* No use without a symbol-file. */
4336 remote_check_symbols ();
4339 /* Possibly the target has been engaged in a trace run started
4340 previously; find out where things are at. */
4341 if (remote_get_trace_status (target, current_trace_status ()) != -1)
4343 struct uploaded_tp *uploaded_tps = NULL;
4345 if (current_trace_status ()->running)
4346 printf_filtered (_("Trace is already running on the target.\n"));
4348 remote_upload_tracepoints (target, &uploaded_tps);
4350 merge_uploaded_tracepoints (&uploaded_tps);
4353 /* Possibly the target has been engaged in a btrace record started
4354 previously; find out where things are at. */
4355 remote_btrace_maybe_reopen ();
4357 /* The thread and inferior lists are now synchronized with the
4358 target, our symbols have been relocated, and we're merged the
4359 target's tracepoints with ours. We're done with basic start
4361 rs->starting_up = 0;
4363 /* Maybe breakpoints are global and need to be inserted now. */
4364 if (breakpoints_should_be_inserted_now ())
4365 insert_breakpoints ();
4368 /* Open a connection to a remote debugger.
4369 NAME is the filename used for communication. */
4372 remote_open (const char *name, int from_tty)
4374 remote_open_1 (name, from_tty, &remote_ops, 0);
4377 /* Open a connection to a remote debugger using the extended
4378 remote gdb protocol. NAME is the filename used for communication. */
4381 extended_remote_open (const char *name, int from_tty)
4383 remote_open_1 (name, from_tty, &extended_remote_ops, 1 /*extended_p */);
4386 /* Reset all packets back to "unknown support". Called when opening a
4387 new connection to a remote target. */
4390 reset_all_packet_configs_support (void)
4394 for (i = 0; i < PACKET_MAX; i++)
4395 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
4398 /* Initialize all packet configs. */
4401 init_all_packet_configs (void)
4405 for (i = 0; i < PACKET_MAX; i++)
4407 remote_protocol_packets[i].detect = AUTO_BOOLEAN_AUTO;
4408 remote_protocol_packets[i].support = PACKET_SUPPORT_UNKNOWN;
4412 /* Symbol look-up. */
4415 remote_check_symbols (void)
4417 struct remote_state *rs = get_remote_state ();
4418 char *msg, *reply, *tmp;
4421 struct cleanup *old_chain;
4423 /* The remote side has no concept of inferiors that aren't running
4424 yet, it only knows about running processes. If we're connected
4425 but our current inferior is not running, we should not invite the
4426 remote target to request symbol lookups related to its
4427 (unrelated) current process. */
4428 if (!target_has_execution)
4431 if (packet_support (PACKET_qSymbol) == PACKET_DISABLE)
4434 /* Make sure the remote is pointing at the right process. Note
4435 there's no way to select "no process". */
4436 set_general_process ();
4438 /* Allocate a message buffer. We can't reuse the input buffer in RS,
4439 because we need both at the same time. */
4440 msg = (char *) xmalloc (get_remote_packet_size ());
4441 old_chain = make_cleanup (xfree, msg);
4442 reply = (char *) xmalloc (get_remote_packet_size ());
4443 make_cleanup (free_current_contents, &reply);
4444 reply_size = get_remote_packet_size ();
4446 /* Invite target to request symbol lookups. */
4448 putpkt ("qSymbol::");
4449 getpkt (&reply, &reply_size, 0);
4450 packet_ok (reply, &remote_protocol_packets[PACKET_qSymbol]);
4452 while (startswith (reply, "qSymbol:"))
4454 struct bound_minimal_symbol sym;
4457 end = hex2bin (tmp, (gdb_byte *) msg, strlen (tmp) / 2);
4459 sym = lookup_minimal_symbol (msg, NULL, NULL);
4460 if (sym.minsym == NULL)
4461 xsnprintf (msg, get_remote_packet_size (), "qSymbol::%s", &reply[8]);
4464 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
4465 CORE_ADDR sym_addr = BMSYMBOL_VALUE_ADDRESS (sym);
4467 /* If this is a function address, return the start of code
4468 instead of any data function descriptor. */
4469 sym_addr = gdbarch_convert_from_func_ptr_addr (target_gdbarch (),
4473 xsnprintf (msg, get_remote_packet_size (), "qSymbol:%s:%s",
4474 phex_nz (sym_addr, addr_size), &reply[8]);
4478 getpkt (&reply, &reply_size, 0);
4481 do_cleanups (old_chain);
4484 static struct serial *
4485 remote_serial_open (const char *name)
4487 static int udp_warning = 0;
4489 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
4490 of in ser-tcp.c, because it is the remote protocol assuming that the
4491 serial connection is reliable and not the serial connection promising
4493 if (!udp_warning && startswith (name, "udp:"))
4495 warning (_("The remote protocol may be unreliable over UDP.\n"
4496 "Some events may be lost, rendering further debugging "
4501 return serial_open (name);
4504 /* Inform the target of our permission settings. The permission flags
4505 work without this, but if the target knows the settings, it can do
4506 a couple things. First, it can add its own check, to catch cases
4507 that somehow manage to get by the permissions checks in target
4508 methods. Second, if the target is wired to disallow particular
4509 settings (for instance, a system in the field that is not set up to
4510 be able to stop at a breakpoint), it can object to any unavailable
4514 remote_set_permissions (struct target_ops *self)
4516 struct remote_state *rs = get_remote_state ();
4518 xsnprintf (rs->buf, get_remote_packet_size (), "QAllow:"
4519 "WriteReg:%x;WriteMem:%x;"
4520 "InsertBreak:%x;InsertTrace:%x;"
4521 "InsertFastTrace:%x;Stop:%x",
4522 may_write_registers, may_write_memory,
4523 may_insert_breakpoints, may_insert_tracepoints,
4524 may_insert_fast_tracepoints, may_stop);
4526 getpkt (&rs->buf, &rs->buf_size, 0);
4528 /* If the target didn't like the packet, warn the user. Do not try
4529 to undo the user's settings, that would just be maddening. */
4530 if (strcmp (rs->buf, "OK") != 0)
4531 warning (_("Remote refused setting permissions with: %s"), rs->buf);
4534 /* This type describes each known response to the qSupported
4536 struct protocol_feature
4538 /* The name of this protocol feature. */
4541 /* The default for this protocol feature. */
4542 enum packet_support default_support;
4544 /* The function to call when this feature is reported, or after
4545 qSupported processing if the feature is not supported.
4546 The first argument points to this structure. The second
4547 argument indicates whether the packet requested support be
4548 enabled, disabled, or probed (or the default, if this function
4549 is being called at the end of processing and this feature was
4550 not reported). The third argument may be NULL; if not NULL, it
4551 is a NUL-terminated string taken from the packet following
4552 this feature's name and an equals sign. */
4553 void (*func) (const struct protocol_feature *, enum packet_support,
4556 /* The corresponding packet for this feature. Only used if
4557 FUNC is remote_supported_packet. */
4562 remote_supported_packet (const struct protocol_feature *feature,
4563 enum packet_support support,
4564 const char *argument)
4568 warning (_("Remote qSupported response supplied an unexpected value for"
4569 " \"%s\"."), feature->name);
4573 remote_protocol_packets[feature->packet].support = support;
4577 remote_packet_size (const struct protocol_feature *feature,
4578 enum packet_support support, const char *value)
4580 struct remote_state *rs = get_remote_state ();
4585 if (support != PACKET_ENABLE)
4588 if (value == NULL || *value == '\0')
4590 warning (_("Remote target reported \"%s\" without a size."),
4596 packet_size = strtol (value, &value_end, 16);
4597 if (errno != 0 || *value_end != '\0' || packet_size < 0)
4599 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
4600 feature->name, value);
4604 /* Record the new maximum packet size. */
4605 rs->explicit_packet_size = packet_size;
4608 static const struct protocol_feature remote_protocol_features[] = {
4609 { "PacketSize", PACKET_DISABLE, remote_packet_size, -1 },
4610 { "qXfer:auxv:read", PACKET_DISABLE, remote_supported_packet,
4611 PACKET_qXfer_auxv },
4612 { "qXfer:exec-file:read", PACKET_DISABLE, remote_supported_packet,
4613 PACKET_qXfer_exec_file },
4614 { "qXfer:features:read", PACKET_DISABLE, remote_supported_packet,
4615 PACKET_qXfer_features },
4616 { "qXfer:libraries:read", PACKET_DISABLE, remote_supported_packet,
4617 PACKET_qXfer_libraries },
4618 { "qXfer:libraries-svr4:read", PACKET_DISABLE, remote_supported_packet,
4619 PACKET_qXfer_libraries_svr4 },
4620 { "augmented-libraries-svr4-read", PACKET_DISABLE,
4621 remote_supported_packet, PACKET_augmented_libraries_svr4_read_feature },
4622 { "qXfer:memory-map:read", PACKET_DISABLE, remote_supported_packet,
4623 PACKET_qXfer_memory_map },
4624 { "qXfer:spu:read", PACKET_DISABLE, remote_supported_packet,
4625 PACKET_qXfer_spu_read },
4626 { "qXfer:spu:write", PACKET_DISABLE, remote_supported_packet,
4627 PACKET_qXfer_spu_write },
4628 { "qXfer:osdata:read", PACKET_DISABLE, remote_supported_packet,
4629 PACKET_qXfer_osdata },
4630 { "qXfer:threads:read", PACKET_DISABLE, remote_supported_packet,
4631 PACKET_qXfer_threads },
4632 { "qXfer:traceframe-info:read", PACKET_DISABLE, remote_supported_packet,
4633 PACKET_qXfer_traceframe_info },
4634 { "QPassSignals", PACKET_DISABLE, remote_supported_packet,
4635 PACKET_QPassSignals },
4636 { "QCatchSyscalls", PACKET_DISABLE, remote_supported_packet,
4637 PACKET_QCatchSyscalls },
4638 { "QProgramSignals", PACKET_DISABLE, remote_supported_packet,
4639 PACKET_QProgramSignals },
4640 { "QStartupWithShell", PACKET_DISABLE, remote_supported_packet,
4641 PACKET_QStartupWithShell },
4642 { "QEnvironmentHexEncoded", PACKET_DISABLE, remote_supported_packet,
4643 PACKET_QEnvironmentHexEncoded },
4644 { "QEnvironmentReset", PACKET_DISABLE, remote_supported_packet,
4645 PACKET_QEnvironmentReset },
4646 { "QEnvironmentUnset", PACKET_DISABLE, remote_supported_packet,
4647 PACKET_QEnvironmentUnset },
4648 { "QStartNoAckMode", PACKET_DISABLE, remote_supported_packet,
4649 PACKET_QStartNoAckMode },
4650 { "multiprocess", PACKET_DISABLE, remote_supported_packet,
4651 PACKET_multiprocess_feature },
4652 { "QNonStop", PACKET_DISABLE, remote_supported_packet, PACKET_QNonStop },
4653 { "qXfer:siginfo:read", PACKET_DISABLE, remote_supported_packet,
4654 PACKET_qXfer_siginfo_read },
4655 { "qXfer:siginfo:write", PACKET_DISABLE, remote_supported_packet,
4656 PACKET_qXfer_siginfo_write },
4657 { "ConditionalTracepoints", PACKET_DISABLE, remote_supported_packet,
4658 PACKET_ConditionalTracepoints },
4659 { "ConditionalBreakpoints", PACKET_DISABLE, remote_supported_packet,
4660 PACKET_ConditionalBreakpoints },
4661 { "BreakpointCommands", PACKET_DISABLE, remote_supported_packet,
4662 PACKET_BreakpointCommands },
4663 { "FastTracepoints", PACKET_DISABLE, remote_supported_packet,
4664 PACKET_FastTracepoints },
4665 { "StaticTracepoints", PACKET_DISABLE, remote_supported_packet,
4666 PACKET_StaticTracepoints },
4667 {"InstallInTrace", PACKET_DISABLE, remote_supported_packet,
4668 PACKET_InstallInTrace},
4669 { "DisconnectedTracing", PACKET_DISABLE, remote_supported_packet,
4670 PACKET_DisconnectedTracing_feature },
4671 { "ReverseContinue", PACKET_DISABLE, remote_supported_packet,
4673 { "ReverseStep", PACKET_DISABLE, remote_supported_packet,
4675 { "TracepointSource", PACKET_DISABLE, remote_supported_packet,
4676 PACKET_TracepointSource },
4677 { "QAllow", PACKET_DISABLE, remote_supported_packet,
4679 { "EnableDisableTracepoints", PACKET_DISABLE, remote_supported_packet,
4680 PACKET_EnableDisableTracepoints_feature },
4681 { "qXfer:fdpic:read", PACKET_DISABLE, remote_supported_packet,
4682 PACKET_qXfer_fdpic },
4683 { "qXfer:uib:read", PACKET_DISABLE, remote_supported_packet,
4685 { "QDisableRandomization", PACKET_DISABLE, remote_supported_packet,
4686 PACKET_QDisableRandomization },
4687 { "QAgent", PACKET_DISABLE, remote_supported_packet, PACKET_QAgent},
4688 { "QTBuffer:size", PACKET_DISABLE,
4689 remote_supported_packet, PACKET_QTBuffer_size},
4690 { "tracenz", PACKET_DISABLE, remote_supported_packet, PACKET_tracenz_feature },
4691 { "Qbtrace:off", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_off },
4692 { "Qbtrace:bts", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_bts },
4693 { "Qbtrace:pt", PACKET_DISABLE, remote_supported_packet, PACKET_Qbtrace_pt },
4694 { "qXfer:btrace:read", PACKET_DISABLE, remote_supported_packet,
4695 PACKET_qXfer_btrace },
4696 { "qXfer:btrace-conf:read", PACKET_DISABLE, remote_supported_packet,
4697 PACKET_qXfer_btrace_conf },
4698 { "Qbtrace-conf:bts:size", PACKET_DISABLE, remote_supported_packet,
4699 PACKET_Qbtrace_conf_bts_size },
4700 { "swbreak", PACKET_DISABLE, remote_supported_packet, PACKET_swbreak_feature },
4701 { "hwbreak", PACKET_DISABLE, remote_supported_packet, PACKET_hwbreak_feature },
4702 { "fork-events", PACKET_DISABLE, remote_supported_packet,
4703 PACKET_fork_event_feature },
4704 { "vfork-events", PACKET_DISABLE, remote_supported_packet,
4705 PACKET_vfork_event_feature },
4706 { "exec-events", PACKET_DISABLE, remote_supported_packet,
4707 PACKET_exec_event_feature },
4708 { "Qbtrace-conf:pt:size", PACKET_DISABLE, remote_supported_packet,
4709 PACKET_Qbtrace_conf_pt_size },
4710 { "vContSupported", PACKET_DISABLE, remote_supported_packet, PACKET_vContSupported },
4711 { "QThreadEvents", PACKET_DISABLE, remote_supported_packet, PACKET_QThreadEvents },
4712 { "no-resumed", PACKET_DISABLE, remote_supported_packet, PACKET_no_resumed },
4715 static char *remote_support_xml;
4717 /* Register string appended to "xmlRegisters=" in qSupported query. */
4720 register_remote_support_xml (const char *xml)
4722 #if defined(HAVE_LIBEXPAT)
4723 if (remote_support_xml == NULL)
4724 remote_support_xml = concat ("xmlRegisters=", xml, (char *) NULL);
4727 char *copy = xstrdup (remote_support_xml + 13);
4728 char *p = strtok (copy, ",");
4732 if (strcmp (p, xml) == 0)
4739 while ((p = strtok (NULL, ",")) != NULL);
4742 remote_support_xml = reconcat (remote_support_xml,
4743 remote_support_xml, ",", xml,
4750 remote_query_supported_append (char *msg, const char *append)
4753 return reconcat (msg, msg, ";", append, (char *) NULL);
4755 return xstrdup (append);
4759 remote_query_supported (void)
4761 struct remote_state *rs = get_remote_state ();
4764 unsigned char seen [ARRAY_SIZE (remote_protocol_features)];
4766 /* The packet support flags are handled differently for this packet
4767 than for most others. We treat an error, a disabled packet, and
4768 an empty response identically: any features which must be reported
4769 to be used will be automatically disabled. An empty buffer
4770 accomplishes this, since that is also the representation for a list
4771 containing no features. */
4774 if (packet_support (PACKET_qSupported) != PACKET_DISABLE)
4777 struct cleanup *old_chain = make_cleanup (free_current_contents, &q);
4779 if (packet_set_cmd_state (PACKET_multiprocess_feature) != AUTO_BOOLEAN_FALSE)
4780 q = remote_query_supported_append (q, "multiprocess+");
4782 if (packet_set_cmd_state (PACKET_swbreak_feature) != AUTO_BOOLEAN_FALSE)
4783 q = remote_query_supported_append (q, "swbreak+");
4784 if (packet_set_cmd_state (PACKET_hwbreak_feature) != AUTO_BOOLEAN_FALSE)
4785 q = remote_query_supported_append (q, "hwbreak+");
4787 q = remote_query_supported_append (q, "qRelocInsn+");
4789 if (packet_set_cmd_state (PACKET_fork_event_feature)
4790 != AUTO_BOOLEAN_FALSE)
4791 q = remote_query_supported_append (q, "fork-events+");
4792 if (packet_set_cmd_state (PACKET_vfork_event_feature)
4793 != AUTO_BOOLEAN_FALSE)
4794 q = remote_query_supported_append (q, "vfork-events+");
4795 if (packet_set_cmd_state (PACKET_exec_event_feature)
4796 != AUTO_BOOLEAN_FALSE)
4797 q = remote_query_supported_append (q, "exec-events+");
4799 if (packet_set_cmd_state (PACKET_vContSupported) != AUTO_BOOLEAN_FALSE)
4800 q = remote_query_supported_append (q, "vContSupported+");
4802 if (packet_set_cmd_state (PACKET_QThreadEvents) != AUTO_BOOLEAN_FALSE)
4803 q = remote_query_supported_append (q, "QThreadEvents+");
4805 if (packet_set_cmd_state (PACKET_no_resumed) != AUTO_BOOLEAN_FALSE)
4806 q = remote_query_supported_append (q, "no-resumed+");
4808 /* Keep this one last to work around a gdbserver <= 7.10 bug in
4809 the qSupported:xmlRegisters=i386 handling. */
4810 if (remote_support_xml != NULL)
4811 q = remote_query_supported_append (q, remote_support_xml);
4813 q = reconcat (q, "qSupported:", q, (char *) NULL);
4816 do_cleanups (old_chain);
4818 getpkt (&rs->buf, &rs->buf_size, 0);
4820 /* If an error occured, warn, but do not return - just reset the
4821 buffer to empty and go on to disable features. */
4822 if (packet_ok (rs->buf, &remote_protocol_packets[PACKET_qSupported])
4825 warning (_("Remote failure reply: %s"), rs->buf);
4830 memset (seen, 0, sizeof (seen));
4835 enum packet_support is_supported;
4836 char *p, *end, *name_end, *value;
4838 /* First separate out this item from the rest of the packet. If
4839 there's another item after this, we overwrite the separator
4840 (terminated strings are much easier to work with). */
4842 end = strchr (p, ';');
4845 end = p + strlen (p);
4855 warning (_("empty item in \"qSupported\" response"));
4860 name_end = strchr (p, '=');
4863 /* This is a name=value entry. */
4864 is_supported = PACKET_ENABLE;
4865 value = name_end + 1;
4874 is_supported = PACKET_ENABLE;
4878 is_supported = PACKET_DISABLE;
4882 is_supported = PACKET_SUPPORT_UNKNOWN;
4886 warning (_("unrecognized item \"%s\" "
4887 "in \"qSupported\" response"), p);
4893 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
4894 if (strcmp (remote_protocol_features[i].name, p) == 0)
4896 const struct protocol_feature *feature;
4899 feature = &remote_protocol_features[i];
4900 feature->func (feature, is_supported, value);
4905 /* If we increased the packet size, make sure to increase the global
4906 buffer size also. We delay this until after parsing the entire
4907 qSupported packet, because this is the same buffer we were
4909 if (rs->buf_size < rs->explicit_packet_size)
4911 rs->buf_size = rs->explicit_packet_size;
4912 rs->buf = (char *) xrealloc (rs->buf, rs->buf_size);
4915 /* Handle the defaults for unmentioned features. */
4916 for (i = 0; i < ARRAY_SIZE (remote_protocol_features); i++)
4919 const struct protocol_feature *feature;
4921 feature = &remote_protocol_features[i];
4922 feature->func (feature, feature->default_support, NULL);
4926 /* Serial QUIT handler for the remote serial descriptor.
4928 Defers handling a Ctrl-C until we're done with the current
4929 command/response packet sequence, unless:
4931 - We're setting up the connection. Don't send a remote interrupt
4932 request, as we're not fully synced yet. Quit immediately
4935 - The target has been resumed in the foreground
4936 (target_terminal_is_ours is false) with a synchronous resume
4937 packet, and we're blocked waiting for the stop reply, thus a
4938 Ctrl-C should be immediately sent to the target.
4940 - We get a second Ctrl-C while still within the same serial read or
4941 write. In that case the serial is seemingly wedged --- offer to
4944 - We see a second Ctrl-C without target response, after having
4945 previously interrupted the target. In that case the target/stub
4946 is probably wedged --- offer to quit/disconnect.
4950 remote_serial_quit_handler (void)
4952 struct remote_state *rs = get_remote_state ();
4954 if (check_quit_flag ())
4956 /* If we're starting up, we're not fully synced yet. Quit
4958 if (rs->starting_up)
4960 else if (rs->got_ctrlc_during_io)
4962 if (query (_("The target is not responding to GDB commands.\n"
4963 "Stop debugging it? ")))
4964 remote_unpush_and_throw ();
4966 /* If ^C has already been sent once, offer to disconnect. */
4967 else if (!target_terminal_is_ours () && rs->ctrlc_pending_p)
4969 /* All-stop protocol, and blocked waiting for stop reply. Send
4970 an interrupt request. */
4971 else if (!target_terminal_is_ours () && rs->waiting_for_stop_reply)
4972 target_interrupt (inferior_ptid);
4974 rs->got_ctrlc_during_io = 1;
4978 /* Remove any of the remote.c targets from target stack. Upper targets depend
4979 on it so remove them first. */
4982 remote_unpush_target (void)
4984 pop_all_targets_at_and_above (process_stratum);
4988 remote_unpush_and_throw (void)
4990 remote_unpush_target ();
4991 throw_error (TARGET_CLOSE_ERROR, _("Disconnected from target."));
4995 remote_open_1 (const char *name, int from_tty,
4996 struct target_ops *target, int extended_p)
4998 struct remote_state *rs = get_remote_state ();
5001 error (_("To open a remote debug connection, you need to specify what\n"
5002 "serial device is attached to the remote system\n"
5003 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
5005 /* See FIXME above. */
5006 if (!target_async_permitted)
5007 wait_forever_enabled_p = 1;
5009 /* If we're connected to a running target, target_preopen will kill it.
5010 Ask this question first, before target_preopen has a chance to kill
5012 if (rs->remote_desc != NULL && !have_inferiors ())
5015 && !query (_("Already connected to a remote target. Disconnect? ")))
5016 error (_("Still connected."));
5019 /* Here the possibly existing remote target gets unpushed. */
5020 target_preopen (from_tty);
5022 /* Make sure we send the passed signals list the next time we resume. */
5023 xfree (rs->last_pass_packet);
5024 rs->last_pass_packet = NULL;
5026 /* Make sure we send the program signals list the next time we
5028 xfree (rs->last_program_signals_packet);
5029 rs->last_program_signals_packet = NULL;
5031 remote_fileio_reset ();
5032 reopen_exec_file ();
5035 rs->remote_desc = remote_serial_open (name);
5036 if (!rs->remote_desc)
5037 perror_with_name (name);
5039 if (baud_rate != -1)
5041 if (serial_setbaudrate (rs->remote_desc, baud_rate))
5043 /* The requested speed could not be set. Error out to
5044 top level after closing remote_desc. Take care to
5045 set remote_desc to NULL to avoid closing remote_desc
5047 serial_close (rs->remote_desc);
5048 rs->remote_desc = NULL;
5049 perror_with_name (name);
5053 serial_setparity (rs->remote_desc, serial_parity);
5054 serial_raw (rs->remote_desc);
5056 /* If there is something sitting in the buffer we might take it as a
5057 response to a command, which would be bad. */
5058 serial_flush_input (rs->remote_desc);
5062 puts_filtered ("Remote debugging using ");
5063 puts_filtered (name);
5064 puts_filtered ("\n");
5066 push_target (target); /* Switch to using remote target now. */
5068 /* Register extra event sources in the event loop. */
5069 remote_async_inferior_event_token
5070 = create_async_event_handler (remote_async_inferior_event_handler,
5072 rs->notif_state = remote_notif_state_allocate ();
5074 /* Reset the target state; these things will be queried either by
5075 remote_query_supported or as they are needed. */
5076 reset_all_packet_configs_support ();
5077 rs->cached_wait_status = 0;
5078 rs->explicit_packet_size = 0;
5080 rs->extended = extended_p;
5081 rs->waiting_for_stop_reply = 0;
5082 rs->ctrlc_pending_p = 0;
5083 rs->got_ctrlc_during_io = 0;
5085 rs->general_thread = not_sent_ptid;
5086 rs->continue_thread = not_sent_ptid;
5087 rs->remote_traceframe_number = -1;
5089 rs->last_resume_exec_dir = EXEC_FORWARD;
5091 /* Probe for ability to use "ThreadInfo" query, as required. */
5092 rs->use_threadinfo_query = 1;
5093 rs->use_threadextra_query = 1;
5095 readahead_cache_invalidate ();
5097 /* Start out by owning the terminal. */
5098 remote_async_terminal_ours_p = 1;
5100 if (target_async_permitted)
5102 /* FIXME: cagney/1999-09-23: During the initial connection it is
5103 assumed that the target is already ready and able to respond to
5104 requests. Unfortunately remote_start_remote() eventually calls
5105 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
5106 around this. Eventually a mechanism that allows
5107 wait_for_inferior() to expect/get timeouts will be
5109 wait_forever_enabled_p = 0;
5112 /* First delete any symbols previously loaded from shared libraries. */
5113 no_shared_libraries (NULL, 0);
5116 init_thread_list ();
5118 /* Start the remote connection. If error() or QUIT, discard this
5119 target (we'd otherwise be in an inconsistent state) and then
5120 propogate the error on up the exception chain. This ensures that
5121 the caller doesn't stumble along blindly assuming that the
5122 function succeeded. The CLI doesn't have this problem but other
5123 UI's, such as MI do.
5125 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
5126 this function should return an error indication letting the
5127 caller restore the previous state. Unfortunately the command
5128 ``target remote'' is directly wired to this function making that
5129 impossible. On a positive note, the CLI side of this problem has
5130 been fixed - the function set_cmd_context() makes it possible for
5131 all the ``target ....'' commands to share a common callback
5132 function. See cli-dump.c. */
5137 remote_start_remote (from_tty, target, extended_p);
5139 CATCH (ex, RETURN_MASK_ALL)
5141 /* Pop the partially set up target - unless something else did
5142 already before throwing the exception. */
5143 if (rs->remote_desc != NULL)
5144 remote_unpush_target ();
5145 if (target_async_permitted)
5146 wait_forever_enabled_p = 1;
5147 throw_exception (ex);
5152 remote_btrace_reset ();
5154 if (target_async_permitted)
5155 wait_forever_enabled_p = 1;
5158 /* Detach the specified process. */
5161 remote_detach_pid (int pid)
5163 struct remote_state *rs = get_remote_state ();
5165 if (remote_multi_process_p (rs))
5166 xsnprintf (rs->buf, get_remote_packet_size (), "D;%x", pid);
5168 strcpy (rs->buf, "D");
5171 getpkt (&rs->buf, &rs->buf_size, 0);
5173 if (rs->buf[0] == 'O' && rs->buf[1] == 'K')
5175 else if (rs->buf[0] == '\0')
5176 error (_("Remote doesn't know how to detach"));
5178 error (_("Can't detach process."));
5181 /* This detaches a program to which we previously attached, using
5182 inferior_ptid to identify the process. After this is done, GDB
5183 can be used to debug some other program. We better not have left
5184 any breakpoints in the target program or it'll die when it hits
5188 remote_detach_1 (const char *args, int from_tty)
5190 int pid = ptid_get_pid (inferior_ptid);
5191 struct remote_state *rs = get_remote_state ();
5192 struct thread_info *tp = find_thread_ptid (inferior_ptid);
5196 error (_("Argument given to \"detach\" when remotely debugging."));
5198 if (!target_has_execution)
5199 error (_("No process to detach from."));
5201 target_announce_detach (from_tty);
5203 /* Tell the remote target to detach. */
5204 remote_detach_pid (pid);
5206 /* Exit only if this is the only active inferior. */
5207 if (from_tty && !rs->extended && number_of_live_inferiors () == 1)
5208 puts_filtered (_("Ending remote debugging.\n"));
5210 /* Check to see if we are detaching a fork parent. Note that if we
5211 are detaching a fork child, tp == NULL. */
5212 is_fork_parent = (tp != NULL
5213 && tp->pending_follow.kind == TARGET_WAITKIND_FORKED);
5215 /* If doing detach-on-fork, we don't mourn, because that will delete
5216 breakpoints that should be available for the followed inferior. */
5217 if (!is_fork_parent)
5218 target_mourn_inferior (inferior_ptid);
5221 inferior_ptid = null_ptid;
5222 detach_inferior (pid);
5227 remote_detach (struct target_ops *ops, const char *args, int from_tty)
5229 remote_detach_1 (args, from_tty);
5233 extended_remote_detach (struct target_ops *ops, const char *args, int from_tty)
5235 remote_detach_1 (args, from_tty);
5238 /* Target follow-fork function for remote targets. On entry, and
5239 at return, the current inferior is the fork parent.
5241 Note that although this is currently only used for extended-remote,
5242 it is named remote_follow_fork in anticipation of using it for the
5243 remote target as well. */
5246 remote_follow_fork (struct target_ops *ops, int follow_child,
5249 struct remote_state *rs = get_remote_state ();
5250 enum target_waitkind kind = inferior_thread ()->pending_follow.kind;
5252 if ((kind == TARGET_WAITKIND_FORKED && remote_fork_event_p (rs))
5253 || (kind == TARGET_WAITKIND_VFORKED && remote_vfork_event_p (rs)))
5255 /* When following the parent and detaching the child, we detach
5256 the child here. For the case of following the child and
5257 detaching the parent, the detach is done in the target-
5258 independent follow fork code in infrun.c. We can't use
5259 target_detach when detaching an unfollowed child because
5260 the client side doesn't know anything about the child. */
5261 if (detach_fork && !follow_child)
5263 /* Detach the fork child. */
5267 child_ptid = inferior_thread ()->pending_follow.value.related_pid;
5268 child_pid = ptid_get_pid (child_ptid);
5270 remote_detach_pid (child_pid);
5271 detach_inferior (child_pid);
5277 /* Target follow-exec function for remote targets. Save EXECD_PATHNAME
5278 in the program space of the new inferior. On entry and at return the
5279 current inferior is the exec'ing inferior. INF is the new exec'd
5280 inferior, which may be the same as the exec'ing inferior unless
5281 follow-exec-mode is "new". */
5284 remote_follow_exec (struct target_ops *ops,
5285 struct inferior *inf, char *execd_pathname)
5287 /* We know that this is a target file name, so if it has the "target:"
5288 prefix we strip it off before saving it in the program space. */
5289 if (is_target_filename (execd_pathname))
5290 execd_pathname += strlen (TARGET_SYSROOT_PREFIX);
5292 set_pspace_remote_exec_file (inf->pspace, execd_pathname);
5295 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
5298 remote_disconnect (struct target_ops *target, const char *args, int from_tty)
5301 error (_("Argument given to \"disconnect\" when remotely debugging."));
5303 /* Make sure we unpush even the extended remote targets. Calling
5304 target_mourn_inferior won't unpush, and remote_mourn won't
5305 unpush if there is more than one inferior left. */
5306 unpush_target (target);
5307 generic_mourn_inferior ();
5310 puts_filtered ("Ending remote debugging.\n");
5313 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
5314 be chatty about it. */
5317 extended_remote_attach (struct target_ops *target, const char *args,
5320 struct remote_state *rs = get_remote_state ();
5322 char *wait_status = NULL;
5324 pid = parse_pid_to_attach (args);
5326 /* Remote PID can be freely equal to getpid, do not check it here the same
5327 way as in other targets. */
5329 if (packet_support (PACKET_vAttach) == PACKET_DISABLE)
5330 error (_("This target does not support attaching to a process"));
5334 char *exec_file = get_exec_file (0);
5337 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file,
5338 target_pid_to_str (pid_to_ptid (pid)));
5340 printf_unfiltered (_("Attaching to %s\n"),
5341 target_pid_to_str (pid_to_ptid (pid)));
5343 gdb_flush (gdb_stdout);
5346 xsnprintf (rs->buf, get_remote_packet_size (), "vAttach;%x", pid);
5348 getpkt (&rs->buf, &rs->buf_size, 0);
5350 switch (packet_ok (rs->buf,
5351 &remote_protocol_packets[PACKET_vAttach]))
5354 if (!target_is_non_stop_p ())
5356 /* Save the reply for later. */
5357 wait_status = (char *) alloca (strlen (rs->buf) + 1);
5358 strcpy (wait_status, rs->buf);
5360 else if (strcmp (rs->buf, "OK") != 0)
5361 error (_("Attaching to %s failed with: %s"),
5362 target_pid_to_str (pid_to_ptid (pid)),
5365 case PACKET_UNKNOWN:
5366 error (_("This target does not support attaching to a process"));
5368 error (_("Attaching to %s failed"),
5369 target_pid_to_str (pid_to_ptid (pid)));
5372 set_current_inferior (remote_add_inferior (0, pid, 1, 0));
5374 inferior_ptid = pid_to_ptid (pid);
5376 if (target_is_non_stop_p ())
5378 struct thread_info *thread;
5380 /* Get list of threads. */
5381 remote_update_thread_list (target);
5383 thread = first_thread_of_process (pid);
5385 inferior_ptid = thread->ptid;
5387 inferior_ptid = pid_to_ptid (pid);
5389 /* Invalidate our notion of the remote current thread. */
5390 record_currthread (rs, minus_one_ptid);
5394 /* Now, if we have thread information, update inferior_ptid. */
5395 inferior_ptid = remote_current_thread (inferior_ptid);
5397 /* Add the main thread to the thread list. */
5398 add_thread_silent (inferior_ptid);
5401 /* Next, if the target can specify a description, read it. We do
5402 this before anything involving memory or registers. */
5403 target_find_description ();
5405 if (!target_is_non_stop_p ())
5407 /* Use the previously fetched status. */
5408 gdb_assert (wait_status != NULL);
5410 if (target_can_async_p ())
5412 struct notif_event *reply
5413 = remote_notif_parse (¬if_client_stop, wait_status);
5415 push_stop_reply ((struct stop_reply *) reply);
5421 gdb_assert (wait_status != NULL);
5422 strcpy (rs->buf, wait_status);
5423 rs->cached_wait_status = 1;
5427 gdb_assert (wait_status == NULL);
5430 /* Implementation of the to_post_attach method. */
5433 extended_remote_post_attach (struct target_ops *ops, int pid)
5435 /* Get text, data & bss offsets. */
5438 /* In certain cases GDB might not have had the chance to start
5439 symbol lookup up until now. This could happen if the debugged
5440 binary is not using shared libraries, the vsyscall page is not
5441 present (on Linux) and the binary itself hadn't changed since the
5442 debugging process was started. */
5443 if (symfile_objfile != NULL)
5444 remote_check_symbols();
5448 /* Check for the availability of vCont. This function should also check
5452 remote_vcont_probe (struct remote_state *rs)
5456 strcpy (rs->buf, "vCont?");
5458 getpkt (&rs->buf, &rs->buf_size, 0);
5461 /* Make sure that the features we assume are supported. */
5462 if (startswith (buf, "vCont"))
5465 int support_c, support_C;
5467 rs->supports_vCont.s = 0;
5468 rs->supports_vCont.S = 0;
5471 rs->supports_vCont.t = 0;
5472 rs->supports_vCont.r = 0;
5473 while (p && *p == ';')
5476 if (*p == 's' && (*(p + 1) == ';' || *(p + 1) == 0))
5477 rs->supports_vCont.s = 1;
5478 else if (*p == 'S' && (*(p + 1) == ';' || *(p + 1) == 0))
5479 rs->supports_vCont.S = 1;
5480 else if (*p == 'c' && (*(p + 1) == ';' || *(p + 1) == 0))
5482 else if (*p == 'C' && (*(p + 1) == ';' || *(p + 1) == 0))
5484 else if (*p == 't' && (*(p + 1) == ';' || *(p + 1) == 0))
5485 rs->supports_vCont.t = 1;
5486 else if (*p == 'r' && (*(p + 1) == ';' || *(p + 1) == 0))
5487 rs->supports_vCont.r = 1;
5489 p = strchr (p, ';');
5492 /* If c, and C are not all supported, we can't use vCont. Clearing
5493 BUF will make packet_ok disable the packet. */
5494 if (!support_c || !support_C)
5498 packet_ok (buf, &remote_protocol_packets[PACKET_vCont]);
5501 /* Helper function for building "vCont" resumptions. Write a
5502 resumption to P. ENDP points to one-passed-the-end of the buffer
5503 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
5504 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
5505 resumed thread should be single-stepped and/or signalled. If PTID
5506 equals minus_one_ptid, then all threads are resumed; if PTID
5507 represents a process, then all threads of the process are resumed;
5508 the thread to be stepped and/or signalled is given in the global
5512 append_resumption (char *p, char *endp,
5513 ptid_t ptid, int step, enum gdb_signal siggnal)
5515 struct remote_state *rs = get_remote_state ();
5517 if (step && siggnal != GDB_SIGNAL_0)
5518 p += xsnprintf (p, endp - p, ";S%02x", siggnal);
5520 /* GDB is willing to range step. */
5521 && use_range_stepping
5522 /* Target supports range stepping. */
5523 && rs->supports_vCont.r
5524 /* We don't currently support range stepping multiple
5525 threads with a wildcard (though the protocol allows it,
5526 so stubs shouldn't make an active effort to forbid
5528 && !(remote_multi_process_p (rs) && ptid_is_pid (ptid)))
5530 struct thread_info *tp;
5532 if (ptid_equal (ptid, minus_one_ptid))
5534 /* If we don't know about the target thread's tid, then
5535 we're resuming magic_null_ptid (see caller). */
5536 tp = find_thread_ptid (magic_null_ptid);
5539 tp = find_thread_ptid (ptid);
5540 gdb_assert (tp != NULL);
5542 if (tp->control.may_range_step)
5544 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
5546 p += xsnprintf (p, endp - p, ";r%s,%s",
5547 phex_nz (tp->control.step_range_start,
5549 phex_nz (tp->control.step_range_end,
5553 p += xsnprintf (p, endp - p, ";s");
5556 p += xsnprintf (p, endp - p, ";s");
5557 else if (siggnal != GDB_SIGNAL_0)
5558 p += xsnprintf (p, endp - p, ";C%02x", siggnal);
5560 p += xsnprintf (p, endp - p, ";c");
5562 if (remote_multi_process_p (rs) && ptid_is_pid (ptid))
5566 /* All (-1) threads of process. */
5567 nptid = ptid_build (ptid_get_pid (ptid), -1, 0);
5569 p += xsnprintf (p, endp - p, ":");
5570 p = write_ptid (p, endp, nptid);
5572 else if (!ptid_equal (ptid, minus_one_ptid))
5574 p += xsnprintf (p, endp - p, ":");
5575 p = write_ptid (p, endp, ptid);
5581 /* Clear the thread's private info on resume. */
5584 resume_clear_thread_private_info (struct thread_info *thread)
5586 if (thread->priv != NULL)
5588 thread->priv->stop_reason = TARGET_STOPPED_BY_NO_REASON;
5589 thread->priv->watch_data_address = 0;
5593 /* Append a vCont continue-with-signal action for threads that have a
5594 non-zero stop signal. */
5597 append_pending_thread_resumptions (char *p, char *endp, ptid_t ptid)
5599 struct thread_info *thread;
5601 ALL_NON_EXITED_THREADS (thread)
5602 if (ptid_match (thread->ptid, ptid)
5603 && !ptid_equal (inferior_ptid, thread->ptid)
5604 && thread->suspend.stop_signal != GDB_SIGNAL_0)
5606 p = append_resumption (p, endp, thread->ptid,
5607 0, thread->suspend.stop_signal);
5608 thread->suspend.stop_signal = GDB_SIGNAL_0;
5609 resume_clear_thread_private_info (thread);
5615 /* Set the target running, using the packets that use Hc
5619 remote_resume_with_hc (struct target_ops *ops,
5620 ptid_t ptid, int step, enum gdb_signal siggnal)
5622 struct remote_state *rs = get_remote_state ();
5623 struct thread_info *thread;
5626 rs->last_sent_signal = siggnal;
5627 rs->last_sent_step = step;
5629 /* The c/s/C/S resume packets use Hc, so set the continue
5631 if (ptid_equal (ptid, minus_one_ptid))
5632 set_continue_thread (any_thread_ptid);
5634 set_continue_thread (ptid);
5636 ALL_NON_EXITED_THREADS (thread)
5637 resume_clear_thread_private_info (thread);
5640 if (execution_direction == EXEC_REVERSE)
5642 /* We don't pass signals to the target in reverse exec mode. */
5643 if (info_verbose && siggnal != GDB_SIGNAL_0)
5644 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
5647 if (step && packet_support (PACKET_bs) == PACKET_DISABLE)
5648 error (_("Remote reverse-step not supported."));
5649 if (!step && packet_support (PACKET_bc) == PACKET_DISABLE)
5650 error (_("Remote reverse-continue not supported."));
5652 strcpy (buf, step ? "bs" : "bc");
5654 else if (siggnal != GDB_SIGNAL_0)
5656 buf[0] = step ? 'S' : 'C';
5657 buf[1] = tohex (((int) siggnal >> 4) & 0xf);
5658 buf[2] = tohex (((int) siggnal) & 0xf);
5662 strcpy (buf, step ? "s" : "c");
5667 /* Resume the remote inferior by using a "vCont" packet. The thread
5668 to be resumed is PTID; STEP and SIGGNAL indicate whether the
5669 resumed thread should be single-stepped and/or signalled. If PTID
5670 equals minus_one_ptid, then all threads are resumed; the thread to
5671 be stepped and/or signalled is given in the global INFERIOR_PTID.
5672 This function returns non-zero iff it resumes the inferior.
5674 This function issues a strict subset of all possible vCont commands
5678 remote_resume_with_vcont (ptid_t ptid, int step, enum gdb_signal siggnal)
5680 struct remote_state *rs = get_remote_state ();
5684 /* No reverse execution actions defined for vCont. */
5685 if (execution_direction == EXEC_REVERSE)
5688 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
5689 remote_vcont_probe (rs);
5691 if (packet_support (PACKET_vCont) == PACKET_DISABLE)
5695 endp = rs->buf + get_remote_packet_size ();
5697 /* If we could generate a wider range of packets, we'd have to worry
5698 about overflowing BUF. Should there be a generic
5699 "multi-part-packet" packet? */
5701 p += xsnprintf (p, endp - p, "vCont");
5703 if (ptid_equal (ptid, magic_null_ptid))
5705 /* MAGIC_NULL_PTID means that we don't have any active threads,
5706 so we don't have any TID numbers the inferior will
5707 understand. Make sure to only send forms that do not specify
5709 append_resumption (p, endp, minus_one_ptid, step, siggnal);
5711 else if (ptid_equal (ptid, minus_one_ptid) || ptid_is_pid (ptid))
5713 /* Resume all threads (of all processes, or of a single
5714 process), with preference for INFERIOR_PTID. This assumes
5715 inferior_ptid belongs to the set of all threads we are about
5717 if (step || siggnal != GDB_SIGNAL_0)
5719 /* Step inferior_ptid, with or without signal. */
5720 p = append_resumption (p, endp, inferior_ptid, step, siggnal);
5723 /* Also pass down any pending signaled resumption for other
5724 threads not the current. */
5725 p = append_pending_thread_resumptions (p, endp, ptid);
5727 /* And continue others without a signal. */
5728 append_resumption (p, endp, ptid, /*step=*/ 0, GDB_SIGNAL_0);
5732 /* Scheduler locking; resume only PTID. */
5733 append_resumption (p, endp, ptid, step, siggnal);
5736 gdb_assert (strlen (rs->buf) < get_remote_packet_size ());
5739 if (target_is_non_stop_p ())
5741 /* In non-stop, the stub replies to vCont with "OK". The stop
5742 reply will be reported asynchronously by means of a `%Stop'
5744 getpkt (&rs->buf, &rs->buf_size, 0);
5745 if (strcmp (rs->buf, "OK") != 0)
5746 error (_("Unexpected vCont reply in non-stop mode: %s"), rs->buf);
5752 /* Tell the remote machine to resume. */
5755 remote_resume (struct target_ops *ops,
5756 ptid_t ptid, int step, enum gdb_signal siggnal)
5758 struct remote_state *rs = get_remote_state ();
5760 /* When connected in non-stop mode, the core resumes threads
5761 individually. Resuming remote threads directly in target_resume
5762 would thus result in sending one packet per thread. Instead, to
5763 minimize roundtrip latency, here we just store the resume
5764 request; the actual remote resumption will be done in
5765 target_commit_resume / remote_commit_resume, where we'll be able
5766 to do vCont action coalescing. */
5767 if (target_is_non_stop_p () && execution_direction != EXEC_REVERSE)
5769 struct private_thread_info *remote_thr;
5771 if (ptid_equal (minus_one_ptid, ptid) || ptid_is_pid (ptid))
5772 remote_thr = get_private_info_ptid (inferior_ptid);
5774 remote_thr = get_private_info_ptid (ptid);
5775 remote_thr->last_resume_step = step;
5776 remote_thr->last_resume_sig = siggnal;
5780 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
5781 (explained in remote-notif.c:handle_notification) so
5782 remote_notif_process is not called. We need find a place where
5783 it is safe to start a 'vNotif' sequence. It is good to do it
5784 before resuming inferior, because inferior was stopped and no RSP
5785 traffic at that moment. */
5786 if (!target_is_non_stop_p ())
5787 remote_notif_process (rs->notif_state, ¬if_client_stop);
5789 rs->last_resume_exec_dir = execution_direction;
5791 /* Prefer vCont, and fallback to s/c/S/C, which use Hc. */
5792 if (!remote_resume_with_vcont (ptid, step, siggnal))
5793 remote_resume_with_hc (ops, ptid, step, siggnal);
5795 /* We are about to start executing the inferior, let's register it
5796 with the event loop. NOTE: this is the one place where all the
5797 execution commands end up. We could alternatively do this in each
5798 of the execution commands in infcmd.c. */
5799 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
5800 into infcmd.c in order to allow inferior function calls to work
5801 NOT asynchronously. */
5802 if (target_can_async_p ())
5805 /* We've just told the target to resume. The remote server will
5806 wait for the inferior to stop, and then send a stop reply. In
5807 the mean time, we can't start another command/query ourselves
5808 because the stub wouldn't be ready to process it. This applies
5809 only to the base all-stop protocol, however. In non-stop (which
5810 only supports vCont), the stub replies with an "OK", and is
5811 immediate able to process further serial input. */
5812 if (!target_is_non_stop_p ())
5813 rs->waiting_for_stop_reply = 1;
5816 static void check_pending_events_prevent_wildcard_vcont
5817 (int *may_global_wildcard_vcont);
5818 static int is_pending_fork_parent_thread (struct thread_info *thread);
5820 /* Private per-inferior info for target remote processes. */
5822 struct private_inferior
5824 /* Whether we can send a wildcard vCont for this process. */
5825 int may_wildcard_vcont;
5828 /* Structure used to track the construction of a vCont packet in the
5829 outgoing packet buffer. This is used to send multiple vCont
5830 packets if we have more actions than would fit a single packet. */
5832 struct vcont_builder
5834 /* Pointer to the first action. P points here if no action has been
5838 /* Where the next action will be appended. */
5841 /* The end of the buffer. Must never write past this. */
5845 /* Prepare the outgoing buffer for a new vCont packet. */
5848 vcont_builder_restart (struct vcont_builder *builder)
5850 struct remote_state *rs = get_remote_state ();
5852 builder->p = rs->buf;
5853 builder->endp = rs->buf + get_remote_packet_size ();
5854 builder->p += xsnprintf (builder->p, builder->endp - builder->p, "vCont");
5855 builder->first_action = builder->p;
5858 /* If the vCont packet being built has any action, send it to the
5862 vcont_builder_flush (struct vcont_builder *builder)
5864 struct remote_state *rs;
5866 if (builder->p == builder->first_action)
5869 rs = get_remote_state ();
5871 getpkt (&rs->buf, &rs->buf_size, 0);
5872 if (strcmp (rs->buf, "OK") != 0)
5873 error (_("Unexpected vCont reply in non-stop mode: %s"), rs->buf);
5876 /* The largest action is range-stepping, with its two addresses. This
5877 is more than sufficient. If a new, bigger action is created, it'll
5878 quickly trigger a failed assertion in append_resumption (and we'll
5880 #define MAX_ACTION_SIZE 200
5882 /* Append a new vCont action in the outgoing packet being built. If
5883 the action doesn't fit the packet along with previous actions, push
5884 what we've got so far to the remote end and start over a new vCont
5885 packet (with the new action). */
5888 vcont_builder_push_action (struct vcont_builder *builder,
5889 ptid_t ptid, int step, enum gdb_signal siggnal)
5891 char buf[MAX_ACTION_SIZE + 1];
5895 endp = append_resumption (buf, buf + sizeof (buf),
5896 ptid, step, siggnal);
5898 /* Check whether this new action would fit in the vCont packet along
5899 with previous actions. If not, send what we've got so far and
5900 start a new vCont packet. */
5902 if (rsize > builder->endp - builder->p)
5904 vcont_builder_flush (builder);
5905 vcont_builder_restart (builder);
5907 /* Should now fit. */
5908 gdb_assert (rsize <= builder->endp - builder->p);
5911 memcpy (builder->p, buf, rsize);
5912 builder->p += rsize;
5916 /* to_commit_resume implementation. */
5919 remote_commit_resume (struct target_ops *ops)
5921 struct remote_state *rs = get_remote_state ();
5922 struct inferior *inf;
5923 struct thread_info *tp;
5924 int any_process_wildcard;
5925 int may_global_wildcard_vcont;
5926 struct vcont_builder vcont_builder;
5928 /* If connected in all-stop mode, we'd send the remote resume
5929 request directly from remote_resume. Likewise if
5930 reverse-debugging, as there are no defined vCont actions for
5931 reverse execution. */
5932 if (!target_is_non_stop_p () || execution_direction == EXEC_REVERSE)
5935 /* Try to send wildcard actions ("vCont;c" or "vCont;c:pPID.-1")
5936 instead of resuming all threads of each process individually.
5937 However, if any thread of a process must remain halted, we can't
5938 send wildcard resumes and must send one action per thread.
5940 Care must be taken to not resume threads/processes the server
5941 side already told us are stopped, but the core doesn't know about
5942 yet, because the events are still in the vStopped notification
5945 #1 => vCont s:p1.1;c
5947 #3 <= %Stopped T05 p1.1
5952 #8 (infrun handles the stop for p1.1 and continues stepping)
5953 #9 => vCont s:p1.1;c
5955 The last vCont above would resume thread p1.2 by mistake, because
5956 the server has no idea that the event for p1.2 had not been
5959 The server side must similarly ignore resume actions for the
5960 thread that has a pending %Stopped notification (and any other
5961 threads with events pending), until GDB acks the notification
5962 with vStopped. Otherwise, e.g., the following case is
5965 #1 => g (or any other packet)
5967 #3 <= %Stopped T05 p1.2
5968 #4 => vCont s:p1.1;c
5971 Above, the server must not resume thread p1.2. GDB can't know
5972 that p1.2 stopped until it acks the %Stopped notification, and
5973 since from GDB's perspective all threads should be running, it
5976 Finally, special care must also be given to handling fork/vfork
5977 events. A (v)fork event actually tells us that two processes
5978 stopped -- the parent and the child. Until we follow the fork,
5979 we must not resume the child. Therefore, if we have a pending
5980 fork follow, we must not send a global wildcard resume action
5981 (vCont;c). We can still send process-wide wildcards though. */
5983 /* Start by assuming a global wildcard (vCont;c) is possible. */
5984 may_global_wildcard_vcont = 1;
5986 /* And assume every process is individually wildcard-able too. */
5987 ALL_NON_EXITED_INFERIORS (inf)
5989 if (inf->priv == NULL)
5990 inf->priv = XNEW (struct private_inferior);
5991 inf->priv->may_wildcard_vcont = 1;
5994 /* Check for any pending events (not reported or processed yet) and
5995 disable process and global wildcard resumes appropriately. */
5996 check_pending_events_prevent_wildcard_vcont (&may_global_wildcard_vcont);
5998 ALL_NON_EXITED_THREADS (tp)
6000 /* If a thread of a process is not meant to be resumed, then we
6001 can't wildcard that process. */
6004 tp->inf->priv->may_wildcard_vcont = 0;
6006 /* And if we can't wildcard a process, we can't wildcard
6007 everything either. */
6008 may_global_wildcard_vcont = 0;
6012 /* If a thread is the parent of an unfollowed fork, then we
6013 can't do a global wildcard, as that would resume the fork
6015 if (is_pending_fork_parent_thread (tp))
6016 may_global_wildcard_vcont = 0;
6019 /* Now let's build the vCont packet(s). Actions must be appended
6020 from narrower to wider scopes (thread -> process -> global). If
6021 we end up with too many actions for a single packet vcont_builder
6022 flushes the current vCont packet to the remote side and starts a
6024 vcont_builder_restart (&vcont_builder);
6026 /* Threads first. */
6027 ALL_NON_EXITED_THREADS (tp)
6029 struct private_thread_info *remote_thr = tp->priv;
6031 if (!tp->executing || remote_thr->vcont_resumed)
6034 gdb_assert (!thread_is_in_step_over_chain (tp));
6036 if (!remote_thr->last_resume_step
6037 && remote_thr->last_resume_sig == GDB_SIGNAL_0
6038 && tp->inf->priv->may_wildcard_vcont)
6040 /* We'll send a wildcard resume instead. */
6041 remote_thr->vcont_resumed = 1;
6045 vcont_builder_push_action (&vcont_builder, tp->ptid,
6046 remote_thr->last_resume_step,
6047 remote_thr->last_resume_sig);
6048 remote_thr->vcont_resumed = 1;
6051 /* Now check whether we can send any process-wide wildcard. This is
6052 to avoid sending a global wildcard in the case nothing is
6053 supposed to be resumed. */
6054 any_process_wildcard = 0;
6056 ALL_NON_EXITED_INFERIORS (inf)
6058 if (inf->priv->may_wildcard_vcont)
6060 any_process_wildcard = 1;
6065 if (any_process_wildcard)
6067 /* If all processes are wildcard-able, then send a single "c"
6068 action, otherwise, send an "all (-1) threads of process"
6069 continue action for each running process, if any. */
6070 if (may_global_wildcard_vcont)
6072 vcont_builder_push_action (&vcont_builder, minus_one_ptid,
6077 ALL_NON_EXITED_INFERIORS (inf)
6079 if (inf->priv->may_wildcard_vcont)
6081 vcont_builder_push_action (&vcont_builder,
6082 pid_to_ptid (inf->pid),
6089 vcont_builder_flush (&vcont_builder);
6094 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
6095 thread, all threads of a remote process, or all threads of all
6099 remote_stop_ns (ptid_t ptid)
6101 struct remote_state *rs = get_remote_state ();
6103 char *endp = rs->buf + get_remote_packet_size ();
6105 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
6106 remote_vcont_probe (rs);
6108 if (!rs->supports_vCont.t)
6109 error (_("Remote server does not support stopping threads"));
6111 if (ptid_equal (ptid, minus_one_ptid)
6112 || (!remote_multi_process_p (rs) && ptid_is_pid (ptid)))
6113 p += xsnprintf (p, endp - p, "vCont;t");
6118 p += xsnprintf (p, endp - p, "vCont;t:");
6120 if (ptid_is_pid (ptid))
6121 /* All (-1) threads of process. */
6122 nptid = ptid_build (ptid_get_pid (ptid), -1, 0);
6125 /* Small optimization: if we already have a stop reply for
6126 this thread, no use in telling the stub we want this
6128 if (peek_stop_reply (ptid))
6134 write_ptid (p, endp, nptid);
6137 /* In non-stop, we get an immediate OK reply. The stop reply will
6138 come in asynchronously by notification. */
6140 getpkt (&rs->buf, &rs->buf_size, 0);
6141 if (strcmp (rs->buf, "OK") != 0)
6142 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid), rs->buf);
6145 /* All-stop version of target_interrupt. Sends a break or a ^C to
6146 interrupt the remote target. It is undefined which thread of which
6147 process reports the interrupt. */
6150 remote_interrupt_as (void)
6152 struct remote_state *rs = get_remote_state ();
6154 rs->ctrlc_pending_p = 1;
6156 /* If the inferior is stopped already, but the core didn't know
6157 about it yet, just ignore the request. The cached wait status
6158 will be collected in remote_wait. */
6159 if (rs->cached_wait_status)
6162 /* Send interrupt_sequence to remote target. */
6163 send_interrupt_sequence ();
6166 /* Non-stop version of target_interrupt. Uses `vCtrlC' to interrupt
6167 the remote target. It is undefined which thread of which process
6168 reports the interrupt. Throws an error if the packet is not
6169 supported by the server. */
6172 remote_interrupt_ns (void)
6174 struct remote_state *rs = get_remote_state ();
6176 char *endp = rs->buf + get_remote_packet_size ();
6178 xsnprintf (p, endp - p, "vCtrlC");
6180 /* In non-stop, we get an immediate OK reply. The stop reply will
6181 come in asynchronously by notification. */
6183 getpkt (&rs->buf, &rs->buf_size, 0);
6185 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_vCtrlC]))
6189 case PACKET_UNKNOWN:
6190 error (_("No support for interrupting the remote target."));
6192 error (_("Interrupting target failed: %s"), rs->buf);
6196 /* Implement the to_stop function for the remote targets. */
6199 remote_stop (struct target_ops *self, ptid_t ptid)
6202 fprintf_unfiltered (gdb_stdlog, "remote_stop called\n");
6204 if (target_is_non_stop_p ())
6205 remote_stop_ns (ptid);
6208 /* We don't currently have a way to transparently pause the
6209 remote target in all-stop mode. Interrupt it instead. */
6210 remote_interrupt_as ();
6214 /* Implement the to_interrupt function for the remote targets. */
6217 remote_interrupt (struct target_ops *self, ptid_t ptid)
6219 struct remote_state *rs = get_remote_state ();
6222 fprintf_unfiltered (gdb_stdlog, "remote_interrupt called\n");
6224 if (target_is_non_stop_p ())
6225 remote_interrupt_ns ();
6227 remote_interrupt_as ();
6230 /* Implement the to_pass_ctrlc function for the remote targets. */
6233 remote_pass_ctrlc (struct target_ops *self)
6235 struct remote_state *rs = get_remote_state ();
6238 fprintf_unfiltered (gdb_stdlog, "remote_pass_ctrlc called\n");
6240 /* If we're starting up, we're not fully synced yet. Quit
6242 if (rs->starting_up)
6244 /* If ^C has already been sent once, offer to disconnect. */
6245 else if (rs->ctrlc_pending_p)
6248 target_interrupt (inferior_ptid);
6251 /* Ask the user what to do when an interrupt is received. */
6254 interrupt_query (void)
6256 struct remote_state *rs = get_remote_state ();
6258 if (rs->waiting_for_stop_reply && rs->ctrlc_pending_p)
6260 if (query (_("The target is not responding to interrupt requests.\n"
6261 "Stop debugging it? ")))
6263 remote_unpush_target ();
6264 throw_error (TARGET_CLOSE_ERROR, _("Disconnected from target."));
6269 if (query (_("Interrupted while waiting for the program.\n"
6270 "Give up waiting? ")))
6275 /* Enable/disable target terminal ownership. Most targets can use
6276 terminal groups to control terminal ownership. Remote targets are
6277 different in that explicit transfer of ownership to/from GDB/target
6281 remote_terminal_inferior (struct target_ops *self)
6283 /* FIXME: cagney/1999-09-27: Make calls to target_terminal_*()
6284 idempotent. The event-loop GDB talking to an asynchronous target
6285 with a synchronous command calls this function from both
6286 event-top.c and infrun.c/infcmd.c. Once GDB stops trying to
6287 transfer the terminal to the target when it shouldn't this guard
6289 if (!remote_async_terminal_ours_p)
6291 remote_async_terminal_ours_p = 0;
6292 /* NOTE: At this point we could also register our selves as the
6293 recipient of all input. Any characters typed could then be
6294 passed on down to the target. */
6298 remote_terminal_ours (struct target_ops *self)
6300 /* See FIXME in remote_terminal_inferior. */
6301 if (remote_async_terminal_ours_p)
6303 remote_async_terminal_ours_p = 1;
6307 remote_console_output (char *msg)
6311 for (p = msg; p[0] && p[1]; p += 2)
6314 char c = fromhex (p[0]) * 16 + fromhex (p[1]);
6318 fputs_unfiltered (tb, gdb_stdtarg);
6320 gdb_flush (gdb_stdtarg);
6323 DEF_VEC_O(cached_reg_t);
6325 typedef struct stop_reply
6327 struct notif_event base;
6329 /* The identifier of the thread about this event */
6332 /* The remote state this event is associated with. When the remote
6333 connection, represented by a remote_state object, is closed,
6334 all the associated stop_reply events should be released. */
6335 struct remote_state *rs;
6337 struct target_waitstatus ws;
6339 /* Expedited registers. This makes remote debugging a bit more
6340 efficient for those targets that provide critical registers as
6341 part of their normal status mechanism (as another roundtrip to
6342 fetch them is avoided). */
6343 VEC(cached_reg_t) *regcache;
6345 enum target_stop_reason stop_reason;
6347 CORE_ADDR watch_data_address;
6352 DECLARE_QUEUE_P (stop_reply_p);
6353 DEFINE_QUEUE_P (stop_reply_p);
6354 /* The list of already fetched and acknowledged stop events. This
6355 queue is used for notification Stop, and other notifications
6356 don't need queue for their events, because the notification events
6357 of Stop can't be consumed immediately, so that events should be
6358 queued first, and be consumed by remote_wait_{ns,as} one per
6359 time. Other notifications can consume their events immediately,
6360 so queue is not needed for them. */
6361 static QUEUE (stop_reply_p) *stop_reply_queue;
6364 stop_reply_xfree (struct stop_reply *r)
6366 notif_event_xfree ((struct notif_event *) r);
6369 /* Return the length of the stop reply queue. */
6372 stop_reply_queue_length (void)
6374 return QUEUE_length (stop_reply_p, stop_reply_queue);
6378 remote_notif_stop_parse (struct notif_client *self, char *buf,
6379 struct notif_event *event)
6381 remote_parse_stop_reply (buf, (struct stop_reply *) event);
6385 remote_notif_stop_ack (struct notif_client *self, char *buf,
6386 struct notif_event *event)
6388 struct stop_reply *stop_reply = (struct stop_reply *) event;
6391 putpkt (self->ack_command);
6393 if (stop_reply->ws.kind == TARGET_WAITKIND_IGNORE)
6394 /* We got an unknown stop reply. */
6395 error (_("Unknown stop reply"));
6397 push_stop_reply (stop_reply);
6401 remote_notif_stop_can_get_pending_events (struct notif_client *self)
6403 /* We can't get pending events in remote_notif_process for
6404 notification stop, and we have to do this in remote_wait_ns
6405 instead. If we fetch all queued events from stub, remote stub
6406 may exit and we have no chance to process them back in
6408 mark_async_event_handler (remote_async_inferior_event_token);
6413 stop_reply_dtr (struct notif_event *event)
6415 struct stop_reply *r = (struct stop_reply *) event;
6420 VEC_iterate (cached_reg_t, r->regcache, ix, reg);
6424 VEC_free (cached_reg_t, r->regcache);
6427 static struct notif_event *
6428 remote_notif_stop_alloc_reply (void)
6430 /* We cast to a pointer to the "base class". */
6431 struct notif_event *r = (struct notif_event *) XNEW (struct stop_reply);
6433 r->dtr = stop_reply_dtr;
6438 /* A client of notification Stop. */
6440 struct notif_client notif_client_stop =
6444 remote_notif_stop_parse,
6445 remote_notif_stop_ack,
6446 remote_notif_stop_can_get_pending_events,
6447 remote_notif_stop_alloc_reply,
6451 /* A parameter to pass data in and out. */
6453 struct queue_iter_param
6456 struct stop_reply *output;
6459 /* Determine if THREAD_PTID is a pending fork parent thread. ARG contains
6460 the pid of the process that owns the threads we want to check, or
6461 -1 if we want to check all threads. */
6464 is_pending_fork_parent (struct target_waitstatus *ws, int event_pid,
6467 if (ws->kind == TARGET_WAITKIND_FORKED
6468 || ws->kind == TARGET_WAITKIND_VFORKED)
6470 if (event_pid == -1 || event_pid == ptid_get_pid (thread_ptid))
6477 /* Return the thread's pending status used to determine whether the
6478 thread is a fork parent stopped at a fork event. */
6480 static struct target_waitstatus *
6481 thread_pending_fork_status (struct thread_info *thread)
6483 if (thread->suspend.waitstatus_pending_p)
6484 return &thread->suspend.waitstatus;
6486 return &thread->pending_follow;
6489 /* Determine if THREAD is a pending fork parent thread. */
6492 is_pending_fork_parent_thread (struct thread_info *thread)
6494 struct target_waitstatus *ws = thread_pending_fork_status (thread);
6497 return is_pending_fork_parent (ws, pid, thread->ptid);
6500 /* Check whether EVENT is a fork event, and if it is, remove the
6501 fork child from the context list passed in DATA. */
6504 remove_child_of_pending_fork (QUEUE (stop_reply_p) *q,
6505 QUEUE_ITER (stop_reply_p) *iter,
6509 struct queue_iter_param *param = (struct queue_iter_param *) data;
6510 struct threads_listing_context *context
6511 = (struct threads_listing_context *) param->input;
6513 if (event->ws.kind == TARGET_WAITKIND_FORKED
6514 || event->ws.kind == TARGET_WAITKIND_VFORKED
6515 || event->ws.kind == TARGET_WAITKIND_THREAD_EXITED)
6516 threads_listing_context_remove (&event->ws, context);
6521 /* If CONTEXT contains any fork child threads that have not been
6522 reported yet, remove them from the CONTEXT list. If such a
6523 thread exists it is because we are stopped at a fork catchpoint
6524 and have not yet called follow_fork, which will set up the
6525 host-side data structures for the new process. */
6528 remove_new_fork_children (struct threads_listing_context *context)
6530 struct thread_info * thread;
6532 struct notif_client *notif = ¬if_client_stop;
6533 struct queue_iter_param param;
6535 /* For any threads stopped at a fork event, remove the corresponding
6536 fork child threads from the CONTEXT list. */
6537 ALL_NON_EXITED_THREADS (thread)
6539 struct target_waitstatus *ws = thread_pending_fork_status (thread);
6541 if (is_pending_fork_parent (ws, pid, thread->ptid))
6543 threads_listing_context_remove (ws, context);
6547 /* Check for any pending fork events (not reported or processed yet)
6548 in process PID and remove those fork child threads from the
6549 CONTEXT list as well. */
6550 remote_notif_get_pending_events (notif);
6551 param.input = context;
6552 param.output = NULL;
6553 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6554 remove_child_of_pending_fork, ¶m);
6557 /* Check whether EVENT would prevent a global or process wildcard
6561 check_pending_event_prevents_wildcard_vcont_callback
6562 (QUEUE (stop_reply_p) *q,
6563 QUEUE_ITER (stop_reply_p) *iter,
6567 struct inferior *inf;
6568 int *may_global_wildcard_vcont = (int *) data;
6570 if (event->ws.kind == TARGET_WAITKIND_NO_RESUMED
6571 || event->ws.kind == TARGET_WAITKIND_NO_HISTORY)
6574 if (event->ws.kind == TARGET_WAITKIND_FORKED
6575 || event->ws.kind == TARGET_WAITKIND_VFORKED)
6576 *may_global_wildcard_vcont = 0;
6578 inf = find_inferior_ptid (event->ptid);
6580 /* This may be the first time we heard about this process.
6581 Regardless, we must not do a global wildcard resume, otherwise
6582 we'd resume this process too. */
6583 *may_global_wildcard_vcont = 0;
6585 inf->priv->may_wildcard_vcont = 0;
6590 /* Check whether any event pending in the vStopped queue would prevent
6591 a global or process wildcard vCont action. Clear
6592 *may_global_wildcard if we can't do a global wildcard (vCont;c),
6593 and clear the event inferior's may_wildcard_vcont flag if we can't
6594 do a process-wide wildcard resume (vCont;c:pPID.-1). */
6597 check_pending_events_prevent_wildcard_vcont (int *may_global_wildcard)
6599 struct notif_client *notif = ¬if_client_stop;
6601 remote_notif_get_pending_events (notif);
6602 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6603 check_pending_event_prevents_wildcard_vcont_callback,
6604 may_global_wildcard);
6607 /* Remove stop replies in the queue if its pid is equal to the given
6611 remove_stop_reply_for_inferior (QUEUE (stop_reply_p) *q,
6612 QUEUE_ITER (stop_reply_p) *iter,
6616 struct queue_iter_param *param = (struct queue_iter_param *) data;
6617 struct inferior *inf = (struct inferior *) param->input;
6619 if (ptid_get_pid (event->ptid) == inf->pid)
6621 stop_reply_xfree (event);
6622 QUEUE_remove_elem (stop_reply_p, q, iter);
6628 /* Discard all pending stop replies of inferior INF. */
6631 discard_pending_stop_replies (struct inferior *inf)
6633 struct queue_iter_param param;
6634 struct stop_reply *reply;
6635 struct remote_state *rs = get_remote_state ();
6636 struct remote_notif_state *rns = rs->notif_state;
6638 /* This function can be notified when an inferior exists. When the
6639 target is not remote, the notification state is NULL. */
6640 if (rs->remote_desc == NULL)
6643 reply = (struct stop_reply *) rns->pending_event[notif_client_stop.id];
6645 /* Discard the in-flight notification. */
6646 if (reply != NULL && ptid_get_pid (reply->ptid) == inf->pid)
6648 stop_reply_xfree (reply);
6649 rns->pending_event[notif_client_stop.id] = NULL;
6653 param.output = NULL;
6654 /* Discard the stop replies we have already pulled with
6656 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6657 remove_stop_reply_for_inferior, ¶m);
6660 /* If its remote state is equal to the given remote state,
6661 remove EVENT from the stop reply queue. */
6664 remove_stop_reply_of_remote_state (QUEUE (stop_reply_p) *q,
6665 QUEUE_ITER (stop_reply_p) *iter,
6669 struct queue_iter_param *param = (struct queue_iter_param *) data;
6670 struct remote_state *rs = (struct remote_state *) param->input;
6672 if (event->rs == rs)
6674 stop_reply_xfree (event);
6675 QUEUE_remove_elem (stop_reply_p, q, iter);
6681 /* Discard the stop replies for RS in stop_reply_queue. */
6684 discard_pending_stop_replies_in_queue (struct remote_state *rs)
6686 struct queue_iter_param param;
6689 param.output = NULL;
6690 /* Discard the stop replies we have already pulled with
6692 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6693 remove_stop_reply_of_remote_state, ¶m);
6696 /* A parameter to pass data in and out. */
6699 remote_notif_remove_once_on_match (QUEUE (stop_reply_p) *q,
6700 QUEUE_ITER (stop_reply_p) *iter,
6704 struct queue_iter_param *param = (struct queue_iter_param *) data;
6705 ptid_t *ptid = (ptid_t *) param->input;
6707 if (ptid_match (event->ptid, *ptid))
6709 param->output = event;
6710 QUEUE_remove_elem (stop_reply_p, q, iter);
6717 /* Remove the first reply in 'stop_reply_queue' which matches
6720 static struct stop_reply *
6721 remote_notif_remove_queued_reply (ptid_t ptid)
6723 struct queue_iter_param param;
6725 param.input = &ptid;
6726 param.output = NULL;
6728 QUEUE_iterate (stop_reply_p, stop_reply_queue,
6729 remote_notif_remove_once_on_match, ¶m);
6731 fprintf_unfiltered (gdb_stdlog,
6732 "notif: discard queued event: 'Stop' in %s\n",
6733 target_pid_to_str (ptid));
6735 return param.output;
6738 /* Look for a queued stop reply belonging to PTID. If one is found,
6739 remove it from the queue, and return it. Returns NULL if none is
6740 found. If there are still queued events left to process, tell the
6741 event loop to get back to target_wait soon. */
6743 static struct stop_reply *
6744 queued_stop_reply (ptid_t ptid)
6746 struct stop_reply *r = remote_notif_remove_queued_reply (ptid);
6748 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
6749 /* There's still at least an event left. */
6750 mark_async_event_handler (remote_async_inferior_event_token);
6755 /* Push a fully parsed stop reply in the stop reply queue. Since we
6756 know that we now have at least one queued event left to pass to the
6757 core side, tell the event loop to get back to target_wait soon. */
6760 push_stop_reply (struct stop_reply *new_event)
6762 QUEUE_enque (stop_reply_p, stop_reply_queue, new_event);
6765 fprintf_unfiltered (gdb_stdlog,
6766 "notif: push 'Stop' %s to queue %d\n",
6767 target_pid_to_str (new_event->ptid),
6768 QUEUE_length (stop_reply_p,
6771 mark_async_event_handler (remote_async_inferior_event_token);
6775 stop_reply_match_ptid_and_ws (QUEUE (stop_reply_p) *q,
6776 QUEUE_ITER (stop_reply_p) *iter,
6777 struct stop_reply *event,
6780 ptid_t *ptid = (ptid_t *) data;
6782 return !(ptid_equal (*ptid, event->ptid)
6783 && event->ws.kind == TARGET_WAITKIND_STOPPED);
6786 /* Returns true if we have a stop reply for PTID. */
6789 peek_stop_reply (ptid_t ptid)
6791 return !QUEUE_iterate (stop_reply_p, stop_reply_queue,
6792 stop_reply_match_ptid_and_ws, &ptid);
6795 /* Helper for remote_parse_stop_reply. Return nonzero if the substring
6796 starting with P and ending with PEND matches PREFIX. */
6799 strprefix (const char *p, const char *pend, const char *prefix)
6801 for ( ; p < pend; p++, prefix++)
6804 return *prefix == '\0';
6807 /* Parse the stop reply in BUF. Either the function succeeds, and the
6808 result is stored in EVENT, or throws an error. */
6811 remote_parse_stop_reply (char *buf, struct stop_reply *event)
6813 struct remote_arch_state *rsa = get_remote_arch_state ();
6818 event->ptid = null_ptid;
6819 event->rs = get_remote_state ();
6820 event->ws.kind = TARGET_WAITKIND_IGNORE;
6821 event->ws.value.integer = 0;
6822 event->stop_reason = TARGET_STOPPED_BY_NO_REASON;
6823 event->regcache = NULL;
6828 case 'T': /* Status with PC, SP, FP, ... */
6829 /* Expedited reply, containing Signal, {regno, reg} repeat. */
6830 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
6832 n... = register number
6833 r... = register contents
6836 p = &buf[3]; /* after Txx */
6842 p1 = strchr (p, ':');
6844 error (_("Malformed packet(a) (missing colon): %s\n\
6848 error (_("Malformed packet(a) (missing register number): %s\n\
6852 /* Some "registers" are actually extended stop information.
6853 Note if you're adding a new entry here: GDB 7.9 and
6854 earlier assume that all register "numbers" that start
6855 with an hex digit are real register numbers. Make sure
6856 the server only sends such a packet if it knows the
6857 client understands it. */
6859 if (strprefix (p, p1, "thread"))
6860 event->ptid = read_ptid (++p1, &p);
6861 else if (strprefix (p, p1, "syscall_entry"))
6865 event->ws.kind = TARGET_WAITKIND_SYSCALL_ENTRY;
6866 p = unpack_varlen_hex (++p1, &sysno);
6867 event->ws.value.syscall_number = (int) sysno;
6869 else if (strprefix (p, p1, "syscall_return"))
6873 event->ws.kind = TARGET_WAITKIND_SYSCALL_RETURN;
6874 p = unpack_varlen_hex (++p1, &sysno);
6875 event->ws.value.syscall_number = (int) sysno;
6877 else if (strprefix (p, p1, "watch")
6878 || strprefix (p, p1, "rwatch")
6879 || strprefix (p, p1, "awatch"))
6881 event->stop_reason = TARGET_STOPPED_BY_WATCHPOINT;
6882 p = unpack_varlen_hex (++p1, &addr);
6883 event->watch_data_address = (CORE_ADDR) addr;
6885 else if (strprefix (p, p1, "swbreak"))
6887 event->stop_reason = TARGET_STOPPED_BY_SW_BREAKPOINT;
6889 /* Make sure the stub doesn't forget to indicate support
6891 if (packet_support (PACKET_swbreak_feature) != PACKET_ENABLE)
6892 error (_("Unexpected swbreak stop reason"));
6894 /* The value part is documented as "must be empty",
6895 though we ignore it, in case we ever decide to make
6896 use of it in a backward compatible way. */
6897 p = strchrnul (p1 + 1, ';');
6899 else if (strprefix (p, p1, "hwbreak"))
6901 event->stop_reason = TARGET_STOPPED_BY_HW_BREAKPOINT;
6903 /* Make sure the stub doesn't forget to indicate support
6905 if (packet_support (PACKET_hwbreak_feature) != PACKET_ENABLE)
6906 error (_("Unexpected hwbreak stop reason"));
6909 p = strchrnul (p1 + 1, ';');
6911 else if (strprefix (p, p1, "library"))
6913 event->ws.kind = TARGET_WAITKIND_LOADED;
6914 p = strchrnul (p1 + 1, ';');
6916 else if (strprefix (p, p1, "replaylog"))
6918 event->ws.kind = TARGET_WAITKIND_NO_HISTORY;
6919 /* p1 will indicate "begin" or "end", but it makes
6920 no difference for now, so ignore it. */
6921 p = strchrnul (p1 + 1, ';');
6923 else if (strprefix (p, p1, "core"))
6927 p = unpack_varlen_hex (++p1, &c);
6930 else if (strprefix (p, p1, "fork"))
6932 event->ws.value.related_pid = read_ptid (++p1, &p);
6933 event->ws.kind = TARGET_WAITKIND_FORKED;
6935 else if (strprefix (p, p1, "vfork"))
6937 event->ws.value.related_pid = read_ptid (++p1, &p);
6938 event->ws.kind = TARGET_WAITKIND_VFORKED;
6940 else if (strprefix (p, p1, "vforkdone"))
6942 event->ws.kind = TARGET_WAITKIND_VFORK_DONE;
6943 p = strchrnul (p1 + 1, ';');
6945 else if (strprefix (p, p1, "exec"))
6948 char pathname[PATH_MAX];
6951 /* Determine the length of the execd pathname. */
6952 p = unpack_varlen_hex (++p1, &ignored);
6953 pathlen = (p - p1) / 2;
6955 /* Save the pathname for event reporting and for
6956 the next run command. */
6957 hex2bin (p1, (gdb_byte *) pathname, pathlen);
6958 pathname[pathlen] = '\0';
6960 /* This is freed during event handling. */
6961 event->ws.value.execd_pathname = xstrdup (pathname);
6962 event->ws.kind = TARGET_WAITKIND_EXECD;
6964 /* Skip the registers included in this packet, since
6965 they may be for an architecture different from the
6966 one used by the original program. */
6969 else if (strprefix (p, p1, "create"))
6971 event->ws.kind = TARGET_WAITKIND_THREAD_CREATED;
6972 p = strchrnul (p1 + 1, ';');
6981 p = strchrnul (p1 + 1, ';');
6986 /* Maybe a real ``P'' register number. */
6987 p_temp = unpack_varlen_hex (p, &pnum);
6988 /* If the first invalid character is the colon, we got a
6989 register number. Otherwise, it's an unknown stop
6993 struct packet_reg *reg = packet_reg_from_pnum (rsa, pnum);
6994 cached_reg_t cached_reg;
6995 struct gdbarch *gdbarch = target_gdbarch ();
6998 error (_("Remote sent bad register number %s: %s\n\
7000 hex_string (pnum), p, buf);
7002 cached_reg.num = reg->regnum;
7003 cached_reg.data = (gdb_byte *)
7004 xmalloc (register_size (gdbarch, reg->regnum));
7007 fieldsize = hex2bin (p, cached_reg.data,
7008 register_size (gdbarch, reg->regnum));
7010 if (fieldsize < register_size (gdbarch, reg->regnum))
7011 warning (_("Remote reply is too short: %s"), buf);
7013 VEC_safe_push (cached_reg_t, event->regcache, &cached_reg);
7017 /* Not a number. Silently skip unknown optional
7019 p = strchrnul (p1 + 1, ';');
7024 error (_("Remote register badly formatted: %s\nhere: %s"),
7029 if (event->ws.kind != TARGET_WAITKIND_IGNORE)
7033 case 'S': /* Old style status, just signal only. */
7037 event->ws.kind = TARGET_WAITKIND_STOPPED;
7038 sig = (fromhex (buf[1]) << 4) + fromhex (buf[2]);
7039 if (GDB_SIGNAL_FIRST <= sig && sig < GDB_SIGNAL_LAST)
7040 event->ws.value.sig = (enum gdb_signal) sig;
7042 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
7045 case 'w': /* Thread exited. */
7050 event->ws.kind = TARGET_WAITKIND_THREAD_EXITED;
7051 p = unpack_varlen_hex (&buf[1], &value);
7052 event->ws.value.integer = value;
7054 error (_("stop reply packet badly formatted: %s"), buf);
7055 event->ptid = read_ptid (++p, NULL);
7058 case 'W': /* Target exited. */
7065 /* GDB used to accept only 2 hex chars here. Stubs should
7066 only send more if they detect GDB supports multi-process
7068 p = unpack_varlen_hex (&buf[1], &value);
7072 /* The remote process exited. */
7073 event->ws.kind = TARGET_WAITKIND_EXITED;
7074 event->ws.value.integer = value;
7078 /* The remote process exited with a signal. */
7079 event->ws.kind = TARGET_WAITKIND_SIGNALLED;
7080 if (GDB_SIGNAL_FIRST <= value && value < GDB_SIGNAL_LAST)
7081 event->ws.value.sig = (enum gdb_signal) value;
7083 event->ws.value.sig = GDB_SIGNAL_UNKNOWN;
7086 /* If no process is specified, assume inferior_ptid. */
7087 pid = ptid_get_pid (inferior_ptid);
7096 else if (startswith (p, "process:"))
7100 p += sizeof ("process:") - 1;
7101 unpack_varlen_hex (p, &upid);
7105 error (_("unknown stop reply packet: %s"), buf);
7108 error (_("unknown stop reply packet: %s"), buf);
7109 event->ptid = pid_to_ptid (pid);
7113 event->ws.kind = TARGET_WAITKIND_NO_RESUMED;
7114 event->ptid = minus_one_ptid;
7118 if (target_is_non_stop_p () && ptid_equal (event->ptid, null_ptid))
7119 error (_("No process or thread specified in stop reply: %s"), buf);
7122 /* When the stub wants to tell GDB about a new notification reply, it
7123 sends a notification (%Stop, for example). Those can come it at
7124 any time, hence, we have to make sure that any pending
7125 putpkt/getpkt sequence we're making is finished, before querying
7126 the stub for more events with the corresponding ack command
7127 (vStopped, for example). E.g., if we started a vStopped sequence
7128 immediately upon receiving the notification, something like this
7136 1.6) <-- (registers reply to step #1.3)
7138 Obviously, the reply in step #1.6 would be unexpected to a vStopped
7141 To solve this, whenever we parse a %Stop notification successfully,
7142 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
7143 doing whatever we were doing:
7149 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
7150 2.5) <-- (registers reply to step #2.3)
7152 Eventualy after step #2.5, we return to the event loop, which
7153 notices there's an event on the
7154 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
7155 associated callback --- the function below. At this point, we're
7156 always safe to start a vStopped sequence. :
7159 2.7) <-- T05 thread:2
7165 remote_notif_get_pending_events (struct notif_client *nc)
7167 struct remote_state *rs = get_remote_state ();
7169 if (rs->notif_state->pending_event[nc->id] != NULL)
7172 fprintf_unfiltered (gdb_stdlog,
7173 "notif: process: '%s' ack pending event\n",
7177 nc->ack (nc, rs->buf, rs->notif_state->pending_event[nc->id]);
7178 rs->notif_state->pending_event[nc->id] = NULL;
7182 getpkt (&rs->buf, &rs->buf_size, 0);
7183 if (strcmp (rs->buf, "OK") == 0)
7186 remote_notif_ack (nc, rs->buf);
7192 fprintf_unfiltered (gdb_stdlog,
7193 "notif: process: '%s' no pending reply\n",
7198 /* Called when it is decided that STOP_REPLY holds the info of the
7199 event that is to be returned to the core. This function always
7200 destroys STOP_REPLY. */
7203 process_stop_reply (struct stop_reply *stop_reply,
7204 struct target_waitstatus *status)
7208 *status = stop_reply->ws;
7209 ptid = stop_reply->ptid;
7211 /* If no thread/process was reported by the stub, assume the current
7213 if (ptid_equal (ptid, null_ptid))
7214 ptid = inferior_ptid;
7216 if (status->kind != TARGET_WAITKIND_EXITED
7217 && status->kind != TARGET_WAITKIND_SIGNALLED
7218 && status->kind != TARGET_WAITKIND_NO_RESUMED)
7220 struct private_thread_info *remote_thr;
7222 /* Expedited registers. */
7223 if (stop_reply->regcache)
7225 struct regcache *regcache
7226 = get_thread_arch_regcache (ptid, target_gdbarch ());
7231 VEC_iterate (cached_reg_t, stop_reply->regcache, ix, reg);
7234 regcache_raw_supply (regcache, reg->num, reg->data);
7238 VEC_free (cached_reg_t, stop_reply->regcache);
7241 remote_notice_new_inferior (ptid, 0);
7242 remote_thr = get_private_info_ptid (ptid);
7243 remote_thr->core = stop_reply->core;
7244 remote_thr->stop_reason = stop_reply->stop_reason;
7245 remote_thr->watch_data_address = stop_reply->watch_data_address;
7246 remote_thr->vcont_resumed = 0;
7249 stop_reply_xfree (stop_reply);
7253 /* The non-stop mode version of target_wait. */
7256 remote_wait_ns (ptid_t ptid, struct target_waitstatus *status, int options)
7258 struct remote_state *rs = get_remote_state ();
7259 struct stop_reply *stop_reply;
7263 /* If in non-stop mode, get out of getpkt even if a
7264 notification is received. */
7266 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
7267 0 /* forever */, &is_notif);
7270 if (ret != -1 && !is_notif)
7273 case 'E': /* Error of some sort. */
7274 /* We're out of sync with the target now. Did it continue
7275 or not? We can't tell which thread it was in non-stop,
7276 so just ignore this. */
7277 warning (_("Remote failure reply: %s"), rs->buf);
7279 case 'O': /* Console output. */
7280 remote_console_output (rs->buf + 1);
7283 warning (_("Invalid remote reply: %s"), rs->buf);
7287 /* Acknowledge a pending stop reply that may have arrived in the
7289 if (rs->notif_state->pending_event[notif_client_stop.id] != NULL)
7290 remote_notif_get_pending_events (¬if_client_stop);
7292 /* If indeed we noticed a stop reply, we're done. */
7293 stop_reply = queued_stop_reply (ptid);
7294 if (stop_reply != NULL)
7295 return process_stop_reply (stop_reply, status);
7297 /* Still no event. If we're just polling for an event, then
7298 return to the event loop. */
7299 if (options & TARGET_WNOHANG)
7301 status->kind = TARGET_WAITKIND_IGNORE;
7302 return minus_one_ptid;
7305 /* Otherwise do a blocking wait. */
7306 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
7307 1 /* forever */, &is_notif);
7311 /* Wait until the remote machine stops, then return, storing status in
7312 STATUS just as `wait' would. */
7315 remote_wait_as (ptid_t ptid, struct target_waitstatus *status, int options)
7317 struct remote_state *rs = get_remote_state ();
7318 ptid_t event_ptid = null_ptid;
7320 struct stop_reply *stop_reply;
7324 status->kind = TARGET_WAITKIND_IGNORE;
7325 status->value.integer = 0;
7327 stop_reply = queued_stop_reply (ptid);
7328 if (stop_reply != NULL)
7329 return process_stop_reply (stop_reply, status);
7331 if (rs->cached_wait_status)
7332 /* Use the cached wait status, but only once. */
7333 rs->cached_wait_status = 0;
7338 int forever = ((options & TARGET_WNOHANG) == 0
7339 && wait_forever_enabled_p);
7341 if (!rs->waiting_for_stop_reply)
7343 status->kind = TARGET_WAITKIND_NO_RESUMED;
7344 return minus_one_ptid;
7347 /* FIXME: cagney/1999-09-27: If we're in async mode we should
7348 _never_ wait for ever -> test on target_is_async_p().
7349 However, before we do that we need to ensure that the caller
7350 knows how to take the target into/out of async mode. */
7351 ret = getpkt_or_notif_sane (&rs->buf, &rs->buf_size,
7352 forever, &is_notif);
7354 /* GDB gets a notification. Return to core as this event is
7356 if (ret != -1 && is_notif)
7357 return minus_one_ptid;
7359 if (ret == -1 && (options & TARGET_WNOHANG) != 0)
7360 return minus_one_ptid;
7365 /* Assume that the target has acknowledged Ctrl-C unless we receive
7366 an 'F' or 'O' packet. */
7367 if (buf[0] != 'F' && buf[0] != 'O')
7368 rs->ctrlc_pending_p = 0;
7372 case 'E': /* Error of some sort. */
7373 /* We're out of sync with the target now. Did it continue or
7374 not? Not is more likely, so report a stop. */
7375 rs->waiting_for_stop_reply = 0;
7377 warning (_("Remote failure reply: %s"), buf);
7378 status->kind = TARGET_WAITKIND_STOPPED;
7379 status->value.sig = GDB_SIGNAL_0;
7381 case 'F': /* File-I/O request. */
7382 /* GDB may access the inferior memory while handling the File-I/O
7383 request, but we don't want GDB accessing memory while waiting
7384 for a stop reply. See the comments in putpkt_binary. Set
7385 waiting_for_stop_reply to 0 temporarily. */
7386 rs->waiting_for_stop_reply = 0;
7387 remote_fileio_request (buf, rs->ctrlc_pending_p);
7388 rs->ctrlc_pending_p = 0;
7389 /* GDB handled the File-I/O request, and the target is running
7390 again. Keep waiting for events. */
7391 rs->waiting_for_stop_reply = 1;
7393 case 'N': case 'T': case 'S': case 'X': case 'W':
7395 struct stop_reply *stop_reply;
7397 /* There is a stop reply to handle. */
7398 rs->waiting_for_stop_reply = 0;
7401 = (struct stop_reply *) remote_notif_parse (¬if_client_stop,
7404 event_ptid = process_stop_reply (stop_reply, status);
7407 case 'O': /* Console output. */
7408 remote_console_output (buf + 1);
7411 if (rs->last_sent_signal != GDB_SIGNAL_0)
7413 /* Zero length reply means that we tried 'S' or 'C' and the
7414 remote system doesn't support it. */
7415 target_terminal_ours_for_output ();
7417 ("Can't send signals to this remote system. %s not sent.\n",
7418 gdb_signal_to_name (rs->last_sent_signal));
7419 rs->last_sent_signal = GDB_SIGNAL_0;
7420 target_terminal_inferior ();
7422 strcpy (buf, rs->last_sent_step ? "s" : "c");
7426 /* else fallthrough */
7428 warning (_("Invalid remote reply: %s"), buf);
7432 if (status->kind == TARGET_WAITKIND_NO_RESUMED)
7433 return minus_one_ptid;
7434 else if (status->kind == TARGET_WAITKIND_IGNORE)
7436 /* Nothing interesting happened. If we're doing a non-blocking
7437 poll, we're done. Otherwise, go back to waiting. */
7438 if (options & TARGET_WNOHANG)
7439 return minus_one_ptid;
7443 else if (status->kind != TARGET_WAITKIND_EXITED
7444 && status->kind != TARGET_WAITKIND_SIGNALLED)
7446 if (!ptid_equal (event_ptid, null_ptid))
7447 record_currthread (rs, event_ptid);
7449 event_ptid = inferior_ptid;
7452 /* A process exit. Invalidate our notion of current thread. */
7453 record_currthread (rs, minus_one_ptid);
7458 /* Wait until the remote machine stops, then return, storing status in
7459 STATUS just as `wait' would. */
7462 remote_wait (struct target_ops *ops,
7463 ptid_t ptid, struct target_waitstatus *status, int options)
7467 if (target_is_non_stop_p ())
7468 event_ptid = remote_wait_ns (ptid, status, options);
7470 event_ptid = remote_wait_as (ptid, status, options);
7472 if (target_is_async_p ())
7474 /* If there are are events left in the queue tell the event loop
7476 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
7477 mark_async_event_handler (remote_async_inferior_event_token);
7483 /* Fetch a single register using a 'p' packet. */
7486 fetch_register_using_p (struct regcache *regcache, struct packet_reg *reg)
7488 struct gdbarch *gdbarch = get_regcache_arch (regcache);
7489 struct remote_state *rs = get_remote_state ();
7491 gdb_byte *regp = (gdb_byte *) alloca (register_size (gdbarch, reg->regnum));
7494 if (packet_support (PACKET_p) == PACKET_DISABLE)
7497 if (reg->pnum == -1)
7502 p += hexnumstr (p, reg->pnum);
7505 getpkt (&rs->buf, &rs->buf_size, 0);
7509 switch (packet_ok (buf, &remote_protocol_packets[PACKET_p]))
7513 case PACKET_UNKNOWN:
7516 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
7517 gdbarch_register_name (get_regcache_arch (regcache),
7522 /* If this register is unfetchable, tell the regcache. */
7525 regcache_raw_supply (regcache, reg->regnum, NULL);
7529 /* Otherwise, parse and supply the value. */
7535 error (_("fetch_register_using_p: early buf termination"));
7537 regp[i++] = fromhex (p[0]) * 16 + fromhex (p[1]);
7540 regcache_raw_supply (regcache, reg->regnum, regp);
7544 /* Fetch the registers included in the target's 'g' packet. */
7547 send_g_packet (void)
7549 struct remote_state *rs = get_remote_state ();
7552 xsnprintf (rs->buf, get_remote_packet_size (), "g");
7553 remote_send (&rs->buf, &rs->buf_size);
7555 /* We can get out of synch in various cases. If the first character
7556 in the buffer is not a hex character, assume that has happened
7557 and try to fetch another packet to read. */
7558 while ((rs->buf[0] < '0' || rs->buf[0] > '9')
7559 && (rs->buf[0] < 'A' || rs->buf[0] > 'F')
7560 && (rs->buf[0] < 'a' || rs->buf[0] > 'f')
7561 && rs->buf[0] != 'x') /* New: unavailable register value. */
7564 fprintf_unfiltered (gdb_stdlog,
7565 "Bad register packet; fetching a new packet\n");
7566 getpkt (&rs->buf, &rs->buf_size, 0);
7569 buf_len = strlen (rs->buf);
7571 /* Sanity check the received packet. */
7572 if (buf_len % 2 != 0)
7573 error (_("Remote 'g' packet reply is of odd length: %s"), rs->buf);
7579 process_g_packet (struct regcache *regcache)
7581 struct gdbarch *gdbarch = get_regcache_arch (regcache);
7582 struct remote_state *rs = get_remote_state ();
7583 struct remote_arch_state *rsa = get_remote_arch_state ();
7588 buf_len = strlen (rs->buf);
7590 /* Further sanity checks, with knowledge of the architecture. */
7591 if (buf_len > 2 * rsa->sizeof_g_packet)
7592 error (_("Remote 'g' packet reply is too long (expected %ld bytes, got %d "
7593 "bytes): %s"), rsa->sizeof_g_packet, buf_len / 2, rs->buf);
7595 /* Save the size of the packet sent to us by the target. It is used
7596 as a heuristic when determining the max size of packets that the
7597 target can safely receive. */
7598 if (rsa->actual_register_packet_size == 0)
7599 rsa->actual_register_packet_size = buf_len;
7601 /* If this is smaller than we guessed the 'g' packet would be,
7602 update our records. A 'g' reply that doesn't include a register's
7603 value implies either that the register is not available, or that
7604 the 'p' packet must be used. */
7605 if (buf_len < 2 * rsa->sizeof_g_packet)
7607 long sizeof_g_packet = buf_len / 2;
7609 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
7611 long offset = rsa->regs[i].offset;
7612 long reg_size = register_size (gdbarch, i);
7614 if (rsa->regs[i].pnum == -1)
7617 if (offset >= sizeof_g_packet)
7618 rsa->regs[i].in_g_packet = 0;
7619 else if (offset + reg_size > sizeof_g_packet)
7620 error (_("Truncated register %d in remote 'g' packet"), i);
7622 rsa->regs[i].in_g_packet = 1;
7625 /* Looks valid enough, we can assume this is the correct length
7626 for a 'g' packet. It's important not to adjust
7627 rsa->sizeof_g_packet if we have truncated registers otherwise
7628 this "if" won't be run the next time the method is called
7629 with a packet of the same size and one of the internal errors
7630 below will trigger instead. */
7631 rsa->sizeof_g_packet = sizeof_g_packet;
7634 regs = (char *) alloca (rsa->sizeof_g_packet);
7636 /* Unimplemented registers read as all bits zero. */
7637 memset (regs, 0, rsa->sizeof_g_packet);
7639 /* Reply describes registers byte by byte, each byte encoded as two
7640 hex characters. Suck them all up, then supply them to the
7641 register cacheing/storage mechanism. */
7644 for (i = 0; i < rsa->sizeof_g_packet; i++)
7646 if (p[0] == 0 || p[1] == 0)
7647 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
7648 internal_error (__FILE__, __LINE__,
7649 _("unexpected end of 'g' packet reply"));
7651 if (p[0] == 'x' && p[1] == 'x')
7652 regs[i] = 0; /* 'x' */
7654 regs[i] = fromhex (p[0]) * 16 + fromhex (p[1]);
7658 for (i = 0; i < gdbarch_num_regs (gdbarch); i++)
7660 struct packet_reg *r = &rsa->regs[i];
7661 long reg_size = register_size (gdbarch, i);
7665 if ((r->offset + reg_size) * 2 > strlen (rs->buf))
7666 /* This shouldn't happen - we adjusted in_g_packet above. */
7667 internal_error (__FILE__, __LINE__,
7668 _("unexpected end of 'g' packet reply"));
7669 else if (rs->buf[r->offset * 2] == 'x')
7671 gdb_assert (r->offset * 2 < strlen (rs->buf));
7672 /* The register isn't available, mark it as such (at
7673 the same time setting the value to zero). */
7674 regcache_raw_supply (regcache, r->regnum, NULL);
7677 regcache_raw_supply (regcache, r->regnum,
7684 fetch_registers_using_g (struct regcache *regcache)
7687 process_g_packet (regcache);
7690 /* Make the remote selected traceframe match GDB's selected
7694 set_remote_traceframe (void)
7697 struct remote_state *rs = get_remote_state ();
7699 if (rs->remote_traceframe_number == get_traceframe_number ())
7702 /* Avoid recursion, remote_trace_find calls us again. */
7703 rs->remote_traceframe_number = get_traceframe_number ();
7705 newnum = target_trace_find (tfind_number,
7706 get_traceframe_number (), 0, 0, NULL);
7708 /* Should not happen. If it does, all bets are off. */
7709 if (newnum != get_traceframe_number ())
7710 warning (_("could not set remote traceframe"));
7714 remote_fetch_registers (struct target_ops *ops,
7715 struct regcache *regcache, int regnum)
7717 struct remote_arch_state *rsa = get_remote_arch_state ();
7720 set_remote_traceframe ();
7721 set_general_thread (regcache_get_ptid (regcache));
7725 struct packet_reg *reg = packet_reg_from_regnum (rsa, regnum);
7727 gdb_assert (reg != NULL);
7729 /* If this register might be in the 'g' packet, try that first -
7730 we are likely to read more than one register. If this is the
7731 first 'g' packet, we might be overly optimistic about its
7732 contents, so fall back to 'p'. */
7733 if (reg->in_g_packet)
7735 fetch_registers_using_g (regcache);
7736 if (reg->in_g_packet)
7740 if (fetch_register_using_p (regcache, reg))
7743 /* This register is not available. */
7744 regcache_raw_supply (regcache, reg->regnum, NULL);
7749 fetch_registers_using_g (regcache);
7751 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
7752 if (!rsa->regs[i].in_g_packet)
7753 if (!fetch_register_using_p (regcache, &rsa->regs[i]))
7755 /* This register is not available. */
7756 regcache_raw_supply (regcache, i, NULL);
7760 /* Prepare to store registers. Since we may send them all (using a
7761 'G' request), we have to read out the ones we don't want to change
7765 remote_prepare_to_store (struct target_ops *self, struct regcache *regcache)
7767 struct remote_arch_state *rsa = get_remote_arch_state ();
7770 /* Make sure the entire registers array is valid. */
7771 switch (packet_support (PACKET_P))
7773 case PACKET_DISABLE:
7774 case PACKET_SUPPORT_UNKNOWN:
7775 /* Make sure all the necessary registers are cached. */
7776 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
7777 if (rsa->regs[i].in_g_packet)
7778 regcache_raw_update (regcache, rsa->regs[i].regnum);
7785 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
7786 packet was not recognized. */
7789 store_register_using_P (const struct regcache *regcache,
7790 struct packet_reg *reg)
7792 struct gdbarch *gdbarch = get_regcache_arch (regcache);
7793 struct remote_state *rs = get_remote_state ();
7794 /* Try storing a single register. */
7795 char *buf = rs->buf;
7796 gdb_byte *regp = (gdb_byte *) alloca (register_size (gdbarch, reg->regnum));
7799 if (packet_support (PACKET_P) == PACKET_DISABLE)
7802 if (reg->pnum == -1)
7805 xsnprintf (buf, get_remote_packet_size (), "P%s=", phex_nz (reg->pnum, 0));
7806 p = buf + strlen (buf);
7807 regcache_raw_collect (regcache, reg->regnum, regp);
7808 bin2hex (regp, p, register_size (gdbarch, reg->regnum));
7810 getpkt (&rs->buf, &rs->buf_size, 0);
7812 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_P]))
7817 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
7818 gdbarch_register_name (gdbarch, reg->regnum), rs->buf);
7819 case PACKET_UNKNOWN:
7822 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
7826 /* Store register REGNUM, or all registers if REGNUM == -1, from the
7827 contents of the register cache buffer. FIXME: ignores errors. */
7830 store_registers_using_G (const struct regcache *regcache)
7832 struct remote_state *rs = get_remote_state ();
7833 struct remote_arch_state *rsa = get_remote_arch_state ();
7837 /* Extract all the registers in the regcache copying them into a
7842 regs = (gdb_byte *) alloca (rsa->sizeof_g_packet);
7843 memset (regs, 0, rsa->sizeof_g_packet);
7844 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
7846 struct packet_reg *r = &rsa->regs[i];
7849 regcache_raw_collect (regcache, r->regnum, regs + r->offset);
7853 /* Command describes registers byte by byte,
7854 each byte encoded as two hex characters. */
7857 bin2hex (regs, p, rsa->sizeof_g_packet);
7859 getpkt (&rs->buf, &rs->buf_size, 0);
7860 if (packet_check_result (rs->buf) == PACKET_ERROR)
7861 error (_("Could not write registers; remote failure reply '%s'"),
7865 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
7866 of the register cache buffer. FIXME: ignores errors. */
7869 remote_store_registers (struct target_ops *ops,
7870 struct regcache *regcache, int regnum)
7872 struct remote_arch_state *rsa = get_remote_arch_state ();
7875 set_remote_traceframe ();
7876 set_general_thread (regcache_get_ptid (regcache));
7880 struct packet_reg *reg = packet_reg_from_regnum (rsa, regnum);
7882 gdb_assert (reg != NULL);
7884 /* Always prefer to store registers using the 'P' packet if
7885 possible; we often change only a small number of registers.
7886 Sometimes we change a larger number; we'd need help from a
7887 higher layer to know to use 'G'. */
7888 if (store_register_using_P (regcache, reg))
7891 /* For now, don't complain if we have no way to write the
7892 register. GDB loses track of unavailable registers too
7893 easily. Some day, this may be an error. We don't have
7894 any way to read the register, either... */
7895 if (!reg->in_g_packet)
7898 store_registers_using_G (regcache);
7902 store_registers_using_G (regcache);
7904 for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
7905 if (!rsa->regs[i].in_g_packet)
7906 if (!store_register_using_P (regcache, &rsa->regs[i]))
7907 /* See above for why we do not issue an error here. */
7912 /* Return the number of hex digits in num. */
7915 hexnumlen (ULONGEST num)
7919 for (i = 0; num != 0; i++)
7922 return std::max (i, 1);
7925 /* Set BUF to the minimum number of hex digits representing NUM. */
7928 hexnumstr (char *buf, ULONGEST num)
7930 int len = hexnumlen (num);
7932 return hexnumnstr (buf, num, len);
7936 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
7939 hexnumnstr (char *buf, ULONGEST num, int width)
7945 for (i = width - 1; i >= 0; i--)
7947 buf[i] = "0123456789abcdef"[(num & 0xf)];
7954 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
7957 remote_address_masked (CORE_ADDR addr)
7959 unsigned int address_size = remote_address_size;
7961 /* If "remoteaddresssize" was not set, default to target address size. */
7963 address_size = gdbarch_addr_bit (target_gdbarch ());
7965 if (address_size > 0
7966 && address_size < (sizeof (ULONGEST) * 8))
7968 /* Only create a mask when that mask can safely be constructed
7969 in a ULONGEST variable. */
7972 mask = (mask << address_size) - 1;
7978 /* Determine whether the remote target supports binary downloading.
7979 This is accomplished by sending a no-op memory write of zero length
7980 to the target at the specified address. It does not suffice to send
7981 the whole packet, since many stubs strip the eighth bit and
7982 subsequently compute a wrong checksum, which causes real havoc with
7985 NOTE: This can still lose if the serial line is not eight-bit
7986 clean. In cases like this, the user should clear "remote
7990 check_binary_download (CORE_ADDR addr)
7992 struct remote_state *rs = get_remote_state ();
7994 switch (packet_support (PACKET_X))
7996 case PACKET_DISABLE:
8000 case PACKET_SUPPORT_UNKNOWN:
8006 p += hexnumstr (p, (ULONGEST) addr);
8008 p += hexnumstr (p, (ULONGEST) 0);
8012 putpkt_binary (rs->buf, (int) (p - rs->buf));
8013 getpkt (&rs->buf, &rs->buf_size, 0);
8015 if (rs->buf[0] == '\0')
8018 fprintf_unfiltered (gdb_stdlog,
8019 "binary downloading NOT "
8020 "supported by target\n");
8021 remote_protocol_packets[PACKET_X].support = PACKET_DISABLE;
8026 fprintf_unfiltered (gdb_stdlog,
8027 "binary downloading supported by target\n");
8028 remote_protocol_packets[PACKET_X].support = PACKET_ENABLE;
8035 /* Helper function to resize the payload in order to try to get a good
8036 alignment. We try to write an amount of data such that the next write will
8037 start on an address aligned on REMOTE_ALIGN_WRITES. */
8040 align_for_efficient_write (int todo, CORE_ADDR memaddr)
8042 return ((memaddr + todo) & ~(REMOTE_ALIGN_WRITES - 1)) - memaddr;
8045 /* Write memory data directly to the remote machine.
8046 This does not inform the data cache; the data cache uses this.
8047 HEADER is the starting part of the packet.
8048 MEMADDR is the address in the remote memory space.
8049 MYADDR is the address of the buffer in our space.
8050 LEN_UNITS is the number of addressable units to write.
8051 UNIT_SIZE is the length in bytes of an addressable unit.
8052 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
8053 should send data as binary ('X'), or hex-encoded ('M').
8055 The function creates packet of the form
8056 <HEADER><ADDRESS>,<LENGTH>:<DATA>
8058 where encoding of <DATA> is terminated by PACKET_FORMAT.
8060 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
8063 Return the transferred status, error or OK (an
8064 'enum target_xfer_status' value). Save the number of addressable units
8065 transferred in *XFERED_LEN_UNITS. Only transfer a single packet.
8067 On a platform with an addressable memory size of 2 bytes (UNIT_SIZE == 2), an
8068 exchange between gdb and the stub could look like (?? in place of the
8074 -> $M1000,3:eeeeffffeeee#??
8078 <- eeeeffffeeeedddd */
8080 static enum target_xfer_status
8081 remote_write_bytes_aux (const char *header, CORE_ADDR memaddr,
8082 const gdb_byte *myaddr, ULONGEST len_units,
8083 int unit_size, ULONGEST *xfered_len_units,
8084 char packet_format, int use_length)
8086 struct remote_state *rs = get_remote_state ();
8092 int payload_capacity_bytes;
8093 int payload_length_bytes;
8095 if (packet_format != 'X' && packet_format != 'M')
8096 internal_error (__FILE__, __LINE__,
8097 _("remote_write_bytes_aux: bad packet format"));
8100 return TARGET_XFER_EOF;
8102 payload_capacity_bytes = get_memory_write_packet_size ();
8104 /* The packet buffer will be large enough for the payload;
8105 get_memory_packet_size ensures this. */
8108 /* Compute the size of the actual payload by subtracting out the
8109 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
8111 payload_capacity_bytes -= strlen ("$,:#NN");
8113 /* The comma won't be used. */
8114 payload_capacity_bytes += 1;
8115 payload_capacity_bytes -= strlen (header);
8116 payload_capacity_bytes -= hexnumlen (memaddr);
8118 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
8120 strcat (rs->buf, header);
8121 p = rs->buf + strlen (header);
8123 /* Compute a best guess of the number of bytes actually transfered. */
8124 if (packet_format == 'X')
8126 /* Best guess at number of bytes that will fit. */
8127 todo_units = std::min (len_units,
8128 (ULONGEST) payload_capacity_bytes / unit_size);
8130 payload_capacity_bytes -= hexnumlen (todo_units);
8131 todo_units = std::min (todo_units, payload_capacity_bytes / unit_size);
8135 /* Number of bytes that will fit. */
8137 = std::min (len_units,
8138 (ULONGEST) (payload_capacity_bytes / unit_size) / 2);
8140 payload_capacity_bytes -= hexnumlen (todo_units);
8141 todo_units = std::min (todo_units,
8142 (payload_capacity_bytes / unit_size) / 2);
8145 if (todo_units <= 0)
8146 internal_error (__FILE__, __LINE__,
8147 _("minimum packet size too small to write data"));
8149 /* If we already need another packet, then try to align the end
8150 of this packet to a useful boundary. */
8151 if (todo_units > 2 * REMOTE_ALIGN_WRITES && todo_units < len_units)
8152 todo_units = align_for_efficient_write (todo_units, memaddr);
8154 /* Append "<memaddr>". */
8155 memaddr = remote_address_masked (memaddr);
8156 p += hexnumstr (p, (ULONGEST) memaddr);
8163 /* Append the length and retain its location and size. It may need to be
8164 adjusted once the packet body has been created. */
8166 plenlen = hexnumstr (p, (ULONGEST) todo_units);
8174 /* Append the packet body. */
8175 if (packet_format == 'X')
8177 /* Binary mode. Send target system values byte by byte, in
8178 increasing byte addresses. Only escape certain critical
8180 payload_length_bytes =
8181 remote_escape_output (myaddr, todo_units, unit_size, (gdb_byte *) p,
8182 &units_written, payload_capacity_bytes);
8184 /* If not all TODO units fit, then we'll need another packet. Make
8185 a second try to keep the end of the packet aligned. Don't do
8186 this if the packet is tiny. */
8187 if (units_written < todo_units && units_written > 2 * REMOTE_ALIGN_WRITES)
8191 new_todo_units = align_for_efficient_write (units_written, memaddr);
8193 if (new_todo_units != units_written)
8194 payload_length_bytes =
8195 remote_escape_output (myaddr, new_todo_units, unit_size,
8196 (gdb_byte *) p, &units_written,
8197 payload_capacity_bytes);
8200 p += payload_length_bytes;
8201 if (use_length && units_written < todo_units)
8203 /* Escape chars have filled up the buffer prematurely,
8204 and we have actually sent fewer units than planned.
8205 Fix-up the length field of the packet. Use the same
8206 number of characters as before. */
8207 plen += hexnumnstr (plen, (ULONGEST) units_written,
8209 *plen = ':'; /* overwrite \0 from hexnumnstr() */
8214 /* Normal mode: Send target system values byte by byte, in
8215 increasing byte addresses. Each byte is encoded as a two hex
8217 p += 2 * bin2hex (myaddr, p, todo_units * unit_size);
8218 units_written = todo_units;
8221 putpkt_binary (rs->buf, (int) (p - rs->buf));
8222 getpkt (&rs->buf, &rs->buf_size, 0);
8224 if (rs->buf[0] == 'E')
8225 return TARGET_XFER_E_IO;
8227 /* Return UNITS_WRITTEN, not TODO_UNITS, in case escape chars caused us to
8228 send fewer units than we'd planned. */
8229 *xfered_len_units = (ULONGEST) units_written;
8230 return TARGET_XFER_OK;
8233 /* Write memory data directly to the remote machine.
8234 This does not inform the data cache; the data cache uses this.
8235 MEMADDR is the address in the remote memory space.
8236 MYADDR is the address of the buffer in our space.
8237 LEN is the number of bytes.
8239 Return the transferred status, error or OK (an
8240 'enum target_xfer_status' value). Save the number of bytes
8241 transferred in *XFERED_LEN. Only transfer a single packet. */
8243 static enum target_xfer_status
8244 remote_write_bytes (CORE_ADDR memaddr, const gdb_byte *myaddr, ULONGEST len,
8245 int unit_size, ULONGEST *xfered_len)
8247 const char *packet_format = NULL;
8249 /* Check whether the target supports binary download. */
8250 check_binary_download (memaddr);
8252 switch (packet_support (PACKET_X))
8255 packet_format = "X";
8257 case PACKET_DISABLE:
8258 packet_format = "M";
8260 case PACKET_SUPPORT_UNKNOWN:
8261 internal_error (__FILE__, __LINE__,
8262 _("remote_write_bytes: bad internal state"));
8264 internal_error (__FILE__, __LINE__, _("bad switch"));
8267 return remote_write_bytes_aux (packet_format,
8268 memaddr, myaddr, len, unit_size, xfered_len,
8269 packet_format[0], 1);
8272 /* Read memory data directly from the remote machine.
8273 This does not use the data cache; the data cache uses this.
8274 MEMADDR is the address in the remote memory space.
8275 MYADDR is the address of the buffer in our space.
8276 LEN_UNITS is the number of addressable memory units to read..
8277 UNIT_SIZE is the length in bytes of an addressable unit.
8279 Return the transferred status, error or OK (an
8280 'enum target_xfer_status' value). Save the number of bytes
8281 transferred in *XFERED_LEN_UNITS.
8283 See the comment of remote_write_bytes_aux for an example of
8284 memory read/write exchange between gdb and the stub. */
8286 static enum target_xfer_status
8287 remote_read_bytes_1 (CORE_ADDR memaddr, gdb_byte *myaddr, ULONGEST len_units,
8288 int unit_size, ULONGEST *xfered_len_units)
8290 struct remote_state *rs = get_remote_state ();
8291 int buf_size_bytes; /* Max size of packet output buffer. */
8296 buf_size_bytes = get_memory_read_packet_size ();
8297 /* The packet buffer will be large enough for the payload;
8298 get_memory_packet_size ensures this. */
8300 /* Number of units that will fit. */
8301 todo_units = std::min (len_units,
8302 (ULONGEST) (buf_size_bytes / unit_size) / 2);
8304 /* Construct "m"<memaddr>","<len>". */
8305 memaddr = remote_address_masked (memaddr);
8308 p += hexnumstr (p, (ULONGEST) memaddr);
8310 p += hexnumstr (p, (ULONGEST) todo_units);
8313 getpkt (&rs->buf, &rs->buf_size, 0);
8314 if (rs->buf[0] == 'E'
8315 && isxdigit (rs->buf[1]) && isxdigit (rs->buf[2])
8316 && rs->buf[3] == '\0')
8317 return TARGET_XFER_E_IO;
8318 /* Reply describes memory byte by byte, each byte encoded as two hex
8321 decoded_bytes = hex2bin (p, myaddr, todo_units * unit_size);
8322 /* Return what we have. Let higher layers handle partial reads. */
8323 *xfered_len_units = (ULONGEST) (decoded_bytes / unit_size);
8324 return TARGET_XFER_OK;
8327 /* Using the set of read-only target sections of remote, read live
8330 For interface/parameters/return description see target.h,
8333 static enum target_xfer_status
8334 remote_xfer_live_readonly_partial (struct target_ops *ops, gdb_byte *readbuf,
8335 ULONGEST memaddr, ULONGEST len,
8336 int unit_size, ULONGEST *xfered_len)
8338 struct target_section *secp;
8339 struct target_section_table *table;
8341 secp = target_section_by_addr (ops, memaddr);
8343 && (bfd_get_section_flags (secp->the_bfd_section->owner,
8344 secp->the_bfd_section)
8347 struct target_section *p;
8348 ULONGEST memend = memaddr + len;
8350 table = target_get_section_table (ops);
8352 for (p = table->sections; p < table->sections_end; p++)
8354 if (memaddr >= p->addr)
8356 if (memend <= p->endaddr)
8358 /* Entire transfer is within this section. */
8359 return remote_read_bytes_1 (memaddr, readbuf, len, unit_size,
8362 else if (memaddr >= p->endaddr)
8364 /* This section ends before the transfer starts. */
8369 /* This section overlaps the transfer. Just do half. */
8370 len = p->endaddr - memaddr;
8371 return remote_read_bytes_1 (memaddr, readbuf, len, unit_size,
8378 return TARGET_XFER_EOF;
8381 /* Similar to remote_read_bytes_1, but it reads from the remote stub
8382 first if the requested memory is unavailable in traceframe.
8383 Otherwise, fall back to remote_read_bytes_1. */
8385 static enum target_xfer_status
8386 remote_read_bytes (struct target_ops *ops, CORE_ADDR memaddr,
8387 gdb_byte *myaddr, ULONGEST len, int unit_size,
8388 ULONGEST *xfered_len)
8391 return TARGET_XFER_EOF;
8393 if (get_traceframe_number () != -1)
8395 VEC(mem_range_s) *available;
8397 /* If we fail to get the set of available memory, then the
8398 target does not support querying traceframe info, and so we
8399 attempt reading from the traceframe anyway (assuming the
8400 target implements the old QTro packet then). */
8401 if (traceframe_available_memory (&available, memaddr, len))
8403 struct cleanup *old_chain;
8405 old_chain = make_cleanup (VEC_cleanup(mem_range_s), &available);
8407 if (VEC_empty (mem_range_s, available)
8408 || VEC_index (mem_range_s, available, 0)->start != memaddr)
8410 enum target_xfer_status res;
8412 /* Don't read into the traceframe's available
8414 if (!VEC_empty (mem_range_s, available))
8416 LONGEST oldlen = len;
8418 len = VEC_index (mem_range_s, available, 0)->start - memaddr;
8419 gdb_assert (len <= oldlen);
8422 do_cleanups (old_chain);
8424 /* This goes through the topmost target again. */
8425 res = remote_xfer_live_readonly_partial (ops, myaddr, memaddr,
8426 len, unit_size, xfered_len);
8427 if (res == TARGET_XFER_OK)
8428 return TARGET_XFER_OK;
8431 /* No use trying further, we know some memory starting
8432 at MEMADDR isn't available. */
8434 return TARGET_XFER_UNAVAILABLE;
8438 /* Don't try to read more than how much is available, in
8439 case the target implements the deprecated QTro packet to
8440 cater for older GDBs (the target's knowledge of read-only
8441 sections may be outdated by now). */
8442 len = VEC_index (mem_range_s, available, 0)->length;
8444 do_cleanups (old_chain);
8448 return remote_read_bytes_1 (memaddr, myaddr, len, unit_size, xfered_len);
8453 /* Sends a packet with content determined by the printf format string
8454 FORMAT and the remaining arguments, then gets the reply. Returns
8455 whether the packet was a success, a failure, or unknown. */
8457 static enum packet_result remote_send_printf (const char *format, ...)
8458 ATTRIBUTE_PRINTF (1, 2);
8460 static enum packet_result
8461 remote_send_printf (const char *format, ...)
8463 struct remote_state *rs = get_remote_state ();
8464 int max_size = get_remote_packet_size ();
8467 va_start (ap, format);
8470 if (vsnprintf (rs->buf, max_size, format, ap) >= max_size)
8471 internal_error (__FILE__, __LINE__, _("Too long remote packet."));
8473 if (putpkt (rs->buf) < 0)
8474 error (_("Communication problem with target."));
8477 getpkt (&rs->buf, &rs->buf_size, 0);
8479 return packet_check_result (rs->buf);
8482 /* Flash writing can take quite some time. We'll set
8483 effectively infinite timeout for flash operations.
8484 In future, we'll need to decide on a better approach. */
8485 static const int remote_flash_timeout = 1000;
8488 remote_flash_erase (struct target_ops *ops,
8489 ULONGEST address, LONGEST length)
8491 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
8492 enum packet_result ret;
8493 scoped_restore restore_timeout
8494 = make_scoped_restore (&remote_timeout, remote_flash_timeout);
8496 ret = remote_send_printf ("vFlashErase:%s,%s",
8497 phex (address, addr_size),
8501 case PACKET_UNKNOWN:
8502 error (_("Remote target does not support flash erase"));
8504 error (_("Error erasing flash with vFlashErase packet"));
8510 static enum target_xfer_status
8511 remote_flash_write (struct target_ops *ops, ULONGEST address,
8512 ULONGEST length, ULONGEST *xfered_len,
8513 const gdb_byte *data)
8515 scoped_restore restore_timeout
8516 = make_scoped_restore (&remote_timeout, remote_flash_timeout);
8517 return remote_write_bytes_aux ("vFlashWrite:", address, data, length, 1,
8522 remote_flash_done (struct target_ops *ops)
8526 scoped_restore restore_timeout
8527 = make_scoped_restore (&remote_timeout, remote_flash_timeout);
8529 ret = remote_send_printf ("vFlashDone");
8533 case PACKET_UNKNOWN:
8534 error (_("Remote target does not support vFlashDone"));
8536 error (_("Error finishing flash operation"));
8543 remote_files_info (struct target_ops *ignore)
8545 puts_filtered ("Debugging a target over a serial line.\n");
8548 /* Stuff for dealing with the packets which are part of this protocol.
8549 See comment at top of file for details. */
8551 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
8552 error to higher layers. Called when a serial error is detected.
8553 The exception message is STRING, followed by a colon and a blank,
8554 the system error message for errno at function entry and final dot
8555 for output compatibility with throw_perror_with_name. */
8558 unpush_and_perror (const char *string)
8560 int saved_errno = errno;
8562 remote_unpush_target ();
8563 throw_error (TARGET_CLOSE_ERROR, "%s: %s.", string,
8564 safe_strerror (saved_errno));
8567 /* Read a single character from the remote end. The current quit
8568 handler is overridden to avoid quitting in the middle of packet
8569 sequence, as that would break communication with the remote server.
8570 See remote_serial_quit_handler for more detail. */
8573 readchar (int timeout)
8576 struct remote_state *rs = get_remote_state ();
8579 scoped_restore restore_quit
8580 = make_scoped_restore (&quit_handler, remote_serial_quit_handler);
8582 rs->got_ctrlc_during_io = 0;
8584 ch = serial_readchar (rs->remote_desc, timeout);
8586 if (rs->got_ctrlc_during_io)
8593 switch ((enum serial_rc) ch)
8596 remote_unpush_target ();
8597 throw_error (TARGET_CLOSE_ERROR, _("Remote connection closed"));
8600 unpush_and_perror (_("Remote communication error. "
8601 "Target disconnected."));
8603 case SERIAL_TIMEOUT:
8609 /* Wrapper for serial_write that closes the target and throws if
8610 writing fails. The current quit handler is overridden to avoid
8611 quitting in the middle of packet sequence, as that would break
8612 communication with the remote server. See
8613 remote_serial_quit_handler for more detail. */
8616 remote_serial_write (const char *str, int len)
8618 struct remote_state *rs = get_remote_state ();
8620 scoped_restore restore_quit
8621 = make_scoped_restore (&quit_handler, remote_serial_quit_handler);
8623 rs->got_ctrlc_during_io = 0;
8625 if (serial_write (rs->remote_desc, str, len))
8627 unpush_and_perror (_("Remote communication error. "
8628 "Target disconnected."));
8631 if (rs->got_ctrlc_during_io)
8635 /* Send the command in *BUF to the remote machine, and read the reply
8636 into *BUF. Report an error if we get an error reply. Resize
8637 *BUF using xrealloc if necessary to hold the result, and update
8641 remote_send (char **buf,
8645 getpkt (buf, sizeof_buf, 0);
8647 if ((*buf)[0] == 'E')
8648 error (_("Remote failure reply: %s"), *buf);
8651 /* Return a string representing an escaped version of BUF, of len N.
8652 E.g. \n is converted to \\n, \t to \\t, etc. */
8655 escape_buffer (const char *buf, int n)
8659 stb.putstrn (buf, n, '\\');
8660 return std::move (stb.string ());
8663 /* Display a null-terminated packet on stdout, for debugging, using C
8667 print_packet (const char *buf)
8669 puts_filtered ("\"");
8670 fputstr_filtered (buf, '"', gdb_stdout);
8671 puts_filtered ("\"");
8675 putpkt (const char *buf)
8677 return putpkt_binary (buf, strlen (buf));
8680 /* Send a packet to the remote machine, with error checking. The data
8681 of the packet is in BUF. The string in BUF can be at most
8682 get_remote_packet_size () - 5 to account for the $, # and checksum,
8683 and for a possible /0 if we are debugging (remote_debug) and want
8684 to print the sent packet as a string. */
8687 putpkt_binary (const char *buf, int cnt)
8689 struct remote_state *rs = get_remote_state ();
8691 unsigned char csum = 0;
8692 char *buf2 = (char *) xmalloc (cnt + 6);
8693 struct cleanup *old_chain = make_cleanup (xfree, buf2);
8699 /* Catch cases like trying to read memory or listing threads while
8700 we're waiting for a stop reply. The remote server wouldn't be
8701 ready to handle this request, so we'd hang and timeout. We don't
8702 have to worry about this in synchronous mode, because in that
8703 case it's not possible to issue a command while the target is
8704 running. This is not a problem in non-stop mode, because in that
8705 case, the stub is always ready to process serial input. */
8706 if (!target_is_non_stop_p ()
8707 && target_is_async_p ()
8708 && rs->waiting_for_stop_reply)
8710 error (_("Cannot execute this command while the target is running.\n"
8711 "Use the \"interrupt\" command to stop the target\n"
8712 "and then try again."));
8715 /* We're sending out a new packet. Make sure we don't look at a
8716 stale cached response. */
8717 rs->cached_wait_status = 0;
8719 /* Copy the packet into buffer BUF2, encapsulating it
8720 and giving it a checksum. */
8725 for (i = 0; i < cnt; i++)
8731 *p++ = tohex ((csum >> 4) & 0xf);
8732 *p++ = tohex (csum & 0xf);
8734 /* Send it over and over until we get a positive ack. */
8738 int started_error_output = 0;
8744 int len = (int) (p - buf2);
8747 = escape_buffer (buf2, std::min (len, REMOTE_DEBUG_MAX_CHAR));
8749 fprintf_unfiltered (gdb_stdlog, "Sending packet: %s", str.c_str ());
8751 if (str.length () > REMOTE_DEBUG_MAX_CHAR)
8753 fprintf_unfiltered (gdb_stdlog, "[%zu bytes omitted]",
8754 str.length () - REMOTE_DEBUG_MAX_CHAR);
8757 fprintf_unfiltered (gdb_stdlog, "...");
8759 gdb_flush (gdb_stdlog);
8761 remote_serial_write (buf2, p - buf2);
8763 /* If this is a no acks version of the remote protocol, send the
8764 packet and move on. */
8768 /* Read until either a timeout occurs (-2) or '+' is read.
8769 Handle any notification that arrives in the mean time. */
8772 ch = readchar (remote_timeout);
8780 case SERIAL_TIMEOUT:
8783 if (started_error_output)
8785 putchar_unfiltered ('\n');
8786 started_error_output = 0;
8795 fprintf_unfiltered (gdb_stdlog, "Ack\n");
8796 do_cleanups (old_chain);
8800 fprintf_unfiltered (gdb_stdlog, "Nak\n");
8802 case SERIAL_TIMEOUT:
8806 do_cleanups (old_chain);
8809 break; /* Retransmit buffer. */
8813 fprintf_unfiltered (gdb_stdlog,
8814 "Packet instead of Ack, ignoring it\n");
8815 /* It's probably an old response sent because an ACK
8816 was lost. Gobble up the packet and ack it so it
8817 doesn't get retransmitted when we resend this
8820 remote_serial_write ("+", 1);
8821 continue; /* Now, go look for +. */
8828 /* If we got a notification, handle it, and go back to looking
8830 /* We've found the start of a notification. Now
8831 collect the data. */
8832 val = read_frame (&rs->buf, &rs->buf_size);
8837 std::string str = escape_buffer (rs->buf, val);
8839 fprintf_unfiltered (gdb_stdlog,
8840 " Notification received: %s\n",
8843 handle_notification (rs->notif_state, rs->buf);
8844 /* We're in sync now, rewait for the ack. */
8851 if (!started_error_output)
8853 started_error_output = 1;
8854 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
8856 fputc_unfiltered (ch & 0177, gdb_stdlog);
8857 fprintf_unfiltered (gdb_stdlog, "%s", rs->buf);
8866 if (!started_error_output)
8868 started_error_output = 1;
8869 fprintf_unfiltered (gdb_stdlog, "putpkt: Junk: ");
8871 fputc_unfiltered (ch & 0177, gdb_stdlog);
8875 break; /* Here to retransmit. */
8879 /* This is wrong. If doing a long backtrace, the user should be
8880 able to get out next time we call QUIT, without anything as
8881 violent as interrupt_query. If we want to provide a way out of
8882 here without getting to the next QUIT, it should be based on
8883 hitting ^C twice as in remote_wait. */
8892 do_cleanups (old_chain);
8896 /* Come here after finding the start of a frame when we expected an
8897 ack. Do our best to discard the rest of this packet. */
8906 c = readchar (remote_timeout);
8909 case SERIAL_TIMEOUT:
8910 /* Nothing we can do. */
8913 /* Discard the two bytes of checksum and stop. */
8914 c = readchar (remote_timeout);
8916 c = readchar (remote_timeout);
8919 case '*': /* Run length encoding. */
8920 /* Discard the repeat count. */
8921 c = readchar (remote_timeout);
8926 /* A regular character. */
8932 /* Come here after finding the start of the frame. Collect the rest
8933 into *BUF, verifying the checksum, length, and handling run-length
8934 compression. NUL terminate the buffer. If there is not enough room,
8935 expand *BUF using xrealloc.
8937 Returns -1 on error, number of characters in buffer (ignoring the
8938 trailing NULL) on success. (could be extended to return one of the
8939 SERIAL status indications). */
8942 read_frame (char **buf_p,
8949 struct remote_state *rs = get_remote_state ();
8956 c = readchar (remote_timeout);
8959 case SERIAL_TIMEOUT:
8961 fputs_filtered ("Timeout in mid-packet, retrying\n", gdb_stdlog);
8965 fputs_filtered ("Saw new packet start in middle of old one\n",
8967 return -1; /* Start a new packet, count retries. */
8970 unsigned char pktcsum;
8976 check_0 = readchar (remote_timeout);
8978 check_1 = readchar (remote_timeout);
8980 if (check_0 == SERIAL_TIMEOUT || check_1 == SERIAL_TIMEOUT)
8983 fputs_filtered ("Timeout in checksum, retrying\n",
8987 else if (check_0 < 0 || check_1 < 0)
8990 fputs_filtered ("Communication error in checksum\n",
8995 /* Don't recompute the checksum; with no ack packets we
8996 don't have any way to indicate a packet retransmission
9001 pktcsum = (fromhex (check_0) << 4) | fromhex (check_1);
9002 if (csum == pktcsum)
9007 std::string str = escape_buffer (buf, bc);
9009 fprintf_unfiltered (gdb_stdlog,
9010 "Bad checksum, sentsum=0x%x, "
9011 "csum=0x%x, buf=%s\n",
9012 pktcsum, csum, str.c_str ());
9014 /* Number of characters in buffer ignoring trailing
9018 case '*': /* Run length encoding. */
9023 c = readchar (remote_timeout);
9025 repeat = c - ' ' + 3; /* Compute repeat count. */
9027 /* The character before ``*'' is repeated. */
9029 if (repeat > 0 && repeat <= 255 && bc > 0)
9031 if (bc + repeat - 1 >= *sizeof_buf - 1)
9033 /* Make some more room in the buffer. */
9034 *sizeof_buf += repeat;
9035 *buf_p = (char *) xrealloc (*buf_p, *sizeof_buf);
9039 memset (&buf[bc], buf[bc - 1], repeat);
9045 printf_filtered (_("Invalid run length encoding: %s\n"), buf);
9049 if (bc >= *sizeof_buf - 1)
9051 /* Make some more room in the buffer. */
9053 *buf_p = (char *) xrealloc (*buf_p, *sizeof_buf);
9064 /* Read a packet from the remote machine, with error checking, and
9065 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
9066 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
9067 rather than timing out; this is used (in synchronous mode) to wait
9068 for a target that is is executing user code to stop. */
9069 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
9070 don't have to change all the calls to getpkt to deal with the
9071 return value, because at the moment I don't know what the right
9072 thing to do it for those. */
9078 getpkt_sane (buf, sizeof_buf, forever);
9082 /* Read a packet from the remote machine, with error checking, and
9083 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
9084 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
9085 rather than timing out; this is used (in synchronous mode) to wait
9086 for a target that is is executing user code to stop. If FOREVER ==
9087 0, this function is allowed to time out gracefully and return an
9088 indication of this to the caller. Otherwise return the number of
9089 bytes read. If EXPECTING_NOTIF, consider receiving a notification
9090 enough reason to return to the caller. *IS_NOTIF is an output
9091 boolean that indicates whether *BUF holds a notification or not
9092 (a regular packet). */
9095 getpkt_or_notif_sane_1 (char **buf, long *sizeof_buf, int forever,
9096 int expecting_notif, int *is_notif)
9098 struct remote_state *rs = get_remote_state ();
9104 /* We're reading a new response. Make sure we don't look at a
9105 previously cached response. */
9106 rs->cached_wait_status = 0;
9108 strcpy (*buf, "timeout");
9111 timeout = watchdog > 0 ? watchdog : -1;
9112 else if (expecting_notif)
9113 timeout = 0; /* There should already be a char in the buffer. If
9116 timeout = remote_timeout;
9120 /* Process any number of notifications, and then return when
9124 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
9126 for (tries = 1; tries <= MAX_TRIES; tries++)
9128 /* This can loop forever if the remote side sends us
9129 characters continuously, but if it pauses, we'll get
9130 SERIAL_TIMEOUT from readchar because of timeout. Then
9131 we'll count that as a retry.
9133 Note that even when forever is set, we will only wait
9134 forever prior to the start of a packet. After that, we
9135 expect characters to arrive at a brisk pace. They should
9136 show up within remote_timeout intervals. */
9138 c = readchar (timeout);
9139 while (c != SERIAL_TIMEOUT && c != '$' && c != '%');
9141 if (c == SERIAL_TIMEOUT)
9143 if (expecting_notif)
9144 return -1; /* Don't complain, it's normal to not get
9145 anything in this case. */
9147 if (forever) /* Watchdog went off? Kill the target. */
9149 remote_unpush_target ();
9150 throw_error (TARGET_CLOSE_ERROR,
9151 _("Watchdog timeout has expired. "
9152 "Target detached."));
9155 fputs_filtered ("Timed out.\n", gdb_stdlog);
9159 /* We've found the start of a packet or notification.
9160 Now collect the data. */
9161 val = read_frame (buf, sizeof_buf);
9166 remote_serial_write ("-", 1);
9169 if (tries > MAX_TRIES)
9171 /* We have tried hard enough, and just can't receive the
9172 packet/notification. Give up. */
9173 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
9175 /* Skip the ack char if we're in no-ack mode. */
9176 if (!rs->noack_mode)
9177 remote_serial_write ("+", 1);
9181 /* If we got an ordinary packet, return that to our caller. */
9187 = escape_buffer (*buf,
9188 std::min (val, REMOTE_DEBUG_MAX_CHAR));
9190 fprintf_unfiltered (gdb_stdlog, "Packet received: %s",
9193 if (str.length () > REMOTE_DEBUG_MAX_CHAR)
9195 fprintf_unfiltered (gdb_stdlog, "[%zu bytes omitted]",
9196 str.length () - REMOTE_DEBUG_MAX_CHAR);
9199 fprintf_unfiltered (gdb_stdlog, "\n");
9202 /* Skip the ack char if we're in no-ack mode. */
9203 if (!rs->noack_mode)
9204 remote_serial_write ("+", 1);
9205 if (is_notif != NULL)
9210 /* If we got a notification, handle it, and go back to looking
9214 gdb_assert (c == '%');
9218 std::string str = escape_buffer (*buf, val);
9220 fprintf_unfiltered (gdb_stdlog,
9221 " Notification received: %s\n",
9224 if (is_notif != NULL)
9227 handle_notification (rs->notif_state, *buf);
9229 /* Notifications require no acknowledgement. */
9231 if (expecting_notif)
9238 getpkt_sane (char **buf, long *sizeof_buf, int forever)
9240 return getpkt_or_notif_sane_1 (buf, sizeof_buf, forever, 0, NULL);
9244 getpkt_or_notif_sane (char **buf, long *sizeof_buf, int forever,
9247 return getpkt_or_notif_sane_1 (buf, sizeof_buf, forever, 1,
9251 /* Check whether EVENT is a fork event for the process specified
9252 by the pid passed in DATA, and if it is, kill the fork child. */
9255 kill_child_of_pending_fork (QUEUE (stop_reply_p) *q,
9256 QUEUE_ITER (stop_reply_p) *iter,
9260 struct queue_iter_param *param = (struct queue_iter_param *) data;
9261 int parent_pid = *(int *) param->input;
9263 if (is_pending_fork_parent (&event->ws, parent_pid, event->ptid))
9265 struct remote_state *rs = get_remote_state ();
9266 int child_pid = ptid_get_pid (event->ws.value.related_pid);
9269 res = remote_vkill (child_pid, rs);
9271 error (_("Can't kill fork child process %d"), child_pid);
9277 /* Kill any new fork children of process PID that haven't been
9278 processed by follow_fork. */
9281 kill_new_fork_children (int pid, struct remote_state *rs)
9283 struct thread_info *thread;
9284 struct notif_client *notif = ¬if_client_stop;
9285 struct queue_iter_param param;
9287 /* Kill the fork child threads of any threads in process PID
9288 that are stopped at a fork event. */
9289 ALL_NON_EXITED_THREADS (thread)
9291 struct target_waitstatus *ws = &thread->pending_follow;
9293 if (is_pending_fork_parent (ws, pid, thread->ptid))
9295 struct remote_state *rs = get_remote_state ();
9296 int child_pid = ptid_get_pid (ws->value.related_pid);
9299 res = remote_vkill (child_pid, rs);
9301 error (_("Can't kill fork child process %d"), child_pid);
9305 /* Check for any pending fork events (not reported or processed yet)
9306 in process PID and kill those fork child threads as well. */
9307 remote_notif_get_pending_events (notif);
9309 param.output = NULL;
9310 QUEUE_iterate (stop_reply_p, stop_reply_queue,
9311 kill_child_of_pending_fork, ¶m);
9315 /* Target hook to kill the current inferior. */
9318 remote_kill (struct target_ops *ops)
9321 int pid = ptid_get_pid (inferior_ptid);
9322 struct remote_state *rs = get_remote_state ();
9324 if (packet_support (PACKET_vKill) != PACKET_DISABLE)
9326 /* If we're stopped while forking and we haven't followed yet,
9327 kill the child task. We need to do this before killing the
9328 parent task because if this is a vfork then the parent will
9330 kill_new_fork_children (pid, rs);
9332 res = remote_vkill (pid, rs);
9335 target_mourn_inferior (inferior_ptid);
9340 /* If we are in 'target remote' mode and we are killing the only
9341 inferior, then we will tell gdbserver to exit and unpush the
9343 if (res == -1 && !remote_multi_process_p (rs)
9344 && number_of_live_inferiors () == 1)
9348 /* We've killed the remote end, we get to mourn it. If we are
9349 not in extended mode, mourning the inferior also unpushes
9350 remote_ops from the target stack, which closes the remote
9352 target_mourn_inferior (inferior_ptid);
9357 error (_("Can't kill process"));
9360 /* Send a kill request to the target using the 'vKill' packet. */
9363 remote_vkill (int pid, struct remote_state *rs)
9365 if (packet_support (PACKET_vKill) == PACKET_DISABLE)
9368 /* Tell the remote target to detach. */
9369 xsnprintf (rs->buf, get_remote_packet_size (), "vKill;%x", pid);
9371 getpkt (&rs->buf, &rs->buf_size, 0);
9373 switch (packet_ok (rs->buf,
9374 &remote_protocol_packets[PACKET_vKill]))
9380 case PACKET_UNKNOWN:
9383 internal_error (__FILE__, __LINE__, _("Bad result from packet_ok"));
9387 /* Send a kill request to the target using the 'k' packet. */
9390 remote_kill_k (void)
9392 /* Catch errors so the user can quit from gdb even when we
9393 aren't on speaking terms with the remote system. */
9398 CATCH (ex, RETURN_MASK_ERROR)
9400 if (ex.error == TARGET_CLOSE_ERROR)
9402 /* If we got an (EOF) error that caused the target
9403 to go away, then we're done, that's what we wanted.
9404 "k" is susceptible to cause a premature EOF, given
9405 that the remote server isn't actually required to
9406 reply to "k", and it can happen that it doesn't
9407 even get to reply ACK to the "k". */
9411 /* Otherwise, something went wrong. We didn't actually kill
9412 the target. Just propagate the exception, and let the
9413 user or higher layers decide what to do. */
9414 throw_exception (ex);
9420 remote_mourn (struct target_ops *target)
9422 struct remote_state *rs = get_remote_state ();
9424 /* In 'target remote' mode with one inferior, we close the connection. */
9425 if (!rs->extended && number_of_live_inferiors () <= 1)
9427 unpush_target (target);
9429 /* remote_close takes care of doing most of the clean up. */
9430 generic_mourn_inferior ();
9434 /* In case we got here due to an error, but we're going to stay
9436 rs->waiting_for_stop_reply = 0;
9438 /* If the current general thread belonged to the process we just
9439 detached from or has exited, the remote side current general
9440 thread becomes undefined. Considering a case like this:
9442 - We just got here due to a detach.
9443 - The process that we're detaching from happens to immediately
9444 report a global breakpoint being hit in non-stop mode, in the
9445 same thread we had selected before.
9446 - GDB attaches to this process again.
9447 - This event happens to be the next event we handle.
9449 GDB would consider that the current general thread didn't need to
9450 be set on the stub side (with Hg), since for all it knew,
9451 GENERAL_THREAD hadn't changed.
9453 Notice that although in all-stop mode, the remote server always
9454 sets the current thread to the thread reporting the stop event,
9455 that doesn't happen in non-stop mode; in non-stop, the stub *must
9456 not* change the current thread when reporting a breakpoint hit,
9457 due to the decoupling of event reporting and event handling.
9459 To keep things simple, we always invalidate our notion of the
9461 record_currthread (rs, minus_one_ptid);
9463 /* Call common code to mark the inferior as not running. */
9464 generic_mourn_inferior ();
9466 if (!have_inferiors ())
9468 if (!remote_multi_process_p (rs))
9470 /* Check whether the target is running now - some remote stubs
9471 automatically restart after kill. */
9473 getpkt (&rs->buf, &rs->buf_size, 0);
9475 if (rs->buf[0] == 'S' || rs->buf[0] == 'T')
9477 /* Assume that the target has been restarted. Set
9478 inferior_ptid so that bits of core GDB realizes
9479 there's something here, e.g., so that the user can
9480 say "kill" again. */
9481 inferior_ptid = magic_null_ptid;
9488 extended_remote_supports_disable_randomization (struct target_ops *self)
9490 return packet_support (PACKET_QDisableRandomization) == PACKET_ENABLE;
9494 extended_remote_disable_randomization (int val)
9496 struct remote_state *rs = get_remote_state ();
9499 xsnprintf (rs->buf, get_remote_packet_size (), "QDisableRandomization:%x",
9502 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
9504 error (_("Target does not support QDisableRandomization."));
9505 if (strcmp (reply, "OK") != 0)
9506 error (_("Bogus QDisableRandomization reply from target: %s"), reply);
9510 extended_remote_run (const std::string &args)
9512 struct remote_state *rs = get_remote_state ();
9514 const char *remote_exec_file = get_remote_exec_file ();
9516 /* If the user has disabled vRun support, or we have detected that
9517 support is not available, do not try it. */
9518 if (packet_support (PACKET_vRun) == PACKET_DISABLE)
9521 strcpy (rs->buf, "vRun;");
9522 len = strlen (rs->buf);
9524 if (strlen (remote_exec_file) * 2 + len >= get_remote_packet_size ())
9525 error (_("Remote file name too long for run packet"));
9526 len += 2 * bin2hex ((gdb_byte *) remote_exec_file, rs->buf + len,
9527 strlen (remote_exec_file));
9533 gdb_argv argv (args.c_str ());
9534 for (i = 0; argv[i] != NULL; i++)
9536 if (strlen (argv[i]) * 2 + 1 + len >= get_remote_packet_size ())
9537 error (_("Argument list too long for run packet"));
9538 rs->buf[len++] = ';';
9539 len += 2 * bin2hex ((gdb_byte *) argv[i], rs->buf + len,
9544 rs->buf[len++] = '\0';
9547 getpkt (&rs->buf, &rs->buf_size, 0);
9549 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_vRun]))
9552 /* We have a wait response. All is well. */
9554 case PACKET_UNKNOWN:
9557 if (remote_exec_file[0] == '\0')
9558 error (_("Running the default executable on the remote target failed; "
9559 "try \"set remote exec-file\"?"));
9561 error (_("Running \"%s\" on the remote target failed"),
9564 gdb_assert_not_reached (_("bad switch"));
9568 /* Helper function to send set/unset environment packets. ACTION is
9569 either "set" or "unset". PACKET is either "QEnvironmentHexEncoded"
9570 or "QEnvironmentUnsetVariable". VALUE is the variable to be
9574 send_environment_packet (struct remote_state *rs,
9579 /* Convert the environment variable to an hex string, which
9580 is the best format to be transmitted over the wire. */
9581 std::string encoded_value = bin2hex ((const gdb_byte *) value,
9584 xsnprintf (rs->buf, get_remote_packet_size (),
9585 "%s:%s", packet, encoded_value.c_str ());
9588 getpkt (&rs->buf, &rs->buf_size, 0);
9589 if (strcmp (rs->buf, "OK") != 0)
9590 warning (_("Unable to %s environment variable '%s' on remote."),
9594 /* Helper function to handle the QEnvironment* packets. */
9597 extended_remote_environment_support (struct remote_state *rs)
9599 if (packet_support (PACKET_QEnvironmentReset) != PACKET_DISABLE)
9601 putpkt ("QEnvironmentReset");
9602 getpkt (&rs->buf, &rs->buf_size, 0);
9603 if (strcmp (rs->buf, "OK") != 0)
9604 warning (_("Unable to reset environment on remote."));
9607 gdb_environ *e = ¤t_inferior ()->environment;
9609 if (packet_support (PACKET_QEnvironmentHexEncoded) != PACKET_DISABLE)
9610 for (const std::string &el : e->user_set_env ())
9611 send_environment_packet (rs, "set", "QEnvironmentHexEncoded",
9614 if (packet_support (PACKET_QEnvironmentUnset) != PACKET_DISABLE)
9615 for (const std::string &el : e->user_unset_env ())
9616 send_environment_packet (rs, "unset", "QEnvironmentUnset", el.c_str ());
9619 /* In the extended protocol we want to be able to do things like
9620 "run" and have them basically work as expected. So we need
9621 a special create_inferior function. We support changing the
9622 executable file and the command line arguments, but not the
9626 extended_remote_create_inferior (struct target_ops *ops,
9627 const char *exec_file,
9628 const std::string &args,
9629 char **env, int from_tty)
9633 struct remote_state *rs = get_remote_state ();
9634 const char *remote_exec_file = get_remote_exec_file ();
9636 /* If running asynchronously, register the target file descriptor
9637 with the event loop. */
9638 if (target_can_async_p ())
9641 /* Disable address space randomization if requested (and supported). */
9642 if (extended_remote_supports_disable_randomization (ops))
9643 extended_remote_disable_randomization (disable_randomization);
9645 /* If startup-with-shell is on, we inform gdbserver to start the
9646 remote inferior using a shell. */
9647 if (packet_support (PACKET_QStartupWithShell) != PACKET_DISABLE)
9649 xsnprintf (rs->buf, get_remote_packet_size (),
9650 "QStartupWithShell:%d", startup_with_shell ? 1 : 0);
9652 getpkt (&rs->buf, &rs->buf_size, 0);
9653 if (strcmp (rs->buf, "OK") != 0)
9655 Remote replied unexpectedly while setting startup-with-shell: %s"),
9659 extended_remote_environment_support (rs);
9661 /* Now restart the remote server. */
9662 run_worked = extended_remote_run (args) != -1;
9665 /* vRun was not supported. Fail if we need it to do what the
9667 if (remote_exec_file[0])
9668 error (_("Remote target does not support \"set remote exec-file\""));
9670 error (_("Remote target does not support \"set args\" or run <ARGS>"));
9672 /* Fall back to "R". */
9673 extended_remote_restart ();
9676 if (!have_inferiors ())
9678 /* Clean up from the last time we ran, before we mark the target
9679 running again. This will mark breakpoints uninserted, and
9680 get_offsets may insert breakpoints. */
9681 init_thread_list ();
9682 init_wait_for_inferior ();
9685 /* vRun's success return is a stop reply. */
9686 stop_reply = run_worked ? rs->buf : NULL;
9687 add_current_inferior_and_thread (stop_reply);
9689 /* Get updated offsets, if the stub uses qOffsets. */
9694 /* Given a location's target info BP_TGT and the packet buffer BUF, output
9695 the list of conditions (in agent expression bytecode format), if any, the
9696 target needs to evaluate. The output is placed into the packet buffer
9697 started from BUF and ended at BUF_END. */
9700 remote_add_target_side_condition (struct gdbarch *gdbarch,
9701 struct bp_target_info *bp_tgt, char *buf,
9704 if (bp_tgt->conditions.empty ())
9707 buf += strlen (buf);
9708 xsnprintf (buf, buf_end - buf, "%s", ";");
9711 /* Send conditions to the target. */
9712 for (agent_expr *aexpr : bp_tgt->conditions)
9714 xsnprintf (buf, buf_end - buf, "X%x,", aexpr->len);
9715 buf += strlen (buf);
9716 for (int i = 0; i < aexpr->len; ++i)
9717 buf = pack_hex_byte (buf, aexpr->buf[i]);
9724 remote_add_target_side_commands (struct gdbarch *gdbarch,
9725 struct bp_target_info *bp_tgt, char *buf)
9727 if (bp_tgt->tcommands.empty ())
9730 buf += strlen (buf);
9732 sprintf (buf, ";cmds:%x,", bp_tgt->persist);
9733 buf += strlen (buf);
9735 /* Concatenate all the agent expressions that are commands into the
9737 for (agent_expr *aexpr : bp_tgt->tcommands)
9739 sprintf (buf, "X%x,", aexpr->len);
9740 buf += strlen (buf);
9741 for (int i = 0; i < aexpr->len; ++i)
9742 buf = pack_hex_byte (buf, aexpr->buf[i]);
9747 /* Insert a breakpoint. On targets that have software breakpoint
9748 support, we ask the remote target to do the work; on targets
9749 which don't, we insert a traditional memory breakpoint. */
9752 remote_insert_breakpoint (struct target_ops *ops,
9753 struct gdbarch *gdbarch,
9754 struct bp_target_info *bp_tgt)
9756 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
9757 If it succeeds, then set the support to PACKET_ENABLE. If it
9758 fails, and the user has explicitly requested the Z support then
9759 report an error, otherwise, mark it disabled and go on. */
9761 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
9763 CORE_ADDR addr = bp_tgt->reqstd_address;
9764 struct remote_state *rs;
9768 /* Make sure the remote is pointing at the right process, if
9770 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9771 set_general_process ();
9773 rs = get_remote_state ();
9775 endbuf = rs->buf + get_remote_packet_size ();
9780 addr = (ULONGEST) remote_address_masked (addr);
9781 p += hexnumstr (p, addr);
9782 xsnprintf (p, endbuf - p, ",%d", bp_tgt->kind);
9784 if (remote_supports_cond_breakpoints (ops))
9785 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
9787 if (remote_can_run_breakpoint_commands (ops))
9788 remote_add_target_side_commands (gdbarch, bp_tgt, p);
9791 getpkt (&rs->buf, &rs->buf_size, 0);
9793 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0]))
9799 case PACKET_UNKNOWN:
9804 /* If this breakpoint has target-side commands but this stub doesn't
9805 support Z0 packets, throw error. */
9806 if (!bp_tgt->tcommands.empty ())
9807 throw_error (NOT_SUPPORTED_ERROR, _("\
9808 Target doesn't support breakpoints that have target side commands."));
9810 return memory_insert_breakpoint (ops, gdbarch, bp_tgt);
9814 remote_remove_breakpoint (struct target_ops *ops,
9815 struct gdbarch *gdbarch,
9816 struct bp_target_info *bp_tgt,
9817 enum remove_bp_reason reason)
9819 CORE_ADDR addr = bp_tgt->placed_address;
9820 struct remote_state *rs = get_remote_state ();
9822 if (packet_support (PACKET_Z0) != PACKET_DISABLE)
9825 char *endbuf = rs->buf + get_remote_packet_size ();
9827 /* Make sure the remote is pointing at the right process, if
9829 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9830 set_general_process ();
9836 addr = (ULONGEST) remote_address_masked (bp_tgt->placed_address);
9837 p += hexnumstr (p, addr);
9838 xsnprintf (p, endbuf - p, ",%d", bp_tgt->kind);
9841 getpkt (&rs->buf, &rs->buf_size, 0);
9843 return (rs->buf[0] == 'E');
9846 return memory_remove_breakpoint (ops, gdbarch, bp_tgt, reason);
9849 static enum Z_packet_type
9850 watchpoint_to_Z_packet (int type)
9855 return Z_PACKET_WRITE_WP;
9858 return Z_PACKET_READ_WP;
9861 return Z_PACKET_ACCESS_WP;
9864 internal_error (__FILE__, __LINE__,
9865 _("hw_bp_to_z: bad watchpoint type %d"), type);
9870 remote_insert_watchpoint (struct target_ops *self, CORE_ADDR addr, int len,
9871 enum target_hw_bp_type type, struct expression *cond)
9873 struct remote_state *rs = get_remote_state ();
9874 char *endbuf = rs->buf + get_remote_packet_size ();
9876 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
9878 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
9881 /* Make sure the remote is pointing at the right process, if
9883 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9884 set_general_process ();
9886 xsnprintf (rs->buf, endbuf - rs->buf, "Z%x,", packet);
9887 p = strchr (rs->buf, '\0');
9888 addr = remote_address_masked (addr);
9889 p += hexnumstr (p, (ULONGEST) addr);
9890 xsnprintf (p, endbuf - p, ",%x", len);
9893 getpkt (&rs->buf, &rs->buf_size, 0);
9895 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
9899 case PACKET_UNKNOWN:
9904 internal_error (__FILE__, __LINE__,
9905 _("remote_insert_watchpoint: reached end of function"));
9909 remote_watchpoint_addr_within_range (struct target_ops *target, CORE_ADDR addr,
9910 CORE_ADDR start, int length)
9912 CORE_ADDR diff = remote_address_masked (addr - start);
9914 return diff < length;
9919 remote_remove_watchpoint (struct target_ops *self, CORE_ADDR addr, int len,
9920 enum target_hw_bp_type type, struct expression *cond)
9922 struct remote_state *rs = get_remote_state ();
9923 char *endbuf = rs->buf + get_remote_packet_size ();
9925 enum Z_packet_type packet = watchpoint_to_Z_packet (type);
9927 if (packet_support (PACKET_Z0 + packet) == PACKET_DISABLE)
9930 /* Make sure the remote is pointing at the right process, if
9932 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
9933 set_general_process ();
9935 xsnprintf (rs->buf, endbuf - rs->buf, "z%x,", packet);
9936 p = strchr (rs->buf, '\0');
9937 addr = remote_address_masked (addr);
9938 p += hexnumstr (p, (ULONGEST) addr);
9939 xsnprintf (p, endbuf - p, ",%x", len);
9941 getpkt (&rs->buf, &rs->buf_size, 0);
9943 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z0 + packet]))
9946 case PACKET_UNKNOWN:
9951 internal_error (__FILE__, __LINE__,
9952 _("remote_remove_watchpoint: reached end of function"));
9956 int remote_hw_watchpoint_limit = -1;
9957 int remote_hw_watchpoint_length_limit = -1;
9958 int remote_hw_breakpoint_limit = -1;
9961 remote_region_ok_for_hw_watchpoint (struct target_ops *self,
9962 CORE_ADDR addr, int len)
9964 if (remote_hw_watchpoint_length_limit == 0)
9966 else if (remote_hw_watchpoint_length_limit < 0)
9968 else if (len <= remote_hw_watchpoint_length_limit)
9975 remote_check_watch_resources (struct target_ops *self,
9976 enum bptype type, int cnt, int ot)
9978 if (type == bp_hardware_breakpoint)
9980 if (remote_hw_breakpoint_limit == 0)
9982 else if (remote_hw_breakpoint_limit < 0)
9984 else if (cnt <= remote_hw_breakpoint_limit)
9989 if (remote_hw_watchpoint_limit == 0)
9991 else if (remote_hw_watchpoint_limit < 0)
9995 else if (cnt <= remote_hw_watchpoint_limit)
10001 /* The to_stopped_by_sw_breakpoint method of target remote. */
10004 remote_stopped_by_sw_breakpoint (struct target_ops *ops)
10006 struct thread_info *thread = inferior_thread ();
10008 return (thread->priv != NULL
10009 && thread->priv->stop_reason == TARGET_STOPPED_BY_SW_BREAKPOINT);
10012 /* The to_supports_stopped_by_sw_breakpoint method of target
10016 remote_supports_stopped_by_sw_breakpoint (struct target_ops *ops)
10018 return (packet_support (PACKET_swbreak_feature) == PACKET_ENABLE);
10021 /* The to_stopped_by_hw_breakpoint method of target remote. */
10024 remote_stopped_by_hw_breakpoint (struct target_ops *ops)
10026 struct thread_info *thread = inferior_thread ();
10028 return (thread->priv != NULL
10029 && thread->priv->stop_reason == TARGET_STOPPED_BY_HW_BREAKPOINT);
10032 /* The to_supports_stopped_by_hw_breakpoint method of target
10036 remote_supports_stopped_by_hw_breakpoint (struct target_ops *ops)
10038 return (packet_support (PACKET_hwbreak_feature) == PACKET_ENABLE);
10042 remote_stopped_by_watchpoint (struct target_ops *ops)
10044 struct thread_info *thread = inferior_thread ();
10046 return (thread->priv != NULL
10047 && thread->priv->stop_reason == TARGET_STOPPED_BY_WATCHPOINT);
10051 remote_stopped_data_address (struct target_ops *target, CORE_ADDR *addr_p)
10053 struct thread_info *thread = inferior_thread ();
10055 if (thread->priv != NULL
10056 && thread->priv->stop_reason == TARGET_STOPPED_BY_WATCHPOINT)
10058 *addr_p = thread->priv->watch_data_address;
10067 remote_insert_hw_breakpoint (struct target_ops *self, struct gdbarch *gdbarch,
10068 struct bp_target_info *bp_tgt)
10070 CORE_ADDR addr = bp_tgt->reqstd_address;
10071 struct remote_state *rs;
10075 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
10078 /* Make sure the remote is pointing at the right process, if
10080 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10081 set_general_process ();
10083 rs = get_remote_state ();
10085 endbuf = rs->buf + get_remote_packet_size ();
10091 addr = remote_address_masked (addr);
10092 p += hexnumstr (p, (ULONGEST) addr);
10093 xsnprintf (p, endbuf - p, ",%x", bp_tgt->kind);
10095 if (remote_supports_cond_breakpoints (self))
10096 remote_add_target_side_condition (gdbarch, bp_tgt, p, endbuf);
10098 if (remote_can_run_breakpoint_commands (self))
10099 remote_add_target_side_commands (gdbarch, bp_tgt, p);
10102 getpkt (&rs->buf, &rs->buf_size, 0);
10104 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
10107 if (rs->buf[1] == '.')
10109 message = strchr (rs->buf + 2, '.');
10111 error (_("Remote failure reply: %s"), message + 1);
10114 case PACKET_UNKNOWN:
10119 internal_error (__FILE__, __LINE__,
10120 _("remote_insert_hw_breakpoint: reached end of function"));
10125 remote_remove_hw_breakpoint (struct target_ops *self, struct gdbarch *gdbarch,
10126 struct bp_target_info *bp_tgt)
10129 struct remote_state *rs = get_remote_state ();
10131 char *endbuf = rs->buf + get_remote_packet_size ();
10133 if (packet_support (PACKET_Z1) == PACKET_DISABLE)
10136 /* Make sure the remote is pointing at the right process, if
10138 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10139 set_general_process ();
10145 addr = remote_address_masked (bp_tgt->placed_address);
10146 p += hexnumstr (p, (ULONGEST) addr);
10147 xsnprintf (p, endbuf - p, ",%x", bp_tgt->kind);
10150 getpkt (&rs->buf, &rs->buf_size, 0);
10152 switch (packet_ok (rs->buf, &remote_protocol_packets[PACKET_Z1]))
10155 case PACKET_UNKNOWN:
10160 internal_error (__FILE__, __LINE__,
10161 _("remote_remove_hw_breakpoint: reached end of function"));
10164 /* Verify memory using the "qCRC:" request. */
10167 remote_verify_memory (struct target_ops *ops,
10168 const gdb_byte *data, CORE_ADDR lma, ULONGEST size)
10170 struct remote_state *rs = get_remote_state ();
10171 unsigned long host_crc, target_crc;
10174 /* It doesn't make sense to use qCRC if the remote target is
10175 connected but not running. */
10176 if (target_has_execution && packet_support (PACKET_qCRC) != PACKET_DISABLE)
10178 enum packet_result result;
10180 /* Make sure the remote is pointing at the right process. */
10181 set_general_process ();
10183 /* FIXME: assumes lma can fit into long. */
10184 xsnprintf (rs->buf, get_remote_packet_size (), "qCRC:%lx,%lx",
10185 (long) lma, (long) size);
10188 /* Be clever; compute the host_crc before waiting for target
10190 host_crc = xcrc32 (data, size, 0xffffffff);
10192 getpkt (&rs->buf, &rs->buf_size, 0);
10194 result = packet_ok (rs->buf,
10195 &remote_protocol_packets[PACKET_qCRC]);
10196 if (result == PACKET_ERROR)
10198 else if (result == PACKET_OK)
10200 for (target_crc = 0, tmp = &rs->buf[1]; *tmp; tmp++)
10201 target_crc = target_crc * 16 + fromhex (*tmp);
10203 return (host_crc == target_crc);
10207 return simple_verify_memory (ops, data, lma, size);
10210 /* compare-sections command
10212 With no arguments, compares each loadable section in the exec bfd
10213 with the same memory range on the target, and reports mismatches.
10214 Useful for verifying the image on the target against the exec file. */
10217 compare_sections_command (char *args, int from_tty)
10220 struct cleanup *old_chain;
10221 gdb_byte *sectdata;
10222 const char *sectname;
10223 bfd_size_type size;
10226 int mismatched = 0;
10231 error (_("command cannot be used without an exec file"));
10233 /* Make sure the remote is pointing at the right process. */
10234 set_general_process ();
10236 if (args != NULL && strcmp (args, "-r") == 0)
10242 for (s = exec_bfd->sections; s; s = s->next)
10244 if (!(s->flags & SEC_LOAD))
10245 continue; /* Skip non-loadable section. */
10247 if (read_only && (s->flags & SEC_READONLY) == 0)
10248 continue; /* Skip writeable sections */
10250 size = bfd_get_section_size (s);
10252 continue; /* Skip zero-length section. */
10254 sectname = bfd_get_section_name (exec_bfd, s);
10255 if (args && strcmp (args, sectname) != 0)
10256 continue; /* Not the section selected by user. */
10258 matched = 1; /* Do this section. */
10261 sectdata = (gdb_byte *) xmalloc (size);
10262 old_chain = make_cleanup (xfree, sectdata);
10263 bfd_get_section_contents (exec_bfd, s, sectdata, 0, size);
10265 res = target_verify_memory (sectdata, lma, size);
10268 error (_("target memory fault, section %s, range %s -- %s"), sectname,
10269 paddress (target_gdbarch (), lma),
10270 paddress (target_gdbarch (), lma + size));
10272 printf_filtered ("Section %s, range %s -- %s: ", sectname,
10273 paddress (target_gdbarch (), lma),
10274 paddress (target_gdbarch (), lma + size));
10276 printf_filtered ("matched.\n");
10279 printf_filtered ("MIS-MATCHED!\n");
10283 do_cleanups (old_chain);
10285 if (mismatched > 0)
10286 warning (_("One or more sections of the target image does not match\n\
10287 the loaded file\n"));
10288 if (args && !matched)
10289 printf_filtered (_("No loaded section named '%s'.\n"), args);
10292 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
10293 into remote target. The number of bytes written to the remote
10294 target is returned, or -1 for error. */
10296 static enum target_xfer_status
10297 remote_write_qxfer (struct target_ops *ops, const char *object_name,
10298 const char *annex, const gdb_byte *writebuf,
10299 ULONGEST offset, LONGEST len, ULONGEST *xfered_len,
10300 struct packet_config *packet)
10304 struct remote_state *rs = get_remote_state ();
10305 int max_size = get_memory_write_packet_size ();
10307 if (packet->support == PACKET_DISABLE)
10308 return TARGET_XFER_E_IO;
10310 /* Insert header. */
10311 i = snprintf (rs->buf, max_size,
10312 "qXfer:%s:write:%s:%s:",
10313 object_name, annex ? annex : "",
10314 phex_nz (offset, sizeof offset));
10315 max_size -= (i + 1);
10317 /* Escape as much data as fits into rs->buf. */
10318 buf_len = remote_escape_output
10319 (writebuf, len, 1, (gdb_byte *) rs->buf + i, &max_size, max_size);
10321 if (putpkt_binary (rs->buf, i + buf_len) < 0
10322 || getpkt_sane (&rs->buf, &rs->buf_size, 0) < 0
10323 || packet_ok (rs->buf, packet) != PACKET_OK)
10324 return TARGET_XFER_E_IO;
10326 unpack_varlen_hex (rs->buf, &n);
10329 return TARGET_XFER_OK;
10332 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
10333 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
10334 number of bytes read is returned, or 0 for EOF, or -1 for error.
10335 The number of bytes read may be less than LEN without indicating an
10336 EOF. PACKET is checked and updated to indicate whether the remote
10337 target supports this object. */
10339 static enum target_xfer_status
10340 remote_read_qxfer (struct target_ops *ops, const char *object_name,
10342 gdb_byte *readbuf, ULONGEST offset, LONGEST len,
10343 ULONGEST *xfered_len,
10344 struct packet_config *packet)
10346 struct remote_state *rs = get_remote_state ();
10347 LONGEST i, n, packet_len;
10349 if (packet->support == PACKET_DISABLE)
10350 return TARGET_XFER_E_IO;
10352 /* Check whether we've cached an end-of-object packet that matches
10354 if (rs->finished_object)
10356 if (strcmp (object_name, rs->finished_object) == 0
10357 && strcmp (annex ? annex : "", rs->finished_annex) == 0
10358 && offset == rs->finished_offset)
10359 return TARGET_XFER_EOF;
10362 /* Otherwise, we're now reading something different. Discard
10364 xfree (rs->finished_object);
10365 xfree (rs->finished_annex);
10366 rs->finished_object = NULL;
10367 rs->finished_annex = NULL;
10370 /* Request only enough to fit in a single packet. The actual data
10371 may not, since we don't know how much of it will need to be escaped;
10372 the target is free to respond with slightly less data. We subtract
10373 five to account for the response type and the protocol frame. */
10374 n = std::min<LONGEST> (get_remote_packet_size () - 5, len);
10375 snprintf (rs->buf, get_remote_packet_size () - 4, "qXfer:%s:read:%s:%s,%s",
10376 object_name, annex ? annex : "",
10377 phex_nz (offset, sizeof offset),
10378 phex_nz (n, sizeof n));
10379 i = putpkt (rs->buf);
10381 return TARGET_XFER_E_IO;
10384 packet_len = getpkt_sane (&rs->buf, &rs->buf_size, 0);
10385 if (packet_len < 0 || packet_ok (rs->buf, packet) != PACKET_OK)
10386 return TARGET_XFER_E_IO;
10388 if (rs->buf[0] != 'l' && rs->buf[0] != 'm')
10389 error (_("Unknown remote qXfer reply: %s"), rs->buf);
10391 /* 'm' means there is (or at least might be) more data after this
10392 batch. That does not make sense unless there's at least one byte
10393 of data in this reply. */
10394 if (rs->buf[0] == 'm' && packet_len == 1)
10395 error (_("Remote qXfer reply contained no data."));
10397 /* Got some data. */
10398 i = remote_unescape_input ((gdb_byte *) rs->buf + 1,
10399 packet_len - 1, readbuf, n);
10401 /* 'l' is an EOF marker, possibly including a final block of data,
10402 or possibly empty. If we have the final block of a non-empty
10403 object, record this fact to bypass a subsequent partial read. */
10404 if (rs->buf[0] == 'l' && offset + i > 0)
10406 rs->finished_object = xstrdup (object_name);
10407 rs->finished_annex = xstrdup (annex ? annex : "");
10408 rs->finished_offset = offset + i;
10412 return TARGET_XFER_EOF;
10416 return TARGET_XFER_OK;
10420 static enum target_xfer_status
10421 remote_xfer_partial (struct target_ops *ops, enum target_object object,
10422 const char *annex, gdb_byte *readbuf,
10423 const gdb_byte *writebuf, ULONGEST offset, ULONGEST len,
10424 ULONGEST *xfered_len)
10426 struct remote_state *rs;
10430 int unit_size = gdbarch_addressable_memory_unit_size (target_gdbarch ());
10432 set_remote_traceframe ();
10433 set_general_thread (inferior_ptid);
10435 rs = get_remote_state ();
10437 /* Handle memory using the standard memory routines. */
10438 if (object == TARGET_OBJECT_MEMORY)
10440 /* If the remote target is connected but not running, we should
10441 pass this request down to a lower stratum (e.g. the executable
10443 if (!target_has_execution)
10444 return TARGET_XFER_EOF;
10446 if (writebuf != NULL)
10447 return remote_write_bytes (offset, writebuf, len, unit_size,
10450 return remote_read_bytes (ops, offset, readbuf, len, unit_size,
10454 /* Handle SPU memory using qxfer packets. */
10455 if (object == TARGET_OBJECT_SPU)
10458 return remote_read_qxfer (ops, "spu", annex, readbuf, offset, len,
10459 xfered_len, &remote_protocol_packets
10460 [PACKET_qXfer_spu_read]);
10462 return remote_write_qxfer (ops, "spu", annex, writebuf, offset, len,
10463 xfered_len, &remote_protocol_packets
10464 [PACKET_qXfer_spu_write]);
10467 /* Handle extra signal info using qxfer packets. */
10468 if (object == TARGET_OBJECT_SIGNAL_INFO)
10471 return remote_read_qxfer (ops, "siginfo", annex, readbuf, offset, len,
10472 xfered_len, &remote_protocol_packets
10473 [PACKET_qXfer_siginfo_read]);
10475 return remote_write_qxfer (ops, "siginfo", annex,
10476 writebuf, offset, len, xfered_len,
10477 &remote_protocol_packets
10478 [PACKET_qXfer_siginfo_write]);
10481 if (object == TARGET_OBJECT_STATIC_TRACE_DATA)
10484 return remote_read_qxfer (ops, "statictrace", annex,
10485 readbuf, offset, len, xfered_len,
10486 &remote_protocol_packets
10487 [PACKET_qXfer_statictrace_read]);
10489 return TARGET_XFER_E_IO;
10492 /* Only handle flash writes. */
10493 if (writebuf != NULL)
10497 case TARGET_OBJECT_FLASH:
10498 return remote_flash_write (ops, offset, len, xfered_len,
10502 return TARGET_XFER_E_IO;
10506 /* Map pre-existing objects onto letters. DO NOT do this for new
10507 objects!!! Instead specify new query packets. */
10510 case TARGET_OBJECT_AVR:
10514 case TARGET_OBJECT_AUXV:
10515 gdb_assert (annex == NULL);
10516 return remote_read_qxfer (ops, "auxv", annex, readbuf, offset, len,
10518 &remote_protocol_packets[PACKET_qXfer_auxv]);
10520 case TARGET_OBJECT_AVAILABLE_FEATURES:
10521 return remote_read_qxfer
10522 (ops, "features", annex, readbuf, offset, len, xfered_len,
10523 &remote_protocol_packets[PACKET_qXfer_features]);
10525 case TARGET_OBJECT_LIBRARIES:
10526 return remote_read_qxfer
10527 (ops, "libraries", annex, readbuf, offset, len, xfered_len,
10528 &remote_protocol_packets[PACKET_qXfer_libraries]);
10530 case TARGET_OBJECT_LIBRARIES_SVR4:
10531 return remote_read_qxfer
10532 (ops, "libraries-svr4", annex, readbuf, offset, len, xfered_len,
10533 &remote_protocol_packets[PACKET_qXfer_libraries_svr4]);
10535 case TARGET_OBJECT_MEMORY_MAP:
10536 gdb_assert (annex == NULL);
10537 return remote_read_qxfer (ops, "memory-map", annex, readbuf, offset, len,
10539 &remote_protocol_packets[PACKET_qXfer_memory_map]);
10541 case TARGET_OBJECT_OSDATA:
10542 /* Should only get here if we're connected. */
10543 gdb_assert (rs->remote_desc);
10544 return remote_read_qxfer
10545 (ops, "osdata", annex, readbuf, offset, len, xfered_len,
10546 &remote_protocol_packets[PACKET_qXfer_osdata]);
10548 case TARGET_OBJECT_THREADS:
10549 gdb_assert (annex == NULL);
10550 return remote_read_qxfer (ops, "threads", annex, readbuf, offset, len,
10552 &remote_protocol_packets[PACKET_qXfer_threads]);
10554 case TARGET_OBJECT_TRACEFRAME_INFO:
10555 gdb_assert (annex == NULL);
10556 return remote_read_qxfer
10557 (ops, "traceframe-info", annex, readbuf, offset, len, xfered_len,
10558 &remote_protocol_packets[PACKET_qXfer_traceframe_info]);
10560 case TARGET_OBJECT_FDPIC:
10561 return remote_read_qxfer (ops, "fdpic", annex, readbuf, offset, len,
10563 &remote_protocol_packets[PACKET_qXfer_fdpic]);
10565 case TARGET_OBJECT_OPENVMS_UIB:
10566 return remote_read_qxfer (ops, "uib", annex, readbuf, offset, len,
10568 &remote_protocol_packets[PACKET_qXfer_uib]);
10570 case TARGET_OBJECT_BTRACE:
10571 return remote_read_qxfer (ops, "btrace", annex, readbuf, offset, len,
10573 &remote_protocol_packets[PACKET_qXfer_btrace]);
10575 case TARGET_OBJECT_BTRACE_CONF:
10576 return remote_read_qxfer (ops, "btrace-conf", annex, readbuf, offset,
10578 &remote_protocol_packets[PACKET_qXfer_btrace_conf]);
10580 case TARGET_OBJECT_EXEC_FILE:
10581 return remote_read_qxfer (ops, "exec-file", annex, readbuf, offset,
10583 &remote_protocol_packets[PACKET_qXfer_exec_file]);
10586 return TARGET_XFER_E_IO;
10589 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
10590 large enough let the caller deal with it. */
10591 if (len < get_remote_packet_size ())
10592 return TARGET_XFER_E_IO;
10593 len = get_remote_packet_size ();
10595 /* Except for querying the minimum buffer size, target must be open. */
10596 if (!rs->remote_desc)
10597 error (_("remote query is only available after target open"));
10599 gdb_assert (annex != NULL);
10600 gdb_assert (readbuf != NULL);
10604 *p2++ = query_type;
10606 /* We used one buffer char for the remote protocol q command and
10607 another for the query type. As the remote protocol encapsulation
10608 uses 4 chars plus one extra in case we are debugging
10609 (remote_debug), we have PBUFZIZ - 7 left to pack the query
10612 while (annex[i] && (i < (get_remote_packet_size () - 8)))
10614 /* Bad caller may have sent forbidden characters. */
10615 gdb_assert (isprint (annex[i]) && annex[i] != '$' && annex[i] != '#');
10620 gdb_assert (annex[i] == '\0');
10622 i = putpkt (rs->buf);
10624 return TARGET_XFER_E_IO;
10626 getpkt (&rs->buf, &rs->buf_size, 0);
10627 strcpy ((char *) readbuf, rs->buf);
10629 *xfered_len = strlen ((char *) readbuf);
10630 return TARGET_XFER_OK;
10633 /* Implementation of to_get_memory_xfer_limit. */
10636 remote_get_memory_xfer_limit (struct target_ops *ops)
10638 return get_memory_write_packet_size ();
10642 remote_search_memory (struct target_ops* ops,
10643 CORE_ADDR start_addr, ULONGEST search_space_len,
10644 const gdb_byte *pattern, ULONGEST pattern_len,
10645 CORE_ADDR *found_addrp)
10647 int addr_size = gdbarch_addr_bit (target_gdbarch ()) / 8;
10648 struct remote_state *rs = get_remote_state ();
10649 int max_size = get_memory_write_packet_size ();
10650 struct packet_config *packet =
10651 &remote_protocol_packets[PACKET_qSearch_memory];
10652 /* Number of packet bytes used to encode the pattern;
10653 this could be more than PATTERN_LEN due to escape characters. */
10654 int escaped_pattern_len;
10655 /* Amount of pattern that was encodable in the packet. */
10656 int used_pattern_len;
10659 ULONGEST found_addr;
10661 /* Don't go to the target if we don't have to.
10662 This is done before checking packet->support to avoid the possibility that
10663 a success for this edge case means the facility works in general. */
10664 if (pattern_len > search_space_len)
10666 if (pattern_len == 0)
10668 *found_addrp = start_addr;
10672 /* If we already know the packet isn't supported, fall back to the simple
10673 way of searching memory. */
10675 if (packet_config_support (packet) == PACKET_DISABLE)
10677 /* Target doesn't provided special support, fall back and use the
10678 standard support (copy memory and do the search here). */
10679 return simple_search_memory (ops, start_addr, search_space_len,
10680 pattern, pattern_len, found_addrp);
10683 /* Make sure the remote is pointing at the right process. */
10684 set_general_process ();
10686 /* Insert header. */
10687 i = snprintf (rs->buf, max_size,
10688 "qSearch:memory:%s;%s;",
10689 phex_nz (start_addr, addr_size),
10690 phex_nz (search_space_len, sizeof (search_space_len)));
10691 max_size -= (i + 1);
10693 /* Escape as much data as fits into rs->buf. */
10694 escaped_pattern_len =
10695 remote_escape_output (pattern, pattern_len, 1, (gdb_byte *) rs->buf + i,
10696 &used_pattern_len, max_size);
10698 /* Bail if the pattern is too large. */
10699 if (used_pattern_len != pattern_len)
10700 error (_("Pattern is too large to transmit to remote target."));
10702 if (putpkt_binary (rs->buf, i + escaped_pattern_len) < 0
10703 || getpkt_sane (&rs->buf, &rs->buf_size, 0) < 0
10704 || packet_ok (rs->buf, packet) != PACKET_OK)
10706 /* The request may not have worked because the command is not
10707 supported. If so, fall back to the simple way. */
10708 if (packet->support == PACKET_DISABLE)
10710 return simple_search_memory (ops, start_addr, search_space_len,
10711 pattern, pattern_len, found_addrp);
10716 if (rs->buf[0] == '0')
10718 else if (rs->buf[0] == '1')
10721 if (rs->buf[1] != ',')
10722 error (_("Unknown qSearch:memory reply: %s"), rs->buf);
10723 unpack_varlen_hex (rs->buf + 2, &found_addr);
10724 *found_addrp = found_addr;
10727 error (_("Unknown qSearch:memory reply: %s"), rs->buf);
10733 remote_rcmd (struct target_ops *self, const char *command,
10734 struct ui_file *outbuf)
10736 struct remote_state *rs = get_remote_state ();
10739 if (!rs->remote_desc)
10740 error (_("remote rcmd is only available after target open"));
10742 /* Send a NULL command across as an empty command. */
10743 if (command == NULL)
10746 /* The query prefix. */
10747 strcpy (rs->buf, "qRcmd,");
10748 p = strchr (rs->buf, '\0');
10750 if ((strlen (rs->buf) + strlen (command) * 2 + 8/*misc*/)
10751 > get_remote_packet_size ())
10752 error (_("\"monitor\" command ``%s'' is too long."), command);
10754 /* Encode the actual command. */
10755 bin2hex ((const gdb_byte *) command, p, strlen (command));
10757 if (putpkt (rs->buf) < 0)
10758 error (_("Communication problem with target."));
10760 /* get/display the response */
10765 /* XXX - see also remote_get_noisy_reply(). */
10766 QUIT; /* Allow user to bail out with ^C. */
10768 if (getpkt_sane (&rs->buf, &rs->buf_size, 0) == -1)
10770 /* Timeout. Continue to (try to) read responses.
10771 This is better than stopping with an error, assuming the stub
10772 is still executing the (long) monitor command.
10773 If needed, the user can interrupt gdb using C-c, obtaining
10774 an effect similar to stop on timeout. */
10778 if (buf[0] == '\0')
10779 error (_("Target does not support this command."));
10780 if (buf[0] == 'O' && buf[1] != 'K')
10782 remote_console_output (buf + 1); /* 'O' message from stub. */
10785 if (strcmp (buf, "OK") == 0)
10787 if (strlen (buf) == 3 && buf[0] == 'E'
10788 && isdigit (buf[1]) && isdigit (buf[2]))
10790 error (_("Protocol error with Rcmd"));
10792 for (p = buf; p[0] != '\0' && p[1] != '\0'; p += 2)
10794 char c = (fromhex (p[0]) << 4) + fromhex (p[1]);
10796 fputc_unfiltered (c, outbuf);
10802 static VEC(mem_region_s) *
10803 remote_memory_map (struct target_ops *ops)
10805 VEC(mem_region_s) *result = NULL;
10806 char *text = target_read_stralloc (¤t_target,
10807 TARGET_OBJECT_MEMORY_MAP, NULL);
10811 struct cleanup *back_to = make_cleanup (xfree, text);
10813 result = parse_memory_map (text);
10814 do_cleanups (back_to);
10821 packet_command (char *args, int from_tty)
10823 struct remote_state *rs = get_remote_state ();
10825 if (!rs->remote_desc)
10826 error (_("command can only be used with remote target"));
10829 error (_("remote-packet command requires packet text as argument"));
10831 puts_filtered ("sending: ");
10832 print_packet (args);
10833 puts_filtered ("\n");
10836 getpkt (&rs->buf, &rs->buf_size, 0);
10837 puts_filtered ("received: ");
10838 print_packet (rs->buf);
10839 puts_filtered ("\n");
10843 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
10845 static void display_thread_info (struct gdb_ext_thread_info *info);
10847 static void threadset_test_cmd (char *cmd, int tty);
10849 static void threadalive_test (char *cmd, int tty);
10851 static void threadlist_test_cmd (char *cmd, int tty);
10853 int get_and_display_threadinfo (threadref *ref);
10855 static void threadinfo_test_cmd (char *cmd, int tty);
10857 static int thread_display_step (threadref *ref, void *context);
10859 static void threadlist_update_test_cmd (char *cmd, int tty);
10861 static void init_remote_threadtests (void);
10863 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
10866 threadset_test_cmd (char *cmd, int tty)
10868 int sample_thread = SAMPLE_THREAD;
10870 printf_filtered (_("Remote threadset test\n"));
10871 set_general_thread (sample_thread);
10876 threadalive_test (char *cmd, int tty)
10878 int sample_thread = SAMPLE_THREAD;
10879 int pid = ptid_get_pid (inferior_ptid);
10880 ptid_t ptid = ptid_build (pid, sample_thread, 0);
10882 if (remote_thread_alive (ptid))
10883 printf_filtered ("PASS: Thread alive test\n");
10885 printf_filtered ("FAIL: Thread alive test\n");
10888 void output_threadid (char *title, threadref *ref);
10891 output_threadid (char *title, threadref *ref)
10895 pack_threadid (&hexid[0], ref); /* Convert threead id into hex. */
10897 printf_filtered ("%s %s\n", title, (&hexid[0]));
10901 threadlist_test_cmd (char *cmd, int tty)
10904 threadref nextthread;
10905 int done, result_count;
10906 threadref threadlist[3];
10908 printf_filtered ("Remote Threadlist test\n");
10909 if (!remote_get_threadlist (startflag, &nextthread, 3, &done,
10910 &result_count, &threadlist[0]))
10911 printf_filtered ("FAIL: threadlist test\n");
10914 threadref *scan = threadlist;
10915 threadref *limit = scan + result_count;
10917 while (scan < limit)
10918 output_threadid (" thread ", scan++);
10923 display_thread_info (struct gdb_ext_thread_info *info)
10925 output_threadid ("Threadid: ", &info->threadid);
10926 printf_filtered ("Name: %s\n ", info->shortname);
10927 printf_filtered ("State: %s\n", info->display);
10928 printf_filtered ("other: %s\n\n", info->more_display);
10932 get_and_display_threadinfo (threadref *ref)
10936 struct gdb_ext_thread_info threadinfo;
10938 set = TAG_THREADID | TAG_EXISTS | TAG_THREADNAME
10939 | TAG_MOREDISPLAY | TAG_DISPLAY;
10940 if (0 != (result = remote_get_threadinfo (ref, set, &threadinfo)))
10941 display_thread_info (&threadinfo);
10946 threadinfo_test_cmd (char *cmd, int tty)
10948 int athread = SAMPLE_THREAD;
10952 int_to_threadref (&thread, athread);
10953 printf_filtered ("Remote Threadinfo test\n");
10954 if (!get_and_display_threadinfo (&thread))
10955 printf_filtered ("FAIL cannot get thread info\n");
10959 thread_display_step (threadref *ref, void *context)
10961 /* output_threadid(" threadstep ",ref); *//* simple test */
10962 return get_and_display_threadinfo (ref);
10966 threadlist_update_test_cmd (char *cmd, int tty)
10968 printf_filtered ("Remote Threadlist update test\n");
10969 remote_threadlist_iterator (thread_display_step, 0, CRAZY_MAX_THREADS);
10973 init_remote_threadtests (void)
10975 add_com ("tlist", class_obscure, threadlist_test_cmd,
10976 _("Fetch and print the remote list of "
10977 "thread identifiers, one pkt only"));
10978 add_com ("tinfo", class_obscure, threadinfo_test_cmd,
10979 _("Fetch and display info about one thread"));
10980 add_com ("tset", class_obscure, threadset_test_cmd,
10981 _("Test setting to a different thread"));
10982 add_com ("tupd", class_obscure, threadlist_update_test_cmd,
10983 _("Iterate through updating all remote thread info"));
10984 add_com ("talive", class_obscure, threadalive_test,
10985 _(" Remote thread alive test "));
10990 /* Convert a thread ID to a string. Returns the string in a static
10993 static const char *
10994 remote_pid_to_str (struct target_ops *ops, ptid_t ptid)
10996 static char buf[64];
10997 struct remote_state *rs = get_remote_state ();
10999 if (ptid_equal (ptid, null_ptid))
11000 return normal_pid_to_str (ptid);
11001 else if (ptid_is_pid (ptid))
11003 /* Printing an inferior target id. */
11005 /* When multi-process extensions are off, there's no way in the
11006 remote protocol to know the remote process id, if there's any
11007 at all. There's one exception --- when we're connected with
11008 target extended-remote, and we manually attached to a process
11009 with "attach PID". We don't record anywhere a flag that
11010 allows us to distinguish that case from the case of
11011 connecting with extended-remote and the stub already being
11012 attached to a process, and reporting yes to qAttached, hence
11013 no smart special casing here. */
11014 if (!remote_multi_process_p (rs))
11016 xsnprintf (buf, sizeof buf, "Remote target");
11020 return normal_pid_to_str (ptid);
11024 if (ptid_equal (magic_null_ptid, ptid))
11025 xsnprintf (buf, sizeof buf, "Thread <main>");
11026 else if (remote_multi_process_p (rs))
11027 if (ptid_get_lwp (ptid) == 0)
11028 return normal_pid_to_str (ptid);
11030 xsnprintf (buf, sizeof buf, "Thread %d.%ld",
11031 ptid_get_pid (ptid), ptid_get_lwp (ptid));
11033 xsnprintf (buf, sizeof buf, "Thread %ld",
11034 ptid_get_lwp (ptid));
11039 /* Get the address of the thread local variable in OBJFILE which is
11040 stored at OFFSET within the thread local storage for thread PTID. */
11043 remote_get_thread_local_address (struct target_ops *ops,
11044 ptid_t ptid, CORE_ADDR lm, CORE_ADDR offset)
11046 if (packet_support (PACKET_qGetTLSAddr) != PACKET_DISABLE)
11048 struct remote_state *rs = get_remote_state ();
11050 char *endp = rs->buf + get_remote_packet_size ();
11051 enum packet_result result;
11053 strcpy (p, "qGetTLSAddr:");
11055 p = write_ptid (p, endp, ptid);
11057 p += hexnumstr (p, offset);
11059 p += hexnumstr (p, lm);
11063 getpkt (&rs->buf, &rs->buf_size, 0);
11064 result = packet_ok (rs->buf,
11065 &remote_protocol_packets[PACKET_qGetTLSAddr]);
11066 if (result == PACKET_OK)
11070 unpack_varlen_hex (rs->buf, &result);
11073 else if (result == PACKET_UNKNOWN)
11074 throw_error (TLS_GENERIC_ERROR,
11075 _("Remote target doesn't support qGetTLSAddr packet"));
11077 throw_error (TLS_GENERIC_ERROR,
11078 _("Remote target failed to process qGetTLSAddr request"));
11081 throw_error (TLS_GENERIC_ERROR,
11082 _("TLS not supported or disabled on this target"));
11087 /* Provide thread local base, i.e. Thread Information Block address.
11088 Returns 1 if ptid is found and thread_local_base is non zero. */
11091 remote_get_tib_address (struct target_ops *self, ptid_t ptid, CORE_ADDR *addr)
11093 if (packet_support (PACKET_qGetTIBAddr) != PACKET_DISABLE)
11095 struct remote_state *rs = get_remote_state ();
11097 char *endp = rs->buf + get_remote_packet_size ();
11098 enum packet_result result;
11100 strcpy (p, "qGetTIBAddr:");
11102 p = write_ptid (p, endp, ptid);
11106 getpkt (&rs->buf, &rs->buf_size, 0);
11107 result = packet_ok (rs->buf,
11108 &remote_protocol_packets[PACKET_qGetTIBAddr]);
11109 if (result == PACKET_OK)
11113 unpack_varlen_hex (rs->buf, &result);
11115 *addr = (CORE_ADDR) result;
11118 else if (result == PACKET_UNKNOWN)
11119 error (_("Remote target doesn't support qGetTIBAddr packet"));
11121 error (_("Remote target failed to process qGetTIBAddr request"));
11124 error (_("qGetTIBAddr not supported or disabled on this target"));
11129 /* Support for inferring a target description based on the current
11130 architecture and the size of a 'g' packet. While the 'g' packet
11131 can have any size (since optional registers can be left off the
11132 end), some sizes are easily recognizable given knowledge of the
11133 approximate architecture. */
11135 struct remote_g_packet_guess
11138 const struct target_desc *tdesc;
11140 typedef struct remote_g_packet_guess remote_g_packet_guess_s;
11141 DEF_VEC_O(remote_g_packet_guess_s);
11143 struct remote_g_packet_data
11145 VEC(remote_g_packet_guess_s) *guesses;
11148 static struct gdbarch_data *remote_g_packet_data_handle;
11151 remote_g_packet_data_init (struct obstack *obstack)
11153 return OBSTACK_ZALLOC (obstack, struct remote_g_packet_data);
11157 register_remote_g_packet_guess (struct gdbarch *gdbarch, int bytes,
11158 const struct target_desc *tdesc)
11160 struct remote_g_packet_data *data
11161 = ((struct remote_g_packet_data *)
11162 gdbarch_data (gdbarch, remote_g_packet_data_handle));
11163 struct remote_g_packet_guess new_guess, *guess;
11166 gdb_assert (tdesc != NULL);
11169 VEC_iterate (remote_g_packet_guess_s, data->guesses, ix, guess);
11171 if (guess->bytes == bytes)
11172 internal_error (__FILE__, __LINE__,
11173 _("Duplicate g packet description added for size %d"),
11176 new_guess.bytes = bytes;
11177 new_guess.tdesc = tdesc;
11178 VEC_safe_push (remote_g_packet_guess_s, data->guesses, &new_guess);
11181 /* Return 1 if remote_read_description would do anything on this target
11182 and architecture, 0 otherwise. */
11185 remote_read_description_p (struct target_ops *target)
11187 struct remote_g_packet_data *data
11188 = ((struct remote_g_packet_data *)
11189 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle));
11191 if (!VEC_empty (remote_g_packet_guess_s, data->guesses))
11197 static const struct target_desc *
11198 remote_read_description (struct target_ops *target)
11200 struct remote_g_packet_data *data
11201 = ((struct remote_g_packet_data *)
11202 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle));
11204 /* Do not try this during initial connection, when we do not know
11205 whether there is a running but stopped thread. */
11206 if (!target_has_execution || ptid_equal (inferior_ptid, null_ptid))
11207 return target->beneath->to_read_description (target->beneath);
11209 if (!VEC_empty (remote_g_packet_guess_s, data->guesses))
11211 struct remote_g_packet_guess *guess;
11213 int bytes = send_g_packet ();
11216 VEC_iterate (remote_g_packet_guess_s, data->guesses, ix, guess);
11218 if (guess->bytes == bytes)
11219 return guess->tdesc;
11221 /* We discard the g packet. A minor optimization would be to
11222 hold on to it, and fill the register cache once we have selected
11223 an architecture, but it's too tricky to do safely. */
11226 return target->beneath->to_read_description (target->beneath);
11229 /* Remote file transfer support. This is host-initiated I/O, not
11230 target-initiated; for target-initiated, see remote-fileio.c. */
11232 /* If *LEFT is at least the length of STRING, copy STRING to
11233 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11234 decrease *LEFT. Otherwise raise an error. */
11237 remote_buffer_add_string (char **buffer, int *left, const char *string)
11239 int len = strlen (string);
11242 error (_("Packet too long for target."));
11244 memcpy (*buffer, string, len);
11248 /* NUL-terminate the buffer as a convenience, if there is
11254 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
11255 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11256 decrease *LEFT. Otherwise raise an error. */
11259 remote_buffer_add_bytes (char **buffer, int *left, const gdb_byte *bytes,
11262 if (2 * len > *left)
11263 error (_("Packet too long for target."));
11265 bin2hex (bytes, *buffer, len);
11266 *buffer += 2 * len;
11269 /* NUL-terminate the buffer as a convenience, if there is
11275 /* If *LEFT is large enough, convert VALUE to hex and add it to
11276 *BUFFER, update *BUFFER to point to the new end of the buffer, and
11277 decrease *LEFT. Otherwise raise an error. */
11280 remote_buffer_add_int (char **buffer, int *left, ULONGEST value)
11282 int len = hexnumlen (value);
11285 error (_("Packet too long for target."));
11287 hexnumstr (*buffer, value);
11291 /* NUL-terminate the buffer as a convenience, if there is
11297 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
11298 value, *REMOTE_ERRNO to the remote error number or zero if none
11299 was included, and *ATTACHMENT to point to the start of the annex
11300 if any. The length of the packet isn't needed here; there may
11301 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
11303 Return 0 if the packet could be parsed, -1 if it could not. If
11304 -1 is returned, the other variables may not be initialized. */
11307 remote_hostio_parse_result (char *buffer, int *retcode,
11308 int *remote_errno, char **attachment)
11313 *attachment = NULL;
11315 if (buffer[0] != 'F')
11319 *retcode = strtol (&buffer[1], &p, 16);
11320 if (errno != 0 || p == &buffer[1])
11323 /* Check for ",errno". */
11327 *remote_errno = strtol (p + 1, &p2, 16);
11328 if (errno != 0 || p + 1 == p2)
11333 /* Check for ";attachment". If there is no attachment, the
11334 packet should end here. */
11337 *attachment = p + 1;
11340 else if (*p == '\0')
11346 /* Send a prepared I/O packet to the target and read its response.
11347 The prepared packet is in the global RS->BUF before this function
11348 is called, and the answer is there when we return.
11350 COMMAND_BYTES is the length of the request to send, which may include
11351 binary data. WHICH_PACKET is the packet configuration to check
11352 before attempting a packet. If an error occurs, *REMOTE_ERRNO
11353 is set to the error number and -1 is returned. Otherwise the value
11354 returned by the function is returned.
11356 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
11357 attachment is expected; an error will be reported if there's a
11358 mismatch. If one is found, *ATTACHMENT will be set to point into
11359 the packet buffer and *ATTACHMENT_LEN will be set to the
11360 attachment's length. */
11363 remote_hostio_send_command (int command_bytes, int which_packet,
11364 int *remote_errno, char **attachment,
11365 int *attachment_len)
11367 struct remote_state *rs = get_remote_state ();
11368 int ret, bytes_read;
11369 char *attachment_tmp;
11371 if (!rs->remote_desc
11372 || packet_support (which_packet) == PACKET_DISABLE)
11374 *remote_errno = FILEIO_ENOSYS;
11378 putpkt_binary (rs->buf, command_bytes);
11379 bytes_read = getpkt_sane (&rs->buf, &rs->buf_size, 0);
11381 /* If it timed out, something is wrong. Don't try to parse the
11383 if (bytes_read < 0)
11385 *remote_errno = FILEIO_EINVAL;
11389 switch (packet_ok (rs->buf, &remote_protocol_packets[which_packet]))
11392 *remote_errno = FILEIO_EINVAL;
11394 case PACKET_UNKNOWN:
11395 *remote_errno = FILEIO_ENOSYS;
11401 if (remote_hostio_parse_result (rs->buf, &ret, remote_errno,
11404 *remote_errno = FILEIO_EINVAL;
11408 /* Make sure we saw an attachment if and only if we expected one. */
11409 if ((attachment_tmp == NULL && attachment != NULL)
11410 || (attachment_tmp != NULL && attachment == NULL))
11412 *remote_errno = FILEIO_EINVAL;
11416 /* If an attachment was found, it must point into the packet buffer;
11417 work out how many bytes there were. */
11418 if (attachment_tmp != NULL)
11420 *attachment = attachment_tmp;
11421 *attachment_len = bytes_read - (*attachment - rs->buf);
11427 /* Invalidate the readahead cache. */
11430 readahead_cache_invalidate (void)
11432 struct remote_state *rs = get_remote_state ();
11434 rs->readahead_cache.fd = -1;
11437 /* Invalidate the readahead cache if it is holding data for FD. */
11440 readahead_cache_invalidate_fd (int fd)
11442 struct remote_state *rs = get_remote_state ();
11444 if (rs->readahead_cache.fd == fd)
11445 rs->readahead_cache.fd = -1;
11448 /* Set the filesystem remote_hostio functions that take FILENAME
11449 arguments will use. Return 0 on success, or -1 if an error
11450 occurs (and set *REMOTE_ERRNO). */
11453 remote_hostio_set_filesystem (struct inferior *inf, int *remote_errno)
11455 struct remote_state *rs = get_remote_state ();
11456 int required_pid = (inf == NULL || inf->fake_pid_p) ? 0 : inf->pid;
11458 int left = get_remote_packet_size () - 1;
11462 if (packet_support (PACKET_vFile_setfs) == PACKET_DISABLE)
11465 if (rs->fs_pid != -1 && required_pid == rs->fs_pid)
11468 remote_buffer_add_string (&p, &left, "vFile:setfs:");
11470 xsnprintf (arg, sizeof (arg), "%x", required_pid);
11471 remote_buffer_add_string (&p, &left, arg);
11473 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_setfs,
11474 remote_errno, NULL, NULL);
11476 if (packet_support (PACKET_vFile_setfs) == PACKET_DISABLE)
11480 rs->fs_pid = required_pid;
11485 /* Implementation of to_fileio_open. */
11488 remote_hostio_open (struct target_ops *self,
11489 struct inferior *inf, const char *filename,
11490 int flags, int mode, int warn_if_slow,
11493 struct remote_state *rs = get_remote_state ();
11495 int left = get_remote_packet_size () - 1;
11499 static int warning_issued = 0;
11501 printf_unfiltered (_("Reading %s from remote target...\n"),
11504 if (!warning_issued)
11506 warning (_("File transfers from remote targets can be slow."
11507 " Use \"set sysroot\" to access files locally"
11509 warning_issued = 1;
11513 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
11516 remote_buffer_add_string (&p, &left, "vFile:open:");
11518 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
11519 strlen (filename));
11520 remote_buffer_add_string (&p, &left, ",");
11522 remote_buffer_add_int (&p, &left, flags);
11523 remote_buffer_add_string (&p, &left, ",");
11525 remote_buffer_add_int (&p, &left, mode);
11527 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_open,
11528 remote_errno, NULL, NULL);
11531 /* Implementation of to_fileio_pwrite. */
11534 remote_hostio_pwrite (struct target_ops *self,
11535 int fd, const gdb_byte *write_buf, int len,
11536 ULONGEST offset, int *remote_errno)
11538 struct remote_state *rs = get_remote_state ();
11540 int left = get_remote_packet_size ();
11543 readahead_cache_invalidate_fd (fd);
11545 remote_buffer_add_string (&p, &left, "vFile:pwrite:");
11547 remote_buffer_add_int (&p, &left, fd);
11548 remote_buffer_add_string (&p, &left, ",");
11550 remote_buffer_add_int (&p, &left, offset);
11551 remote_buffer_add_string (&p, &left, ",");
11553 p += remote_escape_output (write_buf, len, 1, (gdb_byte *) p, &out_len,
11554 get_remote_packet_size () - (p - rs->buf));
11556 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_pwrite,
11557 remote_errno, NULL, NULL);
11560 /* Helper for the implementation of to_fileio_pread. Read the file
11561 from the remote side with vFile:pread. */
11564 remote_hostio_pread_vFile (struct target_ops *self,
11565 int fd, gdb_byte *read_buf, int len,
11566 ULONGEST offset, int *remote_errno)
11568 struct remote_state *rs = get_remote_state ();
11571 int left = get_remote_packet_size ();
11572 int ret, attachment_len;
11575 remote_buffer_add_string (&p, &left, "vFile:pread:");
11577 remote_buffer_add_int (&p, &left, fd);
11578 remote_buffer_add_string (&p, &left, ",");
11580 remote_buffer_add_int (&p, &left, len);
11581 remote_buffer_add_string (&p, &left, ",");
11583 remote_buffer_add_int (&p, &left, offset);
11585 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_pread,
11586 remote_errno, &attachment,
11592 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
11594 if (read_len != ret)
11595 error (_("Read returned %d, but %d bytes."), ret, (int) read_len);
11600 /* Serve pread from the readahead cache. Returns number of bytes
11601 read, or 0 if the request can't be served from the cache. */
11604 remote_hostio_pread_from_cache (struct remote_state *rs,
11605 int fd, gdb_byte *read_buf, size_t len,
11608 struct readahead_cache *cache = &rs->readahead_cache;
11610 if (cache->fd == fd
11611 && cache->offset <= offset
11612 && offset < cache->offset + cache->bufsize)
11614 ULONGEST max = cache->offset + cache->bufsize;
11616 if (offset + len > max)
11617 len = max - offset;
11619 memcpy (read_buf, cache->buf + offset - cache->offset, len);
11626 /* Implementation of to_fileio_pread. */
11629 remote_hostio_pread (struct target_ops *self,
11630 int fd, gdb_byte *read_buf, int len,
11631 ULONGEST offset, int *remote_errno)
11634 struct remote_state *rs = get_remote_state ();
11635 struct readahead_cache *cache = &rs->readahead_cache;
11637 ret = remote_hostio_pread_from_cache (rs, fd, read_buf, len, offset);
11640 cache->hit_count++;
11643 fprintf_unfiltered (gdb_stdlog, "readahead cache hit %s\n",
11644 pulongest (cache->hit_count));
11648 cache->miss_count++;
11650 fprintf_unfiltered (gdb_stdlog, "readahead cache miss %s\n",
11651 pulongest (cache->miss_count));
11654 cache->offset = offset;
11655 cache->bufsize = get_remote_packet_size ();
11656 cache->buf = (gdb_byte *) xrealloc (cache->buf, cache->bufsize);
11658 ret = remote_hostio_pread_vFile (self, cache->fd, cache->buf, cache->bufsize,
11659 cache->offset, remote_errno);
11662 readahead_cache_invalidate_fd (fd);
11666 cache->bufsize = ret;
11667 return remote_hostio_pread_from_cache (rs, fd, read_buf, len, offset);
11670 /* Implementation of to_fileio_close. */
11673 remote_hostio_close (struct target_ops *self, int fd, int *remote_errno)
11675 struct remote_state *rs = get_remote_state ();
11677 int left = get_remote_packet_size () - 1;
11679 readahead_cache_invalidate_fd (fd);
11681 remote_buffer_add_string (&p, &left, "vFile:close:");
11683 remote_buffer_add_int (&p, &left, fd);
11685 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_close,
11686 remote_errno, NULL, NULL);
11689 /* Implementation of to_fileio_unlink. */
11692 remote_hostio_unlink (struct target_ops *self,
11693 struct inferior *inf, const char *filename,
11696 struct remote_state *rs = get_remote_state ();
11698 int left = get_remote_packet_size () - 1;
11700 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
11703 remote_buffer_add_string (&p, &left, "vFile:unlink:");
11705 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
11706 strlen (filename));
11708 return remote_hostio_send_command (p - rs->buf, PACKET_vFile_unlink,
11709 remote_errno, NULL, NULL);
11712 /* Implementation of to_fileio_readlink. */
11715 remote_hostio_readlink (struct target_ops *self,
11716 struct inferior *inf, const char *filename,
11719 struct remote_state *rs = get_remote_state ();
11722 int left = get_remote_packet_size ();
11723 int len, attachment_len;
11727 if (remote_hostio_set_filesystem (inf, remote_errno) != 0)
11730 remote_buffer_add_string (&p, &left, "vFile:readlink:");
11732 remote_buffer_add_bytes (&p, &left, (const gdb_byte *) filename,
11733 strlen (filename));
11735 len = remote_hostio_send_command (p - rs->buf, PACKET_vFile_readlink,
11736 remote_errno, &attachment,
11742 ret = (char *) xmalloc (len + 1);
11744 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
11745 (gdb_byte *) ret, len);
11746 if (read_len != len)
11747 error (_("Readlink returned %d, but %d bytes."), len, read_len);
11753 /* Implementation of to_fileio_fstat. */
11756 remote_hostio_fstat (struct target_ops *self,
11757 int fd, struct stat *st,
11760 struct remote_state *rs = get_remote_state ();
11762 int left = get_remote_packet_size ();
11763 int attachment_len, ret;
11765 struct fio_stat fst;
11768 remote_buffer_add_string (&p, &left, "vFile:fstat:");
11770 remote_buffer_add_int (&p, &left, fd);
11772 ret = remote_hostio_send_command (p - rs->buf, PACKET_vFile_fstat,
11773 remote_errno, &attachment,
11777 if (*remote_errno != FILEIO_ENOSYS)
11780 /* Strictly we should return -1, ENOSYS here, but when
11781 "set sysroot remote:" was implemented in August 2008
11782 BFD's need for a stat function was sidestepped with
11783 this hack. This was not remedied until March 2015
11784 so we retain the previous behavior to avoid breaking
11787 Note that the memset is a March 2015 addition; older
11788 GDBs set st_size *and nothing else* so the structure
11789 would have garbage in all other fields. This might
11790 break something but retaining the previous behavior
11791 here would be just too wrong. */
11793 memset (st, 0, sizeof (struct stat));
11794 st->st_size = INT_MAX;
11798 read_len = remote_unescape_input ((gdb_byte *) attachment, attachment_len,
11799 (gdb_byte *) &fst, sizeof (fst));
11801 if (read_len != ret)
11802 error (_("vFile:fstat returned %d, but %d bytes."), ret, read_len);
11804 if (read_len != sizeof (fst))
11805 error (_("vFile:fstat returned %d bytes, but expecting %d."),
11806 read_len, (int) sizeof (fst));
11808 remote_fileio_to_host_stat (&fst, st);
11813 /* Implementation of to_filesystem_is_local. */
11816 remote_filesystem_is_local (struct target_ops *self)
11818 /* Valgrind GDB presents itself as a remote target but works
11819 on the local filesystem: it does not implement remote get
11820 and users are not expected to set a sysroot. To handle
11821 this case we treat the remote filesystem as local if the
11822 sysroot is exactly TARGET_SYSROOT_PREFIX and if the stub
11823 does not support vFile:open. */
11824 if (strcmp (gdb_sysroot, TARGET_SYSROOT_PREFIX) == 0)
11826 enum packet_support ps = packet_support (PACKET_vFile_open);
11828 if (ps == PACKET_SUPPORT_UNKNOWN)
11830 int fd, remote_errno;
11832 /* Try opening a file to probe support. The supplied
11833 filename is irrelevant, we only care about whether
11834 the stub recognizes the packet or not. */
11835 fd = remote_hostio_open (self, NULL, "just probing",
11836 FILEIO_O_RDONLY, 0700, 0,
11840 remote_hostio_close (self, fd, &remote_errno);
11842 ps = packet_support (PACKET_vFile_open);
11845 if (ps == PACKET_DISABLE)
11847 static int warning_issued = 0;
11849 if (!warning_issued)
11851 warning (_("remote target does not support file"
11852 " transfer, attempting to access files"
11853 " from local filesystem."));
11854 warning_issued = 1;
11865 remote_fileio_errno_to_host (int errnum)
11871 case FILEIO_ENOENT:
11879 case FILEIO_EACCES:
11881 case FILEIO_EFAULT:
11885 case FILEIO_EEXIST:
11887 case FILEIO_ENODEV:
11889 case FILEIO_ENOTDIR:
11891 case FILEIO_EISDIR:
11893 case FILEIO_EINVAL:
11895 case FILEIO_ENFILE:
11897 case FILEIO_EMFILE:
11901 case FILEIO_ENOSPC:
11903 case FILEIO_ESPIPE:
11907 case FILEIO_ENOSYS:
11909 case FILEIO_ENAMETOOLONG:
11910 return ENAMETOOLONG;
11916 remote_hostio_error (int errnum)
11918 int host_error = remote_fileio_errno_to_host (errnum);
11920 if (host_error == -1)
11921 error (_("Unknown remote I/O error %d"), errnum);
11923 error (_("Remote I/O error: %s"), safe_strerror (host_error));
11927 remote_hostio_close_cleanup (void *opaque)
11929 int fd = *(int *) opaque;
11932 remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno);
11936 remote_file_put (const char *local_file, const char *remote_file, int from_tty)
11938 struct cleanup *back_to, *close_cleanup;
11939 int retcode, fd, remote_errno, bytes, io_size;
11941 int bytes_in_buffer;
11944 struct remote_state *rs = get_remote_state ();
11946 if (!rs->remote_desc)
11947 error (_("command can only be used with remote target"));
11949 gdb_file_up file = gdb_fopen_cloexec (local_file, "rb");
11951 perror_with_name (local_file);
11953 fd = remote_hostio_open (find_target_at (process_stratum), NULL,
11954 remote_file, (FILEIO_O_WRONLY | FILEIO_O_CREAT
11956 0700, 0, &remote_errno);
11958 remote_hostio_error (remote_errno);
11960 /* Send up to this many bytes at once. They won't all fit in the
11961 remote packet limit, so we'll transfer slightly fewer. */
11962 io_size = get_remote_packet_size ();
11963 buffer = (gdb_byte *) xmalloc (io_size);
11964 back_to = make_cleanup (xfree, buffer);
11966 close_cleanup = make_cleanup (remote_hostio_close_cleanup, &fd);
11968 bytes_in_buffer = 0;
11971 while (bytes_in_buffer || !saw_eof)
11975 bytes = fread (buffer + bytes_in_buffer, 1,
11976 io_size - bytes_in_buffer,
11980 if (ferror (file.get ()))
11981 error (_("Error reading %s."), local_file);
11984 /* EOF. Unless there is something still in the
11985 buffer from the last iteration, we are done. */
11987 if (bytes_in_buffer == 0)
11995 bytes += bytes_in_buffer;
11996 bytes_in_buffer = 0;
11998 retcode = remote_hostio_pwrite (find_target_at (process_stratum),
12000 offset, &remote_errno);
12003 remote_hostio_error (remote_errno);
12004 else if (retcode == 0)
12005 error (_("Remote write of %d bytes returned 0!"), bytes);
12006 else if (retcode < bytes)
12008 /* Short write. Save the rest of the read data for the next
12010 bytes_in_buffer = bytes - retcode;
12011 memmove (buffer, buffer + retcode, bytes_in_buffer);
12017 discard_cleanups (close_cleanup);
12018 if (remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno))
12019 remote_hostio_error (remote_errno);
12022 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file);
12023 do_cleanups (back_to);
12027 remote_file_get (const char *remote_file, const char *local_file, int from_tty)
12029 struct cleanup *back_to, *close_cleanup;
12030 int fd, remote_errno, bytes, io_size;
12033 struct remote_state *rs = get_remote_state ();
12035 if (!rs->remote_desc)
12036 error (_("command can only be used with remote target"));
12038 fd = remote_hostio_open (find_target_at (process_stratum), NULL,
12039 remote_file, FILEIO_O_RDONLY, 0, 0,
12042 remote_hostio_error (remote_errno);
12044 gdb_file_up file = gdb_fopen_cloexec (local_file, "wb");
12046 perror_with_name (local_file);
12048 /* Send up to this many bytes at once. They won't all fit in the
12049 remote packet limit, so we'll transfer slightly fewer. */
12050 io_size = get_remote_packet_size ();
12051 buffer = (gdb_byte *) xmalloc (io_size);
12052 back_to = make_cleanup (xfree, buffer);
12054 close_cleanup = make_cleanup (remote_hostio_close_cleanup, &fd);
12059 bytes = remote_hostio_pread (find_target_at (process_stratum),
12060 fd, buffer, io_size, offset, &remote_errno);
12062 /* Success, but no bytes, means end-of-file. */
12065 remote_hostio_error (remote_errno);
12069 bytes = fwrite (buffer, 1, bytes, file.get ());
12071 perror_with_name (local_file);
12074 discard_cleanups (close_cleanup);
12075 if (remote_hostio_close (find_target_at (process_stratum), fd, &remote_errno))
12076 remote_hostio_error (remote_errno);
12079 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file);
12080 do_cleanups (back_to);
12084 remote_file_delete (const char *remote_file, int from_tty)
12086 int retcode, remote_errno;
12087 struct remote_state *rs = get_remote_state ();
12089 if (!rs->remote_desc)
12090 error (_("command can only be used with remote target"));
12092 retcode = remote_hostio_unlink (find_target_at (process_stratum),
12093 NULL, remote_file, &remote_errno);
12095 remote_hostio_error (remote_errno);
12098 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file);
12102 remote_put_command (char *args, int from_tty)
12105 error_no_arg (_("file to put"));
12107 gdb_argv argv (args);
12108 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
12109 error (_("Invalid parameters to remote put"));
12111 remote_file_put (argv[0], argv[1], from_tty);
12115 remote_get_command (char *args, int from_tty)
12118 error_no_arg (_("file to get"));
12120 gdb_argv argv (args);
12121 if (argv[0] == NULL || argv[1] == NULL || argv[2] != NULL)
12122 error (_("Invalid parameters to remote get"));
12124 remote_file_get (argv[0], argv[1], from_tty);
12128 remote_delete_command (char *args, int from_tty)
12131 error_no_arg (_("file to delete"));
12133 gdb_argv argv (args);
12134 if (argv[0] == NULL || argv[1] != NULL)
12135 error (_("Invalid parameters to remote delete"));
12137 remote_file_delete (argv[0], from_tty);
12141 remote_command (char *args, int from_tty)
12143 help_list (remote_cmdlist, "remote ", all_commands, gdb_stdout);
12147 remote_can_execute_reverse (struct target_ops *self)
12149 if (packet_support (PACKET_bs) == PACKET_ENABLE
12150 || packet_support (PACKET_bc) == PACKET_ENABLE)
12157 remote_supports_non_stop (struct target_ops *self)
12163 remote_supports_disable_randomization (struct target_ops *self)
12165 /* Only supported in extended mode. */
12170 remote_supports_multi_process (struct target_ops *self)
12172 struct remote_state *rs = get_remote_state ();
12174 return remote_multi_process_p (rs);
12178 remote_supports_cond_tracepoints (void)
12180 return packet_support (PACKET_ConditionalTracepoints) == PACKET_ENABLE;
12184 remote_supports_cond_breakpoints (struct target_ops *self)
12186 return packet_support (PACKET_ConditionalBreakpoints) == PACKET_ENABLE;
12190 remote_supports_fast_tracepoints (void)
12192 return packet_support (PACKET_FastTracepoints) == PACKET_ENABLE;
12196 remote_supports_static_tracepoints (void)
12198 return packet_support (PACKET_StaticTracepoints) == PACKET_ENABLE;
12202 remote_supports_install_in_trace (void)
12204 return packet_support (PACKET_InstallInTrace) == PACKET_ENABLE;
12208 remote_supports_enable_disable_tracepoint (struct target_ops *self)
12210 return (packet_support (PACKET_EnableDisableTracepoints_feature)
12215 remote_supports_string_tracing (struct target_ops *self)
12217 return packet_support (PACKET_tracenz_feature) == PACKET_ENABLE;
12221 remote_can_run_breakpoint_commands (struct target_ops *self)
12223 return packet_support (PACKET_BreakpointCommands) == PACKET_ENABLE;
12227 remote_trace_init (struct target_ops *self)
12230 remote_get_noisy_reply (&target_buf, &target_buf_size);
12231 if (strcmp (target_buf, "OK") != 0)
12232 error (_("Target does not support this command."));
12235 static void free_actions_list (char **actions_list);
12236 static void free_actions_list_cleanup_wrapper (void *);
12238 free_actions_list_cleanup_wrapper (void *al)
12240 free_actions_list ((char **) al);
12244 free_actions_list (char **actions_list)
12248 if (actions_list == 0)
12251 for (ndx = 0; actions_list[ndx]; ndx++)
12252 xfree (actions_list[ndx]);
12254 xfree (actions_list);
12257 /* Recursive routine to walk through command list including loops, and
12258 download packets for each command. */
12261 remote_download_command_source (int num, ULONGEST addr,
12262 struct command_line *cmds)
12264 struct remote_state *rs = get_remote_state ();
12265 struct command_line *cmd;
12267 for (cmd = cmds; cmd; cmd = cmd->next)
12269 QUIT; /* Allow user to bail out with ^C. */
12270 strcpy (rs->buf, "QTDPsrc:");
12271 encode_source_string (num, addr, "cmd", cmd->line,
12272 rs->buf + strlen (rs->buf),
12273 rs->buf_size - strlen (rs->buf));
12275 remote_get_noisy_reply (&target_buf, &target_buf_size);
12276 if (strcmp (target_buf, "OK"))
12277 warning (_("Target does not support source download."));
12279 if (cmd->control_type == while_control
12280 || cmd->control_type == while_stepping_control)
12282 remote_download_command_source (num, addr, *cmd->body_list);
12284 QUIT; /* Allow user to bail out with ^C. */
12285 strcpy (rs->buf, "QTDPsrc:");
12286 encode_source_string (num, addr, "cmd", "end",
12287 rs->buf + strlen (rs->buf),
12288 rs->buf_size - strlen (rs->buf));
12290 remote_get_noisy_reply (&target_buf, &target_buf_size);
12291 if (strcmp (target_buf, "OK"))
12292 warning (_("Target does not support source download."));
12298 remote_download_tracepoint (struct target_ops *self, struct bp_location *loc)
12300 #define BUF_SIZE 2048
12304 char buf[BUF_SIZE];
12305 char **tdp_actions;
12306 char **stepping_actions;
12308 struct cleanup *old_chain = NULL;
12310 struct breakpoint *b = loc->owner;
12311 struct tracepoint *t = (struct tracepoint *) b;
12313 encode_actions_rsp (loc, &tdp_actions, &stepping_actions);
12314 old_chain = make_cleanup (free_actions_list_cleanup_wrapper,
12316 (void) make_cleanup (free_actions_list_cleanup_wrapper,
12319 tpaddr = loc->address;
12320 sprintf_vma (addrbuf, tpaddr);
12321 xsnprintf (buf, BUF_SIZE, "QTDP:%x:%s:%c:%lx:%x", b->number,
12322 addrbuf, /* address */
12323 (b->enable_state == bp_enabled ? 'E' : 'D'),
12324 t->step_count, t->pass_count);
12325 /* Fast tracepoints are mostly handled by the target, but we can
12326 tell the target how big of an instruction block should be moved
12328 if (b->type == bp_fast_tracepoint)
12330 /* Only test for support at download time; we may not know
12331 target capabilities at definition time. */
12332 if (remote_supports_fast_tracepoints ())
12334 if (gdbarch_fast_tracepoint_valid_at (loc->gdbarch, tpaddr,
12336 xsnprintf (buf + strlen (buf), BUF_SIZE - strlen (buf), ":F%x",
12337 gdb_insn_length (loc->gdbarch, tpaddr));
12339 /* If it passed validation at definition but fails now,
12340 something is very wrong. */
12341 internal_error (__FILE__, __LINE__,
12342 _("Fast tracepoint not "
12343 "valid during download"));
12346 /* Fast tracepoints are functionally identical to regular
12347 tracepoints, so don't take lack of support as a reason to
12348 give up on the trace run. */
12349 warning (_("Target does not support fast tracepoints, "
12350 "downloading %d as regular tracepoint"), b->number);
12352 else if (b->type == bp_static_tracepoint)
12354 /* Only test for support at download time; we may not know
12355 target capabilities at definition time. */
12356 if (remote_supports_static_tracepoints ())
12358 struct static_tracepoint_marker marker;
12360 if (target_static_tracepoint_marker_at (tpaddr, &marker))
12361 strcat (buf, ":S");
12363 error (_("Static tracepoint not valid during download"));
12366 /* Fast tracepoints are functionally identical to regular
12367 tracepoints, so don't take lack of support as a reason
12368 to give up on the trace run. */
12369 error (_("Target does not support static tracepoints"));
12371 /* If the tracepoint has a conditional, make it into an agent
12372 expression and append to the definition. */
12375 /* Only test support at download time, we may not know target
12376 capabilities at definition time. */
12377 if (remote_supports_cond_tracepoints ())
12379 agent_expr_up aexpr = gen_eval_for_expr (tpaddr, loc->cond.get ());
12380 xsnprintf (buf + strlen (buf), BUF_SIZE - strlen (buf), ":X%x,",
12382 pkt = buf + strlen (buf);
12383 for (ndx = 0; ndx < aexpr->len; ++ndx)
12384 pkt = pack_hex_byte (pkt, aexpr->buf[ndx]);
12388 warning (_("Target does not support conditional tracepoints, "
12389 "ignoring tp %d cond"), b->number);
12392 if (b->commands || *default_collect)
12395 remote_get_noisy_reply (&target_buf, &target_buf_size);
12396 if (strcmp (target_buf, "OK"))
12397 error (_("Target does not support tracepoints."));
12399 /* do_single_steps (t); */
12402 for (ndx = 0; tdp_actions[ndx]; ndx++)
12404 QUIT; /* Allow user to bail out with ^C. */
12405 xsnprintf (buf, BUF_SIZE, "QTDP:-%x:%s:%s%c",
12406 b->number, addrbuf, /* address */
12408 ((tdp_actions[ndx + 1] || stepping_actions)
12411 remote_get_noisy_reply (&target_buf,
12413 if (strcmp (target_buf, "OK"))
12414 error (_("Error on target while setting tracepoints."));
12417 if (stepping_actions)
12419 for (ndx = 0; stepping_actions[ndx]; ndx++)
12421 QUIT; /* Allow user to bail out with ^C. */
12422 xsnprintf (buf, BUF_SIZE, "QTDP:-%x:%s:%s%s%s",
12423 b->number, addrbuf, /* address */
12424 ((ndx == 0) ? "S" : ""),
12425 stepping_actions[ndx],
12426 (stepping_actions[ndx + 1] ? "-" : ""));
12428 remote_get_noisy_reply (&target_buf,
12430 if (strcmp (target_buf, "OK"))
12431 error (_("Error on target while setting tracepoints."));
12435 if (packet_support (PACKET_TracepointSource) == PACKET_ENABLE)
12437 if (b->location != NULL)
12439 strcpy (buf, "QTDPsrc:");
12440 encode_source_string (b->number, loc->address, "at",
12441 event_location_to_string (b->location.get ()),
12442 buf + strlen (buf), 2048 - strlen (buf));
12444 remote_get_noisy_reply (&target_buf, &target_buf_size);
12445 if (strcmp (target_buf, "OK"))
12446 warning (_("Target does not support source download."));
12448 if (b->cond_string)
12450 strcpy (buf, "QTDPsrc:");
12451 encode_source_string (b->number, loc->address,
12452 "cond", b->cond_string, buf + strlen (buf),
12453 2048 - strlen (buf));
12455 remote_get_noisy_reply (&target_buf, &target_buf_size);
12456 if (strcmp (target_buf, "OK"))
12457 warning (_("Target does not support source download."));
12459 remote_download_command_source (b->number, loc->address,
12460 breakpoint_commands (b));
12463 do_cleanups (old_chain);
12467 remote_can_download_tracepoint (struct target_ops *self)
12469 struct remote_state *rs = get_remote_state ();
12470 struct trace_status *ts;
12473 /* Don't try to install tracepoints until we've relocated our
12474 symbols, and fetched and merged the target's tracepoint list with
12476 if (rs->starting_up)
12479 ts = current_trace_status ();
12480 status = remote_get_trace_status (self, ts);
12482 if (status == -1 || !ts->running_known || !ts->running)
12485 /* If we are in a tracing experiment, but remote stub doesn't support
12486 installing tracepoint in trace, we have to return. */
12487 if (!remote_supports_install_in_trace ())
12495 remote_download_trace_state_variable (struct target_ops *self,
12496 struct trace_state_variable *tsv)
12498 struct remote_state *rs = get_remote_state ();
12501 xsnprintf (rs->buf, get_remote_packet_size (), "QTDV:%x:%s:%x:",
12502 tsv->number, phex ((ULONGEST) tsv->initial_value, 8),
12504 p = rs->buf + strlen (rs->buf);
12505 if ((p - rs->buf) + strlen (tsv->name) * 2 >= get_remote_packet_size ())
12506 error (_("Trace state variable name too long for tsv definition packet"));
12507 p += 2 * bin2hex ((gdb_byte *) (tsv->name), p, strlen (tsv->name));
12510 remote_get_noisy_reply (&target_buf, &target_buf_size);
12511 if (*target_buf == '\0')
12512 error (_("Target does not support this command."));
12513 if (strcmp (target_buf, "OK") != 0)
12514 error (_("Error on target while downloading trace state variable."));
12518 remote_enable_tracepoint (struct target_ops *self,
12519 struct bp_location *location)
12521 struct remote_state *rs = get_remote_state ();
12524 sprintf_vma (addr_buf, location->address);
12525 xsnprintf (rs->buf, get_remote_packet_size (), "QTEnable:%x:%s",
12526 location->owner->number, addr_buf);
12528 remote_get_noisy_reply (&rs->buf, &rs->buf_size);
12529 if (*rs->buf == '\0')
12530 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
12531 if (strcmp (rs->buf, "OK") != 0)
12532 error (_("Error on target while enabling tracepoint."));
12536 remote_disable_tracepoint (struct target_ops *self,
12537 struct bp_location *location)
12539 struct remote_state *rs = get_remote_state ();
12542 sprintf_vma (addr_buf, location->address);
12543 xsnprintf (rs->buf, get_remote_packet_size (), "QTDisable:%x:%s",
12544 location->owner->number, addr_buf);
12546 remote_get_noisy_reply (&rs->buf, &rs->buf_size);
12547 if (*rs->buf == '\0')
12548 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
12549 if (strcmp (rs->buf, "OK") != 0)
12550 error (_("Error on target while disabling tracepoint."));
12554 remote_trace_set_readonly_regions (struct target_ops *self)
12558 bfd_size_type size;
12564 return; /* No information to give. */
12566 strcpy (target_buf, "QTro");
12567 offset = strlen (target_buf);
12568 for (s = exec_bfd->sections; s; s = s->next)
12570 char tmp1[40], tmp2[40];
12573 if ((s->flags & SEC_LOAD) == 0 ||
12574 /* (s->flags & SEC_CODE) == 0 || */
12575 (s->flags & SEC_READONLY) == 0)
12579 vma = bfd_get_section_vma (abfd, s);
12580 size = bfd_get_section_size (s);
12581 sprintf_vma (tmp1, vma);
12582 sprintf_vma (tmp2, vma + size);
12583 sec_length = 1 + strlen (tmp1) + 1 + strlen (tmp2);
12584 if (offset + sec_length + 1 > target_buf_size)
12586 if (packet_support (PACKET_qXfer_traceframe_info) != PACKET_ENABLE)
12588 Too many sections for read-only sections definition packet."));
12591 xsnprintf (target_buf + offset, target_buf_size - offset, ":%s,%s",
12593 offset += sec_length;
12597 putpkt (target_buf);
12598 getpkt (&target_buf, &target_buf_size, 0);
12603 remote_trace_start (struct target_ops *self)
12605 putpkt ("QTStart");
12606 remote_get_noisy_reply (&target_buf, &target_buf_size);
12607 if (*target_buf == '\0')
12608 error (_("Target does not support this command."));
12609 if (strcmp (target_buf, "OK") != 0)
12610 error (_("Bogus reply from target: %s"), target_buf);
12614 remote_get_trace_status (struct target_ops *self, struct trace_status *ts)
12616 /* Initialize it just to avoid a GCC false warning. */
12618 /* FIXME we need to get register block size some other way. */
12619 extern int trace_regblock_size;
12620 enum packet_result result;
12622 if (packet_support (PACKET_qTStatus) == PACKET_DISABLE)
12625 trace_regblock_size = get_remote_arch_state ()->sizeof_g_packet;
12627 putpkt ("qTStatus");
12631 p = remote_get_noisy_reply (&target_buf, &target_buf_size);
12633 CATCH (ex, RETURN_MASK_ERROR)
12635 if (ex.error != TARGET_CLOSE_ERROR)
12637 exception_fprintf (gdb_stderr, ex, "qTStatus: ");
12640 throw_exception (ex);
12644 result = packet_ok (p, &remote_protocol_packets[PACKET_qTStatus]);
12646 /* If the remote target doesn't do tracing, flag it. */
12647 if (result == PACKET_UNKNOWN)
12650 /* We're working with a live target. */
12651 ts->filename = NULL;
12654 error (_("Bogus trace status reply from target: %s"), target_buf);
12656 /* Function 'parse_trace_status' sets default value of each field of
12657 'ts' at first, so we don't have to do it here. */
12658 parse_trace_status (p, ts);
12660 return ts->running;
12664 remote_get_tracepoint_status (struct target_ops *self, struct breakpoint *bp,
12665 struct uploaded_tp *utp)
12667 struct remote_state *rs = get_remote_state ();
12669 struct bp_location *loc;
12670 struct tracepoint *tp = (struct tracepoint *) bp;
12671 size_t size = get_remote_packet_size ();
12676 tp->traceframe_usage = 0;
12677 for (loc = tp->loc; loc; loc = loc->next)
12679 /* If the tracepoint was never downloaded, don't go asking for
12681 if (tp->number_on_target == 0)
12683 xsnprintf (rs->buf, size, "qTP:%x:%s", tp->number_on_target,
12684 phex_nz (loc->address, 0));
12686 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12687 if (reply && *reply)
12690 parse_tracepoint_status (reply + 1, bp, utp);
12696 utp->hit_count = 0;
12697 utp->traceframe_usage = 0;
12698 xsnprintf (rs->buf, size, "qTP:%x:%s", utp->number,
12699 phex_nz (utp->addr, 0));
12701 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12702 if (reply && *reply)
12705 parse_tracepoint_status (reply + 1, bp, utp);
12711 remote_trace_stop (struct target_ops *self)
12714 remote_get_noisy_reply (&target_buf, &target_buf_size);
12715 if (*target_buf == '\0')
12716 error (_("Target does not support this command."));
12717 if (strcmp (target_buf, "OK") != 0)
12718 error (_("Bogus reply from target: %s"), target_buf);
12722 remote_trace_find (struct target_ops *self,
12723 enum trace_find_type type, int num,
12724 CORE_ADDR addr1, CORE_ADDR addr2,
12727 struct remote_state *rs = get_remote_state ();
12728 char *endbuf = rs->buf + get_remote_packet_size ();
12730 int target_frameno = -1, target_tracept = -1;
12732 /* Lookups other than by absolute frame number depend on the current
12733 trace selected, so make sure it is correct on the remote end
12735 if (type != tfind_number)
12736 set_remote_traceframe ();
12739 strcpy (p, "QTFrame:");
12740 p = strchr (p, '\0');
12744 xsnprintf (p, endbuf - p, "%x", num);
12747 xsnprintf (p, endbuf - p, "pc:%s", phex_nz (addr1, 0));
12750 xsnprintf (p, endbuf - p, "tdp:%x", num);
12753 xsnprintf (p, endbuf - p, "range:%s:%s", phex_nz (addr1, 0),
12754 phex_nz (addr2, 0));
12756 case tfind_outside:
12757 xsnprintf (p, endbuf - p, "outside:%s:%s", phex_nz (addr1, 0),
12758 phex_nz (addr2, 0));
12761 error (_("Unknown trace find type %d"), type);
12765 reply = remote_get_noisy_reply (&(rs->buf), &rs->buf_size);
12766 if (*reply == '\0')
12767 error (_("Target does not support this command."));
12769 while (reply && *reply)
12774 target_frameno = (int) strtol (p, &reply, 16);
12776 error (_("Unable to parse trace frame number"));
12777 /* Don't update our remote traceframe number cache on failure
12778 to select a remote traceframe. */
12779 if (target_frameno == -1)
12784 target_tracept = (int) strtol (p, &reply, 16);
12786 error (_("Unable to parse tracepoint number"));
12788 case 'O': /* "OK"? */
12789 if (reply[1] == 'K' && reply[2] == '\0')
12792 error (_("Bogus reply from target: %s"), reply);
12795 error (_("Bogus reply from target: %s"), reply);
12798 *tpp = target_tracept;
12800 rs->remote_traceframe_number = target_frameno;
12801 return target_frameno;
12805 remote_get_trace_state_variable_value (struct target_ops *self,
12806 int tsvnum, LONGEST *val)
12808 struct remote_state *rs = get_remote_state ();
12812 set_remote_traceframe ();
12814 xsnprintf (rs->buf, get_remote_packet_size (), "qTV:%x", tsvnum);
12816 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12817 if (reply && *reply)
12821 unpack_varlen_hex (reply + 1, &uval);
12822 *val = (LONGEST) uval;
12830 remote_save_trace_data (struct target_ops *self, const char *filename)
12832 struct remote_state *rs = get_remote_state ();
12836 strcpy (p, "QTSave:");
12838 if ((p - rs->buf) + strlen (filename) * 2 >= get_remote_packet_size ())
12839 error (_("Remote file name too long for trace save packet"));
12840 p += 2 * bin2hex ((gdb_byte *) filename, p, strlen (filename));
12843 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12844 if (*reply == '\0')
12845 error (_("Target does not support this command."));
12846 if (strcmp (reply, "OK") != 0)
12847 error (_("Bogus reply from target: %s"), reply);
12851 /* This is basically a memory transfer, but needs to be its own packet
12852 because we don't know how the target actually organizes its trace
12853 memory, plus we want to be able to ask for as much as possible, but
12854 not be unhappy if we don't get as much as we ask for. */
12857 remote_get_raw_trace_data (struct target_ops *self,
12858 gdb_byte *buf, ULONGEST offset, LONGEST len)
12860 struct remote_state *rs = get_remote_state ();
12866 strcpy (p, "qTBuffer:");
12868 p += hexnumstr (p, offset);
12870 p += hexnumstr (p, len);
12874 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12875 if (reply && *reply)
12877 /* 'l' by itself means we're at the end of the buffer and
12878 there is nothing more to get. */
12882 /* Convert the reply into binary. Limit the number of bytes to
12883 convert according to our passed-in buffer size, rather than
12884 what was returned in the packet; if the target is
12885 unexpectedly generous and gives us a bigger reply than we
12886 asked for, we don't want to crash. */
12887 rslt = hex2bin (target_buf, buf, len);
12891 /* Something went wrong, flag as an error. */
12896 remote_set_disconnected_tracing (struct target_ops *self, int val)
12898 struct remote_state *rs = get_remote_state ();
12900 if (packet_support (PACKET_DisconnectedTracing_feature) == PACKET_ENABLE)
12904 xsnprintf (rs->buf, get_remote_packet_size (), "QTDisconnected:%x", val);
12906 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12907 if (*reply == '\0')
12908 error (_("Target does not support this command."));
12909 if (strcmp (reply, "OK") != 0)
12910 error (_("Bogus reply from target: %s"), reply);
12913 warning (_("Target does not support disconnected tracing."));
12917 remote_core_of_thread (struct target_ops *ops, ptid_t ptid)
12919 struct thread_info *info = find_thread_ptid (ptid);
12921 if (info && info->priv)
12922 return info->priv->core;
12927 remote_set_circular_trace_buffer (struct target_ops *self, int val)
12929 struct remote_state *rs = get_remote_state ();
12932 xsnprintf (rs->buf, get_remote_packet_size (), "QTBuffer:circular:%x", val);
12934 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12935 if (*reply == '\0')
12936 error (_("Target does not support this command."));
12937 if (strcmp (reply, "OK") != 0)
12938 error (_("Bogus reply from target: %s"), reply);
12941 static struct traceframe_info *
12942 remote_traceframe_info (struct target_ops *self)
12946 text = target_read_stralloc (¤t_target,
12947 TARGET_OBJECT_TRACEFRAME_INFO, NULL);
12950 struct traceframe_info *info;
12951 struct cleanup *back_to = make_cleanup (xfree, text);
12953 info = parse_traceframe_info (text);
12954 do_cleanups (back_to);
12961 /* Handle the qTMinFTPILen packet. Returns the minimum length of
12962 instruction on which a fast tracepoint may be placed. Returns -1
12963 if the packet is not supported, and 0 if the minimum instruction
12964 length is unknown. */
12967 remote_get_min_fast_tracepoint_insn_len (struct target_ops *self)
12969 struct remote_state *rs = get_remote_state ();
12972 /* If we're not debugging a process yet, the IPA can't be
12974 if (!target_has_execution)
12977 /* Make sure the remote is pointing at the right process. */
12978 set_general_process ();
12980 xsnprintf (rs->buf, get_remote_packet_size (), "qTMinFTPILen");
12982 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
12983 if (*reply == '\0')
12987 ULONGEST min_insn_len;
12989 unpack_varlen_hex (reply, &min_insn_len);
12991 return (int) min_insn_len;
12996 remote_set_trace_buffer_size (struct target_ops *self, LONGEST val)
12998 if (packet_support (PACKET_QTBuffer_size) != PACKET_DISABLE)
13000 struct remote_state *rs = get_remote_state ();
13001 char *buf = rs->buf;
13002 char *endbuf = rs->buf + get_remote_packet_size ();
13003 enum packet_result result;
13005 gdb_assert (val >= 0 || val == -1);
13006 buf += xsnprintf (buf, endbuf - buf, "QTBuffer:size:");
13007 /* Send -1 as literal "-1" to avoid host size dependency. */
13011 buf += hexnumstr (buf, (ULONGEST) -val);
13014 buf += hexnumstr (buf, (ULONGEST) val);
13017 remote_get_noisy_reply (&rs->buf, &rs->buf_size);
13018 result = packet_ok (rs->buf,
13019 &remote_protocol_packets[PACKET_QTBuffer_size]);
13021 if (result != PACKET_OK)
13022 warning (_("Bogus reply from target: %s"), rs->buf);
13027 remote_set_trace_notes (struct target_ops *self,
13028 const char *user, const char *notes,
13029 const char *stop_notes)
13031 struct remote_state *rs = get_remote_state ();
13033 char *buf = rs->buf;
13034 char *endbuf = rs->buf + get_remote_packet_size ();
13037 buf += xsnprintf (buf, endbuf - buf, "QTNotes:");
13040 buf += xsnprintf (buf, endbuf - buf, "user:");
13041 nbytes = bin2hex ((gdb_byte *) user, buf, strlen (user));
13047 buf += xsnprintf (buf, endbuf - buf, "notes:");
13048 nbytes = bin2hex ((gdb_byte *) notes, buf, strlen (notes));
13054 buf += xsnprintf (buf, endbuf - buf, "tstop:");
13055 nbytes = bin2hex ((gdb_byte *) stop_notes, buf, strlen (stop_notes));
13059 /* Ensure the buffer is terminated. */
13063 reply = remote_get_noisy_reply (&target_buf, &target_buf_size);
13064 if (*reply == '\0')
13067 if (strcmp (reply, "OK") != 0)
13068 error (_("Bogus reply from target: %s"), reply);
13074 remote_use_agent (struct target_ops *self, int use)
13076 if (packet_support (PACKET_QAgent) != PACKET_DISABLE)
13078 struct remote_state *rs = get_remote_state ();
13080 /* If the stub supports QAgent. */
13081 xsnprintf (rs->buf, get_remote_packet_size (), "QAgent:%d", use);
13083 getpkt (&rs->buf, &rs->buf_size, 0);
13085 if (strcmp (rs->buf, "OK") == 0)
13096 remote_can_use_agent (struct target_ops *self)
13098 return (packet_support (PACKET_QAgent) != PACKET_DISABLE);
13101 struct btrace_target_info
13103 /* The ptid of the traced thread. */
13106 /* The obtained branch trace configuration. */
13107 struct btrace_config conf;
13110 /* Reset our idea of our target's btrace configuration. */
13113 remote_btrace_reset (void)
13115 struct remote_state *rs = get_remote_state ();
13117 memset (&rs->btrace_config, 0, sizeof (rs->btrace_config));
13120 /* Check whether the target supports branch tracing. */
13123 remote_supports_btrace (struct target_ops *self, enum btrace_format format)
13125 if (packet_support (PACKET_Qbtrace_off) != PACKET_ENABLE)
13127 if (packet_support (PACKET_qXfer_btrace) != PACKET_ENABLE)
13132 case BTRACE_FORMAT_NONE:
13135 case BTRACE_FORMAT_BTS:
13136 return (packet_support (PACKET_Qbtrace_bts) == PACKET_ENABLE);
13138 case BTRACE_FORMAT_PT:
13139 /* The trace is decoded on the host. Even if our target supports it,
13140 we still need to have libipt to decode the trace. */
13141 #if defined (HAVE_LIBIPT)
13142 return (packet_support (PACKET_Qbtrace_pt) == PACKET_ENABLE);
13143 #else /* !defined (HAVE_LIBIPT) */
13145 #endif /* !defined (HAVE_LIBIPT) */
13148 internal_error (__FILE__, __LINE__, _("Unknown branch trace format"));
13151 /* Synchronize the configuration with the target. */
13154 btrace_sync_conf (const struct btrace_config *conf)
13156 struct packet_config *packet;
13157 struct remote_state *rs;
13158 char *buf, *pos, *endbuf;
13160 rs = get_remote_state ();
13162 endbuf = buf + get_remote_packet_size ();
13164 packet = &remote_protocol_packets[PACKET_Qbtrace_conf_bts_size];
13165 if (packet_config_support (packet) == PACKET_ENABLE
13166 && conf->bts.size != rs->btrace_config.bts.size)
13169 pos += xsnprintf (pos, endbuf - pos, "%s=0x%x", packet->name,
13173 getpkt (&buf, &rs->buf_size, 0);
13175 if (packet_ok (buf, packet) == PACKET_ERROR)
13177 if (buf[0] == 'E' && buf[1] == '.')
13178 error (_("Failed to configure the BTS buffer size: %s"), buf + 2);
13180 error (_("Failed to configure the BTS buffer size."));
13183 rs->btrace_config.bts.size = conf->bts.size;
13186 packet = &remote_protocol_packets[PACKET_Qbtrace_conf_pt_size];
13187 if (packet_config_support (packet) == PACKET_ENABLE
13188 && conf->pt.size != rs->btrace_config.pt.size)
13191 pos += xsnprintf (pos, endbuf - pos, "%s=0x%x", packet->name,
13195 getpkt (&buf, &rs->buf_size, 0);
13197 if (packet_ok (buf, packet) == PACKET_ERROR)
13199 if (buf[0] == 'E' && buf[1] == '.')
13200 error (_("Failed to configure the trace buffer size: %s"), buf + 2);
13202 error (_("Failed to configure the trace buffer size."));
13205 rs->btrace_config.pt.size = conf->pt.size;
13209 /* Read the current thread's btrace configuration from the target and
13210 store it into CONF. */
13213 btrace_read_config (struct btrace_config *conf)
13217 xml = target_read_stralloc (¤t_target,
13218 TARGET_OBJECT_BTRACE_CONF, "");
13221 struct cleanup *cleanup;
13223 cleanup = make_cleanup (xfree, xml);
13224 parse_xml_btrace_conf (conf, xml);
13225 do_cleanups (cleanup);
13229 /* Maybe reopen target btrace. */
13232 remote_btrace_maybe_reopen (void)
13234 struct remote_state *rs = get_remote_state ();
13235 struct thread_info *tp;
13236 int btrace_target_pushed = 0;
13239 scoped_restore_current_thread restore_thread;
13241 ALL_NON_EXITED_THREADS (tp)
13243 set_general_thread (tp->ptid);
13245 memset (&rs->btrace_config, 0x00, sizeof (struct btrace_config));
13246 btrace_read_config (&rs->btrace_config);
13248 if (rs->btrace_config.format == BTRACE_FORMAT_NONE)
13251 #if !defined (HAVE_LIBIPT)
13252 if (rs->btrace_config.format == BTRACE_FORMAT_PT)
13257 warning (_("GDB does not support Intel Processor Trace. "
13258 "\"record\" will not work in this session."));
13263 #endif /* !defined (HAVE_LIBIPT) */
13265 /* Push target, once, but before anything else happens. This way our
13266 changes to the threads will be cleaned up by unpushing the target
13267 in case btrace_read_config () throws. */
13268 if (!btrace_target_pushed)
13270 btrace_target_pushed = 1;
13271 record_btrace_push_target ();
13272 printf_filtered (_("Target is recording using %s.\n"),
13273 btrace_format_string (rs->btrace_config.format));
13276 tp->btrace.target = XCNEW (struct btrace_target_info);
13277 tp->btrace.target->ptid = tp->ptid;
13278 tp->btrace.target->conf = rs->btrace_config;
13282 /* Enable branch tracing. */
13284 static struct btrace_target_info *
13285 remote_enable_btrace (struct target_ops *self, ptid_t ptid,
13286 const struct btrace_config *conf)
13288 struct btrace_target_info *tinfo = NULL;
13289 struct packet_config *packet = NULL;
13290 struct remote_state *rs = get_remote_state ();
13291 char *buf = rs->buf;
13292 char *endbuf = rs->buf + get_remote_packet_size ();
13294 switch (conf->format)
13296 case BTRACE_FORMAT_BTS:
13297 packet = &remote_protocol_packets[PACKET_Qbtrace_bts];
13300 case BTRACE_FORMAT_PT:
13301 packet = &remote_protocol_packets[PACKET_Qbtrace_pt];
13305 if (packet == NULL || packet_config_support (packet) != PACKET_ENABLE)
13306 error (_("Target does not support branch tracing."));
13308 btrace_sync_conf (conf);
13310 set_general_thread (ptid);
13312 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
13314 getpkt (&rs->buf, &rs->buf_size, 0);
13316 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
13318 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
13319 error (_("Could not enable branch tracing for %s: %s"),
13320 target_pid_to_str (ptid), rs->buf + 2);
13322 error (_("Could not enable branch tracing for %s."),
13323 target_pid_to_str (ptid));
13326 tinfo = XCNEW (struct btrace_target_info);
13327 tinfo->ptid = ptid;
13329 /* If we fail to read the configuration, we lose some information, but the
13330 tracing itself is not impacted. */
13333 btrace_read_config (&tinfo->conf);
13335 CATCH (err, RETURN_MASK_ERROR)
13337 if (err.message != NULL)
13338 warning ("%s", err.message);
13345 /* Disable branch tracing. */
13348 remote_disable_btrace (struct target_ops *self,
13349 struct btrace_target_info *tinfo)
13351 struct packet_config *packet = &remote_protocol_packets[PACKET_Qbtrace_off];
13352 struct remote_state *rs = get_remote_state ();
13353 char *buf = rs->buf;
13354 char *endbuf = rs->buf + get_remote_packet_size ();
13356 if (packet_config_support (packet) != PACKET_ENABLE)
13357 error (_("Target does not support branch tracing."));
13359 set_general_thread (tinfo->ptid);
13361 buf += xsnprintf (buf, endbuf - buf, "%s", packet->name);
13363 getpkt (&rs->buf, &rs->buf_size, 0);
13365 if (packet_ok (rs->buf, packet) == PACKET_ERROR)
13367 if (rs->buf[0] == 'E' && rs->buf[1] == '.')
13368 error (_("Could not disable branch tracing for %s: %s"),
13369 target_pid_to_str (tinfo->ptid), rs->buf + 2);
13371 error (_("Could not disable branch tracing for %s."),
13372 target_pid_to_str (tinfo->ptid));
13378 /* Teardown branch tracing. */
13381 remote_teardown_btrace (struct target_ops *self,
13382 struct btrace_target_info *tinfo)
13384 /* We must not talk to the target during teardown. */
13388 /* Read the branch trace. */
13390 static enum btrace_error
13391 remote_read_btrace (struct target_ops *self,
13392 struct btrace_data *btrace,
13393 struct btrace_target_info *tinfo,
13394 enum btrace_read_type type)
13396 struct packet_config *packet = &remote_protocol_packets[PACKET_qXfer_btrace];
13397 struct cleanup *cleanup;
13401 if (packet_config_support (packet) != PACKET_ENABLE)
13402 error (_("Target does not support branch tracing."));
13404 #if !defined(HAVE_LIBEXPAT)
13405 error (_("Cannot process branch tracing result. XML parsing not supported."));
13410 case BTRACE_READ_ALL:
13413 case BTRACE_READ_NEW:
13416 case BTRACE_READ_DELTA:
13420 internal_error (__FILE__, __LINE__,
13421 _("Bad branch tracing read type: %u."),
13422 (unsigned int) type);
13425 xml = target_read_stralloc (¤t_target,
13426 TARGET_OBJECT_BTRACE, annex);
13428 return BTRACE_ERR_UNKNOWN;
13430 cleanup = make_cleanup (xfree, xml);
13431 parse_xml_btrace (btrace, xml);
13432 do_cleanups (cleanup);
13434 return BTRACE_ERR_NONE;
13437 static const struct btrace_config *
13438 remote_btrace_conf (struct target_ops *self,
13439 const struct btrace_target_info *tinfo)
13441 return &tinfo->conf;
13445 remote_augmented_libraries_svr4_read (struct target_ops *self)
13447 return (packet_support (PACKET_augmented_libraries_svr4_read_feature)
13451 /* Implementation of to_load. */
13454 remote_load (struct target_ops *self, const char *name, int from_tty)
13456 generic_load (name, from_tty);
13459 /* Accepts an integer PID; returns a string representing a file that
13460 can be opened on the remote side to get the symbols for the child
13461 process. Returns NULL if the operation is not supported. */
13464 remote_pid_to_exec_file (struct target_ops *self, int pid)
13466 static char *filename = NULL;
13467 struct inferior *inf;
13468 char *annex = NULL;
13470 if (packet_support (PACKET_qXfer_exec_file) != PACKET_ENABLE)
13473 if (filename != NULL)
13476 inf = find_inferior_pid (pid);
13478 internal_error (__FILE__, __LINE__,
13479 _("not currently attached to process %d"), pid);
13481 if (!inf->fake_pid_p)
13483 const int annex_size = 9;
13485 annex = (char *) alloca (annex_size);
13486 xsnprintf (annex, annex_size, "%x", pid);
13489 filename = target_read_stralloc (¤t_target,
13490 TARGET_OBJECT_EXEC_FILE, annex);
13495 /* Implement the to_can_do_single_step target_ops method. */
13498 remote_can_do_single_step (struct target_ops *ops)
13500 /* We can only tell whether target supports single step or not by
13501 supported s and S vCont actions if the stub supports vContSupported
13502 feature. If the stub doesn't support vContSupported feature,
13503 we have conservatively to think target doesn't supports single
13505 if (packet_support (PACKET_vContSupported) == PACKET_ENABLE)
13507 struct remote_state *rs = get_remote_state ();
13509 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
13510 remote_vcont_probe (rs);
13512 return rs->supports_vCont.s && rs->supports_vCont.S;
13518 /* Implementation of the to_execution_direction method for the remote
13521 static enum exec_direction_kind
13522 remote_execution_direction (struct target_ops *self)
13524 struct remote_state *rs = get_remote_state ();
13526 return rs->last_resume_exec_dir;
13530 init_remote_ops (void)
13532 remote_ops.to_shortname = "remote";
13533 remote_ops.to_longname = "Remote serial target in gdb-specific protocol";
13534 remote_ops.to_doc =
13535 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
13536 Specify the serial device it is connected to\n\
13537 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).";
13538 remote_ops.to_open = remote_open;
13539 remote_ops.to_close = remote_close;
13540 remote_ops.to_detach = remote_detach;
13541 remote_ops.to_disconnect = remote_disconnect;
13542 remote_ops.to_resume = remote_resume;
13543 remote_ops.to_commit_resume = remote_commit_resume;
13544 remote_ops.to_wait = remote_wait;
13545 remote_ops.to_fetch_registers = remote_fetch_registers;
13546 remote_ops.to_store_registers = remote_store_registers;
13547 remote_ops.to_prepare_to_store = remote_prepare_to_store;
13548 remote_ops.to_files_info = remote_files_info;
13549 remote_ops.to_insert_breakpoint = remote_insert_breakpoint;
13550 remote_ops.to_remove_breakpoint = remote_remove_breakpoint;
13551 remote_ops.to_stopped_by_sw_breakpoint = remote_stopped_by_sw_breakpoint;
13552 remote_ops.to_supports_stopped_by_sw_breakpoint = remote_supports_stopped_by_sw_breakpoint;
13553 remote_ops.to_stopped_by_hw_breakpoint = remote_stopped_by_hw_breakpoint;
13554 remote_ops.to_supports_stopped_by_hw_breakpoint = remote_supports_stopped_by_hw_breakpoint;
13555 remote_ops.to_stopped_by_watchpoint = remote_stopped_by_watchpoint;
13556 remote_ops.to_stopped_data_address = remote_stopped_data_address;
13557 remote_ops.to_watchpoint_addr_within_range =
13558 remote_watchpoint_addr_within_range;
13559 remote_ops.to_can_use_hw_breakpoint = remote_check_watch_resources;
13560 remote_ops.to_insert_hw_breakpoint = remote_insert_hw_breakpoint;
13561 remote_ops.to_remove_hw_breakpoint = remote_remove_hw_breakpoint;
13562 remote_ops.to_region_ok_for_hw_watchpoint
13563 = remote_region_ok_for_hw_watchpoint;
13564 remote_ops.to_insert_watchpoint = remote_insert_watchpoint;
13565 remote_ops.to_remove_watchpoint = remote_remove_watchpoint;
13566 remote_ops.to_kill = remote_kill;
13567 remote_ops.to_load = remote_load;
13568 remote_ops.to_mourn_inferior = remote_mourn;
13569 remote_ops.to_pass_signals = remote_pass_signals;
13570 remote_ops.to_set_syscall_catchpoint = remote_set_syscall_catchpoint;
13571 remote_ops.to_program_signals = remote_program_signals;
13572 remote_ops.to_thread_alive = remote_thread_alive;
13573 remote_ops.to_thread_name = remote_thread_name;
13574 remote_ops.to_update_thread_list = remote_update_thread_list;
13575 remote_ops.to_pid_to_str = remote_pid_to_str;
13576 remote_ops.to_extra_thread_info = remote_threads_extra_info;
13577 remote_ops.to_get_ada_task_ptid = remote_get_ada_task_ptid;
13578 remote_ops.to_stop = remote_stop;
13579 remote_ops.to_interrupt = remote_interrupt;
13580 remote_ops.to_pass_ctrlc = remote_pass_ctrlc;
13581 remote_ops.to_xfer_partial = remote_xfer_partial;
13582 remote_ops.to_get_memory_xfer_limit = remote_get_memory_xfer_limit;
13583 remote_ops.to_rcmd = remote_rcmd;
13584 remote_ops.to_pid_to_exec_file = remote_pid_to_exec_file;
13585 remote_ops.to_log_command = serial_log_command;
13586 remote_ops.to_get_thread_local_address = remote_get_thread_local_address;
13587 remote_ops.to_stratum = process_stratum;
13588 remote_ops.to_has_all_memory = default_child_has_all_memory;
13589 remote_ops.to_has_memory = default_child_has_memory;
13590 remote_ops.to_has_stack = default_child_has_stack;
13591 remote_ops.to_has_registers = default_child_has_registers;
13592 remote_ops.to_has_execution = default_child_has_execution;
13593 remote_ops.to_has_thread_control = tc_schedlock; /* can lock scheduler */
13594 remote_ops.to_can_execute_reverse = remote_can_execute_reverse;
13595 remote_ops.to_magic = OPS_MAGIC;
13596 remote_ops.to_memory_map = remote_memory_map;
13597 remote_ops.to_flash_erase = remote_flash_erase;
13598 remote_ops.to_flash_done = remote_flash_done;
13599 remote_ops.to_read_description = remote_read_description;
13600 remote_ops.to_search_memory = remote_search_memory;
13601 remote_ops.to_can_async_p = remote_can_async_p;
13602 remote_ops.to_is_async_p = remote_is_async_p;
13603 remote_ops.to_async = remote_async;
13604 remote_ops.to_thread_events = remote_thread_events;
13605 remote_ops.to_can_do_single_step = remote_can_do_single_step;
13606 remote_ops.to_terminal_inferior = remote_terminal_inferior;
13607 remote_ops.to_terminal_ours = remote_terminal_ours;
13608 remote_ops.to_supports_non_stop = remote_supports_non_stop;
13609 remote_ops.to_supports_multi_process = remote_supports_multi_process;
13610 remote_ops.to_supports_disable_randomization
13611 = remote_supports_disable_randomization;
13612 remote_ops.to_filesystem_is_local = remote_filesystem_is_local;
13613 remote_ops.to_fileio_open = remote_hostio_open;
13614 remote_ops.to_fileio_pwrite = remote_hostio_pwrite;
13615 remote_ops.to_fileio_pread = remote_hostio_pread;
13616 remote_ops.to_fileio_fstat = remote_hostio_fstat;
13617 remote_ops.to_fileio_close = remote_hostio_close;
13618 remote_ops.to_fileio_unlink = remote_hostio_unlink;
13619 remote_ops.to_fileio_readlink = remote_hostio_readlink;
13620 remote_ops.to_supports_enable_disable_tracepoint = remote_supports_enable_disable_tracepoint;
13621 remote_ops.to_supports_string_tracing = remote_supports_string_tracing;
13622 remote_ops.to_supports_evaluation_of_breakpoint_conditions = remote_supports_cond_breakpoints;
13623 remote_ops.to_can_run_breakpoint_commands = remote_can_run_breakpoint_commands;
13624 remote_ops.to_trace_init = remote_trace_init;
13625 remote_ops.to_download_tracepoint = remote_download_tracepoint;
13626 remote_ops.to_can_download_tracepoint = remote_can_download_tracepoint;
13627 remote_ops.to_download_trace_state_variable
13628 = remote_download_trace_state_variable;
13629 remote_ops.to_enable_tracepoint = remote_enable_tracepoint;
13630 remote_ops.to_disable_tracepoint = remote_disable_tracepoint;
13631 remote_ops.to_trace_set_readonly_regions = remote_trace_set_readonly_regions;
13632 remote_ops.to_trace_start = remote_trace_start;
13633 remote_ops.to_get_trace_status = remote_get_trace_status;
13634 remote_ops.to_get_tracepoint_status = remote_get_tracepoint_status;
13635 remote_ops.to_trace_stop = remote_trace_stop;
13636 remote_ops.to_trace_find = remote_trace_find;
13637 remote_ops.to_get_trace_state_variable_value
13638 = remote_get_trace_state_variable_value;
13639 remote_ops.to_save_trace_data = remote_save_trace_data;
13640 remote_ops.to_upload_tracepoints = remote_upload_tracepoints;
13641 remote_ops.to_upload_trace_state_variables
13642 = remote_upload_trace_state_variables;
13643 remote_ops.to_get_raw_trace_data = remote_get_raw_trace_data;
13644 remote_ops.to_get_min_fast_tracepoint_insn_len = remote_get_min_fast_tracepoint_insn_len;
13645 remote_ops.to_set_disconnected_tracing = remote_set_disconnected_tracing;
13646 remote_ops.to_set_circular_trace_buffer = remote_set_circular_trace_buffer;
13647 remote_ops.to_set_trace_buffer_size = remote_set_trace_buffer_size;
13648 remote_ops.to_set_trace_notes = remote_set_trace_notes;
13649 remote_ops.to_core_of_thread = remote_core_of_thread;
13650 remote_ops.to_verify_memory = remote_verify_memory;
13651 remote_ops.to_get_tib_address = remote_get_tib_address;
13652 remote_ops.to_set_permissions = remote_set_permissions;
13653 remote_ops.to_static_tracepoint_marker_at
13654 = remote_static_tracepoint_marker_at;
13655 remote_ops.to_static_tracepoint_markers_by_strid
13656 = remote_static_tracepoint_markers_by_strid;
13657 remote_ops.to_traceframe_info = remote_traceframe_info;
13658 remote_ops.to_use_agent = remote_use_agent;
13659 remote_ops.to_can_use_agent = remote_can_use_agent;
13660 remote_ops.to_supports_btrace = remote_supports_btrace;
13661 remote_ops.to_enable_btrace = remote_enable_btrace;
13662 remote_ops.to_disable_btrace = remote_disable_btrace;
13663 remote_ops.to_teardown_btrace = remote_teardown_btrace;
13664 remote_ops.to_read_btrace = remote_read_btrace;
13665 remote_ops.to_btrace_conf = remote_btrace_conf;
13666 remote_ops.to_augmented_libraries_svr4_read =
13667 remote_augmented_libraries_svr4_read;
13668 remote_ops.to_follow_fork = remote_follow_fork;
13669 remote_ops.to_follow_exec = remote_follow_exec;
13670 remote_ops.to_insert_fork_catchpoint = remote_insert_fork_catchpoint;
13671 remote_ops.to_remove_fork_catchpoint = remote_remove_fork_catchpoint;
13672 remote_ops.to_insert_vfork_catchpoint = remote_insert_vfork_catchpoint;
13673 remote_ops.to_remove_vfork_catchpoint = remote_remove_vfork_catchpoint;
13674 remote_ops.to_insert_exec_catchpoint = remote_insert_exec_catchpoint;
13675 remote_ops.to_remove_exec_catchpoint = remote_remove_exec_catchpoint;
13676 remote_ops.to_execution_direction = remote_execution_direction;
13679 /* Set up the extended remote vector by making a copy of the standard
13680 remote vector and adding to it. */
13683 init_extended_remote_ops (void)
13685 extended_remote_ops = remote_ops;
13687 extended_remote_ops.to_shortname = "extended-remote";
13688 extended_remote_ops.to_longname =
13689 "Extended remote serial target in gdb-specific protocol";
13690 extended_remote_ops.to_doc =
13691 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
13692 Specify the serial device it is connected to (e.g. /dev/ttya).";
13693 extended_remote_ops.to_open = extended_remote_open;
13694 extended_remote_ops.to_create_inferior = extended_remote_create_inferior;
13695 extended_remote_ops.to_detach = extended_remote_detach;
13696 extended_remote_ops.to_attach = extended_remote_attach;
13697 extended_remote_ops.to_post_attach = extended_remote_post_attach;
13698 extended_remote_ops.to_supports_disable_randomization
13699 = extended_remote_supports_disable_randomization;
13703 remote_can_async_p (struct target_ops *ops)
13705 struct remote_state *rs = get_remote_state ();
13707 /* We don't go async if the user has explicitly prevented it with the
13708 "maint set target-async" command. */
13709 if (!target_async_permitted)
13712 /* We're async whenever the serial device is. */
13713 return serial_can_async_p (rs->remote_desc);
13717 remote_is_async_p (struct target_ops *ops)
13719 struct remote_state *rs = get_remote_state ();
13721 if (!target_async_permitted)
13722 /* We only enable async when the user specifically asks for it. */
13725 /* We're async whenever the serial device is. */
13726 return serial_is_async_p (rs->remote_desc);
13729 /* Pass the SERIAL event on and up to the client. One day this code
13730 will be able to delay notifying the client of an event until the
13731 point where an entire packet has been received. */
13733 static serial_event_ftype remote_async_serial_handler;
13736 remote_async_serial_handler (struct serial *scb, void *context)
13738 /* Don't propogate error information up to the client. Instead let
13739 the client find out about the error by querying the target. */
13740 inferior_event_handler (INF_REG_EVENT, NULL);
13744 remote_async_inferior_event_handler (gdb_client_data data)
13746 inferior_event_handler (INF_REG_EVENT, NULL);
13750 remote_async (struct target_ops *ops, int enable)
13752 struct remote_state *rs = get_remote_state ();
13756 serial_async (rs->remote_desc, remote_async_serial_handler, rs);
13758 /* If there are pending events in the stop reply queue tell the
13759 event loop to process them. */
13760 if (!QUEUE_is_empty (stop_reply_p, stop_reply_queue))
13761 mark_async_event_handler (remote_async_inferior_event_token);
13762 /* For simplicity, below we clear the pending events token
13763 without remembering whether it is marked, so here we always
13764 mark it. If there's actually no pending notification to
13765 process, this ends up being a no-op (other than a spurious
13766 event-loop wakeup). */
13767 if (target_is_non_stop_p ())
13768 mark_async_event_handler (rs->notif_state->get_pending_events_token);
13772 serial_async (rs->remote_desc, NULL, NULL);
13773 /* If the core is disabling async, it doesn't want to be
13774 disturbed with target events. Clear all async event sources
13776 clear_async_event_handler (remote_async_inferior_event_token);
13777 if (target_is_non_stop_p ())
13778 clear_async_event_handler (rs->notif_state->get_pending_events_token);
13782 /* Implementation of the to_thread_events method. */
13785 remote_thread_events (struct target_ops *ops, int enable)
13787 struct remote_state *rs = get_remote_state ();
13788 size_t size = get_remote_packet_size ();
13790 if (packet_support (PACKET_QThreadEvents) == PACKET_DISABLE)
13793 xsnprintf (rs->buf, size, "QThreadEvents:%x", enable ? 1 : 0);
13795 getpkt (&rs->buf, &rs->buf_size, 0);
13797 switch (packet_ok (rs->buf,
13798 &remote_protocol_packets[PACKET_QThreadEvents]))
13801 if (strcmp (rs->buf, "OK") != 0)
13802 error (_("Remote refused setting thread events: %s"), rs->buf);
13805 warning (_("Remote failure reply: %s"), rs->buf);
13807 case PACKET_UNKNOWN:
13813 set_remote_cmd (char *args, int from_tty)
13815 help_list (remote_set_cmdlist, "set remote ", all_commands, gdb_stdout);
13819 show_remote_cmd (char *args, int from_tty)
13821 /* We can't just use cmd_show_list here, because we want to skip
13822 the redundant "show remote Z-packet" and the legacy aliases. */
13823 struct cmd_list_element *list = remote_show_cmdlist;
13824 struct ui_out *uiout = current_uiout;
13826 ui_out_emit_tuple tuple_emitter (uiout, "showlist");
13827 for (; list != NULL; list = list->next)
13828 if (strcmp (list->name, "Z-packet") == 0)
13830 else if (list->type == not_set_cmd)
13831 /* Alias commands are exactly like the original, except they
13832 don't have the normal type. */
13836 ui_out_emit_tuple option_emitter (uiout, "option");
13838 uiout->field_string ("name", list->name);
13839 uiout->text (": ");
13840 if (list->type == show_cmd)
13841 do_show_command (NULL, from_tty, list);
13843 cmd_func (list, NULL, from_tty);
13848 /* Function to be called whenever a new objfile (shlib) is detected. */
13850 remote_new_objfile (struct objfile *objfile)
13852 struct remote_state *rs = get_remote_state ();
13854 if (rs->remote_desc != 0) /* Have a remote connection. */
13855 remote_check_symbols ();
13858 /* Pull all the tracepoints defined on the target and create local
13859 data structures representing them. We don't want to create real
13860 tracepoints yet, we don't want to mess up the user's existing
13864 remote_upload_tracepoints (struct target_ops *self, struct uploaded_tp **utpp)
13866 struct remote_state *rs = get_remote_state ();
13869 /* Ask for a first packet of tracepoint definition. */
13871 getpkt (&rs->buf, &rs->buf_size, 0);
13873 while (*p && *p != 'l')
13875 parse_tracepoint_definition (p, utpp);
13876 /* Ask for another packet of tracepoint definition. */
13878 getpkt (&rs->buf, &rs->buf_size, 0);
13885 remote_upload_trace_state_variables (struct target_ops *self,
13886 struct uploaded_tsv **utsvp)
13888 struct remote_state *rs = get_remote_state ();
13891 /* Ask for a first packet of variable definition. */
13893 getpkt (&rs->buf, &rs->buf_size, 0);
13895 while (*p && *p != 'l')
13897 parse_tsv_definition (p, utsvp);
13898 /* Ask for another packet of variable definition. */
13900 getpkt (&rs->buf, &rs->buf_size, 0);
13906 /* The "set/show range-stepping" show hook. */
13909 show_range_stepping (struct ui_file *file, int from_tty,
13910 struct cmd_list_element *c,
13913 fprintf_filtered (file,
13914 _("Debugger's willingness to use range stepping "
13915 "is %s.\n"), value);
13918 /* The "set/show range-stepping" set hook. */
13921 set_range_stepping (char *ignore_args, int from_tty,
13922 struct cmd_list_element *c)
13924 struct remote_state *rs = get_remote_state ();
13926 /* Whene enabling, check whether range stepping is actually
13927 supported by the target, and warn if not. */
13928 if (use_range_stepping)
13930 if (rs->remote_desc != NULL)
13932 if (packet_support (PACKET_vCont) == PACKET_SUPPORT_UNKNOWN)
13933 remote_vcont_probe (rs);
13935 if (packet_support (PACKET_vCont) == PACKET_ENABLE
13936 && rs->supports_vCont.r)
13940 warning (_("Range stepping is not supported by the current target"));
13945 _initialize_remote (void)
13947 struct cmd_list_element *cmd;
13948 const char *cmd_name;
13950 /* architecture specific data */
13951 remote_gdbarch_data_handle =
13952 gdbarch_data_register_post_init (init_remote_state);
13953 remote_g_packet_data_handle =
13954 gdbarch_data_register_pre_init (remote_g_packet_data_init);
13957 = register_program_space_data_with_cleanup (NULL,
13958 remote_pspace_data_cleanup);
13960 /* Initialize the per-target state. At the moment there is only one
13961 of these, not one per target. Only one target is active at a
13963 remote_state = new_remote_state ();
13965 init_remote_ops ();
13966 add_target (&remote_ops);
13968 init_extended_remote_ops ();
13969 add_target (&extended_remote_ops);
13971 /* Hook into new objfile notification. */
13972 observer_attach_new_objfile (remote_new_objfile);
13973 /* We're no longer interested in notification events of an inferior
13975 observer_attach_inferior_exit (discard_pending_stop_replies);
13978 init_remote_threadtests ();
13981 stop_reply_queue = QUEUE_alloc (stop_reply_p, stop_reply_xfree);
13982 /* set/show remote ... */
13984 add_prefix_cmd ("remote", class_maintenance, set_remote_cmd, _("\
13985 Remote protocol specific variables\n\
13986 Configure various remote-protocol specific variables such as\n\
13987 the packets being used"),
13988 &remote_set_cmdlist, "set remote ",
13989 0 /* allow-unknown */, &setlist);
13990 add_prefix_cmd ("remote", class_maintenance, show_remote_cmd, _("\
13991 Remote protocol specific variables\n\
13992 Configure various remote-protocol specific variables such as\n\
13993 the packets being used"),
13994 &remote_show_cmdlist, "show remote ",
13995 0 /* allow-unknown */, &showlist);
13997 add_cmd ("compare-sections", class_obscure, compare_sections_command, _("\
13998 Compare section data on target to the exec file.\n\
13999 Argument is a single section name (default: all loaded sections).\n\
14000 To compare only read-only loaded sections, specify the -r option."),
14003 add_cmd ("packet", class_maintenance, packet_command, _("\
14004 Send an arbitrary packet to a remote target.\n\
14005 maintenance packet TEXT\n\
14006 If GDB is talking to an inferior via the GDB serial protocol, then\n\
14007 this command sends the string TEXT to the inferior, and displays the\n\
14008 response packet. GDB supplies the initial `$' character, and the\n\
14009 terminating `#' character and checksum."),
14012 add_setshow_boolean_cmd ("remotebreak", no_class, &remote_break, _("\
14013 Set whether to send break if interrupted."), _("\
14014 Show whether to send break if interrupted."), _("\
14015 If set, a break, instead of a cntrl-c, is sent to the remote target."),
14016 set_remotebreak, show_remotebreak,
14017 &setlist, &showlist);
14018 cmd_name = "remotebreak";
14019 cmd = lookup_cmd (&cmd_name, setlist, "", -1, 1);
14020 deprecate_cmd (cmd, "set remote interrupt-sequence");
14021 cmd_name = "remotebreak"; /* needed because lookup_cmd updates the pointer */
14022 cmd = lookup_cmd (&cmd_name, showlist, "", -1, 1);
14023 deprecate_cmd (cmd, "show remote interrupt-sequence");
14025 add_setshow_enum_cmd ("interrupt-sequence", class_support,
14026 interrupt_sequence_modes, &interrupt_sequence_mode,
14028 Set interrupt sequence to remote target."), _("\
14029 Show interrupt sequence to remote target."), _("\
14030 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
14031 NULL, show_interrupt_sequence,
14032 &remote_set_cmdlist,
14033 &remote_show_cmdlist);
14035 add_setshow_boolean_cmd ("interrupt-on-connect", class_support,
14036 &interrupt_on_connect, _("\
14037 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
14038 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
14039 If set, interrupt sequence is sent to remote target."),
14041 &remote_set_cmdlist, &remote_show_cmdlist);
14043 /* Install commands for configuring memory read/write packets. */
14045 add_cmd ("remotewritesize", no_class, set_memory_write_packet_size, _("\
14046 Set the maximum number of bytes per memory write packet (deprecated)."),
14048 add_cmd ("remotewritesize", no_class, show_memory_write_packet_size, _("\
14049 Show the maximum number of bytes per memory write packet (deprecated)."),
14051 add_cmd ("memory-write-packet-size", no_class,
14052 set_memory_write_packet_size, _("\
14053 Set the maximum number of bytes per memory-write packet.\n\
14054 Specify the number of bytes in a packet or 0 (zero) for the\n\
14055 default packet size. The actual limit is further reduced\n\
14056 dependent on the target. Specify ``fixed'' to disable the\n\
14057 further restriction and ``limit'' to enable that restriction."),
14058 &remote_set_cmdlist);
14059 add_cmd ("memory-read-packet-size", no_class,
14060 set_memory_read_packet_size, _("\
14061 Set the maximum number of bytes per memory-read packet.\n\
14062 Specify the number of bytes in a packet or 0 (zero) for the\n\
14063 default packet size. The actual limit is further reduced\n\
14064 dependent on the target. Specify ``fixed'' to disable the\n\
14065 further restriction and ``limit'' to enable that restriction."),
14066 &remote_set_cmdlist);
14067 add_cmd ("memory-write-packet-size", no_class,
14068 show_memory_write_packet_size,
14069 _("Show the maximum number of bytes per memory-write packet."),
14070 &remote_show_cmdlist);
14071 add_cmd ("memory-read-packet-size", no_class,
14072 show_memory_read_packet_size,
14073 _("Show the maximum number of bytes per memory-read packet."),
14074 &remote_show_cmdlist);
14076 add_setshow_zinteger_cmd ("hardware-watchpoint-limit", no_class,
14077 &remote_hw_watchpoint_limit, _("\
14078 Set the maximum number of target hardware watchpoints."), _("\
14079 Show the maximum number of target hardware watchpoints."), _("\
14080 Specify a negative limit for unlimited."),
14081 NULL, NULL, /* FIXME: i18n: The maximum
14082 number of target hardware
14083 watchpoints is %s. */
14084 &remote_set_cmdlist, &remote_show_cmdlist);
14085 add_setshow_zinteger_cmd ("hardware-watchpoint-length-limit", no_class,
14086 &remote_hw_watchpoint_length_limit, _("\
14087 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
14088 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
14089 Specify a negative limit for unlimited."),
14090 NULL, NULL, /* FIXME: i18n: The maximum
14091 length (in bytes) of a target
14092 hardware watchpoint is %s. */
14093 &remote_set_cmdlist, &remote_show_cmdlist);
14094 add_setshow_zinteger_cmd ("hardware-breakpoint-limit", no_class,
14095 &remote_hw_breakpoint_limit, _("\
14096 Set the maximum number of target hardware breakpoints."), _("\
14097 Show the maximum number of target hardware breakpoints."), _("\
14098 Specify a negative limit for unlimited."),
14099 NULL, NULL, /* FIXME: i18n: The maximum
14100 number of target hardware
14101 breakpoints is %s. */
14102 &remote_set_cmdlist, &remote_show_cmdlist);
14104 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure,
14105 &remote_address_size, _("\
14106 Set the maximum size of the address (in bits) in a memory packet."), _("\
14107 Show the maximum size of the address (in bits) in a memory packet."), NULL,
14109 NULL, /* FIXME: i18n: */
14110 &setlist, &showlist);
14112 init_all_packet_configs ();
14114 add_packet_config_cmd (&remote_protocol_packets[PACKET_X],
14115 "X", "binary-download", 1);
14117 add_packet_config_cmd (&remote_protocol_packets[PACKET_vCont],
14118 "vCont", "verbose-resume", 0);
14120 add_packet_config_cmd (&remote_protocol_packets[PACKET_QPassSignals],
14121 "QPassSignals", "pass-signals", 0);
14123 add_packet_config_cmd (&remote_protocol_packets[PACKET_QCatchSyscalls],
14124 "QCatchSyscalls", "catch-syscalls", 0);
14126 add_packet_config_cmd (&remote_protocol_packets[PACKET_QProgramSignals],
14127 "QProgramSignals", "program-signals", 0);
14129 add_packet_config_cmd (&remote_protocol_packets[PACKET_QStartupWithShell],
14130 "QStartupWithShell", "startup-with-shell", 0);
14132 add_packet_config_cmd (&remote_protocol_packets
14133 [PACKET_QEnvironmentHexEncoded],
14134 "QEnvironmentHexEncoded", "environment-hex-encoded",
14137 add_packet_config_cmd (&remote_protocol_packets[PACKET_QEnvironmentReset],
14138 "QEnvironmentReset", "environment-reset",
14141 add_packet_config_cmd (&remote_protocol_packets[PACKET_QEnvironmentUnset],
14142 "QEnvironmentUnset", "environment-unset",
14145 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSymbol],
14146 "qSymbol", "symbol-lookup", 0);
14148 add_packet_config_cmd (&remote_protocol_packets[PACKET_P],
14149 "P", "set-register", 1);
14151 add_packet_config_cmd (&remote_protocol_packets[PACKET_p],
14152 "p", "fetch-register", 1);
14154 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z0],
14155 "Z0", "software-breakpoint", 0);
14157 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z1],
14158 "Z1", "hardware-breakpoint", 0);
14160 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z2],
14161 "Z2", "write-watchpoint", 0);
14163 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z3],
14164 "Z3", "read-watchpoint", 0);
14166 add_packet_config_cmd (&remote_protocol_packets[PACKET_Z4],
14167 "Z4", "access-watchpoint", 0);
14169 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_auxv],
14170 "qXfer:auxv:read", "read-aux-vector", 0);
14172 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_exec_file],
14173 "qXfer:exec-file:read", "pid-to-exec-file", 0);
14175 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_features],
14176 "qXfer:features:read", "target-features", 0);
14178 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries],
14179 "qXfer:libraries:read", "library-info", 0);
14181 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_libraries_svr4],
14182 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
14184 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_memory_map],
14185 "qXfer:memory-map:read", "memory-map", 0);
14187 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_read],
14188 "qXfer:spu:read", "read-spu-object", 0);
14190 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_spu_write],
14191 "qXfer:spu:write", "write-spu-object", 0);
14193 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_osdata],
14194 "qXfer:osdata:read", "osdata", 0);
14196 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_threads],
14197 "qXfer:threads:read", "threads", 0);
14199 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_read],
14200 "qXfer:siginfo:read", "read-siginfo-object", 0);
14202 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_siginfo_write],
14203 "qXfer:siginfo:write", "write-siginfo-object", 0);
14205 add_packet_config_cmd
14206 (&remote_protocol_packets[PACKET_qXfer_traceframe_info],
14207 "qXfer:traceframe-info:read", "traceframe-info", 0);
14209 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_uib],
14210 "qXfer:uib:read", "unwind-info-block", 0);
14212 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTLSAddr],
14213 "qGetTLSAddr", "get-thread-local-storage-address",
14216 add_packet_config_cmd (&remote_protocol_packets[PACKET_qGetTIBAddr],
14217 "qGetTIBAddr", "get-thread-information-block-address",
14220 add_packet_config_cmd (&remote_protocol_packets[PACKET_bc],
14221 "bc", "reverse-continue", 0);
14223 add_packet_config_cmd (&remote_protocol_packets[PACKET_bs],
14224 "bs", "reverse-step", 0);
14226 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSupported],
14227 "qSupported", "supported-packets", 0);
14229 add_packet_config_cmd (&remote_protocol_packets[PACKET_qSearch_memory],
14230 "qSearch:memory", "search-memory", 0);
14232 add_packet_config_cmd (&remote_protocol_packets[PACKET_qTStatus],
14233 "qTStatus", "trace-status", 0);
14235 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_setfs],
14236 "vFile:setfs", "hostio-setfs", 0);
14238 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_open],
14239 "vFile:open", "hostio-open", 0);
14241 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pread],
14242 "vFile:pread", "hostio-pread", 0);
14244 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_pwrite],
14245 "vFile:pwrite", "hostio-pwrite", 0);
14247 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_close],
14248 "vFile:close", "hostio-close", 0);
14250 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_unlink],
14251 "vFile:unlink", "hostio-unlink", 0);
14253 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_readlink],
14254 "vFile:readlink", "hostio-readlink", 0);
14256 add_packet_config_cmd (&remote_protocol_packets[PACKET_vFile_fstat],
14257 "vFile:fstat", "hostio-fstat", 0);
14259 add_packet_config_cmd (&remote_protocol_packets[PACKET_vAttach],
14260 "vAttach", "attach", 0);
14262 add_packet_config_cmd (&remote_protocol_packets[PACKET_vRun],
14265 add_packet_config_cmd (&remote_protocol_packets[PACKET_QStartNoAckMode],
14266 "QStartNoAckMode", "noack", 0);
14268 add_packet_config_cmd (&remote_protocol_packets[PACKET_vKill],
14269 "vKill", "kill", 0);
14271 add_packet_config_cmd (&remote_protocol_packets[PACKET_qAttached],
14272 "qAttached", "query-attached", 0);
14274 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalTracepoints],
14275 "ConditionalTracepoints",
14276 "conditional-tracepoints", 0);
14278 add_packet_config_cmd (&remote_protocol_packets[PACKET_ConditionalBreakpoints],
14279 "ConditionalBreakpoints",
14280 "conditional-breakpoints", 0);
14282 add_packet_config_cmd (&remote_protocol_packets[PACKET_BreakpointCommands],
14283 "BreakpointCommands",
14284 "breakpoint-commands", 0);
14286 add_packet_config_cmd (&remote_protocol_packets[PACKET_FastTracepoints],
14287 "FastTracepoints", "fast-tracepoints", 0);
14289 add_packet_config_cmd (&remote_protocol_packets[PACKET_TracepointSource],
14290 "TracepointSource", "TracepointSource", 0);
14292 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAllow],
14293 "QAllow", "allow", 0);
14295 add_packet_config_cmd (&remote_protocol_packets[PACKET_StaticTracepoints],
14296 "StaticTracepoints", "static-tracepoints", 0);
14298 add_packet_config_cmd (&remote_protocol_packets[PACKET_InstallInTrace],
14299 "InstallInTrace", "install-in-trace", 0);
14301 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_statictrace_read],
14302 "qXfer:statictrace:read", "read-sdata-object", 0);
14304 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_fdpic],
14305 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
14307 add_packet_config_cmd (&remote_protocol_packets[PACKET_QDisableRandomization],
14308 "QDisableRandomization", "disable-randomization", 0);
14310 add_packet_config_cmd (&remote_protocol_packets[PACKET_QAgent],
14311 "QAgent", "agent", 0);
14313 add_packet_config_cmd (&remote_protocol_packets[PACKET_QTBuffer_size],
14314 "QTBuffer:size", "trace-buffer-size", 0);
14316 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_off],
14317 "Qbtrace:off", "disable-btrace", 0);
14319 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_bts],
14320 "Qbtrace:bts", "enable-btrace-bts", 0);
14322 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_pt],
14323 "Qbtrace:pt", "enable-btrace-pt", 0);
14325 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace],
14326 "qXfer:btrace", "read-btrace", 0);
14328 add_packet_config_cmd (&remote_protocol_packets[PACKET_qXfer_btrace_conf],
14329 "qXfer:btrace-conf", "read-btrace-conf", 0);
14331 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_conf_bts_size],
14332 "Qbtrace-conf:bts:size", "btrace-conf-bts-size", 0);
14334 add_packet_config_cmd (&remote_protocol_packets[PACKET_multiprocess_feature],
14335 "multiprocess-feature", "multiprocess-feature", 0);
14337 add_packet_config_cmd (&remote_protocol_packets[PACKET_swbreak_feature],
14338 "swbreak-feature", "swbreak-feature", 0);
14340 add_packet_config_cmd (&remote_protocol_packets[PACKET_hwbreak_feature],
14341 "hwbreak-feature", "hwbreak-feature", 0);
14343 add_packet_config_cmd (&remote_protocol_packets[PACKET_fork_event_feature],
14344 "fork-event-feature", "fork-event-feature", 0);
14346 add_packet_config_cmd (&remote_protocol_packets[PACKET_vfork_event_feature],
14347 "vfork-event-feature", "vfork-event-feature", 0);
14349 add_packet_config_cmd (&remote_protocol_packets[PACKET_Qbtrace_conf_pt_size],
14350 "Qbtrace-conf:pt:size", "btrace-conf-pt-size", 0);
14352 add_packet_config_cmd (&remote_protocol_packets[PACKET_vContSupported],
14353 "vContSupported", "verbose-resume-supported", 0);
14355 add_packet_config_cmd (&remote_protocol_packets[PACKET_exec_event_feature],
14356 "exec-event-feature", "exec-event-feature", 0);
14358 add_packet_config_cmd (&remote_protocol_packets[PACKET_vCtrlC],
14359 "vCtrlC", "ctrl-c", 0);
14361 add_packet_config_cmd (&remote_protocol_packets[PACKET_QThreadEvents],
14362 "QThreadEvents", "thread-events", 0);
14364 add_packet_config_cmd (&remote_protocol_packets[PACKET_no_resumed],
14365 "N stop reply", "no-resumed-stop-reply", 0);
14367 /* Assert that we've registered "set remote foo-packet" commands
14368 for all packet configs. */
14372 for (i = 0; i < PACKET_MAX; i++)
14374 /* Ideally all configs would have a command associated. Some
14375 still don't though. */
14380 case PACKET_QNonStop:
14381 case PACKET_EnableDisableTracepoints_feature:
14382 case PACKET_tracenz_feature:
14383 case PACKET_DisconnectedTracing_feature:
14384 case PACKET_augmented_libraries_svr4_read_feature:
14386 /* Additions to this list need to be well justified:
14387 pre-existing packets are OK; new packets are not. */
14395 /* This catches both forgetting to add a config command, and
14396 forgetting to remove a packet from the exception list. */
14397 gdb_assert (excepted == (remote_protocol_packets[i].name == NULL));
14401 /* Keep the old ``set remote Z-packet ...'' working. Each individual
14402 Z sub-packet has its own set and show commands, but users may
14403 have sets to this variable in their .gdbinit files (or in their
14405 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure,
14406 &remote_Z_packet_detect, _("\
14407 Set use of remote protocol `Z' packets"), _("\
14408 Show use of remote protocol `Z' packets "), _("\
14409 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
14411 set_remote_protocol_Z_packet_cmd,
14412 show_remote_protocol_Z_packet_cmd,
14413 /* FIXME: i18n: Use of remote protocol
14414 `Z' packets is %s. */
14415 &remote_set_cmdlist, &remote_show_cmdlist);
14417 add_prefix_cmd ("remote", class_files, remote_command, _("\
14418 Manipulate files on the remote system\n\
14419 Transfer files to and from the remote target system."),
14420 &remote_cmdlist, "remote ",
14421 0 /* allow-unknown */, &cmdlist);
14423 add_cmd ("put", class_files, remote_put_command,
14424 _("Copy a local file to the remote system."),
14427 add_cmd ("get", class_files, remote_get_command,
14428 _("Copy a remote file to the local system."),
14431 add_cmd ("delete", class_files, remote_delete_command,
14432 _("Delete a remote file."),
14435 add_setshow_string_noescape_cmd ("exec-file", class_files,
14436 &remote_exec_file_var, _("\
14437 Set the remote pathname for \"run\""), _("\
14438 Show the remote pathname for \"run\""), NULL,
14439 set_remote_exec_file,
14440 show_remote_exec_file,
14441 &remote_set_cmdlist,
14442 &remote_show_cmdlist);
14444 add_setshow_boolean_cmd ("range-stepping", class_run,
14445 &use_range_stepping, _("\
14446 Enable or disable range stepping."), _("\
14447 Show whether target-assisted range stepping is enabled."), _("\
14448 If on, and the target supports it, when stepping a source line, GDB\n\
14449 tells the target to step the corresponding range of addresses itself instead\n\
14450 of issuing multiple single-steps. This speeds up source level\n\
14451 stepping. If off, GDB always issues single-steps, even if range\n\
14452 stepping is supported by the target. The default is on."),
14453 set_range_stepping,
14454 show_range_stepping,
14458 /* Eventually initialize fileio. See fileio.c */
14459 initialize_remote_fileio (remote_set_cmdlist, remote_show_cmdlist);
14461 /* Take advantage of the fact that the TID field is not used, to tag
14462 special ptids with it set to != 0. */
14463 magic_null_ptid = ptid_build (42000, -1, 1);
14464 not_sent_ptid = ptid_build (42000, -2, 1);
14465 any_thread_ptid = ptid_build (42000, 0, 1);
14467 target_buf_size = 2048;
14468 target_buf = (char *) xmalloc (target_buf_size);