1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2012 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. */
23 #include "gdb_string.h"
29 #include "exceptions.h"
31 /*#include "terminal.h" */
34 #include "gdb-stabs.h"
35 #include "gdbthread.h"
39 #include "gdb_assert.h"
42 #include "cli/cli-decode.h"
43 #include "cli/cli-setshow.h"
44 #include "target-descriptions.h"
49 #include "event-loop.h"
50 #include "event-top.h"
56 #include "gdbcore.h" /* for exec_bfd */
58 #include "remote-fileio.h"
59 #include "gdb/fileio.h"
61 #include "xml-support.h"
63 #include "memory-map.h"
65 #include "tracepoint.h"
70 /* Temp hacks for tracepoint encoding migration. */
71 static char *target_buf
;
72 static long target_buf_size
;
74 /* The size to align memory write packets, when practical. The protocol
75 does not guarantee any alignment, and gdb will generate short
76 writes and unaligned writes, but even as a best-effort attempt this
77 can improve bulk transfers. For instance, if a write is misaligned
78 relative to the target's data bus, the stub may need to make an extra
79 round trip fetching data from the target. This doesn't make a
80 huge difference, but it's easy to do, so we try to be helpful.
82 The alignment chosen is arbitrary; usually data bus width is
83 important here, not the possibly larger cache line size. */
84 enum { REMOTE_ALIGN_WRITES
= 16 };
86 /* Prototypes for local functions. */
87 static void cleanup_sigint_signal_handler (void *dummy
);
88 static void initialize_sigint_signal_handler (void);
89 static int getpkt_sane (char **buf
, long *sizeof_buf
, int forever
);
90 static int getpkt_or_notif_sane (char **buf
, long *sizeof_buf
,
93 static void handle_remote_sigint (int);
94 static void handle_remote_sigint_twice (int);
95 static void async_remote_interrupt (gdb_client_data
);
96 void async_remote_interrupt_twice (gdb_client_data
);
98 static void remote_files_info (struct target_ops
*ignore
);
100 static void remote_prepare_to_store (struct regcache
*regcache
);
102 static void remote_open (char *name
, int from_tty
);
104 static void extended_remote_open (char *name
, int from_tty
);
106 static void remote_open_1 (char *, int, struct target_ops
*, int extended_p
);
108 static void remote_close (int quitting
);
110 static void remote_mourn (struct target_ops
*ops
);
112 static void extended_remote_restart (void);
114 static void extended_remote_mourn (struct target_ops
*);
116 static void remote_mourn_1 (struct target_ops
*);
118 static void remote_send (char **buf
, long *sizeof_buf_p
);
120 static int readchar (int timeout
);
122 static void remote_kill (struct target_ops
*ops
);
124 static int tohex (int nib
);
126 static int remote_can_async_p (void);
128 static int remote_is_async_p (void);
130 static void remote_async (void (*callback
) (enum inferior_event_type event_type
,
131 void *context
), void *context
);
133 static void remote_detach (struct target_ops
*ops
, char *args
, int from_tty
);
135 static void remote_interrupt (int signo
);
137 static void remote_interrupt_twice (int signo
);
139 static void interrupt_query (void);
141 static void set_general_thread (struct ptid ptid
);
142 static void set_continue_thread (struct ptid ptid
);
144 static void get_offsets (void);
146 static void skip_frame (void);
148 static long read_frame (char **buf_p
, long *sizeof_buf
);
150 static int hexnumlen (ULONGEST num
);
152 static void init_remote_ops (void);
154 static void init_extended_remote_ops (void);
156 static void remote_stop (ptid_t
);
158 static int ishex (int ch
, int *val
);
160 static int stubhex (int ch
);
162 static int hexnumstr (char *, ULONGEST
);
164 static int hexnumnstr (char *, ULONGEST
, int);
166 static CORE_ADDR
remote_address_masked (CORE_ADDR
);
168 static void print_packet (char *);
170 static void compare_sections_command (char *, int);
172 static void packet_command (char *, int);
174 static int stub_unpack_int (char *buff
, int fieldlength
);
176 static ptid_t
remote_current_thread (ptid_t oldptid
);
178 static void remote_find_new_threads (void);
180 static void record_currthread (ptid_t currthread
);
182 static int fromhex (int a
);
184 extern int hex2bin (const char *hex
, gdb_byte
*bin
, int count
);
186 extern int bin2hex (const gdb_byte
*bin
, char *hex
, int count
);
188 static int putpkt_binary (char *buf
, int cnt
);
190 static void check_binary_download (CORE_ADDR addr
);
192 struct packet_config
;
194 static void show_packet_config_cmd (struct packet_config
*config
);
196 static void update_packet_config (struct packet_config
*config
);
198 static void set_remote_protocol_packet_cmd (char *args
, int from_tty
,
199 struct cmd_list_element
*c
);
201 static void show_remote_protocol_packet_cmd (struct ui_file
*file
,
203 struct cmd_list_element
*c
,
206 static char *write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
);
207 static ptid_t
read_ptid (char *buf
, char **obuf
);
209 static void remote_set_permissions (void);
212 static int remote_get_trace_status (struct trace_status
*ts
);
214 static int remote_upload_tracepoints (struct uploaded_tp
**utpp
);
216 static int remote_upload_trace_state_variables (struct uploaded_tsv
**utsvp
);
218 static void remote_query_supported (void);
220 static void remote_check_symbols (struct objfile
*objfile
);
222 void _initialize_remote (void);
225 static struct stop_reply
*stop_reply_xmalloc (void);
226 static void stop_reply_xfree (struct stop_reply
*);
227 static void do_stop_reply_xfree (void *arg
);
228 static void remote_parse_stop_reply (char *buf
, struct stop_reply
*);
229 static void push_stop_reply (struct stop_reply
*);
230 static void remote_get_pending_stop_replies (void);
231 static void discard_pending_stop_replies (int pid
);
232 static int peek_stop_reply (ptid_t ptid
);
234 static void remote_async_inferior_event_handler (gdb_client_data
);
235 static void remote_async_get_pending_events_handler (gdb_client_data
);
237 static void remote_terminal_ours (void);
239 static int remote_read_description_p (struct target_ops
*target
);
241 static void remote_console_output (char *msg
);
243 static int remote_supports_cond_breakpoints (void);
245 /* The non-stop remote protocol provisions for one pending stop reply.
246 This is where we keep it until it is acknowledged. */
248 static struct stop_reply
*pending_stop_reply
= NULL
;
252 static struct cmd_list_element
*remote_cmdlist
;
254 /* For "set remote" and "show remote". */
256 static struct cmd_list_element
*remote_set_cmdlist
;
257 static struct cmd_list_element
*remote_show_cmdlist
;
259 /* Description of the remote protocol state for the currently
260 connected target. This is per-target state, and independent of the
261 selected architecture. */
265 /* A buffer to use for incoming packets, and its current size. The
266 buffer is grown dynamically for larger incoming packets.
267 Outgoing packets may also be constructed in this buffer.
268 BUF_SIZE is always at least REMOTE_PACKET_SIZE;
269 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
274 /* True if we're going through initial connection setup (finding out
275 about the remote side's threads, relocating symbols, etc.). */
278 /* If we negotiated packet size explicitly (and thus can bypass
279 heuristics for the largest packet size that will not overflow
280 a buffer in the stub), this will be set to that packet size.
281 Otherwise zero, meaning to use the guessed size. */
282 long explicit_packet_size
;
284 /* remote_wait is normally called when the target is running and
285 waits for a stop reply packet. But sometimes we need to call it
286 when the target is already stopped. We can send a "?" packet
287 and have remote_wait read the response. Or, if we already have
288 the response, we can stash it in BUF and tell remote_wait to
289 skip calling getpkt. This flag is set when BUF contains a
290 stop reply packet and the target is not waiting. */
291 int cached_wait_status
;
293 /* True, if in no ack mode. That is, neither GDB nor the stub will
294 expect acks from each other. The connection is assumed to be
298 /* True if we're connected in extended remote mode. */
301 /* True if the stub reported support for multi-process
303 int multi_process_aware
;
305 /* True if we resumed the target and we're waiting for the target to
306 stop. In the mean time, we can't start another command/query.
307 The remote server wouldn't be ready to process it, so we'd
308 timeout waiting for a reply that would never come and eventually
309 we'd close the connection. This can happen in asynchronous mode
310 because we allow GDB commands while the target is running. */
311 int waiting_for_stop_reply
;
313 /* True if the stub reports support for non-stop mode. */
316 /* True if the stub reports support for vCont;t. */
319 /* True if the stub reports support for conditional tracepoints. */
320 int cond_tracepoints
;
322 /* True if the stub reports support for target-side breakpoint
324 int cond_breakpoints
;
326 /* True if the stub reports support for fast tracepoints. */
327 int fast_tracepoints
;
329 /* True if the stub reports support for static tracepoints. */
330 int static_tracepoints
;
332 /* True if the stub reports support for installing tracepoint while
334 int install_in_trace
;
336 /* True if the stub can continue running a trace while GDB is
338 int disconnected_tracing
;
340 /* True if the stub reports support for enabling and disabling
341 tracepoints while a trace experiment is running. */
342 int enable_disable_tracepoints
;
344 /* True if the stub can collect strings using tracenz bytecode. */
347 /* Nonzero if the user has pressed Ctrl-C, but the target hasn't
348 responded to that. */
352 /* Private data that we'll store in (struct thread_info)->private. */
353 struct private_thread_info
360 free_private_thread_info (struct private_thread_info
*info
)
366 /* Returns true if the multi-process extensions are in effect. */
368 remote_multi_process_p (struct remote_state
*rs
)
370 return rs
->multi_process_aware
;
373 /* This data could be associated with a target, but we do not always
374 have access to the current target when we need it, so for now it is
375 static. This will be fine for as long as only one target is in use
377 static struct remote_state remote_state
;
379 static struct remote_state
*
380 get_remote_state_raw (void)
382 return &remote_state
;
385 /* Description of the remote protocol for a given architecture. */
389 long offset
; /* Offset into G packet. */
390 long regnum
; /* GDB's internal register number. */
391 LONGEST pnum
; /* Remote protocol register number. */
392 int in_g_packet
; /* Always part of G packet. */
393 /* long size in bytes; == register_size (target_gdbarch, regnum);
395 /* char *name; == gdbarch_register_name (target_gdbarch, regnum);
399 struct remote_arch_state
401 /* Description of the remote protocol registers. */
402 long sizeof_g_packet
;
404 /* Description of the remote protocol registers indexed by REGNUM
405 (making an array gdbarch_num_regs in size). */
406 struct packet_reg
*regs
;
408 /* This is the size (in chars) of the first response to the ``g''
409 packet. It is used as a heuristic when determining the maximum
410 size of memory-read and memory-write packets. A target will
411 typically only reserve a buffer large enough to hold the ``g''
412 packet. The size does not include packet overhead (headers and
414 long actual_register_packet_size
;
416 /* This is the maximum size (in chars) of a non read/write packet.
417 It is also used as a cap on the size of read/write packets. */
418 long remote_packet_size
;
421 long sizeof_pkt
= 2000;
423 /* Utility: generate error from an incoming stub packet. */
425 trace_error (char *buf
)
428 return; /* not an error msg */
431 case '1': /* malformed packet error */
432 if (*++buf
== '0') /* general case: */
433 error (_("remote.c: error in outgoing packet."));
435 error (_("remote.c: error in outgoing packet at field #%ld."),
436 strtol (buf
, NULL
, 16));
438 error (_("trace API error 0x%s."), ++buf
);
440 error (_("Target returns error code '%s'."), buf
);
444 /* Utility: wait for reply from stub, while accepting "O" packets. */
446 remote_get_noisy_reply (char **buf_p
,
449 do /* Loop on reply from remote stub. */
453 QUIT
; /* Allow user to bail out with ^C. */
454 getpkt (buf_p
, sizeof_buf
, 0);
458 else if (strncmp (buf
, "qRelocInsn:", strlen ("qRelocInsn:")) == 0)
461 CORE_ADDR from
, to
, org_to
;
463 int adjusted_size
= 0;
464 volatile struct gdb_exception ex
;
466 p
= buf
+ strlen ("qRelocInsn:");
467 pp
= unpack_varlen_hex (p
, &ul
);
469 error (_("invalid qRelocInsn packet: %s"), buf
);
473 unpack_varlen_hex (p
, &ul
);
478 TRY_CATCH (ex
, RETURN_MASK_ALL
)
480 gdbarch_relocate_instruction (target_gdbarch
, &to
, from
);
484 adjusted_size
= to
- org_to
;
486 xsnprintf (buf
, *sizeof_buf
, "qRelocInsn:%x", adjusted_size
);
489 else if (ex
.reason
< 0 && ex
.error
== MEMORY_ERROR
)
491 /* Propagate memory errors silently back to the target.
492 The stub may have limited the range of addresses we
493 can write to, for example. */
498 /* Something unexpectedly bad happened. Be verbose so
499 we can tell what, and propagate the error back to the
500 stub, so it doesn't get stuck waiting for a
502 exception_fprintf (gdb_stderr
, ex
,
503 _("warning: relocating instruction: "));
507 else if (buf
[0] == 'O' && buf
[1] != 'K')
508 remote_console_output (buf
+ 1); /* 'O' message from stub */
510 return buf
; /* Here's the actual reply. */
515 /* Handle for retreving the remote protocol data from gdbarch. */
516 static struct gdbarch_data
*remote_gdbarch_data_handle
;
518 static struct remote_arch_state
*
519 get_remote_arch_state (void)
521 return gdbarch_data (target_gdbarch
, remote_gdbarch_data_handle
);
524 /* Fetch the global remote target state. */
526 static struct remote_state
*
527 get_remote_state (void)
529 /* Make sure that the remote architecture state has been
530 initialized, because doing so might reallocate rs->buf. Any
531 function which calls getpkt also needs to be mindful of changes
532 to rs->buf, but this call limits the number of places which run
534 get_remote_arch_state ();
536 return get_remote_state_raw ();
540 compare_pnums (const void *lhs_
, const void *rhs_
)
542 const struct packet_reg
* const *lhs
= lhs_
;
543 const struct packet_reg
* const *rhs
= rhs_
;
545 if ((*lhs
)->pnum
< (*rhs
)->pnum
)
547 else if ((*lhs
)->pnum
== (*rhs
)->pnum
)
554 map_regcache_remote_table (struct gdbarch
*gdbarch
, struct packet_reg
*regs
)
556 int regnum
, num_remote_regs
, offset
;
557 struct packet_reg
**remote_regs
;
559 for (regnum
= 0; regnum
< gdbarch_num_regs (gdbarch
); regnum
++)
561 struct packet_reg
*r
= ®s
[regnum
];
563 if (register_size (gdbarch
, regnum
) == 0)
564 /* Do not try to fetch zero-sized (placeholder) registers. */
567 r
->pnum
= gdbarch_remote_register_number (gdbarch
, regnum
);
572 /* Define the g/G packet format as the contents of each register
573 with a remote protocol number, in order of ascending protocol
576 remote_regs
= alloca (gdbarch_num_regs (gdbarch
)
577 * sizeof (struct packet_reg
*));
578 for (num_remote_regs
= 0, regnum
= 0;
579 regnum
< gdbarch_num_regs (gdbarch
);
581 if (regs
[regnum
].pnum
!= -1)
582 remote_regs
[num_remote_regs
++] = ®s
[regnum
];
584 qsort (remote_regs
, num_remote_regs
, sizeof (struct packet_reg
*),
587 for (regnum
= 0, offset
= 0; regnum
< num_remote_regs
; regnum
++)
589 remote_regs
[regnum
]->in_g_packet
= 1;
590 remote_regs
[regnum
]->offset
= offset
;
591 offset
+= register_size (gdbarch
, remote_regs
[regnum
]->regnum
);
597 /* Given the architecture described by GDBARCH, return the remote
598 protocol register's number and the register's offset in the g/G
599 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
600 If the target does not have a mapping for REGNUM, return false,
601 otherwise, return true. */
604 remote_register_number_and_offset (struct gdbarch
*gdbarch
, int regnum
,
605 int *pnum
, int *poffset
)
608 struct packet_reg
*regs
;
609 struct cleanup
*old_chain
;
611 gdb_assert (regnum
< gdbarch_num_regs (gdbarch
));
613 regs
= xcalloc (gdbarch_num_regs (gdbarch
), sizeof (struct packet_reg
));
614 old_chain
= make_cleanup (xfree
, regs
);
616 sizeof_g_packet
= map_regcache_remote_table (gdbarch
, regs
);
618 *pnum
= regs
[regnum
].pnum
;
619 *poffset
= regs
[regnum
].offset
;
621 do_cleanups (old_chain
);
627 init_remote_state (struct gdbarch
*gdbarch
)
629 struct remote_state
*rs
= get_remote_state_raw ();
630 struct remote_arch_state
*rsa
;
632 rsa
= GDBARCH_OBSTACK_ZALLOC (gdbarch
, struct remote_arch_state
);
634 /* Use the architecture to build a regnum<->pnum table, which will be
635 1:1 unless a feature set specifies otherwise. */
636 rsa
->regs
= GDBARCH_OBSTACK_CALLOC (gdbarch
,
637 gdbarch_num_regs (gdbarch
),
640 /* Record the maximum possible size of the g packet - it may turn out
642 rsa
->sizeof_g_packet
= map_regcache_remote_table (gdbarch
, rsa
->regs
);
644 /* Default maximum number of characters in a packet body. Many
645 remote stubs have a hardwired buffer size of 400 bytes
646 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
647 as the maximum packet-size to ensure that the packet and an extra
648 NUL character can always fit in the buffer. This stops GDB
649 trashing stubs that try to squeeze an extra NUL into what is
650 already a full buffer (As of 1999-12-04 that was most stubs). */
651 rsa
->remote_packet_size
= 400 - 1;
653 /* This one is filled in when a ``g'' packet is received. */
654 rsa
->actual_register_packet_size
= 0;
656 /* Should rsa->sizeof_g_packet needs more space than the
657 default, adjust the size accordingly. Remember that each byte is
658 encoded as two characters. 32 is the overhead for the packet
659 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
660 (``$NN:G...#NN'') is a better guess, the below has been padded a
662 if (rsa
->sizeof_g_packet
> ((rsa
->remote_packet_size
- 32) / 2))
663 rsa
->remote_packet_size
= (rsa
->sizeof_g_packet
* 2 + 32);
665 /* Make sure that the packet buffer is plenty big enough for
666 this architecture. */
667 if (rs
->buf_size
< rsa
->remote_packet_size
)
669 rs
->buf_size
= 2 * rsa
->remote_packet_size
;
670 rs
->buf
= xrealloc (rs
->buf
, rs
->buf_size
);
676 /* Return the current allowed size of a remote packet. This is
677 inferred from the current architecture, and should be used to
678 limit the length of outgoing packets. */
680 get_remote_packet_size (void)
682 struct remote_state
*rs
= get_remote_state ();
683 struct remote_arch_state
*rsa
= get_remote_arch_state ();
685 if (rs
->explicit_packet_size
)
686 return rs
->explicit_packet_size
;
688 return rsa
->remote_packet_size
;
691 static struct packet_reg
*
692 packet_reg_from_regnum (struct remote_arch_state
*rsa
, long regnum
)
694 if (regnum
< 0 && regnum
>= gdbarch_num_regs (target_gdbarch
))
698 struct packet_reg
*r
= &rsa
->regs
[regnum
];
700 gdb_assert (r
->regnum
== regnum
);
705 static struct packet_reg
*
706 packet_reg_from_pnum (struct remote_arch_state
*rsa
, LONGEST pnum
)
710 for (i
= 0; i
< gdbarch_num_regs (target_gdbarch
); i
++)
712 struct packet_reg
*r
= &rsa
->regs
[i
];
720 /* FIXME: graces/2002-08-08: These variables should eventually be
721 bound to an instance of the target object (as in gdbarch-tdep()),
722 when such a thing exists. */
724 /* This is set to the data address of the access causing the target
725 to stop for a watchpoint. */
726 static CORE_ADDR remote_watch_data_address
;
728 /* This is non-zero if target stopped for a watchpoint. */
729 static int remote_stopped_by_watchpoint_p
;
731 static struct target_ops remote_ops
;
733 static struct target_ops extended_remote_ops
;
735 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
736 ``forever'' still use the normal timeout mechanism. This is
737 currently used by the ASYNC code to guarentee that target reads
738 during the initial connect always time-out. Once getpkt has been
739 modified to return a timeout indication and, in turn
740 remote_wait()/wait_for_inferior() have gained a timeout parameter
742 static int wait_forever_enabled_p
= 1;
744 /* Allow the user to specify what sequence to send to the remote
745 when he requests a program interruption: Although ^C is usually
746 what remote systems expect (this is the default, here), it is
747 sometimes preferable to send a break. On other systems such
748 as the Linux kernel, a break followed by g, which is Magic SysRq g
749 is required in order to interrupt the execution. */
750 const char interrupt_sequence_control_c
[] = "Ctrl-C";
751 const char interrupt_sequence_break
[] = "BREAK";
752 const char interrupt_sequence_break_g
[] = "BREAK-g";
753 static const char *const interrupt_sequence_modes
[] =
755 interrupt_sequence_control_c
,
756 interrupt_sequence_break
,
757 interrupt_sequence_break_g
,
760 static const char *interrupt_sequence_mode
= interrupt_sequence_control_c
;
763 show_interrupt_sequence (struct ui_file
*file
, int from_tty
,
764 struct cmd_list_element
*c
,
767 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
768 fprintf_filtered (file
,
769 _("Send the ASCII ETX character (Ctrl-c) "
770 "to the remote target to interrupt the "
771 "execution of the program.\n"));
772 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
773 fprintf_filtered (file
,
774 _("send a break signal to the remote target "
775 "to interrupt the execution of the program.\n"));
776 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
777 fprintf_filtered (file
,
778 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
779 "the remote target to interrupt the execution "
780 "of Linux kernel.\n"));
782 internal_error (__FILE__
, __LINE__
,
783 _("Invalid value for interrupt_sequence_mode: %s."),
784 interrupt_sequence_mode
);
787 /* This boolean variable specifies whether interrupt_sequence is sent
788 to the remote target when gdb connects to it.
789 This is mostly needed when you debug the Linux kernel: The Linux kernel
790 expects BREAK g which is Magic SysRq g for connecting gdb. */
791 static int interrupt_on_connect
= 0;
793 /* This variable is used to implement the "set/show remotebreak" commands.
794 Since these commands are now deprecated in favor of "set/show remote
795 interrupt-sequence", it no longer has any effect on the code. */
796 static int remote_break
;
799 set_remotebreak (char *args
, int from_tty
, struct cmd_list_element
*c
)
802 interrupt_sequence_mode
= interrupt_sequence_break
;
804 interrupt_sequence_mode
= interrupt_sequence_control_c
;
808 show_remotebreak (struct ui_file
*file
, int from_tty
,
809 struct cmd_list_element
*c
,
814 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
815 remote_open knows that we don't have a file open when the program
817 static struct serial
*remote_desc
= NULL
;
819 /* This variable sets the number of bits in an address that are to be
820 sent in a memory ("M" or "m") packet. Normally, after stripping
821 leading zeros, the entire address would be sent. This variable
822 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
823 initial implementation of remote.c restricted the address sent in
824 memory packets to ``host::sizeof long'' bytes - (typically 32
825 bits). Consequently, for 64 bit targets, the upper 32 bits of an
826 address was never sent. Since fixing this bug may cause a break in
827 some remote targets this variable is principly provided to
828 facilitate backward compatibility. */
830 static int remote_address_size
;
832 /* Temporary to track who currently owns the terminal. See
833 remote_terminal_* for more details. */
835 static int remote_async_terminal_ours_p
;
837 /* The executable file to use for "run" on the remote side. */
839 static char *remote_exec_file
= "";
842 /* User configurable variables for the number of characters in a
843 memory read/write packet. MIN (rsa->remote_packet_size,
844 rsa->sizeof_g_packet) is the default. Some targets need smaller
845 values (fifo overruns, et.al.) and some users need larger values
846 (speed up transfers). The variables ``preferred_*'' (the user
847 request), ``current_*'' (what was actually set) and ``forced_*''
848 (Positive - a soft limit, negative - a hard limit). */
850 struct memory_packet_config
857 /* Compute the current size of a read/write packet. Since this makes
858 use of ``actual_register_packet_size'' the computation is dynamic. */
861 get_memory_packet_size (struct memory_packet_config
*config
)
863 struct remote_state
*rs
= get_remote_state ();
864 struct remote_arch_state
*rsa
= get_remote_arch_state ();
866 /* NOTE: The somewhat arbitrary 16k comes from the knowledge (folk
867 law?) that some hosts don't cope very well with large alloca()
868 calls. Eventually the alloca() code will be replaced by calls to
869 xmalloc() and make_cleanups() allowing this restriction to either
870 be lifted or removed. */
871 #ifndef MAX_REMOTE_PACKET_SIZE
872 #define MAX_REMOTE_PACKET_SIZE 16384
874 /* NOTE: 20 ensures we can write at least one byte. */
875 #ifndef MIN_REMOTE_PACKET_SIZE
876 #define MIN_REMOTE_PACKET_SIZE 20
881 if (config
->size
<= 0)
882 what_they_get
= MAX_REMOTE_PACKET_SIZE
;
884 what_they_get
= config
->size
;
888 what_they_get
= get_remote_packet_size ();
889 /* Limit the packet to the size specified by the user. */
891 && what_they_get
> config
->size
)
892 what_they_get
= config
->size
;
894 /* Limit it to the size of the targets ``g'' response unless we have
895 permission from the stub to use a larger packet size. */
896 if (rs
->explicit_packet_size
== 0
897 && rsa
->actual_register_packet_size
> 0
898 && what_they_get
> rsa
->actual_register_packet_size
)
899 what_they_get
= rsa
->actual_register_packet_size
;
901 if (what_they_get
> MAX_REMOTE_PACKET_SIZE
)
902 what_they_get
= MAX_REMOTE_PACKET_SIZE
;
903 if (what_they_get
< MIN_REMOTE_PACKET_SIZE
)
904 what_they_get
= MIN_REMOTE_PACKET_SIZE
;
906 /* Make sure there is room in the global buffer for this packet
907 (including its trailing NUL byte). */
908 if (rs
->buf_size
< what_they_get
+ 1)
910 rs
->buf_size
= 2 * what_they_get
;
911 rs
->buf
= xrealloc (rs
->buf
, 2 * what_they_get
);
914 return what_they_get
;
917 /* Update the size of a read/write packet. If they user wants
918 something really big then do a sanity check. */
921 set_memory_packet_size (char *args
, struct memory_packet_config
*config
)
923 int fixed_p
= config
->fixed_p
;
924 long size
= config
->size
;
927 error (_("Argument required (integer, `fixed' or `limited')."));
928 else if (strcmp (args
, "hard") == 0
929 || strcmp (args
, "fixed") == 0)
931 else if (strcmp (args
, "soft") == 0
932 || strcmp (args
, "limit") == 0)
938 size
= strtoul (args
, &end
, 0);
940 error (_("Invalid %s (bad syntax)."), config
->name
);
942 /* Instead of explicitly capping the size of a packet to
943 MAX_REMOTE_PACKET_SIZE or dissallowing it, the user is
944 instead allowed to set the size to something arbitrarily
946 if (size
> MAX_REMOTE_PACKET_SIZE
)
947 error (_("Invalid %s (too large)."), config
->name
);
951 if (fixed_p
&& !config
->fixed_p
)
953 if (! query (_("The target may not be able to correctly handle a %s\n"
954 "of %ld bytes. Change the packet size? "),
956 error (_("Packet size not changed."));
958 /* Update the config. */
959 config
->fixed_p
= fixed_p
;
964 show_memory_packet_size (struct memory_packet_config
*config
)
966 printf_filtered (_("The %s is %ld. "), config
->name
, config
->size
);
968 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
969 get_memory_packet_size (config
));
971 printf_filtered (_("Packets are limited to %ld bytes.\n"),
972 get_memory_packet_size (config
));
975 static struct memory_packet_config memory_write_packet_config
=
977 "memory-write-packet-size",
981 set_memory_write_packet_size (char *args
, int from_tty
)
983 set_memory_packet_size (args
, &memory_write_packet_config
);
987 show_memory_write_packet_size (char *args
, int from_tty
)
989 show_memory_packet_size (&memory_write_packet_config
);
993 get_memory_write_packet_size (void)
995 return get_memory_packet_size (&memory_write_packet_config
);
998 static struct memory_packet_config memory_read_packet_config
=
1000 "memory-read-packet-size",
1004 set_memory_read_packet_size (char *args
, int from_tty
)
1006 set_memory_packet_size (args
, &memory_read_packet_config
);
1010 show_memory_read_packet_size (char *args
, int from_tty
)
1012 show_memory_packet_size (&memory_read_packet_config
);
1016 get_memory_read_packet_size (void)
1018 long size
= get_memory_packet_size (&memory_read_packet_config
);
1020 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1021 extra buffer size argument before the memory read size can be
1022 increased beyond this. */
1023 if (size
> get_remote_packet_size ())
1024 size
= get_remote_packet_size ();
1029 /* Generic configuration support for packets the stub optionally
1030 supports. Allows the user to specify the use of the packet as well
1031 as allowing GDB to auto-detect support in the remote stub. */
1035 PACKET_SUPPORT_UNKNOWN
= 0,
1040 struct packet_config
1044 enum auto_boolean detect
;
1045 enum packet_support support
;
1048 /* Analyze a packet's return value and update the packet config
1059 update_packet_config (struct packet_config
*config
)
1061 switch (config
->detect
)
1063 case AUTO_BOOLEAN_TRUE
:
1064 config
->support
= PACKET_ENABLE
;
1066 case AUTO_BOOLEAN_FALSE
:
1067 config
->support
= PACKET_DISABLE
;
1069 case AUTO_BOOLEAN_AUTO
:
1070 config
->support
= PACKET_SUPPORT_UNKNOWN
;
1076 show_packet_config_cmd (struct packet_config
*config
)
1078 char *support
= "internal-error";
1080 switch (config
->support
)
1083 support
= "enabled";
1085 case PACKET_DISABLE
:
1086 support
= "disabled";
1088 case PACKET_SUPPORT_UNKNOWN
:
1089 support
= "unknown";
1092 switch (config
->detect
)
1094 case AUTO_BOOLEAN_AUTO
:
1095 printf_filtered (_("Support for the `%s' packet "
1096 "is auto-detected, currently %s.\n"),
1097 config
->name
, support
);
1099 case AUTO_BOOLEAN_TRUE
:
1100 case AUTO_BOOLEAN_FALSE
:
1101 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1102 config
->name
, support
);
1108 add_packet_config_cmd (struct packet_config
*config
, const char *name
,
1109 const char *title
, int legacy
)
1115 config
->name
= name
;
1116 config
->title
= title
;
1117 config
->detect
= AUTO_BOOLEAN_AUTO
;
1118 config
->support
= PACKET_SUPPORT_UNKNOWN
;
1119 set_doc
= xstrprintf ("Set use of remote protocol `%s' (%s) packet",
1121 show_doc
= xstrprintf ("Show current use of remote "
1122 "protocol `%s' (%s) packet",
1124 /* set/show TITLE-packet {auto,on,off} */
1125 cmd_name
= xstrprintf ("%s-packet", title
);
1126 add_setshow_auto_boolean_cmd (cmd_name
, class_obscure
,
1127 &config
->detect
, set_doc
,
1128 show_doc
, NULL
, /* help_doc */
1129 set_remote_protocol_packet_cmd
,
1130 show_remote_protocol_packet_cmd
,
1131 &remote_set_cmdlist
, &remote_show_cmdlist
);
1132 /* The command code copies the documentation strings. */
1135 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1140 legacy_name
= xstrprintf ("%s-packet", name
);
1141 add_alias_cmd (legacy_name
, cmd_name
, class_obscure
, 0,
1142 &remote_set_cmdlist
);
1143 add_alias_cmd (legacy_name
, cmd_name
, class_obscure
, 0,
1144 &remote_show_cmdlist
);
1148 static enum packet_result
1149 packet_check_result (const char *buf
)
1153 /* The stub recognized the packet request. Check that the
1154 operation succeeded. */
1156 && isxdigit (buf
[1]) && isxdigit (buf
[2])
1158 /* "Enn" - definitly an error. */
1159 return PACKET_ERROR
;
1161 /* Always treat "E." as an error. This will be used for
1162 more verbose error messages, such as E.memtypes. */
1163 if (buf
[0] == 'E' && buf
[1] == '.')
1164 return PACKET_ERROR
;
1166 /* The packet may or may not be OK. Just assume it is. */
1170 /* The stub does not support the packet. */
1171 return PACKET_UNKNOWN
;
1174 static enum packet_result
1175 packet_ok (const char *buf
, struct packet_config
*config
)
1177 enum packet_result result
;
1179 result
= packet_check_result (buf
);
1184 /* The stub recognized the packet request. */
1185 switch (config
->support
)
1187 case PACKET_SUPPORT_UNKNOWN
:
1189 fprintf_unfiltered (gdb_stdlog
,
1190 "Packet %s (%s) is supported\n",
1191 config
->name
, config
->title
);
1192 config
->support
= PACKET_ENABLE
;
1194 case PACKET_DISABLE
:
1195 internal_error (__FILE__
, __LINE__
,
1196 _("packet_ok: attempt to use a disabled packet"));
1202 case PACKET_UNKNOWN
:
1203 /* The stub does not support the packet. */
1204 switch (config
->support
)
1207 if (config
->detect
== AUTO_BOOLEAN_AUTO
)
1208 /* If the stub previously indicated that the packet was
1209 supported then there is a protocol error.. */
1210 error (_("Protocol error: %s (%s) conflicting enabled responses."),
1211 config
->name
, config
->title
);
1213 /* The user set it wrong. */
1214 error (_("Enabled packet %s (%s) not recognized by stub"),
1215 config
->name
, config
->title
);
1217 case PACKET_SUPPORT_UNKNOWN
:
1219 fprintf_unfiltered (gdb_stdlog
,
1220 "Packet %s (%s) is NOT supported\n",
1221 config
->name
, config
->title
);
1222 config
->support
= PACKET_DISABLE
;
1224 case PACKET_DISABLE
:
1246 PACKET_vFile_pwrite
,
1248 PACKET_vFile_unlink
,
1249 PACKET_vFile_readlink
,
1251 PACKET_qXfer_features
,
1252 PACKET_qXfer_libraries
,
1253 PACKET_qXfer_libraries_svr4
,
1254 PACKET_qXfer_memory_map
,
1255 PACKET_qXfer_spu_read
,
1256 PACKET_qXfer_spu_write
,
1257 PACKET_qXfer_osdata
,
1258 PACKET_qXfer_threads
,
1259 PACKET_qXfer_statictrace_read
,
1260 PACKET_qXfer_traceframe_info
,
1265 PACKET_QPassSignals
,
1266 PACKET_QProgramSignals
,
1267 PACKET_qSearch_memory
,
1270 PACKET_QStartNoAckMode
,
1272 PACKET_qXfer_siginfo_read
,
1273 PACKET_qXfer_siginfo_write
,
1275 PACKET_ConditionalTracepoints
,
1276 PACKET_ConditionalBreakpoints
,
1277 PACKET_FastTracepoints
,
1278 PACKET_StaticTracepoints
,
1279 PACKET_InstallInTrace
,
1282 PACKET_TracepointSource
,
1285 PACKET_QDisableRandomization
,
1290 static struct packet_config remote_protocol_packets
[PACKET_MAX
];
1293 set_remote_protocol_packet_cmd (char *args
, int from_tty
,
1294 struct cmd_list_element
*c
)
1296 struct packet_config
*packet
;
1298 for (packet
= remote_protocol_packets
;
1299 packet
< &remote_protocol_packets
[PACKET_MAX
];
1302 if (&packet
->detect
== c
->var
)
1304 update_packet_config (packet
);
1308 internal_error (__FILE__
, __LINE__
, _("Could not find config for %s"),
1313 show_remote_protocol_packet_cmd (struct ui_file
*file
, int from_tty
,
1314 struct cmd_list_element
*c
,
1317 struct packet_config
*packet
;
1319 for (packet
= remote_protocol_packets
;
1320 packet
< &remote_protocol_packets
[PACKET_MAX
];
1323 if (&packet
->detect
== c
->var
)
1325 show_packet_config_cmd (packet
);
1329 internal_error (__FILE__
, __LINE__
, _("Could not find config for %s"),
1333 /* Should we try one of the 'Z' requests? */
1337 Z_PACKET_SOFTWARE_BP
,
1338 Z_PACKET_HARDWARE_BP
,
1345 /* For compatibility with older distributions. Provide a ``set remote
1346 Z-packet ...'' command that updates all the Z packet types. */
1348 static enum auto_boolean remote_Z_packet_detect
;
1351 set_remote_protocol_Z_packet_cmd (char *args
, int from_tty
,
1352 struct cmd_list_element
*c
)
1356 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
1358 remote_protocol_packets
[PACKET_Z0
+ i
].detect
= remote_Z_packet_detect
;
1359 update_packet_config (&remote_protocol_packets
[PACKET_Z0
+ i
]);
1364 show_remote_protocol_Z_packet_cmd (struct ui_file
*file
, int from_tty
,
1365 struct cmd_list_element
*c
,
1370 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
1372 show_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
+ i
]);
1376 /* Should we try the 'ThreadInfo' query packet?
1378 This variable (NOT available to the user: auto-detect only!)
1379 determines whether GDB will use the new, simpler "ThreadInfo"
1380 query or the older, more complex syntax for thread queries.
1381 This is an auto-detect variable (set to true at each connect,
1382 and set to false when the target fails to recognize it). */
1384 static int use_threadinfo_query
;
1385 static int use_threadextra_query
;
1387 /* Tokens for use by the asynchronous signal handlers for SIGINT. */
1388 static struct async_signal_handler
*sigint_remote_twice_token
;
1389 static struct async_signal_handler
*sigint_remote_token
;
1392 /* Asynchronous signal handle registered as event loop source for
1393 when we have pending events ready to be passed to the core. */
1395 static struct async_event_handler
*remote_async_inferior_event_token
;
1397 /* Asynchronous signal handle registered as event loop source for when
1398 the remote sent us a %Stop notification. The registered callback
1399 will do a vStopped sequence to pull the rest of the events out of
1400 the remote side into our event queue. */
1402 static struct async_event_handler
*remote_async_get_pending_events_token
;
1405 static ptid_t magic_null_ptid
;
1406 static ptid_t not_sent_ptid
;
1407 static ptid_t any_thread_ptid
;
1409 /* These are the threads which we last sent to the remote system. The
1410 TID member will be -1 for all or -2 for not sent yet. */
1412 static ptid_t general_thread
;
1413 static ptid_t continue_thread
;
1415 /* This the traceframe which we last selected on the remote system.
1416 It will be -1 if no traceframe is selected. */
1417 static int remote_traceframe_number
= -1;
1419 /* Find out if the stub attached to PID (and hence GDB should offer to
1420 detach instead of killing it when bailing out). */
1423 remote_query_attached (int pid
)
1425 struct remote_state
*rs
= get_remote_state ();
1426 size_t size
= get_remote_packet_size ();
1428 if (remote_protocol_packets
[PACKET_qAttached
].support
== PACKET_DISABLE
)
1431 if (remote_multi_process_p (rs
))
1432 xsnprintf (rs
->buf
, size
, "qAttached:%x", pid
);
1434 xsnprintf (rs
->buf
, size
, "qAttached");
1437 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1439 switch (packet_ok (rs
->buf
,
1440 &remote_protocol_packets
[PACKET_qAttached
]))
1443 if (strcmp (rs
->buf
, "1") == 0)
1447 warning (_("Remote failure reply: %s"), rs
->buf
);
1449 case PACKET_UNKNOWN
:
1456 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
1457 has been invented by GDB, instead of reported by the target. Since
1458 we can be connected to a remote system before before knowing about
1459 any inferior, mark the target with execution when we find the first
1460 inferior. If ATTACHED is 1, then we had just attached to this
1461 inferior. If it is 0, then we just created this inferior. If it
1462 is -1, then try querying the remote stub to find out if it had
1463 attached to the inferior or not. */
1465 static struct inferior
*
1466 remote_add_inferior (int fake_pid_p
, int pid
, int attached
)
1468 struct inferior
*inf
;
1470 /* Check whether this process we're learning about is to be
1471 considered attached, or if is to be considered to have been
1472 spawned by the stub. */
1474 attached
= remote_query_attached (pid
);
1476 if (gdbarch_has_global_solist (target_gdbarch
))
1478 /* If the target shares code across all inferiors, then every
1479 attach adds a new inferior. */
1480 inf
= add_inferior (pid
);
1482 /* ... and every inferior is bound to the same program space.
1483 However, each inferior may still have its own address
1485 inf
->aspace
= maybe_new_address_space ();
1486 inf
->pspace
= current_program_space
;
1490 /* In the traditional debugging scenario, there's a 1-1 match
1491 between program/address spaces. We simply bind the inferior
1492 to the program space's address space. */
1493 inf
= current_inferior ();
1494 inferior_appeared (inf
, pid
);
1497 inf
->attach_flag
= attached
;
1498 inf
->fake_pid_p
= fake_pid_p
;
1503 /* Add thread PTID to GDB's thread list. Tag it as executing/running
1504 according to RUNNING. */
1507 remote_add_thread (ptid_t ptid
, int running
)
1511 set_executing (ptid
, running
);
1512 set_running (ptid
, running
);
1515 /* Come here when we learn about a thread id from the remote target.
1516 It may be the first time we hear about such thread, so take the
1517 opportunity to add it to GDB's thread list. In case this is the
1518 first time we're noticing its corresponding inferior, add it to
1519 GDB's inferior list as well. */
1522 remote_notice_new_inferior (ptid_t currthread
, int running
)
1524 /* If this is a new thread, add it to GDB's thread list.
1525 If we leave it up to WFI to do this, bad things will happen. */
1527 if (in_thread_list (currthread
) && is_exited (currthread
))
1529 /* We're seeing an event on a thread id we knew had exited.
1530 This has to be a new thread reusing the old id. Add it. */
1531 remote_add_thread (currthread
, running
);
1535 if (!in_thread_list (currthread
))
1537 struct inferior
*inf
= NULL
;
1538 int pid
= ptid_get_pid (currthread
);
1540 if (ptid_is_pid (inferior_ptid
)
1541 && pid
== ptid_get_pid (inferior_ptid
))
1543 /* inferior_ptid has no thread member yet. This can happen
1544 with the vAttach -> remote_wait,"TAAthread:" path if the
1545 stub doesn't support qC. This is the first stop reported
1546 after an attach, so this is the main thread. Update the
1547 ptid in the thread list. */
1548 if (in_thread_list (pid_to_ptid (pid
)))
1549 thread_change_ptid (inferior_ptid
, currthread
);
1552 remote_add_thread (currthread
, running
);
1553 inferior_ptid
= currthread
;
1558 if (ptid_equal (magic_null_ptid
, inferior_ptid
))
1560 /* inferior_ptid is not set yet. This can happen with the
1561 vRun -> remote_wait,"TAAthread:" path if the stub
1562 doesn't support qC. This is the first stop reported
1563 after an attach, so this is the main thread. Update the
1564 ptid in the thread list. */
1565 thread_change_ptid (inferior_ptid
, currthread
);
1569 /* When connecting to a target remote, or to a target
1570 extended-remote which already was debugging an inferior, we
1571 may not know about it yet. Add it before adding its child
1572 thread, so notifications are emitted in a sensible order. */
1573 if (!in_inferior_list (ptid_get_pid (currthread
)))
1575 struct remote_state
*rs
= get_remote_state ();
1576 int fake_pid_p
= !remote_multi_process_p (rs
);
1578 inf
= remote_add_inferior (fake_pid_p
,
1579 ptid_get_pid (currthread
), -1);
1582 /* This is really a new thread. Add it. */
1583 remote_add_thread (currthread
, running
);
1585 /* If we found a new inferior, let the common code do whatever
1586 it needs to with it (e.g., read shared libraries, insert
1589 notice_new_inferior (currthread
, running
, 0);
1593 /* Return the private thread data, creating it if necessary. */
1595 static struct private_thread_info
*
1596 demand_private_info (ptid_t ptid
)
1598 struct thread_info
*info
= find_thread_ptid (ptid
);
1604 info
->private = xmalloc (sizeof (*(info
->private)));
1605 info
->private_dtor
= free_private_thread_info
;
1606 info
->private->core
= -1;
1607 info
->private->extra
= 0;
1610 return info
->private;
1613 /* Call this function as a result of
1614 1) A halt indication (T packet) containing a thread id
1615 2) A direct query of currthread
1616 3) Successful execution of set thread */
1619 record_currthread (ptid_t currthread
)
1621 general_thread
= currthread
;
1624 static char *last_pass_packet
;
1626 /* If 'QPassSignals' is supported, tell the remote stub what signals
1627 it can simply pass through to the inferior without reporting. */
1630 remote_pass_signals (int numsigs
, unsigned char *pass_signals
)
1632 if (remote_protocol_packets
[PACKET_QPassSignals
].support
!= PACKET_DISABLE
)
1634 char *pass_packet
, *p
;
1637 gdb_assert (numsigs
< 256);
1638 for (i
= 0; i
< numsigs
; i
++)
1640 if (pass_signals
[i
])
1643 pass_packet
= xmalloc (count
* 3 + strlen ("QPassSignals:") + 1);
1644 strcpy (pass_packet
, "QPassSignals:");
1645 p
= pass_packet
+ strlen (pass_packet
);
1646 for (i
= 0; i
< numsigs
; i
++)
1648 if (pass_signals
[i
])
1651 *p
++ = tohex (i
>> 4);
1652 *p
++ = tohex (i
& 15);
1661 if (!last_pass_packet
|| strcmp (last_pass_packet
, pass_packet
))
1663 struct remote_state
*rs
= get_remote_state ();
1664 char *buf
= rs
->buf
;
1666 putpkt (pass_packet
);
1667 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1668 packet_ok (buf
, &remote_protocol_packets
[PACKET_QPassSignals
]);
1669 if (last_pass_packet
)
1670 xfree (last_pass_packet
);
1671 last_pass_packet
= pass_packet
;
1674 xfree (pass_packet
);
1678 /* The last QProgramSignals packet sent to the target. We bypass
1679 sending a new program signals list down to the target if the new
1680 packet is exactly the same as the last we sent. IOW, we only let
1681 the target know about program signals list changes. */
1683 static char *last_program_signals_packet
;
1685 /* If 'QProgramSignals' is supported, tell the remote stub what
1686 signals it should pass through to the inferior when detaching. */
1689 remote_program_signals (int numsigs
, unsigned char *signals
)
1691 if (remote_protocol_packets
[PACKET_QProgramSignals
].support
!= PACKET_DISABLE
)
1696 gdb_assert (numsigs
< 256);
1697 for (i
= 0; i
< numsigs
; i
++)
1702 packet
= xmalloc (count
* 3 + strlen ("QProgramSignals:") + 1);
1703 strcpy (packet
, "QProgramSignals:");
1704 p
= packet
+ strlen (packet
);
1705 for (i
= 0; i
< numsigs
; i
++)
1707 if (signal_pass_state (i
))
1710 *p
++ = tohex (i
>> 4);
1711 *p
++ = tohex (i
& 15);
1720 if (!last_program_signals_packet
1721 || strcmp (last_program_signals_packet
, packet
) != 0)
1723 struct remote_state
*rs
= get_remote_state ();
1724 char *buf
= rs
->buf
;
1727 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1728 packet_ok (buf
, &remote_protocol_packets
[PACKET_QProgramSignals
]);
1729 xfree (last_program_signals_packet
);
1730 last_program_signals_packet
= packet
;
1737 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
1738 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
1739 thread. If GEN is set, set the general thread, if not, then set
1740 the step/continue thread. */
1742 set_thread (struct ptid ptid
, int gen
)
1744 struct remote_state
*rs
= get_remote_state ();
1745 ptid_t state
= gen
? general_thread
: continue_thread
;
1746 char *buf
= rs
->buf
;
1747 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
1749 if (ptid_equal (state
, ptid
))
1753 *buf
++ = gen
? 'g' : 'c';
1754 if (ptid_equal (ptid
, magic_null_ptid
))
1755 xsnprintf (buf
, endbuf
- buf
, "0");
1756 else if (ptid_equal (ptid
, any_thread_ptid
))
1757 xsnprintf (buf
, endbuf
- buf
, "0");
1758 else if (ptid_equal (ptid
, minus_one_ptid
))
1759 xsnprintf (buf
, endbuf
- buf
, "-1");
1761 write_ptid (buf
, endbuf
, ptid
);
1763 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1765 general_thread
= ptid
;
1767 continue_thread
= ptid
;
1771 set_general_thread (struct ptid ptid
)
1773 set_thread (ptid
, 1);
1777 set_continue_thread (struct ptid ptid
)
1779 set_thread (ptid
, 0);
1782 /* Change the remote current process. Which thread within the process
1783 ends up selected isn't important, as long as it is the same process
1784 as what INFERIOR_PTID points to.
1786 This comes from that fact that there is no explicit notion of
1787 "selected process" in the protocol. The selected process for
1788 general operations is the process the selected general thread
1792 set_general_process (void)
1794 struct remote_state
*rs
= get_remote_state ();
1796 /* If the remote can't handle multiple processes, don't bother. */
1797 if (!rs
->extended
|| !remote_multi_process_p (rs
))
1800 /* We only need to change the remote current thread if it's pointing
1801 at some other process. */
1802 if (ptid_get_pid (general_thread
) != ptid_get_pid (inferior_ptid
))
1803 set_general_thread (inferior_ptid
);
1807 /* Return nonzero if the thread PTID is still alive on the remote
1811 remote_thread_alive (struct target_ops
*ops
, ptid_t ptid
)
1813 struct remote_state
*rs
= get_remote_state ();
1816 if (ptid_equal (ptid
, magic_null_ptid
))
1817 /* The main thread is always alive. */
1820 if (ptid_get_pid (ptid
) != 0 && ptid_get_tid (ptid
) == 0)
1821 /* The main thread is always alive. This can happen after a
1822 vAttach, if the remote side doesn't support
1827 endp
= rs
->buf
+ get_remote_packet_size ();
1830 write_ptid (p
, endp
, ptid
);
1833 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1834 return (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K');
1837 /* About these extended threadlist and threadinfo packets. They are
1838 variable length packets but, the fields within them are often fixed
1839 length. They are redundent enough to send over UDP as is the
1840 remote protocol in general. There is a matching unit test module
1843 #define OPAQUETHREADBYTES 8
1845 /* a 64 bit opaque identifier */
1846 typedef unsigned char threadref
[OPAQUETHREADBYTES
];
1848 /* WARNING: This threadref data structure comes from the remote O.S.,
1849 libstub protocol encoding, and remote.c. It is not particularly
1852 /* Right now, the internal structure is int. We want it to be bigger.
1853 Plan to fix this. */
1855 typedef int gdb_threadref
; /* Internal GDB thread reference. */
1857 /* gdb_ext_thread_info is an internal GDB data structure which is
1858 equivalent to the reply of the remote threadinfo packet. */
1860 struct gdb_ext_thread_info
1862 threadref threadid
; /* External form of thread reference. */
1863 int active
; /* Has state interesting to GDB?
1865 char display
[256]; /* Brief state display, name,
1866 blocked/suspended. */
1867 char shortname
[32]; /* To be used to name threads. */
1868 char more_display
[256]; /* Long info, statistics, queue depth,
1872 /* The volume of remote transfers can be limited by submitting
1873 a mask containing bits specifying the desired information.
1874 Use a union of these values as the 'selection' parameter to
1875 get_thread_info. FIXME: Make these TAG names more thread specific. */
1877 #define TAG_THREADID 1
1878 #define TAG_EXISTS 2
1879 #define TAG_DISPLAY 4
1880 #define TAG_THREADNAME 8
1881 #define TAG_MOREDISPLAY 16
1883 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
1885 char *unpack_varlen_hex (char *buff
, ULONGEST
*result
);
1887 static char *unpack_nibble (char *buf
, int *val
);
1889 static char *pack_nibble (char *buf
, int nibble
);
1891 static char *pack_hex_byte (char *pkt
, int /* unsigned char */ byte
);
1893 static char *unpack_byte (char *buf
, int *value
);
1895 static char *pack_int (char *buf
, int value
);
1897 static char *unpack_int (char *buf
, int *value
);
1899 static char *unpack_string (char *src
, char *dest
, int length
);
1901 static char *pack_threadid (char *pkt
, threadref
*id
);
1903 static char *unpack_threadid (char *inbuf
, threadref
*id
);
1905 void int_to_threadref (threadref
*id
, int value
);
1907 static int threadref_to_int (threadref
*ref
);
1909 static void copy_threadref (threadref
*dest
, threadref
*src
);
1911 static int threadmatch (threadref
*dest
, threadref
*src
);
1913 static char *pack_threadinfo_request (char *pkt
, int mode
,
1916 static int remote_unpack_thread_info_response (char *pkt
,
1917 threadref
*expectedref
,
1918 struct gdb_ext_thread_info
1922 static int remote_get_threadinfo (threadref
*threadid
,
1923 int fieldset
, /*TAG mask */
1924 struct gdb_ext_thread_info
*info
);
1926 static char *pack_threadlist_request (char *pkt
, int startflag
,
1928 threadref
*nextthread
);
1930 static int parse_threadlist_response (char *pkt
,
1932 threadref
*original_echo
,
1933 threadref
*resultlist
,
1936 static int remote_get_threadlist (int startflag
,
1937 threadref
*nextthread
,
1941 threadref
*threadlist
);
1943 typedef int (*rmt_thread_action
) (threadref
*ref
, void *context
);
1945 static int remote_threadlist_iterator (rmt_thread_action stepfunction
,
1946 void *context
, int looplimit
);
1948 static int remote_newthread_step (threadref
*ref
, void *context
);
1951 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
1952 buffer we're allowed to write to. Returns
1953 BUF+CHARACTERS_WRITTEN. */
1956 write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
)
1959 struct remote_state
*rs
= get_remote_state ();
1961 if (remote_multi_process_p (rs
))
1963 pid
= ptid_get_pid (ptid
);
1965 buf
+= xsnprintf (buf
, endbuf
- buf
, "p-%x.", -pid
);
1967 buf
+= xsnprintf (buf
, endbuf
- buf
, "p%x.", pid
);
1969 tid
= ptid_get_tid (ptid
);
1971 buf
+= xsnprintf (buf
, endbuf
- buf
, "-%x", -tid
);
1973 buf
+= xsnprintf (buf
, endbuf
- buf
, "%x", tid
);
1978 /* Extract a PTID from BUF. If non-null, OBUF is set to the to one
1979 passed the last parsed char. Returns null_ptid on error. */
1982 read_ptid (char *buf
, char **obuf
)
1986 ULONGEST pid
= 0, tid
= 0;
1990 /* Multi-process ptid. */
1991 pp
= unpack_varlen_hex (p
+ 1, &pid
);
1993 error (_("invalid remote ptid: %s"), p
);
1996 pp
= unpack_varlen_hex (p
+ 1, &tid
);
1999 return ptid_build (pid
, 0, tid
);
2002 /* No multi-process. Just a tid. */
2003 pp
= unpack_varlen_hex (p
, &tid
);
2005 /* Since the stub is not sending a process id, then default to
2006 what's in inferior_ptid, unless it's null at this point. If so,
2007 then since there's no way to know the pid of the reported
2008 threads, use the magic number. */
2009 if (ptid_equal (inferior_ptid
, null_ptid
))
2010 pid
= ptid_get_pid (magic_null_ptid
);
2012 pid
= ptid_get_pid (inferior_ptid
);
2016 return ptid_build (pid
, 0, tid
);
2019 /* Encode 64 bits in 16 chars of hex. */
2021 static const char hexchars
[] = "0123456789abcdef";
2024 ishex (int ch
, int *val
)
2026 if ((ch
>= 'a') && (ch
<= 'f'))
2028 *val
= ch
- 'a' + 10;
2031 if ((ch
>= 'A') && (ch
<= 'F'))
2033 *val
= ch
- 'A' + 10;
2036 if ((ch
>= '0') && (ch
<= '9'))
2047 if (ch
>= 'a' && ch
<= 'f')
2048 return ch
- 'a' + 10;
2049 if (ch
>= '0' && ch
<= '9')
2051 if (ch
>= 'A' && ch
<= 'F')
2052 return ch
- 'A' + 10;
2057 stub_unpack_int (char *buff
, int fieldlength
)
2064 nibble
= stubhex (*buff
++);
2068 retval
= retval
<< 4;
2074 unpack_varlen_hex (char *buff
, /* packet to parse */
2078 ULONGEST retval
= 0;
2080 while (ishex (*buff
, &nibble
))
2083 retval
= retval
<< 4;
2084 retval
|= nibble
& 0x0f;
2091 unpack_nibble (char *buf
, int *val
)
2093 *val
= fromhex (*buf
++);
2098 pack_nibble (char *buf
, int nibble
)
2100 *buf
++ = hexchars
[(nibble
& 0x0f)];
2105 pack_hex_byte (char *pkt
, int byte
)
2107 *pkt
++ = hexchars
[(byte
>> 4) & 0xf];
2108 *pkt
++ = hexchars
[(byte
& 0xf)];
2113 unpack_byte (char *buf
, int *value
)
2115 *value
= stub_unpack_int (buf
, 2);
2120 pack_int (char *buf
, int value
)
2122 buf
= pack_hex_byte (buf
, (value
>> 24) & 0xff);
2123 buf
= pack_hex_byte (buf
, (value
>> 16) & 0xff);
2124 buf
= pack_hex_byte (buf
, (value
>> 8) & 0x0ff);
2125 buf
= pack_hex_byte (buf
, (value
& 0xff));
2130 unpack_int (char *buf
, int *value
)
2132 *value
= stub_unpack_int (buf
, 8);
2136 #if 0 /* Currently unused, uncomment when needed. */
2137 static char *pack_string (char *pkt
, char *string
);
2140 pack_string (char *pkt
, char *string
)
2145 len
= strlen (string
);
2147 len
= 200; /* Bigger than most GDB packets, junk??? */
2148 pkt
= pack_hex_byte (pkt
, len
);
2152 if ((ch
== '\0') || (ch
== '#'))
2153 ch
= '*'; /* Protect encapsulation. */
2158 #endif /* 0 (unused) */
2161 unpack_string (char *src
, char *dest
, int length
)
2170 pack_threadid (char *pkt
, threadref
*id
)
2173 unsigned char *altid
;
2175 altid
= (unsigned char *) id
;
2176 limit
= pkt
+ BUF_THREAD_ID_SIZE
;
2178 pkt
= pack_hex_byte (pkt
, *altid
++);
2184 unpack_threadid (char *inbuf
, threadref
*id
)
2187 char *limit
= inbuf
+ BUF_THREAD_ID_SIZE
;
2190 altref
= (char *) id
;
2192 while (inbuf
< limit
)
2194 x
= stubhex (*inbuf
++);
2195 y
= stubhex (*inbuf
++);
2196 *altref
++ = (x
<< 4) | y
;
2201 /* Externally, threadrefs are 64 bits but internally, they are still
2202 ints. This is due to a mismatch of specifications. We would like
2203 to use 64bit thread references internally. This is an adapter
2207 int_to_threadref (threadref
*id
, int value
)
2209 unsigned char *scan
;
2211 scan
= (unsigned char *) id
;
2217 *scan
++ = (value
>> 24) & 0xff;
2218 *scan
++ = (value
>> 16) & 0xff;
2219 *scan
++ = (value
>> 8) & 0xff;
2220 *scan
++ = (value
& 0xff);
2224 threadref_to_int (threadref
*ref
)
2227 unsigned char *scan
;
2233 value
= (value
<< 8) | ((*scan
++) & 0xff);
2238 copy_threadref (threadref
*dest
, threadref
*src
)
2241 unsigned char *csrc
, *cdest
;
2243 csrc
= (unsigned char *) src
;
2244 cdest
= (unsigned char *) dest
;
2251 threadmatch (threadref
*dest
, threadref
*src
)
2253 /* Things are broken right now, so just assume we got a match. */
2255 unsigned char *srcp
, *destp
;
2257 srcp
= (char *) src
;
2258 destp
= (char *) dest
;
2262 result
&= (*srcp
++ == *destp
++) ? 1 : 0;
2269 threadid:1, # always request threadid
2276 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
2279 pack_threadinfo_request (char *pkt
, int mode
, threadref
*id
)
2281 *pkt
++ = 'q'; /* Info Query */
2282 *pkt
++ = 'P'; /* process or thread info */
2283 pkt
= pack_int (pkt
, mode
); /* mode */
2284 pkt
= pack_threadid (pkt
, id
); /* threadid */
2285 *pkt
= '\0'; /* terminate */
2289 /* These values tag the fields in a thread info response packet. */
2290 /* Tagging the fields allows us to request specific fields and to
2291 add more fields as time goes by. */
2293 #define TAG_THREADID 1 /* Echo the thread identifier. */
2294 #define TAG_EXISTS 2 /* Is this process defined enough to
2295 fetch registers and its stack? */
2296 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
2297 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
2298 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
2302 remote_unpack_thread_info_response (char *pkt
, threadref
*expectedref
,
2303 struct gdb_ext_thread_info
*info
)
2305 struct remote_state
*rs
= get_remote_state ();
2309 char *limit
= pkt
+ rs
->buf_size
; /* Plausible parsing limit. */
2312 /* info->threadid = 0; FIXME: implement zero_threadref. */
2314 info
->display
[0] = '\0';
2315 info
->shortname
[0] = '\0';
2316 info
->more_display
[0] = '\0';
2318 /* Assume the characters indicating the packet type have been
2320 pkt
= unpack_int (pkt
, &mask
); /* arg mask */
2321 pkt
= unpack_threadid (pkt
, &ref
);
2324 warning (_("Incomplete response to threadinfo request."));
2325 if (!threadmatch (&ref
, expectedref
))
2326 { /* This is an answer to a different request. */
2327 warning (_("ERROR RMT Thread info mismatch."));
2330 copy_threadref (&info
->threadid
, &ref
);
2332 /* Loop on tagged fields , try to bail if somthing goes wrong. */
2334 /* Packets are terminated with nulls. */
2335 while ((pkt
< limit
) && mask
&& *pkt
)
2337 pkt
= unpack_int (pkt
, &tag
); /* tag */
2338 pkt
= unpack_byte (pkt
, &length
); /* length */
2339 if (!(tag
& mask
)) /* Tags out of synch with mask. */
2341 warning (_("ERROR RMT: threadinfo tag mismatch."));
2345 if (tag
== TAG_THREADID
)
2349 warning (_("ERROR RMT: length of threadid is not 16."));
2353 pkt
= unpack_threadid (pkt
, &ref
);
2354 mask
= mask
& ~TAG_THREADID
;
2357 if (tag
== TAG_EXISTS
)
2359 info
->active
= stub_unpack_int (pkt
, length
);
2361 mask
= mask
& ~(TAG_EXISTS
);
2364 warning (_("ERROR RMT: 'exists' length too long."));
2370 if (tag
== TAG_THREADNAME
)
2372 pkt
= unpack_string (pkt
, &info
->shortname
[0], length
);
2373 mask
= mask
& ~TAG_THREADNAME
;
2376 if (tag
== TAG_DISPLAY
)
2378 pkt
= unpack_string (pkt
, &info
->display
[0], length
);
2379 mask
= mask
& ~TAG_DISPLAY
;
2382 if (tag
== TAG_MOREDISPLAY
)
2384 pkt
= unpack_string (pkt
, &info
->more_display
[0], length
);
2385 mask
= mask
& ~TAG_MOREDISPLAY
;
2388 warning (_("ERROR RMT: unknown thread info tag."));
2389 break; /* Not a tag we know about. */
2395 remote_get_threadinfo (threadref
*threadid
, int fieldset
, /* TAG mask */
2396 struct gdb_ext_thread_info
*info
)
2398 struct remote_state
*rs
= get_remote_state ();
2401 pack_threadinfo_request (rs
->buf
, fieldset
, threadid
);
2403 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2405 if (rs
->buf
[0] == '\0')
2408 result
= remote_unpack_thread_info_response (rs
->buf
+ 2,
2413 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
2416 pack_threadlist_request (char *pkt
, int startflag
, int threadcount
,
2417 threadref
*nextthread
)
2419 *pkt
++ = 'q'; /* info query packet */
2420 *pkt
++ = 'L'; /* Process LIST or threadLIST request */
2421 pkt
= pack_nibble (pkt
, startflag
); /* initflag 1 bytes */
2422 pkt
= pack_hex_byte (pkt
, threadcount
); /* threadcount 2 bytes */
2423 pkt
= pack_threadid (pkt
, nextthread
); /* 64 bit thread identifier */
2428 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
2431 parse_threadlist_response (char *pkt
, int result_limit
,
2432 threadref
*original_echo
, threadref
*resultlist
,
2435 struct remote_state
*rs
= get_remote_state ();
2437 int count
, resultcount
, done
;
2440 /* Assume the 'q' and 'M chars have been stripped. */
2441 limit
= pkt
+ (rs
->buf_size
- BUF_THREAD_ID_SIZE
);
2442 /* done parse past here */
2443 pkt
= unpack_byte (pkt
, &count
); /* count field */
2444 pkt
= unpack_nibble (pkt
, &done
);
2445 /* The first threadid is the argument threadid. */
2446 pkt
= unpack_threadid (pkt
, original_echo
); /* should match query packet */
2447 while ((count
-- > 0) && (pkt
< limit
))
2449 pkt
= unpack_threadid (pkt
, resultlist
++);
2450 if (resultcount
++ >= result_limit
)
2459 remote_get_threadlist (int startflag
, threadref
*nextthread
, int result_limit
,
2460 int *done
, int *result_count
, threadref
*threadlist
)
2462 struct remote_state
*rs
= get_remote_state ();
2463 static threadref echo_nextthread
;
2466 /* Trancate result limit to be smaller than the packet size. */
2467 if ((((result_limit
+ 1) * BUF_THREAD_ID_SIZE
) + 10)
2468 >= get_remote_packet_size ())
2469 result_limit
= (get_remote_packet_size () / BUF_THREAD_ID_SIZE
) - 2;
2471 pack_threadlist_request (rs
->buf
, startflag
, result_limit
, nextthread
);
2473 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2475 if (*rs
->buf
== '\0')
2479 parse_threadlist_response (rs
->buf
+ 2, result_limit
, &echo_nextthread
,
2482 if (!threadmatch (&echo_nextthread
, nextthread
))
2484 /* FIXME: This is a good reason to drop the packet. */
2485 /* Possably, there is a duplicate response. */
2487 retransmit immediatly - race conditions
2488 retransmit after timeout - yes
2490 wait for packet, then exit
2492 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
2493 return 0; /* I choose simply exiting. */
2495 if (*result_count
<= 0)
2499 warning (_("RMT ERROR : failed to get remote thread list."));
2502 return result
; /* break; */
2504 if (*result_count
> result_limit
)
2507 warning (_("RMT ERROR: threadlist response longer than requested."));
2513 /* This is the interface between remote and threads, remotes upper
2516 /* remote_find_new_threads retrieves the thread list and for each
2517 thread in the list, looks up the thread in GDB's internal list,
2518 adding the thread if it does not already exist. This involves
2519 getting partial thread lists from the remote target so, polling the
2520 quit_flag is required. */
2523 /* About this many threadisds fit in a packet. */
2525 #define MAXTHREADLISTRESULTS 32
2528 remote_threadlist_iterator (rmt_thread_action stepfunction
, void *context
,
2531 int done
, i
, result_count
;
2535 static threadref nextthread
;
2536 static threadref resultthreadlist
[MAXTHREADLISTRESULTS
];
2541 if (loopcount
++ > looplimit
)
2544 warning (_("Remote fetch threadlist -infinite loop-."));
2547 if (!remote_get_threadlist (startflag
, &nextthread
, MAXTHREADLISTRESULTS
,
2548 &done
, &result_count
, resultthreadlist
))
2553 /* Clear for later iterations. */
2555 /* Setup to resume next batch of thread references, set nextthread. */
2556 if (result_count
>= 1)
2557 copy_threadref (&nextthread
, &resultthreadlist
[result_count
- 1]);
2559 while (result_count
--)
2560 if (!(result
= (*stepfunction
) (&resultthreadlist
[i
++], context
)))
2567 remote_newthread_step (threadref
*ref
, void *context
)
2569 int pid
= ptid_get_pid (inferior_ptid
);
2570 ptid_t ptid
= ptid_build (pid
, 0, threadref_to_int (ref
));
2572 if (!in_thread_list (ptid
))
2574 return 1; /* continue iterator */
2577 #define CRAZY_MAX_THREADS 1000
2580 remote_current_thread (ptid_t oldpid
)
2582 struct remote_state
*rs
= get_remote_state ();
2585 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2586 if (rs
->buf
[0] == 'Q' && rs
->buf
[1] == 'C')
2587 return read_ptid (&rs
->buf
[2], NULL
);
2592 /* Find new threads for info threads command.
2593 * Original version, using John Metzler's thread protocol.
2597 remote_find_new_threads (void)
2599 remote_threadlist_iterator (remote_newthread_step
, 0,
2603 #if defined(HAVE_LIBEXPAT)
2605 typedef struct thread_item
2611 DEF_VEC_O(thread_item_t
);
2613 struct threads_parsing_context
2615 VEC (thread_item_t
) *items
;
2619 start_thread (struct gdb_xml_parser
*parser
,
2620 const struct gdb_xml_element
*element
,
2621 void *user_data
, VEC(gdb_xml_value_s
) *attributes
)
2623 struct threads_parsing_context
*data
= user_data
;
2625 struct thread_item item
;
2627 struct gdb_xml_value
*attr
;
2629 id
= xml_find_attribute (attributes
, "id")->value
;
2630 item
.ptid
= read_ptid (id
, NULL
);
2632 attr
= xml_find_attribute (attributes
, "core");
2634 item
.core
= *(ULONGEST
*) attr
->value
;
2640 VEC_safe_push (thread_item_t
, data
->items
, &item
);
2644 end_thread (struct gdb_xml_parser
*parser
,
2645 const struct gdb_xml_element
*element
,
2646 void *user_data
, const char *body_text
)
2648 struct threads_parsing_context
*data
= user_data
;
2650 if (body_text
&& *body_text
)
2651 VEC_last (thread_item_t
, data
->items
)->extra
= xstrdup (body_text
);
2654 const struct gdb_xml_attribute thread_attributes
[] = {
2655 { "id", GDB_XML_AF_NONE
, NULL
, NULL
},
2656 { "core", GDB_XML_AF_OPTIONAL
, gdb_xml_parse_attr_ulongest
, NULL
},
2657 { NULL
, GDB_XML_AF_NONE
, NULL
, NULL
}
2660 const struct gdb_xml_element thread_children
[] = {
2661 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
2664 const struct gdb_xml_element threads_children
[] = {
2665 { "thread", thread_attributes
, thread_children
,
2666 GDB_XML_EF_REPEATABLE
| GDB_XML_EF_OPTIONAL
,
2667 start_thread
, end_thread
},
2668 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
2671 const struct gdb_xml_element threads_elements
[] = {
2672 { "threads", NULL
, threads_children
,
2673 GDB_XML_EF_NONE
, NULL
, NULL
},
2674 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
2677 /* Discard the contents of the constructed thread info context. */
2680 clear_threads_parsing_context (void *p
)
2682 struct threads_parsing_context
*context
= p
;
2684 struct thread_item
*item
;
2686 for (i
= 0; VEC_iterate (thread_item_t
, context
->items
, i
, item
); ++i
)
2687 xfree (item
->extra
);
2689 VEC_free (thread_item_t
, context
->items
);
2695 * Find all threads for info threads command.
2696 * Uses new thread protocol contributed by Cisco.
2697 * Falls back and attempts to use the older method (above)
2698 * if the target doesn't respond to the new method.
2702 remote_threads_info (struct target_ops
*ops
)
2704 struct remote_state
*rs
= get_remote_state ();
2708 if (remote_desc
== 0) /* paranoia */
2709 error (_("Command can only be used when connected to the remote target."));
2711 #if defined(HAVE_LIBEXPAT)
2712 if (remote_protocol_packets
[PACKET_qXfer_threads
].support
== PACKET_ENABLE
)
2714 char *xml
= target_read_stralloc (¤t_target
,
2715 TARGET_OBJECT_THREADS
, NULL
);
2717 struct cleanup
*back_to
= make_cleanup (xfree
, xml
);
2721 struct threads_parsing_context context
;
2723 context
.items
= NULL
;
2724 make_cleanup (clear_threads_parsing_context
, &context
);
2726 if (gdb_xml_parse_quick (_("threads"), "threads.dtd",
2727 threads_elements
, xml
, &context
) == 0)
2730 struct thread_item
*item
;
2733 VEC_iterate (thread_item_t
, context
.items
, i
, item
);
2736 if (!ptid_equal (item
->ptid
, null_ptid
))
2738 struct private_thread_info
*info
;
2739 /* In non-stop mode, we assume new found threads
2740 are running until proven otherwise with a
2741 stop reply. In all-stop, we can only get
2742 here if all threads are stopped. */
2743 int running
= non_stop
? 1 : 0;
2745 remote_notice_new_inferior (item
->ptid
, running
);
2747 info
= demand_private_info (item
->ptid
);
2748 info
->core
= item
->core
;
2749 info
->extra
= item
->extra
;
2756 do_cleanups (back_to
);
2761 if (use_threadinfo_query
)
2763 putpkt ("qfThreadInfo");
2764 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2766 if (bufp
[0] != '\0') /* q packet recognized */
2768 while (*bufp
++ == 'm') /* reply contains one or more TID */
2772 new_thread
= read_ptid (bufp
, &bufp
);
2773 if (!ptid_equal (new_thread
, null_ptid
))
2775 /* In non-stop mode, we assume new found threads
2776 are running until proven otherwise with a
2777 stop reply. In all-stop, we can only get
2778 here if all threads are stopped. */
2779 int running
= non_stop
? 1 : 0;
2781 remote_notice_new_inferior (new_thread
, running
);
2784 while (*bufp
++ == ','); /* comma-separated list */
2785 putpkt ("qsThreadInfo");
2786 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2793 /* Only qfThreadInfo is supported in non-stop mode. */
2797 /* Else fall back to old method based on jmetzler protocol. */
2798 use_threadinfo_query
= 0;
2799 remote_find_new_threads ();
2804 * Collect a descriptive string about the given thread.
2805 * The target may say anything it wants to about the thread
2806 * (typically info about its blocked / runnable state, name, etc.).
2807 * This string will appear in the info threads display.
2809 * Optional: targets are not required to implement this function.
2813 remote_threads_extra_info (struct thread_info
*tp
)
2815 struct remote_state
*rs
= get_remote_state ();
2819 struct gdb_ext_thread_info threadinfo
;
2820 static char display_buf
[100]; /* arbitrary... */
2821 int n
= 0; /* position in display_buf */
2823 if (remote_desc
== 0) /* paranoia */
2824 internal_error (__FILE__
, __LINE__
,
2825 _("remote_threads_extra_info"));
2827 if (ptid_equal (tp
->ptid
, magic_null_ptid
)
2828 || (ptid_get_pid (tp
->ptid
) != 0 && ptid_get_tid (tp
->ptid
) == 0))
2829 /* This is the main thread which was added by GDB. The remote
2830 server doesn't know about it. */
2833 if (remote_protocol_packets
[PACKET_qXfer_threads
].support
== PACKET_ENABLE
)
2835 struct thread_info
*info
= find_thread_ptid (tp
->ptid
);
2837 if (info
&& info
->private)
2838 return info
->private->extra
;
2843 if (use_threadextra_query
)
2846 char *endb
= rs
->buf
+ get_remote_packet_size ();
2848 xsnprintf (b
, endb
- b
, "qThreadExtraInfo,");
2850 write_ptid (b
, endb
, tp
->ptid
);
2853 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2854 if (rs
->buf
[0] != 0)
2856 n
= min (strlen (rs
->buf
) / 2, sizeof (display_buf
));
2857 result
= hex2bin (rs
->buf
, (gdb_byte
*) display_buf
, n
);
2858 display_buf
[result
] = '\0';
2863 /* If the above query fails, fall back to the old method. */
2864 use_threadextra_query
= 0;
2865 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
2866 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
2867 int_to_threadref (&id
, ptid_get_tid (tp
->ptid
));
2868 if (remote_get_threadinfo (&id
, set
, &threadinfo
))
2869 if (threadinfo
.active
)
2871 if (*threadinfo
.shortname
)
2872 n
+= xsnprintf (&display_buf
[0], sizeof (display_buf
) - n
,
2873 " Name: %s,", threadinfo
.shortname
);
2874 if (*threadinfo
.display
)
2875 n
+= xsnprintf (&display_buf
[n
], sizeof (display_buf
) - n
,
2876 " State: %s,", threadinfo
.display
);
2877 if (*threadinfo
.more_display
)
2878 n
+= xsnprintf (&display_buf
[n
], sizeof (display_buf
) - n
,
2879 " Priority: %s", threadinfo
.more_display
);
2883 /* For purely cosmetic reasons, clear up trailing commas. */
2884 if (',' == display_buf
[n
-1])
2885 display_buf
[n
-1] = ' ';
2894 remote_static_tracepoint_marker_at (CORE_ADDR addr
,
2895 struct static_tracepoint_marker
*marker
)
2897 struct remote_state
*rs
= get_remote_state ();
2900 xsnprintf (p
, get_remote_packet_size (), "qTSTMat:");
2902 p
+= hexnumstr (p
, addr
);
2904 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2908 error (_("Remote failure reply: %s"), p
);
2912 parse_static_tracepoint_marker_definition (p
, &p
, marker
);
2919 static VEC(static_tracepoint_marker_p
) *
2920 remote_static_tracepoint_markers_by_strid (const char *strid
)
2922 struct remote_state
*rs
= get_remote_state ();
2923 VEC(static_tracepoint_marker_p
) *markers
= NULL
;
2924 struct static_tracepoint_marker
*marker
= NULL
;
2925 struct cleanup
*old_chain
;
2928 /* Ask for a first packet of static tracepoint marker
2931 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2934 error (_("Remote failure reply: %s"), p
);
2936 old_chain
= make_cleanup (free_current_marker
, &marker
);
2941 marker
= XCNEW (struct static_tracepoint_marker
);
2945 parse_static_tracepoint_marker_definition (p
, &p
, marker
);
2947 if (strid
== NULL
|| strcmp (strid
, marker
->str_id
) == 0)
2949 VEC_safe_push (static_tracepoint_marker_p
,
2955 release_static_tracepoint_marker (marker
);
2956 memset (marker
, 0, sizeof (*marker
));
2959 while (*p
++ == ','); /* comma-separated list */
2960 /* Ask for another packet of static tracepoint definition. */
2962 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2966 do_cleanups (old_chain
);
2971 /* Implement the to_get_ada_task_ptid function for the remote targets. */
2974 remote_get_ada_task_ptid (long lwp
, long thread
)
2976 return ptid_build (ptid_get_pid (inferior_ptid
), 0, lwp
);
2980 /* Restart the remote side; this is an extended protocol operation. */
2983 extended_remote_restart (void)
2985 struct remote_state
*rs
= get_remote_state ();
2987 /* Send the restart command; for reasons I don't understand the
2988 remote side really expects a number after the "R". */
2989 xsnprintf (rs
->buf
, get_remote_packet_size (), "R%x", 0);
2992 remote_fileio_reset ();
2995 /* Clean up connection to a remote debugger. */
2998 remote_close (int quitting
)
3000 if (remote_desc
== NULL
)
3001 return; /* already closed */
3003 /* Make sure we leave stdin registered in the event loop, and we
3004 don't leave the async SIGINT signal handler installed. */
3005 remote_terminal_ours ();
3007 serial_close (remote_desc
);
3010 /* We don't have a connection to the remote stub anymore. Get rid
3011 of all the inferiors and their threads we were controlling.
3012 Reset inferior_ptid to null_ptid first, as otherwise has_stack_frame
3013 will be unable to find the thread corresponding to (pid, 0, 0). */
3014 inferior_ptid
= null_ptid
;
3015 discard_all_inferiors ();
3017 /* We're no longer interested in any of these events. */
3018 discard_pending_stop_replies (-1);
3020 if (remote_async_inferior_event_token
)
3021 delete_async_event_handler (&remote_async_inferior_event_token
);
3022 if (remote_async_get_pending_events_token
)
3023 delete_async_event_handler (&remote_async_get_pending_events_token
);
3026 /* Query the remote side for the text, data and bss offsets. */
3031 struct remote_state
*rs
= get_remote_state ();
3034 int lose
, num_segments
= 0, do_sections
, do_segments
;
3035 CORE_ADDR text_addr
, data_addr
, bss_addr
, segments
[2];
3036 struct section_offsets
*offs
;
3037 struct symfile_segment_data
*data
;
3039 if (symfile_objfile
== NULL
)
3042 putpkt ("qOffsets");
3043 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3046 if (buf
[0] == '\000')
3047 return; /* Return silently. Stub doesn't support
3051 warning (_("Remote failure reply: %s"), buf
);
3055 /* Pick up each field in turn. This used to be done with scanf, but
3056 scanf will make trouble if CORE_ADDR size doesn't match
3057 conversion directives correctly. The following code will work
3058 with any size of CORE_ADDR. */
3059 text_addr
= data_addr
= bss_addr
= 0;
3063 if (strncmp (ptr
, "Text=", 5) == 0)
3066 /* Don't use strtol, could lose on big values. */
3067 while (*ptr
&& *ptr
!= ';')
3068 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
3070 if (strncmp (ptr
, ";Data=", 6) == 0)
3073 while (*ptr
&& *ptr
!= ';')
3074 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
3079 if (!lose
&& strncmp (ptr
, ";Bss=", 5) == 0)
3082 while (*ptr
&& *ptr
!= ';')
3083 bss_addr
= (bss_addr
<< 4) + fromhex (*ptr
++);
3085 if (bss_addr
!= data_addr
)
3086 warning (_("Target reported unsupported offsets: %s"), buf
);
3091 else if (strncmp (ptr
, "TextSeg=", 8) == 0)
3094 /* Don't use strtol, could lose on big values. */
3095 while (*ptr
&& *ptr
!= ';')
3096 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
3099 if (strncmp (ptr
, ";DataSeg=", 9) == 0)
3102 while (*ptr
&& *ptr
!= ';')
3103 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
3111 error (_("Malformed response to offset query, %s"), buf
);
3112 else if (*ptr
!= '\0')
3113 warning (_("Target reported unsupported offsets: %s"), buf
);
3115 offs
= ((struct section_offsets
*)
3116 alloca (SIZEOF_N_SECTION_OFFSETS (symfile_objfile
->num_sections
)));
3117 memcpy (offs
, symfile_objfile
->section_offsets
,
3118 SIZEOF_N_SECTION_OFFSETS (symfile_objfile
->num_sections
));
3120 data
= get_symfile_segment_data (symfile_objfile
->obfd
);
3121 do_segments
= (data
!= NULL
);
3122 do_sections
= num_segments
== 0;
3124 if (num_segments
> 0)
3126 segments
[0] = text_addr
;
3127 segments
[1] = data_addr
;
3129 /* If we have two segments, we can still try to relocate everything
3130 by assuming that the .text and .data offsets apply to the whole
3131 text and data segments. Convert the offsets given in the packet
3132 to base addresses for symfile_map_offsets_to_segments. */
3133 else if (data
&& data
->num_segments
== 2)
3135 segments
[0] = data
->segment_bases
[0] + text_addr
;
3136 segments
[1] = data
->segment_bases
[1] + data_addr
;
3139 /* If the object file has only one segment, assume that it is text
3140 rather than data; main programs with no writable data are rare,
3141 but programs with no code are useless. Of course the code might
3142 have ended up in the data segment... to detect that we would need
3143 the permissions here. */
3144 else if (data
&& data
->num_segments
== 1)
3146 segments
[0] = data
->segment_bases
[0] + text_addr
;
3149 /* There's no way to relocate by segment. */
3155 int ret
= symfile_map_offsets_to_segments (symfile_objfile
->obfd
, data
,
3156 offs
, num_segments
, segments
);
3158 if (ret
== 0 && !do_sections
)
3159 error (_("Can not handle qOffsets TextSeg "
3160 "response with this symbol file"));
3167 free_symfile_segment_data (data
);
3171 offs
->offsets
[SECT_OFF_TEXT (symfile_objfile
)] = text_addr
;
3173 /* This is a temporary kludge to force data and bss to use the
3174 same offsets because that's what nlmconv does now. The real
3175 solution requires changes to the stub and remote.c that I
3176 don't have time to do right now. */
3178 offs
->offsets
[SECT_OFF_DATA (symfile_objfile
)] = data_addr
;
3179 offs
->offsets
[SECT_OFF_BSS (symfile_objfile
)] = data_addr
;
3182 objfile_relocate (symfile_objfile
, offs
);
3185 /* Callback for iterate_over_threads. Set the STOP_REQUESTED flags in
3186 threads we know are stopped already. This is used during the
3187 initial remote connection in non-stop mode --- threads that are
3188 reported as already being stopped are left stopped. */
3191 set_stop_requested_callback (struct thread_info
*thread
, void *data
)
3193 /* If we have a stop reply for this thread, it must be stopped. */
3194 if (peek_stop_reply (thread
->ptid
))
3195 set_stop_requested (thread
->ptid
, 1);
3200 /* Send interrupt_sequence to remote target. */
3202 send_interrupt_sequence (void)
3204 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
3205 serial_write (remote_desc
, "\x03", 1);
3206 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
3207 serial_send_break (remote_desc
);
3208 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
3210 serial_send_break (remote_desc
);
3211 serial_write (remote_desc
, "g", 1);
3214 internal_error (__FILE__
, __LINE__
,
3215 _("Invalid value for interrupt_sequence_mode: %s."),
3216 interrupt_sequence_mode
);
3219 /* Query the remote target for which is the current thread/process,
3220 add it to our tables, and update INFERIOR_PTID. The caller is
3221 responsible for setting the state such that the remote end is ready
3222 to return the current thread. */
3225 add_current_inferior_and_thread (void)
3227 struct remote_state
*rs
= get_remote_state ();
3231 inferior_ptid
= null_ptid
;
3233 /* Now, if we have thread information, update inferior_ptid. */
3234 ptid
= remote_current_thread (inferior_ptid
);
3235 if (!ptid_equal (ptid
, null_ptid
))
3237 if (!remote_multi_process_p (rs
))
3240 inferior_ptid
= ptid
;
3244 /* Without this, some commands which require an active target
3245 (such as kill) won't work. This variable serves (at least)
3246 double duty as both the pid of the target process (if it has
3247 such), and as a flag indicating that a target is active. */
3248 inferior_ptid
= magic_null_ptid
;
3252 remote_add_inferior (fake_pid_p
, ptid_get_pid (inferior_ptid
), -1);
3254 /* Add the main thread. */
3255 add_thread_silent (inferior_ptid
);
3259 remote_start_remote (int from_tty
, struct target_ops
*target
, int extended_p
)
3261 struct remote_state
*rs
= get_remote_state ();
3262 struct packet_config
*noack_config
;
3263 char *wait_status
= NULL
;
3265 immediate_quit
++; /* Allow user to interrupt it. */
3267 if (interrupt_on_connect
)
3268 send_interrupt_sequence ();
3270 /* Ack any packet which the remote side has already sent. */
3271 serial_write (remote_desc
, "+", 1);
3273 /* Signal other parts that we're going through the initial setup,
3274 and so things may not be stable yet. */
3275 rs
->starting_up
= 1;
3277 /* The first packet we send to the target is the optional "supported
3278 packets" request. If the target can answer this, it will tell us
3279 which later probes to skip. */
3280 remote_query_supported ();
3282 /* If the stub wants to get a QAllow, compose one and send it. */
3283 if (remote_protocol_packets
[PACKET_QAllow
].support
!= PACKET_DISABLE
)
3284 remote_set_permissions ();
3286 /* Next, we possibly activate noack mode.
3288 If the QStartNoAckMode packet configuration is set to AUTO,
3289 enable noack mode if the stub reported a wish for it with
3292 If set to TRUE, then enable noack mode even if the stub didn't
3293 report it in qSupported. If the stub doesn't reply OK, the
3294 session ends with an error.
3296 If FALSE, then don't activate noack mode, regardless of what the
3297 stub claimed should be the default with qSupported. */
3299 noack_config
= &remote_protocol_packets
[PACKET_QStartNoAckMode
];
3301 if (noack_config
->detect
== AUTO_BOOLEAN_TRUE
3302 || (noack_config
->detect
== AUTO_BOOLEAN_AUTO
3303 && noack_config
->support
== PACKET_ENABLE
))
3305 putpkt ("QStartNoAckMode");
3306 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3307 if (packet_ok (rs
->buf
, noack_config
) == PACKET_OK
)
3313 /* Tell the remote that we are using the extended protocol. */
3315 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3318 /* Let the target know which signals it is allowed to pass down to
3320 update_signals_program_target ();
3322 /* Next, if the target can specify a description, read it. We do
3323 this before anything involving memory or registers. */
3324 target_find_description ();
3326 /* Next, now that we know something about the target, update the
3327 address spaces in the program spaces. */
3328 update_address_spaces ();
3330 /* On OSs where the list of libraries is global to all
3331 processes, we fetch them early. */
3332 if (gdbarch_has_global_solist (target_gdbarch
))
3333 solib_add (NULL
, from_tty
, target
, auto_solib_add
);
3337 if (!rs
->non_stop_aware
)
3338 error (_("Non-stop mode requested, but remote "
3339 "does not support non-stop"));
3341 putpkt ("QNonStop:1");
3342 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3344 if (strcmp (rs
->buf
, "OK") != 0)
3345 error (_("Remote refused setting non-stop mode with: %s"), rs
->buf
);
3347 /* Find about threads and processes the stub is already
3348 controlling. We default to adding them in the running state.
3349 The '?' query below will then tell us about which threads are
3351 remote_threads_info (target
);
3353 else if (rs
->non_stop_aware
)
3355 /* Don't assume that the stub can operate in all-stop mode.
3356 Request it explicitely. */
3357 putpkt ("QNonStop:0");
3358 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3360 if (strcmp (rs
->buf
, "OK") != 0)
3361 error (_("Remote refused setting all-stop mode with: %s"), rs
->buf
);
3364 /* Check whether the target is running now. */
3366 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3372 struct inferior
*inf
;
3374 if (rs
->buf
[0] == 'W' || rs
->buf
[0] == 'X')
3377 error (_("The target is not running (try extended-remote?)"));
3379 /* We're connected, but not running. Drop out before we
3380 call start_remote. */
3381 rs
->starting_up
= 0;
3386 /* Save the reply for later. */
3387 wait_status
= alloca (strlen (rs
->buf
) + 1);
3388 strcpy (wait_status
, rs
->buf
);
3391 /* Let the stub know that we want it to return the thread. */
3392 set_continue_thread (minus_one_ptid
);
3394 add_current_inferior_and_thread ();
3396 /* init_wait_for_inferior should be called before get_offsets in order
3397 to manage `inserted' flag in bp loc in a correct state.
3398 breakpoint_init_inferior, called from init_wait_for_inferior, set
3399 `inserted' flag to 0, while before breakpoint_re_set, called from
3400 start_remote, set `inserted' flag to 1. In the initialization of
3401 inferior, breakpoint_init_inferior should be called first, and then
3402 breakpoint_re_set can be called. If this order is broken, state of
3403 `inserted' flag is wrong, and cause some problems on breakpoint
3405 init_wait_for_inferior ();
3407 get_offsets (); /* Get text, data & bss offsets. */
3409 /* If we could not find a description using qXfer, and we know
3410 how to do it some other way, try again. This is not
3411 supported for non-stop; it could be, but it is tricky if
3412 there are no stopped threads when we connect. */
3413 if (remote_read_description_p (target
)
3414 && gdbarch_target_desc (target_gdbarch
) == NULL
)
3416 target_clear_description ();
3417 target_find_description ();
3420 /* Use the previously fetched status. */
3421 gdb_assert (wait_status
!= NULL
);
3422 strcpy (rs
->buf
, wait_status
);
3423 rs
->cached_wait_status
= 1;
3426 start_remote (from_tty
); /* Initialize gdb process mechanisms. */
3430 /* Clear WFI global state. Do this before finding about new
3431 threads and inferiors, and setting the current inferior.
3432 Otherwise we would clear the proceed status of the current
3433 inferior when we want its stop_soon state to be preserved
3434 (see notice_new_inferior). */
3435 init_wait_for_inferior ();
3437 /* In non-stop, we will either get an "OK", meaning that there
3438 are no stopped threads at this time; or, a regular stop
3439 reply. In the latter case, there may be more than one thread
3440 stopped --- we pull them all out using the vStopped
3442 if (strcmp (rs
->buf
, "OK") != 0)
3444 struct stop_reply
*stop_reply
;
3445 struct cleanup
*old_chain
;
3447 stop_reply
= stop_reply_xmalloc ();
3448 old_chain
= make_cleanup (do_stop_reply_xfree
, stop_reply
);
3450 remote_parse_stop_reply (rs
->buf
, stop_reply
);
3451 discard_cleanups (old_chain
);
3453 /* get_pending_stop_replies acks this one, and gets the rest
3455 pending_stop_reply
= stop_reply
;
3456 remote_get_pending_stop_replies ();
3458 /* Make sure that threads that were stopped remain
3460 iterate_over_threads (set_stop_requested_callback
, NULL
);
3463 if (target_can_async_p ())
3464 target_async (inferior_event_handler
, 0);
3466 if (thread_count () == 0)
3469 error (_("The target is not running (try extended-remote?)"));
3471 /* We're connected, but not running. Drop out before we
3472 call start_remote. */
3473 rs
->starting_up
= 0;
3477 /* Let the stub know that we want it to return the thread. */
3479 /* Force the stub to choose a thread. */
3480 set_general_thread (null_ptid
);
3483 inferior_ptid
= remote_current_thread (minus_one_ptid
);
3484 if (ptid_equal (inferior_ptid
, minus_one_ptid
))
3485 error (_("remote didn't report the current thread in non-stop mode"));
3487 get_offsets (); /* Get text, data & bss offsets. */
3489 /* In non-stop mode, any cached wait status will be stored in
3490 the stop reply queue. */
3491 gdb_assert (wait_status
== NULL
);
3493 /* Report all signals during attach/startup. */
3494 remote_pass_signals (0, NULL
);
3497 /* If we connected to a live target, do some additional setup. */
3498 if (target_has_execution
)
3500 if (exec_bfd
) /* No use without an exec file. */
3501 remote_check_symbols (symfile_objfile
);
3504 /* Possibly the target has been engaged in a trace run started
3505 previously; find out where things are at. */
3506 if (remote_get_trace_status (current_trace_status ()) != -1)
3508 struct uploaded_tp
*uploaded_tps
= NULL
;
3509 struct uploaded_tsv
*uploaded_tsvs
= NULL
;
3511 if (current_trace_status ()->running
)
3512 printf_filtered (_("Trace is already running on the target.\n"));
3514 /* Get trace state variables first, they may be checked when
3515 parsing uploaded commands. */
3517 remote_upload_trace_state_variables (&uploaded_tsvs
);
3519 merge_uploaded_trace_state_variables (&uploaded_tsvs
);
3521 remote_upload_tracepoints (&uploaded_tps
);
3523 merge_uploaded_tracepoints (&uploaded_tps
);
3526 /* The thread and inferior lists are now synchronized with the
3527 target, our symbols have been relocated, and we're merged the
3528 target's tracepoints with ours. We're done with basic start
3530 rs
->starting_up
= 0;
3532 /* If breakpoints are global, insert them now. */
3533 if (gdbarch_has_global_breakpoints (target_gdbarch
)
3534 && breakpoints_always_inserted_mode ())
3535 insert_breakpoints ();
3538 /* Open a connection to a remote debugger.
3539 NAME is the filename used for communication. */
3542 remote_open (char *name
, int from_tty
)
3544 remote_open_1 (name
, from_tty
, &remote_ops
, 0);
3547 /* Open a connection to a remote debugger using the extended
3548 remote gdb protocol. NAME is the filename used for communication. */
3551 extended_remote_open (char *name
, int from_tty
)
3553 remote_open_1 (name
, from_tty
, &extended_remote_ops
, 1 /*extended_p */);
3556 /* Generic code for opening a connection to a remote target. */
3559 init_all_packet_configs (void)
3563 for (i
= 0; i
< PACKET_MAX
; i
++)
3564 update_packet_config (&remote_protocol_packets
[i
]);
3567 /* Symbol look-up. */
3570 remote_check_symbols (struct objfile
*objfile
)
3572 struct remote_state
*rs
= get_remote_state ();
3573 char *msg
, *reply
, *tmp
;
3574 struct minimal_symbol
*sym
;
3577 /* The remote side has no concept of inferiors that aren't running
3578 yet, it only knows about running processes. If we're connected
3579 but our current inferior is not running, we should not invite the
3580 remote target to request symbol lookups related to its
3581 (unrelated) current process. */
3582 if (!target_has_execution
)
3585 if (remote_protocol_packets
[PACKET_qSymbol
].support
== PACKET_DISABLE
)
3588 /* Make sure the remote is pointing at the right process. Note
3589 there's no way to select "no process". */
3590 set_general_process ();
3592 /* Allocate a message buffer. We can't reuse the input buffer in RS,
3593 because we need both at the same time. */
3594 msg
= alloca (get_remote_packet_size ());
3596 /* Invite target to request symbol lookups. */
3598 putpkt ("qSymbol::");
3599 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3600 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_qSymbol
]);
3603 while (strncmp (reply
, "qSymbol:", 8) == 0)
3606 end
= hex2bin (tmp
, (gdb_byte
*) msg
, strlen (tmp
) / 2);
3608 sym
= lookup_minimal_symbol (msg
, NULL
, NULL
);
3610 xsnprintf (msg
, get_remote_packet_size (), "qSymbol::%s", &reply
[8]);
3613 int addr_size
= gdbarch_addr_bit (target_gdbarch
) / 8;
3614 CORE_ADDR sym_addr
= SYMBOL_VALUE_ADDRESS (sym
);
3616 /* If this is a function address, return the start of code
3617 instead of any data function descriptor. */
3618 sym_addr
= gdbarch_convert_from_func_ptr_addr (target_gdbarch
,
3622 xsnprintf (msg
, get_remote_packet_size (), "qSymbol:%s:%s",
3623 phex_nz (sym_addr
, addr_size
), &reply
[8]);
3627 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3632 static struct serial
*
3633 remote_serial_open (char *name
)
3635 static int udp_warning
= 0;
3637 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
3638 of in ser-tcp.c, because it is the remote protocol assuming that the
3639 serial connection is reliable and not the serial connection promising
3641 if (!udp_warning
&& strncmp (name
, "udp:", 4) == 0)
3643 warning (_("The remote protocol may be unreliable over UDP.\n"
3644 "Some events may be lost, rendering further debugging "
3649 return serial_open (name
);
3652 /* Inform the target of our permission settings. The permission flags
3653 work without this, but if the target knows the settings, it can do
3654 a couple things. First, it can add its own check, to catch cases
3655 that somehow manage to get by the permissions checks in target
3656 methods. Second, if the target is wired to disallow particular
3657 settings (for instance, a system in the field that is not set up to
3658 be able to stop at a breakpoint), it can object to any unavailable
3662 remote_set_permissions (void)
3664 struct remote_state
*rs
= get_remote_state ();
3666 xsnprintf (rs
->buf
, get_remote_packet_size (), "QAllow:"
3667 "WriteReg:%x;WriteMem:%x;"
3668 "InsertBreak:%x;InsertTrace:%x;"
3669 "InsertFastTrace:%x;Stop:%x",
3670 may_write_registers
, may_write_memory
,
3671 may_insert_breakpoints
, may_insert_tracepoints
,
3672 may_insert_fast_tracepoints
, may_stop
);
3674 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3676 /* If the target didn't like the packet, warn the user. Do not try
3677 to undo the user's settings, that would just be maddening. */
3678 if (strcmp (rs
->buf
, "OK") != 0)
3679 warning (_("Remote refused setting permissions with: %s"), rs
->buf
);
3682 /* This type describes each known response to the qSupported
3684 struct protocol_feature
3686 /* The name of this protocol feature. */
3689 /* The default for this protocol feature. */
3690 enum packet_support default_support
;
3692 /* The function to call when this feature is reported, or after
3693 qSupported processing if the feature is not supported.
3694 The first argument points to this structure. The second
3695 argument indicates whether the packet requested support be
3696 enabled, disabled, or probed (or the default, if this function
3697 is being called at the end of processing and this feature was
3698 not reported). The third argument may be NULL; if not NULL, it
3699 is a NUL-terminated string taken from the packet following
3700 this feature's name and an equals sign. */
3701 void (*func
) (const struct protocol_feature
*, enum packet_support
,
3704 /* The corresponding packet for this feature. Only used if
3705 FUNC is remote_supported_packet. */
3710 remote_supported_packet (const struct protocol_feature
*feature
,
3711 enum packet_support support
,
3712 const char *argument
)
3716 warning (_("Remote qSupported response supplied an unexpected value for"
3717 " \"%s\"."), feature
->name
);
3721 if (remote_protocol_packets
[feature
->packet
].support
3722 == PACKET_SUPPORT_UNKNOWN
)
3723 remote_protocol_packets
[feature
->packet
].support
= support
;
3727 remote_packet_size (const struct protocol_feature
*feature
,
3728 enum packet_support support
, const char *value
)
3730 struct remote_state
*rs
= get_remote_state ();
3735 if (support
!= PACKET_ENABLE
)
3738 if (value
== NULL
|| *value
== '\0')
3740 warning (_("Remote target reported \"%s\" without a size."),
3746 packet_size
= strtol (value
, &value_end
, 16);
3747 if (errno
!= 0 || *value_end
!= '\0' || packet_size
< 0)
3749 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
3750 feature
->name
, value
);
3754 if (packet_size
> MAX_REMOTE_PACKET_SIZE
)
3756 warning (_("limiting remote suggested packet size (%d bytes) to %d"),
3757 packet_size
, MAX_REMOTE_PACKET_SIZE
);
3758 packet_size
= MAX_REMOTE_PACKET_SIZE
;
3761 /* Record the new maximum packet size. */
3762 rs
->explicit_packet_size
= packet_size
;
3766 remote_multi_process_feature (const struct protocol_feature
*feature
,
3767 enum packet_support support
, const char *value
)
3769 struct remote_state
*rs
= get_remote_state ();
3771 rs
->multi_process_aware
= (support
== PACKET_ENABLE
);
3775 remote_non_stop_feature (const struct protocol_feature
*feature
,
3776 enum packet_support support
, const char *value
)
3778 struct remote_state
*rs
= get_remote_state ();
3780 rs
->non_stop_aware
= (support
== PACKET_ENABLE
);
3784 remote_cond_tracepoint_feature (const struct protocol_feature
*feature
,
3785 enum packet_support support
,
3788 struct remote_state
*rs
= get_remote_state ();
3790 rs
->cond_tracepoints
= (support
== PACKET_ENABLE
);
3794 remote_cond_breakpoint_feature (const struct protocol_feature
*feature
,
3795 enum packet_support support
,
3798 struct remote_state
*rs
= get_remote_state ();
3800 rs
->cond_breakpoints
= (support
== PACKET_ENABLE
);
3804 remote_fast_tracepoint_feature (const struct protocol_feature
*feature
,
3805 enum packet_support support
,
3808 struct remote_state
*rs
= get_remote_state ();
3810 rs
->fast_tracepoints
= (support
== PACKET_ENABLE
);
3814 remote_static_tracepoint_feature (const struct protocol_feature
*feature
,
3815 enum packet_support support
,
3818 struct remote_state
*rs
= get_remote_state ();
3820 rs
->static_tracepoints
= (support
== PACKET_ENABLE
);
3824 remote_install_in_trace_feature (const struct protocol_feature
*feature
,
3825 enum packet_support support
,
3828 struct remote_state
*rs
= get_remote_state ();
3830 rs
->install_in_trace
= (support
== PACKET_ENABLE
);
3834 remote_disconnected_tracing_feature (const struct protocol_feature
*feature
,
3835 enum packet_support support
,
3838 struct remote_state
*rs
= get_remote_state ();
3840 rs
->disconnected_tracing
= (support
== PACKET_ENABLE
);
3844 remote_enable_disable_tracepoint_feature (const struct protocol_feature
*feature
,
3845 enum packet_support support
,
3848 struct remote_state
*rs
= get_remote_state ();
3850 rs
->enable_disable_tracepoints
= (support
== PACKET_ENABLE
);
3854 remote_string_tracing_feature (const struct protocol_feature
*feature
,
3855 enum packet_support support
,
3858 struct remote_state
*rs
= get_remote_state ();
3860 rs
->string_tracing
= (support
== PACKET_ENABLE
);
3863 static struct protocol_feature remote_protocol_features
[] = {
3864 { "PacketSize", PACKET_DISABLE
, remote_packet_size
, -1 },
3865 { "qXfer:auxv:read", PACKET_DISABLE
, remote_supported_packet
,
3866 PACKET_qXfer_auxv
},
3867 { "qXfer:features:read", PACKET_DISABLE
, remote_supported_packet
,
3868 PACKET_qXfer_features
},
3869 { "qXfer:libraries:read", PACKET_DISABLE
, remote_supported_packet
,
3870 PACKET_qXfer_libraries
},
3871 { "qXfer:libraries-svr4:read", PACKET_DISABLE
, remote_supported_packet
,
3872 PACKET_qXfer_libraries_svr4
},
3873 { "qXfer:memory-map:read", PACKET_DISABLE
, remote_supported_packet
,
3874 PACKET_qXfer_memory_map
},
3875 { "qXfer:spu:read", PACKET_DISABLE
, remote_supported_packet
,
3876 PACKET_qXfer_spu_read
},
3877 { "qXfer:spu:write", PACKET_DISABLE
, remote_supported_packet
,
3878 PACKET_qXfer_spu_write
},
3879 { "qXfer:osdata:read", PACKET_DISABLE
, remote_supported_packet
,
3880 PACKET_qXfer_osdata
},
3881 { "qXfer:threads:read", PACKET_DISABLE
, remote_supported_packet
,
3882 PACKET_qXfer_threads
},
3883 { "qXfer:traceframe-info:read", PACKET_DISABLE
, remote_supported_packet
,
3884 PACKET_qXfer_traceframe_info
},
3885 { "QPassSignals", PACKET_DISABLE
, remote_supported_packet
,
3886 PACKET_QPassSignals
},
3887 { "QProgramSignals", PACKET_DISABLE
, remote_supported_packet
,
3888 PACKET_QProgramSignals
},
3889 { "QStartNoAckMode", PACKET_DISABLE
, remote_supported_packet
,
3890 PACKET_QStartNoAckMode
},
3891 { "multiprocess", PACKET_DISABLE
, remote_multi_process_feature
, -1 },
3892 { "QNonStop", PACKET_DISABLE
, remote_non_stop_feature
, -1 },
3893 { "qXfer:siginfo:read", PACKET_DISABLE
, remote_supported_packet
,
3894 PACKET_qXfer_siginfo_read
},
3895 { "qXfer:siginfo:write", PACKET_DISABLE
, remote_supported_packet
,
3896 PACKET_qXfer_siginfo_write
},
3897 { "ConditionalTracepoints", PACKET_DISABLE
, remote_cond_tracepoint_feature
,
3898 PACKET_ConditionalTracepoints
},
3899 { "ConditionalBreakpoints", PACKET_DISABLE
, remote_cond_breakpoint_feature
,
3900 PACKET_ConditionalBreakpoints
},
3901 { "FastTracepoints", PACKET_DISABLE
, remote_fast_tracepoint_feature
,
3902 PACKET_FastTracepoints
},
3903 { "StaticTracepoints", PACKET_DISABLE
, remote_static_tracepoint_feature
,
3904 PACKET_StaticTracepoints
},
3905 {"InstallInTrace", PACKET_DISABLE
, remote_install_in_trace_feature
,
3906 PACKET_InstallInTrace
},
3907 { "DisconnectedTracing", PACKET_DISABLE
, remote_disconnected_tracing_feature
,
3909 { "ReverseContinue", PACKET_DISABLE
, remote_supported_packet
,
3911 { "ReverseStep", PACKET_DISABLE
, remote_supported_packet
,
3913 { "TracepointSource", PACKET_DISABLE
, remote_supported_packet
,
3914 PACKET_TracepointSource
},
3915 { "QAllow", PACKET_DISABLE
, remote_supported_packet
,
3917 { "EnableDisableTracepoints", PACKET_DISABLE
,
3918 remote_enable_disable_tracepoint_feature
, -1 },
3919 { "qXfer:fdpic:read", PACKET_DISABLE
, remote_supported_packet
,
3920 PACKET_qXfer_fdpic
},
3921 { "qXfer:uib:read", PACKET_DISABLE
, remote_supported_packet
,
3923 { "QDisableRandomization", PACKET_DISABLE
, remote_supported_packet
,
3924 PACKET_QDisableRandomization
},
3925 { "QAgent", PACKET_DISABLE
, remote_supported_packet
, PACKET_QAgent
},
3926 { "tracenz", PACKET_DISABLE
,
3927 remote_string_tracing_feature
, -1 },
3930 static char *remote_support_xml
;
3932 /* Register string appended to "xmlRegisters=" in qSupported query. */
3935 register_remote_support_xml (const char *xml
)
3937 #if defined(HAVE_LIBEXPAT)
3938 if (remote_support_xml
== NULL
)
3939 remote_support_xml
= concat ("xmlRegisters=", xml
, (char *) NULL
);
3942 char *copy
= xstrdup (remote_support_xml
+ 13);
3943 char *p
= strtok (copy
, ",");
3947 if (strcmp (p
, xml
) == 0)
3954 while ((p
= strtok (NULL
, ",")) != NULL
);
3957 remote_support_xml
= reconcat (remote_support_xml
,
3958 remote_support_xml
, ",", xml
,
3965 remote_query_supported_append (char *msg
, const char *append
)
3968 return reconcat (msg
, msg
, ";", append
, (char *) NULL
);
3970 return xstrdup (append
);
3974 remote_query_supported (void)
3976 struct remote_state
*rs
= get_remote_state ();
3979 unsigned char seen
[ARRAY_SIZE (remote_protocol_features
)];
3981 /* The packet support flags are handled differently for this packet
3982 than for most others. We treat an error, a disabled packet, and
3983 an empty response identically: any features which must be reported
3984 to be used will be automatically disabled. An empty buffer
3985 accomplishes this, since that is also the representation for a list
3986 containing no features. */
3989 if (remote_protocol_packets
[PACKET_qSupported
].support
!= PACKET_DISABLE
)
3992 struct cleanup
*old_chain
= make_cleanup (free_current_contents
, &q
);
3994 q
= remote_query_supported_append (q
, "multiprocess+");
3996 if (remote_support_xml
)
3997 q
= remote_query_supported_append (q
, remote_support_xml
);
3999 q
= remote_query_supported_append (q
, "qRelocInsn+");
4001 q
= reconcat (q
, "qSupported:", q
, (char *) NULL
);
4004 do_cleanups (old_chain
);
4006 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4008 /* If an error occured, warn, but do not return - just reset the
4009 buffer to empty and go on to disable features. */
4010 if (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_qSupported
])
4013 warning (_("Remote failure reply: %s"), rs
->buf
);
4018 memset (seen
, 0, sizeof (seen
));
4023 enum packet_support is_supported
;
4024 char *p
, *end
, *name_end
, *value
;
4026 /* First separate out this item from the rest of the packet. If
4027 there's another item after this, we overwrite the separator
4028 (terminated strings are much easier to work with). */
4030 end
= strchr (p
, ';');
4033 end
= p
+ strlen (p
);
4043 warning (_("empty item in \"qSupported\" response"));
4048 name_end
= strchr (p
, '=');
4051 /* This is a name=value entry. */
4052 is_supported
= PACKET_ENABLE
;
4053 value
= name_end
+ 1;
4062 is_supported
= PACKET_ENABLE
;
4066 is_supported
= PACKET_DISABLE
;
4070 is_supported
= PACKET_SUPPORT_UNKNOWN
;
4074 warning (_("unrecognized item \"%s\" "
4075 "in \"qSupported\" response"), p
);
4081 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
4082 if (strcmp (remote_protocol_features
[i
].name
, p
) == 0)
4084 const struct protocol_feature
*feature
;
4087 feature
= &remote_protocol_features
[i
];
4088 feature
->func (feature
, is_supported
, value
);
4093 /* If we increased the packet size, make sure to increase the global
4094 buffer size also. We delay this until after parsing the entire
4095 qSupported packet, because this is the same buffer we were
4097 if (rs
->buf_size
< rs
->explicit_packet_size
)
4099 rs
->buf_size
= rs
->explicit_packet_size
;
4100 rs
->buf
= xrealloc (rs
->buf
, rs
->buf_size
);
4103 /* Handle the defaults for unmentioned features. */
4104 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
4107 const struct protocol_feature
*feature
;
4109 feature
= &remote_protocol_features
[i
];
4110 feature
->func (feature
, feature
->default_support
, NULL
);
4116 remote_open_1 (char *name
, int from_tty
,
4117 struct target_ops
*target
, int extended_p
)
4119 struct remote_state
*rs
= get_remote_state ();
4122 error (_("To open a remote debug connection, you need to specify what\n"
4123 "serial device is attached to the remote system\n"
4124 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
4126 /* See FIXME above. */
4127 if (!target_async_permitted
)
4128 wait_forever_enabled_p
= 1;
4130 /* If we're connected to a running target, target_preopen will kill it.
4131 But if we're connected to a target system with no running process,
4132 then we will still be connected when it returns. Ask this question
4133 first, before target_preopen has a chance to kill anything. */
4134 if (remote_desc
!= NULL
&& !have_inferiors ())
4137 || query (_("Already connected to a remote target. Disconnect? ")))
4140 error (_("Still connected."));
4143 target_preopen (from_tty
);
4145 unpush_target (target
);
4147 /* This time without a query. If we were connected to an
4148 extended-remote target and target_preopen killed the running
4149 process, we may still be connected. If we are starting "target
4150 remote" now, the extended-remote target will not have been
4151 removed by unpush_target. */
4152 if (remote_desc
!= NULL
&& !have_inferiors ())
4155 /* Make sure we send the passed signals list the next time we resume. */
4156 xfree (last_pass_packet
);
4157 last_pass_packet
= NULL
;
4159 /* Make sure we send the program signals list the next time we
4161 xfree (last_program_signals_packet
);
4162 last_program_signals_packet
= NULL
;
4164 remote_fileio_reset ();
4165 reopen_exec_file ();
4168 remote_desc
= remote_serial_open (name
);
4170 perror_with_name (name
);
4172 if (baud_rate
!= -1)
4174 if (serial_setbaudrate (remote_desc
, baud_rate
))
4176 /* The requested speed could not be set. Error out to
4177 top level after closing remote_desc. Take care to
4178 set remote_desc to NULL to avoid closing remote_desc
4180 serial_close (remote_desc
);
4182 perror_with_name (name
);
4186 serial_raw (remote_desc
);
4188 /* If there is something sitting in the buffer we might take it as a
4189 response to a command, which would be bad. */
4190 serial_flush_input (remote_desc
);
4194 puts_filtered ("Remote debugging using ");
4195 puts_filtered (name
);
4196 puts_filtered ("\n");
4198 push_target (target
); /* Switch to using remote target now. */
4200 /* Register extra event sources in the event loop. */
4201 remote_async_inferior_event_token
4202 = create_async_event_handler (remote_async_inferior_event_handler
,
4204 remote_async_get_pending_events_token
4205 = create_async_event_handler (remote_async_get_pending_events_handler
,
4208 /* Reset the target state; these things will be queried either by
4209 remote_query_supported or as they are needed. */
4210 init_all_packet_configs ();
4211 rs
->cached_wait_status
= 0;
4212 rs
->explicit_packet_size
= 0;
4214 rs
->multi_process_aware
= 0;
4215 rs
->extended
= extended_p
;
4216 rs
->non_stop_aware
= 0;
4217 rs
->waiting_for_stop_reply
= 0;
4218 rs
->ctrlc_pending_p
= 0;
4220 general_thread
= not_sent_ptid
;
4221 continue_thread
= not_sent_ptid
;
4222 remote_traceframe_number
= -1;
4224 /* Probe for ability to use "ThreadInfo" query, as required. */
4225 use_threadinfo_query
= 1;
4226 use_threadextra_query
= 1;
4228 if (target_async_permitted
)
4230 /* With this target we start out by owning the terminal. */
4231 remote_async_terminal_ours_p
= 1;
4233 /* FIXME: cagney/1999-09-23: During the initial connection it is
4234 assumed that the target is already ready and able to respond to
4235 requests. Unfortunately remote_start_remote() eventually calls
4236 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
4237 around this. Eventually a mechanism that allows
4238 wait_for_inferior() to expect/get timeouts will be
4240 wait_forever_enabled_p
= 0;
4243 /* First delete any symbols previously loaded from shared libraries. */
4244 no_shared_libraries (NULL
, 0);
4247 init_thread_list ();
4249 /* Start the remote connection. If error() or QUIT, discard this
4250 target (we'd otherwise be in an inconsistent state) and then
4251 propogate the error on up the exception chain. This ensures that
4252 the caller doesn't stumble along blindly assuming that the
4253 function succeeded. The CLI doesn't have this problem but other
4254 UI's, such as MI do.
4256 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
4257 this function should return an error indication letting the
4258 caller restore the previous state. Unfortunately the command
4259 ``target remote'' is directly wired to this function making that
4260 impossible. On a positive note, the CLI side of this problem has
4261 been fixed - the function set_cmd_context() makes it possible for
4262 all the ``target ....'' commands to share a common callback
4263 function. See cli-dump.c. */
4265 volatile struct gdb_exception ex
;
4267 TRY_CATCH (ex
, RETURN_MASK_ALL
)
4269 remote_start_remote (from_tty
, target
, extended_p
);
4273 /* Pop the partially set up target - unless something else did
4274 already before throwing the exception. */
4275 if (remote_desc
!= NULL
)
4277 if (target_async_permitted
)
4278 wait_forever_enabled_p
= 1;
4279 throw_exception (ex
);
4283 if (target_async_permitted
)
4284 wait_forever_enabled_p
= 1;
4287 /* This takes a program previously attached to and detaches it. After
4288 this is done, GDB can be used to debug some other program. We
4289 better not have left any breakpoints in the target program or it'll
4290 die when it hits one. */
4293 remote_detach_1 (char *args
, int from_tty
, int extended
)
4295 int pid
= ptid_get_pid (inferior_ptid
);
4296 struct remote_state
*rs
= get_remote_state ();
4299 error (_("Argument given to \"detach\" when remotely debugging."));
4301 if (!target_has_execution
)
4302 error (_("No process to detach from."));
4306 char *exec_file
= get_exec_file (0);
4307 if (exec_file
== NULL
)
4309 printf_unfiltered (_("Detaching from program: %s, %s\n"), exec_file
,
4310 target_pid_to_str (pid_to_ptid (pid
)));
4311 gdb_flush (gdb_stdout
);
4314 /* Tell the remote target to detach. */
4315 if (remote_multi_process_p (rs
))
4316 xsnprintf (rs
->buf
, get_remote_packet_size (), "D;%x", pid
);
4318 strcpy (rs
->buf
, "D");
4321 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4323 if (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K')
4325 else if (rs
->buf
[0] == '\0')
4326 error (_("Remote doesn't know how to detach"));
4328 error (_("Can't detach process."));
4330 if (from_tty
&& !extended
)
4331 puts_filtered (_("Ending remote debugging.\n"));
4333 discard_pending_stop_replies (pid
);
4334 target_mourn_inferior ();
4338 remote_detach (struct target_ops
*ops
, char *args
, int from_tty
)
4340 remote_detach_1 (args
, from_tty
, 0);
4344 extended_remote_detach (struct target_ops
*ops
, char *args
, int from_tty
)
4346 remote_detach_1 (args
, from_tty
, 1);
4349 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
4352 remote_disconnect (struct target_ops
*target
, char *args
, int from_tty
)
4355 error (_("Argument given to \"disconnect\" when remotely debugging."));
4357 /* Make sure we unpush even the extended remote targets; mourn
4358 won't do it. So call remote_mourn_1 directly instead of
4359 target_mourn_inferior. */
4360 remote_mourn_1 (target
);
4363 puts_filtered ("Ending remote debugging.\n");
4366 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
4367 be chatty about it. */
4370 extended_remote_attach_1 (struct target_ops
*target
, char *args
, int from_tty
)
4372 struct remote_state
*rs
= get_remote_state ();
4374 char *wait_status
= NULL
;
4376 pid
= parse_pid_to_attach (args
);
4378 /* Remote PID can be freely equal to getpid, do not check it here the same
4379 way as in other targets. */
4381 if (remote_protocol_packets
[PACKET_vAttach
].support
== PACKET_DISABLE
)
4382 error (_("This target does not support attaching to a process"));
4386 char *exec_file
= get_exec_file (0);
4389 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file
,
4390 target_pid_to_str (pid_to_ptid (pid
)));
4392 printf_unfiltered (_("Attaching to %s\n"),
4393 target_pid_to_str (pid_to_ptid (pid
)));
4395 gdb_flush (gdb_stdout
);
4398 xsnprintf (rs
->buf
, get_remote_packet_size (), "vAttach;%x", pid
);
4400 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4402 if (packet_ok (rs
->buf
,
4403 &remote_protocol_packets
[PACKET_vAttach
]) == PACKET_OK
)
4407 /* Save the reply for later. */
4408 wait_status
= alloca (strlen (rs
->buf
) + 1);
4409 strcpy (wait_status
, rs
->buf
);
4411 else if (strcmp (rs
->buf
, "OK") != 0)
4412 error (_("Attaching to %s failed with: %s"),
4413 target_pid_to_str (pid_to_ptid (pid
)),
4416 else if (remote_protocol_packets
[PACKET_vAttach
].support
== PACKET_DISABLE
)
4417 error (_("This target does not support attaching to a process"));
4419 error (_("Attaching to %s failed"),
4420 target_pid_to_str (pid_to_ptid (pid
)));
4422 set_current_inferior (remote_add_inferior (0, pid
, 1));
4424 inferior_ptid
= pid_to_ptid (pid
);
4428 struct thread_info
*thread
;
4430 /* Get list of threads. */
4431 remote_threads_info (target
);
4433 thread
= first_thread_of_process (pid
);
4435 inferior_ptid
= thread
->ptid
;
4437 inferior_ptid
= pid_to_ptid (pid
);
4439 /* Invalidate our notion of the remote current thread. */
4440 record_currthread (minus_one_ptid
);
4444 /* Now, if we have thread information, update inferior_ptid. */
4445 inferior_ptid
= remote_current_thread (inferior_ptid
);
4447 /* Add the main thread to the thread list. */
4448 add_thread_silent (inferior_ptid
);
4451 /* Next, if the target can specify a description, read it. We do
4452 this before anything involving memory or registers. */
4453 target_find_description ();
4457 /* Use the previously fetched status. */
4458 gdb_assert (wait_status
!= NULL
);
4460 if (target_can_async_p ())
4462 struct stop_reply
*stop_reply
;
4463 struct cleanup
*old_chain
;
4465 stop_reply
= stop_reply_xmalloc ();
4466 old_chain
= make_cleanup (do_stop_reply_xfree
, stop_reply
);
4467 remote_parse_stop_reply (wait_status
, stop_reply
);
4468 discard_cleanups (old_chain
);
4469 push_stop_reply (stop_reply
);
4471 target_async (inferior_event_handler
, 0);
4475 gdb_assert (wait_status
!= NULL
);
4476 strcpy (rs
->buf
, wait_status
);
4477 rs
->cached_wait_status
= 1;
4481 gdb_assert (wait_status
== NULL
);
4485 extended_remote_attach (struct target_ops
*ops
, char *args
, int from_tty
)
4487 extended_remote_attach_1 (ops
, args
, from_tty
);
4490 /* Convert hex digit A to a number. */
4495 if (a
>= '0' && a
<= '9')
4497 else if (a
>= 'a' && a
<= 'f')
4498 return a
- 'a' + 10;
4499 else if (a
>= 'A' && a
<= 'F')
4500 return a
- 'A' + 10;
4502 error (_("Reply contains invalid hex digit %d"), a
);
4506 hex2bin (const char *hex
, gdb_byte
*bin
, int count
)
4510 for (i
= 0; i
< count
; i
++)
4512 if (hex
[0] == 0 || hex
[1] == 0)
4514 /* Hex string is short, or of uneven length.
4515 Return the count that has been converted so far. */
4518 *bin
++ = fromhex (hex
[0]) * 16 + fromhex (hex
[1]);
4524 /* Convert number NIB to a hex digit. */
4532 return 'a' + nib
- 10;
4536 bin2hex (const gdb_byte
*bin
, char *hex
, int count
)
4540 /* May use a length, or a nul-terminated string as input. */
4542 count
= strlen ((char *) bin
);
4544 for (i
= 0; i
< count
; i
++)
4546 *hex
++ = tohex ((*bin
>> 4) & 0xf);
4547 *hex
++ = tohex (*bin
++ & 0xf);
4553 /* Check for the availability of vCont. This function should also check
4557 remote_vcont_probe (struct remote_state
*rs
)
4561 strcpy (rs
->buf
, "vCont?");
4563 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4566 /* Make sure that the features we assume are supported. */
4567 if (strncmp (buf
, "vCont", 5) == 0)
4570 int support_s
, support_S
, support_c
, support_C
;
4576 rs
->support_vCont_t
= 0;
4577 while (p
&& *p
== ';')
4580 if (*p
== 's' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4582 else if (*p
== 'S' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4584 else if (*p
== 'c' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4586 else if (*p
== 'C' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4588 else if (*p
== 't' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4589 rs
->support_vCont_t
= 1;
4591 p
= strchr (p
, ';');
4594 /* If s, S, c, and C are not all supported, we can't use vCont. Clearing
4595 BUF will make packet_ok disable the packet. */
4596 if (!support_s
|| !support_S
|| !support_c
|| !support_C
)
4600 packet_ok (buf
, &remote_protocol_packets
[PACKET_vCont
]);
4603 /* Helper function for building "vCont" resumptions. Write a
4604 resumption to P. ENDP points to one-passed-the-end of the buffer
4605 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
4606 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
4607 resumed thread should be single-stepped and/or signalled. If PTID
4608 equals minus_one_ptid, then all threads are resumed; if PTID
4609 represents a process, then all threads of the process are resumed;
4610 the thread to be stepped and/or signalled is given in the global
4614 append_resumption (char *p
, char *endp
,
4615 ptid_t ptid
, int step
, enum gdb_signal siggnal
)
4617 struct remote_state
*rs
= get_remote_state ();
4619 if (step
&& siggnal
!= GDB_SIGNAL_0
)
4620 p
+= xsnprintf (p
, endp
- p
, ";S%02x", siggnal
);
4622 p
+= xsnprintf (p
, endp
- p
, ";s");
4623 else if (siggnal
!= GDB_SIGNAL_0
)
4624 p
+= xsnprintf (p
, endp
- p
, ";C%02x", siggnal
);
4626 p
+= xsnprintf (p
, endp
- p
, ";c");
4628 if (remote_multi_process_p (rs
) && ptid_is_pid (ptid
))
4632 /* All (-1) threads of process. */
4633 nptid
= ptid_build (ptid_get_pid (ptid
), 0, -1);
4635 p
+= xsnprintf (p
, endp
- p
, ":");
4636 p
= write_ptid (p
, endp
, nptid
);
4638 else if (!ptid_equal (ptid
, minus_one_ptid
))
4640 p
+= xsnprintf (p
, endp
- p
, ":");
4641 p
= write_ptid (p
, endp
, ptid
);
4647 /* Append a vCont continue-with-signal action for threads that have a
4648 non-zero stop signal. */
4651 append_pending_thread_resumptions (char *p
, char *endp
, ptid_t ptid
)
4653 struct thread_info
*thread
;
4655 ALL_THREADS (thread
)
4656 if (ptid_match (thread
->ptid
, ptid
)
4657 && !ptid_equal (inferior_ptid
, thread
->ptid
)
4658 && thread
->suspend
.stop_signal
!= GDB_SIGNAL_0
4659 && signal_pass_state (thread
->suspend
.stop_signal
))
4661 p
= append_resumption (p
, endp
, thread
->ptid
,
4662 0, thread
->suspend
.stop_signal
);
4663 thread
->suspend
.stop_signal
= GDB_SIGNAL_0
;
4669 /* Resume the remote inferior by using a "vCont" packet. The thread
4670 to be resumed is PTID; STEP and SIGGNAL indicate whether the
4671 resumed thread should be single-stepped and/or signalled. If PTID
4672 equals minus_one_ptid, then all threads are resumed; the thread to
4673 be stepped and/or signalled is given in the global INFERIOR_PTID.
4674 This function returns non-zero iff it resumes the inferior.
4676 This function issues a strict subset of all possible vCont commands at the
4680 remote_vcont_resume (ptid_t ptid
, int step
, enum gdb_signal siggnal
)
4682 struct remote_state
*rs
= get_remote_state ();
4686 if (remote_protocol_packets
[PACKET_vCont
].support
== PACKET_SUPPORT_UNKNOWN
)
4687 remote_vcont_probe (rs
);
4689 if (remote_protocol_packets
[PACKET_vCont
].support
== PACKET_DISABLE
)
4693 endp
= rs
->buf
+ get_remote_packet_size ();
4695 /* If we could generate a wider range of packets, we'd have to worry
4696 about overflowing BUF. Should there be a generic
4697 "multi-part-packet" packet? */
4699 p
+= xsnprintf (p
, endp
- p
, "vCont");
4701 if (ptid_equal (ptid
, magic_null_ptid
))
4703 /* MAGIC_NULL_PTID means that we don't have any active threads,
4704 so we don't have any TID numbers the inferior will
4705 understand. Make sure to only send forms that do not specify
4707 append_resumption (p
, endp
, minus_one_ptid
, step
, siggnal
);
4709 else if (ptid_equal (ptid
, minus_one_ptid
) || ptid_is_pid (ptid
))
4711 /* Resume all threads (of all processes, or of a single
4712 process), with preference for INFERIOR_PTID. This assumes
4713 inferior_ptid belongs to the set of all threads we are about
4715 if (step
|| siggnal
!= GDB_SIGNAL_0
)
4717 /* Step inferior_ptid, with or without signal. */
4718 p
= append_resumption (p
, endp
, inferior_ptid
, step
, siggnal
);
4721 /* Also pass down any pending signaled resumption for other
4722 threads not the current. */
4723 p
= append_pending_thread_resumptions (p
, endp
, ptid
);
4725 /* And continue others without a signal. */
4726 append_resumption (p
, endp
, ptid
, /*step=*/ 0, GDB_SIGNAL_0
);
4730 /* Scheduler locking; resume only PTID. */
4731 append_resumption (p
, endp
, ptid
, step
, siggnal
);
4734 gdb_assert (strlen (rs
->buf
) < get_remote_packet_size ());
4739 /* In non-stop, the stub replies to vCont with "OK". The stop
4740 reply will be reported asynchronously by means of a `%Stop'
4742 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4743 if (strcmp (rs
->buf
, "OK") != 0)
4744 error (_("Unexpected vCont reply in non-stop mode: %s"), rs
->buf
);
4750 /* Tell the remote machine to resume. */
4752 static enum gdb_signal last_sent_signal
= GDB_SIGNAL_0
;
4754 static int last_sent_step
;
4757 remote_resume (struct target_ops
*ops
,
4758 ptid_t ptid
, int step
, enum gdb_signal siggnal
)
4760 struct remote_state
*rs
= get_remote_state ();
4763 last_sent_signal
= siggnal
;
4764 last_sent_step
= step
;
4766 /* The vCont packet doesn't need to specify threads via Hc. */
4767 /* No reverse support (yet) for vCont. */
4768 if (execution_direction
!= EXEC_REVERSE
)
4769 if (remote_vcont_resume (ptid
, step
, siggnal
))
4772 /* All other supported resume packets do use Hc, so set the continue
4774 if (ptid_equal (ptid
, minus_one_ptid
))
4775 set_continue_thread (any_thread_ptid
);
4777 set_continue_thread (ptid
);
4780 if (execution_direction
== EXEC_REVERSE
)
4782 /* We don't pass signals to the target in reverse exec mode. */
4783 if (info_verbose
&& siggnal
!= GDB_SIGNAL_0
)
4784 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
4788 && remote_protocol_packets
[PACKET_bs
].support
== PACKET_DISABLE
)
4789 error (_("Remote reverse-step not supported."));
4791 && remote_protocol_packets
[PACKET_bc
].support
== PACKET_DISABLE
)
4792 error (_("Remote reverse-continue not supported."));
4794 strcpy (buf
, step
? "bs" : "bc");
4796 else if (siggnal
!= GDB_SIGNAL_0
)
4798 buf
[0] = step
? 'S' : 'C';
4799 buf
[1] = tohex (((int) siggnal
>> 4) & 0xf);
4800 buf
[2] = tohex (((int) siggnal
) & 0xf);
4804 strcpy (buf
, step
? "s" : "c");
4809 /* We are about to start executing the inferior, let's register it
4810 with the event loop. NOTE: this is the one place where all the
4811 execution commands end up. We could alternatively do this in each
4812 of the execution commands in infcmd.c. */
4813 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
4814 into infcmd.c in order to allow inferior function calls to work
4815 NOT asynchronously. */
4816 if (target_can_async_p ())
4817 target_async (inferior_event_handler
, 0);
4819 /* We've just told the target to resume. The remote server will
4820 wait for the inferior to stop, and then send a stop reply. In
4821 the mean time, we can't start another command/query ourselves
4822 because the stub wouldn't be ready to process it. This applies
4823 only to the base all-stop protocol, however. In non-stop (which
4824 only supports vCont), the stub replies with an "OK", and is
4825 immediate able to process further serial input. */
4827 rs
->waiting_for_stop_reply
= 1;
4831 /* Set up the signal handler for SIGINT, while the target is
4832 executing, ovewriting the 'regular' SIGINT signal handler. */
4834 initialize_sigint_signal_handler (void)
4836 signal (SIGINT
, handle_remote_sigint
);
4839 /* Signal handler for SIGINT, while the target is executing. */
4841 handle_remote_sigint (int sig
)
4843 signal (sig
, handle_remote_sigint_twice
);
4844 mark_async_signal_handler_wrapper (sigint_remote_token
);
4847 /* Signal handler for SIGINT, installed after SIGINT has already been
4848 sent once. It will take effect the second time that the user sends
4851 handle_remote_sigint_twice (int sig
)
4853 signal (sig
, handle_remote_sigint
);
4854 mark_async_signal_handler_wrapper (sigint_remote_twice_token
);
4857 /* Perform the real interruption of the target execution, in response
4860 async_remote_interrupt (gdb_client_data arg
)
4863 fprintf_unfiltered (gdb_stdlog
, "async_remote_interrupt called\n");
4865 target_stop (inferior_ptid
);
4868 /* Perform interrupt, if the first attempt did not succeed. Just give
4869 up on the target alltogether. */
4871 async_remote_interrupt_twice (gdb_client_data arg
)
4874 fprintf_unfiltered (gdb_stdlog
, "async_remote_interrupt_twice called\n");
4879 /* Reinstall the usual SIGINT handlers, after the target has
4882 cleanup_sigint_signal_handler (void *dummy
)
4884 signal (SIGINT
, handle_sigint
);
4887 /* Send ^C to target to halt it. Target will respond, and send us a
4889 static void (*ofunc
) (int);
4891 /* The command line interface's stop routine. This function is installed
4892 as a signal handler for SIGINT. The first time a user requests a
4893 stop, we call remote_stop to send a break or ^C. If there is no
4894 response from the target (it didn't stop when the user requested it),
4895 we ask the user if he'd like to detach from the target. */
4897 remote_interrupt (int signo
)
4899 /* If this doesn't work, try more severe steps. */
4900 signal (signo
, remote_interrupt_twice
);
4902 gdb_call_async_signal_handler (sigint_remote_token
, 1);
4905 /* The user typed ^C twice. */
4908 remote_interrupt_twice (int signo
)
4910 signal (signo
, ofunc
);
4911 gdb_call_async_signal_handler (sigint_remote_twice_token
, 1);
4912 signal (signo
, remote_interrupt
);
4915 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
4916 thread, all threads of a remote process, or all threads of all
4920 remote_stop_ns (ptid_t ptid
)
4922 struct remote_state
*rs
= get_remote_state ();
4924 char *endp
= rs
->buf
+ get_remote_packet_size ();
4926 if (remote_protocol_packets
[PACKET_vCont
].support
== PACKET_SUPPORT_UNKNOWN
)
4927 remote_vcont_probe (rs
);
4929 if (!rs
->support_vCont_t
)
4930 error (_("Remote server does not support stopping threads"));
4932 if (ptid_equal (ptid
, minus_one_ptid
)
4933 || (!remote_multi_process_p (rs
) && ptid_is_pid (ptid
)))
4934 p
+= xsnprintf (p
, endp
- p
, "vCont;t");
4939 p
+= xsnprintf (p
, endp
- p
, "vCont;t:");
4941 if (ptid_is_pid (ptid
))
4942 /* All (-1) threads of process. */
4943 nptid
= ptid_build (ptid_get_pid (ptid
), 0, -1);
4946 /* Small optimization: if we already have a stop reply for
4947 this thread, no use in telling the stub we want this
4949 if (peek_stop_reply (ptid
))
4955 write_ptid (p
, endp
, nptid
);
4958 /* In non-stop, we get an immediate OK reply. The stop reply will
4959 come in asynchronously by notification. */
4961 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4962 if (strcmp (rs
->buf
, "OK") != 0)
4963 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid
), rs
->buf
);
4966 /* All-stop version of target_stop. Sends a break or a ^C to stop the
4967 remote target. It is undefined which thread of which process
4968 reports the stop. */
4971 remote_stop_as (ptid_t ptid
)
4973 struct remote_state
*rs
= get_remote_state ();
4975 rs
->ctrlc_pending_p
= 1;
4977 /* If the inferior is stopped already, but the core didn't know
4978 about it yet, just ignore the request. The cached wait status
4979 will be collected in remote_wait. */
4980 if (rs
->cached_wait_status
)
4983 /* Send interrupt_sequence to remote target. */
4984 send_interrupt_sequence ();
4987 /* This is the generic stop called via the target vector. When a target
4988 interrupt is requested, either by the command line or the GUI, we
4989 will eventually end up here. */
4992 remote_stop (ptid_t ptid
)
4995 fprintf_unfiltered (gdb_stdlog
, "remote_stop called\n");
4998 remote_stop_ns (ptid
);
5000 remote_stop_as (ptid
);
5003 /* Ask the user what to do when an interrupt is received. */
5006 interrupt_query (void)
5008 target_terminal_ours ();
5010 if (target_can_async_p ())
5012 signal (SIGINT
, handle_sigint
);
5013 deprecated_throw_reason (RETURN_QUIT
);
5017 if (query (_("Interrupted while waiting for the program.\n\
5018 Give up (and stop debugging it)? ")))
5021 deprecated_throw_reason (RETURN_QUIT
);
5025 target_terminal_inferior ();
5028 /* Enable/disable target terminal ownership. Most targets can use
5029 terminal groups to control terminal ownership. Remote targets are
5030 different in that explicit transfer of ownership to/from GDB/target
5034 remote_terminal_inferior (void)
5036 if (!target_async_permitted
)
5037 /* Nothing to do. */
5040 /* FIXME: cagney/1999-09-27: Make calls to target_terminal_*()
5041 idempotent. The event-loop GDB talking to an asynchronous target
5042 with a synchronous command calls this function from both
5043 event-top.c and infrun.c/infcmd.c. Once GDB stops trying to
5044 transfer the terminal to the target when it shouldn't this guard
5046 if (!remote_async_terminal_ours_p
)
5048 delete_file_handler (input_fd
);
5049 remote_async_terminal_ours_p
= 0;
5050 initialize_sigint_signal_handler ();
5051 /* NOTE: At this point we could also register our selves as the
5052 recipient of all input. Any characters typed could then be
5053 passed on down to the target. */
5057 remote_terminal_ours (void)
5059 if (!target_async_permitted
)
5060 /* Nothing to do. */
5063 /* See FIXME in remote_terminal_inferior. */
5064 if (remote_async_terminal_ours_p
)
5066 cleanup_sigint_signal_handler (NULL
);
5067 add_file_handler (input_fd
, stdin_event_handler
, 0);
5068 remote_async_terminal_ours_p
= 1;
5072 remote_console_output (char *msg
)
5076 for (p
= msg
; p
[0] && p
[1]; p
+= 2)
5079 char c
= fromhex (p
[0]) * 16 + fromhex (p
[1]);
5083 fputs_unfiltered (tb
, gdb_stdtarg
);
5085 gdb_flush (gdb_stdtarg
);
5088 typedef struct cached_reg
5091 gdb_byte data
[MAX_REGISTER_SIZE
];
5094 DEF_VEC_O(cached_reg_t
);
5098 struct stop_reply
*next
;
5102 struct target_waitstatus ws
;
5104 /* Expedited registers. This makes remote debugging a bit more
5105 efficient for those targets that provide critical registers as
5106 part of their normal status mechanism (as another roundtrip to
5107 fetch them is avoided). */
5108 VEC(cached_reg_t
) *regcache
;
5110 int stopped_by_watchpoint_p
;
5111 CORE_ADDR watch_data_address
;
5119 /* The list of already fetched and acknowledged stop events. */
5120 static struct stop_reply
*stop_reply_queue
;
5122 static struct stop_reply
*
5123 stop_reply_xmalloc (void)
5125 struct stop_reply
*r
= XMALLOC (struct stop_reply
);
5132 stop_reply_xfree (struct stop_reply
*r
)
5136 VEC_free (cached_reg_t
, r
->regcache
);
5141 /* Discard all pending stop replies of inferior PID. If PID is -1,
5142 discard everything. */
5145 discard_pending_stop_replies (int pid
)
5147 struct stop_reply
*prev
= NULL
, *reply
, *next
;
5149 /* Discard the in-flight notification. */
5150 if (pending_stop_reply
!= NULL
5152 || ptid_get_pid (pending_stop_reply
->ptid
) == pid
))
5154 stop_reply_xfree (pending_stop_reply
);
5155 pending_stop_reply
= NULL
;
5158 /* Discard the stop replies we have already pulled with
5160 for (reply
= stop_reply_queue
; reply
; reply
= next
)
5164 || ptid_get_pid (reply
->ptid
) == pid
)
5166 if (reply
== stop_reply_queue
)
5167 stop_reply_queue
= reply
->next
;
5169 prev
->next
= reply
->next
;
5171 stop_reply_xfree (reply
);
5178 /* Cleanup wrapper. */
5181 do_stop_reply_xfree (void *arg
)
5183 struct stop_reply
*r
= arg
;
5185 stop_reply_xfree (r
);
5188 /* Look for a queued stop reply belonging to PTID. If one is found,
5189 remove it from the queue, and return it. Returns NULL if none is
5190 found. If there are still queued events left to process, tell the
5191 event loop to get back to target_wait soon. */
5193 static struct stop_reply
*
5194 queued_stop_reply (ptid_t ptid
)
5196 struct stop_reply
*it
;
5197 struct stop_reply
**it_link
;
5199 it
= stop_reply_queue
;
5200 it_link
= &stop_reply_queue
;
5203 if (ptid_match (it
->ptid
, ptid
))
5205 *it_link
= it
->next
;
5210 it_link
= &it
->next
;
5214 if (stop_reply_queue
)
5215 /* There's still at least an event left. */
5216 mark_async_event_handler (remote_async_inferior_event_token
);
5221 /* Push a fully parsed stop reply in the stop reply queue. Since we
5222 know that we now have at least one queued event left to pass to the
5223 core side, tell the event loop to get back to target_wait soon. */
5226 push_stop_reply (struct stop_reply
*new_event
)
5228 struct stop_reply
*event
;
5230 if (stop_reply_queue
)
5232 for (event
= stop_reply_queue
;
5233 event
&& event
->next
;
5234 event
= event
->next
)
5237 event
->next
= new_event
;
5240 stop_reply_queue
= new_event
;
5242 mark_async_event_handler (remote_async_inferior_event_token
);
5245 /* Returns true if we have a stop reply for PTID. */
5248 peek_stop_reply (ptid_t ptid
)
5250 struct stop_reply
*it
;
5252 for (it
= stop_reply_queue
; it
; it
= it
->next
)
5253 if (ptid_equal (ptid
, it
->ptid
))
5255 if (it
->ws
.kind
== TARGET_WAITKIND_STOPPED
)
5262 /* Parse the stop reply in BUF. Either the function succeeds, and the
5263 result is stored in EVENT, or throws an error. */
5266 remote_parse_stop_reply (char *buf
, struct stop_reply
*event
)
5268 struct remote_arch_state
*rsa
= get_remote_arch_state ();
5272 event
->ptid
= null_ptid
;
5273 event
->ws
.kind
= TARGET_WAITKIND_IGNORE
;
5274 event
->ws
.value
.integer
= 0;
5275 event
->solibs_changed
= 0;
5276 event
->replay_event
= 0;
5277 event
->stopped_by_watchpoint_p
= 0;
5278 event
->regcache
= NULL
;
5283 case 'T': /* Status with PC, SP, FP, ... */
5284 /* Expedited reply, containing Signal, {regno, reg} repeat. */
5285 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
5287 n... = register number
5288 r... = register contents
5291 p
= &buf
[3]; /* after Txx */
5299 /* If the packet contains a register number, save it in
5300 pnum and set p1 to point to the character following it.
5301 Otherwise p1 points to p. */
5303 /* If this packet is an awatch packet, don't parse the 'a'
5304 as a register number. */
5306 if (strncmp (p
, "awatch", strlen("awatch")) != 0
5307 && strncmp (p
, "core", strlen ("core") != 0))
5309 /* Read the ``P'' register number. */
5310 pnum
= strtol (p
, &p_temp
, 16);
5316 if (p1
== p
) /* No register number present here. */
5318 p1
= strchr (p
, ':');
5320 error (_("Malformed packet(a) (missing colon): %s\n\
5323 if (strncmp (p
, "thread", p1
- p
) == 0)
5324 event
->ptid
= read_ptid (++p1
, &p
);
5325 else if ((strncmp (p
, "watch", p1
- p
) == 0)
5326 || (strncmp (p
, "rwatch", p1
- p
) == 0)
5327 || (strncmp (p
, "awatch", p1
- p
) == 0))
5329 event
->stopped_by_watchpoint_p
= 1;
5330 p
= unpack_varlen_hex (++p1
, &addr
);
5331 event
->watch_data_address
= (CORE_ADDR
) addr
;
5333 else if (strncmp (p
, "library", p1
- p
) == 0)
5337 while (*p_temp
&& *p_temp
!= ';')
5340 event
->solibs_changed
= 1;
5343 else if (strncmp (p
, "replaylog", p1
- p
) == 0)
5345 /* NO_HISTORY event.
5346 p1 will indicate "begin" or "end", but
5347 it makes no difference for now, so ignore it. */
5348 event
->replay_event
= 1;
5349 p_temp
= strchr (p1
+ 1, ';');
5353 else if (strncmp (p
, "core", p1
- p
) == 0)
5357 p
= unpack_varlen_hex (++p1
, &c
);
5362 /* Silently skip unknown optional info. */
5363 p_temp
= strchr (p1
+ 1, ';');
5370 struct packet_reg
*reg
= packet_reg_from_pnum (rsa
, pnum
);
5371 cached_reg_t cached_reg
;
5376 error (_("Malformed packet(b) (missing colon): %s\n\
5382 error (_("Remote sent bad register number %s: %s\n\
5384 hex_string (pnum
), p
, buf
);
5386 cached_reg
.num
= reg
->regnum
;
5388 fieldsize
= hex2bin (p
, cached_reg
.data
,
5389 register_size (target_gdbarch
,
5392 if (fieldsize
< register_size (target_gdbarch
,
5394 warning (_("Remote reply is too short: %s"), buf
);
5396 VEC_safe_push (cached_reg_t
, event
->regcache
, &cached_reg
);
5400 error (_("Remote register badly formatted: %s\nhere: %s"),
5405 case 'S': /* Old style status, just signal only. */
5406 if (event
->solibs_changed
)
5407 event
->ws
.kind
= TARGET_WAITKIND_LOADED
;
5408 else if (event
->replay_event
)
5409 event
->ws
.kind
= TARGET_WAITKIND_NO_HISTORY
;
5412 event
->ws
.kind
= TARGET_WAITKIND_STOPPED
;
5413 event
->ws
.value
.sig
= (enum gdb_signal
)
5414 (((fromhex (buf
[1])) << 4) + (fromhex (buf
[2])));
5417 case 'W': /* Target exited. */
5424 /* GDB used to accept only 2 hex chars here. Stubs should
5425 only send more if they detect GDB supports multi-process
5427 p
= unpack_varlen_hex (&buf
[1], &value
);
5431 /* The remote process exited. */
5432 event
->ws
.kind
= TARGET_WAITKIND_EXITED
;
5433 event
->ws
.value
.integer
= value
;
5437 /* The remote process exited with a signal. */
5438 event
->ws
.kind
= TARGET_WAITKIND_SIGNALLED
;
5439 event
->ws
.value
.sig
= (enum gdb_signal
) value
;
5442 /* If no process is specified, assume inferior_ptid. */
5443 pid
= ptid_get_pid (inferior_ptid
);
5452 else if (strncmp (p
,
5453 "process:", sizeof ("process:") - 1) == 0)
5457 p
+= sizeof ("process:") - 1;
5458 unpack_varlen_hex (p
, &upid
);
5462 error (_("unknown stop reply packet: %s"), buf
);
5465 error (_("unknown stop reply packet: %s"), buf
);
5466 event
->ptid
= pid_to_ptid (pid
);
5471 if (non_stop
&& ptid_equal (event
->ptid
, null_ptid
))
5472 error (_("No process or thread specified in stop reply: %s"), buf
);
5475 /* When the stub wants to tell GDB about a new stop reply, it sends a
5476 stop notification (%Stop). Those can come it at any time, hence,
5477 we have to make sure that any pending putpkt/getpkt sequence we're
5478 making is finished, before querying the stub for more events with
5479 vStopped. E.g., if we started a vStopped sequence immediatelly
5480 upon receiving the %Stop notification, something like this could
5488 1.6) <-- (registers reply to step #1.3)
5490 Obviously, the reply in step #1.6 would be unexpected to a vStopped
5493 To solve this, whenever we parse a %Stop notification sucessfully,
5494 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
5495 doing whatever we were doing:
5501 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
5502 2.5) <-- (registers reply to step #2.3)
5504 Eventualy after step #2.5, we return to the event loop, which
5505 notices there's an event on the
5506 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
5507 associated callback --- the function below. At this point, we're
5508 always safe to start a vStopped sequence. :
5511 2.7) <-- T05 thread:2
5517 remote_get_pending_stop_replies (void)
5519 struct remote_state
*rs
= get_remote_state ();
5521 if (pending_stop_reply
)
5524 putpkt ("vStopped");
5526 /* Now we can rely on it. */
5527 push_stop_reply (pending_stop_reply
);
5528 pending_stop_reply
= NULL
;
5532 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
5533 if (strcmp (rs
->buf
, "OK") == 0)
5537 struct cleanup
*old_chain
;
5538 struct stop_reply
*stop_reply
= stop_reply_xmalloc ();
5540 old_chain
= make_cleanup (do_stop_reply_xfree
, stop_reply
);
5541 remote_parse_stop_reply (rs
->buf
, stop_reply
);
5544 putpkt ("vStopped");
5546 if (stop_reply
->ws
.kind
!= TARGET_WAITKIND_IGNORE
)
5548 /* Now we can rely on it. */
5549 discard_cleanups (old_chain
);
5550 push_stop_reply (stop_reply
);
5553 /* We got an unknown stop reply. */
5554 do_cleanups (old_chain
);
5561 /* Called when it is decided that STOP_REPLY holds the info of the
5562 event that is to be returned to the core. This function always
5563 destroys STOP_REPLY. */
5566 process_stop_reply (struct stop_reply
*stop_reply
,
5567 struct target_waitstatus
*status
)
5571 *status
= stop_reply
->ws
;
5572 ptid
= stop_reply
->ptid
;
5574 /* If no thread/process was reported by the stub, assume the current
5576 if (ptid_equal (ptid
, null_ptid
))
5577 ptid
= inferior_ptid
;
5579 if (status
->kind
!= TARGET_WAITKIND_EXITED
5580 && status
->kind
!= TARGET_WAITKIND_SIGNALLED
)
5582 /* Expedited registers. */
5583 if (stop_reply
->regcache
)
5585 struct regcache
*regcache
5586 = get_thread_arch_regcache (ptid
, target_gdbarch
);
5591 VEC_iterate(cached_reg_t
, stop_reply
->regcache
, ix
, reg
);
5593 regcache_raw_supply (regcache
, reg
->num
, reg
->data
);
5594 VEC_free (cached_reg_t
, stop_reply
->regcache
);
5597 remote_stopped_by_watchpoint_p
= stop_reply
->stopped_by_watchpoint_p
;
5598 remote_watch_data_address
= stop_reply
->watch_data_address
;
5600 remote_notice_new_inferior (ptid
, 0);
5601 demand_private_info (ptid
)->core
= stop_reply
->core
;
5604 stop_reply_xfree (stop_reply
);
5608 /* The non-stop mode version of target_wait. */
5611 remote_wait_ns (ptid_t ptid
, struct target_waitstatus
*status
, int options
)
5613 struct remote_state
*rs
= get_remote_state ();
5614 struct stop_reply
*stop_reply
;
5617 /* If in non-stop mode, get out of getpkt even if a
5618 notification is received. */
5620 ret
= getpkt_or_notif_sane (&rs
->buf
, &rs
->buf_size
,
5627 case 'E': /* Error of some sort. */
5628 /* We're out of sync with the target now. Did it continue
5629 or not? We can't tell which thread it was in non-stop,
5630 so just ignore this. */
5631 warning (_("Remote failure reply: %s"), rs
->buf
);
5633 case 'O': /* Console output. */
5634 remote_console_output (rs
->buf
+ 1);
5637 warning (_("Invalid remote reply: %s"), rs
->buf
);
5641 /* Acknowledge a pending stop reply that may have arrived in the
5643 if (pending_stop_reply
!= NULL
)
5644 remote_get_pending_stop_replies ();
5646 /* If indeed we noticed a stop reply, we're done. */
5647 stop_reply
= queued_stop_reply (ptid
);
5648 if (stop_reply
!= NULL
)
5649 return process_stop_reply (stop_reply
, status
);
5651 /* Still no event. If we're just polling for an event, then
5652 return to the event loop. */
5653 if (options
& TARGET_WNOHANG
)
5655 status
->kind
= TARGET_WAITKIND_IGNORE
;
5656 return minus_one_ptid
;
5659 /* Otherwise do a blocking wait. */
5660 ret
= getpkt_or_notif_sane (&rs
->buf
, &rs
->buf_size
,
5665 /* Wait until the remote machine stops, then return, storing status in
5666 STATUS just as `wait' would. */
5669 remote_wait_as (ptid_t ptid
, struct target_waitstatus
*status
, int options
)
5671 struct remote_state
*rs
= get_remote_state ();
5672 ptid_t event_ptid
= null_ptid
;
5674 struct stop_reply
*stop_reply
;
5678 status
->kind
= TARGET_WAITKIND_IGNORE
;
5679 status
->value
.integer
= 0;
5681 stop_reply
= queued_stop_reply (ptid
);
5682 if (stop_reply
!= NULL
)
5683 return process_stop_reply (stop_reply
, status
);
5685 if (rs
->cached_wait_status
)
5686 /* Use the cached wait status, but only once. */
5687 rs
->cached_wait_status
= 0;
5692 if (!target_is_async_p ())
5694 ofunc
= signal (SIGINT
, remote_interrupt
);
5695 /* If the user hit C-c before this packet, or between packets,
5696 pretend that it was hit right here. */
5700 remote_interrupt (SIGINT
);
5704 /* FIXME: cagney/1999-09-27: If we're in async mode we should
5705 _never_ wait for ever -> test on target_is_async_p().
5706 However, before we do that we need to ensure that the caller
5707 knows how to take the target into/out of async mode. */
5708 ret
= getpkt_sane (&rs
->buf
, &rs
->buf_size
, wait_forever_enabled_p
);
5709 if (!target_is_async_p ())
5710 signal (SIGINT
, ofunc
);
5715 remote_stopped_by_watchpoint_p
= 0;
5717 /* We got something. */
5718 rs
->waiting_for_stop_reply
= 0;
5720 /* Assume that the target has acknowledged Ctrl-C unless we receive
5721 an 'F' or 'O' packet. */
5722 if (buf
[0] != 'F' && buf
[0] != 'O')
5723 rs
->ctrlc_pending_p
= 0;
5727 case 'E': /* Error of some sort. */
5728 /* We're out of sync with the target now. Did it continue or
5729 not? Not is more likely, so report a stop. */
5730 warning (_("Remote failure reply: %s"), buf
);
5731 status
->kind
= TARGET_WAITKIND_STOPPED
;
5732 status
->value
.sig
= GDB_SIGNAL_0
;
5734 case 'F': /* File-I/O request. */
5735 remote_fileio_request (buf
, rs
->ctrlc_pending_p
);
5736 rs
->ctrlc_pending_p
= 0;
5738 case 'T': case 'S': case 'X': case 'W':
5740 struct stop_reply
*stop_reply
;
5741 struct cleanup
*old_chain
;
5743 stop_reply
= stop_reply_xmalloc ();
5744 old_chain
= make_cleanup (do_stop_reply_xfree
, stop_reply
);
5745 remote_parse_stop_reply (buf
, stop_reply
);
5746 discard_cleanups (old_chain
);
5747 event_ptid
= process_stop_reply (stop_reply
, status
);
5750 case 'O': /* Console output. */
5751 remote_console_output (buf
+ 1);
5753 /* The target didn't really stop; keep waiting. */
5754 rs
->waiting_for_stop_reply
= 1;
5758 if (last_sent_signal
!= GDB_SIGNAL_0
)
5760 /* Zero length reply means that we tried 'S' or 'C' and the
5761 remote system doesn't support it. */
5762 target_terminal_ours_for_output ();
5764 ("Can't send signals to this remote system. %s not sent.\n",
5765 gdb_signal_to_name (last_sent_signal
));
5766 last_sent_signal
= GDB_SIGNAL_0
;
5767 target_terminal_inferior ();
5769 strcpy ((char *) buf
, last_sent_step
? "s" : "c");
5770 putpkt ((char *) buf
);
5772 /* We just told the target to resume, so a stop reply is in
5774 rs
->waiting_for_stop_reply
= 1;
5777 /* else fallthrough */
5779 warning (_("Invalid remote reply: %s"), buf
);
5781 rs
->waiting_for_stop_reply
= 1;
5785 if (status
->kind
== TARGET_WAITKIND_IGNORE
)
5787 /* Nothing interesting happened. If we're doing a non-blocking
5788 poll, we're done. Otherwise, go back to waiting. */
5789 if (options
& TARGET_WNOHANG
)
5790 return minus_one_ptid
;
5794 else if (status
->kind
!= TARGET_WAITKIND_EXITED
5795 && status
->kind
!= TARGET_WAITKIND_SIGNALLED
)
5797 if (!ptid_equal (event_ptid
, null_ptid
))
5798 record_currthread (event_ptid
);
5800 event_ptid
= inferior_ptid
;
5803 /* A process exit. Invalidate our notion of current thread. */
5804 record_currthread (minus_one_ptid
);
5809 /* Wait until the remote machine stops, then return, storing status in
5810 STATUS just as `wait' would. */
5813 remote_wait (struct target_ops
*ops
,
5814 ptid_t ptid
, struct target_waitstatus
*status
, int options
)
5819 event_ptid
= remote_wait_ns (ptid
, status
, options
);
5821 event_ptid
= remote_wait_as (ptid
, status
, options
);
5823 if (target_can_async_p ())
5825 /* If there are are events left in the queue tell the event loop
5827 if (stop_reply_queue
)
5828 mark_async_event_handler (remote_async_inferior_event_token
);
5834 /* Fetch a single register using a 'p' packet. */
5837 fetch_register_using_p (struct regcache
*regcache
, struct packet_reg
*reg
)
5839 struct remote_state
*rs
= get_remote_state ();
5841 char regp
[MAX_REGISTER_SIZE
];
5844 if (remote_protocol_packets
[PACKET_p
].support
== PACKET_DISABLE
)
5847 if (reg
->pnum
== -1)
5852 p
+= hexnumstr (p
, reg
->pnum
);
5855 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
5859 switch (packet_ok (buf
, &remote_protocol_packets
[PACKET_p
]))
5863 case PACKET_UNKNOWN
:
5866 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
5867 gdbarch_register_name (get_regcache_arch (regcache
),
5872 /* If this register is unfetchable, tell the regcache. */
5875 regcache_raw_supply (regcache
, reg
->regnum
, NULL
);
5879 /* Otherwise, parse and supply the value. */
5885 error (_("fetch_register_using_p: early buf termination"));
5887 regp
[i
++] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
5890 regcache_raw_supply (regcache
, reg
->regnum
, regp
);
5894 /* Fetch the registers included in the target's 'g' packet. */
5897 send_g_packet (void)
5899 struct remote_state
*rs
= get_remote_state ();
5902 xsnprintf (rs
->buf
, get_remote_packet_size (), "g");
5903 remote_send (&rs
->buf
, &rs
->buf_size
);
5905 /* We can get out of synch in various cases. If the first character
5906 in the buffer is not a hex character, assume that has happened
5907 and try to fetch another packet to read. */
5908 while ((rs
->buf
[0] < '0' || rs
->buf
[0] > '9')
5909 && (rs
->buf
[0] < 'A' || rs
->buf
[0] > 'F')
5910 && (rs
->buf
[0] < 'a' || rs
->buf
[0] > 'f')
5911 && rs
->buf
[0] != 'x') /* New: unavailable register value. */
5914 fprintf_unfiltered (gdb_stdlog
,
5915 "Bad register packet; fetching a new packet\n");
5916 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
5919 buf_len
= strlen (rs
->buf
);
5921 /* Sanity check the received packet. */
5922 if (buf_len
% 2 != 0)
5923 error (_("Remote 'g' packet reply is of odd length: %s"), rs
->buf
);
5929 process_g_packet (struct regcache
*regcache
)
5931 struct gdbarch
*gdbarch
= get_regcache_arch (regcache
);
5932 struct remote_state
*rs
= get_remote_state ();
5933 struct remote_arch_state
*rsa
= get_remote_arch_state ();
5938 buf_len
= strlen (rs
->buf
);
5940 /* Further sanity checks, with knowledge of the architecture. */
5941 if (buf_len
> 2 * rsa
->sizeof_g_packet
)
5942 error (_("Remote 'g' packet reply is too long: %s"), rs
->buf
);
5944 /* Save the size of the packet sent to us by the target. It is used
5945 as a heuristic when determining the max size of packets that the
5946 target can safely receive. */
5947 if (rsa
->actual_register_packet_size
== 0)
5948 rsa
->actual_register_packet_size
= buf_len
;
5950 /* If this is smaller than we guessed the 'g' packet would be,
5951 update our records. A 'g' reply that doesn't include a register's
5952 value implies either that the register is not available, or that
5953 the 'p' packet must be used. */
5954 if (buf_len
< 2 * rsa
->sizeof_g_packet
)
5956 rsa
->sizeof_g_packet
= buf_len
/ 2;
5958 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
5960 if (rsa
->regs
[i
].pnum
== -1)
5963 if (rsa
->regs
[i
].offset
>= rsa
->sizeof_g_packet
)
5964 rsa
->regs
[i
].in_g_packet
= 0;
5966 rsa
->regs
[i
].in_g_packet
= 1;
5970 regs
= alloca (rsa
->sizeof_g_packet
);
5972 /* Unimplemented registers read as all bits zero. */
5973 memset (regs
, 0, rsa
->sizeof_g_packet
);
5975 /* Reply describes registers byte by byte, each byte encoded as two
5976 hex characters. Suck them all up, then supply them to the
5977 register cacheing/storage mechanism. */
5980 for (i
= 0; i
< rsa
->sizeof_g_packet
; i
++)
5982 if (p
[0] == 0 || p
[1] == 0)
5983 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
5984 internal_error (__FILE__
, __LINE__
,
5985 _("unexpected end of 'g' packet reply"));
5987 if (p
[0] == 'x' && p
[1] == 'x')
5988 regs
[i
] = 0; /* 'x' */
5990 regs
[i
] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
5994 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
5996 struct packet_reg
*r
= &rsa
->regs
[i
];
6000 if (r
->offset
* 2 >= strlen (rs
->buf
))
6001 /* This shouldn't happen - we adjusted in_g_packet above. */
6002 internal_error (__FILE__
, __LINE__
,
6003 _("unexpected end of 'g' packet reply"));
6004 else if (rs
->buf
[r
->offset
* 2] == 'x')
6006 gdb_assert (r
->offset
* 2 < strlen (rs
->buf
));
6007 /* The register isn't available, mark it as such (at
6008 the same time setting the value to zero). */
6009 regcache_raw_supply (regcache
, r
->regnum
, NULL
);
6012 regcache_raw_supply (regcache
, r
->regnum
,
6019 fetch_registers_using_g (struct regcache
*regcache
)
6022 process_g_packet (regcache
);
6025 /* Make the remote selected traceframe match GDB's selected
6029 set_remote_traceframe (void)
6033 if (remote_traceframe_number
== get_traceframe_number ())
6036 /* Avoid recursion, remote_trace_find calls us again. */
6037 remote_traceframe_number
= get_traceframe_number ();
6039 newnum
= target_trace_find (tfind_number
,
6040 get_traceframe_number (), 0, 0, NULL
);
6042 /* Should not happen. If it does, all bets are off. */
6043 if (newnum
!= get_traceframe_number ())
6044 warning (_("could not set remote traceframe"));
6048 remote_fetch_registers (struct target_ops
*ops
,
6049 struct regcache
*regcache
, int regnum
)
6051 struct remote_arch_state
*rsa
= get_remote_arch_state ();
6054 set_remote_traceframe ();
6055 set_general_thread (inferior_ptid
);
6059 struct packet_reg
*reg
= packet_reg_from_regnum (rsa
, regnum
);
6061 gdb_assert (reg
!= NULL
);
6063 /* If this register might be in the 'g' packet, try that first -
6064 we are likely to read more than one register. If this is the
6065 first 'g' packet, we might be overly optimistic about its
6066 contents, so fall back to 'p'. */
6067 if (reg
->in_g_packet
)
6069 fetch_registers_using_g (regcache
);
6070 if (reg
->in_g_packet
)
6074 if (fetch_register_using_p (regcache
, reg
))
6077 /* This register is not available. */
6078 regcache_raw_supply (regcache
, reg
->regnum
, NULL
);
6083 fetch_registers_using_g (regcache
);
6085 for (i
= 0; i
< gdbarch_num_regs (get_regcache_arch (regcache
)); i
++)
6086 if (!rsa
->regs
[i
].in_g_packet
)
6087 if (!fetch_register_using_p (regcache
, &rsa
->regs
[i
]))
6089 /* This register is not available. */
6090 regcache_raw_supply (regcache
, i
, NULL
);
6094 /* Prepare to store registers. Since we may send them all (using a
6095 'G' request), we have to read out the ones we don't want to change
6099 remote_prepare_to_store (struct regcache
*regcache
)
6101 struct remote_arch_state
*rsa
= get_remote_arch_state ();
6103 gdb_byte buf
[MAX_REGISTER_SIZE
];
6105 /* Make sure the entire registers array is valid. */
6106 switch (remote_protocol_packets
[PACKET_P
].support
)
6108 case PACKET_DISABLE
:
6109 case PACKET_SUPPORT_UNKNOWN
:
6110 /* Make sure all the necessary registers are cached. */
6111 for (i
= 0; i
< gdbarch_num_regs (get_regcache_arch (regcache
)); i
++)
6112 if (rsa
->regs
[i
].in_g_packet
)
6113 regcache_raw_read (regcache
, rsa
->regs
[i
].regnum
, buf
);
6120 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
6121 packet was not recognized. */
6124 store_register_using_P (const struct regcache
*regcache
,
6125 struct packet_reg
*reg
)
6127 struct gdbarch
*gdbarch
= get_regcache_arch (regcache
);
6128 struct remote_state
*rs
= get_remote_state ();
6129 /* Try storing a single register. */
6130 char *buf
= rs
->buf
;
6131 gdb_byte regp
[MAX_REGISTER_SIZE
];
6134 if (remote_protocol_packets
[PACKET_P
].support
== PACKET_DISABLE
)
6137 if (reg
->pnum
== -1)
6140 xsnprintf (buf
, get_remote_packet_size (), "P%s=", phex_nz (reg
->pnum
, 0));
6141 p
= buf
+ strlen (buf
);
6142 regcache_raw_collect (regcache
, reg
->regnum
, regp
);
6143 bin2hex (regp
, p
, register_size (gdbarch
, reg
->regnum
));
6145 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6147 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_P
]))
6152 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
6153 gdbarch_register_name (gdbarch
, reg
->regnum
), rs
->buf
);
6154 case PACKET_UNKNOWN
:
6157 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
6161 /* Store register REGNUM, or all registers if REGNUM == -1, from the
6162 contents of the register cache buffer. FIXME: ignores errors. */
6165 store_registers_using_G (const struct regcache
*regcache
)
6167 struct remote_state
*rs
= get_remote_state ();
6168 struct remote_arch_state
*rsa
= get_remote_arch_state ();
6172 /* Extract all the registers in the regcache copying them into a
6177 regs
= alloca (rsa
->sizeof_g_packet
);
6178 memset (regs
, 0, rsa
->sizeof_g_packet
);
6179 for (i
= 0; i
< gdbarch_num_regs (get_regcache_arch (regcache
)); i
++)
6181 struct packet_reg
*r
= &rsa
->regs
[i
];
6184 regcache_raw_collect (regcache
, r
->regnum
, regs
+ r
->offset
);
6188 /* Command describes registers byte by byte,
6189 each byte encoded as two hex characters. */
6192 /* remote_prepare_to_store insures that rsa->sizeof_g_packet gets
6194 bin2hex (regs
, p
, rsa
->sizeof_g_packet
);
6196 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6197 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
6198 error (_("Could not write registers; remote failure reply '%s'"),
6202 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
6203 of the register cache buffer. FIXME: ignores errors. */
6206 remote_store_registers (struct target_ops
*ops
,
6207 struct regcache
*regcache
, int regnum
)
6209 struct remote_arch_state
*rsa
= get_remote_arch_state ();
6212 set_remote_traceframe ();
6213 set_general_thread (inferior_ptid
);
6217 struct packet_reg
*reg
= packet_reg_from_regnum (rsa
, regnum
);
6219 gdb_assert (reg
!= NULL
);
6221 /* Always prefer to store registers using the 'P' packet if
6222 possible; we often change only a small number of registers.
6223 Sometimes we change a larger number; we'd need help from a
6224 higher layer to know to use 'G'. */
6225 if (store_register_using_P (regcache
, reg
))
6228 /* For now, don't complain if we have no way to write the
6229 register. GDB loses track of unavailable registers too
6230 easily. Some day, this may be an error. We don't have
6231 any way to read the register, either... */
6232 if (!reg
->in_g_packet
)
6235 store_registers_using_G (regcache
);
6239 store_registers_using_G (regcache
);
6241 for (i
= 0; i
< gdbarch_num_regs (get_regcache_arch (regcache
)); i
++)
6242 if (!rsa
->regs
[i
].in_g_packet
)
6243 if (!store_register_using_P (regcache
, &rsa
->regs
[i
]))
6244 /* See above for why we do not issue an error here. */
6249 /* Return the number of hex digits in num. */
6252 hexnumlen (ULONGEST num
)
6256 for (i
= 0; num
!= 0; i
++)
6262 /* Set BUF to the minimum number of hex digits representing NUM. */
6265 hexnumstr (char *buf
, ULONGEST num
)
6267 int len
= hexnumlen (num
);
6269 return hexnumnstr (buf
, num
, len
);
6273 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
6276 hexnumnstr (char *buf
, ULONGEST num
, int width
)
6282 for (i
= width
- 1; i
>= 0; i
--)
6284 buf
[i
] = "0123456789abcdef"[(num
& 0xf)];
6291 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
6294 remote_address_masked (CORE_ADDR addr
)
6296 int address_size
= remote_address_size
;
6298 /* If "remoteaddresssize" was not set, default to target address size. */
6300 address_size
= gdbarch_addr_bit (target_gdbarch
);
6302 if (address_size
> 0
6303 && address_size
< (sizeof (ULONGEST
) * 8))
6305 /* Only create a mask when that mask can safely be constructed
6306 in a ULONGEST variable. */
6309 mask
= (mask
<< address_size
) - 1;
6315 /* Convert BUFFER, binary data at least LEN bytes long, into escaped
6316 binary data in OUT_BUF. Set *OUT_LEN to the length of the data
6317 encoded in OUT_BUF, and return the number of bytes in OUT_BUF
6318 (which may be more than *OUT_LEN due to escape characters). The
6319 total number of bytes in the output buffer will be at most
6323 remote_escape_output (const gdb_byte
*buffer
, int len
,
6324 gdb_byte
*out_buf
, int *out_len
,
6327 int input_index
, output_index
;
6330 for (input_index
= 0; input_index
< len
; input_index
++)
6332 gdb_byte b
= buffer
[input_index
];
6334 if (b
== '$' || b
== '#' || b
== '}')
6336 /* These must be escaped. */
6337 if (output_index
+ 2 > out_maxlen
)
6339 out_buf
[output_index
++] = '}';
6340 out_buf
[output_index
++] = b
^ 0x20;
6344 if (output_index
+ 1 > out_maxlen
)
6346 out_buf
[output_index
++] = b
;
6350 *out_len
= input_index
;
6351 return output_index
;
6354 /* Convert BUFFER, escaped data LEN bytes long, into binary data
6355 in OUT_BUF. Return the number of bytes written to OUT_BUF.
6356 Raise an error if the total number of bytes exceeds OUT_MAXLEN.
6358 This function reverses remote_escape_output. It allows more
6359 escaped characters than that function does, in particular because
6360 '*' must be escaped to avoid the run-length encoding processing
6361 in reading packets. */
6364 remote_unescape_input (const gdb_byte
*buffer
, int len
,
6365 gdb_byte
*out_buf
, int out_maxlen
)
6367 int input_index
, output_index
;
6372 for (input_index
= 0; input_index
< len
; input_index
++)
6374 gdb_byte b
= buffer
[input_index
];
6376 if (output_index
+ 1 > out_maxlen
)
6378 warning (_("Received too much data from remote target;"
6379 " ignoring overflow."));
6380 return output_index
;
6385 out_buf
[output_index
++] = b
^ 0x20;
6391 out_buf
[output_index
++] = b
;
6395 error (_("Unmatched escape character in target response."));
6397 return output_index
;
6400 /* Determine whether the remote target supports binary downloading.
6401 This is accomplished by sending a no-op memory write of zero length
6402 to the target at the specified address. It does not suffice to send
6403 the whole packet, since many stubs strip the eighth bit and
6404 subsequently compute a wrong checksum, which causes real havoc with
6407 NOTE: This can still lose if the serial line is not eight-bit
6408 clean. In cases like this, the user should clear "remote
6412 check_binary_download (CORE_ADDR addr
)
6414 struct remote_state
*rs
= get_remote_state ();
6416 switch (remote_protocol_packets
[PACKET_X
].support
)
6418 case PACKET_DISABLE
:
6422 case PACKET_SUPPORT_UNKNOWN
:
6428 p
+= hexnumstr (p
, (ULONGEST
) addr
);
6430 p
+= hexnumstr (p
, (ULONGEST
) 0);
6434 putpkt_binary (rs
->buf
, (int) (p
- rs
->buf
));
6435 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6437 if (rs
->buf
[0] == '\0')
6440 fprintf_unfiltered (gdb_stdlog
,
6441 "binary downloading NOT "
6442 "supported by target\n");
6443 remote_protocol_packets
[PACKET_X
].support
= PACKET_DISABLE
;
6448 fprintf_unfiltered (gdb_stdlog
,
6449 "binary downloading supported by target\n");
6450 remote_protocol_packets
[PACKET_X
].support
= PACKET_ENABLE
;
6457 /* Write memory data directly to the remote machine.
6458 This does not inform the data cache; the data cache uses this.
6459 HEADER is the starting part of the packet.
6460 MEMADDR is the address in the remote memory space.
6461 MYADDR is the address of the buffer in our space.
6462 LEN is the number of bytes.
6463 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
6464 should send data as binary ('X'), or hex-encoded ('M').
6466 The function creates packet of the form
6467 <HEADER><ADDRESS>,<LENGTH>:<DATA>
6469 where encoding of <DATA> is termined by PACKET_FORMAT.
6471 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
6474 Returns the number of bytes transferred, or 0 (setting errno) for
6475 error. Only transfer a single packet. */
6478 remote_write_bytes_aux (const char *header
, CORE_ADDR memaddr
,
6479 const gdb_byte
*myaddr
, ssize_t len
,
6480 char packet_format
, int use_length
)
6482 struct remote_state
*rs
= get_remote_state ();
6492 if (packet_format
!= 'X' && packet_format
!= 'M')
6493 internal_error (__FILE__
, __LINE__
,
6494 _("remote_write_bytes_aux: bad packet format"));
6499 payload_size
= get_memory_write_packet_size ();
6501 /* The packet buffer will be large enough for the payload;
6502 get_memory_packet_size ensures this. */
6505 /* Compute the size of the actual payload by subtracting out the
6506 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
6508 payload_size
-= strlen ("$,:#NN");
6510 /* The comma won't be used. */
6512 header_length
= strlen (header
);
6513 payload_size
-= header_length
;
6514 payload_size
-= hexnumlen (memaddr
);
6516 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
6518 strcat (rs
->buf
, header
);
6519 p
= rs
->buf
+ strlen (header
);
6521 /* Compute a best guess of the number of bytes actually transfered. */
6522 if (packet_format
== 'X')
6524 /* Best guess at number of bytes that will fit. */
6525 todo
= min (len
, payload_size
);
6527 payload_size
-= hexnumlen (todo
);
6528 todo
= min (todo
, payload_size
);
6532 /* Num bytes that will fit. */
6533 todo
= min (len
, payload_size
/ 2);
6535 payload_size
-= hexnumlen (todo
);
6536 todo
= min (todo
, payload_size
/ 2);
6540 internal_error (__FILE__
, __LINE__
,
6541 _("minimum packet size too small to write data"));
6543 /* If we already need another packet, then try to align the end
6544 of this packet to a useful boundary. */
6545 if (todo
> 2 * REMOTE_ALIGN_WRITES
&& todo
< len
)
6546 todo
= ((memaddr
+ todo
) & ~(REMOTE_ALIGN_WRITES
- 1)) - memaddr
;
6548 /* Append "<memaddr>". */
6549 memaddr
= remote_address_masked (memaddr
);
6550 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
6557 /* Append <len>. Retain the location/size of <len>. It may need to
6558 be adjusted once the packet body has been created. */
6560 plenlen
= hexnumstr (p
, (ULONGEST
) todo
);
6568 /* Append the packet body. */
6569 if (packet_format
== 'X')
6571 /* Binary mode. Send target system values byte by byte, in
6572 increasing byte addresses. Only escape certain critical
6574 payload_length
= remote_escape_output (myaddr
, todo
, p
, &nr_bytes
,
6577 /* If not all TODO bytes fit, then we'll need another packet. Make
6578 a second try to keep the end of the packet aligned. Don't do
6579 this if the packet is tiny. */
6580 if (nr_bytes
< todo
&& nr_bytes
> 2 * REMOTE_ALIGN_WRITES
)
6584 new_nr_bytes
= (((memaddr
+ nr_bytes
) & ~(REMOTE_ALIGN_WRITES
- 1))
6586 if (new_nr_bytes
!= nr_bytes
)
6587 payload_length
= remote_escape_output (myaddr
, new_nr_bytes
,
6592 p
+= payload_length
;
6593 if (use_length
&& nr_bytes
< todo
)
6595 /* Escape chars have filled up the buffer prematurely,
6596 and we have actually sent fewer bytes than planned.
6597 Fix-up the length field of the packet. Use the same
6598 number of characters as before. */
6599 plen
+= hexnumnstr (plen
, (ULONGEST
) nr_bytes
, plenlen
);
6600 *plen
= ':'; /* overwrite \0 from hexnumnstr() */
6605 /* Normal mode: Send target system values byte by byte, in
6606 increasing byte addresses. Each byte is encoded as a two hex
6608 nr_bytes
= bin2hex (myaddr
, p
, todo
);
6612 putpkt_binary (rs
->buf
, (int) (p
- rs
->buf
));
6613 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6615 if (rs
->buf
[0] == 'E')
6617 /* There is no correspondance between what the remote protocol
6618 uses for errors and errno codes. We would like a cleaner way
6619 of representing errors (big enough to include errno codes,
6620 bfd_error codes, and others). But for now just return EIO. */
6625 /* Return NR_BYTES, not TODO, in case escape chars caused us to send
6626 fewer bytes than we'd planned. */
6630 /* Write memory data directly to the remote machine.
6631 This does not inform the data cache; the data cache uses this.
6632 MEMADDR is the address in the remote memory space.
6633 MYADDR is the address of the buffer in our space.
6634 LEN is the number of bytes.
6636 Returns number of bytes transferred, or 0 (setting errno) for
6637 error. Only transfer a single packet. */
6640 remote_write_bytes (CORE_ADDR memaddr
, const gdb_byte
*myaddr
, ssize_t len
)
6642 char *packet_format
= 0;
6644 /* Check whether the target supports binary download. */
6645 check_binary_download (memaddr
);
6647 switch (remote_protocol_packets
[PACKET_X
].support
)
6650 packet_format
= "X";
6652 case PACKET_DISABLE
:
6653 packet_format
= "M";
6655 case PACKET_SUPPORT_UNKNOWN
:
6656 internal_error (__FILE__
, __LINE__
,
6657 _("remote_write_bytes: bad internal state"));
6659 internal_error (__FILE__
, __LINE__
, _("bad switch"));
6662 return remote_write_bytes_aux (packet_format
,
6663 memaddr
, myaddr
, len
, packet_format
[0], 1);
6666 /* Read memory data directly from the remote machine.
6667 This does not use the data cache; the data cache uses this.
6668 MEMADDR is the address in the remote memory space.
6669 MYADDR is the address of the buffer in our space.
6670 LEN is the number of bytes.
6672 Returns number of bytes transferred, or 0 for error. */
6675 remote_read_bytes (CORE_ADDR memaddr
, gdb_byte
*myaddr
, int len
)
6677 struct remote_state
*rs
= get_remote_state ();
6678 int max_buf_size
; /* Max size of packet output buffer. */
6686 max_buf_size
= get_memory_read_packet_size ();
6687 /* The packet buffer will be large enough for the payload;
6688 get_memory_packet_size ensures this. */
6690 /* Number if bytes that will fit. */
6691 todo
= min (len
, max_buf_size
/ 2);
6693 /* Construct "m"<memaddr>","<len>". */
6694 memaddr
= remote_address_masked (memaddr
);
6697 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
6699 p
+= hexnumstr (p
, (ULONGEST
) todo
);
6702 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6703 if (rs
->buf
[0] == 'E'
6704 && isxdigit (rs
->buf
[1]) && isxdigit (rs
->buf
[2])
6705 && rs
->buf
[3] == '\0')
6707 /* There is no correspondance between what the remote protocol
6708 uses for errors and errno codes. We would like a cleaner way
6709 of representing errors (big enough to include errno codes,
6710 bfd_error codes, and others). But for now just return
6715 /* Reply describes memory byte by byte, each byte encoded as two hex
6718 i
= hex2bin (p
, myaddr
, todo
);
6719 /* Return what we have. Let higher layers handle partial reads. */
6724 /* Remote notification handler. */
6727 handle_notification (char *buf
, size_t length
)
6729 if (strncmp (buf
, "Stop:", 5) == 0)
6731 if (pending_stop_reply
)
6733 /* We've already parsed the in-flight stop-reply, but the
6734 stub for some reason thought we didn't, possibly due to
6735 timeout on its side. Just ignore it. */
6737 fprintf_unfiltered (gdb_stdlog
, "ignoring resent notification\n");
6741 struct cleanup
*old_chain
;
6742 struct stop_reply
*reply
= stop_reply_xmalloc ();
6744 old_chain
= make_cleanup (do_stop_reply_xfree
, reply
);
6746 remote_parse_stop_reply (buf
+ 5, reply
);
6748 discard_cleanups (old_chain
);
6750 /* Be careful to only set it after parsing, since an error
6751 may be thrown then. */
6752 pending_stop_reply
= reply
;
6754 /* Notify the event loop there's a stop reply to acknowledge
6755 and that there may be more events to fetch. */
6756 mark_async_event_handler (remote_async_get_pending_events_token
);
6759 fprintf_unfiltered (gdb_stdlog
, "stop notification captured\n");
6763 /* We ignore notifications we don't recognize, for compatibility
6764 with newer stubs. */
6769 /* Read or write LEN bytes from inferior memory at MEMADDR,
6770 transferring to or from debugger address BUFFER. Write to inferior
6771 if SHOULD_WRITE is nonzero. Returns length of data written or
6772 read; 0 for error. TARGET is unused. */
6775 remote_xfer_memory (CORE_ADDR mem_addr
, gdb_byte
*buffer
, int mem_len
,
6776 int should_write
, struct mem_attrib
*attrib
,
6777 struct target_ops
*target
)
6781 set_remote_traceframe ();
6782 set_general_thread (inferior_ptid
);
6785 res
= remote_write_bytes (mem_addr
, buffer
, mem_len
);
6787 res
= remote_read_bytes (mem_addr
, buffer
, mem_len
);
6792 /* Sends a packet with content determined by the printf format string
6793 FORMAT and the remaining arguments, then gets the reply. Returns
6794 whether the packet was a success, a failure, or unknown. */
6796 static enum packet_result
6797 remote_send_printf (const char *format
, ...)
6799 struct remote_state
*rs
= get_remote_state ();
6800 int max_size
= get_remote_packet_size ();
6803 va_start (ap
, format
);
6806 if (vsnprintf (rs
->buf
, max_size
, format
, ap
) >= max_size
)
6807 internal_error (__FILE__
, __LINE__
, _("Too long remote packet."));
6809 if (putpkt (rs
->buf
) < 0)
6810 error (_("Communication problem with target."));
6813 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6815 return packet_check_result (rs
->buf
);
6819 restore_remote_timeout (void *p
)
6821 int value
= *(int *)p
;
6823 remote_timeout
= value
;
6826 /* Flash writing can take quite some time. We'll set
6827 effectively infinite timeout for flash operations.
6828 In future, we'll need to decide on a better approach. */
6829 static const int remote_flash_timeout
= 1000;
6832 remote_flash_erase (struct target_ops
*ops
,
6833 ULONGEST address
, LONGEST length
)
6835 int addr_size
= gdbarch_addr_bit (target_gdbarch
) / 8;
6836 int saved_remote_timeout
= remote_timeout
;
6837 enum packet_result ret
;
6838 struct cleanup
*back_to
= make_cleanup (restore_remote_timeout
,
6839 &saved_remote_timeout
);
6841 remote_timeout
= remote_flash_timeout
;
6843 ret
= remote_send_printf ("vFlashErase:%s,%s",
6844 phex (address
, addr_size
),
6848 case PACKET_UNKNOWN
:
6849 error (_("Remote target does not support flash erase"));
6851 error (_("Error erasing flash with vFlashErase packet"));
6856 do_cleanups (back_to
);
6860 remote_flash_write (struct target_ops
*ops
,
6861 ULONGEST address
, LONGEST length
,
6862 const gdb_byte
*data
)
6864 int saved_remote_timeout
= remote_timeout
;
6866 struct cleanup
*back_to
= make_cleanup (restore_remote_timeout
,
6867 &saved_remote_timeout
);
6869 remote_timeout
= remote_flash_timeout
;
6870 ret
= remote_write_bytes_aux ("vFlashWrite:", address
, data
, length
, 'X', 0);
6871 do_cleanups (back_to
);
6877 remote_flash_done (struct target_ops
*ops
)
6879 int saved_remote_timeout
= remote_timeout
;
6881 struct cleanup
*back_to
= make_cleanup (restore_remote_timeout
,
6882 &saved_remote_timeout
);
6884 remote_timeout
= remote_flash_timeout
;
6885 ret
= remote_send_printf ("vFlashDone");
6886 do_cleanups (back_to
);
6890 case PACKET_UNKNOWN
:
6891 error (_("Remote target does not support vFlashDone"));
6893 error (_("Error finishing flash operation"));
6900 remote_files_info (struct target_ops
*ignore
)
6902 puts_filtered ("Debugging a target over a serial line.\n");
6905 /* Stuff for dealing with the packets which are part of this protocol.
6906 See comment at top of file for details. */
6908 /* Read a single character from the remote end. */
6911 readchar (int timeout
)
6915 ch
= serial_readchar (remote_desc
, timeout
);
6920 switch ((enum serial_rc
) ch
)
6924 error (_("Remote connection closed"));
6928 perror_with_name (_("Remote communication error. "
6929 "Target disconnected."));
6931 case SERIAL_TIMEOUT
:
6937 /* Send the command in *BUF to the remote machine, and read the reply
6938 into *BUF. Report an error if we get an error reply. Resize
6939 *BUF using xrealloc if necessary to hold the result, and update
6943 remote_send (char **buf
,
6947 getpkt (buf
, sizeof_buf
, 0);
6949 if ((*buf
)[0] == 'E')
6950 error (_("Remote failure reply: %s"), *buf
);
6953 /* Return a pointer to an xmalloc'ed string representing an escaped
6954 version of BUF, of len N. E.g. \n is converted to \\n, \t to \\t,
6955 etc. The caller is responsible for releasing the returned
6959 escape_buffer (const char *buf
, int n
)
6961 struct cleanup
*old_chain
;
6962 struct ui_file
*stb
;
6965 stb
= mem_fileopen ();
6966 old_chain
= make_cleanup_ui_file_delete (stb
);
6968 fputstrn_unfiltered (buf
, n
, 0, stb
);
6969 str
= ui_file_xstrdup (stb
, NULL
);
6970 do_cleanups (old_chain
);
6974 /* Display a null-terminated packet on stdout, for debugging, using C
6978 print_packet (char *buf
)
6980 puts_filtered ("\"");
6981 fputstr_filtered (buf
, '"', gdb_stdout
);
6982 puts_filtered ("\"");
6988 return putpkt_binary (buf
, strlen (buf
));
6991 /* Send a packet to the remote machine, with error checking. The data
6992 of the packet is in BUF. The string in BUF can be at most
6993 get_remote_packet_size () - 5 to account for the $, # and checksum,
6994 and for a possible /0 if we are debugging (remote_debug) and want
6995 to print the sent packet as a string. */
6998 putpkt_binary (char *buf
, int cnt
)
7000 struct remote_state
*rs
= get_remote_state ();
7002 unsigned char csum
= 0;
7003 char *buf2
= alloca (cnt
+ 6);
7009 /* Catch cases like trying to read memory or listing threads while
7010 we're waiting for a stop reply. The remote server wouldn't be
7011 ready to handle this request, so we'd hang and timeout. We don't
7012 have to worry about this in synchronous mode, because in that
7013 case it's not possible to issue a command while the target is
7014 running. This is not a problem in non-stop mode, because in that
7015 case, the stub is always ready to process serial input. */
7016 if (!non_stop
&& target_can_async_p () && rs
->waiting_for_stop_reply
)
7017 error (_("Cannot execute this command while the target is running."));
7019 /* We're sending out a new packet. Make sure we don't look at a
7020 stale cached response. */
7021 rs
->cached_wait_status
= 0;
7023 /* Copy the packet into buffer BUF2, encapsulating it
7024 and giving it a checksum. */
7029 for (i
= 0; i
< cnt
; i
++)
7035 *p
++ = tohex ((csum
>> 4) & 0xf);
7036 *p
++ = tohex (csum
& 0xf);
7038 /* Send it over and over until we get a positive ack. */
7042 int started_error_output
= 0;
7046 struct cleanup
*old_chain
;
7050 str
= escape_buffer (buf2
, p
- buf2
);
7051 old_chain
= make_cleanup (xfree
, str
);
7052 fprintf_unfiltered (gdb_stdlog
, "Sending packet: %s...", str
);
7053 gdb_flush (gdb_stdlog
);
7054 do_cleanups (old_chain
);
7056 if (serial_write (remote_desc
, buf2
, p
- buf2
))
7057 perror_with_name (_("putpkt: write failed"));
7059 /* If this is a no acks version of the remote protocol, send the
7060 packet and move on. */
7064 /* Read until either a timeout occurs (-2) or '+' is read.
7065 Handle any notification that arrives in the mean time. */
7068 ch
= readchar (remote_timeout
);
7076 case SERIAL_TIMEOUT
:
7079 if (started_error_output
)
7081 putchar_unfiltered ('\n');
7082 started_error_output
= 0;
7091 fprintf_unfiltered (gdb_stdlog
, "Ack\n");
7095 fprintf_unfiltered (gdb_stdlog
, "Nak\n");
7097 case SERIAL_TIMEOUT
:
7101 break; /* Retransmit buffer. */
7105 fprintf_unfiltered (gdb_stdlog
,
7106 "Packet instead of Ack, ignoring it\n");
7107 /* It's probably an old response sent because an ACK
7108 was lost. Gobble up the packet and ack it so it
7109 doesn't get retransmitted when we resend this
7112 serial_write (remote_desc
, "+", 1);
7113 continue; /* Now, go look for +. */
7120 /* If we got a notification, handle it, and go back to looking
7122 /* We've found the start of a notification. Now
7123 collect the data. */
7124 val
= read_frame (&rs
->buf
, &rs
->buf_size
);
7129 struct cleanup
*old_chain
;
7132 str
= escape_buffer (rs
->buf
, val
);
7133 old_chain
= make_cleanup (xfree
, str
);
7134 fprintf_unfiltered (gdb_stdlog
,
7135 " Notification received: %s\n",
7137 do_cleanups (old_chain
);
7139 handle_notification (rs
->buf
, val
);
7140 /* We're in sync now, rewait for the ack. */
7147 if (!started_error_output
)
7149 started_error_output
= 1;
7150 fprintf_unfiltered (gdb_stdlog
, "putpkt: Junk: ");
7152 fputc_unfiltered (ch
& 0177, gdb_stdlog
);
7153 fprintf_unfiltered (gdb_stdlog
, "%s", rs
->buf
);
7162 if (!started_error_output
)
7164 started_error_output
= 1;
7165 fprintf_unfiltered (gdb_stdlog
, "putpkt: Junk: ");
7167 fputc_unfiltered (ch
& 0177, gdb_stdlog
);
7171 break; /* Here to retransmit. */
7175 /* This is wrong. If doing a long backtrace, the user should be
7176 able to get out next time we call QUIT, without anything as
7177 violent as interrupt_query. If we want to provide a way out of
7178 here without getting to the next QUIT, it should be based on
7179 hitting ^C twice as in remote_wait. */
7190 /* Come here after finding the start of a frame when we expected an
7191 ack. Do our best to discard the rest of this packet. */
7200 c
= readchar (remote_timeout
);
7203 case SERIAL_TIMEOUT
:
7204 /* Nothing we can do. */
7207 /* Discard the two bytes of checksum and stop. */
7208 c
= readchar (remote_timeout
);
7210 c
= readchar (remote_timeout
);
7213 case '*': /* Run length encoding. */
7214 /* Discard the repeat count. */
7215 c
= readchar (remote_timeout
);
7220 /* A regular character. */
7226 /* Come here after finding the start of the frame. Collect the rest
7227 into *BUF, verifying the checksum, length, and handling run-length
7228 compression. NUL terminate the buffer. If there is not enough room,
7229 expand *BUF using xrealloc.
7231 Returns -1 on error, number of characters in buffer (ignoring the
7232 trailing NULL) on success. (could be extended to return one of the
7233 SERIAL status indications). */
7236 read_frame (char **buf_p
,
7243 struct remote_state
*rs
= get_remote_state ();
7250 c
= readchar (remote_timeout
);
7253 case SERIAL_TIMEOUT
:
7255 fputs_filtered ("Timeout in mid-packet, retrying\n", gdb_stdlog
);
7259 fputs_filtered ("Saw new packet start in middle of old one\n",
7261 return -1; /* Start a new packet, count retries. */
7264 unsigned char pktcsum
;
7270 check_0
= readchar (remote_timeout
);
7272 check_1
= readchar (remote_timeout
);
7274 if (check_0
== SERIAL_TIMEOUT
|| check_1
== SERIAL_TIMEOUT
)
7277 fputs_filtered ("Timeout in checksum, retrying\n",
7281 else if (check_0
< 0 || check_1
< 0)
7284 fputs_filtered ("Communication error in checksum\n",
7289 /* Don't recompute the checksum; with no ack packets we
7290 don't have any way to indicate a packet retransmission
7295 pktcsum
= (fromhex (check_0
) << 4) | fromhex (check_1
);
7296 if (csum
== pktcsum
)
7301 struct cleanup
*old_chain
;
7304 str
= escape_buffer (buf
, bc
);
7305 old_chain
= make_cleanup (xfree
, str
);
7306 fprintf_unfiltered (gdb_stdlog
,
7307 "Bad checksum, sentsum=0x%x, "
7308 "csum=0x%x, buf=%s\n",
7309 pktcsum
, csum
, str
);
7310 do_cleanups (old_chain
);
7312 /* Number of characters in buffer ignoring trailing
7316 case '*': /* Run length encoding. */
7321 c
= readchar (remote_timeout
);
7323 repeat
= c
- ' ' + 3; /* Compute repeat count. */
7325 /* The character before ``*'' is repeated. */
7327 if (repeat
> 0 && repeat
<= 255 && bc
> 0)
7329 if (bc
+ repeat
- 1 >= *sizeof_buf
- 1)
7331 /* Make some more room in the buffer. */
7332 *sizeof_buf
+= repeat
;
7333 *buf_p
= xrealloc (*buf_p
, *sizeof_buf
);
7337 memset (&buf
[bc
], buf
[bc
- 1], repeat
);
7343 printf_filtered (_("Invalid run length encoding: %s\n"), buf
);
7347 if (bc
>= *sizeof_buf
- 1)
7349 /* Make some more room in the buffer. */
7351 *buf_p
= xrealloc (*buf_p
, *sizeof_buf
);
7362 /* Read a packet from the remote machine, with error checking, and
7363 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
7364 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
7365 rather than timing out; this is used (in synchronous mode) to wait
7366 for a target that is is executing user code to stop. */
7367 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
7368 don't have to change all the calls to getpkt to deal with the
7369 return value, because at the moment I don't know what the right
7370 thing to do it for those. */
7378 timed_out
= getpkt_sane (buf
, sizeof_buf
, forever
);
7382 /* Read a packet from the remote machine, with error checking, and
7383 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
7384 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
7385 rather than timing out; this is used (in synchronous mode) to wait
7386 for a target that is is executing user code to stop. If FOREVER ==
7387 0, this function is allowed to time out gracefully and return an
7388 indication of this to the caller. Otherwise return the number of
7389 bytes read. If EXPECTING_NOTIF, consider receiving a notification
7390 enough reason to return to the caller. */
7393 getpkt_or_notif_sane_1 (char **buf
, long *sizeof_buf
, int forever
,
7394 int expecting_notif
)
7396 struct remote_state
*rs
= get_remote_state ();
7402 /* We're reading a new response. Make sure we don't look at a
7403 previously cached response. */
7404 rs
->cached_wait_status
= 0;
7406 strcpy (*buf
, "timeout");
7409 timeout
= watchdog
> 0 ? watchdog
: -1;
7410 else if (expecting_notif
)
7411 timeout
= 0; /* There should already be a char in the buffer. If
7414 timeout
= remote_timeout
;
7418 /* Process any number of notifications, and then return when
7422 /* If we get a timeout or bad checksm, retry up to MAX_TRIES
7424 for (tries
= 1; tries
<= MAX_TRIES
; tries
++)
7426 /* This can loop forever if the remote side sends us
7427 characters continuously, but if it pauses, we'll get
7428 SERIAL_TIMEOUT from readchar because of timeout. Then
7429 we'll count that as a retry.
7431 Note that even when forever is set, we will only wait
7432 forever prior to the start of a packet. After that, we
7433 expect characters to arrive at a brisk pace. They should
7434 show up within remote_timeout intervals. */
7436 c
= readchar (timeout
);
7437 while (c
!= SERIAL_TIMEOUT
&& c
!= '$' && c
!= '%');
7439 if (c
== SERIAL_TIMEOUT
)
7441 if (expecting_notif
)
7442 return -1; /* Don't complain, it's normal to not get
7443 anything in this case. */
7445 if (forever
) /* Watchdog went off? Kill the target. */
7449 error (_("Watchdog timeout has expired. Target detached."));
7452 fputs_filtered ("Timed out.\n", gdb_stdlog
);
7456 /* We've found the start of a packet or notification.
7457 Now collect the data. */
7458 val
= read_frame (buf
, sizeof_buf
);
7463 serial_write (remote_desc
, "-", 1);
7466 if (tries
> MAX_TRIES
)
7468 /* We have tried hard enough, and just can't receive the
7469 packet/notification. Give up. */
7470 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
7472 /* Skip the ack char if we're in no-ack mode. */
7473 if (!rs
->noack_mode
)
7474 serial_write (remote_desc
, "+", 1);
7478 /* If we got an ordinary packet, return that to our caller. */
7483 struct cleanup
*old_chain
;
7486 str
= escape_buffer (*buf
, val
);
7487 old_chain
= make_cleanup (xfree
, str
);
7488 fprintf_unfiltered (gdb_stdlog
, "Packet received: %s\n", str
);
7489 do_cleanups (old_chain
);
7492 /* Skip the ack char if we're in no-ack mode. */
7493 if (!rs
->noack_mode
)
7494 serial_write (remote_desc
, "+", 1);
7498 /* If we got a notification, handle it, and go back to looking
7502 gdb_assert (c
== '%');
7506 struct cleanup
*old_chain
;
7509 str
= escape_buffer (*buf
, val
);
7510 old_chain
= make_cleanup (xfree
, str
);
7511 fprintf_unfiltered (gdb_stdlog
,
7512 " Notification received: %s\n",
7514 do_cleanups (old_chain
);
7517 handle_notification (*buf
, val
);
7519 /* Notifications require no acknowledgement. */
7521 if (expecting_notif
)
7528 getpkt_sane (char **buf
, long *sizeof_buf
, int forever
)
7530 return getpkt_or_notif_sane_1 (buf
, sizeof_buf
, forever
, 0);
7534 getpkt_or_notif_sane (char **buf
, long *sizeof_buf
, int forever
)
7536 return getpkt_or_notif_sane_1 (buf
, sizeof_buf
, forever
, 1);
7540 /* A helper function that just calls putpkt; for type correctness. */
7543 putpkt_for_catch_errors (void *arg
)
7545 return putpkt (arg
);
7549 remote_kill (struct target_ops
*ops
)
7551 /* Use catch_errors so the user can quit from gdb even when we
7552 aren't on speaking terms with the remote system. */
7553 catch_errors (putpkt_for_catch_errors
, "k", "", RETURN_MASK_ERROR
);
7555 /* Don't wait for it to die. I'm not really sure it matters whether
7556 we do or not. For the existing stubs, kill is a noop. */
7557 target_mourn_inferior ();
7561 remote_vkill (int pid
, struct remote_state
*rs
)
7563 if (remote_protocol_packets
[PACKET_vKill
].support
== PACKET_DISABLE
)
7566 /* Tell the remote target to detach. */
7567 xsnprintf (rs
->buf
, get_remote_packet_size (), "vKill;%x", pid
);
7569 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7571 if (packet_ok (rs
->buf
,
7572 &remote_protocol_packets
[PACKET_vKill
]) == PACKET_OK
)
7574 else if (remote_protocol_packets
[PACKET_vKill
].support
== PACKET_DISABLE
)
7581 extended_remote_kill (struct target_ops
*ops
)
7584 int pid
= ptid_get_pid (inferior_ptid
);
7585 struct remote_state
*rs
= get_remote_state ();
7587 res
= remote_vkill (pid
, rs
);
7588 if (res
== -1 && !(rs
->extended
&& remote_multi_process_p (rs
)))
7590 /* Don't try 'k' on a multi-process aware stub -- it has no way
7591 to specify the pid. */
7595 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7596 if (rs
->buf
[0] != 'O' || rs
->buf
[0] != 'K')
7599 /* Don't wait for it to die. I'm not really sure it matters whether
7600 we do or not. For the existing stubs, kill is a noop. */
7606 error (_("Can't kill process"));
7608 target_mourn_inferior ();
7612 remote_mourn (struct target_ops
*ops
)
7614 remote_mourn_1 (ops
);
7617 /* Worker function for remote_mourn. */
7619 remote_mourn_1 (struct target_ops
*target
)
7621 unpush_target (target
);
7623 /* remote_close takes care of doing most of the clean up. */
7624 generic_mourn_inferior ();
7628 extended_remote_mourn_1 (struct target_ops
*target
)
7630 struct remote_state
*rs
= get_remote_state ();
7632 /* In case we got here due to an error, but we're going to stay
7634 rs
->waiting_for_stop_reply
= 0;
7636 /* We're no longer interested in these events. */
7637 discard_pending_stop_replies (ptid_get_pid (inferior_ptid
));
7639 /* If the current general thread belonged to the process we just
7640 detached from or has exited, the remote side current general
7641 thread becomes undefined. Considering a case like this:
7643 - We just got here due to a detach.
7644 - The process that we're detaching from happens to immediately
7645 report a global breakpoint being hit in non-stop mode, in the
7646 same thread we had selected before.
7647 - GDB attaches to this process again.
7648 - This event happens to be the next event we handle.
7650 GDB would consider that the current general thread didn't need to
7651 be set on the stub side (with Hg), since for all it knew,
7652 GENERAL_THREAD hadn't changed.
7654 Notice that although in all-stop mode, the remote server always
7655 sets the current thread to the thread reporting the stop event,
7656 that doesn't happen in non-stop mode; in non-stop, the stub *must
7657 not* change the current thread when reporting a breakpoint hit,
7658 due to the decoupling of event reporting and event handling.
7660 To keep things simple, we always invalidate our notion of the
7662 record_currthread (minus_one_ptid
);
7664 /* Unlike "target remote", we do not want to unpush the target; then
7665 the next time the user says "run", we won't be connected. */
7667 /* Call common code to mark the inferior as not running. */
7668 generic_mourn_inferior ();
7670 if (!have_inferiors ())
7672 if (!remote_multi_process_p (rs
))
7674 /* Check whether the target is running now - some remote stubs
7675 automatically restart after kill. */
7677 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7679 if (rs
->buf
[0] == 'S' || rs
->buf
[0] == 'T')
7681 /* Assume that the target has been restarted. Set
7682 inferior_ptid so that bits of core GDB realizes
7683 there's something here, e.g., so that the user can
7684 say "kill" again. */
7685 inferior_ptid
= magic_null_ptid
;
7692 extended_remote_mourn (struct target_ops
*ops
)
7694 extended_remote_mourn_1 (ops
);
7698 extended_remote_supports_disable_randomization (void)
7700 return (remote_protocol_packets
[PACKET_QDisableRandomization
].support
7705 extended_remote_disable_randomization (int val
)
7707 struct remote_state
*rs
= get_remote_state ();
7710 xsnprintf (rs
->buf
, get_remote_packet_size (), "QDisableRandomization:%x",
7713 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
7715 error (_("Target does not support QDisableRandomization."));
7716 if (strcmp (reply
, "OK") != 0)
7717 error (_("Bogus QDisableRandomization reply from target: %s"), reply
);
7721 extended_remote_run (char *args
)
7723 struct remote_state
*rs
= get_remote_state ();
7726 /* If the user has disabled vRun support, or we have detected that
7727 support is not available, do not try it. */
7728 if (remote_protocol_packets
[PACKET_vRun
].support
== PACKET_DISABLE
)
7731 strcpy (rs
->buf
, "vRun;");
7732 len
= strlen (rs
->buf
);
7734 if (strlen (remote_exec_file
) * 2 + len
>= get_remote_packet_size ())
7735 error (_("Remote file name too long for run packet"));
7736 len
+= 2 * bin2hex ((gdb_byte
*) remote_exec_file
, rs
->buf
+ len
, 0);
7738 gdb_assert (args
!= NULL
);
7741 struct cleanup
*back_to
;
7745 argv
= gdb_buildargv (args
);
7746 back_to
= make_cleanup ((void (*) (void *)) freeargv
, argv
);
7747 for (i
= 0; argv
[i
] != NULL
; i
++)
7749 if (strlen (argv
[i
]) * 2 + 1 + len
>= get_remote_packet_size ())
7750 error (_("Argument list too long for run packet"));
7751 rs
->buf
[len
++] = ';';
7752 len
+= 2 * bin2hex ((gdb_byte
*) argv
[i
], rs
->buf
+ len
, 0);
7754 do_cleanups (back_to
);
7757 rs
->buf
[len
++] = '\0';
7760 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7762 if (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vRun
]) == PACKET_OK
)
7764 /* We have a wait response; we don't need it, though. All is well. */
7767 else if (remote_protocol_packets
[PACKET_vRun
].support
== PACKET_DISABLE
)
7768 /* It wasn't disabled before, but it is now. */
7772 if (remote_exec_file
[0] == '\0')
7773 error (_("Running the default executable on the remote target failed; "
7774 "try \"set remote exec-file\"?"));
7776 error (_("Running \"%s\" on the remote target failed"),
7781 /* In the extended protocol we want to be able to do things like
7782 "run" and have them basically work as expected. So we need
7783 a special create_inferior function. We support changing the
7784 executable file and the command line arguments, but not the
7788 extended_remote_create_inferior_1 (char *exec_file
, char *args
,
7789 char **env
, int from_tty
)
7791 /* If running asynchronously, register the target file descriptor
7792 with the event loop. */
7793 if (target_can_async_p ())
7794 target_async (inferior_event_handler
, 0);
7796 /* Disable address space randomization if requested (and supported). */
7797 if (extended_remote_supports_disable_randomization ())
7798 extended_remote_disable_randomization (disable_randomization
);
7800 /* Now restart the remote server. */
7801 if (extended_remote_run (args
) == -1)
7803 /* vRun was not supported. Fail if we need it to do what the
7805 if (remote_exec_file
[0])
7806 error (_("Remote target does not support \"set remote exec-file\""));
7808 error (_("Remote target does not support \"set args\" or run <ARGS>"));
7810 /* Fall back to "R". */
7811 extended_remote_restart ();
7814 if (!have_inferiors ())
7816 /* Clean up from the last time we ran, before we mark the target
7817 running again. This will mark breakpoints uninserted, and
7818 get_offsets may insert breakpoints. */
7819 init_thread_list ();
7820 init_wait_for_inferior ();
7823 add_current_inferior_and_thread ();
7825 /* Get updated offsets, if the stub uses qOffsets. */
7830 extended_remote_create_inferior (struct target_ops
*ops
,
7831 char *exec_file
, char *args
,
7832 char **env
, int from_tty
)
7834 extended_remote_create_inferior_1 (exec_file
, args
, env
, from_tty
);
7838 /* Given a location's target info BP_TGT and the packet buffer BUF, output
7839 the list of conditions (in agent expression bytecode format), if any, the
7840 target needs to evaluate. The output is placed into the packet buffer
7841 started from BUF and ended at BUF_END. */
7844 remote_add_target_side_condition (struct gdbarch
*gdbarch
,
7845 struct bp_target_info
*bp_tgt
, char *buf
,
7848 struct agent_expr
*aexpr
= NULL
;
7851 char *buf_start
= buf
;
7853 if (VEC_empty (agent_expr_p
, bp_tgt
->conditions
))
7856 buf
+= strlen (buf
);
7857 xsnprintf (buf
, buf_end
- buf
, "%s", ";");
7860 /* Send conditions to the target and free the vector. */
7862 VEC_iterate (agent_expr_p
, bp_tgt
->conditions
, ix
, aexpr
);
7865 xsnprintf (buf
, buf_end
- buf
, "X%x,", aexpr
->len
);
7866 buf
+= strlen (buf
);
7867 for (i
= 0; i
< aexpr
->len
; ++i
)
7868 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
7872 VEC_free (agent_expr_p
, bp_tgt
->conditions
);
7876 /* Insert a breakpoint. On targets that have software breakpoint
7877 support, we ask the remote target to do the work; on targets
7878 which don't, we insert a traditional memory breakpoint. */
7881 remote_insert_breakpoint (struct gdbarch
*gdbarch
,
7882 struct bp_target_info
*bp_tgt
)
7884 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
7885 If it succeeds, then set the support to PACKET_ENABLE. If it
7886 fails, and the user has explicitly requested the Z support then
7887 report an error, otherwise, mark it disabled and go on. */
7889 if (remote_protocol_packets
[PACKET_Z0
].support
!= PACKET_DISABLE
)
7891 CORE_ADDR addr
= bp_tgt
->placed_address
;
7892 struct remote_state
*rs
;
7895 struct condition_list
*cond
= NULL
;
7897 gdbarch_remote_breakpoint_from_pc (gdbarch
, &addr
, &bpsize
);
7899 rs
= get_remote_state ();
7901 endbuf
= rs
->buf
+ get_remote_packet_size ();
7906 addr
= (ULONGEST
) remote_address_masked (addr
);
7907 p
+= hexnumstr (p
, addr
);
7908 xsnprintf (p
, endbuf
- p
, ",%d", bpsize
);
7910 if (remote_supports_cond_breakpoints ())
7911 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
7914 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7916 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
]))
7921 bp_tgt
->placed_address
= addr
;
7922 bp_tgt
->placed_size
= bpsize
;
7924 case PACKET_UNKNOWN
:
7929 return memory_insert_breakpoint (gdbarch
, bp_tgt
);
7933 remote_remove_breakpoint (struct gdbarch
*gdbarch
,
7934 struct bp_target_info
*bp_tgt
)
7936 CORE_ADDR addr
= bp_tgt
->placed_address
;
7937 struct remote_state
*rs
= get_remote_state ();
7939 if (remote_protocol_packets
[PACKET_Z0
].support
!= PACKET_DISABLE
)
7942 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
7948 addr
= (ULONGEST
) remote_address_masked (bp_tgt
->placed_address
);
7949 p
+= hexnumstr (p
, addr
);
7950 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->placed_size
);
7953 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7955 return (rs
->buf
[0] == 'E');
7958 return memory_remove_breakpoint (gdbarch
, bp_tgt
);
7962 watchpoint_to_Z_packet (int type
)
7967 return Z_PACKET_WRITE_WP
;
7970 return Z_PACKET_READ_WP
;
7973 return Z_PACKET_ACCESS_WP
;
7976 internal_error (__FILE__
, __LINE__
,
7977 _("hw_bp_to_z: bad watchpoint type %d"), type
);
7982 remote_insert_watchpoint (CORE_ADDR addr
, int len
, int type
,
7983 struct expression
*cond
)
7985 struct remote_state
*rs
= get_remote_state ();
7986 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
7988 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
7990 if (remote_protocol_packets
[PACKET_Z0
+ packet
].support
== PACKET_DISABLE
)
7993 xsnprintf (rs
->buf
, endbuf
- rs
->buf
, "Z%x,", packet
);
7994 p
= strchr (rs
->buf
, '\0');
7995 addr
= remote_address_masked (addr
);
7996 p
+= hexnumstr (p
, (ULONGEST
) addr
);
7997 xsnprintf (p
, endbuf
- p
, ",%x", len
);
8000 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8002 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
8006 case PACKET_UNKNOWN
:
8011 internal_error (__FILE__
, __LINE__
,
8012 _("remote_insert_watchpoint: reached end of function"));
8016 remote_watchpoint_addr_within_range (struct target_ops
*target
, CORE_ADDR addr
,
8017 CORE_ADDR start
, int length
)
8019 CORE_ADDR diff
= remote_address_masked (addr
- start
);
8021 return diff
< length
;
8026 remote_remove_watchpoint (CORE_ADDR addr
, int len
, int type
,
8027 struct expression
*cond
)
8029 struct remote_state
*rs
= get_remote_state ();
8030 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
8032 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
8034 if (remote_protocol_packets
[PACKET_Z0
+ packet
].support
== PACKET_DISABLE
)
8037 xsnprintf (rs
->buf
, endbuf
- rs
->buf
, "z%x,", packet
);
8038 p
= strchr (rs
->buf
, '\0');
8039 addr
= remote_address_masked (addr
);
8040 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8041 xsnprintf (p
, endbuf
- p
, ",%x", len
);
8043 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8045 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
8048 case PACKET_UNKNOWN
:
8053 internal_error (__FILE__
, __LINE__
,
8054 _("remote_remove_watchpoint: reached end of function"));
8058 int remote_hw_watchpoint_limit
= -1;
8059 int remote_hw_watchpoint_length_limit
= -1;
8060 int remote_hw_breakpoint_limit
= -1;
8063 remote_region_ok_for_hw_watchpoint (CORE_ADDR addr
, int len
)
8065 if (remote_hw_watchpoint_length_limit
== 0)
8067 else if (remote_hw_watchpoint_length_limit
< 0)
8069 else if (len
<= remote_hw_watchpoint_length_limit
)
8076 remote_check_watch_resources (int type
, int cnt
, int ot
)
8078 if (type
== bp_hardware_breakpoint
)
8080 if (remote_hw_breakpoint_limit
== 0)
8082 else if (remote_hw_breakpoint_limit
< 0)
8084 else if (cnt
<= remote_hw_breakpoint_limit
)
8089 if (remote_hw_watchpoint_limit
== 0)
8091 else if (remote_hw_watchpoint_limit
< 0)
8095 else if (cnt
<= remote_hw_watchpoint_limit
)
8102 remote_stopped_by_watchpoint (void)
8104 return remote_stopped_by_watchpoint_p
;
8108 remote_stopped_data_address (struct target_ops
*target
, CORE_ADDR
*addr_p
)
8112 if (remote_stopped_by_watchpoint ())
8114 *addr_p
= remote_watch_data_address
;
8123 remote_insert_hw_breakpoint (struct gdbarch
*gdbarch
,
8124 struct bp_target_info
*bp_tgt
)
8127 struct remote_state
*rs
;
8130 /* The length field should be set to the size of a breakpoint
8131 instruction, even though we aren't inserting one ourselves. */
8133 gdbarch_remote_breakpoint_from_pc
8134 (gdbarch
, &bp_tgt
->placed_address
, &bp_tgt
->placed_size
);
8136 if (remote_protocol_packets
[PACKET_Z1
].support
== PACKET_DISABLE
)
8139 rs
= get_remote_state ();
8141 endbuf
= rs
->buf
+ get_remote_packet_size ();
8147 addr
= remote_address_masked (bp_tgt
->placed_address
);
8148 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8149 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->placed_size
);
8151 if (remote_supports_cond_breakpoints ())
8152 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
8155 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8157 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
8160 case PACKET_UNKNOWN
:
8165 internal_error (__FILE__
, __LINE__
,
8166 _("remote_insert_hw_breakpoint: reached end of function"));
8171 remote_remove_hw_breakpoint (struct gdbarch
*gdbarch
,
8172 struct bp_target_info
*bp_tgt
)
8175 struct remote_state
*rs
= get_remote_state ();
8177 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
8179 if (remote_protocol_packets
[PACKET_Z1
].support
== PACKET_DISABLE
)
8186 addr
= remote_address_masked (bp_tgt
->placed_address
);
8187 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8188 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->placed_size
);
8191 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8193 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
8196 case PACKET_UNKNOWN
:
8201 internal_error (__FILE__
, __LINE__
,
8202 _("remote_remove_hw_breakpoint: reached end of function"));
8205 /* Table used by the crc32 function to calcuate the checksum. */
8207 static unsigned long crc32_table
[256] =
8210 static unsigned long
8211 crc32 (const unsigned char *buf
, int len
, unsigned int crc
)
8213 if (!crc32_table
[1])
8215 /* Initialize the CRC table and the decoding table. */
8219 for (i
= 0; i
< 256; i
++)
8221 for (c
= i
<< 24, j
= 8; j
> 0; --j
)
8222 c
= c
& 0x80000000 ? (c
<< 1) ^ 0x04c11db7 : (c
<< 1);
8229 crc
= (crc
<< 8) ^ crc32_table
[((crc
>> 24) ^ *buf
) & 255];
8235 /* Verify memory using the "qCRC:" request. */
8238 remote_verify_memory (struct target_ops
*ops
,
8239 const gdb_byte
*data
, CORE_ADDR lma
, ULONGEST size
)
8241 struct remote_state
*rs
= get_remote_state ();
8242 unsigned long host_crc
, target_crc
;
8245 /* FIXME: assumes lma can fit into long. */
8246 xsnprintf (rs
->buf
, get_remote_packet_size (), "qCRC:%lx,%lx",
8247 (long) lma
, (long) size
);
8250 /* Be clever; compute the host_crc before waiting for target
8252 host_crc
= crc32 (data
, size
, 0xffffffff);
8254 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8255 if (rs
->buf
[0] == 'E')
8258 if (rs
->buf
[0] != 'C')
8259 error (_("remote target does not support this operation"));
8261 for (target_crc
= 0, tmp
= &rs
->buf
[1]; *tmp
; tmp
++)
8262 target_crc
= target_crc
* 16 + fromhex (*tmp
);
8264 return (host_crc
== target_crc
);
8267 /* compare-sections command
8269 With no arguments, compares each loadable section in the exec bfd
8270 with the same memory range on the target, and reports mismatches.
8271 Useful for verifying the image on the target against the exec file. */
8274 compare_sections_command (char *args
, int from_tty
)
8277 struct cleanup
*old_chain
;
8279 const char *sectname
;
8287 error (_("command cannot be used without an exec file"));
8289 for (s
= exec_bfd
->sections
; s
; s
= s
->next
)
8291 if (!(s
->flags
& SEC_LOAD
))
8292 continue; /* Skip non-loadable section. */
8294 size
= bfd_get_section_size (s
);
8296 continue; /* Skip zero-length section. */
8298 sectname
= bfd_get_section_name (exec_bfd
, s
);
8299 if (args
&& strcmp (args
, sectname
) != 0)
8300 continue; /* Not the section selected by user. */
8302 matched
= 1; /* Do this section. */
8305 sectdata
= xmalloc (size
);
8306 old_chain
= make_cleanup (xfree
, sectdata
);
8307 bfd_get_section_contents (exec_bfd
, s
, sectdata
, 0, size
);
8309 res
= target_verify_memory (sectdata
, lma
, size
);
8312 error (_("target memory fault, section %s, range %s -- %s"), sectname
,
8313 paddress (target_gdbarch
, lma
),
8314 paddress (target_gdbarch
, lma
+ size
));
8316 printf_filtered ("Section %s, range %s -- %s: ", sectname
,
8317 paddress (target_gdbarch
, lma
),
8318 paddress (target_gdbarch
, lma
+ size
));
8320 printf_filtered ("matched.\n");
8323 printf_filtered ("MIS-MATCHED!\n");
8327 do_cleanups (old_chain
);
8330 warning (_("One or more sections of the remote executable does not match\n\
8331 the loaded file\n"));
8332 if (args
&& !matched
)
8333 printf_filtered (_("No loaded section named '%s'.\n"), args
);
8336 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
8337 into remote target. The number of bytes written to the remote
8338 target is returned, or -1 for error. */
8341 remote_write_qxfer (struct target_ops
*ops
, const char *object_name
,
8342 const char *annex
, const gdb_byte
*writebuf
,
8343 ULONGEST offset
, LONGEST len
,
8344 struct packet_config
*packet
)
8348 struct remote_state
*rs
= get_remote_state ();
8349 int max_size
= get_memory_write_packet_size ();
8351 if (packet
->support
== PACKET_DISABLE
)
8354 /* Insert header. */
8355 i
= snprintf (rs
->buf
, max_size
,
8356 "qXfer:%s:write:%s:%s:",
8357 object_name
, annex
? annex
: "",
8358 phex_nz (offset
, sizeof offset
));
8359 max_size
-= (i
+ 1);
8361 /* Escape as much data as fits into rs->buf. */
8362 buf_len
= remote_escape_output
8363 (writebuf
, len
, (rs
->buf
+ i
), &max_size
, max_size
);
8365 if (putpkt_binary (rs
->buf
, i
+ buf_len
) < 0
8366 || getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0) < 0
8367 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
8370 unpack_varlen_hex (rs
->buf
, &n
);
8374 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
8375 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
8376 number of bytes read is returned, or 0 for EOF, or -1 for error.
8377 The number of bytes read may be less than LEN without indicating an
8378 EOF. PACKET is checked and updated to indicate whether the remote
8379 target supports this object. */
8382 remote_read_qxfer (struct target_ops
*ops
, const char *object_name
,
8384 gdb_byte
*readbuf
, ULONGEST offset
, LONGEST len
,
8385 struct packet_config
*packet
)
8387 static char *finished_object
;
8388 static char *finished_annex
;
8389 static ULONGEST finished_offset
;
8391 struct remote_state
*rs
= get_remote_state ();
8392 LONGEST i
, n
, packet_len
;
8394 if (packet
->support
== PACKET_DISABLE
)
8397 /* Check whether we've cached an end-of-object packet that matches
8399 if (finished_object
)
8401 if (strcmp (object_name
, finished_object
) == 0
8402 && strcmp (annex
? annex
: "", finished_annex
) == 0
8403 && offset
== finished_offset
)
8406 /* Otherwise, we're now reading something different. Discard
8408 xfree (finished_object
);
8409 xfree (finished_annex
);
8410 finished_object
= NULL
;
8411 finished_annex
= NULL
;
8414 /* Request only enough to fit in a single packet. The actual data
8415 may not, since we don't know how much of it will need to be escaped;
8416 the target is free to respond with slightly less data. We subtract
8417 five to account for the response type and the protocol frame. */
8418 n
= min (get_remote_packet_size () - 5, len
);
8419 snprintf (rs
->buf
, get_remote_packet_size () - 4, "qXfer:%s:read:%s:%s,%s",
8420 object_name
, annex
? annex
: "",
8421 phex_nz (offset
, sizeof offset
),
8422 phex_nz (n
, sizeof n
));
8423 i
= putpkt (rs
->buf
);
8428 packet_len
= getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0);
8429 if (packet_len
< 0 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
8432 if (rs
->buf
[0] != 'l' && rs
->buf
[0] != 'm')
8433 error (_("Unknown remote qXfer reply: %s"), rs
->buf
);
8435 /* 'm' means there is (or at least might be) more data after this
8436 batch. That does not make sense unless there's at least one byte
8437 of data in this reply. */
8438 if (rs
->buf
[0] == 'm' && packet_len
== 1)
8439 error (_("Remote qXfer reply contained no data."));
8441 /* Got some data. */
8442 i
= remote_unescape_input (rs
->buf
+ 1, packet_len
- 1, readbuf
, n
);
8444 /* 'l' is an EOF marker, possibly including a final block of data,
8445 or possibly empty. If we have the final block of a non-empty
8446 object, record this fact to bypass a subsequent partial read. */
8447 if (rs
->buf
[0] == 'l' && offset
+ i
> 0)
8449 finished_object
= xstrdup (object_name
);
8450 finished_annex
= xstrdup (annex
? annex
: "");
8451 finished_offset
= offset
+ i
;
8458 remote_xfer_partial (struct target_ops
*ops
, enum target_object object
,
8459 const char *annex
, gdb_byte
*readbuf
,
8460 const gdb_byte
*writebuf
, ULONGEST offset
, LONGEST len
)
8462 struct remote_state
*rs
;
8467 set_remote_traceframe ();
8468 set_general_thread (inferior_ptid
);
8470 rs
= get_remote_state ();
8472 /* Handle memory using the standard memory routines. */
8473 if (object
== TARGET_OBJECT_MEMORY
)
8479 /* If the remote target is connected but not running, we should
8480 pass this request down to a lower stratum (e.g. the executable
8482 if (!target_has_execution
)
8485 if (writebuf
!= NULL
)
8486 xfered
= remote_write_bytes (offset
, writebuf
, len
);
8488 xfered
= remote_read_bytes (offset
, readbuf
, len
);
8492 else if (xfered
== 0 && errno
== 0)
8498 /* Handle SPU memory using qxfer packets. */
8499 if (object
== TARGET_OBJECT_SPU
)
8502 return remote_read_qxfer (ops
, "spu", annex
, readbuf
, offset
, len
,
8503 &remote_protocol_packets
8504 [PACKET_qXfer_spu_read
]);
8506 return remote_write_qxfer (ops
, "spu", annex
, writebuf
, offset
, len
,
8507 &remote_protocol_packets
8508 [PACKET_qXfer_spu_write
]);
8511 /* Handle extra signal info using qxfer packets. */
8512 if (object
== TARGET_OBJECT_SIGNAL_INFO
)
8515 return remote_read_qxfer (ops
, "siginfo", annex
, readbuf
, offset
, len
,
8516 &remote_protocol_packets
8517 [PACKET_qXfer_siginfo_read
]);
8519 return remote_write_qxfer (ops
, "siginfo", annex
,
8520 writebuf
, offset
, len
,
8521 &remote_protocol_packets
8522 [PACKET_qXfer_siginfo_write
]);
8525 if (object
== TARGET_OBJECT_STATIC_TRACE_DATA
)
8528 return remote_read_qxfer (ops
, "statictrace", annex
,
8529 readbuf
, offset
, len
,
8530 &remote_protocol_packets
8531 [PACKET_qXfer_statictrace_read
]);
8536 /* Only handle flash writes. */
8537 if (writebuf
!= NULL
)
8543 case TARGET_OBJECT_FLASH
:
8544 xfered
= remote_flash_write (ops
, offset
, len
, writebuf
);
8548 else if (xfered
== 0 && errno
== 0)
8558 /* Map pre-existing objects onto letters. DO NOT do this for new
8559 objects!!! Instead specify new query packets. */
8562 case TARGET_OBJECT_AVR
:
8566 case TARGET_OBJECT_AUXV
:
8567 gdb_assert (annex
== NULL
);
8568 return remote_read_qxfer (ops
, "auxv", annex
, readbuf
, offset
, len
,
8569 &remote_protocol_packets
[PACKET_qXfer_auxv
]);
8571 case TARGET_OBJECT_AVAILABLE_FEATURES
:
8572 return remote_read_qxfer
8573 (ops
, "features", annex
, readbuf
, offset
, len
,
8574 &remote_protocol_packets
[PACKET_qXfer_features
]);
8576 case TARGET_OBJECT_LIBRARIES
:
8577 return remote_read_qxfer
8578 (ops
, "libraries", annex
, readbuf
, offset
, len
,
8579 &remote_protocol_packets
[PACKET_qXfer_libraries
]);
8581 case TARGET_OBJECT_LIBRARIES_SVR4
:
8582 return remote_read_qxfer
8583 (ops
, "libraries-svr4", annex
, readbuf
, offset
, len
,
8584 &remote_protocol_packets
[PACKET_qXfer_libraries_svr4
]);
8586 case TARGET_OBJECT_MEMORY_MAP
:
8587 gdb_assert (annex
== NULL
);
8588 return remote_read_qxfer (ops
, "memory-map", annex
, readbuf
, offset
, len
,
8589 &remote_protocol_packets
[PACKET_qXfer_memory_map
]);
8591 case TARGET_OBJECT_OSDATA
:
8592 /* Should only get here if we're connected. */
8593 gdb_assert (remote_desc
);
8594 return remote_read_qxfer
8595 (ops
, "osdata", annex
, readbuf
, offset
, len
,
8596 &remote_protocol_packets
[PACKET_qXfer_osdata
]);
8598 case TARGET_OBJECT_THREADS
:
8599 gdb_assert (annex
== NULL
);
8600 return remote_read_qxfer (ops
, "threads", annex
, readbuf
, offset
, len
,
8601 &remote_protocol_packets
[PACKET_qXfer_threads
]);
8603 case TARGET_OBJECT_TRACEFRAME_INFO
:
8604 gdb_assert (annex
== NULL
);
8605 return remote_read_qxfer
8606 (ops
, "traceframe-info", annex
, readbuf
, offset
, len
,
8607 &remote_protocol_packets
[PACKET_qXfer_traceframe_info
]);
8609 case TARGET_OBJECT_FDPIC
:
8610 return remote_read_qxfer (ops
, "fdpic", annex
, readbuf
, offset
, len
,
8611 &remote_protocol_packets
[PACKET_qXfer_fdpic
]);
8613 case TARGET_OBJECT_OPENVMS_UIB
:
8614 return remote_read_qxfer (ops
, "uib", annex
, readbuf
, offset
, len
,
8615 &remote_protocol_packets
[PACKET_qXfer_uib
]);
8621 /* Note: a zero OFFSET and LEN can be used to query the minimum
8623 if (offset
== 0 && len
== 0)
8624 return (get_remote_packet_size ());
8625 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
8626 large enough let the caller deal with it. */
8627 if (len
< get_remote_packet_size ())
8629 len
= get_remote_packet_size ();
8631 /* Except for querying the minimum buffer size, target must be open. */
8633 error (_("remote query is only available after target open"));
8635 gdb_assert (annex
!= NULL
);
8636 gdb_assert (readbuf
!= NULL
);
8642 /* We used one buffer char for the remote protocol q command and
8643 another for the query type. As the remote protocol encapsulation
8644 uses 4 chars plus one extra in case we are debugging
8645 (remote_debug), we have PBUFZIZ - 7 left to pack the query
8648 while (annex
[i
] && (i
< (get_remote_packet_size () - 8)))
8650 /* Bad caller may have sent forbidden characters. */
8651 gdb_assert (isprint (annex
[i
]) && annex
[i
] != '$' && annex
[i
] != '#');
8656 gdb_assert (annex
[i
] == '\0');
8658 i
= putpkt (rs
->buf
);
8662 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8663 strcpy ((char *) readbuf
, rs
->buf
);
8665 return strlen ((char *) readbuf
);
8669 remote_search_memory (struct target_ops
* ops
,
8670 CORE_ADDR start_addr
, ULONGEST search_space_len
,
8671 const gdb_byte
*pattern
, ULONGEST pattern_len
,
8672 CORE_ADDR
*found_addrp
)
8674 int addr_size
= gdbarch_addr_bit (target_gdbarch
) / 8;
8675 struct remote_state
*rs
= get_remote_state ();
8676 int max_size
= get_memory_write_packet_size ();
8677 struct packet_config
*packet
=
8678 &remote_protocol_packets
[PACKET_qSearch_memory
];
8679 /* Number of packet bytes used to encode the pattern;
8680 this could be more than PATTERN_LEN due to escape characters. */
8681 int escaped_pattern_len
;
8682 /* Amount of pattern that was encodable in the packet. */
8683 int used_pattern_len
;
8686 ULONGEST found_addr
;
8688 /* Don't go to the target if we don't have to.
8689 This is done before checking packet->support to avoid the possibility that
8690 a success for this edge case means the facility works in general. */
8691 if (pattern_len
> search_space_len
)
8693 if (pattern_len
== 0)
8695 *found_addrp
= start_addr
;
8699 /* If we already know the packet isn't supported, fall back to the simple
8700 way of searching memory. */
8702 if (packet
->support
== PACKET_DISABLE
)
8704 /* Target doesn't provided special support, fall back and use the
8705 standard support (copy memory and do the search here). */
8706 return simple_search_memory (ops
, start_addr
, search_space_len
,
8707 pattern
, pattern_len
, found_addrp
);
8710 /* Insert header. */
8711 i
= snprintf (rs
->buf
, max_size
,
8712 "qSearch:memory:%s;%s;",
8713 phex_nz (start_addr
, addr_size
),
8714 phex_nz (search_space_len
, sizeof (search_space_len
)));
8715 max_size
-= (i
+ 1);
8717 /* Escape as much data as fits into rs->buf. */
8718 escaped_pattern_len
=
8719 remote_escape_output (pattern
, pattern_len
, (rs
->buf
+ i
),
8720 &used_pattern_len
, max_size
);
8722 /* Bail if the pattern is too large. */
8723 if (used_pattern_len
!= pattern_len
)
8724 error (_("Pattern is too large to transmit to remote target."));
8726 if (putpkt_binary (rs
->buf
, i
+ escaped_pattern_len
) < 0
8727 || getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0) < 0
8728 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
8730 /* The request may not have worked because the command is not
8731 supported. If so, fall back to the simple way. */
8732 if (packet
->support
== PACKET_DISABLE
)
8734 return simple_search_memory (ops
, start_addr
, search_space_len
,
8735 pattern
, pattern_len
, found_addrp
);
8740 if (rs
->buf
[0] == '0')
8742 else if (rs
->buf
[0] == '1')
8745 if (rs
->buf
[1] != ',')
8746 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
);
8747 unpack_varlen_hex (rs
->buf
+ 2, &found_addr
);
8748 *found_addrp
= found_addr
;
8751 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
);
8757 remote_rcmd (char *command
,
8758 struct ui_file
*outbuf
)
8760 struct remote_state
*rs
= get_remote_state ();
8764 error (_("remote rcmd is only available after target open"));
8766 /* Send a NULL command across as an empty command. */
8767 if (command
== NULL
)
8770 /* The query prefix. */
8771 strcpy (rs
->buf
, "qRcmd,");
8772 p
= strchr (rs
->buf
, '\0');
8774 if ((strlen (rs
->buf
) + strlen (command
) * 2 + 8/*misc*/)
8775 > get_remote_packet_size ())
8776 error (_("\"monitor\" command ``%s'' is too long."), command
);
8778 /* Encode the actual command. */
8779 bin2hex ((gdb_byte
*) command
, p
, 0);
8781 if (putpkt (rs
->buf
) < 0)
8782 error (_("Communication problem with target."));
8784 /* get/display the response */
8789 /* XXX - see also remote_get_noisy_reply(). */
8790 QUIT
; /* Allow user to bail out with ^C. */
8792 if (getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0) == -1)
8794 /* Timeout. Continue to (try to) read responses.
8795 This is better than stopping with an error, assuming the stub
8796 is still executing the (long) monitor command.
8797 If needed, the user can interrupt gdb using C-c, obtaining
8798 an effect similar to stop on timeout. */
8803 error (_("Target does not support this command."));
8804 if (buf
[0] == 'O' && buf
[1] != 'K')
8806 remote_console_output (buf
+ 1); /* 'O' message from stub. */
8809 if (strcmp (buf
, "OK") == 0)
8811 if (strlen (buf
) == 3 && buf
[0] == 'E'
8812 && isdigit (buf
[1]) && isdigit (buf
[2]))
8814 error (_("Protocol error with Rcmd"));
8816 for (p
= buf
; p
[0] != '\0' && p
[1] != '\0'; p
+= 2)
8818 char c
= (fromhex (p
[0]) << 4) + fromhex (p
[1]);
8820 fputc_unfiltered (c
, outbuf
);
8826 static VEC(mem_region_s
) *
8827 remote_memory_map (struct target_ops
*ops
)
8829 VEC(mem_region_s
) *result
= NULL
;
8830 char *text
= target_read_stralloc (¤t_target
,
8831 TARGET_OBJECT_MEMORY_MAP
, NULL
);
8835 struct cleanup
*back_to
= make_cleanup (xfree
, text
);
8837 result
= parse_memory_map (text
);
8838 do_cleanups (back_to
);
8845 packet_command (char *args
, int from_tty
)
8847 struct remote_state
*rs
= get_remote_state ();
8850 error (_("command can only be used with remote target"));
8853 error (_("remote-packet command requires packet text as argument"));
8855 puts_filtered ("sending: ");
8856 print_packet (args
);
8857 puts_filtered ("\n");
8860 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8861 puts_filtered ("received: ");
8862 print_packet (rs
->buf
);
8863 puts_filtered ("\n");
8867 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
8869 static void display_thread_info (struct gdb_ext_thread_info
*info
);
8871 static void threadset_test_cmd (char *cmd
, int tty
);
8873 static void threadalive_test (char *cmd
, int tty
);
8875 static void threadlist_test_cmd (char *cmd
, int tty
);
8877 int get_and_display_threadinfo (threadref
*ref
);
8879 static void threadinfo_test_cmd (char *cmd
, int tty
);
8881 static int thread_display_step (threadref
*ref
, void *context
);
8883 static void threadlist_update_test_cmd (char *cmd
, int tty
);
8885 static void init_remote_threadtests (void);
8887 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
8890 threadset_test_cmd (char *cmd
, int tty
)
8892 int sample_thread
= SAMPLE_THREAD
;
8894 printf_filtered (_("Remote threadset test\n"));
8895 set_general_thread (sample_thread
);
8900 threadalive_test (char *cmd
, int tty
)
8902 int sample_thread
= SAMPLE_THREAD
;
8903 int pid
= ptid_get_pid (inferior_ptid
);
8904 ptid_t ptid
= ptid_build (pid
, 0, sample_thread
);
8906 if (remote_thread_alive (ptid
))
8907 printf_filtered ("PASS: Thread alive test\n");
8909 printf_filtered ("FAIL: Thread alive test\n");
8912 void output_threadid (char *title
, threadref
*ref
);
8915 output_threadid (char *title
, threadref
*ref
)
8919 pack_threadid (&hexid
[0], ref
); /* Convert threead id into hex. */
8921 printf_filtered ("%s %s\n", title
, (&hexid
[0]));
8925 threadlist_test_cmd (char *cmd
, int tty
)
8928 threadref nextthread
;
8929 int done
, result_count
;
8930 threadref threadlist
[3];
8932 printf_filtered ("Remote Threadlist test\n");
8933 if (!remote_get_threadlist (startflag
, &nextthread
, 3, &done
,
8934 &result_count
, &threadlist
[0]))
8935 printf_filtered ("FAIL: threadlist test\n");
8938 threadref
*scan
= threadlist
;
8939 threadref
*limit
= scan
+ result_count
;
8941 while (scan
< limit
)
8942 output_threadid (" thread ", scan
++);
8947 display_thread_info (struct gdb_ext_thread_info
*info
)
8949 output_threadid ("Threadid: ", &info
->threadid
);
8950 printf_filtered ("Name: %s\n ", info
->shortname
);
8951 printf_filtered ("State: %s\n", info
->display
);
8952 printf_filtered ("other: %s\n\n", info
->more_display
);
8956 get_and_display_threadinfo (threadref
*ref
)
8960 struct gdb_ext_thread_info threadinfo
;
8962 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
8963 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
8964 if (0 != (result
= remote_get_threadinfo (ref
, set
, &threadinfo
)))
8965 display_thread_info (&threadinfo
);
8970 threadinfo_test_cmd (char *cmd
, int tty
)
8972 int athread
= SAMPLE_THREAD
;
8976 int_to_threadref (&thread
, athread
);
8977 printf_filtered ("Remote Threadinfo test\n");
8978 if (!get_and_display_threadinfo (&thread
))
8979 printf_filtered ("FAIL cannot get thread info\n");
8983 thread_display_step (threadref
*ref
, void *context
)
8985 /* output_threadid(" threadstep ",ref); *//* simple test */
8986 return get_and_display_threadinfo (ref
);
8990 threadlist_update_test_cmd (char *cmd
, int tty
)
8992 printf_filtered ("Remote Threadlist update test\n");
8993 remote_threadlist_iterator (thread_display_step
, 0, CRAZY_MAX_THREADS
);
8997 init_remote_threadtests (void)
8999 add_com ("tlist", class_obscure
, threadlist_test_cmd
,
9000 _("Fetch and print the remote list of "
9001 "thread identifiers, one pkt only"));
9002 add_com ("tinfo", class_obscure
, threadinfo_test_cmd
,
9003 _("Fetch and display info about one thread"));
9004 add_com ("tset", class_obscure
, threadset_test_cmd
,
9005 _("Test setting to a different thread"));
9006 add_com ("tupd", class_obscure
, threadlist_update_test_cmd
,
9007 _("Iterate through updating all remote thread info"));
9008 add_com ("talive", class_obscure
, threadalive_test
,
9009 _(" Remote thread alive test "));
9014 /* Convert a thread ID to a string. Returns the string in a static
9018 remote_pid_to_str (struct target_ops
*ops
, ptid_t ptid
)
9020 static char buf
[64];
9021 struct remote_state
*rs
= get_remote_state ();
9023 if (ptid_equal (ptid
, null_ptid
))
9024 return normal_pid_to_str (ptid
);
9025 else if (ptid_is_pid (ptid
))
9027 /* Printing an inferior target id. */
9029 /* When multi-process extensions are off, there's no way in the
9030 remote protocol to know the remote process id, if there's any
9031 at all. There's one exception --- when we're connected with
9032 target extended-remote, and we manually attached to a process
9033 with "attach PID". We don't record anywhere a flag that
9034 allows us to distinguish that case from the case of
9035 connecting with extended-remote and the stub already being
9036 attached to a process, and reporting yes to qAttached, hence
9037 no smart special casing here. */
9038 if (!remote_multi_process_p (rs
))
9040 xsnprintf (buf
, sizeof buf
, "Remote target");
9044 return normal_pid_to_str (ptid
);
9048 if (ptid_equal (magic_null_ptid
, ptid
))
9049 xsnprintf (buf
, sizeof buf
, "Thread <main>");
9050 else if (rs
->extended
&& remote_multi_process_p (rs
))
9051 xsnprintf (buf
, sizeof buf
, "Thread %d.%ld",
9052 ptid_get_pid (ptid
), ptid_get_tid (ptid
));
9054 xsnprintf (buf
, sizeof buf
, "Thread %ld",
9055 ptid_get_tid (ptid
));
9060 /* Get the address of the thread local variable in OBJFILE which is
9061 stored at OFFSET within the thread local storage for thread PTID. */
9064 remote_get_thread_local_address (struct target_ops
*ops
,
9065 ptid_t ptid
, CORE_ADDR lm
, CORE_ADDR offset
)
9067 if (remote_protocol_packets
[PACKET_qGetTLSAddr
].support
!= PACKET_DISABLE
)
9069 struct remote_state
*rs
= get_remote_state ();
9071 char *endp
= rs
->buf
+ get_remote_packet_size ();
9072 enum packet_result result
;
9074 strcpy (p
, "qGetTLSAddr:");
9076 p
= write_ptid (p
, endp
, ptid
);
9078 p
+= hexnumstr (p
, offset
);
9080 p
+= hexnumstr (p
, lm
);
9084 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
9085 result
= packet_ok (rs
->buf
,
9086 &remote_protocol_packets
[PACKET_qGetTLSAddr
]);
9087 if (result
== PACKET_OK
)
9091 unpack_varlen_hex (rs
->buf
, &result
);
9094 else if (result
== PACKET_UNKNOWN
)
9095 throw_error (TLS_GENERIC_ERROR
,
9096 _("Remote target doesn't support qGetTLSAddr packet"));
9098 throw_error (TLS_GENERIC_ERROR
,
9099 _("Remote target failed to process qGetTLSAddr request"));
9102 throw_error (TLS_GENERIC_ERROR
,
9103 _("TLS not supported or disabled on this target"));
9108 /* Provide thread local base, i.e. Thread Information Block address.
9109 Returns 1 if ptid is found and thread_local_base is non zero. */
9112 remote_get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
)
9114 if (remote_protocol_packets
[PACKET_qGetTIBAddr
].support
!= PACKET_DISABLE
)
9116 struct remote_state
*rs
= get_remote_state ();
9118 char *endp
= rs
->buf
+ get_remote_packet_size ();
9119 enum packet_result result
;
9121 strcpy (p
, "qGetTIBAddr:");
9123 p
= write_ptid (p
, endp
, ptid
);
9127 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
9128 result
= packet_ok (rs
->buf
,
9129 &remote_protocol_packets
[PACKET_qGetTIBAddr
]);
9130 if (result
== PACKET_OK
)
9134 unpack_varlen_hex (rs
->buf
, &result
);
9136 *addr
= (CORE_ADDR
) result
;
9139 else if (result
== PACKET_UNKNOWN
)
9140 error (_("Remote target doesn't support qGetTIBAddr packet"));
9142 error (_("Remote target failed to process qGetTIBAddr request"));
9145 error (_("qGetTIBAddr not supported or disabled on this target"));
9150 /* Support for inferring a target description based on the current
9151 architecture and the size of a 'g' packet. While the 'g' packet
9152 can have any size (since optional registers can be left off the
9153 end), some sizes are easily recognizable given knowledge of the
9154 approximate architecture. */
9156 struct remote_g_packet_guess
9159 const struct target_desc
*tdesc
;
9161 typedef struct remote_g_packet_guess remote_g_packet_guess_s
;
9162 DEF_VEC_O(remote_g_packet_guess_s
);
9164 struct remote_g_packet_data
9166 VEC(remote_g_packet_guess_s
) *guesses
;
9169 static struct gdbarch_data
*remote_g_packet_data_handle
;
9172 remote_g_packet_data_init (struct obstack
*obstack
)
9174 return OBSTACK_ZALLOC (obstack
, struct remote_g_packet_data
);
9178 register_remote_g_packet_guess (struct gdbarch
*gdbarch
, int bytes
,
9179 const struct target_desc
*tdesc
)
9181 struct remote_g_packet_data
*data
9182 = gdbarch_data (gdbarch
, remote_g_packet_data_handle
);
9183 struct remote_g_packet_guess new_guess
, *guess
;
9186 gdb_assert (tdesc
!= NULL
);
9189 VEC_iterate (remote_g_packet_guess_s
, data
->guesses
, ix
, guess
);
9191 if (guess
->bytes
== bytes
)
9192 internal_error (__FILE__
, __LINE__
,
9193 _("Duplicate g packet description added for size %d"),
9196 new_guess
.bytes
= bytes
;
9197 new_guess
.tdesc
= tdesc
;
9198 VEC_safe_push (remote_g_packet_guess_s
, data
->guesses
, &new_guess
);
9201 /* Return 1 if remote_read_description would do anything on this target
9202 and architecture, 0 otherwise. */
9205 remote_read_description_p (struct target_ops
*target
)
9207 struct remote_g_packet_data
*data
9208 = gdbarch_data (target_gdbarch
, remote_g_packet_data_handle
);
9210 if (!VEC_empty (remote_g_packet_guess_s
, data
->guesses
))
9216 static const struct target_desc
*
9217 remote_read_description (struct target_ops
*target
)
9219 struct remote_g_packet_data
*data
9220 = gdbarch_data (target_gdbarch
, remote_g_packet_data_handle
);
9222 /* Do not try this during initial connection, when we do not know
9223 whether there is a running but stopped thread. */
9224 if (!target_has_execution
|| ptid_equal (inferior_ptid
, null_ptid
))
9227 if (!VEC_empty (remote_g_packet_guess_s
, data
->guesses
))
9229 struct remote_g_packet_guess
*guess
;
9231 int bytes
= send_g_packet ();
9234 VEC_iterate (remote_g_packet_guess_s
, data
->guesses
, ix
, guess
);
9236 if (guess
->bytes
== bytes
)
9237 return guess
->tdesc
;
9239 /* We discard the g packet. A minor optimization would be to
9240 hold on to it, and fill the register cache once we have selected
9241 an architecture, but it's too tricky to do safely. */
9247 /* Remote file transfer support. This is host-initiated I/O, not
9248 target-initiated; for target-initiated, see remote-fileio.c. */
9250 /* If *LEFT is at least the length of STRING, copy STRING to
9251 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9252 decrease *LEFT. Otherwise raise an error. */
9255 remote_buffer_add_string (char **buffer
, int *left
, char *string
)
9257 int len
= strlen (string
);
9260 error (_("Packet too long for target."));
9262 memcpy (*buffer
, string
, len
);
9266 /* NUL-terminate the buffer as a convenience, if there is
9272 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
9273 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9274 decrease *LEFT. Otherwise raise an error. */
9277 remote_buffer_add_bytes (char **buffer
, int *left
, const gdb_byte
*bytes
,
9280 if (2 * len
> *left
)
9281 error (_("Packet too long for target."));
9283 bin2hex (bytes
, *buffer
, len
);
9287 /* NUL-terminate the buffer as a convenience, if there is
9293 /* If *LEFT is large enough, convert VALUE to hex and add it to
9294 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9295 decrease *LEFT. Otherwise raise an error. */
9298 remote_buffer_add_int (char **buffer
, int *left
, ULONGEST value
)
9300 int len
= hexnumlen (value
);
9303 error (_("Packet too long for target."));
9305 hexnumstr (*buffer
, value
);
9309 /* NUL-terminate the buffer as a convenience, if there is
9315 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
9316 value, *REMOTE_ERRNO to the remote error number or zero if none
9317 was included, and *ATTACHMENT to point to the start of the annex
9318 if any. The length of the packet isn't needed here; there may
9319 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
9321 Return 0 if the packet could be parsed, -1 if it could not. If
9322 -1 is returned, the other variables may not be initialized. */
9325 remote_hostio_parse_result (char *buffer
, int *retcode
,
9326 int *remote_errno
, char **attachment
)
9333 if (buffer
[0] != 'F')
9337 *retcode
= strtol (&buffer
[1], &p
, 16);
9338 if (errno
!= 0 || p
== &buffer
[1])
9341 /* Check for ",errno". */
9345 *remote_errno
= strtol (p
+ 1, &p2
, 16);
9346 if (errno
!= 0 || p
+ 1 == p2
)
9351 /* Check for ";attachment". If there is no attachment, the
9352 packet should end here. */
9355 *attachment
= p
+ 1;
9358 else if (*p
== '\0')
9364 /* Send a prepared I/O packet to the target and read its response.
9365 The prepared packet is in the global RS->BUF before this function
9366 is called, and the answer is there when we return.
9368 COMMAND_BYTES is the length of the request to send, which may include
9369 binary data. WHICH_PACKET is the packet configuration to check
9370 before attempting a packet. If an error occurs, *REMOTE_ERRNO
9371 is set to the error number and -1 is returned. Otherwise the value
9372 returned by the function is returned.
9374 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
9375 attachment is expected; an error will be reported if there's a
9376 mismatch. If one is found, *ATTACHMENT will be set to point into
9377 the packet buffer and *ATTACHMENT_LEN will be set to the
9378 attachment's length. */
9381 remote_hostio_send_command (int command_bytes
, int which_packet
,
9382 int *remote_errno
, char **attachment
,
9383 int *attachment_len
)
9385 struct remote_state
*rs
= get_remote_state ();
9386 int ret
, bytes_read
;
9387 char *attachment_tmp
;
9390 || remote_protocol_packets
[which_packet
].support
== PACKET_DISABLE
)
9392 *remote_errno
= FILEIO_ENOSYS
;
9396 putpkt_binary (rs
->buf
, command_bytes
);
9397 bytes_read
= getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0);
9399 /* If it timed out, something is wrong. Don't try to parse the
9403 *remote_errno
= FILEIO_EINVAL
;
9407 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[which_packet
]))
9410 *remote_errno
= FILEIO_EINVAL
;
9412 case PACKET_UNKNOWN
:
9413 *remote_errno
= FILEIO_ENOSYS
;
9419 if (remote_hostio_parse_result (rs
->buf
, &ret
, remote_errno
,
9422 *remote_errno
= FILEIO_EINVAL
;
9426 /* Make sure we saw an attachment if and only if we expected one. */
9427 if ((attachment_tmp
== NULL
&& attachment
!= NULL
)
9428 || (attachment_tmp
!= NULL
&& attachment
== NULL
))
9430 *remote_errno
= FILEIO_EINVAL
;
9434 /* If an attachment was found, it must point into the packet buffer;
9435 work out how many bytes there were. */
9436 if (attachment_tmp
!= NULL
)
9438 *attachment
= attachment_tmp
;
9439 *attachment_len
= bytes_read
- (*attachment
- rs
->buf
);
9445 /* Open FILENAME on the remote target, using FLAGS and MODE. Return a
9446 remote file descriptor, or -1 if an error occurs (and set
9450 remote_hostio_open (const char *filename
, int flags
, int mode
,
9453 struct remote_state
*rs
= get_remote_state ();
9455 int left
= get_remote_packet_size () - 1;
9457 remote_buffer_add_string (&p
, &left
, "vFile:open:");
9459 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
9461 remote_buffer_add_string (&p
, &left
, ",");
9463 remote_buffer_add_int (&p
, &left
, flags
);
9464 remote_buffer_add_string (&p
, &left
, ",");
9466 remote_buffer_add_int (&p
, &left
, mode
);
9468 return remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_open
,
9469 remote_errno
, NULL
, NULL
);
9472 /* Write up to LEN bytes from WRITE_BUF to FD on the remote target.
9473 Return the number of bytes written, or -1 if an error occurs (and
9474 set *REMOTE_ERRNO). */
9477 remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
9478 ULONGEST offset
, int *remote_errno
)
9480 struct remote_state
*rs
= get_remote_state ();
9482 int left
= get_remote_packet_size ();
9485 remote_buffer_add_string (&p
, &left
, "vFile:pwrite:");
9487 remote_buffer_add_int (&p
, &left
, fd
);
9488 remote_buffer_add_string (&p
, &left
, ",");
9490 remote_buffer_add_int (&p
, &left
, offset
);
9491 remote_buffer_add_string (&p
, &left
, ",");
9493 p
+= remote_escape_output (write_buf
, len
, p
, &out_len
,
9494 get_remote_packet_size () - (p
- rs
->buf
));
9496 return remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_pwrite
,
9497 remote_errno
, NULL
, NULL
);
9500 /* Read up to LEN bytes FD on the remote target into READ_BUF
9501 Return the number of bytes read, or -1 if an error occurs (and
9502 set *REMOTE_ERRNO). */
9505 remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
9506 ULONGEST offset
, int *remote_errno
)
9508 struct remote_state
*rs
= get_remote_state ();
9511 int left
= get_remote_packet_size ();
9512 int ret
, attachment_len
;
9515 remote_buffer_add_string (&p
, &left
, "vFile:pread:");
9517 remote_buffer_add_int (&p
, &left
, fd
);
9518 remote_buffer_add_string (&p
, &left
, ",");
9520 remote_buffer_add_int (&p
, &left
, len
);
9521 remote_buffer_add_string (&p
, &left
, ",");
9523 remote_buffer_add_int (&p
, &left
, offset
);
9525 ret
= remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_pread
,
9526 remote_errno
, &attachment
,
9532 read_len
= remote_unescape_input (attachment
, attachment_len
,
9534 if (read_len
!= ret
)
9535 error (_("Read returned %d, but %d bytes."), ret
, (int) read_len
);
9540 /* Close FD on the remote target. Return 0, or -1 if an error occurs
9541 (and set *REMOTE_ERRNO). */
9544 remote_hostio_close (int fd
, int *remote_errno
)
9546 struct remote_state
*rs
= get_remote_state ();
9548 int left
= get_remote_packet_size () - 1;
9550 remote_buffer_add_string (&p
, &left
, "vFile:close:");
9552 remote_buffer_add_int (&p
, &left
, fd
);
9554 return remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_close
,
9555 remote_errno
, NULL
, NULL
);
9558 /* Unlink FILENAME on the remote target. Return 0, or -1 if an error
9559 occurs (and set *REMOTE_ERRNO). */
9562 remote_hostio_unlink (const char *filename
, int *remote_errno
)
9564 struct remote_state
*rs
= get_remote_state ();
9566 int left
= get_remote_packet_size () - 1;
9568 remote_buffer_add_string (&p
, &left
, "vFile:unlink:");
9570 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
9573 return remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_unlink
,
9574 remote_errno
, NULL
, NULL
);
9577 /* Read value of symbolic link FILENAME on the remote target. Return
9578 a null-terminated string allocated via xmalloc, or NULL if an error
9579 occurs (and set *REMOTE_ERRNO). */
9582 remote_hostio_readlink (const char *filename
, int *remote_errno
)
9584 struct remote_state
*rs
= get_remote_state ();
9587 int left
= get_remote_packet_size ();
9588 int len
, attachment_len
;
9592 remote_buffer_add_string (&p
, &left
, "vFile:readlink:");
9594 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
9597 len
= remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_readlink
,
9598 remote_errno
, &attachment
,
9604 ret
= xmalloc (len
+ 1);
9606 read_len
= remote_unescape_input (attachment
, attachment_len
,
9608 if (read_len
!= len
)
9609 error (_("Readlink returned %d, but %d bytes."), len
, read_len
);
9616 remote_fileio_errno_to_host (int errnum
)
9640 case FILEIO_ENOTDIR
:
9660 case FILEIO_ENAMETOOLONG
:
9661 return ENAMETOOLONG
;
9667 remote_hostio_error (int errnum
)
9669 int host_error
= remote_fileio_errno_to_host (errnum
);
9671 if (host_error
== -1)
9672 error (_("Unknown remote I/O error %d"), errnum
);
9674 error (_("Remote I/O error: %s"), safe_strerror (host_error
));
9678 remote_hostio_close_cleanup (void *opaque
)
9680 int fd
= *(int *) opaque
;
9683 remote_hostio_close (fd
, &remote_errno
);
9688 remote_bfd_iovec_open (struct bfd
*abfd
, void *open_closure
)
9690 const char *filename
= bfd_get_filename (abfd
);
9691 int fd
, remote_errno
;
9694 gdb_assert (remote_filename_p (filename
));
9696 fd
= remote_hostio_open (filename
+ 7, FILEIO_O_RDONLY
, 0, &remote_errno
);
9699 errno
= remote_fileio_errno_to_host (remote_errno
);
9700 bfd_set_error (bfd_error_system_call
);
9704 stream
= xmalloc (sizeof (int));
9710 remote_bfd_iovec_close (struct bfd
*abfd
, void *stream
)
9712 int fd
= *(int *)stream
;
9717 /* Ignore errors on close; these may happen if the remote
9718 connection was already torn down. */
9719 remote_hostio_close (fd
, &remote_errno
);
9725 remote_bfd_iovec_pread (struct bfd
*abfd
, void *stream
, void *buf
,
9726 file_ptr nbytes
, file_ptr offset
)
9728 int fd
= *(int *)stream
;
9730 file_ptr pos
, bytes
;
9733 while (nbytes
> pos
)
9735 bytes
= remote_hostio_pread (fd
, (char *)buf
+ pos
, nbytes
- pos
,
9736 offset
+ pos
, &remote_errno
);
9738 /* Success, but no bytes, means end-of-file. */
9742 errno
= remote_fileio_errno_to_host (remote_errno
);
9743 bfd_set_error (bfd_error_system_call
);
9754 remote_bfd_iovec_stat (struct bfd
*abfd
, void *stream
, struct stat
*sb
)
9756 /* FIXME: We should probably implement remote_hostio_stat. */
9757 sb
->st_size
= INT_MAX
;
9762 remote_filename_p (const char *filename
)
9764 return strncmp (filename
, "remote:", 7) == 0;
9768 remote_bfd_open (const char *remote_file
, const char *target
)
9770 return bfd_openr_iovec (remote_file
, target
,
9771 remote_bfd_iovec_open
, NULL
,
9772 remote_bfd_iovec_pread
,
9773 remote_bfd_iovec_close
,
9774 remote_bfd_iovec_stat
);
9778 remote_file_put (const char *local_file
, const char *remote_file
, int from_tty
)
9780 struct cleanup
*back_to
, *close_cleanup
;
9781 int retcode
, fd
, remote_errno
, bytes
, io_size
;
9784 int bytes_in_buffer
;
9789 error (_("command can only be used with remote target"));
9791 file
= fopen (local_file
, "rb");
9793 perror_with_name (local_file
);
9794 back_to
= make_cleanup_fclose (file
);
9796 fd
= remote_hostio_open (remote_file
, (FILEIO_O_WRONLY
| FILEIO_O_CREAT
9798 0700, &remote_errno
);
9800 remote_hostio_error (remote_errno
);
9802 /* Send up to this many bytes at once. They won't all fit in the
9803 remote packet limit, so we'll transfer slightly fewer. */
9804 io_size
= get_remote_packet_size ();
9805 buffer
= xmalloc (io_size
);
9806 make_cleanup (xfree
, buffer
);
9808 close_cleanup
= make_cleanup (remote_hostio_close_cleanup
, &fd
);
9810 bytes_in_buffer
= 0;
9813 while (bytes_in_buffer
|| !saw_eof
)
9817 bytes
= fread (buffer
+ bytes_in_buffer
, 1,
9818 io_size
- bytes_in_buffer
,
9823 error (_("Error reading %s."), local_file
);
9826 /* EOF. Unless there is something still in the
9827 buffer from the last iteration, we are done. */
9829 if (bytes_in_buffer
== 0)
9837 bytes
+= bytes_in_buffer
;
9838 bytes_in_buffer
= 0;
9840 retcode
= remote_hostio_pwrite (fd
, buffer
, bytes
,
9841 offset
, &remote_errno
);
9844 remote_hostio_error (remote_errno
);
9845 else if (retcode
== 0)
9846 error (_("Remote write of %d bytes returned 0!"), bytes
);
9847 else if (retcode
< bytes
)
9849 /* Short write. Save the rest of the read data for the next
9851 bytes_in_buffer
= bytes
- retcode
;
9852 memmove (buffer
, buffer
+ retcode
, bytes_in_buffer
);
9858 discard_cleanups (close_cleanup
);
9859 if (remote_hostio_close (fd
, &remote_errno
))
9860 remote_hostio_error (remote_errno
);
9863 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file
);
9864 do_cleanups (back_to
);
9868 remote_file_get (const char *remote_file
, const char *local_file
, int from_tty
)
9870 struct cleanup
*back_to
, *close_cleanup
;
9871 int fd
, remote_errno
, bytes
, io_size
;
9877 error (_("command can only be used with remote target"));
9879 fd
= remote_hostio_open (remote_file
, FILEIO_O_RDONLY
, 0, &remote_errno
);
9881 remote_hostio_error (remote_errno
);
9883 file
= fopen (local_file
, "wb");
9885 perror_with_name (local_file
);
9886 back_to
= make_cleanup_fclose (file
);
9888 /* Send up to this many bytes at once. They won't all fit in the
9889 remote packet limit, so we'll transfer slightly fewer. */
9890 io_size
= get_remote_packet_size ();
9891 buffer
= xmalloc (io_size
);
9892 make_cleanup (xfree
, buffer
);
9894 close_cleanup
= make_cleanup (remote_hostio_close_cleanup
, &fd
);
9899 bytes
= remote_hostio_pread (fd
, buffer
, io_size
, offset
, &remote_errno
);
9901 /* Success, but no bytes, means end-of-file. */
9904 remote_hostio_error (remote_errno
);
9908 bytes
= fwrite (buffer
, 1, bytes
, file
);
9910 perror_with_name (local_file
);
9913 discard_cleanups (close_cleanup
);
9914 if (remote_hostio_close (fd
, &remote_errno
))
9915 remote_hostio_error (remote_errno
);
9918 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file
);
9919 do_cleanups (back_to
);
9923 remote_file_delete (const char *remote_file
, int from_tty
)
9925 int retcode
, remote_errno
;
9928 error (_("command can only be used with remote target"));
9930 retcode
= remote_hostio_unlink (remote_file
, &remote_errno
);
9932 remote_hostio_error (remote_errno
);
9935 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file
);
9939 remote_put_command (char *args
, int from_tty
)
9941 struct cleanup
*back_to
;
9945 error_no_arg (_("file to put"));
9947 argv
= gdb_buildargv (args
);
9948 back_to
= make_cleanup_freeargv (argv
);
9949 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
9950 error (_("Invalid parameters to remote put"));
9952 remote_file_put (argv
[0], argv
[1], from_tty
);
9954 do_cleanups (back_to
);
9958 remote_get_command (char *args
, int from_tty
)
9960 struct cleanup
*back_to
;
9964 error_no_arg (_("file to get"));
9966 argv
= gdb_buildargv (args
);
9967 back_to
= make_cleanup_freeargv (argv
);
9968 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
9969 error (_("Invalid parameters to remote get"));
9971 remote_file_get (argv
[0], argv
[1], from_tty
);
9973 do_cleanups (back_to
);
9977 remote_delete_command (char *args
, int from_tty
)
9979 struct cleanup
*back_to
;
9983 error_no_arg (_("file to delete"));
9985 argv
= gdb_buildargv (args
);
9986 back_to
= make_cleanup_freeargv (argv
);
9987 if (argv
[0] == NULL
|| argv
[1] != NULL
)
9988 error (_("Invalid parameters to remote delete"));
9990 remote_file_delete (argv
[0], from_tty
);
9992 do_cleanups (back_to
);
9996 remote_command (char *args
, int from_tty
)
9998 help_list (remote_cmdlist
, "remote ", -1, gdb_stdout
);
10002 remote_can_execute_reverse (void)
10004 if (remote_protocol_packets
[PACKET_bs
].support
== PACKET_ENABLE
10005 || remote_protocol_packets
[PACKET_bc
].support
== PACKET_ENABLE
)
10012 remote_supports_non_stop (void)
10018 remote_supports_disable_randomization (void)
10020 /* Only supported in extended mode. */
10025 remote_supports_multi_process (void)
10027 struct remote_state
*rs
= get_remote_state ();
10029 /* Only extended-remote handles being attached to multiple
10030 processes, even though plain remote can use the multi-process
10031 thread id extensions, so that GDB knows the target process's
10033 return rs
->extended
&& remote_multi_process_p (rs
);
10037 remote_supports_cond_tracepoints (void)
10039 struct remote_state
*rs
= get_remote_state ();
10041 return rs
->cond_tracepoints
;
10045 remote_supports_cond_breakpoints (void)
10047 struct remote_state
*rs
= get_remote_state ();
10049 return rs
->cond_breakpoints
;
10053 remote_supports_fast_tracepoints (void)
10055 struct remote_state
*rs
= get_remote_state ();
10057 return rs
->fast_tracepoints
;
10061 remote_supports_static_tracepoints (void)
10063 struct remote_state
*rs
= get_remote_state ();
10065 return rs
->static_tracepoints
;
10069 remote_supports_install_in_trace (void)
10071 struct remote_state
*rs
= get_remote_state ();
10073 return rs
->install_in_trace
;
10077 remote_supports_enable_disable_tracepoint (void)
10079 struct remote_state
*rs
= get_remote_state ();
10081 return rs
->enable_disable_tracepoints
;
10085 remote_supports_string_tracing (void)
10087 struct remote_state
*rs
= get_remote_state ();
10089 return rs
->string_tracing
;
10093 remote_trace_init (void)
10096 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10097 if (strcmp (target_buf
, "OK") != 0)
10098 error (_("Target does not support this command."));
10101 static void free_actions_list (char **actions_list
);
10102 static void free_actions_list_cleanup_wrapper (void *);
10104 free_actions_list_cleanup_wrapper (void *al
)
10106 free_actions_list (al
);
10110 free_actions_list (char **actions_list
)
10114 if (actions_list
== 0)
10117 for (ndx
= 0; actions_list
[ndx
]; ndx
++)
10118 xfree (actions_list
[ndx
]);
10120 xfree (actions_list
);
10123 /* Recursive routine to walk through command list including loops, and
10124 download packets for each command. */
10127 remote_download_command_source (int num
, ULONGEST addr
,
10128 struct command_line
*cmds
)
10130 struct remote_state
*rs
= get_remote_state ();
10131 struct command_line
*cmd
;
10133 for (cmd
= cmds
; cmd
; cmd
= cmd
->next
)
10135 QUIT
; /* Allow user to bail out with ^C. */
10136 strcpy (rs
->buf
, "QTDPsrc:");
10137 encode_source_string (num
, addr
, "cmd", cmd
->line
,
10138 rs
->buf
+ strlen (rs
->buf
),
10139 rs
->buf_size
- strlen (rs
->buf
));
10141 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10142 if (strcmp (target_buf
, "OK"))
10143 warning (_("Target does not support source download."));
10145 if (cmd
->control_type
== while_control
10146 || cmd
->control_type
== while_stepping_control
)
10148 remote_download_command_source (num
, addr
, *cmd
->body_list
);
10150 QUIT
; /* Allow user to bail out with ^C. */
10151 strcpy (rs
->buf
, "QTDPsrc:");
10152 encode_source_string (num
, addr
, "cmd", "end",
10153 rs
->buf
+ strlen (rs
->buf
),
10154 rs
->buf_size
- strlen (rs
->buf
));
10156 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10157 if (strcmp (target_buf
, "OK"))
10158 warning (_("Target does not support source download."));
10164 remote_download_tracepoint (struct bp_location
*loc
)
10166 #define BUF_SIZE 2048
10170 char buf
[BUF_SIZE
];
10171 char **tdp_actions
;
10172 char **stepping_actions
;
10174 struct cleanup
*old_chain
= NULL
;
10175 struct agent_expr
*aexpr
;
10176 struct cleanup
*aexpr_chain
= NULL
;
10178 struct breakpoint
*b
= loc
->owner
;
10179 struct tracepoint
*t
= (struct tracepoint
*) b
;
10181 encode_actions (loc
->owner
, loc
, &tdp_actions
, &stepping_actions
);
10182 old_chain
= make_cleanup (free_actions_list_cleanup_wrapper
,
10184 (void) make_cleanup (free_actions_list_cleanup_wrapper
,
10187 tpaddr
= loc
->address
;
10188 sprintf_vma (addrbuf
, tpaddr
);
10189 xsnprintf (buf
, BUF_SIZE
, "QTDP:%x:%s:%c:%lx:%x", b
->number
,
10190 addrbuf
, /* address */
10191 (b
->enable_state
== bp_enabled
? 'E' : 'D'),
10192 t
->step_count
, t
->pass_count
);
10193 /* Fast tracepoints are mostly handled by the target, but we can
10194 tell the target how big of an instruction block should be moved
10196 if (b
->type
== bp_fast_tracepoint
)
10198 /* Only test for support at download time; we may not know
10199 target capabilities at definition time. */
10200 if (remote_supports_fast_tracepoints ())
10204 if (gdbarch_fast_tracepoint_valid_at (target_gdbarch
,
10205 tpaddr
, &isize
, NULL
))
10206 xsnprintf (buf
+ strlen (buf
), BUF_SIZE
- strlen (buf
), ":F%x",
10209 /* If it passed validation at definition but fails now,
10210 something is very wrong. */
10211 internal_error (__FILE__
, __LINE__
,
10212 _("Fast tracepoint not "
10213 "valid during download"));
10216 /* Fast tracepoints are functionally identical to regular
10217 tracepoints, so don't take lack of support as a reason to
10218 give up on the trace run. */
10219 warning (_("Target does not support fast tracepoints, "
10220 "downloading %d as regular tracepoint"), b
->number
);
10222 else if (b
->type
== bp_static_tracepoint
)
10224 /* Only test for support at download time; we may not know
10225 target capabilities at definition time. */
10226 if (remote_supports_static_tracepoints ())
10228 struct static_tracepoint_marker marker
;
10230 if (target_static_tracepoint_marker_at (tpaddr
, &marker
))
10231 strcat (buf
, ":S");
10233 error (_("Static tracepoint not valid during download"));
10236 /* Fast tracepoints are functionally identical to regular
10237 tracepoints, so don't take lack of support as a reason
10238 to give up on the trace run. */
10239 error (_("Target does not support static tracepoints"));
10241 /* If the tracepoint has a conditional, make it into an agent
10242 expression and append to the definition. */
10245 /* Only test support at download time, we may not know target
10246 capabilities at definition time. */
10247 if (remote_supports_cond_tracepoints ())
10249 aexpr
= gen_eval_for_expr (tpaddr
, loc
->cond
);
10250 aexpr_chain
= make_cleanup_free_agent_expr (aexpr
);
10251 xsnprintf (buf
+ strlen (buf
), BUF_SIZE
- strlen (buf
), ":X%x,",
10253 pkt
= buf
+ strlen (buf
);
10254 for (ndx
= 0; ndx
< aexpr
->len
; ++ndx
)
10255 pkt
= pack_hex_byte (pkt
, aexpr
->buf
[ndx
]);
10257 do_cleanups (aexpr_chain
);
10260 warning (_("Target does not support conditional tracepoints, "
10261 "ignoring tp %d cond"), b
->number
);
10264 if (b
->commands
|| *default_collect
)
10267 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10268 if (strcmp (target_buf
, "OK"))
10269 error (_("Target does not support tracepoints."));
10271 /* do_single_steps (t); */
10274 for (ndx
= 0; tdp_actions
[ndx
]; ndx
++)
10276 QUIT
; /* Allow user to bail out with ^C. */
10277 xsnprintf (buf
, BUF_SIZE
, "QTDP:-%x:%s:%s%c",
10278 b
->number
, addrbuf
, /* address */
10280 ((tdp_actions
[ndx
+ 1] || stepping_actions
)
10283 remote_get_noisy_reply (&target_buf
,
10285 if (strcmp (target_buf
, "OK"))
10286 error (_("Error on target while setting tracepoints."));
10289 if (stepping_actions
)
10291 for (ndx
= 0; stepping_actions
[ndx
]; ndx
++)
10293 QUIT
; /* Allow user to bail out with ^C. */
10294 xsnprintf (buf
, BUF_SIZE
, "QTDP:-%x:%s:%s%s%s",
10295 b
->number
, addrbuf
, /* address */
10296 ((ndx
== 0) ? "S" : ""),
10297 stepping_actions
[ndx
],
10298 (stepping_actions
[ndx
+ 1] ? "-" : ""));
10300 remote_get_noisy_reply (&target_buf
,
10302 if (strcmp (target_buf
, "OK"))
10303 error (_("Error on target while setting tracepoints."));
10307 if (remote_protocol_packets
[PACKET_TracepointSource
].support
10310 if (b
->addr_string
)
10312 strcpy (buf
, "QTDPsrc:");
10313 encode_source_string (b
->number
, loc
->address
,
10314 "at", b
->addr_string
, buf
+ strlen (buf
),
10315 2048 - strlen (buf
));
10318 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10319 if (strcmp (target_buf
, "OK"))
10320 warning (_("Target does not support source download."));
10322 if (b
->cond_string
)
10324 strcpy (buf
, "QTDPsrc:");
10325 encode_source_string (b
->number
, loc
->address
,
10326 "cond", b
->cond_string
, buf
+ strlen (buf
),
10327 2048 - strlen (buf
));
10329 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10330 if (strcmp (target_buf
, "OK"))
10331 warning (_("Target does not support source download."));
10333 remote_download_command_source (b
->number
, loc
->address
,
10334 breakpoint_commands (b
));
10337 do_cleanups (old_chain
);
10341 remote_can_download_tracepoint (void)
10343 struct remote_state
*rs
= get_remote_state ();
10344 struct trace_status
*ts
;
10347 /* Don't try to install tracepoints until we've relocated our
10348 symbols, and fetched and merged the target's tracepoint list with
10350 if (rs
->starting_up
)
10353 ts
= current_trace_status ();
10354 status
= remote_get_trace_status (ts
);
10356 if (status
== -1 || !ts
->running_known
|| !ts
->running
)
10359 /* If we are in a tracing experiment, but remote stub doesn't support
10360 installing tracepoint in trace, we have to return. */
10361 if (!remote_supports_install_in_trace ())
10369 remote_download_trace_state_variable (struct trace_state_variable
*tsv
)
10371 struct remote_state
*rs
= get_remote_state ();
10374 xsnprintf (rs
->buf
, get_remote_packet_size (), "QTDV:%x:%s:%x:",
10375 tsv
->number
, phex ((ULONGEST
) tsv
->initial_value
, 8),
10377 p
= rs
->buf
+ strlen (rs
->buf
);
10378 if ((p
- rs
->buf
) + strlen (tsv
->name
) * 2 >= get_remote_packet_size ())
10379 error (_("Trace state variable name too long for tsv definition packet"));
10380 p
+= 2 * bin2hex ((gdb_byte
*) (tsv
->name
), p
, 0);
10383 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10384 if (*target_buf
== '\0')
10385 error (_("Target does not support this command."));
10386 if (strcmp (target_buf
, "OK") != 0)
10387 error (_("Error on target while downloading trace state variable."));
10391 remote_enable_tracepoint (struct bp_location
*location
)
10393 struct remote_state
*rs
= get_remote_state ();
10396 sprintf_vma (addr_buf
, location
->address
);
10397 xsnprintf (rs
->buf
, get_remote_packet_size (), "QTEnable:%x:%s",
10398 location
->owner
->number
, addr_buf
);
10400 remote_get_noisy_reply (&rs
->buf
, &rs
->buf_size
);
10401 if (*rs
->buf
== '\0')
10402 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
10403 if (strcmp (rs
->buf
, "OK") != 0)
10404 error (_("Error on target while enabling tracepoint."));
10408 remote_disable_tracepoint (struct bp_location
*location
)
10410 struct remote_state
*rs
= get_remote_state ();
10413 sprintf_vma (addr_buf
, location
->address
);
10414 xsnprintf (rs
->buf
, get_remote_packet_size (), "QTDisable:%x:%s",
10415 location
->owner
->number
, addr_buf
);
10417 remote_get_noisy_reply (&rs
->buf
, &rs
->buf_size
);
10418 if (*rs
->buf
== '\0')
10419 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
10420 if (strcmp (rs
->buf
, "OK") != 0)
10421 error (_("Error on target while disabling tracepoint."));
10425 remote_trace_set_readonly_regions (void)
10429 bfd_size_type size
;
10435 return; /* No information to give. */
10437 strcpy (target_buf
, "QTro");
10438 for (s
= exec_bfd
->sections
; s
; s
= s
->next
)
10440 char tmp1
[40], tmp2
[40];
10443 if ((s
->flags
& SEC_LOAD
) == 0 ||
10444 /* (s->flags & SEC_CODE) == 0 || */
10445 (s
->flags
& SEC_READONLY
) == 0)
10449 vma
= bfd_get_section_vma (abfd
, s
);
10450 size
= bfd_get_section_size (s
);
10451 sprintf_vma (tmp1
, vma
);
10452 sprintf_vma (tmp2
, vma
+ size
);
10453 sec_length
= 1 + strlen (tmp1
) + 1 + strlen (tmp2
);
10454 if (offset
+ sec_length
+ 1 > target_buf_size
)
10456 if (remote_protocol_packets
[PACKET_qXfer_traceframe_info
].support
10459 Too many sections for read-only sections definition packet."));
10462 xsnprintf (target_buf
+ offset
, target_buf_size
- offset
, ":%s,%s",
10464 offset
+= sec_length
;
10468 putpkt (target_buf
);
10469 getpkt (&target_buf
, &target_buf_size
, 0);
10474 remote_trace_start (void)
10476 putpkt ("QTStart");
10477 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10478 if (*target_buf
== '\0')
10479 error (_("Target does not support this command."));
10480 if (strcmp (target_buf
, "OK") != 0)
10481 error (_("Bogus reply from target: %s"), target_buf
);
10485 remote_get_trace_status (struct trace_status
*ts
)
10487 /* Initialize it just to avoid a GCC false warning. */
10489 /* FIXME we need to get register block size some other way. */
10490 extern int trace_regblock_size
;
10491 volatile struct gdb_exception ex
;
10493 trace_regblock_size
= get_remote_arch_state ()->sizeof_g_packet
;
10495 putpkt ("qTStatus");
10497 TRY_CATCH (ex
, RETURN_MASK_ERROR
)
10499 p
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10503 exception_fprintf (gdb_stderr
, ex
, "qTStatus: ");
10507 /* If the remote target doesn't do tracing, flag it. */
10511 /* We're working with a live target. */
10514 /* Set some defaults. */
10515 ts
->running_known
= 0;
10516 ts
->stop_reason
= trace_stop_reason_unknown
;
10517 ts
->traceframe_count
= -1;
10518 ts
->buffer_free
= 0;
10521 error (_("Bogus trace status reply from target: %s"), target_buf
);
10523 parse_trace_status (p
, ts
);
10525 return ts
->running
;
10529 remote_get_tracepoint_status (struct breakpoint
*bp
,
10530 struct uploaded_tp
*utp
)
10532 struct remote_state
*rs
= get_remote_state ();
10534 struct bp_location
*loc
;
10535 struct tracepoint
*tp
= (struct tracepoint
*) bp
;
10536 size_t size
= get_remote_packet_size ();
10540 tp
->base
.hit_count
= 0;
10541 tp
->traceframe_usage
= 0;
10542 for (loc
= tp
->base
.loc
; loc
; loc
= loc
->next
)
10544 /* If the tracepoint was never downloaded, don't go asking for
10546 if (tp
->number_on_target
== 0)
10548 xsnprintf (rs
->buf
, size
, "qTP:%x:%s", tp
->number_on_target
,
10549 phex_nz (loc
->address
, 0));
10551 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10552 if (reply
&& *reply
)
10555 parse_tracepoint_status (reply
+ 1, bp
, utp
);
10561 utp
->hit_count
= 0;
10562 utp
->traceframe_usage
= 0;
10563 xsnprintf (rs
->buf
, size
, "qTP:%x:%s", utp
->number
,
10564 phex_nz (utp
->addr
, 0));
10566 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10567 if (reply
&& *reply
)
10570 parse_tracepoint_status (reply
+ 1, bp
, utp
);
10576 remote_trace_stop (void)
10579 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10580 if (*target_buf
== '\0')
10581 error (_("Target does not support this command."));
10582 if (strcmp (target_buf
, "OK") != 0)
10583 error (_("Bogus reply from target: %s"), target_buf
);
10587 remote_trace_find (enum trace_find_type type
, int num
,
10588 ULONGEST addr1
, ULONGEST addr2
,
10591 struct remote_state
*rs
= get_remote_state ();
10592 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
10594 int target_frameno
= -1, target_tracept
= -1;
10596 /* Lookups other than by absolute frame number depend on the current
10597 trace selected, so make sure it is correct on the remote end
10599 if (type
!= tfind_number
)
10600 set_remote_traceframe ();
10603 strcpy (p
, "QTFrame:");
10604 p
= strchr (p
, '\0');
10608 xsnprintf (p
, endbuf
- p
, "%x", num
);
10611 xsnprintf (p
, endbuf
- p
, "pc:%s", phex_nz (addr1
, 0));
10614 xsnprintf (p
, endbuf
- p
, "tdp:%x", num
);
10617 xsnprintf (p
, endbuf
- p
, "range:%s:%s", phex_nz (addr1
, 0),
10618 phex_nz (addr2
, 0));
10620 case tfind_outside
:
10621 xsnprintf (p
, endbuf
- p
, "outside:%s:%s", phex_nz (addr1
, 0),
10622 phex_nz (addr2
, 0));
10625 error (_("Unknown trace find type %d"), type
);
10629 reply
= remote_get_noisy_reply (&(rs
->buf
), &sizeof_pkt
);
10630 if (*reply
== '\0')
10631 error (_("Target does not support this command."));
10633 while (reply
&& *reply
)
10638 target_frameno
= (int) strtol (p
, &reply
, 16);
10640 error (_("Unable to parse trace frame number"));
10641 /* Don't update our remote traceframe number cache on failure
10642 to select a remote traceframe. */
10643 if (target_frameno
== -1)
10648 target_tracept
= (int) strtol (p
, &reply
, 16);
10650 error (_("Unable to parse tracepoint number"));
10652 case 'O': /* "OK"? */
10653 if (reply
[1] == 'K' && reply
[2] == '\0')
10656 error (_("Bogus reply from target: %s"), reply
);
10659 error (_("Bogus reply from target: %s"), reply
);
10662 *tpp
= target_tracept
;
10664 remote_traceframe_number
= target_frameno
;
10665 return target_frameno
;
10669 remote_get_trace_state_variable_value (int tsvnum
, LONGEST
*val
)
10671 struct remote_state
*rs
= get_remote_state ();
10675 set_remote_traceframe ();
10677 xsnprintf (rs
->buf
, get_remote_packet_size (), "qTV:%x", tsvnum
);
10679 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10680 if (reply
&& *reply
)
10684 unpack_varlen_hex (reply
+ 1, &uval
);
10685 *val
= (LONGEST
) uval
;
10693 remote_save_trace_data (const char *filename
)
10695 struct remote_state
*rs
= get_remote_state ();
10699 strcpy (p
, "QTSave:");
10701 if ((p
- rs
->buf
) + strlen (filename
) * 2 >= get_remote_packet_size ())
10702 error (_("Remote file name too long for trace save packet"));
10703 p
+= 2 * bin2hex ((gdb_byte
*) filename
, p
, 0);
10706 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10707 if (*reply
== '\0')
10708 error (_("Target does not support this command."));
10709 if (strcmp (reply
, "OK") != 0)
10710 error (_("Bogus reply from target: %s"), reply
);
10714 /* This is basically a memory transfer, but needs to be its own packet
10715 because we don't know how the target actually organizes its trace
10716 memory, plus we want to be able to ask for as much as possible, but
10717 not be unhappy if we don't get as much as we ask for. */
10720 remote_get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
)
10722 struct remote_state
*rs
= get_remote_state ();
10728 strcpy (p
, "qTBuffer:");
10730 p
+= hexnumstr (p
, offset
);
10732 p
+= hexnumstr (p
, len
);
10736 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10737 if (reply
&& *reply
)
10739 /* 'l' by itself means we're at the end of the buffer and
10740 there is nothing more to get. */
10744 /* Convert the reply into binary. Limit the number of bytes to
10745 convert according to our passed-in buffer size, rather than
10746 what was returned in the packet; if the target is
10747 unexpectedly generous and gives us a bigger reply than we
10748 asked for, we don't want to crash. */
10749 rslt
= hex2bin (target_buf
, buf
, len
);
10753 /* Something went wrong, flag as an error. */
10758 remote_set_disconnected_tracing (int val
)
10760 struct remote_state
*rs
= get_remote_state ();
10762 if (rs
->disconnected_tracing
)
10766 xsnprintf (rs
->buf
, get_remote_packet_size (), "QTDisconnected:%x", val
);
10768 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10769 if (*reply
== '\0')
10770 error (_("Target does not support this command."));
10771 if (strcmp (reply
, "OK") != 0)
10772 error (_("Bogus reply from target: %s"), reply
);
10775 warning (_("Target does not support disconnected tracing."));
10779 remote_core_of_thread (struct target_ops
*ops
, ptid_t ptid
)
10781 struct thread_info
*info
= find_thread_ptid (ptid
);
10783 if (info
&& info
->private)
10784 return info
->private->core
;
10789 remote_set_circular_trace_buffer (int val
)
10791 struct remote_state
*rs
= get_remote_state ();
10794 xsnprintf (rs
->buf
, get_remote_packet_size (), "QTBuffer:circular:%x", val
);
10796 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10797 if (*reply
== '\0')
10798 error (_("Target does not support this command."));
10799 if (strcmp (reply
, "OK") != 0)
10800 error (_("Bogus reply from target: %s"), reply
);
10803 static struct traceframe_info
*
10804 remote_traceframe_info (void)
10808 text
= target_read_stralloc (¤t_target
,
10809 TARGET_OBJECT_TRACEFRAME_INFO
, NULL
);
10812 struct traceframe_info
*info
;
10813 struct cleanup
*back_to
= make_cleanup (xfree
, text
);
10815 info
= parse_traceframe_info (text
);
10816 do_cleanups (back_to
);
10823 /* Handle the qTMinFTPILen packet. Returns the minimum length of
10824 instruction on which a fast tracepoint may be placed. Returns -1
10825 if the packet is not supported, and 0 if the minimum instruction
10826 length is unknown. */
10829 remote_get_min_fast_tracepoint_insn_len (void)
10831 struct remote_state
*rs
= get_remote_state ();
10834 /* If we're not debugging a process yet, the IPA can't be
10836 if (!target_has_execution
)
10839 /* Make sure the remote is pointing at the right process. */
10840 set_general_process ();
10842 xsnprintf (rs
->buf
, get_remote_packet_size (), "qTMinFTPILen");
10844 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10845 if (*reply
== '\0')
10849 ULONGEST min_insn_len
;
10851 unpack_varlen_hex (reply
, &min_insn_len
);
10853 return (int) min_insn_len
;
10858 remote_set_trace_notes (char *user
, char *notes
, char *stop_notes
)
10860 struct remote_state
*rs
= get_remote_state ();
10862 char *buf
= rs
->buf
;
10863 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
10866 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTNotes:");
10869 buf
+= xsnprintf (buf
, endbuf
- buf
, "user:");
10870 nbytes
= bin2hex (user
, buf
, 0);
10876 buf
+= xsnprintf (buf
, endbuf
- buf
, "notes:");
10877 nbytes
= bin2hex (notes
, buf
, 0);
10883 buf
+= xsnprintf (buf
, endbuf
- buf
, "tstop:");
10884 nbytes
= bin2hex (stop_notes
, buf
, 0);
10888 /* Ensure the buffer is terminated. */
10892 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10893 if (*reply
== '\0')
10896 if (strcmp (reply
, "OK") != 0)
10897 error (_("Bogus reply from target: %s"), reply
);
10903 remote_use_agent (int use
)
10905 if (remote_protocol_packets
[PACKET_QAgent
].support
!= PACKET_DISABLE
)
10907 struct remote_state
*rs
= get_remote_state ();
10909 /* If the stub supports QAgent. */
10910 xsnprintf (rs
->buf
, get_remote_packet_size (), "QAgent:%d", use
);
10912 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
10914 if (strcmp (rs
->buf
, "OK") == 0)
10925 remote_can_use_agent (void)
10927 return (remote_protocol_packets
[PACKET_QAgent
].support
!= PACKET_DISABLE
);
10931 init_remote_ops (void)
10933 remote_ops
.to_shortname
= "remote";
10934 remote_ops
.to_longname
= "Remote serial target in gdb-specific protocol";
10935 remote_ops
.to_doc
=
10936 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
10937 Specify the serial device it is connected to\n\
10938 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).";
10939 remote_ops
.to_open
= remote_open
;
10940 remote_ops
.to_close
= remote_close
;
10941 remote_ops
.to_detach
= remote_detach
;
10942 remote_ops
.to_disconnect
= remote_disconnect
;
10943 remote_ops
.to_resume
= remote_resume
;
10944 remote_ops
.to_wait
= remote_wait
;
10945 remote_ops
.to_fetch_registers
= remote_fetch_registers
;
10946 remote_ops
.to_store_registers
= remote_store_registers
;
10947 remote_ops
.to_prepare_to_store
= remote_prepare_to_store
;
10948 remote_ops
.deprecated_xfer_memory
= remote_xfer_memory
;
10949 remote_ops
.to_files_info
= remote_files_info
;
10950 remote_ops
.to_insert_breakpoint
= remote_insert_breakpoint
;
10951 remote_ops
.to_remove_breakpoint
= remote_remove_breakpoint
;
10952 remote_ops
.to_stopped_by_watchpoint
= remote_stopped_by_watchpoint
;
10953 remote_ops
.to_stopped_data_address
= remote_stopped_data_address
;
10954 remote_ops
.to_watchpoint_addr_within_range
=
10955 remote_watchpoint_addr_within_range
;
10956 remote_ops
.to_can_use_hw_breakpoint
= remote_check_watch_resources
;
10957 remote_ops
.to_insert_hw_breakpoint
= remote_insert_hw_breakpoint
;
10958 remote_ops
.to_remove_hw_breakpoint
= remote_remove_hw_breakpoint
;
10959 remote_ops
.to_region_ok_for_hw_watchpoint
10960 = remote_region_ok_for_hw_watchpoint
;
10961 remote_ops
.to_insert_watchpoint
= remote_insert_watchpoint
;
10962 remote_ops
.to_remove_watchpoint
= remote_remove_watchpoint
;
10963 remote_ops
.to_kill
= remote_kill
;
10964 remote_ops
.to_load
= generic_load
;
10965 remote_ops
.to_mourn_inferior
= remote_mourn
;
10966 remote_ops
.to_pass_signals
= remote_pass_signals
;
10967 remote_ops
.to_program_signals
= remote_program_signals
;
10968 remote_ops
.to_thread_alive
= remote_thread_alive
;
10969 remote_ops
.to_find_new_threads
= remote_threads_info
;
10970 remote_ops
.to_pid_to_str
= remote_pid_to_str
;
10971 remote_ops
.to_extra_thread_info
= remote_threads_extra_info
;
10972 remote_ops
.to_get_ada_task_ptid
= remote_get_ada_task_ptid
;
10973 remote_ops
.to_stop
= remote_stop
;
10974 remote_ops
.to_xfer_partial
= remote_xfer_partial
;
10975 remote_ops
.to_rcmd
= remote_rcmd
;
10976 remote_ops
.to_log_command
= serial_log_command
;
10977 remote_ops
.to_get_thread_local_address
= remote_get_thread_local_address
;
10978 remote_ops
.to_stratum
= process_stratum
;
10979 remote_ops
.to_has_all_memory
= default_child_has_all_memory
;
10980 remote_ops
.to_has_memory
= default_child_has_memory
;
10981 remote_ops
.to_has_stack
= default_child_has_stack
;
10982 remote_ops
.to_has_registers
= default_child_has_registers
;
10983 remote_ops
.to_has_execution
= default_child_has_execution
;
10984 remote_ops
.to_has_thread_control
= tc_schedlock
; /* can lock scheduler */
10985 remote_ops
.to_can_execute_reverse
= remote_can_execute_reverse
;
10986 remote_ops
.to_magic
= OPS_MAGIC
;
10987 remote_ops
.to_memory_map
= remote_memory_map
;
10988 remote_ops
.to_flash_erase
= remote_flash_erase
;
10989 remote_ops
.to_flash_done
= remote_flash_done
;
10990 remote_ops
.to_read_description
= remote_read_description
;
10991 remote_ops
.to_search_memory
= remote_search_memory
;
10992 remote_ops
.to_can_async_p
= remote_can_async_p
;
10993 remote_ops
.to_is_async_p
= remote_is_async_p
;
10994 remote_ops
.to_async
= remote_async
;
10995 remote_ops
.to_terminal_inferior
= remote_terminal_inferior
;
10996 remote_ops
.to_terminal_ours
= remote_terminal_ours
;
10997 remote_ops
.to_supports_non_stop
= remote_supports_non_stop
;
10998 remote_ops
.to_supports_multi_process
= remote_supports_multi_process
;
10999 remote_ops
.to_supports_disable_randomization
11000 = remote_supports_disable_randomization
;
11001 remote_ops
.to_fileio_open
= remote_hostio_open
;
11002 remote_ops
.to_fileio_pwrite
= remote_hostio_pwrite
;
11003 remote_ops
.to_fileio_pread
= remote_hostio_pread
;
11004 remote_ops
.to_fileio_close
= remote_hostio_close
;
11005 remote_ops
.to_fileio_unlink
= remote_hostio_unlink
;
11006 remote_ops
.to_fileio_readlink
= remote_hostio_readlink
;
11007 remote_ops
.to_supports_enable_disable_tracepoint
= remote_supports_enable_disable_tracepoint
;
11008 remote_ops
.to_supports_string_tracing
= remote_supports_string_tracing
;
11009 remote_ops
.to_supports_evaluation_of_breakpoint_conditions
= remote_supports_cond_breakpoints
;
11010 remote_ops
.to_trace_init
= remote_trace_init
;
11011 remote_ops
.to_download_tracepoint
= remote_download_tracepoint
;
11012 remote_ops
.to_can_download_tracepoint
= remote_can_download_tracepoint
;
11013 remote_ops
.to_download_trace_state_variable
11014 = remote_download_trace_state_variable
;
11015 remote_ops
.to_enable_tracepoint
= remote_enable_tracepoint
;
11016 remote_ops
.to_disable_tracepoint
= remote_disable_tracepoint
;
11017 remote_ops
.to_trace_set_readonly_regions
= remote_trace_set_readonly_regions
;
11018 remote_ops
.to_trace_start
= remote_trace_start
;
11019 remote_ops
.to_get_trace_status
= remote_get_trace_status
;
11020 remote_ops
.to_get_tracepoint_status
= remote_get_tracepoint_status
;
11021 remote_ops
.to_trace_stop
= remote_trace_stop
;
11022 remote_ops
.to_trace_find
= remote_trace_find
;
11023 remote_ops
.to_get_trace_state_variable_value
11024 = remote_get_trace_state_variable_value
;
11025 remote_ops
.to_save_trace_data
= remote_save_trace_data
;
11026 remote_ops
.to_upload_tracepoints
= remote_upload_tracepoints
;
11027 remote_ops
.to_upload_trace_state_variables
11028 = remote_upload_trace_state_variables
;
11029 remote_ops
.to_get_raw_trace_data
= remote_get_raw_trace_data
;
11030 remote_ops
.to_get_min_fast_tracepoint_insn_len
= remote_get_min_fast_tracepoint_insn_len
;
11031 remote_ops
.to_set_disconnected_tracing
= remote_set_disconnected_tracing
;
11032 remote_ops
.to_set_circular_trace_buffer
= remote_set_circular_trace_buffer
;
11033 remote_ops
.to_set_trace_notes
= remote_set_trace_notes
;
11034 remote_ops
.to_core_of_thread
= remote_core_of_thread
;
11035 remote_ops
.to_verify_memory
= remote_verify_memory
;
11036 remote_ops
.to_get_tib_address
= remote_get_tib_address
;
11037 remote_ops
.to_set_permissions
= remote_set_permissions
;
11038 remote_ops
.to_static_tracepoint_marker_at
11039 = remote_static_tracepoint_marker_at
;
11040 remote_ops
.to_static_tracepoint_markers_by_strid
11041 = remote_static_tracepoint_markers_by_strid
;
11042 remote_ops
.to_traceframe_info
= remote_traceframe_info
;
11043 remote_ops
.to_use_agent
= remote_use_agent
;
11044 remote_ops
.to_can_use_agent
= remote_can_use_agent
;
11047 /* Set up the extended remote vector by making a copy of the standard
11048 remote vector and adding to it. */
11051 init_extended_remote_ops (void)
11053 extended_remote_ops
= remote_ops
;
11055 extended_remote_ops
.to_shortname
= "extended-remote";
11056 extended_remote_ops
.to_longname
=
11057 "Extended remote serial target in gdb-specific protocol";
11058 extended_remote_ops
.to_doc
=
11059 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
11060 Specify the serial device it is connected to (e.g. /dev/ttya).";
11061 extended_remote_ops
.to_open
= extended_remote_open
;
11062 extended_remote_ops
.to_create_inferior
= extended_remote_create_inferior
;
11063 extended_remote_ops
.to_mourn_inferior
= extended_remote_mourn
;
11064 extended_remote_ops
.to_detach
= extended_remote_detach
;
11065 extended_remote_ops
.to_attach
= extended_remote_attach
;
11066 extended_remote_ops
.to_kill
= extended_remote_kill
;
11067 extended_remote_ops
.to_supports_disable_randomization
11068 = extended_remote_supports_disable_randomization
;
11072 remote_can_async_p (void)
11074 if (!target_async_permitted
)
11075 /* We only enable async when the user specifically asks for it. */
11078 /* We're async whenever the serial device is. */
11079 return serial_can_async_p (remote_desc
);
11083 remote_is_async_p (void)
11085 if (!target_async_permitted
)
11086 /* We only enable async when the user specifically asks for it. */
11089 /* We're async whenever the serial device is. */
11090 return serial_is_async_p (remote_desc
);
11093 /* Pass the SERIAL event on and up to the client. One day this code
11094 will be able to delay notifying the client of an event until the
11095 point where an entire packet has been received. */
11097 static void (*async_client_callback
) (enum inferior_event_type event_type
,
11099 static void *async_client_context
;
11100 static serial_event_ftype remote_async_serial_handler
;
11103 remote_async_serial_handler (struct serial
*scb
, void *context
)
11105 /* Don't propogate error information up to the client. Instead let
11106 the client find out about the error by querying the target. */
11107 async_client_callback (INF_REG_EVENT
, async_client_context
);
11111 remote_async_inferior_event_handler (gdb_client_data data
)
11113 inferior_event_handler (INF_REG_EVENT
, NULL
);
11117 remote_async_get_pending_events_handler (gdb_client_data data
)
11119 remote_get_pending_stop_replies ();
11123 remote_async (void (*callback
) (enum inferior_event_type event_type
,
11124 void *context
), void *context
)
11126 if (callback
!= NULL
)
11128 serial_async (remote_desc
, remote_async_serial_handler
, NULL
);
11129 async_client_callback
= callback
;
11130 async_client_context
= context
;
11133 serial_async (remote_desc
, NULL
, NULL
);
11137 set_remote_cmd (char *args
, int from_tty
)
11139 help_list (remote_set_cmdlist
, "set remote ", -1, gdb_stdout
);
11143 show_remote_cmd (char *args
, int from_tty
)
11145 /* We can't just use cmd_show_list here, because we want to skip
11146 the redundant "show remote Z-packet" and the legacy aliases. */
11147 struct cleanup
*showlist_chain
;
11148 struct cmd_list_element
*list
= remote_show_cmdlist
;
11149 struct ui_out
*uiout
= current_uiout
;
11151 showlist_chain
= make_cleanup_ui_out_tuple_begin_end (uiout
, "showlist");
11152 for (; list
!= NULL
; list
= list
->next
)
11153 if (strcmp (list
->name
, "Z-packet") == 0)
11155 else if (list
->type
== not_set_cmd
)
11156 /* Alias commands are exactly like the original, except they
11157 don't have the normal type. */
11161 struct cleanup
*option_chain
11162 = make_cleanup_ui_out_tuple_begin_end (uiout
, "option");
11164 ui_out_field_string (uiout
, "name", list
->name
);
11165 ui_out_text (uiout
, ": ");
11166 if (list
->type
== show_cmd
)
11167 do_setshow_command ((char *) NULL
, from_tty
, list
);
11169 cmd_func (list
, NULL
, from_tty
);
11170 /* Close the tuple. */
11171 do_cleanups (option_chain
);
11174 /* Close the tuple. */
11175 do_cleanups (showlist_chain
);
11179 /* Function to be called whenever a new objfile (shlib) is detected. */
11181 remote_new_objfile (struct objfile
*objfile
)
11183 if (remote_desc
!= 0) /* Have a remote connection. */
11184 remote_check_symbols (objfile
);
11187 /* Pull all the tracepoints defined on the target and create local
11188 data structures representing them. We don't want to create real
11189 tracepoints yet, we don't want to mess up the user's existing
11193 remote_upload_tracepoints (struct uploaded_tp
**utpp
)
11195 struct remote_state
*rs
= get_remote_state ();
11198 /* Ask for a first packet of tracepoint definition. */
11200 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11202 while (*p
&& *p
!= 'l')
11204 parse_tracepoint_definition (p
, utpp
);
11205 /* Ask for another packet of tracepoint definition. */
11207 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11214 remote_upload_trace_state_variables (struct uploaded_tsv
**utsvp
)
11216 struct remote_state
*rs
= get_remote_state ();
11219 /* Ask for a first packet of variable definition. */
11221 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11223 while (*p
&& *p
!= 'l')
11225 parse_tsv_definition (p
, utsvp
);
11226 /* Ask for another packet of variable definition. */
11228 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11235 _initialize_remote (void)
11237 struct remote_state
*rs
;
11238 struct cmd_list_element
*cmd
;
11241 /* architecture specific data */
11242 remote_gdbarch_data_handle
=
11243 gdbarch_data_register_post_init (init_remote_state
);
11244 remote_g_packet_data_handle
=
11245 gdbarch_data_register_pre_init (remote_g_packet_data_init
);
11247 /* Initialize the per-target state. At the moment there is only one
11248 of these, not one per target. Only one target is active at a
11249 time. The default buffer size is unimportant; it will be expanded
11250 whenever a larger buffer is needed. */
11251 rs
= get_remote_state_raw ();
11252 rs
->buf_size
= 400;
11253 rs
->buf
= xmalloc (rs
->buf_size
);
11255 init_remote_ops ();
11256 add_target (&remote_ops
);
11258 init_extended_remote_ops ();
11259 add_target (&extended_remote_ops
);
11261 /* Hook into new objfile notification. */
11262 observer_attach_new_objfile (remote_new_objfile
);
11264 /* Set up signal handlers. */
11265 sigint_remote_token
=
11266 create_async_signal_handler (async_remote_interrupt
, NULL
);
11267 sigint_remote_twice_token
=
11268 create_async_signal_handler (async_remote_interrupt_twice
, NULL
);
11271 init_remote_threadtests ();
11274 /* set/show remote ... */
11276 add_prefix_cmd ("remote", class_maintenance
, set_remote_cmd
, _("\
11277 Remote protocol specific variables\n\
11278 Configure various remote-protocol specific variables such as\n\
11279 the packets being used"),
11280 &remote_set_cmdlist
, "set remote ",
11281 0 /* allow-unknown */, &setlist
);
11282 add_prefix_cmd ("remote", class_maintenance
, show_remote_cmd
, _("\
11283 Remote protocol specific variables\n\
11284 Configure various remote-protocol specific variables such as\n\
11285 the packets being used"),
11286 &remote_show_cmdlist
, "show remote ",
11287 0 /* allow-unknown */, &showlist
);
11289 add_cmd ("compare-sections", class_obscure
, compare_sections_command
, _("\
11290 Compare section data on target to the exec file.\n\
11291 Argument is a single section name (default: all loaded sections)."),
11294 add_cmd ("packet", class_maintenance
, packet_command
, _("\
11295 Send an arbitrary packet to a remote target.\n\
11296 maintenance packet TEXT\n\
11297 If GDB is talking to an inferior via the GDB serial protocol, then\n\
11298 this command sends the string TEXT to the inferior, and displays the\n\
11299 response packet. GDB supplies the initial `$' character, and the\n\
11300 terminating `#' character and checksum."),
11303 add_setshow_boolean_cmd ("remotebreak", no_class
, &remote_break
, _("\
11304 Set whether to send break if interrupted."), _("\
11305 Show whether to send break if interrupted."), _("\
11306 If set, a break, instead of a cntrl-c, is sent to the remote target."),
11307 set_remotebreak
, show_remotebreak
,
11308 &setlist
, &showlist
);
11309 cmd_name
= "remotebreak";
11310 cmd
= lookup_cmd (&cmd_name
, setlist
, "", -1, 1);
11311 deprecate_cmd (cmd
, "set remote interrupt-sequence");
11312 cmd_name
= "remotebreak"; /* needed because lookup_cmd updates the pointer */
11313 cmd
= lookup_cmd (&cmd_name
, showlist
, "", -1, 1);
11314 deprecate_cmd (cmd
, "show remote interrupt-sequence");
11316 add_setshow_enum_cmd ("interrupt-sequence", class_support
,
11317 interrupt_sequence_modes
, &interrupt_sequence_mode
,
11319 Set interrupt sequence to remote target."), _("\
11320 Show interrupt sequence to remote target."), _("\
11321 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
11322 NULL
, show_interrupt_sequence
,
11323 &remote_set_cmdlist
,
11324 &remote_show_cmdlist
);
11326 add_setshow_boolean_cmd ("interrupt-on-connect", class_support
,
11327 &interrupt_on_connect
, _("\
11328 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
11329 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
11330 If set, interrupt sequence is sent to remote target."),
11332 &remote_set_cmdlist
, &remote_show_cmdlist
);
11334 /* Install commands for configuring memory read/write packets. */
11336 add_cmd ("remotewritesize", no_class
, set_memory_write_packet_size
, _("\
11337 Set the maximum number of bytes per memory write packet (deprecated)."),
11339 add_cmd ("remotewritesize", no_class
, show_memory_write_packet_size
, _("\
11340 Show the maximum number of bytes per memory write packet (deprecated)."),
11342 add_cmd ("memory-write-packet-size", no_class
,
11343 set_memory_write_packet_size
, _("\
11344 Set the maximum number of bytes per memory-write packet.\n\
11345 Specify the number of bytes in a packet or 0 (zero) for the\n\
11346 default packet size. The actual limit is further reduced\n\
11347 dependent on the target. Specify ``fixed'' to disable the\n\
11348 further restriction and ``limit'' to enable that restriction."),
11349 &remote_set_cmdlist
);
11350 add_cmd ("memory-read-packet-size", no_class
,
11351 set_memory_read_packet_size
, _("\
11352 Set the maximum number of bytes per memory-read packet.\n\
11353 Specify the number of bytes in a packet or 0 (zero) for the\n\
11354 default packet size. The actual limit is further reduced\n\
11355 dependent on the target. Specify ``fixed'' to disable the\n\
11356 further restriction and ``limit'' to enable that restriction."),
11357 &remote_set_cmdlist
);
11358 add_cmd ("memory-write-packet-size", no_class
,
11359 show_memory_write_packet_size
,
11360 _("Show the maximum number of bytes per memory-write packet."),
11361 &remote_show_cmdlist
);
11362 add_cmd ("memory-read-packet-size", no_class
,
11363 show_memory_read_packet_size
,
11364 _("Show the maximum number of bytes per memory-read packet."),
11365 &remote_show_cmdlist
);
11367 add_setshow_zinteger_cmd ("hardware-watchpoint-limit", no_class
,
11368 &remote_hw_watchpoint_limit
, _("\
11369 Set the maximum number of target hardware watchpoints."), _("\
11370 Show the maximum number of target hardware watchpoints."), _("\
11371 Specify a negative limit for unlimited."),
11372 NULL
, NULL
, /* FIXME: i18n: The maximum
11373 number of target hardware
11374 watchpoints is %s. */
11375 &remote_set_cmdlist
, &remote_show_cmdlist
);
11376 add_setshow_zinteger_cmd ("hardware-watchpoint-length-limit", no_class
,
11377 &remote_hw_watchpoint_length_limit
, _("\
11378 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
11379 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
11380 Specify a negative limit for unlimited."),
11381 NULL
, NULL
, /* FIXME: i18n: The maximum
11382 length (in bytes) of a target
11383 hardware watchpoint is %s. */
11384 &remote_set_cmdlist
, &remote_show_cmdlist
);
11385 add_setshow_zinteger_cmd ("hardware-breakpoint-limit", no_class
,
11386 &remote_hw_breakpoint_limit
, _("\
11387 Set the maximum number of target hardware breakpoints."), _("\
11388 Show the maximum number of target hardware breakpoints."), _("\
11389 Specify a negative limit for unlimited."),
11390 NULL
, NULL
, /* FIXME: i18n: The maximum
11391 number of target hardware
11392 breakpoints is %s. */
11393 &remote_set_cmdlist
, &remote_show_cmdlist
);
11395 add_setshow_integer_cmd ("remoteaddresssize", class_obscure
,
11396 &remote_address_size
, _("\
11397 Set the maximum size of the address (in bits) in a memory packet."), _("\
11398 Show the maximum size of the address (in bits) in a memory packet."), NULL
,
11400 NULL
, /* FIXME: i18n: */
11401 &setlist
, &showlist
);
11403 add_packet_config_cmd (&remote_protocol_packets
[PACKET_X
],
11404 "X", "binary-download", 1);
11406 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCont
],
11407 "vCont", "verbose-resume", 0);
11409 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QPassSignals
],
11410 "QPassSignals", "pass-signals", 0);
11412 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QProgramSignals
],
11413 "QProgramSignals", "program-signals", 0);
11415 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSymbol
],
11416 "qSymbol", "symbol-lookup", 0);
11418 add_packet_config_cmd (&remote_protocol_packets
[PACKET_P
],
11419 "P", "set-register", 1);
11421 add_packet_config_cmd (&remote_protocol_packets
[PACKET_p
],
11422 "p", "fetch-register", 1);
11424 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
],
11425 "Z0", "software-breakpoint", 0);
11427 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z1
],
11428 "Z1", "hardware-breakpoint", 0);
11430 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z2
],
11431 "Z2", "write-watchpoint", 0);
11433 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z3
],
11434 "Z3", "read-watchpoint", 0);
11436 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z4
],
11437 "Z4", "access-watchpoint", 0);
11439 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_auxv
],
11440 "qXfer:auxv:read", "read-aux-vector", 0);
11442 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_features
],
11443 "qXfer:features:read", "target-features", 0);
11445 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries
],
11446 "qXfer:libraries:read", "library-info", 0);
11448 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries_svr4
],
11449 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
11451 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_memory_map
],
11452 "qXfer:memory-map:read", "memory-map", 0);
11454 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_spu_read
],
11455 "qXfer:spu:read", "read-spu-object", 0);
11457 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_spu_write
],
11458 "qXfer:spu:write", "write-spu-object", 0);
11460 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_osdata
],
11461 "qXfer:osdata:read", "osdata", 0);
11463 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_threads
],
11464 "qXfer:threads:read", "threads", 0);
11466 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_read
],
11467 "qXfer:siginfo:read", "read-siginfo-object", 0);
11469 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_write
],
11470 "qXfer:siginfo:write", "write-siginfo-object", 0);
11472 add_packet_config_cmd
11473 (&remote_protocol_packets
[PACKET_qXfer_traceframe_info
],
11474 "qXfer:trace-frame-info:read", "traceframe-info", 0);
11476 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_uib
],
11477 "qXfer:uib:read", "unwind-info-block", 0);
11479 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTLSAddr
],
11480 "qGetTLSAddr", "get-thread-local-storage-address",
11483 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTIBAddr
],
11484 "qGetTIBAddr", "get-thread-information-block-address",
11487 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bc
],
11488 "bc", "reverse-continue", 0);
11490 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bs
],
11491 "bs", "reverse-step", 0);
11493 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSupported
],
11494 "qSupported", "supported-packets", 0);
11496 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSearch_memory
],
11497 "qSearch:memory", "search-memory", 0);
11499 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_open
],
11500 "vFile:open", "hostio-open", 0);
11502 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pread
],
11503 "vFile:pread", "hostio-pread", 0);
11505 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pwrite
],
11506 "vFile:pwrite", "hostio-pwrite", 0);
11508 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_close
],
11509 "vFile:close", "hostio-close", 0);
11511 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_unlink
],
11512 "vFile:unlink", "hostio-unlink", 0);
11514 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_readlink
],
11515 "vFile:readlink", "hostio-readlink", 0);
11517 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vAttach
],
11518 "vAttach", "attach", 0);
11520 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vRun
],
11523 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartNoAckMode
],
11524 "QStartNoAckMode", "noack", 0);
11526 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vKill
],
11527 "vKill", "kill", 0);
11529 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qAttached
],
11530 "qAttached", "query-attached", 0);
11532 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalTracepoints
],
11533 "ConditionalTracepoints",
11534 "conditional-tracepoints", 0);
11536 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalBreakpoints
],
11537 "ConditionalBreakpoints",
11538 "conditional-breakpoints", 0);
11540 add_packet_config_cmd (&remote_protocol_packets
[PACKET_FastTracepoints
],
11541 "FastTracepoints", "fast-tracepoints", 0);
11543 add_packet_config_cmd (&remote_protocol_packets
[PACKET_TracepointSource
],
11544 "TracepointSource", "TracepointSource", 0);
11546 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAllow
],
11547 "QAllow", "allow", 0);
11549 add_packet_config_cmd (&remote_protocol_packets
[PACKET_StaticTracepoints
],
11550 "StaticTracepoints", "static-tracepoints", 0);
11552 add_packet_config_cmd (&remote_protocol_packets
[PACKET_InstallInTrace
],
11553 "InstallInTrace", "install-in-trace", 0);
11555 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_statictrace_read
],
11556 "qXfer:statictrace:read", "read-sdata-object", 0);
11558 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_fdpic
],
11559 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
11561 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QDisableRandomization
],
11562 "QDisableRandomization", "disable-randomization", 0);
11564 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAgent
],
11565 "QAgent", "agent", 0);
11567 /* Keep the old ``set remote Z-packet ...'' working. Each individual
11568 Z sub-packet has its own set and show commands, but users may
11569 have sets to this variable in their .gdbinit files (or in their
11571 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure
,
11572 &remote_Z_packet_detect
, _("\
11573 Set use of remote protocol `Z' packets"), _("\
11574 Show use of remote protocol `Z' packets "), _("\
11575 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
11577 set_remote_protocol_Z_packet_cmd
,
11578 show_remote_protocol_Z_packet_cmd
,
11579 /* FIXME: i18n: Use of remote protocol
11580 `Z' packets is %s. */
11581 &remote_set_cmdlist
, &remote_show_cmdlist
);
11583 add_prefix_cmd ("remote", class_files
, remote_command
, _("\
11584 Manipulate files on the remote system\n\
11585 Transfer files to and from the remote target system."),
11586 &remote_cmdlist
, "remote ",
11587 0 /* allow-unknown */, &cmdlist
);
11589 add_cmd ("put", class_files
, remote_put_command
,
11590 _("Copy a local file to the remote system."),
11593 add_cmd ("get", class_files
, remote_get_command
,
11594 _("Copy a remote file to the local system."),
11597 add_cmd ("delete", class_files
, remote_delete_command
,
11598 _("Delete a remote file."),
11601 remote_exec_file
= xstrdup ("");
11602 add_setshow_string_noescape_cmd ("exec-file", class_files
,
11603 &remote_exec_file
, _("\
11604 Set the remote pathname for \"run\""), _("\
11605 Show the remote pathname for \"run\""), NULL
, NULL
, NULL
,
11606 &remote_set_cmdlist
, &remote_show_cmdlist
);
11608 /* Eventually initialize fileio. See fileio.c */
11609 initialize_remote_fileio (remote_set_cmdlist
, remote_show_cmdlist
);
11611 /* Take advantage of the fact that the LWP field is not used, to tag
11612 special ptids with it set to != 0. */
11613 magic_null_ptid
= ptid_build (42000, 1, -1);
11614 not_sent_ptid
= ptid_build (42000, 1, -2);
11615 any_thread_ptid
= ptid_build (42000, 1, 0);
11617 target_buf_size
= 2048;
11618 target_buf
= xmalloc (target_buf_size
);