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 /* If we negotiated packet size explicitly (and thus can bypass
275 heuristics for the largest packet size that will not overflow
276 a buffer in the stub), this will be set to that packet size.
277 Otherwise zero, meaning to use the guessed size. */
278 long explicit_packet_size
;
280 /* remote_wait is normally called when the target is running and
281 waits for a stop reply packet. But sometimes we need to call it
282 when the target is already stopped. We can send a "?" packet
283 and have remote_wait read the response. Or, if we already have
284 the response, we can stash it in BUF and tell remote_wait to
285 skip calling getpkt. This flag is set when BUF contains a
286 stop reply packet and the target is not waiting. */
287 int cached_wait_status
;
289 /* True, if in no ack mode. That is, neither GDB nor the stub will
290 expect acks from each other. The connection is assumed to be
294 /* True if we're connected in extended remote mode. */
297 /* True if the stub reported support for multi-process
299 int multi_process_aware
;
301 /* True if we resumed the target and we're waiting for the target to
302 stop. In the mean time, we can't start another command/query.
303 The remote server wouldn't be ready to process it, so we'd
304 timeout waiting for a reply that would never come and eventually
305 we'd close the connection. This can happen in asynchronous mode
306 because we allow GDB commands while the target is running. */
307 int waiting_for_stop_reply
;
309 /* True if the stub reports support for non-stop mode. */
312 /* True if the stub reports support for vCont;t. */
315 /* True if the stub reports support for conditional tracepoints. */
316 int cond_tracepoints
;
318 /* True if the stub reports support for target-side breakpoint
320 int cond_breakpoints
;
322 /* True if the stub reports support for fast tracepoints. */
323 int fast_tracepoints
;
325 /* True if the stub reports support for static tracepoints. */
326 int static_tracepoints
;
328 /* True if the stub reports support for installing tracepoint while
330 int install_in_trace
;
332 /* True if the stub can continue running a trace while GDB is
334 int disconnected_tracing
;
336 /* True if the stub reports support for enabling and disabling
337 tracepoints while a trace experiment is running. */
338 int enable_disable_tracepoints
;
340 /* True if the stub can collect strings using tracenz bytecode. */
343 /* Nonzero if the user has pressed Ctrl-C, but the target hasn't
344 responded to that. */
348 /* Private data that we'll store in (struct thread_info)->private. */
349 struct private_thread_info
356 free_private_thread_info (struct private_thread_info
*info
)
362 /* Returns true if the multi-process extensions are in effect. */
364 remote_multi_process_p (struct remote_state
*rs
)
366 return rs
->multi_process_aware
;
369 /* This data could be associated with a target, but we do not always
370 have access to the current target when we need it, so for now it is
371 static. This will be fine for as long as only one target is in use
373 static struct remote_state remote_state
;
375 static struct remote_state
*
376 get_remote_state_raw (void)
378 return &remote_state
;
381 /* Description of the remote protocol for a given architecture. */
385 long offset
; /* Offset into G packet. */
386 long regnum
; /* GDB's internal register number. */
387 LONGEST pnum
; /* Remote protocol register number. */
388 int in_g_packet
; /* Always part of G packet. */
389 /* long size in bytes; == register_size (target_gdbarch, regnum);
391 /* char *name; == gdbarch_register_name (target_gdbarch, regnum);
395 struct remote_arch_state
397 /* Description of the remote protocol registers. */
398 long sizeof_g_packet
;
400 /* Description of the remote protocol registers indexed by REGNUM
401 (making an array gdbarch_num_regs in size). */
402 struct packet_reg
*regs
;
404 /* This is the size (in chars) of the first response to the ``g''
405 packet. It is used as a heuristic when determining the maximum
406 size of memory-read and memory-write packets. A target will
407 typically only reserve a buffer large enough to hold the ``g''
408 packet. The size does not include packet overhead (headers and
410 long actual_register_packet_size
;
412 /* This is the maximum size (in chars) of a non read/write packet.
413 It is also used as a cap on the size of read/write packets. */
414 long remote_packet_size
;
417 long sizeof_pkt
= 2000;
419 /* Utility: generate error from an incoming stub packet. */
421 trace_error (char *buf
)
424 return; /* not an error msg */
427 case '1': /* malformed packet error */
428 if (*++buf
== '0') /* general case: */
429 error (_("remote.c: error in outgoing packet."));
431 error (_("remote.c: error in outgoing packet at field #%ld."),
432 strtol (buf
, NULL
, 16));
434 error (_("trace API error 0x%s."), ++buf
);
436 error (_("Target returns error code '%s'."), buf
);
440 /* Utility: wait for reply from stub, while accepting "O" packets. */
442 remote_get_noisy_reply (char **buf_p
,
445 do /* Loop on reply from remote stub. */
449 QUIT
; /* Allow user to bail out with ^C. */
450 getpkt (buf_p
, sizeof_buf
, 0);
454 else if (strncmp (buf
, "qRelocInsn:", strlen ("qRelocInsn:")) == 0)
457 CORE_ADDR from
, to
, org_to
;
459 int adjusted_size
= 0;
460 volatile struct gdb_exception ex
;
462 p
= buf
+ strlen ("qRelocInsn:");
463 pp
= unpack_varlen_hex (p
, &ul
);
465 error (_("invalid qRelocInsn packet: %s"), buf
);
469 unpack_varlen_hex (p
, &ul
);
474 TRY_CATCH (ex
, RETURN_MASK_ALL
)
476 gdbarch_relocate_instruction (target_gdbarch
, &to
, from
);
480 adjusted_size
= to
- org_to
;
482 sprintf (buf
, "qRelocInsn:%x", adjusted_size
);
485 else if (ex
.reason
< 0 && ex
.error
== MEMORY_ERROR
)
487 /* Propagate memory errors silently back to the target.
488 The stub may have limited the range of addresses we
489 can write to, for example. */
494 /* Something unexpectedly bad happened. Be verbose so
495 we can tell what, and propagate the error back to the
496 stub, so it doesn't get stuck waiting for a
498 exception_fprintf (gdb_stderr
, ex
,
499 _("warning: relocating instruction: "));
503 else if (buf
[0] == 'O' && buf
[1] != 'K')
504 remote_console_output (buf
+ 1); /* 'O' message from stub */
506 return buf
; /* Here's the actual reply. */
511 /* Handle for retreving the remote protocol data from gdbarch. */
512 static struct gdbarch_data
*remote_gdbarch_data_handle
;
514 static struct remote_arch_state
*
515 get_remote_arch_state (void)
517 return gdbarch_data (target_gdbarch
, remote_gdbarch_data_handle
);
520 /* Fetch the global remote target state. */
522 static struct remote_state
*
523 get_remote_state (void)
525 /* Make sure that the remote architecture state has been
526 initialized, because doing so might reallocate rs->buf. Any
527 function which calls getpkt also needs to be mindful of changes
528 to rs->buf, but this call limits the number of places which run
530 get_remote_arch_state ();
532 return get_remote_state_raw ();
536 compare_pnums (const void *lhs_
, const void *rhs_
)
538 const struct packet_reg
* const *lhs
= lhs_
;
539 const struct packet_reg
* const *rhs
= rhs_
;
541 if ((*lhs
)->pnum
< (*rhs
)->pnum
)
543 else if ((*lhs
)->pnum
== (*rhs
)->pnum
)
550 map_regcache_remote_table (struct gdbarch
*gdbarch
, struct packet_reg
*regs
)
552 int regnum
, num_remote_regs
, offset
;
553 struct packet_reg
**remote_regs
;
555 for (regnum
= 0; regnum
< gdbarch_num_regs (gdbarch
); regnum
++)
557 struct packet_reg
*r
= ®s
[regnum
];
559 if (register_size (gdbarch
, regnum
) == 0)
560 /* Do not try to fetch zero-sized (placeholder) registers. */
563 r
->pnum
= gdbarch_remote_register_number (gdbarch
, regnum
);
568 /* Define the g/G packet format as the contents of each register
569 with a remote protocol number, in order of ascending protocol
572 remote_regs
= alloca (gdbarch_num_regs (gdbarch
)
573 * sizeof (struct packet_reg
*));
574 for (num_remote_regs
= 0, regnum
= 0;
575 regnum
< gdbarch_num_regs (gdbarch
);
577 if (regs
[regnum
].pnum
!= -1)
578 remote_regs
[num_remote_regs
++] = ®s
[regnum
];
580 qsort (remote_regs
, num_remote_regs
, sizeof (struct packet_reg
*),
583 for (regnum
= 0, offset
= 0; regnum
< num_remote_regs
; regnum
++)
585 remote_regs
[regnum
]->in_g_packet
= 1;
586 remote_regs
[regnum
]->offset
= offset
;
587 offset
+= register_size (gdbarch
, remote_regs
[regnum
]->regnum
);
593 /* Given the architecture described by GDBARCH, return the remote
594 protocol register's number and the register's offset in the g/G
595 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
596 If the target does not have a mapping for REGNUM, return false,
597 otherwise, return true. */
600 remote_register_number_and_offset (struct gdbarch
*gdbarch
, int regnum
,
601 int *pnum
, int *poffset
)
604 struct packet_reg
*regs
;
605 struct cleanup
*old_chain
;
607 gdb_assert (regnum
< gdbarch_num_regs (gdbarch
));
609 regs
= xcalloc (gdbarch_num_regs (gdbarch
), sizeof (struct packet_reg
));
610 old_chain
= make_cleanup (xfree
, regs
);
612 sizeof_g_packet
= map_regcache_remote_table (gdbarch
, regs
);
614 *pnum
= regs
[regnum
].pnum
;
615 *poffset
= regs
[regnum
].offset
;
617 do_cleanups (old_chain
);
623 init_remote_state (struct gdbarch
*gdbarch
)
625 struct remote_state
*rs
= get_remote_state_raw ();
626 struct remote_arch_state
*rsa
;
628 rsa
= GDBARCH_OBSTACK_ZALLOC (gdbarch
, struct remote_arch_state
);
630 /* Use the architecture to build a regnum<->pnum table, which will be
631 1:1 unless a feature set specifies otherwise. */
632 rsa
->regs
= GDBARCH_OBSTACK_CALLOC (gdbarch
,
633 gdbarch_num_regs (gdbarch
),
636 /* Record the maximum possible size of the g packet - it may turn out
638 rsa
->sizeof_g_packet
= map_regcache_remote_table (gdbarch
, rsa
->regs
);
640 /* Default maximum number of characters in a packet body. Many
641 remote stubs have a hardwired buffer size of 400 bytes
642 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
643 as the maximum packet-size to ensure that the packet and an extra
644 NUL character can always fit in the buffer. This stops GDB
645 trashing stubs that try to squeeze an extra NUL into what is
646 already a full buffer (As of 1999-12-04 that was most stubs). */
647 rsa
->remote_packet_size
= 400 - 1;
649 /* This one is filled in when a ``g'' packet is received. */
650 rsa
->actual_register_packet_size
= 0;
652 /* Should rsa->sizeof_g_packet needs more space than the
653 default, adjust the size accordingly. Remember that each byte is
654 encoded as two characters. 32 is the overhead for the packet
655 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
656 (``$NN:G...#NN'') is a better guess, the below has been padded a
658 if (rsa
->sizeof_g_packet
> ((rsa
->remote_packet_size
- 32) / 2))
659 rsa
->remote_packet_size
= (rsa
->sizeof_g_packet
* 2 + 32);
661 /* Make sure that the packet buffer is plenty big enough for
662 this architecture. */
663 if (rs
->buf_size
< rsa
->remote_packet_size
)
665 rs
->buf_size
= 2 * rsa
->remote_packet_size
;
666 rs
->buf
= xrealloc (rs
->buf
, rs
->buf_size
);
672 /* Return the current allowed size of a remote packet. This is
673 inferred from the current architecture, and should be used to
674 limit the length of outgoing packets. */
676 get_remote_packet_size (void)
678 struct remote_state
*rs
= get_remote_state ();
679 struct remote_arch_state
*rsa
= get_remote_arch_state ();
681 if (rs
->explicit_packet_size
)
682 return rs
->explicit_packet_size
;
684 return rsa
->remote_packet_size
;
687 static struct packet_reg
*
688 packet_reg_from_regnum (struct remote_arch_state
*rsa
, long regnum
)
690 if (regnum
< 0 && regnum
>= gdbarch_num_regs (target_gdbarch
))
694 struct packet_reg
*r
= &rsa
->regs
[regnum
];
696 gdb_assert (r
->regnum
== regnum
);
701 static struct packet_reg
*
702 packet_reg_from_pnum (struct remote_arch_state
*rsa
, LONGEST pnum
)
706 for (i
= 0; i
< gdbarch_num_regs (target_gdbarch
); i
++)
708 struct packet_reg
*r
= &rsa
->regs
[i
];
716 /* FIXME: graces/2002-08-08: These variables should eventually be
717 bound to an instance of the target object (as in gdbarch-tdep()),
718 when such a thing exists. */
720 /* This is set to the data address of the access causing the target
721 to stop for a watchpoint. */
722 static CORE_ADDR remote_watch_data_address
;
724 /* This is non-zero if target stopped for a watchpoint. */
725 static int remote_stopped_by_watchpoint_p
;
727 static struct target_ops remote_ops
;
729 static struct target_ops extended_remote_ops
;
731 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
732 ``forever'' still use the normal timeout mechanism. This is
733 currently used by the ASYNC code to guarentee that target reads
734 during the initial connect always time-out. Once getpkt has been
735 modified to return a timeout indication and, in turn
736 remote_wait()/wait_for_inferior() have gained a timeout parameter
738 static int wait_forever_enabled_p
= 1;
740 /* Allow the user to specify what sequence to send to the remote
741 when he requests a program interruption: Although ^C is usually
742 what remote systems expect (this is the default, here), it is
743 sometimes preferable to send a break. On other systems such
744 as the Linux kernel, a break followed by g, which is Magic SysRq g
745 is required in order to interrupt the execution. */
746 const char interrupt_sequence_control_c
[] = "Ctrl-C";
747 const char interrupt_sequence_break
[] = "BREAK";
748 const char interrupt_sequence_break_g
[] = "BREAK-g";
749 static const char *const interrupt_sequence_modes
[] =
751 interrupt_sequence_control_c
,
752 interrupt_sequence_break
,
753 interrupt_sequence_break_g
,
756 static const char *interrupt_sequence_mode
= interrupt_sequence_control_c
;
759 show_interrupt_sequence (struct ui_file
*file
, int from_tty
,
760 struct cmd_list_element
*c
,
763 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
764 fprintf_filtered (file
,
765 _("Send the ASCII ETX character (Ctrl-c) "
766 "to the remote target to interrupt the "
767 "execution of the program.\n"));
768 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
769 fprintf_filtered (file
,
770 _("send a break signal to the remote target "
771 "to interrupt the execution of the program.\n"));
772 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
773 fprintf_filtered (file
,
774 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
775 "the remote target to interrupt the execution "
776 "of Linux kernel.\n"));
778 internal_error (__FILE__
, __LINE__
,
779 _("Invalid value for interrupt_sequence_mode: %s."),
780 interrupt_sequence_mode
);
783 /* This boolean variable specifies whether interrupt_sequence is sent
784 to the remote target when gdb connects to it.
785 This is mostly needed when you debug the Linux kernel: The Linux kernel
786 expects BREAK g which is Magic SysRq g for connecting gdb. */
787 static int interrupt_on_connect
= 0;
789 /* This variable is used to implement the "set/show remotebreak" commands.
790 Since these commands are now deprecated in favor of "set/show remote
791 interrupt-sequence", it no longer has any effect on the code. */
792 static int remote_break
;
795 set_remotebreak (char *args
, int from_tty
, struct cmd_list_element
*c
)
798 interrupt_sequence_mode
= interrupt_sequence_break
;
800 interrupt_sequence_mode
= interrupt_sequence_control_c
;
804 show_remotebreak (struct ui_file
*file
, int from_tty
,
805 struct cmd_list_element
*c
,
810 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
811 remote_open knows that we don't have a file open when the program
813 static struct serial
*remote_desc
= NULL
;
815 /* This variable sets the number of bits in an address that are to be
816 sent in a memory ("M" or "m") packet. Normally, after stripping
817 leading zeros, the entire address would be sent. This variable
818 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
819 initial implementation of remote.c restricted the address sent in
820 memory packets to ``host::sizeof long'' bytes - (typically 32
821 bits). Consequently, for 64 bit targets, the upper 32 bits of an
822 address was never sent. Since fixing this bug may cause a break in
823 some remote targets this variable is principly provided to
824 facilitate backward compatibility. */
826 static int remote_address_size
;
828 /* Temporary to track who currently owns the terminal. See
829 remote_terminal_* for more details. */
831 static int remote_async_terminal_ours_p
;
833 /* The executable file to use for "run" on the remote side. */
835 static char *remote_exec_file
= "";
838 /* User configurable variables for the number of characters in a
839 memory read/write packet. MIN (rsa->remote_packet_size,
840 rsa->sizeof_g_packet) is the default. Some targets need smaller
841 values (fifo overruns, et.al.) and some users need larger values
842 (speed up transfers). The variables ``preferred_*'' (the user
843 request), ``current_*'' (what was actually set) and ``forced_*''
844 (Positive - a soft limit, negative - a hard limit). */
846 struct memory_packet_config
853 /* Compute the current size of a read/write packet. Since this makes
854 use of ``actual_register_packet_size'' the computation is dynamic. */
857 get_memory_packet_size (struct memory_packet_config
*config
)
859 struct remote_state
*rs
= get_remote_state ();
860 struct remote_arch_state
*rsa
= get_remote_arch_state ();
862 /* NOTE: The somewhat arbitrary 16k comes from the knowledge (folk
863 law?) that some hosts don't cope very well with large alloca()
864 calls. Eventually the alloca() code will be replaced by calls to
865 xmalloc() and make_cleanups() allowing this restriction to either
866 be lifted or removed. */
867 #ifndef MAX_REMOTE_PACKET_SIZE
868 #define MAX_REMOTE_PACKET_SIZE 16384
870 /* NOTE: 20 ensures we can write at least one byte. */
871 #ifndef MIN_REMOTE_PACKET_SIZE
872 #define MIN_REMOTE_PACKET_SIZE 20
877 if (config
->size
<= 0)
878 what_they_get
= MAX_REMOTE_PACKET_SIZE
;
880 what_they_get
= config
->size
;
884 what_they_get
= get_remote_packet_size ();
885 /* Limit the packet to the size specified by the user. */
887 && what_they_get
> config
->size
)
888 what_they_get
= config
->size
;
890 /* Limit it to the size of the targets ``g'' response unless we have
891 permission from the stub to use a larger packet size. */
892 if (rs
->explicit_packet_size
== 0
893 && rsa
->actual_register_packet_size
> 0
894 && what_they_get
> rsa
->actual_register_packet_size
)
895 what_they_get
= rsa
->actual_register_packet_size
;
897 if (what_they_get
> MAX_REMOTE_PACKET_SIZE
)
898 what_they_get
= MAX_REMOTE_PACKET_SIZE
;
899 if (what_they_get
< MIN_REMOTE_PACKET_SIZE
)
900 what_they_get
= MIN_REMOTE_PACKET_SIZE
;
902 /* Make sure there is room in the global buffer for this packet
903 (including its trailing NUL byte). */
904 if (rs
->buf_size
< what_they_get
+ 1)
906 rs
->buf_size
= 2 * what_they_get
;
907 rs
->buf
= xrealloc (rs
->buf
, 2 * what_they_get
);
910 return what_they_get
;
913 /* Update the size of a read/write packet. If they user wants
914 something really big then do a sanity check. */
917 set_memory_packet_size (char *args
, struct memory_packet_config
*config
)
919 int fixed_p
= config
->fixed_p
;
920 long size
= config
->size
;
923 error (_("Argument required (integer, `fixed' or `limited')."));
924 else if (strcmp (args
, "hard") == 0
925 || strcmp (args
, "fixed") == 0)
927 else if (strcmp (args
, "soft") == 0
928 || strcmp (args
, "limit") == 0)
934 size
= strtoul (args
, &end
, 0);
936 error (_("Invalid %s (bad syntax)."), config
->name
);
938 /* Instead of explicitly capping the size of a packet to
939 MAX_REMOTE_PACKET_SIZE or dissallowing it, the user is
940 instead allowed to set the size to something arbitrarily
942 if (size
> MAX_REMOTE_PACKET_SIZE
)
943 error (_("Invalid %s (too large)."), config
->name
);
947 if (fixed_p
&& !config
->fixed_p
)
949 if (! query (_("The target may not be able to correctly handle a %s\n"
950 "of %ld bytes. Change the packet size? "),
952 error (_("Packet size not changed."));
954 /* Update the config. */
955 config
->fixed_p
= fixed_p
;
960 show_memory_packet_size (struct memory_packet_config
*config
)
962 printf_filtered (_("The %s is %ld. "), config
->name
, config
->size
);
964 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
965 get_memory_packet_size (config
));
967 printf_filtered (_("Packets are limited to %ld bytes.\n"),
968 get_memory_packet_size (config
));
971 static struct memory_packet_config memory_write_packet_config
=
973 "memory-write-packet-size",
977 set_memory_write_packet_size (char *args
, int from_tty
)
979 set_memory_packet_size (args
, &memory_write_packet_config
);
983 show_memory_write_packet_size (char *args
, int from_tty
)
985 show_memory_packet_size (&memory_write_packet_config
);
989 get_memory_write_packet_size (void)
991 return get_memory_packet_size (&memory_write_packet_config
);
994 static struct memory_packet_config memory_read_packet_config
=
996 "memory-read-packet-size",
1000 set_memory_read_packet_size (char *args
, int from_tty
)
1002 set_memory_packet_size (args
, &memory_read_packet_config
);
1006 show_memory_read_packet_size (char *args
, int from_tty
)
1008 show_memory_packet_size (&memory_read_packet_config
);
1012 get_memory_read_packet_size (void)
1014 long size
= get_memory_packet_size (&memory_read_packet_config
);
1016 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1017 extra buffer size argument before the memory read size can be
1018 increased beyond this. */
1019 if (size
> get_remote_packet_size ())
1020 size
= get_remote_packet_size ();
1025 /* Generic configuration support for packets the stub optionally
1026 supports. Allows the user to specify the use of the packet as well
1027 as allowing GDB to auto-detect support in the remote stub. */
1031 PACKET_SUPPORT_UNKNOWN
= 0,
1036 struct packet_config
1040 enum auto_boolean detect
;
1041 enum packet_support support
;
1044 /* Analyze a packet's return value and update the packet config
1055 update_packet_config (struct packet_config
*config
)
1057 switch (config
->detect
)
1059 case AUTO_BOOLEAN_TRUE
:
1060 config
->support
= PACKET_ENABLE
;
1062 case AUTO_BOOLEAN_FALSE
:
1063 config
->support
= PACKET_DISABLE
;
1065 case AUTO_BOOLEAN_AUTO
:
1066 config
->support
= PACKET_SUPPORT_UNKNOWN
;
1072 show_packet_config_cmd (struct packet_config
*config
)
1074 char *support
= "internal-error";
1076 switch (config
->support
)
1079 support
= "enabled";
1081 case PACKET_DISABLE
:
1082 support
= "disabled";
1084 case PACKET_SUPPORT_UNKNOWN
:
1085 support
= "unknown";
1088 switch (config
->detect
)
1090 case AUTO_BOOLEAN_AUTO
:
1091 printf_filtered (_("Support for the `%s' packet "
1092 "is auto-detected, currently %s.\n"),
1093 config
->name
, support
);
1095 case AUTO_BOOLEAN_TRUE
:
1096 case AUTO_BOOLEAN_FALSE
:
1097 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1098 config
->name
, support
);
1104 add_packet_config_cmd (struct packet_config
*config
, const char *name
,
1105 const char *title
, int legacy
)
1111 config
->name
= name
;
1112 config
->title
= title
;
1113 config
->detect
= AUTO_BOOLEAN_AUTO
;
1114 config
->support
= PACKET_SUPPORT_UNKNOWN
;
1115 set_doc
= xstrprintf ("Set use of remote protocol `%s' (%s) packet",
1117 show_doc
= xstrprintf ("Show current use of remote "
1118 "protocol `%s' (%s) packet",
1120 /* set/show TITLE-packet {auto,on,off} */
1121 cmd_name
= xstrprintf ("%s-packet", title
);
1122 add_setshow_auto_boolean_cmd (cmd_name
, class_obscure
,
1123 &config
->detect
, set_doc
,
1124 show_doc
, NULL
, /* help_doc */
1125 set_remote_protocol_packet_cmd
,
1126 show_remote_protocol_packet_cmd
,
1127 &remote_set_cmdlist
, &remote_show_cmdlist
);
1128 /* The command code copies the documentation strings. */
1131 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1136 legacy_name
= xstrprintf ("%s-packet", name
);
1137 add_alias_cmd (legacy_name
, cmd_name
, class_obscure
, 0,
1138 &remote_set_cmdlist
);
1139 add_alias_cmd (legacy_name
, cmd_name
, class_obscure
, 0,
1140 &remote_show_cmdlist
);
1144 static enum packet_result
1145 packet_check_result (const char *buf
)
1149 /* The stub recognized the packet request. Check that the
1150 operation succeeded. */
1152 && isxdigit (buf
[1]) && isxdigit (buf
[2])
1154 /* "Enn" - definitly an error. */
1155 return PACKET_ERROR
;
1157 /* Always treat "E." as an error. This will be used for
1158 more verbose error messages, such as E.memtypes. */
1159 if (buf
[0] == 'E' && buf
[1] == '.')
1160 return PACKET_ERROR
;
1162 /* The packet may or may not be OK. Just assume it is. */
1166 /* The stub does not support the packet. */
1167 return PACKET_UNKNOWN
;
1170 static enum packet_result
1171 packet_ok (const char *buf
, struct packet_config
*config
)
1173 enum packet_result result
;
1175 result
= packet_check_result (buf
);
1180 /* The stub recognized the packet request. */
1181 switch (config
->support
)
1183 case PACKET_SUPPORT_UNKNOWN
:
1185 fprintf_unfiltered (gdb_stdlog
,
1186 "Packet %s (%s) is supported\n",
1187 config
->name
, config
->title
);
1188 config
->support
= PACKET_ENABLE
;
1190 case PACKET_DISABLE
:
1191 internal_error (__FILE__
, __LINE__
,
1192 _("packet_ok: attempt to use a disabled packet"));
1198 case PACKET_UNKNOWN
:
1199 /* The stub does not support the packet. */
1200 switch (config
->support
)
1203 if (config
->detect
== AUTO_BOOLEAN_AUTO
)
1204 /* If the stub previously indicated that the packet was
1205 supported then there is a protocol error.. */
1206 error (_("Protocol error: %s (%s) conflicting enabled responses."),
1207 config
->name
, config
->title
);
1209 /* The user set it wrong. */
1210 error (_("Enabled packet %s (%s) not recognized by stub"),
1211 config
->name
, config
->title
);
1213 case PACKET_SUPPORT_UNKNOWN
:
1215 fprintf_unfiltered (gdb_stdlog
,
1216 "Packet %s (%s) is NOT supported\n",
1217 config
->name
, config
->title
);
1218 config
->support
= PACKET_DISABLE
;
1220 case PACKET_DISABLE
:
1242 PACKET_vFile_pwrite
,
1244 PACKET_vFile_unlink
,
1245 PACKET_vFile_readlink
,
1247 PACKET_qXfer_features
,
1248 PACKET_qXfer_libraries
,
1249 PACKET_qXfer_libraries_svr4
,
1250 PACKET_qXfer_memory_map
,
1251 PACKET_qXfer_spu_read
,
1252 PACKET_qXfer_spu_write
,
1253 PACKET_qXfer_osdata
,
1254 PACKET_qXfer_threads
,
1255 PACKET_qXfer_statictrace_read
,
1256 PACKET_qXfer_traceframe_info
,
1261 PACKET_QPassSignals
,
1262 PACKET_qSearch_memory
,
1265 PACKET_QStartNoAckMode
,
1267 PACKET_qXfer_siginfo_read
,
1268 PACKET_qXfer_siginfo_write
,
1270 PACKET_ConditionalTracepoints
,
1271 PACKET_ConditionalBreakpoints
,
1272 PACKET_FastTracepoints
,
1273 PACKET_StaticTracepoints
,
1274 PACKET_InstallInTrace
,
1277 PACKET_TracepointSource
,
1280 PACKET_QDisableRandomization
,
1285 static struct packet_config remote_protocol_packets
[PACKET_MAX
];
1288 set_remote_protocol_packet_cmd (char *args
, int from_tty
,
1289 struct cmd_list_element
*c
)
1291 struct packet_config
*packet
;
1293 for (packet
= remote_protocol_packets
;
1294 packet
< &remote_protocol_packets
[PACKET_MAX
];
1297 if (&packet
->detect
== c
->var
)
1299 update_packet_config (packet
);
1303 internal_error (__FILE__
, __LINE__
, _("Could not find config for %s"),
1308 show_remote_protocol_packet_cmd (struct ui_file
*file
, int from_tty
,
1309 struct cmd_list_element
*c
,
1312 struct packet_config
*packet
;
1314 for (packet
= remote_protocol_packets
;
1315 packet
< &remote_protocol_packets
[PACKET_MAX
];
1318 if (&packet
->detect
== c
->var
)
1320 show_packet_config_cmd (packet
);
1324 internal_error (__FILE__
, __LINE__
, _("Could not find config for %s"),
1328 /* Should we try one of the 'Z' requests? */
1332 Z_PACKET_SOFTWARE_BP
,
1333 Z_PACKET_HARDWARE_BP
,
1340 /* For compatibility with older distributions. Provide a ``set remote
1341 Z-packet ...'' command that updates all the Z packet types. */
1343 static enum auto_boolean remote_Z_packet_detect
;
1346 set_remote_protocol_Z_packet_cmd (char *args
, int from_tty
,
1347 struct cmd_list_element
*c
)
1351 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
1353 remote_protocol_packets
[PACKET_Z0
+ i
].detect
= remote_Z_packet_detect
;
1354 update_packet_config (&remote_protocol_packets
[PACKET_Z0
+ i
]);
1359 show_remote_protocol_Z_packet_cmd (struct ui_file
*file
, int from_tty
,
1360 struct cmd_list_element
*c
,
1365 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
1367 show_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
+ i
]);
1371 /* Should we try the 'ThreadInfo' query packet?
1373 This variable (NOT available to the user: auto-detect only!)
1374 determines whether GDB will use the new, simpler "ThreadInfo"
1375 query or the older, more complex syntax for thread queries.
1376 This is an auto-detect variable (set to true at each connect,
1377 and set to false when the target fails to recognize it). */
1379 static int use_threadinfo_query
;
1380 static int use_threadextra_query
;
1382 /* Tokens for use by the asynchronous signal handlers for SIGINT. */
1383 static struct async_signal_handler
*sigint_remote_twice_token
;
1384 static struct async_signal_handler
*sigint_remote_token
;
1387 /* Asynchronous signal handle registered as event loop source for
1388 when we have pending events ready to be passed to the core. */
1390 static struct async_event_handler
*remote_async_inferior_event_token
;
1392 /* Asynchronous signal handle registered as event loop source for when
1393 the remote sent us a %Stop notification. The registered callback
1394 will do a vStopped sequence to pull the rest of the events out of
1395 the remote side into our event queue. */
1397 static struct async_event_handler
*remote_async_get_pending_events_token
;
1400 static ptid_t magic_null_ptid
;
1401 static ptid_t not_sent_ptid
;
1402 static ptid_t any_thread_ptid
;
1404 /* These are the threads which we last sent to the remote system. The
1405 TID member will be -1 for all or -2 for not sent yet. */
1407 static ptid_t general_thread
;
1408 static ptid_t continue_thread
;
1410 /* This the traceframe which we last selected on the remote system.
1411 It will be -1 if no traceframe is selected. */
1412 static int remote_traceframe_number
= -1;
1414 /* Find out if the stub attached to PID (and hence GDB should offer to
1415 detach instead of killing it when bailing out). */
1418 remote_query_attached (int pid
)
1420 struct remote_state
*rs
= get_remote_state ();
1422 if (remote_protocol_packets
[PACKET_qAttached
].support
== PACKET_DISABLE
)
1425 if (remote_multi_process_p (rs
))
1426 sprintf (rs
->buf
, "qAttached:%x", pid
);
1428 sprintf (rs
->buf
, "qAttached");
1431 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1433 switch (packet_ok (rs
->buf
,
1434 &remote_protocol_packets
[PACKET_qAttached
]))
1437 if (strcmp (rs
->buf
, "1") == 0)
1441 warning (_("Remote failure reply: %s"), rs
->buf
);
1443 case PACKET_UNKNOWN
:
1450 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
1451 has been invented by GDB, instead of reported by the target. Since
1452 we can be connected to a remote system before before knowing about
1453 any inferior, mark the target with execution when we find the first
1454 inferior. If ATTACHED is 1, then we had just attached to this
1455 inferior. If it is 0, then we just created this inferior. If it
1456 is -1, then try querying the remote stub to find out if it had
1457 attached to the inferior or not. */
1459 static struct inferior
*
1460 remote_add_inferior (int fake_pid_p
, int pid
, int attached
)
1462 struct inferior
*inf
;
1464 /* Check whether this process we're learning about is to be
1465 considered attached, or if is to be considered to have been
1466 spawned by the stub. */
1468 attached
= remote_query_attached (pid
);
1470 if (gdbarch_has_global_solist (target_gdbarch
))
1472 /* If the target shares code across all inferiors, then every
1473 attach adds a new inferior. */
1474 inf
= add_inferior (pid
);
1476 /* ... and every inferior is bound to the same program space.
1477 However, each inferior may still have its own address
1479 inf
->aspace
= maybe_new_address_space ();
1480 inf
->pspace
= current_program_space
;
1484 /* In the traditional debugging scenario, there's a 1-1 match
1485 between program/address spaces. We simply bind the inferior
1486 to the program space's address space. */
1487 inf
= current_inferior ();
1488 inferior_appeared (inf
, pid
);
1491 inf
->attach_flag
= attached
;
1492 inf
->fake_pid_p
= fake_pid_p
;
1497 /* Add thread PTID to GDB's thread list. Tag it as executing/running
1498 according to RUNNING. */
1501 remote_add_thread (ptid_t ptid
, int running
)
1505 set_executing (ptid
, running
);
1506 set_running (ptid
, running
);
1509 /* Come here when we learn about a thread id from the remote target.
1510 It may be the first time we hear about such thread, so take the
1511 opportunity to add it to GDB's thread list. In case this is the
1512 first time we're noticing its corresponding inferior, add it to
1513 GDB's inferior list as well. */
1516 remote_notice_new_inferior (ptid_t currthread
, int running
)
1518 /* If this is a new thread, add it to GDB's thread list.
1519 If we leave it up to WFI to do this, bad things will happen. */
1521 if (in_thread_list (currthread
) && is_exited (currthread
))
1523 /* We're seeing an event on a thread id we knew had exited.
1524 This has to be a new thread reusing the old id. Add it. */
1525 remote_add_thread (currthread
, running
);
1529 if (!in_thread_list (currthread
))
1531 struct inferior
*inf
= NULL
;
1532 int pid
= ptid_get_pid (currthread
);
1534 if (ptid_is_pid (inferior_ptid
)
1535 && pid
== ptid_get_pid (inferior_ptid
))
1537 /* inferior_ptid has no thread member yet. This can happen
1538 with the vAttach -> remote_wait,"TAAthread:" path if the
1539 stub doesn't support qC. This is the first stop reported
1540 after an attach, so this is the main thread. Update the
1541 ptid in the thread list. */
1542 if (in_thread_list (pid_to_ptid (pid
)))
1543 thread_change_ptid (inferior_ptid
, currthread
);
1546 remote_add_thread (currthread
, running
);
1547 inferior_ptid
= currthread
;
1552 if (ptid_equal (magic_null_ptid
, inferior_ptid
))
1554 /* inferior_ptid is not set yet. This can happen with the
1555 vRun -> remote_wait,"TAAthread:" path if the stub
1556 doesn't support qC. This is the first stop reported
1557 after an attach, so this is the main thread. Update the
1558 ptid in the thread list. */
1559 thread_change_ptid (inferior_ptid
, currthread
);
1563 /* When connecting to a target remote, or to a target
1564 extended-remote which already was debugging an inferior, we
1565 may not know about it yet. Add it before adding its child
1566 thread, so notifications are emitted in a sensible order. */
1567 if (!in_inferior_list (ptid_get_pid (currthread
)))
1569 struct remote_state
*rs
= get_remote_state ();
1570 int fake_pid_p
= !remote_multi_process_p (rs
);
1572 inf
= remote_add_inferior (fake_pid_p
,
1573 ptid_get_pid (currthread
), -1);
1576 /* This is really a new thread. Add it. */
1577 remote_add_thread (currthread
, running
);
1579 /* If we found a new inferior, let the common code do whatever
1580 it needs to with it (e.g., read shared libraries, insert
1583 notice_new_inferior (currthread
, running
, 0);
1587 /* Return the private thread data, creating it if necessary. */
1589 static struct private_thread_info
*
1590 demand_private_info (ptid_t ptid
)
1592 struct thread_info
*info
= find_thread_ptid (ptid
);
1598 info
->private = xmalloc (sizeof (*(info
->private)));
1599 info
->private_dtor
= free_private_thread_info
;
1600 info
->private->core
= -1;
1601 info
->private->extra
= 0;
1604 return info
->private;
1607 /* Call this function as a result of
1608 1) A halt indication (T packet) containing a thread id
1609 2) A direct query of currthread
1610 3) Successful execution of set thread */
1613 record_currthread (ptid_t currthread
)
1615 general_thread
= currthread
;
1618 static char *last_pass_packet
;
1620 /* If 'QPassSignals' is supported, tell the remote stub what signals
1621 it can simply pass through to the inferior without reporting. */
1624 remote_pass_signals (int numsigs
, unsigned char *pass_signals
)
1626 if (remote_protocol_packets
[PACKET_QPassSignals
].support
!= PACKET_DISABLE
)
1628 char *pass_packet
, *p
;
1631 gdb_assert (numsigs
< 256);
1632 for (i
= 0; i
< numsigs
; i
++)
1634 if (pass_signals
[i
])
1637 pass_packet
= xmalloc (count
* 3 + strlen ("QPassSignals:") + 1);
1638 strcpy (pass_packet
, "QPassSignals:");
1639 p
= pass_packet
+ strlen (pass_packet
);
1640 for (i
= 0; i
< numsigs
; i
++)
1642 if (pass_signals
[i
])
1645 *p
++ = tohex (i
>> 4);
1646 *p
++ = tohex (i
& 15);
1655 if (!last_pass_packet
|| strcmp (last_pass_packet
, pass_packet
))
1657 struct remote_state
*rs
= get_remote_state ();
1658 char *buf
= rs
->buf
;
1660 putpkt (pass_packet
);
1661 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1662 packet_ok (buf
, &remote_protocol_packets
[PACKET_QPassSignals
]);
1663 if (last_pass_packet
)
1664 xfree (last_pass_packet
);
1665 last_pass_packet
= pass_packet
;
1668 xfree (pass_packet
);
1672 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
1673 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
1674 thread. If GEN is set, set the general thread, if not, then set
1675 the step/continue thread. */
1677 set_thread (struct ptid ptid
, int gen
)
1679 struct remote_state
*rs
= get_remote_state ();
1680 ptid_t state
= gen
? general_thread
: continue_thread
;
1681 char *buf
= rs
->buf
;
1682 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
1684 if (ptid_equal (state
, ptid
))
1688 *buf
++ = gen
? 'g' : 'c';
1689 if (ptid_equal (ptid
, magic_null_ptid
))
1690 xsnprintf (buf
, endbuf
- buf
, "0");
1691 else if (ptid_equal (ptid
, any_thread_ptid
))
1692 xsnprintf (buf
, endbuf
- buf
, "0");
1693 else if (ptid_equal (ptid
, minus_one_ptid
))
1694 xsnprintf (buf
, endbuf
- buf
, "-1");
1696 write_ptid (buf
, endbuf
, ptid
);
1698 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1700 general_thread
= ptid
;
1702 continue_thread
= ptid
;
1706 set_general_thread (struct ptid ptid
)
1708 set_thread (ptid
, 1);
1712 set_continue_thread (struct ptid ptid
)
1714 set_thread (ptid
, 0);
1717 /* Change the remote current process. Which thread within the process
1718 ends up selected isn't important, as long as it is the same process
1719 as what INFERIOR_PTID points to.
1721 This comes from that fact that there is no explicit notion of
1722 "selected process" in the protocol. The selected process for
1723 general operations is the process the selected general thread
1727 set_general_process (void)
1729 struct remote_state
*rs
= get_remote_state ();
1731 /* If the remote can't handle multiple processes, don't bother. */
1732 if (!rs
->extended
|| !remote_multi_process_p (rs
))
1735 /* We only need to change the remote current thread if it's pointing
1736 at some other process. */
1737 if (ptid_get_pid (general_thread
) != ptid_get_pid (inferior_ptid
))
1738 set_general_thread (inferior_ptid
);
1742 /* Return nonzero if the thread PTID is still alive on the remote
1746 remote_thread_alive (struct target_ops
*ops
, ptid_t ptid
)
1748 struct remote_state
*rs
= get_remote_state ();
1751 if (ptid_equal (ptid
, magic_null_ptid
))
1752 /* The main thread is always alive. */
1755 if (ptid_get_pid (ptid
) != 0 && ptid_get_tid (ptid
) == 0)
1756 /* The main thread is always alive. This can happen after a
1757 vAttach, if the remote side doesn't support
1762 endp
= rs
->buf
+ get_remote_packet_size ();
1765 write_ptid (p
, endp
, ptid
);
1768 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1769 return (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K');
1772 /* About these extended threadlist and threadinfo packets. They are
1773 variable length packets but, the fields within them are often fixed
1774 length. They are redundent enough to send over UDP as is the
1775 remote protocol in general. There is a matching unit test module
1778 #define OPAQUETHREADBYTES 8
1780 /* a 64 bit opaque identifier */
1781 typedef unsigned char threadref
[OPAQUETHREADBYTES
];
1783 /* WARNING: This threadref data structure comes from the remote O.S.,
1784 libstub protocol encoding, and remote.c. It is not particularly
1787 /* Right now, the internal structure is int. We want it to be bigger.
1788 Plan to fix this. */
1790 typedef int gdb_threadref
; /* Internal GDB thread reference. */
1792 /* gdb_ext_thread_info is an internal GDB data structure which is
1793 equivalent to the reply of the remote threadinfo packet. */
1795 struct gdb_ext_thread_info
1797 threadref threadid
; /* External form of thread reference. */
1798 int active
; /* Has state interesting to GDB?
1800 char display
[256]; /* Brief state display, name,
1801 blocked/suspended. */
1802 char shortname
[32]; /* To be used to name threads. */
1803 char more_display
[256]; /* Long info, statistics, queue depth,
1807 /* The volume of remote transfers can be limited by submitting
1808 a mask containing bits specifying the desired information.
1809 Use a union of these values as the 'selection' parameter to
1810 get_thread_info. FIXME: Make these TAG names more thread specific. */
1812 #define TAG_THREADID 1
1813 #define TAG_EXISTS 2
1814 #define TAG_DISPLAY 4
1815 #define TAG_THREADNAME 8
1816 #define TAG_MOREDISPLAY 16
1818 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
1820 char *unpack_varlen_hex (char *buff
, ULONGEST
*result
);
1822 static char *unpack_nibble (char *buf
, int *val
);
1824 static char *pack_nibble (char *buf
, int nibble
);
1826 static char *pack_hex_byte (char *pkt
, int /* unsigned char */ byte
);
1828 static char *unpack_byte (char *buf
, int *value
);
1830 static char *pack_int (char *buf
, int value
);
1832 static char *unpack_int (char *buf
, int *value
);
1834 static char *unpack_string (char *src
, char *dest
, int length
);
1836 static char *pack_threadid (char *pkt
, threadref
*id
);
1838 static char *unpack_threadid (char *inbuf
, threadref
*id
);
1840 void int_to_threadref (threadref
*id
, int value
);
1842 static int threadref_to_int (threadref
*ref
);
1844 static void copy_threadref (threadref
*dest
, threadref
*src
);
1846 static int threadmatch (threadref
*dest
, threadref
*src
);
1848 static char *pack_threadinfo_request (char *pkt
, int mode
,
1851 static int remote_unpack_thread_info_response (char *pkt
,
1852 threadref
*expectedref
,
1853 struct gdb_ext_thread_info
1857 static int remote_get_threadinfo (threadref
*threadid
,
1858 int fieldset
, /*TAG mask */
1859 struct gdb_ext_thread_info
*info
);
1861 static char *pack_threadlist_request (char *pkt
, int startflag
,
1863 threadref
*nextthread
);
1865 static int parse_threadlist_response (char *pkt
,
1867 threadref
*original_echo
,
1868 threadref
*resultlist
,
1871 static int remote_get_threadlist (int startflag
,
1872 threadref
*nextthread
,
1876 threadref
*threadlist
);
1878 typedef int (*rmt_thread_action
) (threadref
*ref
, void *context
);
1880 static int remote_threadlist_iterator (rmt_thread_action stepfunction
,
1881 void *context
, int looplimit
);
1883 static int remote_newthread_step (threadref
*ref
, void *context
);
1886 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
1887 buffer we're allowed to write to. Returns
1888 BUF+CHARACTERS_WRITTEN. */
1891 write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
)
1894 struct remote_state
*rs
= get_remote_state ();
1896 if (remote_multi_process_p (rs
))
1898 pid
= ptid_get_pid (ptid
);
1900 buf
+= xsnprintf (buf
, endbuf
- buf
, "p-%x.", -pid
);
1902 buf
+= xsnprintf (buf
, endbuf
- buf
, "p%x.", pid
);
1904 tid
= ptid_get_tid (ptid
);
1906 buf
+= xsnprintf (buf
, endbuf
- buf
, "-%x", -tid
);
1908 buf
+= xsnprintf (buf
, endbuf
- buf
, "%x", tid
);
1913 /* Extract a PTID from BUF. If non-null, OBUF is set to the to one
1914 passed the last parsed char. Returns null_ptid on error. */
1917 read_ptid (char *buf
, char **obuf
)
1921 ULONGEST pid
= 0, tid
= 0;
1925 /* Multi-process ptid. */
1926 pp
= unpack_varlen_hex (p
+ 1, &pid
);
1928 error (_("invalid remote ptid: %s"), p
);
1931 pp
= unpack_varlen_hex (p
+ 1, &tid
);
1934 return ptid_build (pid
, 0, tid
);
1937 /* No multi-process. Just a tid. */
1938 pp
= unpack_varlen_hex (p
, &tid
);
1940 /* Since the stub is not sending a process id, then default to
1941 what's in inferior_ptid, unless it's null at this point. If so,
1942 then since there's no way to know the pid of the reported
1943 threads, use the magic number. */
1944 if (ptid_equal (inferior_ptid
, null_ptid
))
1945 pid
= ptid_get_pid (magic_null_ptid
);
1947 pid
= ptid_get_pid (inferior_ptid
);
1951 return ptid_build (pid
, 0, tid
);
1954 /* Encode 64 bits in 16 chars of hex. */
1956 static const char hexchars
[] = "0123456789abcdef";
1959 ishex (int ch
, int *val
)
1961 if ((ch
>= 'a') && (ch
<= 'f'))
1963 *val
= ch
- 'a' + 10;
1966 if ((ch
>= 'A') && (ch
<= 'F'))
1968 *val
= ch
- 'A' + 10;
1971 if ((ch
>= '0') && (ch
<= '9'))
1982 if (ch
>= 'a' && ch
<= 'f')
1983 return ch
- 'a' + 10;
1984 if (ch
>= '0' && ch
<= '9')
1986 if (ch
>= 'A' && ch
<= 'F')
1987 return ch
- 'A' + 10;
1992 stub_unpack_int (char *buff
, int fieldlength
)
1999 nibble
= stubhex (*buff
++);
2003 retval
= retval
<< 4;
2009 unpack_varlen_hex (char *buff
, /* packet to parse */
2013 ULONGEST retval
= 0;
2015 while (ishex (*buff
, &nibble
))
2018 retval
= retval
<< 4;
2019 retval
|= nibble
& 0x0f;
2026 unpack_nibble (char *buf
, int *val
)
2028 *val
= fromhex (*buf
++);
2033 pack_nibble (char *buf
, int nibble
)
2035 *buf
++ = hexchars
[(nibble
& 0x0f)];
2040 pack_hex_byte (char *pkt
, int byte
)
2042 *pkt
++ = hexchars
[(byte
>> 4) & 0xf];
2043 *pkt
++ = hexchars
[(byte
& 0xf)];
2048 unpack_byte (char *buf
, int *value
)
2050 *value
= stub_unpack_int (buf
, 2);
2055 pack_int (char *buf
, int value
)
2057 buf
= pack_hex_byte (buf
, (value
>> 24) & 0xff);
2058 buf
= pack_hex_byte (buf
, (value
>> 16) & 0xff);
2059 buf
= pack_hex_byte (buf
, (value
>> 8) & 0x0ff);
2060 buf
= pack_hex_byte (buf
, (value
& 0xff));
2065 unpack_int (char *buf
, int *value
)
2067 *value
= stub_unpack_int (buf
, 8);
2071 #if 0 /* Currently unused, uncomment when needed. */
2072 static char *pack_string (char *pkt
, char *string
);
2075 pack_string (char *pkt
, char *string
)
2080 len
= strlen (string
);
2082 len
= 200; /* Bigger than most GDB packets, junk??? */
2083 pkt
= pack_hex_byte (pkt
, len
);
2087 if ((ch
== '\0') || (ch
== '#'))
2088 ch
= '*'; /* Protect encapsulation. */
2093 #endif /* 0 (unused) */
2096 unpack_string (char *src
, char *dest
, int length
)
2105 pack_threadid (char *pkt
, threadref
*id
)
2108 unsigned char *altid
;
2110 altid
= (unsigned char *) id
;
2111 limit
= pkt
+ BUF_THREAD_ID_SIZE
;
2113 pkt
= pack_hex_byte (pkt
, *altid
++);
2119 unpack_threadid (char *inbuf
, threadref
*id
)
2122 char *limit
= inbuf
+ BUF_THREAD_ID_SIZE
;
2125 altref
= (char *) id
;
2127 while (inbuf
< limit
)
2129 x
= stubhex (*inbuf
++);
2130 y
= stubhex (*inbuf
++);
2131 *altref
++ = (x
<< 4) | y
;
2136 /* Externally, threadrefs are 64 bits but internally, they are still
2137 ints. This is due to a mismatch of specifications. We would like
2138 to use 64bit thread references internally. This is an adapter
2142 int_to_threadref (threadref
*id
, int value
)
2144 unsigned char *scan
;
2146 scan
= (unsigned char *) id
;
2152 *scan
++ = (value
>> 24) & 0xff;
2153 *scan
++ = (value
>> 16) & 0xff;
2154 *scan
++ = (value
>> 8) & 0xff;
2155 *scan
++ = (value
& 0xff);
2159 threadref_to_int (threadref
*ref
)
2162 unsigned char *scan
;
2168 value
= (value
<< 8) | ((*scan
++) & 0xff);
2173 copy_threadref (threadref
*dest
, threadref
*src
)
2176 unsigned char *csrc
, *cdest
;
2178 csrc
= (unsigned char *) src
;
2179 cdest
= (unsigned char *) dest
;
2186 threadmatch (threadref
*dest
, threadref
*src
)
2188 /* Things are broken right now, so just assume we got a match. */
2190 unsigned char *srcp
, *destp
;
2192 srcp
= (char *) src
;
2193 destp
= (char *) dest
;
2197 result
&= (*srcp
++ == *destp
++) ? 1 : 0;
2204 threadid:1, # always request threadid
2211 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
2214 pack_threadinfo_request (char *pkt
, int mode
, threadref
*id
)
2216 *pkt
++ = 'q'; /* Info Query */
2217 *pkt
++ = 'P'; /* process or thread info */
2218 pkt
= pack_int (pkt
, mode
); /* mode */
2219 pkt
= pack_threadid (pkt
, id
); /* threadid */
2220 *pkt
= '\0'; /* terminate */
2224 /* These values tag the fields in a thread info response packet. */
2225 /* Tagging the fields allows us to request specific fields and to
2226 add more fields as time goes by. */
2228 #define TAG_THREADID 1 /* Echo the thread identifier. */
2229 #define TAG_EXISTS 2 /* Is this process defined enough to
2230 fetch registers and its stack? */
2231 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
2232 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
2233 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
2237 remote_unpack_thread_info_response (char *pkt
, threadref
*expectedref
,
2238 struct gdb_ext_thread_info
*info
)
2240 struct remote_state
*rs
= get_remote_state ();
2244 char *limit
= pkt
+ rs
->buf_size
; /* Plausible parsing limit. */
2247 /* info->threadid = 0; FIXME: implement zero_threadref. */
2249 info
->display
[0] = '\0';
2250 info
->shortname
[0] = '\0';
2251 info
->more_display
[0] = '\0';
2253 /* Assume the characters indicating the packet type have been
2255 pkt
= unpack_int (pkt
, &mask
); /* arg mask */
2256 pkt
= unpack_threadid (pkt
, &ref
);
2259 warning (_("Incomplete response to threadinfo request."));
2260 if (!threadmatch (&ref
, expectedref
))
2261 { /* This is an answer to a different request. */
2262 warning (_("ERROR RMT Thread info mismatch."));
2265 copy_threadref (&info
->threadid
, &ref
);
2267 /* Loop on tagged fields , try to bail if somthing goes wrong. */
2269 /* Packets are terminated with nulls. */
2270 while ((pkt
< limit
) && mask
&& *pkt
)
2272 pkt
= unpack_int (pkt
, &tag
); /* tag */
2273 pkt
= unpack_byte (pkt
, &length
); /* length */
2274 if (!(tag
& mask
)) /* Tags out of synch with mask. */
2276 warning (_("ERROR RMT: threadinfo tag mismatch."));
2280 if (tag
== TAG_THREADID
)
2284 warning (_("ERROR RMT: length of threadid is not 16."));
2288 pkt
= unpack_threadid (pkt
, &ref
);
2289 mask
= mask
& ~TAG_THREADID
;
2292 if (tag
== TAG_EXISTS
)
2294 info
->active
= stub_unpack_int (pkt
, length
);
2296 mask
= mask
& ~(TAG_EXISTS
);
2299 warning (_("ERROR RMT: 'exists' length too long."));
2305 if (tag
== TAG_THREADNAME
)
2307 pkt
= unpack_string (pkt
, &info
->shortname
[0], length
);
2308 mask
= mask
& ~TAG_THREADNAME
;
2311 if (tag
== TAG_DISPLAY
)
2313 pkt
= unpack_string (pkt
, &info
->display
[0], length
);
2314 mask
= mask
& ~TAG_DISPLAY
;
2317 if (tag
== TAG_MOREDISPLAY
)
2319 pkt
= unpack_string (pkt
, &info
->more_display
[0], length
);
2320 mask
= mask
& ~TAG_MOREDISPLAY
;
2323 warning (_("ERROR RMT: unknown thread info tag."));
2324 break; /* Not a tag we know about. */
2330 remote_get_threadinfo (threadref
*threadid
, int fieldset
, /* TAG mask */
2331 struct gdb_ext_thread_info
*info
)
2333 struct remote_state
*rs
= get_remote_state ();
2336 pack_threadinfo_request (rs
->buf
, fieldset
, threadid
);
2338 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2340 if (rs
->buf
[0] == '\0')
2343 result
= remote_unpack_thread_info_response (rs
->buf
+ 2,
2348 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
2351 pack_threadlist_request (char *pkt
, int startflag
, int threadcount
,
2352 threadref
*nextthread
)
2354 *pkt
++ = 'q'; /* info query packet */
2355 *pkt
++ = 'L'; /* Process LIST or threadLIST request */
2356 pkt
= pack_nibble (pkt
, startflag
); /* initflag 1 bytes */
2357 pkt
= pack_hex_byte (pkt
, threadcount
); /* threadcount 2 bytes */
2358 pkt
= pack_threadid (pkt
, nextthread
); /* 64 bit thread identifier */
2363 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
2366 parse_threadlist_response (char *pkt
, int result_limit
,
2367 threadref
*original_echo
, threadref
*resultlist
,
2370 struct remote_state
*rs
= get_remote_state ();
2372 int count
, resultcount
, done
;
2375 /* Assume the 'q' and 'M chars have been stripped. */
2376 limit
= pkt
+ (rs
->buf_size
- BUF_THREAD_ID_SIZE
);
2377 /* done parse past here */
2378 pkt
= unpack_byte (pkt
, &count
); /* count field */
2379 pkt
= unpack_nibble (pkt
, &done
);
2380 /* The first threadid is the argument threadid. */
2381 pkt
= unpack_threadid (pkt
, original_echo
); /* should match query packet */
2382 while ((count
-- > 0) && (pkt
< limit
))
2384 pkt
= unpack_threadid (pkt
, resultlist
++);
2385 if (resultcount
++ >= result_limit
)
2394 remote_get_threadlist (int startflag
, threadref
*nextthread
, int result_limit
,
2395 int *done
, int *result_count
, threadref
*threadlist
)
2397 struct remote_state
*rs
= get_remote_state ();
2398 static threadref echo_nextthread
;
2401 /* Trancate result limit to be smaller than the packet size. */
2402 if ((((result_limit
+ 1) * BUF_THREAD_ID_SIZE
) + 10)
2403 >= get_remote_packet_size ())
2404 result_limit
= (get_remote_packet_size () / BUF_THREAD_ID_SIZE
) - 2;
2406 pack_threadlist_request (rs
->buf
, startflag
, result_limit
, nextthread
);
2408 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2410 if (*rs
->buf
== '\0')
2414 parse_threadlist_response (rs
->buf
+ 2, result_limit
, &echo_nextthread
,
2417 if (!threadmatch (&echo_nextthread
, nextthread
))
2419 /* FIXME: This is a good reason to drop the packet. */
2420 /* Possably, there is a duplicate response. */
2422 retransmit immediatly - race conditions
2423 retransmit after timeout - yes
2425 wait for packet, then exit
2427 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
2428 return 0; /* I choose simply exiting. */
2430 if (*result_count
<= 0)
2434 warning (_("RMT ERROR : failed to get remote thread list."));
2437 return result
; /* break; */
2439 if (*result_count
> result_limit
)
2442 warning (_("RMT ERROR: threadlist response longer than requested."));
2448 /* This is the interface between remote and threads, remotes upper
2451 /* remote_find_new_threads retrieves the thread list and for each
2452 thread in the list, looks up the thread in GDB's internal list,
2453 adding the thread if it does not already exist. This involves
2454 getting partial thread lists from the remote target so, polling the
2455 quit_flag is required. */
2458 /* About this many threadisds fit in a packet. */
2460 #define MAXTHREADLISTRESULTS 32
2463 remote_threadlist_iterator (rmt_thread_action stepfunction
, void *context
,
2466 int done
, i
, result_count
;
2470 static threadref nextthread
;
2471 static threadref resultthreadlist
[MAXTHREADLISTRESULTS
];
2476 if (loopcount
++ > looplimit
)
2479 warning (_("Remote fetch threadlist -infinite loop-."));
2482 if (!remote_get_threadlist (startflag
, &nextthread
, MAXTHREADLISTRESULTS
,
2483 &done
, &result_count
, resultthreadlist
))
2488 /* Clear for later iterations. */
2490 /* Setup to resume next batch of thread references, set nextthread. */
2491 if (result_count
>= 1)
2492 copy_threadref (&nextthread
, &resultthreadlist
[result_count
- 1]);
2494 while (result_count
--)
2495 if (!(result
= (*stepfunction
) (&resultthreadlist
[i
++], context
)))
2502 remote_newthread_step (threadref
*ref
, void *context
)
2504 int pid
= ptid_get_pid (inferior_ptid
);
2505 ptid_t ptid
= ptid_build (pid
, 0, threadref_to_int (ref
));
2507 if (!in_thread_list (ptid
))
2509 return 1; /* continue iterator */
2512 #define CRAZY_MAX_THREADS 1000
2515 remote_current_thread (ptid_t oldpid
)
2517 struct remote_state
*rs
= get_remote_state ();
2520 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2521 if (rs
->buf
[0] == 'Q' && rs
->buf
[1] == 'C')
2522 return read_ptid (&rs
->buf
[2], NULL
);
2527 /* Find new threads for info threads command.
2528 * Original version, using John Metzler's thread protocol.
2532 remote_find_new_threads (void)
2534 remote_threadlist_iterator (remote_newthread_step
, 0,
2538 #if defined(HAVE_LIBEXPAT)
2540 typedef struct thread_item
2546 DEF_VEC_O(thread_item_t
);
2548 struct threads_parsing_context
2550 VEC (thread_item_t
) *items
;
2554 start_thread (struct gdb_xml_parser
*parser
,
2555 const struct gdb_xml_element
*element
,
2556 void *user_data
, VEC(gdb_xml_value_s
) *attributes
)
2558 struct threads_parsing_context
*data
= user_data
;
2560 struct thread_item item
;
2562 struct gdb_xml_value
*attr
;
2564 id
= xml_find_attribute (attributes
, "id")->value
;
2565 item
.ptid
= read_ptid (id
, NULL
);
2567 attr
= xml_find_attribute (attributes
, "core");
2569 item
.core
= *(ULONGEST
*) attr
->value
;
2575 VEC_safe_push (thread_item_t
, data
->items
, &item
);
2579 end_thread (struct gdb_xml_parser
*parser
,
2580 const struct gdb_xml_element
*element
,
2581 void *user_data
, const char *body_text
)
2583 struct threads_parsing_context
*data
= user_data
;
2585 if (body_text
&& *body_text
)
2586 VEC_last (thread_item_t
, data
->items
)->extra
= xstrdup (body_text
);
2589 const struct gdb_xml_attribute thread_attributes
[] = {
2590 { "id", GDB_XML_AF_NONE
, NULL
, NULL
},
2591 { "core", GDB_XML_AF_OPTIONAL
, gdb_xml_parse_attr_ulongest
, NULL
},
2592 { NULL
, GDB_XML_AF_NONE
, NULL
, NULL
}
2595 const struct gdb_xml_element thread_children
[] = {
2596 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
2599 const struct gdb_xml_element threads_children
[] = {
2600 { "thread", thread_attributes
, thread_children
,
2601 GDB_XML_EF_REPEATABLE
| GDB_XML_EF_OPTIONAL
,
2602 start_thread
, end_thread
},
2603 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
2606 const struct gdb_xml_element threads_elements
[] = {
2607 { "threads", NULL
, threads_children
,
2608 GDB_XML_EF_NONE
, NULL
, NULL
},
2609 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
2612 /* Discard the contents of the constructed thread info context. */
2615 clear_threads_parsing_context (void *p
)
2617 struct threads_parsing_context
*context
= p
;
2619 struct thread_item
*item
;
2621 for (i
= 0; VEC_iterate (thread_item_t
, context
->items
, i
, item
); ++i
)
2622 xfree (item
->extra
);
2624 VEC_free (thread_item_t
, context
->items
);
2630 * Find all threads for info threads command.
2631 * Uses new thread protocol contributed by Cisco.
2632 * Falls back and attempts to use the older method (above)
2633 * if the target doesn't respond to the new method.
2637 remote_threads_info (struct target_ops
*ops
)
2639 struct remote_state
*rs
= get_remote_state ();
2643 if (remote_desc
== 0) /* paranoia */
2644 error (_("Command can only be used when connected to the remote target."));
2646 #if defined(HAVE_LIBEXPAT)
2647 if (remote_protocol_packets
[PACKET_qXfer_threads
].support
== PACKET_ENABLE
)
2649 char *xml
= target_read_stralloc (¤t_target
,
2650 TARGET_OBJECT_THREADS
, NULL
);
2652 struct cleanup
*back_to
= make_cleanup (xfree
, xml
);
2656 struct threads_parsing_context context
;
2658 context
.items
= NULL
;
2659 make_cleanup (clear_threads_parsing_context
, &context
);
2661 if (gdb_xml_parse_quick (_("threads"), "threads.dtd",
2662 threads_elements
, xml
, &context
) == 0)
2665 struct thread_item
*item
;
2668 VEC_iterate (thread_item_t
, context
.items
, i
, item
);
2671 if (!ptid_equal (item
->ptid
, null_ptid
))
2673 struct private_thread_info
*info
;
2674 /* In non-stop mode, we assume new found threads
2675 are running until proven otherwise with a
2676 stop reply. In all-stop, we can only get
2677 here if all threads are stopped. */
2678 int running
= non_stop
? 1 : 0;
2680 remote_notice_new_inferior (item
->ptid
, running
);
2682 info
= demand_private_info (item
->ptid
);
2683 info
->core
= item
->core
;
2684 info
->extra
= item
->extra
;
2691 do_cleanups (back_to
);
2696 if (use_threadinfo_query
)
2698 putpkt ("qfThreadInfo");
2699 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2701 if (bufp
[0] != '\0') /* q packet recognized */
2703 while (*bufp
++ == 'm') /* reply contains one or more TID */
2707 new_thread
= read_ptid (bufp
, &bufp
);
2708 if (!ptid_equal (new_thread
, null_ptid
))
2710 /* In non-stop mode, we assume new found threads
2711 are running until proven otherwise with a
2712 stop reply. In all-stop, we can only get
2713 here if all threads are stopped. */
2714 int running
= non_stop
? 1 : 0;
2716 remote_notice_new_inferior (new_thread
, running
);
2719 while (*bufp
++ == ','); /* comma-separated list */
2720 putpkt ("qsThreadInfo");
2721 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2728 /* Only qfThreadInfo is supported in non-stop mode. */
2732 /* Else fall back to old method based on jmetzler protocol. */
2733 use_threadinfo_query
= 0;
2734 remote_find_new_threads ();
2739 * Collect a descriptive string about the given thread.
2740 * The target may say anything it wants to about the thread
2741 * (typically info about its blocked / runnable state, name, etc.).
2742 * This string will appear in the info threads display.
2744 * Optional: targets are not required to implement this function.
2748 remote_threads_extra_info (struct thread_info
*tp
)
2750 struct remote_state
*rs
= get_remote_state ();
2754 struct gdb_ext_thread_info threadinfo
;
2755 static char display_buf
[100]; /* arbitrary... */
2756 int n
= 0; /* position in display_buf */
2758 if (remote_desc
== 0) /* paranoia */
2759 internal_error (__FILE__
, __LINE__
,
2760 _("remote_threads_extra_info"));
2762 if (ptid_equal (tp
->ptid
, magic_null_ptid
)
2763 || (ptid_get_pid (tp
->ptid
) != 0 && ptid_get_tid (tp
->ptid
) == 0))
2764 /* This is the main thread which was added by GDB. The remote
2765 server doesn't know about it. */
2768 if (remote_protocol_packets
[PACKET_qXfer_threads
].support
== PACKET_ENABLE
)
2770 struct thread_info
*info
= find_thread_ptid (tp
->ptid
);
2772 if (info
&& info
->private)
2773 return info
->private->extra
;
2778 if (use_threadextra_query
)
2781 char *endb
= rs
->buf
+ get_remote_packet_size ();
2783 xsnprintf (b
, endb
- b
, "qThreadExtraInfo,");
2785 write_ptid (b
, endb
, tp
->ptid
);
2788 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2789 if (rs
->buf
[0] != 0)
2791 n
= min (strlen (rs
->buf
) / 2, sizeof (display_buf
));
2792 result
= hex2bin (rs
->buf
, (gdb_byte
*) display_buf
, n
);
2793 display_buf
[result
] = '\0';
2798 /* If the above query fails, fall back to the old method. */
2799 use_threadextra_query
= 0;
2800 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
2801 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
2802 int_to_threadref (&id
, ptid_get_tid (tp
->ptid
));
2803 if (remote_get_threadinfo (&id
, set
, &threadinfo
))
2804 if (threadinfo
.active
)
2806 if (*threadinfo
.shortname
)
2807 n
+= xsnprintf (&display_buf
[0], sizeof (display_buf
) - n
,
2808 " Name: %s,", threadinfo
.shortname
);
2809 if (*threadinfo
.display
)
2810 n
+= xsnprintf (&display_buf
[n
], sizeof (display_buf
) - n
,
2811 " State: %s,", threadinfo
.display
);
2812 if (*threadinfo
.more_display
)
2813 n
+= xsnprintf (&display_buf
[n
], sizeof (display_buf
) - n
,
2814 " Priority: %s", threadinfo
.more_display
);
2818 /* For purely cosmetic reasons, clear up trailing commas. */
2819 if (',' == display_buf
[n
-1])
2820 display_buf
[n
-1] = ' ';
2829 remote_static_tracepoint_marker_at (CORE_ADDR addr
,
2830 struct static_tracepoint_marker
*marker
)
2832 struct remote_state
*rs
= get_remote_state ();
2835 sprintf (p
, "qTSTMat:");
2837 p
+= hexnumstr (p
, addr
);
2839 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2843 error (_("Remote failure reply: %s"), p
);
2847 parse_static_tracepoint_marker_definition (p
, &p
, marker
);
2854 static VEC(static_tracepoint_marker_p
) *
2855 remote_static_tracepoint_markers_by_strid (const char *strid
)
2857 struct remote_state
*rs
= get_remote_state ();
2858 VEC(static_tracepoint_marker_p
) *markers
= NULL
;
2859 struct static_tracepoint_marker
*marker
= NULL
;
2860 struct cleanup
*old_chain
;
2863 /* Ask for a first packet of static tracepoint marker
2866 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2869 error (_("Remote failure reply: %s"), p
);
2871 old_chain
= make_cleanup (free_current_marker
, &marker
);
2876 marker
= XCNEW (struct static_tracepoint_marker
);
2880 parse_static_tracepoint_marker_definition (p
, &p
, marker
);
2882 if (strid
== NULL
|| strcmp (strid
, marker
->str_id
) == 0)
2884 VEC_safe_push (static_tracepoint_marker_p
,
2890 release_static_tracepoint_marker (marker
);
2891 memset (marker
, 0, sizeof (*marker
));
2894 while (*p
++ == ','); /* comma-separated list */
2895 /* Ask for another packet of static tracepoint definition. */
2897 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2901 do_cleanups (old_chain
);
2906 /* Implement the to_get_ada_task_ptid function for the remote targets. */
2909 remote_get_ada_task_ptid (long lwp
, long thread
)
2911 return ptid_build (ptid_get_pid (inferior_ptid
), 0, lwp
);
2915 /* Restart the remote side; this is an extended protocol operation. */
2918 extended_remote_restart (void)
2920 struct remote_state
*rs
= get_remote_state ();
2922 /* Send the restart command; for reasons I don't understand the
2923 remote side really expects a number after the "R". */
2924 xsnprintf (rs
->buf
, get_remote_packet_size (), "R%x", 0);
2927 remote_fileio_reset ();
2930 /* Clean up connection to a remote debugger. */
2933 remote_close (int quitting
)
2935 if (remote_desc
== NULL
)
2936 return; /* already closed */
2938 /* Make sure we leave stdin registered in the event loop, and we
2939 don't leave the async SIGINT signal handler installed. */
2940 remote_terminal_ours ();
2942 serial_close (remote_desc
);
2945 /* We don't have a connection to the remote stub anymore. Get rid
2946 of all the inferiors and their threads we were controlling.
2947 Reset inferior_ptid to null_ptid first, as otherwise has_stack_frame
2948 will be unable to find the thread corresponding to (pid, 0, 0). */
2949 inferior_ptid
= null_ptid
;
2950 discard_all_inferiors ();
2952 /* We're no longer interested in any of these events. */
2953 discard_pending_stop_replies (-1);
2955 if (remote_async_inferior_event_token
)
2956 delete_async_event_handler (&remote_async_inferior_event_token
);
2957 if (remote_async_get_pending_events_token
)
2958 delete_async_event_handler (&remote_async_get_pending_events_token
);
2961 /* Query the remote side for the text, data and bss offsets. */
2966 struct remote_state
*rs
= get_remote_state ();
2969 int lose
, num_segments
= 0, do_sections
, do_segments
;
2970 CORE_ADDR text_addr
, data_addr
, bss_addr
, segments
[2];
2971 struct section_offsets
*offs
;
2972 struct symfile_segment_data
*data
;
2974 if (symfile_objfile
== NULL
)
2977 putpkt ("qOffsets");
2978 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2981 if (buf
[0] == '\000')
2982 return; /* Return silently. Stub doesn't support
2986 warning (_("Remote failure reply: %s"), buf
);
2990 /* Pick up each field in turn. This used to be done with scanf, but
2991 scanf will make trouble if CORE_ADDR size doesn't match
2992 conversion directives correctly. The following code will work
2993 with any size of CORE_ADDR. */
2994 text_addr
= data_addr
= bss_addr
= 0;
2998 if (strncmp (ptr
, "Text=", 5) == 0)
3001 /* Don't use strtol, could lose on big values. */
3002 while (*ptr
&& *ptr
!= ';')
3003 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
3005 if (strncmp (ptr
, ";Data=", 6) == 0)
3008 while (*ptr
&& *ptr
!= ';')
3009 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
3014 if (!lose
&& strncmp (ptr
, ";Bss=", 5) == 0)
3017 while (*ptr
&& *ptr
!= ';')
3018 bss_addr
= (bss_addr
<< 4) + fromhex (*ptr
++);
3020 if (bss_addr
!= data_addr
)
3021 warning (_("Target reported unsupported offsets: %s"), buf
);
3026 else if (strncmp (ptr
, "TextSeg=", 8) == 0)
3029 /* Don't use strtol, could lose on big values. */
3030 while (*ptr
&& *ptr
!= ';')
3031 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
3034 if (strncmp (ptr
, ";DataSeg=", 9) == 0)
3037 while (*ptr
&& *ptr
!= ';')
3038 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
3046 error (_("Malformed response to offset query, %s"), buf
);
3047 else if (*ptr
!= '\0')
3048 warning (_("Target reported unsupported offsets: %s"), buf
);
3050 offs
= ((struct section_offsets
*)
3051 alloca (SIZEOF_N_SECTION_OFFSETS (symfile_objfile
->num_sections
)));
3052 memcpy (offs
, symfile_objfile
->section_offsets
,
3053 SIZEOF_N_SECTION_OFFSETS (symfile_objfile
->num_sections
));
3055 data
= get_symfile_segment_data (symfile_objfile
->obfd
);
3056 do_segments
= (data
!= NULL
);
3057 do_sections
= num_segments
== 0;
3059 if (num_segments
> 0)
3061 segments
[0] = text_addr
;
3062 segments
[1] = data_addr
;
3064 /* If we have two segments, we can still try to relocate everything
3065 by assuming that the .text and .data offsets apply to the whole
3066 text and data segments. Convert the offsets given in the packet
3067 to base addresses for symfile_map_offsets_to_segments. */
3068 else if (data
&& data
->num_segments
== 2)
3070 segments
[0] = data
->segment_bases
[0] + text_addr
;
3071 segments
[1] = data
->segment_bases
[1] + data_addr
;
3074 /* If the object file has only one segment, assume that it is text
3075 rather than data; main programs with no writable data are rare,
3076 but programs with no code are useless. Of course the code might
3077 have ended up in the data segment... to detect that we would need
3078 the permissions here. */
3079 else if (data
&& data
->num_segments
== 1)
3081 segments
[0] = data
->segment_bases
[0] + text_addr
;
3084 /* There's no way to relocate by segment. */
3090 int ret
= symfile_map_offsets_to_segments (symfile_objfile
->obfd
, data
,
3091 offs
, num_segments
, segments
);
3093 if (ret
== 0 && !do_sections
)
3094 error (_("Can not handle qOffsets TextSeg "
3095 "response with this symbol file"));
3102 free_symfile_segment_data (data
);
3106 offs
->offsets
[SECT_OFF_TEXT (symfile_objfile
)] = text_addr
;
3108 /* This is a temporary kludge to force data and bss to use the
3109 same offsets because that's what nlmconv does now. The real
3110 solution requires changes to the stub and remote.c that I
3111 don't have time to do right now. */
3113 offs
->offsets
[SECT_OFF_DATA (symfile_objfile
)] = data_addr
;
3114 offs
->offsets
[SECT_OFF_BSS (symfile_objfile
)] = data_addr
;
3117 objfile_relocate (symfile_objfile
, offs
);
3120 /* Callback for iterate_over_threads. Set the STOP_REQUESTED flags in
3121 threads we know are stopped already. This is used during the
3122 initial remote connection in non-stop mode --- threads that are
3123 reported as already being stopped are left stopped. */
3126 set_stop_requested_callback (struct thread_info
*thread
, void *data
)
3128 /* If we have a stop reply for this thread, it must be stopped. */
3129 if (peek_stop_reply (thread
->ptid
))
3130 set_stop_requested (thread
->ptid
, 1);
3135 /* Send interrupt_sequence to remote target. */
3137 send_interrupt_sequence (void)
3139 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
3140 serial_write (remote_desc
, "\x03", 1);
3141 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
3142 serial_send_break (remote_desc
);
3143 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
3145 serial_send_break (remote_desc
);
3146 serial_write (remote_desc
, "g", 1);
3149 internal_error (__FILE__
, __LINE__
,
3150 _("Invalid value for interrupt_sequence_mode: %s."),
3151 interrupt_sequence_mode
);
3154 /* Query the remote target for which is the current thread/process,
3155 add it to our tables, and update INFERIOR_PTID. The caller is
3156 responsible for setting the state such that the remote end is ready
3157 to return the current thread. */
3160 add_current_inferior_and_thread (void)
3162 struct remote_state
*rs
= get_remote_state ();
3166 inferior_ptid
= null_ptid
;
3168 /* Now, if we have thread information, update inferior_ptid. */
3169 ptid
= remote_current_thread (inferior_ptid
);
3170 if (!ptid_equal (ptid
, null_ptid
))
3172 if (!remote_multi_process_p (rs
))
3175 inferior_ptid
= ptid
;
3179 /* Without this, some commands which require an active target
3180 (such as kill) won't work. This variable serves (at least)
3181 double duty as both the pid of the target process (if it has
3182 such), and as a flag indicating that a target is active. */
3183 inferior_ptid
= magic_null_ptid
;
3187 remote_add_inferior (fake_pid_p
, ptid_get_pid (inferior_ptid
), -1);
3189 /* Add the main thread. */
3190 add_thread_silent (inferior_ptid
);
3194 remote_start_remote (int from_tty
, struct target_ops
*target
, int extended_p
)
3196 struct remote_state
*rs
= get_remote_state ();
3197 struct packet_config
*noack_config
;
3198 char *wait_status
= NULL
;
3200 immediate_quit
++; /* Allow user to interrupt it. */
3202 if (interrupt_on_connect
)
3203 send_interrupt_sequence ();
3205 /* Ack any packet which the remote side has already sent. */
3206 serial_write (remote_desc
, "+", 1);
3208 /* The first packet we send to the target is the optional "supported
3209 packets" request. If the target can answer this, it will tell us
3210 which later probes to skip. */
3211 remote_query_supported ();
3213 /* If the stub wants to get a QAllow, compose one and send it. */
3214 if (remote_protocol_packets
[PACKET_QAllow
].support
!= PACKET_DISABLE
)
3215 remote_set_permissions ();
3217 /* Next, we possibly activate noack mode.
3219 If the QStartNoAckMode packet configuration is set to AUTO,
3220 enable noack mode if the stub reported a wish for it with
3223 If set to TRUE, then enable noack mode even if the stub didn't
3224 report it in qSupported. If the stub doesn't reply OK, the
3225 session ends with an error.
3227 If FALSE, then don't activate noack mode, regardless of what the
3228 stub claimed should be the default with qSupported. */
3230 noack_config
= &remote_protocol_packets
[PACKET_QStartNoAckMode
];
3232 if (noack_config
->detect
== AUTO_BOOLEAN_TRUE
3233 || (noack_config
->detect
== AUTO_BOOLEAN_AUTO
3234 && noack_config
->support
== PACKET_ENABLE
))
3236 putpkt ("QStartNoAckMode");
3237 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3238 if (packet_ok (rs
->buf
, noack_config
) == PACKET_OK
)
3244 /* Tell the remote that we are using the extended protocol. */
3246 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3249 /* Next, if the target can specify a description, read it. We do
3250 this before anything involving memory or registers. */
3251 target_find_description ();
3253 /* Next, now that we know something about the target, update the
3254 address spaces in the program spaces. */
3255 update_address_spaces ();
3257 /* On OSs where the list of libraries is global to all
3258 processes, we fetch them early. */
3259 if (gdbarch_has_global_solist (target_gdbarch
))
3260 solib_add (NULL
, from_tty
, target
, auto_solib_add
);
3264 if (!rs
->non_stop_aware
)
3265 error (_("Non-stop mode requested, but remote "
3266 "does not support non-stop"));
3268 putpkt ("QNonStop:1");
3269 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3271 if (strcmp (rs
->buf
, "OK") != 0)
3272 error (_("Remote refused setting non-stop mode with: %s"), rs
->buf
);
3274 /* Find about threads and processes the stub is already
3275 controlling. We default to adding them in the running state.
3276 The '?' query below will then tell us about which threads are
3278 remote_threads_info (target
);
3280 else if (rs
->non_stop_aware
)
3282 /* Don't assume that the stub can operate in all-stop mode.
3283 Request it explicitely. */
3284 putpkt ("QNonStop:0");
3285 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3287 if (strcmp (rs
->buf
, "OK") != 0)
3288 error (_("Remote refused setting all-stop mode with: %s"), rs
->buf
);
3291 /* Check whether the target is running now. */
3293 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3299 struct inferior
*inf
;
3301 if (rs
->buf
[0] == 'W' || rs
->buf
[0] == 'X')
3304 error (_("The target is not running (try extended-remote?)"));
3306 /* We're connected, but not running. Drop out before we
3307 call start_remote. */
3312 /* Save the reply for later. */
3313 wait_status
= alloca (strlen (rs
->buf
) + 1);
3314 strcpy (wait_status
, rs
->buf
);
3317 /* Let the stub know that we want it to return the thread. */
3318 set_continue_thread (minus_one_ptid
);
3320 add_current_inferior_and_thread ();
3322 /* init_wait_for_inferior should be called before get_offsets in order
3323 to manage `inserted' flag in bp loc in a correct state.
3324 breakpoint_init_inferior, called from init_wait_for_inferior, set
3325 `inserted' flag to 0, while before breakpoint_re_set, called from
3326 start_remote, set `inserted' flag to 1. In the initialization of
3327 inferior, breakpoint_init_inferior should be called first, and then
3328 breakpoint_re_set can be called. If this order is broken, state of
3329 `inserted' flag is wrong, and cause some problems on breakpoint
3331 init_wait_for_inferior ();
3333 get_offsets (); /* Get text, data & bss offsets. */
3335 /* If we could not find a description using qXfer, and we know
3336 how to do it some other way, try again. This is not
3337 supported for non-stop; it could be, but it is tricky if
3338 there are no stopped threads when we connect. */
3339 if (remote_read_description_p (target
)
3340 && gdbarch_target_desc (target_gdbarch
) == NULL
)
3342 target_clear_description ();
3343 target_find_description ();
3346 /* Use the previously fetched status. */
3347 gdb_assert (wait_status
!= NULL
);
3348 strcpy (rs
->buf
, wait_status
);
3349 rs
->cached_wait_status
= 1;
3352 start_remote (from_tty
); /* Initialize gdb process mechanisms. */
3356 /* Clear WFI global state. Do this before finding about new
3357 threads and inferiors, and setting the current inferior.
3358 Otherwise we would clear the proceed status of the current
3359 inferior when we want its stop_soon state to be preserved
3360 (see notice_new_inferior). */
3361 init_wait_for_inferior ();
3363 /* In non-stop, we will either get an "OK", meaning that there
3364 are no stopped threads at this time; or, a regular stop
3365 reply. In the latter case, there may be more than one thread
3366 stopped --- we pull them all out using the vStopped
3368 if (strcmp (rs
->buf
, "OK") != 0)
3370 struct stop_reply
*stop_reply
;
3371 struct cleanup
*old_chain
;
3373 stop_reply
= stop_reply_xmalloc ();
3374 old_chain
= make_cleanup (do_stop_reply_xfree
, stop_reply
);
3376 remote_parse_stop_reply (rs
->buf
, stop_reply
);
3377 discard_cleanups (old_chain
);
3379 /* get_pending_stop_replies acks this one, and gets the rest
3381 pending_stop_reply
= stop_reply
;
3382 remote_get_pending_stop_replies ();
3384 /* Make sure that threads that were stopped remain
3386 iterate_over_threads (set_stop_requested_callback
, NULL
);
3389 if (target_can_async_p ())
3390 target_async (inferior_event_handler
, 0);
3392 if (thread_count () == 0)
3395 error (_("The target is not running (try extended-remote?)"));
3397 /* We're connected, but not running. Drop out before we
3398 call start_remote. */
3402 /* Let the stub know that we want it to return the thread. */
3404 /* Force the stub to choose a thread. */
3405 set_general_thread (null_ptid
);
3408 inferior_ptid
= remote_current_thread (minus_one_ptid
);
3409 if (ptid_equal (inferior_ptid
, minus_one_ptid
))
3410 error (_("remote didn't report the current thread in non-stop mode"));
3412 get_offsets (); /* Get text, data & bss offsets. */
3414 /* In non-stop mode, any cached wait status will be stored in
3415 the stop reply queue. */
3416 gdb_assert (wait_status
== NULL
);
3418 /* Report all signals during attach/startup. */
3419 remote_pass_signals (0, NULL
);
3422 /* If we connected to a live target, do some additional setup. */
3423 if (target_has_execution
)
3425 if (exec_bfd
) /* No use without an exec file. */
3426 remote_check_symbols (symfile_objfile
);
3429 /* Possibly the target has been engaged in a trace run started
3430 previously; find out where things are at. */
3431 if (remote_get_trace_status (current_trace_status ()) != -1)
3433 struct uploaded_tp
*uploaded_tps
= NULL
;
3434 struct uploaded_tsv
*uploaded_tsvs
= NULL
;
3436 if (current_trace_status ()->running
)
3437 printf_filtered (_("Trace is already running on the target.\n"));
3439 /* Get trace state variables first, they may be checked when
3440 parsing uploaded commands. */
3442 remote_upload_trace_state_variables (&uploaded_tsvs
);
3444 merge_uploaded_trace_state_variables (&uploaded_tsvs
);
3446 remote_upload_tracepoints (&uploaded_tps
);
3448 merge_uploaded_tracepoints (&uploaded_tps
);
3451 /* If breakpoints are global, insert them now. */
3452 if (gdbarch_has_global_breakpoints (target_gdbarch
)
3453 && breakpoints_always_inserted_mode ())
3454 insert_breakpoints ();
3457 /* Open a connection to a remote debugger.
3458 NAME is the filename used for communication. */
3461 remote_open (char *name
, int from_tty
)
3463 remote_open_1 (name
, from_tty
, &remote_ops
, 0);
3466 /* Open a connection to a remote debugger using the extended
3467 remote gdb protocol. NAME is the filename used for communication. */
3470 extended_remote_open (char *name
, int from_tty
)
3472 remote_open_1 (name
, from_tty
, &extended_remote_ops
, 1 /*extended_p */);
3475 /* Generic code for opening a connection to a remote target. */
3478 init_all_packet_configs (void)
3482 for (i
= 0; i
< PACKET_MAX
; i
++)
3483 update_packet_config (&remote_protocol_packets
[i
]);
3486 /* Symbol look-up. */
3489 remote_check_symbols (struct objfile
*objfile
)
3491 struct remote_state
*rs
= get_remote_state ();
3492 char *msg
, *reply
, *tmp
;
3493 struct minimal_symbol
*sym
;
3496 /* The remote side has no concept of inferiors that aren't running
3497 yet, it only knows about running processes. If we're connected
3498 but our current inferior is not running, we should not invite the
3499 remote target to request symbol lookups related to its
3500 (unrelated) current process. */
3501 if (!target_has_execution
)
3504 if (remote_protocol_packets
[PACKET_qSymbol
].support
== PACKET_DISABLE
)
3507 /* Make sure the remote is pointing at the right process. Note
3508 there's no way to select "no process". */
3509 set_general_process ();
3511 /* Allocate a message buffer. We can't reuse the input buffer in RS,
3512 because we need both at the same time. */
3513 msg
= alloca (get_remote_packet_size ());
3515 /* Invite target to request symbol lookups. */
3517 putpkt ("qSymbol::");
3518 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3519 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_qSymbol
]);
3522 while (strncmp (reply
, "qSymbol:", 8) == 0)
3525 end
= hex2bin (tmp
, (gdb_byte
*) msg
, strlen (tmp
) / 2);
3527 sym
= lookup_minimal_symbol (msg
, NULL
, NULL
);
3529 xsnprintf (msg
, get_remote_packet_size (), "qSymbol::%s", &reply
[8]);
3532 int addr_size
= gdbarch_addr_bit (target_gdbarch
) / 8;
3533 CORE_ADDR sym_addr
= SYMBOL_VALUE_ADDRESS (sym
);
3535 /* If this is a function address, return the start of code
3536 instead of any data function descriptor. */
3537 sym_addr
= gdbarch_convert_from_func_ptr_addr (target_gdbarch
,
3541 xsnprintf (msg
, get_remote_packet_size (), "qSymbol:%s:%s",
3542 phex_nz (sym_addr
, addr_size
), &reply
[8]);
3546 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3551 static struct serial
*
3552 remote_serial_open (char *name
)
3554 static int udp_warning
= 0;
3556 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
3557 of in ser-tcp.c, because it is the remote protocol assuming that the
3558 serial connection is reliable and not the serial connection promising
3560 if (!udp_warning
&& strncmp (name
, "udp:", 4) == 0)
3562 warning (_("The remote protocol may be unreliable over UDP.\n"
3563 "Some events may be lost, rendering further debugging "
3568 return serial_open (name
);
3571 /* Inform the target of our permission settings. The permission flags
3572 work without this, but if the target knows the settings, it can do
3573 a couple things. First, it can add its own check, to catch cases
3574 that somehow manage to get by the permissions checks in target
3575 methods. Second, if the target is wired to disallow particular
3576 settings (for instance, a system in the field that is not set up to
3577 be able to stop at a breakpoint), it can object to any unavailable
3581 remote_set_permissions (void)
3583 struct remote_state
*rs
= get_remote_state ();
3585 sprintf (rs
->buf
, "QAllow:"
3586 "WriteReg:%x;WriteMem:%x;"
3587 "InsertBreak:%x;InsertTrace:%x;"
3588 "InsertFastTrace:%x;Stop:%x",
3589 may_write_registers
, may_write_memory
,
3590 may_insert_breakpoints
, may_insert_tracepoints
,
3591 may_insert_fast_tracepoints
, may_stop
);
3593 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3595 /* If the target didn't like the packet, warn the user. Do not try
3596 to undo the user's settings, that would just be maddening. */
3597 if (strcmp (rs
->buf
, "OK") != 0)
3598 warning (_("Remote refused setting permissions with: %s"), rs
->buf
);
3601 /* This type describes each known response to the qSupported
3603 struct protocol_feature
3605 /* The name of this protocol feature. */
3608 /* The default for this protocol feature. */
3609 enum packet_support default_support
;
3611 /* The function to call when this feature is reported, or after
3612 qSupported processing if the feature is not supported.
3613 The first argument points to this structure. The second
3614 argument indicates whether the packet requested support be
3615 enabled, disabled, or probed (or the default, if this function
3616 is being called at the end of processing and this feature was
3617 not reported). The third argument may be NULL; if not NULL, it
3618 is a NUL-terminated string taken from the packet following
3619 this feature's name and an equals sign. */
3620 void (*func
) (const struct protocol_feature
*, enum packet_support
,
3623 /* The corresponding packet for this feature. Only used if
3624 FUNC is remote_supported_packet. */
3629 remote_supported_packet (const struct protocol_feature
*feature
,
3630 enum packet_support support
,
3631 const char *argument
)
3635 warning (_("Remote qSupported response supplied an unexpected value for"
3636 " \"%s\"."), feature
->name
);
3640 if (remote_protocol_packets
[feature
->packet
].support
3641 == PACKET_SUPPORT_UNKNOWN
)
3642 remote_protocol_packets
[feature
->packet
].support
= support
;
3646 remote_packet_size (const struct protocol_feature
*feature
,
3647 enum packet_support support
, const char *value
)
3649 struct remote_state
*rs
= get_remote_state ();
3654 if (support
!= PACKET_ENABLE
)
3657 if (value
== NULL
|| *value
== '\0')
3659 warning (_("Remote target reported \"%s\" without a size."),
3665 packet_size
= strtol (value
, &value_end
, 16);
3666 if (errno
!= 0 || *value_end
!= '\0' || packet_size
< 0)
3668 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
3669 feature
->name
, value
);
3673 if (packet_size
> MAX_REMOTE_PACKET_SIZE
)
3675 warning (_("limiting remote suggested packet size (%d bytes) to %d"),
3676 packet_size
, MAX_REMOTE_PACKET_SIZE
);
3677 packet_size
= MAX_REMOTE_PACKET_SIZE
;
3680 /* Record the new maximum packet size. */
3681 rs
->explicit_packet_size
= packet_size
;
3685 remote_multi_process_feature (const struct protocol_feature
*feature
,
3686 enum packet_support support
, const char *value
)
3688 struct remote_state
*rs
= get_remote_state ();
3690 rs
->multi_process_aware
= (support
== PACKET_ENABLE
);
3694 remote_non_stop_feature (const struct protocol_feature
*feature
,
3695 enum packet_support support
, const char *value
)
3697 struct remote_state
*rs
= get_remote_state ();
3699 rs
->non_stop_aware
= (support
== PACKET_ENABLE
);
3703 remote_cond_tracepoint_feature (const struct protocol_feature
*feature
,
3704 enum packet_support support
,
3707 struct remote_state
*rs
= get_remote_state ();
3709 rs
->cond_tracepoints
= (support
== PACKET_ENABLE
);
3713 remote_cond_breakpoint_feature (const struct protocol_feature
*feature
,
3714 enum packet_support support
,
3717 struct remote_state
*rs
= get_remote_state ();
3719 rs
->cond_breakpoints
= (support
== PACKET_ENABLE
);
3723 remote_fast_tracepoint_feature (const struct protocol_feature
*feature
,
3724 enum packet_support support
,
3727 struct remote_state
*rs
= get_remote_state ();
3729 rs
->fast_tracepoints
= (support
== PACKET_ENABLE
);
3733 remote_static_tracepoint_feature (const struct protocol_feature
*feature
,
3734 enum packet_support support
,
3737 struct remote_state
*rs
= get_remote_state ();
3739 rs
->static_tracepoints
= (support
== PACKET_ENABLE
);
3743 remote_install_in_trace_feature (const struct protocol_feature
*feature
,
3744 enum packet_support support
,
3747 struct remote_state
*rs
= get_remote_state ();
3749 rs
->install_in_trace
= (support
== PACKET_ENABLE
);
3753 remote_disconnected_tracing_feature (const struct protocol_feature
*feature
,
3754 enum packet_support support
,
3757 struct remote_state
*rs
= get_remote_state ();
3759 rs
->disconnected_tracing
= (support
== PACKET_ENABLE
);
3763 remote_enable_disable_tracepoint_feature (const struct protocol_feature
*feature
,
3764 enum packet_support support
,
3767 struct remote_state
*rs
= get_remote_state ();
3769 rs
->enable_disable_tracepoints
= (support
== PACKET_ENABLE
);
3773 remote_string_tracing_feature (const struct protocol_feature
*feature
,
3774 enum packet_support support
,
3777 struct remote_state
*rs
= get_remote_state ();
3779 rs
->string_tracing
= (support
== PACKET_ENABLE
);
3782 static struct protocol_feature remote_protocol_features
[] = {
3783 { "PacketSize", PACKET_DISABLE
, remote_packet_size
, -1 },
3784 { "qXfer:auxv:read", PACKET_DISABLE
, remote_supported_packet
,
3785 PACKET_qXfer_auxv
},
3786 { "qXfer:features:read", PACKET_DISABLE
, remote_supported_packet
,
3787 PACKET_qXfer_features
},
3788 { "qXfer:libraries:read", PACKET_DISABLE
, remote_supported_packet
,
3789 PACKET_qXfer_libraries
},
3790 { "qXfer:libraries-svr4:read", PACKET_DISABLE
, remote_supported_packet
,
3791 PACKET_qXfer_libraries_svr4
},
3792 { "qXfer:memory-map:read", PACKET_DISABLE
, remote_supported_packet
,
3793 PACKET_qXfer_memory_map
},
3794 { "qXfer:spu:read", PACKET_DISABLE
, remote_supported_packet
,
3795 PACKET_qXfer_spu_read
},
3796 { "qXfer:spu:write", PACKET_DISABLE
, remote_supported_packet
,
3797 PACKET_qXfer_spu_write
},
3798 { "qXfer:osdata:read", PACKET_DISABLE
, remote_supported_packet
,
3799 PACKET_qXfer_osdata
},
3800 { "qXfer:threads:read", PACKET_DISABLE
, remote_supported_packet
,
3801 PACKET_qXfer_threads
},
3802 { "qXfer:traceframe-info:read", PACKET_DISABLE
, remote_supported_packet
,
3803 PACKET_qXfer_traceframe_info
},
3804 { "QPassSignals", PACKET_DISABLE
, remote_supported_packet
,
3805 PACKET_QPassSignals
},
3806 { "QStartNoAckMode", PACKET_DISABLE
, remote_supported_packet
,
3807 PACKET_QStartNoAckMode
},
3808 { "multiprocess", PACKET_DISABLE
, remote_multi_process_feature
, -1 },
3809 { "QNonStop", PACKET_DISABLE
, remote_non_stop_feature
, -1 },
3810 { "qXfer:siginfo:read", PACKET_DISABLE
, remote_supported_packet
,
3811 PACKET_qXfer_siginfo_read
},
3812 { "qXfer:siginfo:write", PACKET_DISABLE
, remote_supported_packet
,
3813 PACKET_qXfer_siginfo_write
},
3814 { "ConditionalTracepoints", PACKET_DISABLE
, remote_cond_tracepoint_feature
,
3815 PACKET_ConditionalTracepoints
},
3816 { "ConditionalBreakpoints", PACKET_DISABLE
, remote_cond_breakpoint_feature
,
3817 PACKET_ConditionalBreakpoints
},
3818 { "FastTracepoints", PACKET_DISABLE
, remote_fast_tracepoint_feature
,
3819 PACKET_FastTracepoints
},
3820 { "StaticTracepoints", PACKET_DISABLE
, remote_static_tracepoint_feature
,
3821 PACKET_StaticTracepoints
},
3822 {"InstallInTrace", PACKET_DISABLE
, remote_install_in_trace_feature
,
3823 PACKET_InstallInTrace
},
3824 { "DisconnectedTracing", PACKET_DISABLE
, remote_disconnected_tracing_feature
,
3826 { "ReverseContinue", PACKET_DISABLE
, remote_supported_packet
,
3828 { "ReverseStep", PACKET_DISABLE
, remote_supported_packet
,
3830 { "TracepointSource", PACKET_DISABLE
, remote_supported_packet
,
3831 PACKET_TracepointSource
},
3832 { "QAllow", PACKET_DISABLE
, remote_supported_packet
,
3834 { "EnableDisableTracepoints", PACKET_DISABLE
,
3835 remote_enable_disable_tracepoint_feature
, -1 },
3836 { "qXfer:fdpic:read", PACKET_DISABLE
, remote_supported_packet
,
3837 PACKET_qXfer_fdpic
},
3838 { "qXfer:uib:read", PACKET_DISABLE
, remote_supported_packet
,
3840 { "QDisableRandomization", PACKET_DISABLE
, remote_supported_packet
,
3841 PACKET_QDisableRandomization
},
3842 { "QAgent", PACKET_DISABLE
, remote_supported_packet
, PACKET_QAgent
},
3843 { "tracenz", PACKET_DISABLE
,
3844 remote_string_tracing_feature
, -1 },
3847 static char *remote_support_xml
;
3849 /* Register string appended to "xmlRegisters=" in qSupported query. */
3852 register_remote_support_xml (const char *xml
)
3854 #if defined(HAVE_LIBEXPAT)
3855 if (remote_support_xml
== NULL
)
3856 remote_support_xml
= concat ("xmlRegisters=", xml
, (char *) NULL
);
3859 char *copy
= xstrdup (remote_support_xml
+ 13);
3860 char *p
= strtok (copy
, ",");
3864 if (strcmp (p
, xml
) == 0)
3871 while ((p
= strtok (NULL
, ",")) != NULL
);
3874 remote_support_xml
= reconcat (remote_support_xml
,
3875 remote_support_xml
, ",", xml
,
3882 remote_query_supported_append (char *msg
, const char *append
)
3885 return reconcat (msg
, msg
, ";", append
, (char *) NULL
);
3887 return xstrdup (append
);
3891 remote_query_supported (void)
3893 struct remote_state
*rs
= get_remote_state ();
3896 unsigned char seen
[ARRAY_SIZE (remote_protocol_features
)];
3898 /* The packet support flags are handled differently for this packet
3899 than for most others. We treat an error, a disabled packet, and
3900 an empty response identically: any features which must be reported
3901 to be used will be automatically disabled. An empty buffer
3902 accomplishes this, since that is also the representation for a list
3903 containing no features. */
3906 if (remote_protocol_packets
[PACKET_qSupported
].support
!= PACKET_DISABLE
)
3909 struct cleanup
*old_chain
= make_cleanup (free_current_contents
, &q
);
3911 q
= remote_query_supported_append (q
, "multiprocess+");
3913 if (remote_support_xml
)
3914 q
= remote_query_supported_append (q
, remote_support_xml
);
3916 q
= remote_query_supported_append (q
, "qRelocInsn+");
3918 q
= reconcat (q
, "qSupported:", q
, (char *) NULL
);
3921 do_cleanups (old_chain
);
3923 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3925 /* If an error occured, warn, but do not return - just reset the
3926 buffer to empty and go on to disable features. */
3927 if (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_qSupported
])
3930 warning (_("Remote failure reply: %s"), rs
->buf
);
3935 memset (seen
, 0, sizeof (seen
));
3940 enum packet_support is_supported
;
3941 char *p
, *end
, *name_end
, *value
;
3943 /* First separate out this item from the rest of the packet. If
3944 there's another item after this, we overwrite the separator
3945 (terminated strings are much easier to work with). */
3947 end
= strchr (p
, ';');
3950 end
= p
+ strlen (p
);
3960 warning (_("empty item in \"qSupported\" response"));
3965 name_end
= strchr (p
, '=');
3968 /* This is a name=value entry. */
3969 is_supported
= PACKET_ENABLE
;
3970 value
= name_end
+ 1;
3979 is_supported
= PACKET_ENABLE
;
3983 is_supported
= PACKET_DISABLE
;
3987 is_supported
= PACKET_SUPPORT_UNKNOWN
;
3991 warning (_("unrecognized item \"%s\" "
3992 "in \"qSupported\" response"), p
);
3998 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
3999 if (strcmp (remote_protocol_features
[i
].name
, p
) == 0)
4001 const struct protocol_feature
*feature
;
4004 feature
= &remote_protocol_features
[i
];
4005 feature
->func (feature
, is_supported
, value
);
4010 /* If we increased the packet size, make sure to increase the global
4011 buffer size also. We delay this until after parsing the entire
4012 qSupported packet, because this is the same buffer we were
4014 if (rs
->buf_size
< rs
->explicit_packet_size
)
4016 rs
->buf_size
= rs
->explicit_packet_size
;
4017 rs
->buf
= xrealloc (rs
->buf
, rs
->buf_size
);
4020 /* Handle the defaults for unmentioned features. */
4021 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
4024 const struct protocol_feature
*feature
;
4026 feature
= &remote_protocol_features
[i
];
4027 feature
->func (feature
, feature
->default_support
, NULL
);
4033 remote_open_1 (char *name
, int from_tty
,
4034 struct target_ops
*target
, int extended_p
)
4036 struct remote_state
*rs
= get_remote_state ();
4039 error (_("To open a remote debug connection, you need to specify what\n"
4040 "serial device is attached to the remote system\n"
4041 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
4043 /* See FIXME above. */
4044 if (!target_async_permitted
)
4045 wait_forever_enabled_p
= 1;
4047 /* If we're connected to a running target, target_preopen will kill it.
4048 But if we're connected to a target system with no running process,
4049 then we will still be connected when it returns. Ask this question
4050 first, before target_preopen has a chance to kill anything. */
4051 if (remote_desc
!= NULL
&& !have_inferiors ())
4054 || query (_("Already connected to a remote target. Disconnect? ")))
4057 error (_("Still connected."));
4060 target_preopen (from_tty
);
4062 unpush_target (target
);
4064 /* This time without a query. If we were connected to an
4065 extended-remote target and target_preopen killed the running
4066 process, we may still be connected. If we are starting "target
4067 remote" now, the extended-remote target will not have been
4068 removed by unpush_target. */
4069 if (remote_desc
!= NULL
&& !have_inferiors ())
4072 /* Make sure we send the passed signals list the next time we resume. */
4073 xfree (last_pass_packet
);
4074 last_pass_packet
= NULL
;
4076 remote_fileio_reset ();
4077 reopen_exec_file ();
4080 remote_desc
= remote_serial_open (name
);
4082 perror_with_name (name
);
4084 if (baud_rate
!= -1)
4086 if (serial_setbaudrate (remote_desc
, baud_rate
))
4088 /* The requested speed could not be set. Error out to
4089 top level after closing remote_desc. Take care to
4090 set remote_desc to NULL to avoid closing remote_desc
4092 serial_close (remote_desc
);
4094 perror_with_name (name
);
4098 serial_raw (remote_desc
);
4100 /* If there is something sitting in the buffer we might take it as a
4101 response to a command, which would be bad. */
4102 serial_flush_input (remote_desc
);
4106 puts_filtered ("Remote debugging using ");
4107 puts_filtered (name
);
4108 puts_filtered ("\n");
4110 push_target (target
); /* Switch to using remote target now. */
4112 /* Register extra event sources in the event loop. */
4113 remote_async_inferior_event_token
4114 = create_async_event_handler (remote_async_inferior_event_handler
,
4116 remote_async_get_pending_events_token
4117 = create_async_event_handler (remote_async_get_pending_events_handler
,
4120 /* Reset the target state; these things will be queried either by
4121 remote_query_supported or as they are needed. */
4122 init_all_packet_configs ();
4123 rs
->cached_wait_status
= 0;
4124 rs
->explicit_packet_size
= 0;
4126 rs
->multi_process_aware
= 0;
4127 rs
->extended
= extended_p
;
4128 rs
->non_stop_aware
= 0;
4129 rs
->waiting_for_stop_reply
= 0;
4130 rs
->ctrlc_pending_p
= 0;
4132 general_thread
= not_sent_ptid
;
4133 continue_thread
= not_sent_ptid
;
4134 remote_traceframe_number
= -1;
4136 /* Probe for ability to use "ThreadInfo" query, as required. */
4137 use_threadinfo_query
= 1;
4138 use_threadextra_query
= 1;
4140 if (target_async_permitted
)
4142 /* With this target we start out by owning the terminal. */
4143 remote_async_terminal_ours_p
= 1;
4145 /* FIXME: cagney/1999-09-23: During the initial connection it is
4146 assumed that the target is already ready and able to respond to
4147 requests. Unfortunately remote_start_remote() eventually calls
4148 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
4149 around this. Eventually a mechanism that allows
4150 wait_for_inferior() to expect/get timeouts will be
4152 wait_forever_enabled_p
= 0;
4155 /* First delete any symbols previously loaded from shared libraries. */
4156 no_shared_libraries (NULL
, 0);
4159 init_thread_list ();
4161 /* Start the remote connection. If error() or QUIT, discard this
4162 target (we'd otherwise be in an inconsistent state) and then
4163 propogate the error on up the exception chain. This ensures that
4164 the caller doesn't stumble along blindly assuming that the
4165 function succeeded. The CLI doesn't have this problem but other
4166 UI's, such as MI do.
4168 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
4169 this function should return an error indication letting the
4170 caller restore the previous state. Unfortunately the command
4171 ``target remote'' is directly wired to this function making that
4172 impossible. On a positive note, the CLI side of this problem has
4173 been fixed - the function set_cmd_context() makes it possible for
4174 all the ``target ....'' commands to share a common callback
4175 function. See cli-dump.c. */
4177 volatile struct gdb_exception ex
;
4179 TRY_CATCH (ex
, RETURN_MASK_ALL
)
4181 remote_start_remote (from_tty
, target
, extended_p
);
4185 /* Pop the partially set up target - unless something else did
4186 already before throwing the exception. */
4187 if (remote_desc
!= NULL
)
4189 if (target_async_permitted
)
4190 wait_forever_enabled_p
= 1;
4191 throw_exception (ex
);
4195 if (target_async_permitted
)
4196 wait_forever_enabled_p
= 1;
4199 /* This takes a program previously attached to and detaches it. After
4200 this is done, GDB can be used to debug some other program. We
4201 better not have left any breakpoints in the target program or it'll
4202 die when it hits one. */
4205 remote_detach_1 (char *args
, int from_tty
, int extended
)
4207 int pid
= ptid_get_pid (inferior_ptid
);
4208 struct remote_state
*rs
= get_remote_state ();
4211 error (_("Argument given to \"detach\" when remotely debugging."));
4213 if (!target_has_execution
)
4214 error (_("No process to detach from."));
4218 char *exec_file
= get_exec_file (0);
4219 if (exec_file
== NULL
)
4221 printf_unfiltered (_("Detaching from program: %s, %s\n"), exec_file
,
4222 target_pid_to_str (pid_to_ptid (pid
)));
4223 gdb_flush (gdb_stdout
);
4226 /* Tell the remote target to detach. */
4227 if (remote_multi_process_p (rs
))
4228 sprintf (rs
->buf
, "D;%x", pid
);
4230 strcpy (rs
->buf
, "D");
4233 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4235 if (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K')
4237 else if (rs
->buf
[0] == '\0')
4238 error (_("Remote doesn't know how to detach"));
4240 error (_("Can't detach process."));
4242 if (from_tty
&& !extended
)
4243 puts_filtered (_("Ending remote debugging.\n"));
4245 discard_pending_stop_replies (pid
);
4246 target_mourn_inferior ();
4250 remote_detach (struct target_ops
*ops
, char *args
, int from_tty
)
4252 remote_detach_1 (args
, from_tty
, 0);
4256 extended_remote_detach (struct target_ops
*ops
, char *args
, int from_tty
)
4258 remote_detach_1 (args
, from_tty
, 1);
4261 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
4264 remote_disconnect (struct target_ops
*target
, char *args
, int from_tty
)
4267 error (_("Argument given to \"disconnect\" when remotely debugging."));
4269 /* Make sure we unpush even the extended remote targets; mourn
4270 won't do it. So call remote_mourn_1 directly instead of
4271 target_mourn_inferior. */
4272 remote_mourn_1 (target
);
4275 puts_filtered ("Ending remote debugging.\n");
4278 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
4279 be chatty about it. */
4282 extended_remote_attach_1 (struct target_ops
*target
, char *args
, int from_tty
)
4284 struct remote_state
*rs
= get_remote_state ();
4286 char *wait_status
= NULL
;
4288 pid
= parse_pid_to_attach (args
);
4290 /* Remote PID can be freely equal to getpid, do not check it here the same
4291 way as in other targets. */
4293 if (remote_protocol_packets
[PACKET_vAttach
].support
== PACKET_DISABLE
)
4294 error (_("This target does not support attaching to a process"));
4298 char *exec_file
= get_exec_file (0);
4301 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file
,
4302 target_pid_to_str (pid_to_ptid (pid
)));
4304 printf_unfiltered (_("Attaching to %s\n"),
4305 target_pid_to_str (pid_to_ptid (pid
)));
4307 gdb_flush (gdb_stdout
);
4310 sprintf (rs
->buf
, "vAttach;%x", pid
);
4312 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4314 if (packet_ok (rs
->buf
,
4315 &remote_protocol_packets
[PACKET_vAttach
]) == PACKET_OK
)
4319 /* Save the reply for later. */
4320 wait_status
= alloca (strlen (rs
->buf
) + 1);
4321 strcpy (wait_status
, rs
->buf
);
4323 else if (strcmp (rs
->buf
, "OK") != 0)
4324 error (_("Attaching to %s failed with: %s"),
4325 target_pid_to_str (pid_to_ptid (pid
)),
4328 else if (remote_protocol_packets
[PACKET_vAttach
].support
== PACKET_DISABLE
)
4329 error (_("This target does not support attaching to a process"));
4331 error (_("Attaching to %s failed"),
4332 target_pid_to_str (pid_to_ptid (pid
)));
4334 set_current_inferior (remote_add_inferior (0, pid
, 1));
4336 inferior_ptid
= pid_to_ptid (pid
);
4340 struct thread_info
*thread
;
4342 /* Get list of threads. */
4343 remote_threads_info (target
);
4345 thread
= first_thread_of_process (pid
);
4347 inferior_ptid
= thread
->ptid
;
4349 inferior_ptid
= pid_to_ptid (pid
);
4351 /* Invalidate our notion of the remote current thread. */
4352 record_currthread (minus_one_ptid
);
4356 /* Now, if we have thread information, update inferior_ptid. */
4357 inferior_ptid
= remote_current_thread (inferior_ptid
);
4359 /* Add the main thread to the thread list. */
4360 add_thread_silent (inferior_ptid
);
4363 /* Next, if the target can specify a description, read it. We do
4364 this before anything involving memory or registers. */
4365 target_find_description ();
4369 /* Use the previously fetched status. */
4370 gdb_assert (wait_status
!= NULL
);
4372 if (target_can_async_p ())
4374 struct stop_reply
*stop_reply
;
4375 struct cleanup
*old_chain
;
4377 stop_reply
= stop_reply_xmalloc ();
4378 old_chain
= make_cleanup (do_stop_reply_xfree
, stop_reply
);
4379 remote_parse_stop_reply (wait_status
, stop_reply
);
4380 discard_cleanups (old_chain
);
4381 push_stop_reply (stop_reply
);
4383 target_async (inferior_event_handler
, 0);
4387 gdb_assert (wait_status
!= NULL
);
4388 strcpy (rs
->buf
, wait_status
);
4389 rs
->cached_wait_status
= 1;
4393 gdb_assert (wait_status
== NULL
);
4397 extended_remote_attach (struct target_ops
*ops
, char *args
, int from_tty
)
4399 extended_remote_attach_1 (ops
, args
, from_tty
);
4402 /* Convert hex digit A to a number. */
4407 if (a
>= '0' && a
<= '9')
4409 else if (a
>= 'a' && a
<= 'f')
4410 return a
- 'a' + 10;
4411 else if (a
>= 'A' && a
<= 'F')
4412 return a
- 'A' + 10;
4414 error (_("Reply contains invalid hex digit %d"), a
);
4418 hex2bin (const char *hex
, gdb_byte
*bin
, int count
)
4422 for (i
= 0; i
< count
; i
++)
4424 if (hex
[0] == 0 || hex
[1] == 0)
4426 /* Hex string is short, or of uneven length.
4427 Return the count that has been converted so far. */
4430 *bin
++ = fromhex (hex
[0]) * 16 + fromhex (hex
[1]);
4436 /* Convert number NIB to a hex digit. */
4444 return 'a' + nib
- 10;
4448 bin2hex (const gdb_byte
*bin
, char *hex
, int count
)
4452 /* May use a length, or a nul-terminated string as input. */
4454 count
= strlen ((char *) bin
);
4456 for (i
= 0; i
< count
; i
++)
4458 *hex
++ = tohex ((*bin
>> 4) & 0xf);
4459 *hex
++ = tohex (*bin
++ & 0xf);
4465 /* Check for the availability of vCont. This function should also check
4469 remote_vcont_probe (struct remote_state
*rs
)
4473 strcpy (rs
->buf
, "vCont?");
4475 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4478 /* Make sure that the features we assume are supported. */
4479 if (strncmp (buf
, "vCont", 5) == 0)
4482 int support_s
, support_S
, support_c
, support_C
;
4488 rs
->support_vCont_t
= 0;
4489 while (p
&& *p
== ';')
4492 if (*p
== 's' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4494 else if (*p
== 'S' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4496 else if (*p
== 'c' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4498 else if (*p
== 'C' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4500 else if (*p
== 't' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4501 rs
->support_vCont_t
= 1;
4503 p
= strchr (p
, ';');
4506 /* If s, S, c, and C are not all supported, we can't use vCont. Clearing
4507 BUF will make packet_ok disable the packet. */
4508 if (!support_s
|| !support_S
|| !support_c
|| !support_C
)
4512 packet_ok (buf
, &remote_protocol_packets
[PACKET_vCont
]);
4515 /* Helper function for building "vCont" resumptions. Write a
4516 resumption to P. ENDP points to one-passed-the-end of the buffer
4517 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
4518 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
4519 resumed thread should be single-stepped and/or signalled. If PTID
4520 equals minus_one_ptid, then all threads are resumed; if PTID
4521 represents a process, then all threads of the process are resumed;
4522 the thread to be stepped and/or signalled is given in the global
4526 append_resumption (char *p
, char *endp
,
4527 ptid_t ptid
, int step
, enum target_signal siggnal
)
4529 struct remote_state
*rs
= get_remote_state ();
4531 if (step
&& siggnal
!= TARGET_SIGNAL_0
)
4532 p
+= xsnprintf (p
, endp
- p
, ";S%02x", siggnal
);
4534 p
+= xsnprintf (p
, endp
- p
, ";s");
4535 else if (siggnal
!= TARGET_SIGNAL_0
)
4536 p
+= xsnprintf (p
, endp
- p
, ";C%02x", siggnal
);
4538 p
+= xsnprintf (p
, endp
- p
, ";c");
4540 if (remote_multi_process_p (rs
) && ptid_is_pid (ptid
))
4544 /* All (-1) threads of process. */
4545 nptid
= ptid_build (ptid_get_pid (ptid
), 0, -1);
4547 p
+= xsnprintf (p
, endp
- p
, ":");
4548 p
= write_ptid (p
, endp
, nptid
);
4550 else if (!ptid_equal (ptid
, minus_one_ptid
))
4552 p
+= xsnprintf (p
, endp
- p
, ":");
4553 p
= write_ptid (p
, endp
, ptid
);
4559 /* Resume the remote inferior by using a "vCont" packet. The thread
4560 to be resumed is PTID; STEP and SIGGNAL indicate whether the
4561 resumed thread should be single-stepped and/or signalled. If PTID
4562 equals minus_one_ptid, then all threads are resumed; the thread to
4563 be stepped and/or signalled is given in the global INFERIOR_PTID.
4564 This function returns non-zero iff it resumes the inferior.
4566 This function issues a strict subset of all possible vCont commands at the
4570 remote_vcont_resume (ptid_t ptid
, int step
, enum target_signal siggnal
)
4572 struct remote_state
*rs
= get_remote_state ();
4576 if (remote_protocol_packets
[PACKET_vCont
].support
== PACKET_SUPPORT_UNKNOWN
)
4577 remote_vcont_probe (rs
);
4579 if (remote_protocol_packets
[PACKET_vCont
].support
== PACKET_DISABLE
)
4583 endp
= rs
->buf
+ get_remote_packet_size ();
4585 /* If we could generate a wider range of packets, we'd have to worry
4586 about overflowing BUF. Should there be a generic
4587 "multi-part-packet" packet? */
4589 p
+= xsnprintf (p
, endp
- p
, "vCont");
4591 if (ptid_equal (ptid
, magic_null_ptid
))
4593 /* MAGIC_NULL_PTID means that we don't have any active threads,
4594 so we don't have any TID numbers the inferior will
4595 understand. Make sure to only send forms that do not specify
4597 append_resumption (p
, endp
, minus_one_ptid
, step
, siggnal
);
4599 else if (ptid_equal (ptid
, minus_one_ptid
) || ptid_is_pid (ptid
))
4601 /* Resume all threads (of all processes, or of a single
4602 process), with preference for INFERIOR_PTID. This assumes
4603 inferior_ptid belongs to the set of all threads we are about
4605 if (step
|| siggnal
!= TARGET_SIGNAL_0
)
4607 /* Step inferior_ptid, with or without signal. */
4608 p
= append_resumption (p
, endp
, inferior_ptid
, step
, siggnal
);
4611 /* And continue others without a signal. */
4612 append_resumption (p
, endp
, ptid
, /*step=*/ 0, TARGET_SIGNAL_0
);
4616 /* Scheduler locking; resume only PTID. */
4617 append_resumption (p
, endp
, ptid
, step
, siggnal
);
4620 gdb_assert (strlen (rs
->buf
) < get_remote_packet_size ());
4625 /* In non-stop, the stub replies to vCont with "OK". The stop
4626 reply will be reported asynchronously by means of a `%Stop'
4628 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4629 if (strcmp (rs
->buf
, "OK") != 0)
4630 error (_("Unexpected vCont reply in non-stop mode: %s"), rs
->buf
);
4636 /* Tell the remote machine to resume. */
4638 static enum target_signal last_sent_signal
= TARGET_SIGNAL_0
;
4640 static int last_sent_step
;
4643 remote_resume (struct target_ops
*ops
,
4644 ptid_t ptid
, int step
, enum target_signal siggnal
)
4646 struct remote_state
*rs
= get_remote_state ();
4649 last_sent_signal
= siggnal
;
4650 last_sent_step
= step
;
4652 /* The vCont packet doesn't need to specify threads via Hc. */
4653 /* No reverse support (yet) for vCont. */
4654 if (execution_direction
!= EXEC_REVERSE
)
4655 if (remote_vcont_resume (ptid
, step
, siggnal
))
4658 /* All other supported resume packets do use Hc, so set the continue
4660 if (ptid_equal (ptid
, minus_one_ptid
))
4661 set_continue_thread (any_thread_ptid
);
4663 set_continue_thread (ptid
);
4666 if (execution_direction
== EXEC_REVERSE
)
4668 /* We don't pass signals to the target in reverse exec mode. */
4669 if (info_verbose
&& siggnal
!= TARGET_SIGNAL_0
)
4670 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
4674 && remote_protocol_packets
[PACKET_bs
].support
== PACKET_DISABLE
)
4675 error (_("Remote reverse-step not supported."));
4677 && remote_protocol_packets
[PACKET_bc
].support
== PACKET_DISABLE
)
4678 error (_("Remote reverse-continue not supported."));
4680 strcpy (buf
, step
? "bs" : "bc");
4682 else if (siggnal
!= TARGET_SIGNAL_0
)
4684 buf
[0] = step
? 'S' : 'C';
4685 buf
[1] = tohex (((int) siggnal
>> 4) & 0xf);
4686 buf
[2] = tohex (((int) siggnal
) & 0xf);
4690 strcpy (buf
, step
? "s" : "c");
4695 /* We are about to start executing the inferior, let's register it
4696 with the event loop. NOTE: this is the one place where all the
4697 execution commands end up. We could alternatively do this in each
4698 of the execution commands in infcmd.c. */
4699 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
4700 into infcmd.c in order to allow inferior function calls to work
4701 NOT asynchronously. */
4702 if (target_can_async_p ())
4703 target_async (inferior_event_handler
, 0);
4705 /* We've just told the target to resume. The remote server will
4706 wait for the inferior to stop, and then send a stop reply. In
4707 the mean time, we can't start another command/query ourselves
4708 because the stub wouldn't be ready to process it. This applies
4709 only to the base all-stop protocol, however. In non-stop (which
4710 only supports vCont), the stub replies with an "OK", and is
4711 immediate able to process further serial input. */
4713 rs
->waiting_for_stop_reply
= 1;
4717 /* Set up the signal handler for SIGINT, while the target is
4718 executing, ovewriting the 'regular' SIGINT signal handler. */
4720 initialize_sigint_signal_handler (void)
4722 signal (SIGINT
, handle_remote_sigint
);
4725 /* Signal handler for SIGINT, while the target is executing. */
4727 handle_remote_sigint (int sig
)
4729 signal (sig
, handle_remote_sigint_twice
);
4730 mark_async_signal_handler_wrapper (sigint_remote_token
);
4733 /* Signal handler for SIGINT, installed after SIGINT has already been
4734 sent once. It will take effect the second time that the user sends
4737 handle_remote_sigint_twice (int sig
)
4739 signal (sig
, handle_remote_sigint
);
4740 mark_async_signal_handler_wrapper (sigint_remote_twice_token
);
4743 /* Perform the real interruption of the target execution, in response
4746 async_remote_interrupt (gdb_client_data arg
)
4749 fprintf_unfiltered (gdb_stdlog
, "remote_interrupt called\n");
4751 target_stop (inferior_ptid
);
4754 /* Perform interrupt, if the first attempt did not succeed. Just give
4755 up on the target alltogether. */
4757 async_remote_interrupt_twice (gdb_client_data arg
)
4760 fprintf_unfiltered (gdb_stdlog
, "remote_interrupt_twice called\n");
4765 /* Reinstall the usual SIGINT handlers, after the target has
4768 cleanup_sigint_signal_handler (void *dummy
)
4770 signal (SIGINT
, handle_sigint
);
4773 /* Send ^C to target to halt it. Target will respond, and send us a
4775 static void (*ofunc
) (int);
4777 /* The command line interface's stop routine. This function is installed
4778 as a signal handler for SIGINT. The first time a user requests a
4779 stop, we call remote_stop to send a break or ^C. If there is no
4780 response from the target (it didn't stop when the user requested it),
4781 we ask the user if he'd like to detach from the target. */
4783 remote_interrupt (int signo
)
4785 /* If this doesn't work, try more severe steps. */
4786 signal (signo
, remote_interrupt_twice
);
4788 gdb_call_async_signal_handler (sigint_remote_token
, 1);
4791 /* The user typed ^C twice. */
4794 remote_interrupt_twice (int signo
)
4796 signal (signo
, ofunc
);
4797 gdb_call_async_signal_handler (sigint_remote_twice_token
, 1);
4798 signal (signo
, remote_interrupt
);
4801 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
4802 thread, all threads of a remote process, or all threads of all
4806 remote_stop_ns (ptid_t ptid
)
4808 struct remote_state
*rs
= get_remote_state ();
4810 char *endp
= rs
->buf
+ get_remote_packet_size ();
4812 if (remote_protocol_packets
[PACKET_vCont
].support
== PACKET_SUPPORT_UNKNOWN
)
4813 remote_vcont_probe (rs
);
4815 if (!rs
->support_vCont_t
)
4816 error (_("Remote server does not support stopping threads"));
4818 if (ptid_equal (ptid
, minus_one_ptid
)
4819 || (!remote_multi_process_p (rs
) && ptid_is_pid (ptid
)))
4820 p
+= xsnprintf (p
, endp
- p
, "vCont;t");
4825 p
+= xsnprintf (p
, endp
- p
, "vCont;t:");
4827 if (ptid_is_pid (ptid
))
4828 /* All (-1) threads of process. */
4829 nptid
= ptid_build (ptid_get_pid (ptid
), 0, -1);
4832 /* Small optimization: if we already have a stop reply for
4833 this thread, no use in telling the stub we want this
4835 if (peek_stop_reply (ptid
))
4841 write_ptid (p
, endp
, nptid
);
4844 /* In non-stop, we get an immediate OK reply. The stop reply will
4845 come in asynchronously by notification. */
4847 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4848 if (strcmp (rs
->buf
, "OK") != 0)
4849 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid
), rs
->buf
);
4852 /* All-stop version of target_stop. Sends a break or a ^C to stop the
4853 remote target. It is undefined which thread of which process
4854 reports the stop. */
4857 remote_stop_as (ptid_t ptid
)
4859 struct remote_state
*rs
= get_remote_state ();
4861 rs
->ctrlc_pending_p
= 1;
4863 /* If the inferior is stopped already, but the core didn't know
4864 about it yet, just ignore the request. The cached wait status
4865 will be collected in remote_wait. */
4866 if (rs
->cached_wait_status
)
4869 /* Send interrupt_sequence to remote target. */
4870 send_interrupt_sequence ();
4873 /* This is the generic stop called via the target vector. When a target
4874 interrupt is requested, either by the command line or the GUI, we
4875 will eventually end up here. */
4878 remote_stop (ptid_t ptid
)
4881 fprintf_unfiltered (gdb_stdlog
, "remote_stop called\n");
4884 remote_stop_ns (ptid
);
4886 remote_stop_as (ptid
);
4889 /* Ask the user what to do when an interrupt is received. */
4892 interrupt_query (void)
4894 target_terminal_ours ();
4896 if (target_can_async_p ())
4898 signal (SIGINT
, handle_sigint
);
4899 deprecated_throw_reason (RETURN_QUIT
);
4903 if (query (_("Interrupted while waiting for the program.\n\
4904 Give up (and stop debugging it)? ")))
4907 deprecated_throw_reason (RETURN_QUIT
);
4911 target_terminal_inferior ();
4914 /* Enable/disable target terminal ownership. Most targets can use
4915 terminal groups to control terminal ownership. Remote targets are
4916 different in that explicit transfer of ownership to/from GDB/target
4920 remote_terminal_inferior (void)
4922 if (!target_async_permitted
)
4923 /* Nothing to do. */
4926 /* FIXME: cagney/1999-09-27: Make calls to target_terminal_*()
4927 idempotent. The event-loop GDB talking to an asynchronous target
4928 with a synchronous command calls this function from both
4929 event-top.c and infrun.c/infcmd.c. Once GDB stops trying to
4930 transfer the terminal to the target when it shouldn't this guard
4932 if (!remote_async_terminal_ours_p
)
4934 delete_file_handler (input_fd
);
4935 remote_async_terminal_ours_p
= 0;
4936 initialize_sigint_signal_handler ();
4937 /* NOTE: At this point we could also register our selves as the
4938 recipient of all input. Any characters typed could then be
4939 passed on down to the target. */
4943 remote_terminal_ours (void)
4945 if (!target_async_permitted
)
4946 /* Nothing to do. */
4949 /* See FIXME in remote_terminal_inferior. */
4950 if (remote_async_terminal_ours_p
)
4952 cleanup_sigint_signal_handler (NULL
);
4953 add_file_handler (input_fd
, stdin_event_handler
, 0);
4954 remote_async_terminal_ours_p
= 1;
4958 remote_console_output (char *msg
)
4962 for (p
= msg
; p
[0] && p
[1]; p
+= 2)
4965 char c
= fromhex (p
[0]) * 16 + fromhex (p
[1]);
4969 fputs_unfiltered (tb
, gdb_stdtarg
);
4971 gdb_flush (gdb_stdtarg
);
4974 typedef struct cached_reg
4977 gdb_byte data
[MAX_REGISTER_SIZE
];
4980 DEF_VEC_O(cached_reg_t
);
4984 struct stop_reply
*next
;
4988 struct target_waitstatus ws
;
4990 /* Expedited registers. This makes remote debugging a bit more
4991 efficient for those targets that provide critical registers as
4992 part of their normal status mechanism (as another roundtrip to
4993 fetch them is avoided). */
4994 VEC(cached_reg_t
) *regcache
;
4996 int stopped_by_watchpoint_p
;
4997 CORE_ADDR watch_data_address
;
5005 /* The list of already fetched and acknowledged stop events. */
5006 static struct stop_reply
*stop_reply_queue
;
5008 static struct stop_reply
*
5009 stop_reply_xmalloc (void)
5011 struct stop_reply
*r
= XMALLOC (struct stop_reply
);
5018 stop_reply_xfree (struct stop_reply
*r
)
5022 VEC_free (cached_reg_t
, r
->regcache
);
5027 /* Discard all pending stop replies of inferior PID. If PID is -1,
5028 discard everything. */
5031 discard_pending_stop_replies (int pid
)
5033 struct stop_reply
*prev
= NULL
, *reply
, *next
;
5035 /* Discard the in-flight notification. */
5036 if (pending_stop_reply
!= NULL
5038 || ptid_get_pid (pending_stop_reply
->ptid
) == pid
))
5040 stop_reply_xfree (pending_stop_reply
);
5041 pending_stop_reply
= NULL
;
5044 /* Discard the stop replies we have already pulled with
5046 for (reply
= stop_reply_queue
; reply
; reply
= next
)
5050 || ptid_get_pid (reply
->ptid
) == pid
)
5052 if (reply
== stop_reply_queue
)
5053 stop_reply_queue
= reply
->next
;
5055 prev
->next
= reply
->next
;
5057 stop_reply_xfree (reply
);
5064 /* Cleanup wrapper. */
5067 do_stop_reply_xfree (void *arg
)
5069 struct stop_reply
*r
= arg
;
5071 stop_reply_xfree (r
);
5074 /* Look for a queued stop reply belonging to PTID. If one is found,
5075 remove it from the queue, and return it. Returns NULL if none is
5076 found. If there are still queued events left to process, tell the
5077 event loop to get back to target_wait soon. */
5079 static struct stop_reply
*
5080 queued_stop_reply (ptid_t ptid
)
5082 struct stop_reply
*it
;
5083 struct stop_reply
**it_link
;
5085 it
= stop_reply_queue
;
5086 it_link
= &stop_reply_queue
;
5089 if (ptid_match (it
->ptid
, ptid
))
5091 *it_link
= it
->next
;
5096 it_link
= &it
->next
;
5100 if (stop_reply_queue
)
5101 /* There's still at least an event left. */
5102 mark_async_event_handler (remote_async_inferior_event_token
);
5107 /* Push a fully parsed stop reply in the stop reply queue. Since we
5108 know that we now have at least one queued event left to pass to the
5109 core side, tell the event loop to get back to target_wait soon. */
5112 push_stop_reply (struct stop_reply
*new_event
)
5114 struct stop_reply
*event
;
5116 if (stop_reply_queue
)
5118 for (event
= stop_reply_queue
;
5119 event
&& event
->next
;
5120 event
= event
->next
)
5123 event
->next
= new_event
;
5126 stop_reply_queue
= new_event
;
5128 mark_async_event_handler (remote_async_inferior_event_token
);
5131 /* Returns true if we have a stop reply for PTID. */
5134 peek_stop_reply (ptid_t ptid
)
5136 struct stop_reply
*it
;
5138 for (it
= stop_reply_queue
; it
; it
= it
->next
)
5139 if (ptid_equal (ptid
, it
->ptid
))
5141 if (it
->ws
.kind
== TARGET_WAITKIND_STOPPED
)
5148 /* Parse the stop reply in BUF. Either the function succeeds, and the
5149 result is stored in EVENT, or throws an error. */
5152 remote_parse_stop_reply (char *buf
, struct stop_reply
*event
)
5154 struct remote_arch_state
*rsa
= get_remote_arch_state ();
5158 event
->ptid
= null_ptid
;
5159 event
->ws
.kind
= TARGET_WAITKIND_IGNORE
;
5160 event
->ws
.value
.integer
= 0;
5161 event
->solibs_changed
= 0;
5162 event
->replay_event
= 0;
5163 event
->stopped_by_watchpoint_p
= 0;
5164 event
->regcache
= NULL
;
5169 case 'T': /* Status with PC, SP, FP, ... */
5170 /* Expedited reply, containing Signal, {regno, reg} repeat. */
5171 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
5173 n... = register number
5174 r... = register contents
5177 p
= &buf
[3]; /* after Txx */
5185 /* If the packet contains a register number, save it in
5186 pnum and set p1 to point to the character following it.
5187 Otherwise p1 points to p. */
5189 /* If this packet is an awatch packet, don't parse the 'a'
5190 as a register number. */
5192 if (strncmp (p
, "awatch", strlen("awatch")) != 0
5193 && strncmp (p
, "core", strlen ("core") != 0))
5195 /* Read the ``P'' register number. */
5196 pnum
= strtol (p
, &p_temp
, 16);
5202 if (p1
== p
) /* No register number present here. */
5204 p1
= strchr (p
, ':');
5206 error (_("Malformed packet(a) (missing colon): %s\n\
5209 if (strncmp (p
, "thread", p1
- p
) == 0)
5210 event
->ptid
= read_ptid (++p1
, &p
);
5211 else if ((strncmp (p
, "watch", p1
- p
) == 0)
5212 || (strncmp (p
, "rwatch", p1
- p
) == 0)
5213 || (strncmp (p
, "awatch", p1
- p
) == 0))
5215 event
->stopped_by_watchpoint_p
= 1;
5216 p
= unpack_varlen_hex (++p1
, &addr
);
5217 event
->watch_data_address
= (CORE_ADDR
) addr
;
5219 else if (strncmp (p
, "library", p1
- p
) == 0)
5223 while (*p_temp
&& *p_temp
!= ';')
5226 event
->solibs_changed
= 1;
5229 else if (strncmp (p
, "replaylog", p1
- p
) == 0)
5231 /* NO_HISTORY event.
5232 p1 will indicate "begin" or "end", but
5233 it makes no difference for now, so ignore it. */
5234 event
->replay_event
= 1;
5235 p_temp
= strchr (p1
+ 1, ';');
5239 else if (strncmp (p
, "core", p1
- p
) == 0)
5243 p
= unpack_varlen_hex (++p1
, &c
);
5248 /* Silently skip unknown optional info. */
5249 p_temp
= strchr (p1
+ 1, ';');
5256 struct packet_reg
*reg
= packet_reg_from_pnum (rsa
, pnum
);
5257 cached_reg_t cached_reg
;
5262 error (_("Malformed packet(b) (missing colon): %s\n\
5268 error (_("Remote sent bad register number %s: %s\n\
5270 hex_string (pnum
), p
, buf
);
5272 cached_reg
.num
= reg
->regnum
;
5274 fieldsize
= hex2bin (p
, cached_reg
.data
,
5275 register_size (target_gdbarch
,
5278 if (fieldsize
< register_size (target_gdbarch
,
5280 warning (_("Remote reply is too short: %s"), buf
);
5282 VEC_safe_push (cached_reg_t
, event
->regcache
, &cached_reg
);
5286 error (_("Remote register badly formatted: %s\nhere: %s"),
5291 case 'S': /* Old style status, just signal only. */
5292 if (event
->solibs_changed
)
5293 event
->ws
.kind
= TARGET_WAITKIND_LOADED
;
5294 else if (event
->replay_event
)
5295 event
->ws
.kind
= TARGET_WAITKIND_NO_HISTORY
;
5298 event
->ws
.kind
= TARGET_WAITKIND_STOPPED
;
5299 event
->ws
.value
.sig
= (enum target_signal
)
5300 (((fromhex (buf
[1])) << 4) + (fromhex (buf
[2])));
5303 case 'W': /* Target exited. */
5310 /* GDB used to accept only 2 hex chars here. Stubs should
5311 only send more if they detect GDB supports multi-process
5313 p
= unpack_varlen_hex (&buf
[1], &value
);
5317 /* The remote process exited. */
5318 event
->ws
.kind
= TARGET_WAITKIND_EXITED
;
5319 event
->ws
.value
.integer
= value
;
5323 /* The remote process exited with a signal. */
5324 event
->ws
.kind
= TARGET_WAITKIND_SIGNALLED
;
5325 event
->ws
.value
.sig
= (enum target_signal
) value
;
5328 /* If no process is specified, assume inferior_ptid. */
5329 pid
= ptid_get_pid (inferior_ptid
);
5338 else if (strncmp (p
,
5339 "process:", sizeof ("process:") - 1) == 0)
5343 p
+= sizeof ("process:") - 1;
5344 unpack_varlen_hex (p
, &upid
);
5348 error (_("unknown stop reply packet: %s"), buf
);
5351 error (_("unknown stop reply packet: %s"), buf
);
5352 event
->ptid
= pid_to_ptid (pid
);
5357 if (non_stop
&& ptid_equal (event
->ptid
, null_ptid
))
5358 error (_("No process or thread specified in stop reply: %s"), buf
);
5361 /* When the stub wants to tell GDB about a new stop reply, it sends a
5362 stop notification (%Stop). Those can come it at any time, hence,
5363 we have to make sure that any pending putpkt/getpkt sequence we're
5364 making is finished, before querying the stub for more events with
5365 vStopped. E.g., if we started a vStopped sequence immediatelly
5366 upon receiving the %Stop notification, something like this could
5374 1.6) <-- (registers reply to step #1.3)
5376 Obviously, the reply in step #1.6 would be unexpected to a vStopped
5379 To solve this, whenever we parse a %Stop notification sucessfully,
5380 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
5381 doing whatever we were doing:
5387 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
5388 2.5) <-- (registers reply to step #2.3)
5390 Eventualy after step #2.5, we return to the event loop, which
5391 notices there's an event on the
5392 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
5393 associated callback --- the function below. At this point, we're
5394 always safe to start a vStopped sequence. :
5397 2.7) <-- T05 thread:2
5403 remote_get_pending_stop_replies (void)
5405 struct remote_state
*rs
= get_remote_state ();
5407 if (pending_stop_reply
)
5410 putpkt ("vStopped");
5412 /* Now we can rely on it. */
5413 push_stop_reply (pending_stop_reply
);
5414 pending_stop_reply
= NULL
;
5418 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
5419 if (strcmp (rs
->buf
, "OK") == 0)
5423 struct cleanup
*old_chain
;
5424 struct stop_reply
*stop_reply
= stop_reply_xmalloc ();
5426 old_chain
= make_cleanup (do_stop_reply_xfree
, stop_reply
);
5427 remote_parse_stop_reply (rs
->buf
, stop_reply
);
5430 putpkt ("vStopped");
5432 if (stop_reply
->ws
.kind
!= TARGET_WAITKIND_IGNORE
)
5434 /* Now we can rely on it. */
5435 discard_cleanups (old_chain
);
5436 push_stop_reply (stop_reply
);
5439 /* We got an unknown stop reply. */
5440 do_cleanups (old_chain
);
5447 /* Called when it is decided that STOP_REPLY holds the info of the
5448 event that is to be returned to the core. This function always
5449 destroys STOP_REPLY. */
5452 process_stop_reply (struct stop_reply
*stop_reply
,
5453 struct target_waitstatus
*status
)
5457 *status
= stop_reply
->ws
;
5458 ptid
= stop_reply
->ptid
;
5460 /* If no thread/process was reported by the stub, assume the current
5462 if (ptid_equal (ptid
, null_ptid
))
5463 ptid
= inferior_ptid
;
5465 if (status
->kind
!= TARGET_WAITKIND_EXITED
5466 && status
->kind
!= TARGET_WAITKIND_SIGNALLED
)
5468 /* Expedited registers. */
5469 if (stop_reply
->regcache
)
5471 struct regcache
*regcache
5472 = get_thread_arch_regcache (ptid
, target_gdbarch
);
5477 VEC_iterate(cached_reg_t
, stop_reply
->regcache
, ix
, reg
);
5479 regcache_raw_supply (regcache
, reg
->num
, reg
->data
);
5480 VEC_free (cached_reg_t
, stop_reply
->regcache
);
5483 remote_stopped_by_watchpoint_p
= stop_reply
->stopped_by_watchpoint_p
;
5484 remote_watch_data_address
= stop_reply
->watch_data_address
;
5486 remote_notice_new_inferior (ptid
, 0);
5487 demand_private_info (ptid
)->core
= stop_reply
->core
;
5490 stop_reply_xfree (stop_reply
);
5494 /* The non-stop mode version of target_wait. */
5497 remote_wait_ns (ptid_t ptid
, struct target_waitstatus
*status
, int options
)
5499 struct remote_state
*rs
= get_remote_state ();
5500 struct stop_reply
*stop_reply
;
5503 /* If in non-stop mode, get out of getpkt even if a
5504 notification is received. */
5506 ret
= getpkt_or_notif_sane (&rs
->buf
, &rs
->buf_size
,
5513 case 'E': /* Error of some sort. */
5514 /* We're out of sync with the target now. Did it continue
5515 or not? We can't tell which thread it was in non-stop,
5516 so just ignore this. */
5517 warning (_("Remote failure reply: %s"), rs
->buf
);
5519 case 'O': /* Console output. */
5520 remote_console_output (rs
->buf
+ 1);
5523 warning (_("Invalid remote reply: %s"), rs
->buf
);
5527 /* Acknowledge a pending stop reply that may have arrived in the
5529 if (pending_stop_reply
!= NULL
)
5530 remote_get_pending_stop_replies ();
5532 /* If indeed we noticed a stop reply, we're done. */
5533 stop_reply
= queued_stop_reply (ptid
);
5534 if (stop_reply
!= NULL
)
5535 return process_stop_reply (stop_reply
, status
);
5537 /* Still no event. If we're just polling for an event, then
5538 return to the event loop. */
5539 if (options
& TARGET_WNOHANG
)
5541 status
->kind
= TARGET_WAITKIND_IGNORE
;
5542 return minus_one_ptid
;
5545 /* Otherwise do a blocking wait. */
5546 ret
= getpkt_or_notif_sane (&rs
->buf
, &rs
->buf_size
,
5551 /* Wait until the remote machine stops, then return, storing status in
5552 STATUS just as `wait' would. */
5555 remote_wait_as (ptid_t ptid
, struct target_waitstatus
*status
, int options
)
5557 struct remote_state
*rs
= get_remote_state ();
5558 ptid_t event_ptid
= null_ptid
;
5560 struct stop_reply
*stop_reply
;
5564 status
->kind
= TARGET_WAITKIND_IGNORE
;
5565 status
->value
.integer
= 0;
5567 stop_reply
= queued_stop_reply (ptid
);
5568 if (stop_reply
!= NULL
)
5569 return process_stop_reply (stop_reply
, status
);
5571 if (rs
->cached_wait_status
)
5572 /* Use the cached wait status, but only once. */
5573 rs
->cached_wait_status
= 0;
5578 if (!target_is_async_p ())
5580 ofunc
= signal (SIGINT
, remote_interrupt
);
5581 /* If the user hit C-c before this packet, or between packets,
5582 pretend that it was hit right here. */
5586 remote_interrupt (SIGINT
);
5590 /* FIXME: cagney/1999-09-27: If we're in async mode we should
5591 _never_ wait for ever -> test on target_is_async_p().
5592 However, before we do that we need to ensure that the caller
5593 knows how to take the target into/out of async mode. */
5594 ret
= getpkt_sane (&rs
->buf
, &rs
->buf_size
, wait_forever_enabled_p
);
5595 if (!target_is_async_p ())
5596 signal (SIGINT
, ofunc
);
5601 remote_stopped_by_watchpoint_p
= 0;
5603 /* We got something. */
5604 rs
->waiting_for_stop_reply
= 0;
5606 /* Assume that the target has acknowledged Ctrl-C unless we receive
5607 an 'F' or 'O' packet. */
5608 if (buf
[0] != 'F' && buf
[0] != 'O')
5609 rs
->ctrlc_pending_p
= 0;
5613 case 'E': /* Error of some sort. */
5614 /* We're out of sync with the target now. Did it continue or
5615 not? Not is more likely, so report a stop. */
5616 warning (_("Remote failure reply: %s"), buf
);
5617 status
->kind
= TARGET_WAITKIND_STOPPED
;
5618 status
->value
.sig
= TARGET_SIGNAL_0
;
5620 case 'F': /* File-I/O request. */
5621 remote_fileio_request (buf
, rs
->ctrlc_pending_p
);
5622 rs
->ctrlc_pending_p
= 0;
5624 case 'T': case 'S': case 'X': case 'W':
5626 struct stop_reply
*stop_reply
;
5627 struct cleanup
*old_chain
;
5629 stop_reply
= stop_reply_xmalloc ();
5630 old_chain
= make_cleanup (do_stop_reply_xfree
, stop_reply
);
5631 remote_parse_stop_reply (buf
, stop_reply
);
5632 discard_cleanups (old_chain
);
5633 event_ptid
= process_stop_reply (stop_reply
, status
);
5636 case 'O': /* Console output. */
5637 remote_console_output (buf
+ 1);
5639 /* The target didn't really stop; keep waiting. */
5640 rs
->waiting_for_stop_reply
= 1;
5644 if (last_sent_signal
!= TARGET_SIGNAL_0
)
5646 /* Zero length reply means that we tried 'S' or 'C' and the
5647 remote system doesn't support it. */
5648 target_terminal_ours_for_output ();
5650 ("Can't send signals to this remote system. %s not sent.\n",
5651 target_signal_to_name (last_sent_signal
));
5652 last_sent_signal
= TARGET_SIGNAL_0
;
5653 target_terminal_inferior ();
5655 strcpy ((char *) buf
, last_sent_step
? "s" : "c");
5656 putpkt ((char *) buf
);
5658 /* We just told the target to resume, so a stop reply is in
5660 rs
->waiting_for_stop_reply
= 1;
5663 /* else fallthrough */
5665 warning (_("Invalid remote reply: %s"), buf
);
5667 rs
->waiting_for_stop_reply
= 1;
5671 if (status
->kind
== TARGET_WAITKIND_IGNORE
)
5673 /* Nothing interesting happened. If we're doing a non-blocking
5674 poll, we're done. Otherwise, go back to waiting. */
5675 if (options
& TARGET_WNOHANG
)
5676 return minus_one_ptid
;
5680 else if (status
->kind
!= TARGET_WAITKIND_EXITED
5681 && status
->kind
!= TARGET_WAITKIND_SIGNALLED
)
5683 if (!ptid_equal (event_ptid
, null_ptid
))
5684 record_currthread (event_ptid
);
5686 event_ptid
= inferior_ptid
;
5689 /* A process exit. Invalidate our notion of current thread. */
5690 record_currthread (minus_one_ptid
);
5695 /* Wait until the remote machine stops, then return, storing status in
5696 STATUS just as `wait' would. */
5699 remote_wait (struct target_ops
*ops
,
5700 ptid_t ptid
, struct target_waitstatus
*status
, int options
)
5705 event_ptid
= remote_wait_ns (ptid
, status
, options
);
5707 event_ptid
= remote_wait_as (ptid
, status
, options
);
5709 if (target_can_async_p ())
5711 /* If there are are events left in the queue tell the event loop
5713 if (stop_reply_queue
)
5714 mark_async_event_handler (remote_async_inferior_event_token
);
5720 /* Fetch a single register using a 'p' packet. */
5723 fetch_register_using_p (struct regcache
*regcache
, struct packet_reg
*reg
)
5725 struct remote_state
*rs
= get_remote_state ();
5727 char regp
[MAX_REGISTER_SIZE
];
5730 if (remote_protocol_packets
[PACKET_p
].support
== PACKET_DISABLE
)
5733 if (reg
->pnum
== -1)
5738 p
+= hexnumstr (p
, reg
->pnum
);
5741 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
5745 switch (packet_ok (buf
, &remote_protocol_packets
[PACKET_p
]))
5749 case PACKET_UNKNOWN
:
5752 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
5753 gdbarch_register_name (get_regcache_arch (regcache
),
5758 /* If this register is unfetchable, tell the regcache. */
5761 regcache_raw_supply (regcache
, reg
->regnum
, NULL
);
5765 /* Otherwise, parse and supply the value. */
5771 error (_("fetch_register_using_p: early buf termination"));
5773 regp
[i
++] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
5776 regcache_raw_supply (regcache
, reg
->regnum
, regp
);
5780 /* Fetch the registers included in the target's 'g' packet. */
5783 send_g_packet (void)
5785 struct remote_state
*rs
= get_remote_state ();
5788 sprintf (rs
->buf
, "g");
5789 remote_send (&rs
->buf
, &rs
->buf_size
);
5791 /* We can get out of synch in various cases. If the first character
5792 in the buffer is not a hex character, assume that has happened
5793 and try to fetch another packet to read. */
5794 while ((rs
->buf
[0] < '0' || rs
->buf
[0] > '9')
5795 && (rs
->buf
[0] < 'A' || rs
->buf
[0] > 'F')
5796 && (rs
->buf
[0] < 'a' || rs
->buf
[0] > 'f')
5797 && rs
->buf
[0] != 'x') /* New: unavailable register value. */
5800 fprintf_unfiltered (gdb_stdlog
,
5801 "Bad register packet; fetching a new packet\n");
5802 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
5805 buf_len
= strlen (rs
->buf
);
5807 /* Sanity check the received packet. */
5808 if (buf_len
% 2 != 0)
5809 error (_("Remote 'g' packet reply is of odd length: %s"), rs
->buf
);
5815 process_g_packet (struct regcache
*regcache
)
5817 struct gdbarch
*gdbarch
= get_regcache_arch (regcache
);
5818 struct remote_state
*rs
= get_remote_state ();
5819 struct remote_arch_state
*rsa
= get_remote_arch_state ();
5824 buf_len
= strlen (rs
->buf
);
5826 /* Further sanity checks, with knowledge of the architecture. */
5827 if (buf_len
> 2 * rsa
->sizeof_g_packet
)
5828 error (_("Remote 'g' packet reply is too long: %s"), rs
->buf
);
5830 /* Save the size of the packet sent to us by the target. It is used
5831 as a heuristic when determining the max size of packets that the
5832 target can safely receive. */
5833 if (rsa
->actual_register_packet_size
== 0)
5834 rsa
->actual_register_packet_size
= buf_len
;
5836 /* If this is smaller than we guessed the 'g' packet would be,
5837 update our records. A 'g' reply that doesn't include a register's
5838 value implies either that the register is not available, or that
5839 the 'p' packet must be used. */
5840 if (buf_len
< 2 * rsa
->sizeof_g_packet
)
5842 rsa
->sizeof_g_packet
= buf_len
/ 2;
5844 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
5846 if (rsa
->regs
[i
].pnum
== -1)
5849 if (rsa
->regs
[i
].offset
>= rsa
->sizeof_g_packet
)
5850 rsa
->regs
[i
].in_g_packet
= 0;
5852 rsa
->regs
[i
].in_g_packet
= 1;
5856 regs
= alloca (rsa
->sizeof_g_packet
);
5858 /* Unimplemented registers read as all bits zero. */
5859 memset (regs
, 0, rsa
->sizeof_g_packet
);
5861 /* Reply describes registers byte by byte, each byte encoded as two
5862 hex characters. Suck them all up, then supply them to the
5863 register cacheing/storage mechanism. */
5866 for (i
= 0; i
< rsa
->sizeof_g_packet
; i
++)
5868 if (p
[0] == 0 || p
[1] == 0)
5869 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
5870 internal_error (__FILE__
, __LINE__
,
5871 _("unexpected end of 'g' packet reply"));
5873 if (p
[0] == 'x' && p
[1] == 'x')
5874 regs
[i
] = 0; /* 'x' */
5876 regs
[i
] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
5880 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
5882 struct packet_reg
*r
= &rsa
->regs
[i
];
5886 if (r
->offset
* 2 >= strlen (rs
->buf
))
5887 /* This shouldn't happen - we adjusted in_g_packet above. */
5888 internal_error (__FILE__
, __LINE__
,
5889 _("unexpected end of 'g' packet reply"));
5890 else if (rs
->buf
[r
->offset
* 2] == 'x')
5892 gdb_assert (r
->offset
* 2 < strlen (rs
->buf
));
5893 /* The register isn't available, mark it as such (at
5894 the same time setting the value to zero). */
5895 regcache_raw_supply (regcache
, r
->regnum
, NULL
);
5898 regcache_raw_supply (regcache
, r
->regnum
,
5905 fetch_registers_using_g (struct regcache
*regcache
)
5908 process_g_packet (regcache
);
5911 /* Make the remote selected traceframe match GDB's selected
5915 set_remote_traceframe (void)
5919 if (remote_traceframe_number
== get_traceframe_number ())
5922 /* Avoid recursion, remote_trace_find calls us again. */
5923 remote_traceframe_number
= get_traceframe_number ();
5925 newnum
= target_trace_find (tfind_number
,
5926 get_traceframe_number (), 0, 0, NULL
);
5928 /* Should not happen. If it does, all bets are off. */
5929 if (newnum
!= get_traceframe_number ())
5930 warning (_("could not set remote traceframe"));
5934 remote_fetch_registers (struct target_ops
*ops
,
5935 struct regcache
*regcache
, int regnum
)
5937 struct remote_arch_state
*rsa
= get_remote_arch_state ();
5940 set_remote_traceframe ();
5941 set_general_thread (inferior_ptid
);
5945 struct packet_reg
*reg
= packet_reg_from_regnum (rsa
, regnum
);
5947 gdb_assert (reg
!= NULL
);
5949 /* If this register might be in the 'g' packet, try that first -
5950 we are likely to read more than one register. If this is the
5951 first 'g' packet, we might be overly optimistic about its
5952 contents, so fall back to 'p'. */
5953 if (reg
->in_g_packet
)
5955 fetch_registers_using_g (regcache
);
5956 if (reg
->in_g_packet
)
5960 if (fetch_register_using_p (regcache
, reg
))
5963 /* This register is not available. */
5964 regcache_raw_supply (regcache
, reg
->regnum
, NULL
);
5969 fetch_registers_using_g (regcache
);
5971 for (i
= 0; i
< gdbarch_num_regs (get_regcache_arch (regcache
)); i
++)
5972 if (!rsa
->regs
[i
].in_g_packet
)
5973 if (!fetch_register_using_p (regcache
, &rsa
->regs
[i
]))
5975 /* This register is not available. */
5976 regcache_raw_supply (regcache
, i
, NULL
);
5980 /* Prepare to store registers. Since we may send them all (using a
5981 'G' request), we have to read out the ones we don't want to change
5985 remote_prepare_to_store (struct regcache
*regcache
)
5987 struct remote_arch_state
*rsa
= get_remote_arch_state ();
5989 gdb_byte buf
[MAX_REGISTER_SIZE
];
5991 /* Make sure the entire registers array is valid. */
5992 switch (remote_protocol_packets
[PACKET_P
].support
)
5994 case PACKET_DISABLE
:
5995 case PACKET_SUPPORT_UNKNOWN
:
5996 /* Make sure all the necessary registers are cached. */
5997 for (i
= 0; i
< gdbarch_num_regs (get_regcache_arch (regcache
)); i
++)
5998 if (rsa
->regs
[i
].in_g_packet
)
5999 regcache_raw_read (regcache
, rsa
->regs
[i
].regnum
, buf
);
6006 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
6007 packet was not recognized. */
6010 store_register_using_P (const struct regcache
*regcache
,
6011 struct packet_reg
*reg
)
6013 struct gdbarch
*gdbarch
= get_regcache_arch (regcache
);
6014 struct remote_state
*rs
= get_remote_state ();
6015 /* Try storing a single register. */
6016 char *buf
= rs
->buf
;
6017 gdb_byte regp
[MAX_REGISTER_SIZE
];
6020 if (remote_protocol_packets
[PACKET_P
].support
== PACKET_DISABLE
)
6023 if (reg
->pnum
== -1)
6026 xsnprintf (buf
, get_remote_packet_size (), "P%s=", phex_nz (reg
->pnum
, 0));
6027 p
= buf
+ strlen (buf
);
6028 regcache_raw_collect (regcache
, reg
->regnum
, regp
);
6029 bin2hex (regp
, p
, register_size (gdbarch
, reg
->regnum
));
6031 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6033 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_P
]))
6038 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
6039 gdbarch_register_name (gdbarch
, reg
->regnum
), rs
->buf
);
6040 case PACKET_UNKNOWN
:
6043 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
6047 /* Store register REGNUM, or all registers if REGNUM == -1, from the
6048 contents of the register cache buffer. FIXME: ignores errors. */
6051 store_registers_using_G (const struct regcache
*regcache
)
6053 struct remote_state
*rs
= get_remote_state ();
6054 struct remote_arch_state
*rsa
= get_remote_arch_state ();
6058 /* Extract all the registers in the regcache copying them into a
6063 regs
= alloca (rsa
->sizeof_g_packet
);
6064 memset (regs
, 0, rsa
->sizeof_g_packet
);
6065 for (i
= 0; i
< gdbarch_num_regs (get_regcache_arch (regcache
)); i
++)
6067 struct packet_reg
*r
= &rsa
->regs
[i
];
6070 regcache_raw_collect (regcache
, r
->regnum
, regs
+ r
->offset
);
6074 /* Command describes registers byte by byte,
6075 each byte encoded as two hex characters. */
6078 /* remote_prepare_to_store insures that rsa->sizeof_g_packet gets
6080 bin2hex (regs
, p
, rsa
->sizeof_g_packet
);
6082 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6083 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
6084 error (_("Could not write registers; remote failure reply '%s'"),
6088 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
6089 of the register cache buffer. FIXME: ignores errors. */
6092 remote_store_registers (struct target_ops
*ops
,
6093 struct regcache
*regcache
, int regnum
)
6095 struct remote_arch_state
*rsa
= get_remote_arch_state ();
6098 set_remote_traceframe ();
6099 set_general_thread (inferior_ptid
);
6103 struct packet_reg
*reg
= packet_reg_from_regnum (rsa
, regnum
);
6105 gdb_assert (reg
!= NULL
);
6107 /* Always prefer to store registers using the 'P' packet if
6108 possible; we often change only a small number of registers.
6109 Sometimes we change a larger number; we'd need help from a
6110 higher layer to know to use 'G'. */
6111 if (store_register_using_P (regcache
, reg
))
6114 /* For now, don't complain if we have no way to write the
6115 register. GDB loses track of unavailable registers too
6116 easily. Some day, this may be an error. We don't have
6117 any way to read the register, either... */
6118 if (!reg
->in_g_packet
)
6121 store_registers_using_G (regcache
);
6125 store_registers_using_G (regcache
);
6127 for (i
= 0; i
< gdbarch_num_regs (get_regcache_arch (regcache
)); i
++)
6128 if (!rsa
->regs
[i
].in_g_packet
)
6129 if (!store_register_using_P (regcache
, &rsa
->regs
[i
]))
6130 /* See above for why we do not issue an error here. */
6135 /* Return the number of hex digits in num. */
6138 hexnumlen (ULONGEST num
)
6142 for (i
= 0; num
!= 0; i
++)
6148 /* Set BUF to the minimum number of hex digits representing NUM. */
6151 hexnumstr (char *buf
, ULONGEST num
)
6153 int len
= hexnumlen (num
);
6155 return hexnumnstr (buf
, num
, len
);
6159 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
6162 hexnumnstr (char *buf
, ULONGEST num
, int width
)
6168 for (i
= width
- 1; i
>= 0; i
--)
6170 buf
[i
] = "0123456789abcdef"[(num
& 0xf)];
6177 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
6180 remote_address_masked (CORE_ADDR addr
)
6182 int address_size
= remote_address_size
;
6184 /* If "remoteaddresssize" was not set, default to target address size. */
6186 address_size
= gdbarch_addr_bit (target_gdbarch
);
6188 if (address_size
> 0
6189 && address_size
< (sizeof (ULONGEST
) * 8))
6191 /* Only create a mask when that mask can safely be constructed
6192 in a ULONGEST variable. */
6195 mask
= (mask
<< address_size
) - 1;
6201 /* Convert BUFFER, binary data at least LEN bytes long, into escaped
6202 binary data in OUT_BUF. Set *OUT_LEN to the length of the data
6203 encoded in OUT_BUF, and return the number of bytes in OUT_BUF
6204 (which may be more than *OUT_LEN due to escape characters). The
6205 total number of bytes in the output buffer will be at most
6209 remote_escape_output (const gdb_byte
*buffer
, int len
,
6210 gdb_byte
*out_buf
, int *out_len
,
6213 int input_index
, output_index
;
6216 for (input_index
= 0; input_index
< len
; input_index
++)
6218 gdb_byte b
= buffer
[input_index
];
6220 if (b
== '$' || b
== '#' || b
== '}')
6222 /* These must be escaped. */
6223 if (output_index
+ 2 > out_maxlen
)
6225 out_buf
[output_index
++] = '}';
6226 out_buf
[output_index
++] = b
^ 0x20;
6230 if (output_index
+ 1 > out_maxlen
)
6232 out_buf
[output_index
++] = b
;
6236 *out_len
= input_index
;
6237 return output_index
;
6240 /* Convert BUFFER, escaped data LEN bytes long, into binary data
6241 in OUT_BUF. Return the number of bytes written to OUT_BUF.
6242 Raise an error if the total number of bytes exceeds OUT_MAXLEN.
6244 This function reverses remote_escape_output. It allows more
6245 escaped characters than that function does, in particular because
6246 '*' must be escaped to avoid the run-length encoding processing
6247 in reading packets. */
6250 remote_unescape_input (const gdb_byte
*buffer
, int len
,
6251 gdb_byte
*out_buf
, int out_maxlen
)
6253 int input_index
, output_index
;
6258 for (input_index
= 0; input_index
< len
; input_index
++)
6260 gdb_byte b
= buffer
[input_index
];
6262 if (output_index
+ 1 > out_maxlen
)
6264 warning (_("Received too much data from remote target;"
6265 " ignoring overflow."));
6266 return output_index
;
6271 out_buf
[output_index
++] = b
^ 0x20;
6277 out_buf
[output_index
++] = b
;
6281 error (_("Unmatched escape character in target response."));
6283 return output_index
;
6286 /* Determine whether the remote target supports binary downloading.
6287 This is accomplished by sending a no-op memory write of zero length
6288 to the target at the specified address. It does not suffice to send
6289 the whole packet, since many stubs strip the eighth bit and
6290 subsequently compute a wrong checksum, which causes real havoc with
6293 NOTE: This can still lose if the serial line is not eight-bit
6294 clean. In cases like this, the user should clear "remote
6298 check_binary_download (CORE_ADDR addr
)
6300 struct remote_state
*rs
= get_remote_state ();
6302 switch (remote_protocol_packets
[PACKET_X
].support
)
6304 case PACKET_DISABLE
:
6308 case PACKET_SUPPORT_UNKNOWN
:
6314 p
+= hexnumstr (p
, (ULONGEST
) addr
);
6316 p
+= hexnumstr (p
, (ULONGEST
) 0);
6320 putpkt_binary (rs
->buf
, (int) (p
- rs
->buf
));
6321 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6323 if (rs
->buf
[0] == '\0')
6326 fprintf_unfiltered (gdb_stdlog
,
6327 "binary downloading NOT "
6328 "supported by target\n");
6329 remote_protocol_packets
[PACKET_X
].support
= PACKET_DISABLE
;
6334 fprintf_unfiltered (gdb_stdlog
,
6335 "binary downloading supported by target\n");
6336 remote_protocol_packets
[PACKET_X
].support
= PACKET_ENABLE
;
6343 /* Write memory data directly to the remote machine.
6344 This does not inform the data cache; the data cache uses this.
6345 HEADER is the starting part of the packet.
6346 MEMADDR is the address in the remote memory space.
6347 MYADDR is the address of the buffer in our space.
6348 LEN is the number of bytes.
6349 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
6350 should send data as binary ('X'), or hex-encoded ('M').
6352 The function creates packet of the form
6353 <HEADER><ADDRESS>,<LENGTH>:<DATA>
6355 where encoding of <DATA> is termined by PACKET_FORMAT.
6357 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
6360 Returns the number of bytes transferred, or 0 (setting errno) for
6361 error. Only transfer a single packet. */
6364 remote_write_bytes_aux (const char *header
, CORE_ADDR memaddr
,
6365 const gdb_byte
*myaddr
, int len
,
6366 char packet_format
, int use_length
)
6368 struct remote_state
*rs
= get_remote_state ();
6378 if (packet_format
!= 'X' && packet_format
!= 'M')
6379 internal_error (__FILE__
, __LINE__
,
6380 _("remote_write_bytes_aux: bad packet format"));
6385 payload_size
= get_memory_write_packet_size ();
6387 /* The packet buffer will be large enough for the payload;
6388 get_memory_packet_size ensures this. */
6391 /* Compute the size of the actual payload by subtracting out the
6392 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
6394 payload_size
-= strlen ("$,:#NN");
6396 /* The comma won't be used. */
6398 header_length
= strlen (header
);
6399 payload_size
-= header_length
;
6400 payload_size
-= hexnumlen (memaddr
);
6402 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
6404 strcat (rs
->buf
, header
);
6405 p
= rs
->buf
+ strlen (header
);
6407 /* Compute a best guess of the number of bytes actually transfered. */
6408 if (packet_format
== 'X')
6410 /* Best guess at number of bytes that will fit. */
6411 todo
= min (len
, payload_size
);
6413 payload_size
-= hexnumlen (todo
);
6414 todo
= min (todo
, payload_size
);
6418 /* Num bytes that will fit. */
6419 todo
= min (len
, payload_size
/ 2);
6421 payload_size
-= hexnumlen (todo
);
6422 todo
= min (todo
, payload_size
/ 2);
6426 internal_error (__FILE__
, __LINE__
,
6427 _("minimum packet size too small to write data"));
6429 /* If we already need another packet, then try to align the end
6430 of this packet to a useful boundary. */
6431 if (todo
> 2 * REMOTE_ALIGN_WRITES
&& todo
< len
)
6432 todo
= ((memaddr
+ todo
) & ~(REMOTE_ALIGN_WRITES
- 1)) - memaddr
;
6434 /* Append "<memaddr>". */
6435 memaddr
= remote_address_masked (memaddr
);
6436 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
6443 /* Append <len>. Retain the location/size of <len>. It may need to
6444 be adjusted once the packet body has been created. */
6446 plenlen
= hexnumstr (p
, (ULONGEST
) todo
);
6454 /* Append the packet body. */
6455 if (packet_format
== 'X')
6457 /* Binary mode. Send target system values byte by byte, in
6458 increasing byte addresses. Only escape certain critical
6460 payload_length
= remote_escape_output (myaddr
, todo
, p
, &nr_bytes
,
6463 /* If not all TODO bytes fit, then we'll need another packet. Make
6464 a second try to keep the end of the packet aligned. Don't do
6465 this if the packet is tiny. */
6466 if (nr_bytes
< todo
&& nr_bytes
> 2 * REMOTE_ALIGN_WRITES
)
6470 new_nr_bytes
= (((memaddr
+ nr_bytes
) & ~(REMOTE_ALIGN_WRITES
- 1))
6472 if (new_nr_bytes
!= nr_bytes
)
6473 payload_length
= remote_escape_output (myaddr
, new_nr_bytes
,
6478 p
+= payload_length
;
6479 if (use_length
&& nr_bytes
< todo
)
6481 /* Escape chars have filled up the buffer prematurely,
6482 and we have actually sent fewer bytes than planned.
6483 Fix-up the length field of the packet. Use the same
6484 number of characters as before. */
6485 plen
+= hexnumnstr (plen
, (ULONGEST
) nr_bytes
, plenlen
);
6486 *plen
= ':'; /* overwrite \0 from hexnumnstr() */
6491 /* Normal mode: Send target system values byte by byte, in
6492 increasing byte addresses. Each byte is encoded as a two hex
6494 nr_bytes
= bin2hex (myaddr
, p
, todo
);
6498 putpkt_binary (rs
->buf
, (int) (p
- rs
->buf
));
6499 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6501 if (rs
->buf
[0] == 'E')
6503 /* There is no correspondance between what the remote protocol
6504 uses for errors and errno codes. We would like a cleaner way
6505 of representing errors (big enough to include errno codes,
6506 bfd_error codes, and others). But for now just return EIO. */
6511 /* Return NR_BYTES, not TODO, in case escape chars caused us to send
6512 fewer bytes than we'd planned. */
6516 /* Write memory data directly to the remote machine.
6517 This does not inform the data cache; the data cache uses this.
6518 MEMADDR is the address in the remote memory space.
6519 MYADDR is the address of the buffer in our space.
6520 LEN is the number of bytes.
6522 Returns number of bytes transferred, or 0 (setting errno) for
6523 error. Only transfer a single packet. */
6526 remote_write_bytes (CORE_ADDR memaddr
, const gdb_byte
*myaddr
, int len
)
6528 char *packet_format
= 0;
6530 /* Check whether the target supports binary download. */
6531 check_binary_download (memaddr
);
6533 switch (remote_protocol_packets
[PACKET_X
].support
)
6536 packet_format
= "X";
6538 case PACKET_DISABLE
:
6539 packet_format
= "M";
6541 case PACKET_SUPPORT_UNKNOWN
:
6542 internal_error (__FILE__
, __LINE__
,
6543 _("remote_write_bytes: bad internal state"));
6545 internal_error (__FILE__
, __LINE__
, _("bad switch"));
6548 return remote_write_bytes_aux (packet_format
,
6549 memaddr
, myaddr
, len
, packet_format
[0], 1);
6552 /* Read memory data directly from the remote machine.
6553 This does not use the data cache; the data cache uses this.
6554 MEMADDR is the address in the remote memory space.
6555 MYADDR is the address of the buffer in our space.
6556 LEN is the number of bytes.
6558 Returns number of bytes transferred, or 0 for error. */
6561 remote_read_bytes (CORE_ADDR memaddr
, gdb_byte
*myaddr
, int len
)
6563 struct remote_state
*rs
= get_remote_state ();
6564 int max_buf_size
; /* Max size of packet output buffer. */
6572 max_buf_size
= get_memory_read_packet_size ();
6573 /* The packet buffer will be large enough for the payload;
6574 get_memory_packet_size ensures this. */
6576 /* Number if bytes that will fit. */
6577 todo
= min (len
, max_buf_size
/ 2);
6579 /* Construct "m"<memaddr>","<len>". */
6580 memaddr
= remote_address_masked (memaddr
);
6583 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
6585 p
+= hexnumstr (p
, (ULONGEST
) todo
);
6588 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6589 if (rs
->buf
[0] == 'E'
6590 && isxdigit (rs
->buf
[1]) && isxdigit (rs
->buf
[2])
6591 && rs
->buf
[3] == '\0')
6593 /* There is no correspondance between what the remote protocol
6594 uses for errors and errno codes. We would like a cleaner way
6595 of representing errors (big enough to include errno codes,
6596 bfd_error codes, and others). But for now just return
6601 /* Reply describes memory byte by byte, each byte encoded as two hex
6604 i
= hex2bin (p
, myaddr
, todo
);
6605 /* Return what we have. Let higher layers handle partial reads. */
6610 /* Remote notification handler. */
6613 handle_notification (char *buf
, size_t length
)
6615 if (strncmp (buf
, "Stop:", 5) == 0)
6617 if (pending_stop_reply
)
6619 /* We've already parsed the in-flight stop-reply, but the
6620 stub for some reason thought we didn't, possibly due to
6621 timeout on its side. Just ignore it. */
6623 fprintf_unfiltered (gdb_stdlog
, "ignoring resent notification\n");
6627 struct cleanup
*old_chain
;
6628 struct stop_reply
*reply
= stop_reply_xmalloc ();
6630 old_chain
= make_cleanup (do_stop_reply_xfree
, reply
);
6632 remote_parse_stop_reply (buf
+ 5, reply
);
6634 discard_cleanups (old_chain
);
6636 /* Be careful to only set it after parsing, since an error
6637 may be thrown then. */
6638 pending_stop_reply
= reply
;
6640 /* Notify the event loop there's a stop reply to acknowledge
6641 and that there may be more events to fetch. */
6642 mark_async_event_handler (remote_async_get_pending_events_token
);
6645 fprintf_unfiltered (gdb_stdlog
, "stop notification captured\n");
6649 /* We ignore notifications we don't recognize, for compatibility
6650 with newer stubs. */
6655 /* Read or write LEN bytes from inferior memory at MEMADDR,
6656 transferring to or from debugger address BUFFER. Write to inferior
6657 if SHOULD_WRITE is nonzero. Returns length of data written or
6658 read; 0 for error. TARGET is unused. */
6661 remote_xfer_memory (CORE_ADDR mem_addr
, gdb_byte
*buffer
, int mem_len
,
6662 int should_write
, struct mem_attrib
*attrib
,
6663 struct target_ops
*target
)
6667 set_remote_traceframe ();
6668 set_general_thread (inferior_ptid
);
6671 res
= remote_write_bytes (mem_addr
, buffer
, mem_len
);
6673 res
= remote_read_bytes (mem_addr
, buffer
, mem_len
);
6678 /* Sends a packet with content determined by the printf format string
6679 FORMAT and the remaining arguments, then gets the reply. Returns
6680 whether the packet was a success, a failure, or unknown. */
6682 static enum packet_result
6683 remote_send_printf (const char *format
, ...)
6685 struct remote_state
*rs
= get_remote_state ();
6686 int max_size
= get_remote_packet_size ();
6689 va_start (ap
, format
);
6692 if (vsnprintf (rs
->buf
, max_size
, format
, ap
) >= max_size
)
6693 internal_error (__FILE__
, __LINE__
, _("Too long remote packet."));
6695 if (putpkt (rs
->buf
) < 0)
6696 error (_("Communication problem with target."));
6699 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6701 return packet_check_result (rs
->buf
);
6705 restore_remote_timeout (void *p
)
6707 int value
= *(int *)p
;
6709 remote_timeout
= value
;
6712 /* Flash writing can take quite some time. We'll set
6713 effectively infinite timeout for flash operations.
6714 In future, we'll need to decide on a better approach. */
6715 static const int remote_flash_timeout
= 1000;
6718 remote_flash_erase (struct target_ops
*ops
,
6719 ULONGEST address
, LONGEST length
)
6721 int addr_size
= gdbarch_addr_bit (target_gdbarch
) / 8;
6722 int saved_remote_timeout
= remote_timeout
;
6723 enum packet_result ret
;
6724 struct cleanup
*back_to
= make_cleanup (restore_remote_timeout
,
6725 &saved_remote_timeout
);
6727 remote_timeout
= remote_flash_timeout
;
6729 ret
= remote_send_printf ("vFlashErase:%s,%s",
6730 phex (address
, addr_size
),
6734 case PACKET_UNKNOWN
:
6735 error (_("Remote target does not support flash erase"));
6737 error (_("Error erasing flash with vFlashErase packet"));
6742 do_cleanups (back_to
);
6746 remote_flash_write (struct target_ops
*ops
,
6747 ULONGEST address
, LONGEST length
,
6748 const gdb_byte
*data
)
6750 int saved_remote_timeout
= remote_timeout
;
6752 struct cleanup
*back_to
= make_cleanup (restore_remote_timeout
,
6753 &saved_remote_timeout
);
6755 remote_timeout
= remote_flash_timeout
;
6756 ret
= remote_write_bytes_aux ("vFlashWrite:", address
, data
, length
, 'X', 0);
6757 do_cleanups (back_to
);
6763 remote_flash_done (struct target_ops
*ops
)
6765 int saved_remote_timeout
= remote_timeout
;
6767 struct cleanup
*back_to
= make_cleanup (restore_remote_timeout
,
6768 &saved_remote_timeout
);
6770 remote_timeout
= remote_flash_timeout
;
6771 ret
= remote_send_printf ("vFlashDone");
6772 do_cleanups (back_to
);
6776 case PACKET_UNKNOWN
:
6777 error (_("Remote target does not support vFlashDone"));
6779 error (_("Error finishing flash operation"));
6786 remote_files_info (struct target_ops
*ignore
)
6788 puts_filtered ("Debugging a target over a serial line.\n");
6791 /* Stuff for dealing with the packets which are part of this protocol.
6792 See comment at top of file for details. */
6794 /* Read a single character from the remote end. */
6797 readchar (int timeout
)
6801 ch
= serial_readchar (remote_desc
, timeout
);
6806 switch ((enum serial_rc
) ch
)
6810 error (_("Remote connection closed"));
6814 perror_with_name (_("Remote communication error. "
6815 "Target disconnected."));
6817 case SERIAL_TIMEOUT
:
6823 /* Send the command in *BUF to the remote machine, and read the reply
6824 into *BUF. Report an error if we get an error reply. Resize
6825 *BUF using xrealloc if necessary to hold the result, and update
6829 remote_send (char **buf
,
6833 getpkt (buf
, sizeof_buf
, 0);
6835 if ((*buf
)[0] == 'E')
6836 error (_("Remote failure reply: %s"), *buf
);
6839 /* Return a pointer to an xmalloc'ed string representing an escaped
6840 version of BUF, of len N. E.g. \n is converted to \\n, \t to \\t,
6841 etc. The caller is responsible for releasing the returned
6845 escape_buffer (const char *buf
, int n
)
6847 struct cleanup
*old_chain
;
6848 struct ui_file
*stb
;
6851 stb
= mem_fileopen ();
6852 old_chain
= make_cleanup_ui_file_delete (stb
);
6854 fputstrn_unfiltered (buf
, n
, 0, stb
);
6855 str
= ui_file_xstrdup (stb
, NULL
);
6856 do_cleanups (old_chain
);
6860 /* Display a null-terminated packet on stdout, for debugging, using C
6864 print_packet (char *buf
)
6866 puts_filtered ("\"");
6867 fputstr_filtered (buf
, '"', gdb_stdout
);
6868 puts_filtered ("\"");
6874 return putpkt_binary (buf
, strlen (buf
));
6877 /* Send a packet to the remote machine, with error checking. The data
6878 of the packet is in BUF. The string in BUF can be at most
6879 get_remote_packet_size () - 5 to account for the $, # and checksum,
6880 and for a possible /0 if we are debugging (remote_debug) and want
6881 to print the sent packet as a string. */
6884 putpkt_binary (char *buf
, int cnt
)
6886 struct remote_state
*rs
= get_remote_state ();
6888 unsigned char csum
= 0;
6889 char *buf2
= alloca (cnt
+ 6);
6895 /* Catch cases like trying to read memory or listing threads while
6896 we're waiting for a stop reply. The remote server wouldn't be
6897 ready to handle this request, so we'd hang and timeout. We don't
6898 have to worry about this in synchronous mode, because in that
6899 case it's not possible to issue a command while the target is
6900 running. This is not a problem in non-stop mode, because in that
6901 case, the stub is always ready to process serial input. */
6902 if (!non_stop
&& target_can_async_p () && rs
->waiting_for_stop_reply
)
6903 error (_("Cannot execute this command while the target is running."));
6905 /* We're sending out a new packet. Make sure we don't look at a
6906 stale cached response. */
6907 rs
->cached_wait_status
= 0;
6909 /* Copy the packet into buffer BUF2, encapsulating it
6910 and giving it a checksum. */
6915 for (i
= 0; i
< cnt
; i
++)
6921 *p
++ = tohex ((csum
>> 4) & 0xf);
6922 *p
++ = tohex (csum
& 0xf);
6924 /* Send it over and over until we get a positive ack. */
6928 int started_error_output
= 0;
6932 struct cleanup
*old_chain
;
6936 str
= escape_buffer (buf2
, p
- buf2
);
6937 old_chain
= make_cleanup (xfree
, str
);
6938 fprintf_unfiltered (gdb_stdlog
, "Sending packet: %s...", str
);
6939 gdb_flush (gdb_stdlog
);
6940 do_cleanups (old_chain
);
6942 if (serial_write (remote_desc
, buf2
, p
- buf2
))
6943 perror_with_name (_("putpkt: write failed"));
6945 /* If this is a no acks version of the remote protocol, send the
6946 packet and move on. */
6950 /* Read until either a timeout occurs (-2) or '+' is read.
6951 Handle any notification that arrives in the mean time. */
6954 ch
= readchar (remote_timeout
);
6962 case SERIAL_TIMEOUT
:
6965 if (started_error_output
)
6967 putchar_unfiltered ('\n');
6968 started_error_output
= 0;
6977 fprintf_unfiltered (gdb_stdlog
, "Ack\n");
6981 fprintf_unfiltered (gdb_stdlog
, "Nak\n");
6983 case SERIAL_TIMEOUT
:
6987 break; /* Retransmit buffer. */
6991 fprintf_unfiltered (gdb_stdlog
,
6992 "Packet instead of Ack, ignoring it\n");
6993 /* It's probably an old response sent because an ACK
6994 was lost. Gobble up the packet and ack it so it
6995 doesn't get retransmitted when we resend this
6998 serial_write (remote_desc
, "+", 1);
6999 continue; /* Now, go look for +. */
7006 /* If we got a notification, handle it, and go back to looking
7008 /* We've found the start of a notification. Now
7009 collect the data. */
7010 val
= read_frame (&rs
->buf
, &rs
->buf_size
);
7015 struct cleanup
*old_chain
;
7018 str
= escape_buffer (rs
->buf
, val
);
7019 old_chain
= make_cleanup (xfree
, str
);
7020 fprintf_unfiltered (gdb_stdlog
,
7021 " Notification received: %s\n",
7023 do_cleanups (old_chain
);
7025 handle_notification (rs
->buf
, val
);
7026 /* We're in sync now, rewait for the ack. */
7033 if (!started_error_output
)
7035 started_error_output
= 1;
7036 fprintf_unfiltered (gdb_stdlog
, "putpkt: Junk: ");
7038 fputc_unfiltered (ch
& 0177, gdb_stdlog
);
7039 fprintf_unfiltered (gdb_stdlog
, "%s", rs
->buf
);
7048 if (!started_error_output
)
7050 started_error_output
= 1;
7051 fprintf_unfiltered (gdb_stdlog
, "putpkt: Junk: ");
7053 fputc_unfiltered (ch
& 0177, gdb_stdlog
);
7057 break; /* Here to retransmit. */
7061 /* This is wrong. If doing a long backtrace, the user should be
7062 able to get out next time we call QUIT, without anything as
7063 violent as interrupt_query. If we want to provide a way out of
7064 here without getting to the next QUIT, it should be based on
7065 hitting ^C twice as in remote_wait. */
7076 /* Come here after finding the start of a frame when we expected an
7077 ack. Do our best to discard the rest of this packet. */
7086 c
= readchar (remote_timeout
);
7089 case SERIAL_TIMEOUT
:
7090 /* Nothing we can do. */
7093 /* Discard the two bytes of checksum and stop. */
7094 c
= readchar (remote_timeout
);
7096 c
= readchar (remote_timeout
);
7099 case '*': /* Run length encoding. */
7100 /* Discard the repeat count. */
7101 c
= readchar (remote_timeout
);
7106 /* A regular character. */
7112 /* Come here after finding the start of the frame. Collect the rest
7113 into *BUF, verifying the checksum, length, and handling run-length
7114 compression. NUL terminate the buffer. If there is not enough room,
7115 expand *BUF using xrealloc.
7117 Returns -1 on error, number of characters in buffer (ignoring the
7118 trailing NULL) on success. (could be extended to return one of the
7119 SERIAL status indications). */
7122 read_frame (char **buf_p
,
7129 struct remote_state
*rs
= get_remote_state ();
7136 c
= readchar (remote_timeout
);
7139 case SERIAL_TIMEOUT
:
7141 fputs_filtered ("Timeout in mid-packet, retrying\n", gdb_stdlog
);
7145 fputs_filtered ("Saw new packet start in middle of old one\n",
7147 return -1; /* Start a new packet, count retries. */
7150 unsigned char pktcsum
;
7156 check_0
= readchar (remote_timeout
);
7158 check_1
= readchar (remote_timeout
);
7160 if (check_0
== SERIAL_TIMEOUT
|| check_1
== SERIAL_TIMEOUT
)
7163 fputs_filtered ("Timeout in checksum, retrying\n",
7167 else if (check_0
< 0 || check_1
< 0)
7170 fputs_filtered ("Communication error in checksum\n",
7175 /* Don't recompute the checksum; with no ack packets we
7176 don't have any way to indicate a packet retransmission
7181 pktcsum
= (fromhex (check_0
) << 4) | fromhex (check_1
);
7182 if (csum
== pktcsum
)
7187 struct cleanup
*old_chain
;
7190 str
= escape_buffer (buf
, bc
);
7191 old_chain
= make_cleanup (xfree
, str
);
7192 fprintf_unfiltered (gdb_stdlog
,
7193 "Bad checksum, sentsum=0x%x, "
7194 "csum=0x%x, buf=%s\n",
7195 pktcsum
, csum
, str
);
7196 do_cleanups (old_chain
);
7198 /* Number of characters in buffer ignoring trailing
7202 case '*': /* Run length encoding. */
7207 c
= readchar (remote_timeout
);
7209 repeat
= c
- ' ' + 3; /* Compute repeat count. */
7211 /* The character before ``*'' is repeated. */
7213 if (repeat
> 0 && repeat
<= 255 && bc
> 0)
7215 if (bc
+ repeat
- 1 >= *sizeof_buf
- 1)
7217 /* Make some more room in the buffer. */
7218 *sizeof_buf
+= repeat
;
7219 *buf_p
= xrealloc (*buf_p
, *sizeof_buf
);
7223 memset (&buf
[bc
], buf
[bc
- 1], repeat
);
7229 printf_filtered (_("Invalid run length encoding: %s\n"), buf
);
7233 if (bc
>= *sizeof_buf
- 1)
7235 /* Make some more room in the buffer. */
7237 *buf_p
= xrealloc (*buf_p
, *sizeof_buf
);
7248 /* Read a packet from the remote machine, with error checking, and
7249 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
7250 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
7251 rather than timing out; this is used (in synchronous mode) to wait
7252 for a target that is is executing user code to stop. */
7253 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
7254 don't have to change all the calls to getpkt to deal with the
7255 return value, because at the moment I don't know what the right
7256 thing to do it for those. */
7264 timed_out
= getpkt_sane (buf
, sizeof_buf
, forever
);
7268 /* Read a packet from the remote machine, with error checking, and
7269 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
7270 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
7271 rather than timing out; this is used (in synchronous mode) to wait
7272 for a target that is is executing user code to stop. If FOREVER ==
7273 0, this function is allowed to time out gracefully and return an
7274 indication of this to the caller. Otherwise return the number of
7275 bytes read. If EXPECTING_NOTIF, consider receiving a notification
7276 enough reason to return to the caller. */
7279 getpkt_or_notif_sane_1 (char **buf
, long *sizeof_buf
, int forever
,
7280 int expecting_notif
)
7282 struct remote_state
*rs
= get_remote_state ();
7288 /* We're reading a new response. Make sure we don't look at a
7289 previously cached response. */
7290 rs
->cached_wait_status
= 0;
7292 strcpy (*buf
, "timeout");
7295 timeout
= watchdog
> 0 ? watchdog
: -1;
7296 else if (expecting_notif
)
7297 timeout
= 0; /* There should already be a char in the buffer. If
7300 timeout
= remote_timeout
;
7304 /* Process any number of notifications, and then return when
7308 /* If we get a timeout or bad checksm, retry up to MAX_TRIES
7310 for (tries
= 1; tries
<= MAX_TRIES
; tries
++)
7312 /* This can loop forever if the remote side sends us
7313 characters continuously, but if it pauses, we'll get
7314 SERIAL_TIMEOUT from readchar because of timeout. Then
7315 we'll count that as a retry.
7317 Note that even when forever is set, we will only wait
7318 forever prior to the start of a packet. After that, we
7319 expect characters to arrive at a brisk pace. They should
7320 show up within remote_timeout intervals. */
7322 c
= readchar (timeout
);
7323 while (c
!= SERIAL_TIMEOUT
&& c
!= '$' && c
!= '%');
7325 if (c
== SERIAL_TIMEOUT
)
7327 if (expecting_notif
)
7328 return -1; /* Don't complain, it's normal to not get
7329 anything in this case. */
7331 if (forever
) /* Watchdog went off? Kill the target. */
7335 error (_("Watchdog timeout has expired. Target detached."));
7338 fputs_filtered ("Timed out.\n", gdb_stdlog
);
7342 /* We've found the start of a packet or notification.
7343 Now collect the data. */
7344 val
= read_frame (buf
, sizeof_buf
);
7349 serial_write (remote_desc
, "-", 1);
7352 if (tries
> MAX_TRIES
)
7354 /* We have tried hard enough, and just can't receive the
7355 packet/notification. Give up. */
7356 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
7358 /* Skip the ack char if we're in no-ack mode. */
7359 if (!rs
->noack_mode
)
7360 serial_write (remote_desc
, "+", 1);
7364 /* If we got an ordinary packet, return that to our caller. */
7369 struct cleanup
*old_chain
;
7372 str
= escape_buffer (*buf
, val
);
7373 old_chain
= make_cleanup (xfree
, str
);
7374 fprintf_unfiltered (gdb_stdlog
, "Packet received: %s\n", str
);
7375 do_cleanups (old_chain
);
7378 /* Skip the ack char if we're in no-ack mode. */
7379 if (!rs
->noack_mode
)
7380 serial_write (remote_desc
, "+", 1);
7384 /* If we got a notification, handle it, and go back to looking
7388 gdb_assert (c
== '%');
7392 struct cleanup
*old_chain
;
7395 str
= escape_buffer (*buf
, val
);
7396 old_chain
= make_cleanup (xfree
, str
);
7397 fprintf_unfiltered (gdb_stdlog
,
7398 " Notification received: %s\n",
7400 do_cleanups (old_chain
);
7403 handle_notification (*buf
, val
);
7405 /* Notifications require no acknowledgement. */
7407 if (expecting_notif
)
7414 getpkt_sane (char **buf
, long *sizeof_buf
, int forever
)
7416 return getpkt_or_notif_sane_1 (buf
, sizeof_buf
, forever
, 0);
7420 getpkt_or_notif_sane (char **buf
, long *sizeof_buf
, int forever
)
7422 return getpkt_or_notif_sane_1 (buf
, sizeof_buf
, forever
, 1);
7426 /* A helper function that just calls putpkt; for type correctness. */
7429 putpkt_for_catch_errors (void *arg
)
7431 return putpkt (arg
);
7435 remote_kill (struct target_ops
*ops
)
7437 /* Use catch_errors so the user can quit from gdb even when we
7438 aren't on speaking terms with the remote system. */
7439 catch_errors (putpkt_for_catch_errors
, "k", "", RETURN_MASK_ERROR
);
7441 /* Don't wait for it to die. I'm not really sure it matters whether
7442 we do or not. For the existing stubs, kill is a noop. */
7443 target_mourn_inferior ();
7447 remote_vkill (int pid
, struct remote_state
*rs
)
7449 if (remote_protocol_packets
[PACKET_vKill
].support
== PACKET_DISABLE
)
7452 /* Tell the remote target to detach. */
7453 sprintf (rs
->buf
, "vKill;%x", pid
);
7455 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7457 if (packet_ok (rs
->buf
,
7458 &remote_protocol_packets
[PACKET_vKill
]) == PACKET_OK
)
7460 else if (remote_protocol_packets
[PACKET_vKill
].support
== PACKET_DISABLE
)
7467 extended_remote_kill (struct target_ops
*ops
)
7470 int pid
= ptid_get_pid (inferior_ptid
);
7471 struct remote_state
*rs
= get_remote_state ();
7473 res
= remote_vkill (pid
, rs
);
7474 if (res
== -1 && !(rs
->extended
&& remote_multi_process_p (rs
)))
7476 /* Don't try 'k' on a multi-process aware stub -- it has no way
7477 to specify the pid. */
7481 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7482 if (rs
->buf
[0] != 'O' || rs
->buf
[0] != 'K')
7485 /* Don't wait for it to die. I'm not really sure it matters whether
7486 we do or not. For the existing stubs, kill is a noop. */
7492 error (_("Can't kill process"));
7494 target_mourn_inferior ();
7498 remote_mourn (struct target_ops
*ops
)
7500 remote_mourn_1 (ops
);
7503 /* Worker function for remote_mourn. */
7505 remote_mourn_1 (struct target_ops
*target
)
7507 unpush_target (target
);
7509 /* remote_close takes care of doing most of the clean up. */
7510 generic_mourn_inferior ();
7514 extended_remote_mourn_1 (struct target_ops
*target
)
7516 struct remote_state
*rs
= get_remote_state ();
7518 /* In case we got here due to an error, but we're going to stay
7520 rs
->waiting_for_stop_reply
= 0;
7522 /* We're no longer interested in these events. */
7523 discard_pending_stop_replies (ptid_get_pid (inferior_ptid
));
7525 /* If the current general thread belonged to the process we just
7526 detached from or has exited, the remote side current general
7527 thread becomes undefined. Considering a case like this:
7529 - We just got here due to a detach.
7530 - The process that we're detaching from happens to immediately
7531 report a global breakpoint being hit in non-stop mode, in the
7532 same thread we had selected before.
7533 - GDB attaches to this process again.
7534 - This event happens to be the next event we handle.
7536 GDB would consider that the current general thread didn't need to
7537 be set on the stub side (with Hg), since for all it knew,
7538 GENERAL_THREAD hadn't changed.
7540 Notice that although in all-stop mode, the remote server always
7541 sets the current thread to the thread reporting the stop event,
7542 that doesn't happen in non-stop mode; in non-stop, the stub *must
7543 not* change the current thread when reporting a breakpoint hit,
7544 due to the decoupling of event reporting and event handling.
7546 To keep things simple, we always invalidate our notion of the
7548 record_currthread (minus_one_ptid
);
7550 /* Unlike "target remote", we do not want to unpush the target; then
7551 the next time the user says "run", we won't be connected. */
7553 /* Call common code to mark the inferior as not running. */
7554 generic_mourn_inferior ();
7556 if (!have_inferiors ())
7558 if (!remote_multi_process_p (rs
))
7560 /* Check whether the target is running now - some remote stubs
7561 automatically restart after kill. */
7563 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7565 if (rs
->buf
[0] == 'S' || rs
->buf
[0] == 'T')
7567 /* Assume that the target has been restarted. Set
7568 inferior_ptid so that bits of core GDB realizes
7569 there's something here, e.g., so that the user can
7570 say "kill" again. */
7571 inferior_ptid
= magic_null_ptid
;
7578 extended_remote_mourn (struct target_ops
*ops
)
7580 extended_remote_mourn_1 (ops
);
7584 extended_remote_supports_disable_randomization (void)
7586 return (remote_protocol_packets
[PACKET_QDisableRandomization
].support
7591 extended_remote_disable_randomization (int val
)
7593 struct remote_state
*rs
= get_remote_state ();
7596 sprintf (rs
->buf
, "QDisableRandomization:%x", val
);
7598 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
7600 error (_("Target does not support QDisableRandomization."));
7601 if (strcmp (reply
, "OK") != 0)
7602 error (_("Bogus QDisableRandomization reply from target: %s"), reply
);
7606 extended_remote_run (char *args
)
7608 struct remote_state
*rs
= get_remote_state ();
7611 /* If the user has disabled vRun support, or we have detected that
7612 support is not available, do not try it. */
7613 if (remote_protocol_packets
[PACKET_vRun
].support
== PACKET_DISABLE
)
7616 strcpy (rs
->buf
, "vRun;");
7617 len
= strlen (rs
->buf
);
7619 if (strlen (remote_exec_file
) * 2 + len
>= get_remote_packet_size ())
7620 error (_("Remote file name too long for run packet"));
7621 len
+= 2 * bin2hex ((gdb_byte
*) remote_exec_file
, rs
->buf
+ len
, 0);
7623 gdb_assert (args
!= NULL
);
7626 struct cleanup
*back_to
;
7630 argv
= gdb_buildargv (args
);
7631 back_to
= make_cleanup ((void (*) (void *)) freeargv
, argv
);
7632 for (i
= 0; argv
[i
] != NULL
; i
++)
7634 if (strlen (argv
[i
]) * 2 + 1 + len
>= get_remote_packet_size ())
7635 error (_("Argument list too long for run packet"));
7636 rs
->buf
[len
++] = ';';
7637 len
+= 2 * bin2hex ((gdb_byte
*) argv
[i
], rs
->buf
+ len
, 0);
7639 do_cleanups (back_to
);
7642 rs
->buf
[len
++] = '\0';
7645 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7647 if (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vRun
]) == PACKET_OK
)
7649 /* We have a wait response; we don't need it, though. All is well. */
7652 else if (remote_protocol_packets
[PACKET_vRun
].support
== PACKET_DISABLE
)
7653 /* It wasn't disabled before, but it is now. */
7657 if (remote_exec_file
[0] == '\0')
7658 error (_("Running the default executable on the remote target failed; "
7659 "try \"set remote exec-file\"?"));
7661 error (_("Running \"%s\" on the remote target failed"),
7666 /* In the extended protocol we want to be able to do things like
7667 "run" and have them basically work as expected. So we need
7668 a special create_inferior function. We support changing the
7669 executable file and the command line arguments, but not the
7673 extended_remote_create_inferior_1 (char *exec_file
, char *args
,
7674 char **env
, int from_tty
)
7676 /* If running asynchronously, register the target file descriptor
7677 with the event loop. */
7678 if (target_can_async_p ())
7679 target_async (inferior_event_handler
, 0);
7681 /* Disable address space randomization if requested (and supported). */
7682 if (extended_remote_supports_disable_randomization ())
7683 extended_remote_disable_randomization (disable_randomization
);
7685 /* Now restart the remote server. */
7686 if (extended_remote_run (args
) == -1)
7688 /* vRun was not supported. Fail if we need it to do what the
7690 if (remote_exec_file
[0])
7691 error (_("Remote target does not support \"set remote exec-file\""));
7693 error (_("Remote target does not support \"set args\" or run <ARGS>"));
7695 /* Fall back to "R". */
7696 extended_remote_restart ();
7699 if (!have_inferiors ())
7701 /* Clean up from the last time we ran, before we mark the target
7702 running again. This will mark breakpoints uninserted, and
7703 get_offsets may insert breakpoints. */
7704 init_thread_list ();
7705 init_wait_for_inferior ();
7708 add_current_inferior_and_thread ();
7710 /* Get updated offsets, if the stub uses qOffsets. */
7715 extended_remote_create_inferior (struct target_ops
*ops
,
7716 char *exec_file
, char *args
,
7717 char **env
, int from_tty
)
7719 extended_remote_create_inferior_1 (exec_file
, args
, env
, from_tty
);
7723 /* Given a location's target info BP_TGT and the packet buffer BUF, output
7724 the list of conditions (in agent expression bytecode format), if any, the
7725 target needs to evaluate. The output is placed into the packet buffer
7729 remote_add_target_side_condition (struct gdbarch
*gdbarch
,
7730 struct bp_target_info
*bp_tgt
, char *buf
)
7732 struct agent_expr
*aexpr
= NULL
;
7735 char *buf_start
= buf
;
7737 if (VEC_empty (agent_expr_p
, bp_tgt
->conditions
))
7740 buf
+= strlen (buf
);
7741 sprintf (buf
, "%s", ";");
7744 /* Send conditions to the target and free the vector. */
7746 VEC_iterate (agent_expr_p
, bp_tgt
->conditions
, ix
, aexpr
);
7749 sprintf (buf
, "X%x,", aexpr
->len
);
7750 buf
+= strlen (buf
);
7751 for (i
= 0; i
< aexpr
->len
; ++i
)
7752 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
7756 VEC_free (agent_expr_p
, bp_tgt
->conditions
);
7760 /* Insert a breakpoint. On targets that have software breakpoint
7761 support, we ask the remote target to do the work; on targets
7762 which don't, we insert a traditional memory breakpoint. */
7765 remote_insert_breakpoint (struct gdbarch
*gdbarch
,
7766 struct bp_target_info
*bp_tgt
)
7768 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
7769 If it succeeds, then set the support to PACKET_ENABLE. If it
7770 fails, and the user has explicitly requested the Z support then
7771 report an error, otherwise, mark it disabled and go on. */
7773 if (remote_protocol_packets
[PACKET_Z0
].support
!= PACKET_DISABLE
)
7775 CORE_ADDR addr
= bp_tgt
->placed_address
;
7776 struct remote_state
*rs
;
7779 struct condition_list
*cond
= NULL
;
7781 gdbarch_remote_breakpoint_from_pc (gdbarch
, &addr
, &bpsize
);
7783 rs
= get_remote_state ();
7789 addr
= (ULONGEST
) remote_address_masked (addr
);
7790 p
+= hexnumstr (p
, addr
);
7791 sprintf (p
, ",%d", bpsize
);
7793 if (remote_supports_cond_breakpoints ())
7794 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
);
7797 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7799 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
]))
7804 bp_tgt
->placed_address
= addr
;
7805 bp_tgt
->placed_size
= bpsize
;
7807 case PACKET_UNKNOWN
:
7812 return memory_insert_breakpoint (gdbarch
, bp_tgt
);
7816 remote_remove_breakpoint (struct gdbarch
*gdbarch
,
7817 struct bp_target_info
*bp_tgt
)
7819 CORE_ADDR addr
= bp_tgt
->placed_address
;
7820 struct remote_state
*rs
= get_remote_state ();
7822 if (remote_protocol_packets
[PACKET_Z0
].support
!= PACKET_DISABLE
)
7830 addr
= (ULONGEST
) remote_address_masked (bp_tgt
->placed_address
);
7831 p
+= hexnumstr (p
, addr
);
7832 sprintf (p
, ",%d", bp_tgt
->placed_size
);
7835 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7837 return (rs
->buf
[0] == 'E');
7840 return memory_remove_breakpoint (gdbarch
, bp_tgt
);
7844 watchpoint_to_Z_packet (int type
)
7849 return Z_PACKET_WRITE_WP
;
7852 return Z_PACKET_READ_WP
;
7855 return Z_PACKET_ACCESS_WP
;
7858 internal_error (__FILE__
, __LINE__
,
7859 _("hw_bp_to_z: bad watchpoint type %d"), type
);
7864 remote_insert_watchpoint (CORE_ADDR addr
, int len
, int type
,
7865 struct expression
*cond
)
7867 struct remote_state
*rs
= get_remote_state ();
7869 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
7871 if (remote_protocol_packets
[PACKET_Z0
+ packet
].support
== PACKET_DISABLE
)
7874 sprintf (rs
->buf
, "Z%x,", packet
);
7875 p
= strchr (rs
->buf
, '\0');
7876 addr
= remote_address_masked (addr
);
7877 p
+= hexnumstr (p
, (ULONGEST
) addr
);
7878 sprintf (p
, ",%x", len
);
7881 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7883 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
7887 case PACKET_UNKNOWN
:
7892 internal_error (__FILE__
, __LINE__
,
7893 _("remote_insert_watchpoint: reached end of function"));
7897 remote_watchpoint_addr_within_range (struct target_ops
*target
, CORE_ADDR addr
,
7898 CORE_ADDR start
, int length
)
7900 CORE_ADDR diff
= remote_address_masked (addr
- start
);
7902 return diff
< length
;
7907 remote_remove_watchpoint (CORE_ADDR addr
, int len
, int type
,
7908 struct expression
*cond
)
7910 struct remote_state
*rs
= get_remote_state ();
7912 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
7914 if (remote_protocol_packets
[PACKET_Z0
+ packet
].support
== PACKET_DISABLE
)
7917 sprintf (rs
->buf
, "z%x,", packet
);
7918 p
= strchr (rs
->buf
, '\0');
7919 addr
= remote_address_masked (addr
);
7920 p
+= hexnumstr (p
, (ULONGEST
) addr
);
7921 sprintf (p
, ",%x", len
);
7923 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7925 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
7928 case PACKET_UNKNOWN
:
7933 internal_error (__FILE__
, __LINE__
,
7934 _("remote_remove_watchpoint: reached end of function"));
7938 int remote_hw_watchpoint_limit
= -1;
7939 int remote_hw_watchpoint_length_limit
= -1;
7940 int remote_hw_breakpoint_limit
= -1;
7943 remote_region_ok_for_hw_watchpoint (CORE_ADDR addr
, int len
)
7945 if (remote_hw_watchpoint_length_limit
== 0)
7947 else if (remote_hw_watchpoint_length_limit
< 0)
7949 else if (len
<= remote_hw_watchpoint_length_limit
)
7956 remote_check_watch_resources (int type
, int cnt
, int ot
)
7958 if (type
== bp_hardware_breakpoint
)
7960 if (remote_hw_breakpoint_limit
== 0)
7962 else if (remote_hw_breakpoint_limit
< 0)
7964 else if (cnt
<= remote_hw_breakpoint_limit
)
7969 if (remote_hw_watchpoint_limit
== 0)
7971 else if (remote_hw_watchpoint_limit
< 0)
7975 else if (cnt
<= remote_hw_watchpoint_limit
)
7982 remote_stopped_by_watchpoint (void)
7984 return remote_stopped_by_watchpoint_p
;
7988 remote_stopped_data_address (struct target_ops
*target
, CORE_ADDR
*addr_p
)
7992 if (remote_stopped_by_watchpoint ())
7994 *addr_p
= remote_watch_data_address
;
8003 remote_insert_hw_breakpoint (struct gdbarch
*gdbarch
,
8004 struct bp_target_info
*bp_tgt
)
8007 struct remote_state
*rs
;
8010 /* The length field should be set to the size of a breakpoint
8011 instruction, even though we aren't inserting one ourselves. */
8013 gdbarch_remote_breakpoint_from_pc
8014 (gdbarch
, &bp_tgt
->placed_address
, &bp_tgt
->placed_size
);
8016 if (remote_protocol_packets
[PACKET_Z1
].support
== PACKET_DISABLE
)
8019 rs
= get_remote_state ();
8026 addr
= remote_address_masked (bp_tgt
->placed_address
);
8027 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8028 sprintf (p
, ",%x", bp_tgt
->placed_size
);
8030 if (remote_supports_cond_breakpoints ())
8031 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
);
8034 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8036 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
8039 case PACKET_UNKNOWN
:
8044 internal_error (__FILE__
, __LINE__
,
8045 _("remote_insert_hw_breakpoint: reached end of function"));
8050 remote_remove_hw_breakpoint (struct gdbarch
*gdbarch
,
8051 struct bp_target_info
*bp_tgt
)
8054 struct remote_state
*rs
= get_remote_state ();
8057 if (remote_protocol_packets
[PACKET_Z1
].support
== PACKET_DISABLE
)
8064 addr
= remote_address_masked (bp_tgt
->placed_address
);
8065 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8066 sprintf (p
, ",%x", bp_tgt
->placed_size
);
8069 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8071 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
8074 case PACKET_UNKNOWN
:
8079 internal_error (__FILE__
, __LINE__
,
8080 _("remote_remove_hw_breakpoint: reached end of function"));
8083 /* Table used by the crc32 function to calcuate the checksum. */
8085 static unsigned long crc32_table
[256] =
8088 static unsigned long
8089 crc32 (const unsigned char *buf
, int len
, unsigned int crc
)
8091 if (!crc32_table
[1])
8093 /* Initialize the CRC table and the decoding table. */
8097 for (i
= 0; i
< 256; i
++)
8099 for (c
= i
<< 24, j
= 8; j
> 0; --j
)
8100 c
= c
& 0x80000000 ? (c
<< 1) ^ 0x04c11db7 : (c
<< 1);
8107 crc
= (crc
<< 8) ^ crc32_table
[((crc
>> 24) ^ *buf
) & 255];
8113 /* Verify memory using the "qCRC:" request. */
8116 remote_verify_memory (struct target_ops
*ops
,
8117 const gdb_byte
*data
, CORE_ADDR lma
, ULONGEST size
)
8119 struct remote_state
*rs
= get_remote_state ();
8120 unsigned long host_crc
, target_crc
;
8123 /* FIXME: assumes lma can fit into long. */
8124 xsnprintf (rs
->buf
, get_remote_packet_size (), "qCRC:%lx,%lx",
8125 (long) lma
, (long) size
);
8128 /* Be clever; compute the host_crc before waiting for target
8130 host_crc
= crc32 (data
, size
, 0xffffffff);
8132 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8133 if (rs
->buf
[0] == 'E')
8136 if (rs
->buf
[0] != 'C')
8137 error (_("remote target does not support this operation"));
8139 for (target_crc
= 0, tmp
= &rs
->buf
[1]; *tmp
; tmp
++)
8140 target_crc
= target_crc
* 16 + fromhex (*tmp
);
8142 return (host_crc
== target_crc
);
8145 /* compare-sections command
8147 With no arguments, compares each loadable section in the exec bfd
8148 with the same memory range on the target, and reports mismatches.
8149 Useful for verifying the image on the target against the exec file. */
8152 compare_sections_command (char *args
, int from_tty
)
8155 struct cleanup
*old_chain
;
8157 const char *sectname
;
8165 error (_("command cannot be used without an exec file"));
8167 for (s
= exec_bfd
->sections
; s
; s
= s
->next
)
8169 if (!(s
->flags
& SEC_LOAD
))
8170 continue; /* Skip non-loadable section. */
8172 size
= bfd_get_section_size (s
);
8174 continue; /* Skip zero-length section. */
8176 sectname
= bfd_get_section_name (exec_bfd
, s
);
8177 if (args
&& strcmp (args
, sectname
) != 0)
8178 continue; /* Not the section selected by user. */
8180 matched
= 1; /* Do this section. */
8183 sectdata
= xmalloc (size
);
8184 old_chain
= make_cleanup (xfree
, sectdata
);
8185 bfd_get_section_contents (exec_bfd
, s
, sectdata
, 0, size
);
8187 res
= target_verify_memory (sectdata
, lma
, size
);
8190 error (_("target memory fault, section %s, range %s -- %s"), sectname
,
8191 paddress (target_gdbarch
, lma
),
8192 paddress (target_gdbarch
, lma
+ size
));
8194 printf_filtered ("Section %s, range %s -- %s: ", sectname
,
8195 paddress (target_gdbarch
, lma
),
8196 paddress (target_gdbarch
, lma
+ size
));
8198 printf_filtered ("matched.\n");
8201 printf_filtered ("MIS-MATCHED!\n");
8205 do_cleanups (old_chain
);
8208 warning (_("One or more sections of the remote executable does not match\n\
8209 the loaded file\n"));
8210 if (args
&& !matched
)
8211 printf_filtered (_("No loaded section named '%s'.\n"), args
);
8214 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
8215 into remote target. The number of bytes written to the remote
8216 target is returned, or -1 for error. */
8219 remote_write_qxfer (struct target_ops
*ops
, const char *object_name
,
8220 const char *annex
, const gdb_byte
*writebuf
,
8221 ULONGEST offset
, LONGEST len
,
8222 struct packet_config
*packet
)
8226 struct remote_state
*rs
= get_remote_state ();
8227 int max_size
= get_memory_write_packet_size ();
8229 if (packet
->support
== PACKET_DISABLE
)
8232 /* Insert header. */
8233 i
= snprintf (rs
->buf
, max_size
,
8234 "qXfer:%s:write:%s:%s:",
8235 object_name
, annex
? annex
: "",
8236 phex_nz (offset
, sizeof offset
));
8237 max_size
-= (i
+ 1);
8239 /* Escape as much data as fits into rs->buf. */
8240 buf_len
= remote_escape_output
8241 (writebuf
, len
, (rs
->buf
+ i
), &max_size
, max_size
);
8243 if (putpkt_binary (rs
->buf
, i
+ buf_len
) < 0
8244 || getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0) < 0
8245 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
8248 unpack_varlen_hex (rs
->buf
, &n
);
8252 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
8253 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
8254 number of bytes read is returned, or 0 for EOF, or -1 for error.
8255 The number of bytes read may be less than LEN without indicating an
8256 EOF. PACKET is checked and updated to indicate whether the remote
8257 target supports this object. */
8260 remote_read_qxfer (struct target_ops
*ops
, const char *object_name
,
8262 gdb_byte
*readbuf
, ULONGEST offset
, LONGEST len
,
8263 struct packet_config
*packet
)
8265 static char *finished_object
;
8266 static char *finished_annex
;
8267 static ULONGEST finished_offset
;
8269 struct remote_state
*rs
= get_remote_state ();
8270 LONGEST i
, n
, packet_len
;
8272 if (packet
->support
== PACKET_DISABLE
)
8275 /* Check whether we've cached an end-of-object packet that matches
8277 if (finished_object
)
8279 if (strcmp (object_name
, finished_object
) == 0
8280 && strcmp (annex
? annex
: "", finished_annex
) == 0
8281 && offset
== finished_offset
)
8284 /* Otherwise, we're now reading something different. Discard
8286 xfree (finished_object
);
8287 xfree (finished_annex
);
8288 finished_object
= NULL
;
8289 finished_annex
= NULL
;
8292 /* Request only enough to fit in a single packet. The actual data
8293 may not, since we don't know how much of it will need to be escaped;
8294 the target is free to respond with slightly less data. We subtract
8295 five to account for the response type and the protocol frame. */
8296 n
= min (get_remote_packet_size () - 5, len
);
8297 snprintf (rs
->buf
, get_remote_packet_size () - 4, "qXfer:%s:read:%s:%s,%s",
8298 object_name
, annex
? annex
: "",
8299 phex_nz (offset
, sizeof offset
),
8300 phex_nz (n
, sizeof n
));
8301 i
= putpkt (rs
->buf
);
8306 packet_len
= getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0);
8307 if (packet_len
< 0 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
8310 if (rs
->buf
[0] != 'l' && rs
->buf
[0] != 'm')
8311 error (_("Unknown remote qXfer reply: %s"), rs
->buf
);
8313 /* 'm' means there is (or at least might be) more data after this
8314 batch. That does not make sense unless there's at least one byte
8315 of data in this reply. */
8316 if (rs
->buf
[0] == 'm' && packet_len
== 1)
8317 error (_("Remote qXfer reply contained no data."));
8319 /* Got some data. */
8320 i
= remote_unescape_input (rs
->buf
+ 1, packet_len
- 1, readbuf
, n
);
8322 /* 'l' is an EOF marker, possibly including a final block of data,
8323 or possibly empty. If we have the final block of a non-empty
8324 object, record this fact to bypass a subsequent partial read. */
8325 if (rs
->buf
[0] == 'l' && offset
+ i
> 0)
8327 finished_object
= xstrdup (object_name
);
8328 finished_annex
= xstrdup (annex
? annex
: "");
8329 finished_offset
= offset
+ i
;
8336 remote_xfer_partial (struct target_ops
*ops
, enum target_object object
,
8337 const char *annex
, gdb_byte
*readbuf
,
8338 const gdb_byte
*writebuf
, ULONGEST offset
, LONGEST len
)
8340 struct remote_state
*rs
;
8345 set_remote_traceframe ();
8346 set_general_thread (inferior_ptid
);
8348 rs
= get_remote_state ();
8350 /* Handle memory using the standard memory routines. */
8351 if (object
== TARGET_OBJECT_MEMORY
)
8357 /* If the remote target is connected but not running, we should
8358 pass this request down to a lower stratum (e.g. the executable
8360 if (!target_has_execution
)
8363 if (writebuf
!= NULL
)
8364 xfered
= remote_write_bytes (offset
, writebuf
, len
);
8366 xfered
= remote_read_bytes (offset
, readbuf
, len
);
8370 else if (xfered
== 0 && errno
== 0)
8376 /* Handle SPU memory using qxfer packets. */
8377 if (object
== TARGET_OBJECT_SPU
)
8380 return remote_read_qxfer (ops
, "spu", annex
, readbuf
, offset
, len
,
8381 &remote_protocol_packets
8382 [PACKET_qXfer_spu_read
]);
8384 return remote_write_qxfer (ops
, "spu", annex
, writebuf
, offset
, len
,
8385 &remote_protocol_packets
8386 [PACKET_qXfer_spu_write
]);
8389 /* Handle extra signal info using qxfer packets. */
8390 if (object
== TARGET_OBJECT_SIGNAL_INFO
)
8393 return remote_read_qxfer (ops
, "siginfo", annex
, readbuf
, offset
, len
,
8394 &remote_protocol_packets
8395 [PACKET_qXfer_siginfo_read
]);
8397 return remote_write_qxfer (ops
, "siginfo", annex
,
8398 writebuf
, offset
, len
,
8399 &remote_protocol_packets
8400 [PACKET_qXfer_siginfo_write
]);
8403 if (object
== TARGET_OBJECT_STATIC_TRACE_DATA
)
8406 return remote_read_qxfer (ops
, "statictrace", annex
,
8407 readbuf
, offset
, len
,
8408 &remote_protocol_packets
8409 [PACKET_qXfer_statictrace_read
]);
8414 /* Only handle flash writes. */
8415 if (writebuf
!= NULL
)
8421 case TARGET_OBJECT_FLASH
:
8422 xfered
= remote_flash_write (ops
, offset
, len
, writebuf
);
8426 else if (xfered
== 0 && errno
== 0)
8436 /* Map pre-existing objects onto letters. DO NOT do this for new
8437 objects!!! Instead specify new query packets. */
8440 case TARGET_OBJECT_AVR
:
8444 case TARGET_OBJECT_AUXV
:
8445 gdb_assert (annex
== NULL
);
8446 return remote_read_qxfer (ops
, "auxv", annex
, readbuf
, offset
, len
,
8447 &remote_protocol_packets
[PACKET_qXfer_auxv
]);
8449 case TARGET_OBJECT_AVAILABLE_FEATURES
:
8450 return remote_read_qxfer
8451 (ops
, "features", annex
, readbuf
, offset
, len
,
8452 &remote_protocol_packets
[PACKET_qXfer_features
]);
8454 case TARGET_OBJECT_LIBRARIES
:
8455 return remote_read_qxfer
8456 (ops
, "libraries", annex
, readbuf
, offset
, len
,
8457 &remote_protocol_packets
[PACKET_qXfer_libraries
]);
8459 case TARGET_OBJECT_LIBRARIES_SVR4
:
8460 return remote_read_qxfer
8461 (ops
, "libraries-svr4", annex
, readbuf
, offset
, len
,
8462 &remote_protocol_packets
[PACKET_qXfer_libraries_svr4
]);
8464 case TARGET_OBJECT_MEMORY_MAP
:
8465 gdb_assert (annex
== NULL
);
8466 return remote_read_qxfer (ops
, "memory-map", annex
, readbuf
, offset
, len
,
8467 &remote_protocol_packets
[PACKET_qXfer_memory_map
]);
8469 case TARGET_OBJECT_OSDATA
:
8470 /* Should only get here if we're connected. */
8471 gdb_assert (remote_desc
);
8472 return remote_read_qxfer
8473 (ops
, "osdata", annex
, readbuf
, offset
, len
,
8474 &remote_protocol_packets
[PACKET_qXfer_osdata
]);
8476 case TARGET_OBJECT_THREADS
:
8477 gdb_assert (annex
== NULL
);
8478 return remote_read_qxfer (ops
, "threads", annex
, readbuf
, offset
, len
,
8479 &remote_protocol_packets
[PACKET_qXfer_threads
]);
8481 case TARGET_OBJECT_TRACEFRAME_INFO
:
8482 gdb_assert (annex
== NULL
);
8483 return remote_read_qxfer
8484 (ops
, "traceframe-info", annex
, readbuf
, offset
, len
,
8485 &remote_protocol_packets
[PACKET_qXfer_traceframe_info
]);
8487 case TARGET_OBJECT_FDPIC
:
8488 return remote_read_qxfer (ops
, "fdpic", annex
, readbuf
, offset
, len
,
8489 &remote_protocol_packets
[PACKET_qXfer_fdpic
]);
8491 case TARGET_OBJECT_OPENVMS_UIB
:
8492 return remote_read_qxfer (ops
, "uib", annex
, readbuf
, offset
, len
,
8493 &remote_protocol_packets
[PACKET_qXfer_uib
]);
8499 /* Note: a zero OFFSET and LEN can be used to query the minimum
8501 if (offset
== 0 && len
== 0)
8502 return (get_remote_packet_size ());
8503 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
8504 large enough let the caller deal with it. */
8505 if (len
< get_remote_packet_size ())
8507 len
= get_remote_packet_size ();
8509 /* Except for querying the minimum buffer size, target must be open. */
8511 error (_("remote query is only available after target open"));
8513 gdb_assert (annex
!= NULL
);
8514 gdb_assert (readbuf
!= NULL
);
8520 /* We used one buffer char for the remote protocol q command and
8521 another for the query type. As the remote protocol encapsulation
8522 uses 4 chars plus one extra in case we are debugging
8523 (remote_debug), we have PBUFZIZ - 7 left to pack the query
8526 while (annex
[i
] && (i
< (get_remote_packet_size () - 8)))
8528 /* Bad caller may have sent forbidden characters. */
8529 gdb_assert (isprint (annex
[i
]) && annex
[i
] != '$' && annex
[i
] != '#');
8534 gdb_assert (annex
[i
] == '\0');
8536 i
= putpkt (rs
->buf
);
8540 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8541 strcpy ((char *) readbuf
, rs
->buf
);
8543 return strlen ((char *) readbuf
);
8547 remote_search_memory (struct target_ops
* ops
,
8548 CORE_ADDR start_addr
, ULONGEST search_space_len
,
8549 const gdb_byte
*pattern
, ULONGEST pattern_len
,
8550 CORE_ADDR
*found_addrp
)
8552 int addr_size
= gdbarch_addr_bit (target_gdbarch
) / 8;
8553 struct remote_state
*rs
= get_remote_state ();
8554 int max_size
= get_memory_write_packet_size ();
8555 struct packet_config
*packet
=
8556 &remote_protocol_packets
[PACKET_qSearch_memory
];
8557 /* Number of packet bytes used to encode the pattern;
8558 this could be more than PATTERN_LEN due to escape characters. */
8559 int escaped_pattern_len
;
8560 /* Amount of pattern that was encodable in the packet. */
8561 int used_pattern_len
;
8564 ULONGEST found_addr
;
8566 /* Don't go to the target if we don't have to.
8567 This is done before checking packet->support to avoid the possibility that
8568 a success for this edge case means the facility works in general. */
8569 if (pattern_len
> search_space_len
)
8571 if (pattern_len
== 0)
8573 *found_addrp
= start_addr
;
8577 /* If we already know the packet isn't supported, fall back to the simple
8578 way of searching memory. */
8580 if (packet
->support
== PACKET_DISABLE
)
8582 /* Target doesn't provided special support, fall back and use the
8583 standard support (copy memory and do the search here). */
8584 return simple_search_memory (ops
, start_addr
, search_space_len
,
8585 pattern
, pattern_len
, found_addrp
);
8588 /* Insert header. */
8589 i
= snprintf (rs
->buf
, max_size
,
8590 "qSearch:memory:%s;%s;",
8591 phex_nz (start_addr
, addr_size
),
8592 phex_nz (search_space_len
, sizeof (search_space_len
)));
8593 max_size
-= (i
+ 1);
8595 /* Escape as much data as fits into rs->buf. */
8596 escaped_pattern_len
=
8597 remote_escape_output (pattern
, pattern_len
, (rs
->buf
+ i
),
8598 &used_pattern_len
, max_size
);
8600 /* Bail if the pattern is too large. */
8601 if (used_pattern_len
!= pattern_len
)
8602 error (_("Pattern is too large to transmit to remote target."));
8604 if (putpkt_binary (rs
->buf
, i
+ escaped_pattern_len
) < 0
8605 || getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0) < 0
8606 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
8608 /* The request may not have worked because the command is not
8609 supported. If so, fall back to the simple way. */
8610 if (packet
->support
== PACKET_DISABLE
)
8612 return simple_search_memory (ops
, start_addr
, search_space_len
,
8613 pattern
, pattern_len
, found_addrp
);
8618 if (rs
->buf
[0] == '0')
8620 else if (rs
->buf
[0] == '1')
8623 if (rs
->buf
[1] != ',')
8624 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
);
8625 unpack_varlen_hex (rs
->buf
+ 2, &found_addr
);
8626 *found_addrp
= found_addr
;
8629 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
);
8635 remote_rcmd (char *command
,
8636 struct ui_file
*outbuf
)
8638 struct remote_state
*rs
= get_remote_state ();
8642 error (_("remote rcmd is only available after target open"));
8644 /* Send a NULL command across as an empty command. */
8645 if (command
== NULL
)
8648 /* The query prefix. */
8649 strcpy (rs
->buf
, "qRcmd,");
8650 p
= strchr (rs
->buf
, '\0');
8652 if ((strlen (rs
->buf
) + strlen (command
) * 2 + 8/*misc*/)
8653 > get_remote_packet_size ())
8654 error (_("\"monitor\" command ``%s'' is too long."), command
);
8656 /* Encode the actual command. */
8657 bin2hex ((gdb_byte
*) command
, p
, 0);
8659 if (putpkt (rs
->buf
) < 0)
8660 error (_("Communication problem with target."));
8662 /* get/display the response */
8667 /* XXX - see also remote_get_noisy_reply(). */
8668 QUIT
; /* Allow user to bail out with ^C. */
8670 if (getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0) == -1)
8672 /* Timeout. Continue to (try to) read responses.
8673 This is better than stopping with an error, assuming the stub
8674 is still executing the (long) monitor command.
8675 If needed, the user can interrupt gdb using C-c, obtaining
8676 an effect similar to stop on timeout. */
8681 error (_("Target does not support this command."));
8682 if (buf
[0] == 'O' && buf
[1] != 'K')
8684 remote_console_output (buf
+ 1); /* 'O' message from stub. */
8687 if (strcmp (buf
, "OK") == 0)
8689 if (strlen (buf
) == 3 && buf
[0] == 'E'
8690 && isdigit (buf
[1]) && isdigit (buf
[2]))
8692 error (_("Protocol error with Rcmd"));
8694 for (p
= buf
; p
[0] != '\0' && p
[1] != '\0'; p
+= 2)
8696 char c
= (fromhex (p
[0]) << 4) + fromhex (p
[1]);
8698 fputc_unfiltered (c
, outbuf
);
8704 static VEC(mem_region_s
) *
8705 remote_memory_map (struct target_ops
*ops
)
8707 VEC(mem_region_s
) *result
= NULL
;
8708 char *text
= target_read_stralloc (¤t_target
,
8709 TARGET_OBJECT_MEMORY_MAP
, NULL
);
8713 struct cleanup
*back_to
= make_cleanup (xfree
, text
);
8715 result
= parse_memory_map (text
);
8716 do_cleanups (back_to
);
8723 packet_command (char *args
, int from_tty
)
8725 struct remote_state
*rs
= get_remote_state ();
8728 error (_("command can only be used with remote target"));
8731 error (_("remote-packet command requires packet text as argument"));
8733 puts_filtered ("sending: ");
8734 print_packet (args
);
8735 puts_filtered ("\n");
8738 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8739 puts_filtered ("received: ");
8740 print_packet (rs
->buf
);
8741 puts_filtered ("\n");
8745 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
8747 static void display_thread_info (struct gdb_ext_thread_info
*info
);
8749 static void threadset_test_cmd (char *cmd
, int tty
);
8751 static void threadalive_test (char *cmd
, int tty
);
8753 static void threadlist_test_cmd (char *cmd
, int tty
);
8755 int get_and_display_threadinfo (threadref
*ref
);
8757 static void threadinfo_test_cmd (char *cmd
, int tty
);
8759 static int thread_display_step (threadref
*ref
, void *context
);
8761 static void threadlist_update_test_cmd (char *cmd
, int tty
);
8763 static void init_remote_threadtests (void);
8765 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
8768 threadset_test_cmd (char *cmd
, int tty
)
8770 int sample_thread
= SAMPLE_THREAD
;
8772 printf_filtered (_("Remote threadset test\n"));
8773 set_general_thread (sample_thread
);
8778 threadalive_test (char *cmd
, int tty
)
8780 int sample_thread
= SAMPLE_THREAD
;
8781 int pid
= ptid_get_pid (inferior_ptid
);
8782 ptid_t ptid
= ptid_build (pid
, 0, sample_thread
);
8784 if (remote_thread_alive (ptid
))
8785 printf_filtered ("PASS: Thread alive test\n");
8787 printf_filtered ("FAIL: Thread alive test\n");
8790 void output_threadid (char *title
, threadref
*ref
);
8793 output_threadid (char *title
, threadref
*ref
)
8797 pack_threadid (&hexid
[0], ref
); /* Convert threead id into hex. */
8799 printf_filtered ("%s %s\n", title
, (&hexid
[0]));
8803 threadlist_test_cmd (char *cmd
, int tty
)
8806 threadref nextthread
;
8807 int done
, result_count
;
8808 threadref threadlist
[3];
8810 printf_filtered ("Remote Threadlist test\n");
8811 if (!remote_get_threadlist (startflag
, &nextthread
, 3, &done
,
8812 &result_count
, &threadlist
[0]))
8813 printf_filtered ("FAIL: threadlist test\n");
8816 threadref
*scan
= threadlist
;
8817 threadref
*limit
= scan
+ result_count
;
8819 while (scan
< limit
)
8820 output_threadid (" thread ", scan
++);
8825 display_thread_info (struct gdb_ext_thread_info
*info
)
8827 output_threadid ("Threadid: ", &info
->threadid
);
8828 printf_filtered ("Name: %s\n ", info
->shortname
);
8829 printf_filtered ("State: %s\n", info
->display
);
8830 printf_filtered ("other: %s\n\n", info
->more_display
);
8834 get_and_display_threadinfo (threadref
*ref
)
8838 struct gdb_ext_thread_info threadinfo
;
8840 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
8841 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
8842 if (0 != (result
= remote_get_threadinfo (ref
, set
, &threadinfo
)))
8843 display_thread_info (&threadinfo
);
8848 threadinfo_test_cmd (char *cmd
, int tty
)
8850 int athread
= SAMPLE_THREAD
;
8854 int_to_threadref (&thread
, athread
);
8855 printf_filtered ("Remote Threadinfo test\n");
8856 if (!get_and_display_threadinfo (&thread
))
8857 printf_filtered ("FAIL cannot get thread info\n");
8861 thread_display_step (threadref
*ref
, void *context
)
8863 /* output_threadid(" threadstep ",ref); *//* simple test */
8864 return get_and_display_threadinfo (ref
);
8868 threadlist_update_test_cmd (char *cmd
, int tty
)
8870 printf_filtered ("Remote Threadlist update test\n");
8871 remote_threadlist_iterator (thread_display_step
, 0, CRAZY_MAX_THREADS
);
8875 init_remote_threadtests (void)
8877 add_com ("tlist", class_obscure
, threadlist_test_cmd
,
8878 _("Fetch and print the remote list of "
8879 "thread identifiers, one pkt only"));
8880 add_com ("tinfo", class_obscure
, threadinfo_test_cmd
,
8881 _("Fetch and display info about one thread"));
8882 add_com ("tset", class_obscure
, threadset_test_cmd
,
8883 _("Test setting to a different thread"));
8884 add_com ("tupd", class_obscure
, threadlist_update_test_cmd
,
8885 _("Iterate through updating all remote thread info"));
8886 add_com ("talive", class_obscure
, threadalive_test
,
8887 _(" Remote thread alive test "));
8892 /* Convert a thread ID to a string. Returns the string in a static
8896 remote_pid_to_str (struct target_ops
*ops
, ptid_t ptid
)
8898 static char buf
[64];
8899 struct remote_state
*rs
= get_remote_state ();
8901 if (ptid_equal (ptid
, null_ptid
))
8902 return normal_pid_to_str (ptid
);
8903 else if (ptid_is_pid (ptid
))
8905 /* Printing an inferior target id. */
8907 /* When multi-process extensions are off, there's no way in the
8908 remote protocol to know the remote process id, if there's any
8909 at all. There's one exception --- when we're connected with
8910 target extended-remote, and we manually attached to a process
8911 with "attach PID". We don't record anywhere a flag that
8912 allows us to distinguish that case from the case of
8913 connecting with extended-remote and the stub already being
8914 attached to a process, and reporting yes to qAttached, hence
8915 no smart special casing here. */
8916 if (!remote_multi_process_p (rs
))
8918 xsnprintf (buf
, sizeof buf
, "Remote target");
8922 return normal_pid_to_str (ptid
);
8926 if (ptid_equal (magic_null_ptid
, ptid
))
8927 xsnprintf (buf
, sizeof buf
, "Thread <main>");
8928 else if (rs
->extended
&& remote_multi_process_p (rs
))
8929 xsnprintf (buf
, sizeof buf
, "Thread %d.%ld",
8930 ptid_get_pid (ptid
), ptid_get_tid (ptid
));
8932 xsnprintf (buf
, sizeof buf
, "Thread %ld",
8933 ptid_get_tid (ptid
));
8938 /* Get the address of the thread local variable in OBJFILE which is
8939 stored at OFFSET within the thread local storage for thread PTID. */
8942 remote_get_thread_local_address (struct target_ops
*ops
,
8943 ptid_t ptid
, CORE_ADDR lm
, CORE_ADDR offset
)
8945 if (remote_protocol_packets
[PACKET_qGetTLSAddr
].support
!= PACKET_DISABLE
)
8947 struct remote_state
*rs
= get_remote_state ();
8949 char *endp
= rs
->buf
+ get_remote_packet_size ();
8950 enum packet_result result
;
8952 strcpy (p
, "qGetTLSAddr:");
8954 p
= write_ptid (p
, endp
, ptid
);
8956 p
+= hexnumstr (p
, offset
);
8958 p
+= hexnumstr (p
, lm
);
8962 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8963 result
= packet_ok (rs
->buf
,
8964 &remote_protocol_packets
[PACKET_qGetTLSAddr
]);
8965 if (result
== PACKET_OK
)
8969 unpack_varlen_hex (rs
->buf
, &result
);
8972 else if (result
== PACKET_UNKNOWN
)
8973 throw_error (TLS_GENERIC_ERROR
,
8974 _("Remote target doesn't support qGetTLSAddr packet"));
8976 throw_error (TLS_GENERIC_ERROR
,
8977 _("Remote target failed to process qGetTLSAddr request"));
8980 throw_error (TLS_GENERIC_ERROR
,
8981 _("TLS not supported or disabled on this target"));
8986 /* Provide thread local base, i.e. Thread Information Block address.
8987 Returns 1 if ptid is found and thread_local_base is non zero. */
8990 remote_get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
)
8992 if (remote_protocol_packets
[PACKET_qGetTIBAddr
].support
!= PACKET_DISABLE
)
8994 struct remote_state
*rs
= get_remote_state ();
8996 char *endp
= rs
->buf
+ get_remote_packet_size ();
8997 enum packet_result result
;
8999 strcpy (p
, "qGetTIBAddr:");
9001 p
= write_ptid (p
, endp
, ptid
);
9005 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
9006 result
= packet_ok (rs
->buf
,
9007 &remote_protocol_packets
[PACKET_qGetTIBAddr
]);
9008 if (result
== PACKET_OK
)
9012 unpack_varlen_hex (rs
->buf
, &result
);
9014 *addr
= (CORE_ADDR
) result
;
9017 else if (result
== PACKET_UNKNOWN
)
9018 error (_("Remote target doesn't support qGetTIBAddr packet"));
9020 error (_("Remote target failed to process qGetTIBAddr request"));
9023 error (_("qGetTIBAddr not supported or disabled on this target"));
9028 /* Support for inferring a target description based on the current
9029 architecture and the size of a 'g' packet. While the 'g' packet
9030 can have any size (since optional registers can be left off the
9031 end), some sizes are easily recognizable given knowledge of the
9032 approximate architecture. */
9034 struct remote_g_packet_guess
9037 const struct target_desc
*tdesc
;
9039 typedef struct remote_g_packet_guess remote_g_packet_guess_s
;
9040 DEF_VEC_O(remote_g_packet_guess_s
);
9042 struct remote_g_packet_data
9044 VEC(remote_g_packet_guess_s
) *guesses
;
9047 static struct gdbarch_data
*remote_g_packet_data_handle
;
9050 remote_g_packet_data_init (struct obstack
*obstack
)
9052 return OBSTACK_ZALLOC (obstack
, struct remote_g_packet_data
);
9056 register_remote_g_packet_guess (struct gdbarch
*gdbarch
, int bytes
,
9057 const struct target_desc
*tdesc
)
9059 struct remote_g_packet_data
*data
9060 = gdbarch_data (gdbarch
, remote_g_packet_data_handle
);
9061 struct remote_g_packet_guess new_guess
, *guess
;
9064 gdb_assert (tdesc
!= NULL
);
9067 VEC_iterate (remote_g_packet_guess_s
, data
->guesses
, ix
, guess
);
9069 if (guess
->bytes
== bytes
)
9070 internal_error (__FILE__
, __LINE__
,
9071 _("Duplicate g packet description added for size %d"),
9074 new_guess
.bytes
= bytes
;
9075 new_guess
.tdesc
= tdesc
;
9076 VEC_safe_push (remote_g_packet_guess_s
, data
->guesses
, &new_guess
);
9079 /* Return 1 if remote_read_description would do anything on this target
9080 and architecture, 0 otherwise. */
9083 remote_read_description_p (struct target_ops
*target
)
9085 struct remote_g_packet_data
*data
9086 = gdbarch_data (target_gdbarch
, remote_g_packet_data_handle
);
9088 if (!VEC_empty (remote_g_packet_guess_s
, data
->guesses
))
9094 static const struct target_desc
*
9095 remote_read_description (struct target_ops
*target
)
9097 struct remote_g_packet_data
*data
9098 = gdbarch_data (target_gdbarch
, remote_g_packet_data_handle
);
9100 /* Do not try this during initial connection, when we do not know
9101 whether there is a running but stopped thread. */
9102 if (!target_has_execution
|| ptid_equal (inferior_ptid
, null_ptid
))
9105 if (!VEC_empty (remote_g_packet_guess_s
, data
->guesses
))
9107 struct remote_g_packet_guess
*guess
;
9109 int bytes
= send_g_packet ();
9112 VEC_iterate (remote_g_packet_guess_s
, data
->guesses
, ix
, guess
);
9114 if (guess
->bytes
== bytes
)
9115 return guess
->tdesc
;
9117 /* We discard the g packet. A minor optimization would be to
9118 hold on to it, and fill the register cache once we have selected
9119 an architecture, but it's too tricky to do safely. */
9125 /* Remote file transfer support. This is host-initiated I/O, not
9126 target-initiated; for target-initiated, see remote-fileio.c. */
9128 /* If *LEFT is at least the length of STRING, copy STRING to
9129 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9130 decrease *LEFT. Otherwise raise an error. */
9133 remote_buffer_add_string (char **buffer
, int *left
, char *string
)
9135 int len
= strlen (string
);
9138 error (_("Packet too long for target."));
9140 memcpy (*buffer
, string
, len
);
9144 /* NUL-terminate the buffer as a convenience, if there is
9150 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
9151 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9152 decrease *LEFT. Otherwise raise an error. */
9155 remote_buffer_add_bytes (char **buffer
, int *left
, const gdb_byte
*bytes
,
9158 if (2 * len
> *left
)
9159 error (_("Packet too long for target."));
9161 bin2hex (bytes
, *buffer
, len
);
9165 /* NUL-terminate the buffer as a convenience, if there is
9171 /* If *LEFT is large enough, convert VALUE to hex and add it to
9172 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9173 decrease *LEFT. Otherwise raise an error. */
9176 remote_buffer_add_int (char **buffer
, int *left
, ULONGEST value
)
9178 int len
= hexnumlen (value
);
9181 error (_("Packet too long for target."));
9183 hexnumstr (*buffer
, value
);
9187 /* NUL-terminate the buffer as a convenience, if there is
9193 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
9194 value, *REMOTE_ERRNO to the remote error number or zero if none
9195 was included, and *ATTACHMENT to point to the start of the annex
9196 if any. The length of the packet isn't needed here; there may
9197 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
9199 Return 0 if the packet could be parsed, -1 if it could not. If
9200 -1 is returned, the other variables may not be initialized. */
9203 remote_hostio_parse_result (char *buffer
, int *retcode
,
9204 int *remote_errno
, char **attachment
)
9211 if (buffer
[0] != 'F')
9215 *retcode
= strtol (&buffer
[1], &p
, 16);
9216 if (errno
!= 0 || p
== &buffer
[1])
9219 /* Check for ",errno". */
9223 *remote_errno
= strtol (p
+ 1, &p2
, 16);
9224 if (errno
!= 0 || p
+ 1 == p2
)
9229 /* Check for ";attachment". If there is no attachment, the
9230 packet should end here. */
9233 *attachment
= p
+ 1;
9236 else if (*p
== '\0')
9242 /* Send a prepared I/O packet to the target and read its response.
9243 The prepared packet is in the global RS->BUF before this function
9244 is called, and the answer is there when we return.
9246 COMMAND_BYTES is the length of the request to send, which may include
9247 binary data. WHICH_PACKET is the packet configuration to check
9248 before attempting a packet. If an error occurs, *REMOTE_ERRNO
9249 is set to the error number and -1 is returned. Otherwise the value
9250 returned by the function is returned.
9252 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
9253 attachment is expected; an error will be reported if there's a
9254 mismatch. If one is found, *ATTACHMENT will be set to point into
9255 the packet buffer and *ATTACHMENT_LEN will be set to the
9256 attachment's length. */
9259 remote_hostio_send_command (int command_bytes
, int which_packet
,
9260 int *remote_errno
, char **attachment
,
9261 int *attachment_len
)
9263 struct remote_state
*rs
= get_remote_state ();
9264 int ret
, bytes_read
;
9265 char *attachment_tmp
;
9268 || remote_protocol_packets
[which_packet
].support
== PACKET_DISABLE
)
9270 *remote_errno
= FILEIO_ENOSYS
;
9274 putpkt_binary (rs
->buf
, command_bytes
);
9275 bytes_read
= getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0);
9277 /* If it timed out, something is wrong. Don't try to parse the
9281 *remote_errno
= FILEIO_EINVAL
;
9285 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[which_packet
]))
9288 *remote_errno
= FILEIO_EINVAL
;
9290 case PACKET_UNKNOWN
:
9291 *remote_errno
= FILEIO_ENOSYS
;
9297 if (remote_hostio_parse_result (rs
->buf
, &ret
, remote_errno
,
9300 *remote_errno
= FILEIO_EINVAL
;
9304 /* Make sure we saw an attachment if and only if we expected one. */
9305 if ((attachment_tmp
== NULL
&& attachment
!= NULL
)
9306 || (attachment_tmp
!= NULL
&& attachment
== NULL
))
9308 *remote_errno
= FILEIO_EINVAL
;
9312 /* If an attachment was found, it must point into the packet buffer;
9313 work out how many bytes there were. */
9314 if (attachment_tmp
!= NULL
)
9316 *attachment
= attachment_tmp
;
9317 *attachment_len
= bytes_read
- (*attachment
- rs
->buf
);
9323 /* Open FILENAME on the remote target, using FLAGS and MODE. Return a
9324 remote file descriptor, or -1 if an error occurs (and set
9328 remote_hostio_open (const char *filename
, int flags
, int mode
,
9331 struct remote_state
*rs
= get_remote_state ();
9333 int left
= get_remote_packet_size () - 1;
9335 remote_buffer_add_string (&p
, &left
, "vFile:open:");
9337 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
9339 remote_buffer_add_string (&p
, &left
, ",");
9341 remote_buffer_add_int (&p
, &left
, flags
);
9342 remote_buffer_add_string (&p
, &left
, ",");
9344 remote_buffer_add_int (&p
, &left
, mode
);
9346 return remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_open
,
9347 remote_errno
, NULL
, NULL
);
9350 /* Write up to LEN bytes from WRITE_BUF to FD on the remote target.
9351 Return the number of bytes written, or -1 if an error occurs (and
9352 set *REMOTE_ERRNO). */
9355 remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
9356 ULONGEST offset
, int *remote_errno
)
9358 struct remote_state
*rs
= get_remote_state ();
9360 int left
= get_remote_packet_size ();
9363 remote_buffer_add_string (&p
, &left
, "vFile:pwrite:");
9365 remote_buffer_add_int (&p
, &left
, fd
);
9366 remote_buffer_add_string (&p
, &left
, ",");
9368 remote_buffer_add_int (&p
, &left
, offset
);
9369 remote_buffer_add_string (&p
, &left
, ",");
9371 p
+= remote_escape_output (write_buf
, len
, p
, &out_len
,
9372 get_remote_packet_size () - (p
- rs
->buf
));
9374 return remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_pwrite
,
9375 remote_errno
, NULL
, NULL
);
9378 /* Read up to LEN bytes FD on the remote target into READ_BUF
9379 Return the number of bytes read, or -1 if an error occurs (and
9380 set *REMOTE_ERRNO). */
9383 remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
9384 ULONGEST offset
, int *remote_errno
)
9386 struct remote_state
*rs
= get_remote_state ();
9389 int left
= get_remote_packet_size ();
9390 int ret
, attachment_len
;
9393 remote_buffer_add_string (&p
, &left
, "vFile:pread:");
9395 remote_buffer_add_int (&p
, &left
, fd
);
9396 remote_buffer_add_string (&p
, &left
, ",");
9398 remote_buffer_add_int (&p
, &left
, len
);
9399 remote_buffer_add_string (&p
, &left
, ",");
9401 remote_buffer_add_int (&p
, &left
, offset
);
9403 ret
= remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_pread
,
9404 remote_errno
, &attachment
,
9410 read_len
= remote_unescape_input (attachment
, attachment_len
,
9412 if (read_len
!= ret
)
9413 error (_("Read returned %d, but %d bytes."), ret
, (int) read_len
);
9418 /* Close FD on the remote target. Return 0, or -1 if an error occurs
9419 (and set *REMOTE_ERRNO). */
9422 remote_hostio_close (int fd
, int *remote_errno
)
9424 struct remote_state
*rs
= get_remote_state ();
9426 int left
= get_remote_packet_size () - 1;
9428 remote_buffer_add_string (&p
, &left
, "vFile:close:");
9430 remote_buffer_add_int (&p
, &left
, fd
);
9432 return remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_close
,
9433 remote_errno
, NULL
, NULL
);
9436 /* Unlink FILENAME on the remote target. Return 0, or -1 if an error
9437 occurs (and set *REMOTE_ERRNO). */
9440 remote_hostio_unlink (const char *filename
, int *remote_errno
)
9442 struct remote_state
*rs
= get_remote_state ();
9444 int left
= get_remote_packet_size () - 1;
9446 remote_buffer_add_string (&p
, &left
, "vFile:unlink:");
9448 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
9451 return remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_unlink
,
9452 remote_errno
, NULL
, NULL
);
9455 /* Read value of symbolic link FILENAME on the remote target. Return
9456 a null-terminated string allocated via xmalloc, or NULL if an error
9457 occurs (and set *REMOTE_ERRNO). */
9460 remote_hostio_readlink (const char *filename
, int *remote_errno
)
9462 struct remote_state
*rs
= get_remote_state ();
9465 int left
= get_remote_packet_size ();
9466 int len
, attachment_len
;
9470 remote_buffer_add_string (&p
, &left
, "vFile:readlink:");
9472 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
9475 len
= remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_readlink
,
9476 remote_errno
, &attachment
,
9482 ret
= xmalloc (len
+ 1);
9484 read_len
= remote_unescape_input (attachment
, attachment_len
,
9486 if (read_len
!= len
)
9487 error (_("Readlink returned %d, but %d bytes."), len
, read_len
);
9494 remote_fileio_errno_to_host (int errnum
)
9518 case FILEIO_ENOTDIR
:
9538 case FILEIO_ENAMETOOLONG
:
9539 return ENAMETOOLONG
;
9545 remote_hostio_error (int errnum
)
9547 int host_error
= remote_fileio_errno_to_host (errnum
);
9549 if (host_error
== -1)
9550 error (_("Unknown remote I/O error %d"), errnum
);
9552 error (_("Remote I/O error: %s"), safe_strerror (host_error
));
9556 remote_hostio_close_cleanup (void *opaque
)
9558 int fd
= *(int *) opaque
;
9561 remote_hostio_close (fd
, &remote_errno
);
9566 remote_bfd_iovec_open (struct bfd
*abfd
, void *open_closure
)
9568 const char *filename
= bfd_get_filename (abfd
);
9569 int fd
, remote_errno
;
9572 gdb_assert (remote_filename_p (filename
));
9574 fd
= remote_hostio_open (filename
+ 7, FILEIO_O_RDONLY
, 0, &remote_errno
);
9577 errno
= remote_fileio_errno_to_host (remote_errno
);
9578 bfd_set_error (bfd_error_system_call
);
9582 stream
= xmalloc (sizeof (int));
9588 remote_bfd_iovec_close (struct bfd
*abfd
, void *stream
)
9590 int fd
= *(int *)stream
;
9595 /* Ignore errors on close; these may happen if the remote
9596 connection was already torn down. */
9597 remote_hostio_close (fd
, &remote_errno
);
9603 remote_bfd_iovec_pread (struct bfd
*abfd
, void *stream
, void *buf
,
9604 file_ptr nbytes
, file_ptr offset
)
9606 int fd
= *(int *)stream
;
9608 file_ptr pos
, bytes
;
9611 while (nbytes
> pos
)
9613 bytes
= remote_hostio_pread (fd
, (char *)buf
+ pos
, nbytes
- pos
,
9614 offset
+ pos
, &remote_errno
);
9616 /* Success, but no bytes, means end-of-file. */
9620 errno
= remote_fileio_errno_to_host (remote_errno
);
9621 bfd_set_error (bfd_error_system_call
);
9632 remote_bfd_iovec_stat (struct bfd
*abfd
, void *stream
, struct stat
*sb
)
9634 /* FIXME: We should probably implement remote_hostio_stat. */
9635 sb
->st_size
= INT_MAX
;
9640 remote_filename_p (const char *filename
)
9642 return strncmp (filename
, "remote:", 7) == 0;
9646 remote_bfd_open (const char *remote_file
, const char *target
)
9648 return bfd_openr_iovec (remote_file
, target
,
9649 remote_bfd_iovec_open
, NULL
,
9650 remote_bfd_iovec_pread
,
9651 remote_bfd_iovec_close
,
9652 remote_bfd_iovec_stat
);
9656 remote_file_put (const char *local_file
, const char *remote_file
, int from_tty
)
9658 struct cleanup
*back_to
, *close_cleanup
;
9659 int retcode
, fd
, remote_errno
, bytes
, io_size
;
9662 int bytes_in_buffer
;
9667 error (_("command can only be used with remote target"));
9669 file
= fopen (local_file
, "rb");
9671 perror_with_name (local_file
);
9672 back_to
= make_cleanup_fclose (file
);
9674 fd
= remote_hostio_open (remote_file
, (FILEIO_O_WRONLY
| FILEIO_O_CREAT
9676 0700, &remote_errno
);
9678 remote_hostio_error (remote_errno
);
9680 /* Send up to this many bytes at once. They won't all fit in the
9681 remote packet limit, so we'll transfer slightly fewer. */
9682 io_size
= get_remote_packet_size ();
9683 buffer
= xmalloc (io_size
);
9684 make_cleanup (xfree
, buffer
);
9686 close_cleanup
= make_cleanup (remote_hostio_close_cleanup
, &fd
);
9688 bytes_in_buffer
= 0;
9691 while (bytes_in_buffer
|| !saw_eof
)
9695 bytes
= fread (buffer
+ bytes_in_buffer
, 1,
9696 io_size
- bytes_in_buffer
,
9701 error (_("Error reading %s."), local_file
);
9704 /* EOF. Unless there is something still in the
9705 buffer from the last iteration, we are done. */
9707 if (bytes_in_buffer
== 0)
9715 bytes
+= bytes_in_buffer
;
9716 bytes_in_buffer
= 0;
9718 retcode
= remote_hostio_pwrite (fd
, buffer
, bytes
,
9719 offset
, &remote_errno
);
9722 remote_hostio_error (remote_errno
);
9723 else if (retcode
== 0)
9724 error (_("Remote write of %d bytes returned 0!"), bytes
);
9725 else if (retcode
< bytes
)
9727 /* Short write. Save the rest of the read data for the next
9729 bytes_in_buffer
= bytes
- retcode
;
9730 memmove (buffer
, buffer
+ retcode
, bytes_in_buffer
);
9736 discard_cleanups (close_cleanup
);
9737 if (remote_hostio_close (fd
, &remote_errno
))
9738 remote_hostio_error (remote_errno
);
9741 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file
);
9742 do_cleanups (back_to
);
9746 remote_file_get (const char *remote_file
, const char *local_file
, int from_tty
)
9748 struct cleanup
*back_to
, *close_cleanup
;
9749 int fd
, remote_errno
, bytes
, io_size
;
9755 error (_("command can only be used with remote target"));
9757 fd
= remote_hostio_open (remote_file
, FILEIO_O_RDONLY
, 0, &remote_errno
);
9759 remote_hostio_error (remote_errno
);
9761 file
= fopen (local_file
, "wb");
9763 perror_with_name (local_file
);
9764 back_to
= make_cleanup_fclose (file
);
9766 /* Send up to this many bytes at once. They won't all fit in the
9767 remote packet limit, so we'll transfer slightly fewer. */
9768 io_size
= get_remote_packet_size ();
9769 buffer
= xmalloc (io_size
);
9770 make_cleanup (xfree
, buffer
);
9772 close_cleanup
= make_cleanup (remote_hostio_close_cleanup
, &fd
);
9777 bytes
= remote_hostio_pread (fd
, buffer
, io_size
, offset
, &remote_errno
);
9779 /* Success, but no bytes, means end-of-file. */
9782 remote_hostio_error (remote_errno
);
9786 bytes
= fwrite (buffer
, 1, bytes
, file
);
9788 perror_with_name (local_file
);
9791 discard_cleanups (close_cleanup
);
9792 if (remote_hostio_close (fd
, &remote_errno
))
9793 remote_hostio_error (remote_errno
);
9796 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file
);
9797 do_cleanups (back_to
);
9801 remote_file_delete (const char *remote_file
, int from_tty
)
9803 int retcode
, remote_errno
;
9806 error (_("command can only be used with remote target"));
9808 retcode
= remote_hostio_unlink (remote_file
, &remote_errno
);
9810 remote_hostio_error (remote_errno
);
9813 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file
);
9817 remote_put_command (char *args
, int from_tty
)
9819 struct cleanup
*back_to
;
9823 error_no_arg (_("file to put"));
9825 argv
= gdb_buildargv (args
);
9826 back_to
= make_cleanup_freeargv (argv
);
9827 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
9828 error (_("Invalid parameters to remote put"));
9830 remote_file_put (argv
[0], argv
[1], from_tty
);
9832 do_cleanups (back_to
);
9836 remote_get_command (char *args
, int from_tty
)
9838 struct cleanup
*back_to
;
9842 error_no_arg (_("file to get"));
9844 argv
= gdb_buildargv (args
);
9845 back_to
= make_cleanup_freeargv (argv
);
9846 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
9847 error (_("Invalid parameters to remote get"));
9849 remote_file_get (argv
[0], argv
[1], from_tty
);
9851 do_cleanups (back_to
);
9855 remote_delete_command (char *args
, int from_tty
)
9857 struct cleanup
*back_to
;
9861 error_no_arg (_("file to delete"));
9863 argv
= gdb_buildargv (args
);
9864 back_to
= make_cleanup_freeargv (argv
);
9865 if (argv
[0] == NULL
|| argv
[1] != NULL
)
9866 error (_("Invalid parameters to remote delete"));
9868 remote_file_delete (argv
[0], from_tty
);
9870 do_cleanups (back_to
);
9874 remote_command (char *args
, int from_tty
)
9876 help_list (remote_cmdlist
, "remote ", -1, gdb_stdout
);
9880 remote_can_execute_reverse (void)
9882 if (remote_protocol_packets
[PACKET_bs
].support
== PACKET_ENABLE
9883 || remote_protocol_packets
[PACKET_bc
].support
== PACKET_ENABLE
)
9890 remote_supports_non_stop (void)
9896 remote_supports_disable_randomization (void)
9898 /* Only supported in extended mode. */
9903 remote_supports_multi_process (void)
9905 struct remote_state
*rs
= get_remote_state ();
9907 /* Only extended-remote handles being attached to multiple
9908 processes, even though plain remote can use the multi-process
9909 thread id extensions, so that GDB knows the target process's
9911 return rs
->extended
&& remote_multi_process_p (rs
);
9915 remote_supports_cond_tracepoints (void)
9917 struct remote_state
*rs
= get_remote_state ();
9919 return rs
->cond_tracepoints
;
9923 remote_supports_cond_breakpoints (void)
9925 struct remote_state
*rs
= get_remote_state ();
9927 return rs
->cond_breakpoints
;
9931 remote_supports_fast_tracepoints (void)
9933 struct remote_state
*rs
= get_remote_state ();
9935 return rs
->fast_tracepoints
;
9939 remote_supports_static_tracepoints (void)
9941 struct remote_state
*rs
= get_remote_state ();
9943 return rs
->static_tracepoints
;
9947 remote_supports_install_in_trace (void)
9949 struct remote_state
*rs
= get_remote_state ();
9951 return rs
->install_in_trace
;
9955 remote_supports_enable_disable_tracepoint (void)
9957 struct remote_state
*rs
= get_remote_state ();
9959 return rs
->enable_disable_tracepoints
;
9963 remote_supports_string_tracing (void)
9965 struct remote_state
*rs
= get_remote_state ();
9967 return rs
->string_tracing
;
9971 remote_trace_init (void)
9974 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
9975 if (strcmp (target_buf
, "OK") != 0)
9976 error (_("Target does not support this command."));
9979 static void free_actions_list (char **actions_list
);
9980 static void free_actions_list_cleanup_wrapper (void *);
9982 free_actions_list_cleanup_wrapper (void *al
)
9984 free_actions_list (al
);
9988 free_actions_list (char **actions_list
)
9992 if (actions_list
== 0)
9995 for (ndx
= 0; actions_list
[ndx
]; ndx
++)
9996 xfree (actions_list
[ndx
]);
9998 xfree (actions_list
);
10001 /* Recursive routine to walk through command list including loops, and
10002 download packets for each command. */
10005 remote_download_command_source (int num
, ULONGEST addr
,
10006 struct command_line
*cmds
)
10008 struct remote_state
*rs
= get_remote_state ();
10009 struct command_line
*cmd
;
10011 for (cmd
= cmds
; cmd
; cmd
= cmd
->next
)
10013 QUIT
; /* Allow user to bail out with ^C. */
10014 strcpy (rs
->buf
, "QTDPsrc:");
10015 encode_source_string (num
, addr
, "cmd", cmd
->line
,
10016 rs
->buf
+ strlen (rs
->buf
),
10017 rs
->buf_size
- strlen (rs
->buf
));
10019 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10020 if (strcmp (target_buf
, "OK"))
10021 warning (_("Target does not support source download."));
10023 if (cmd
->control_type
== while_control
10024 || cmd
->control_type
== while_stepping_control
)
10026 remote_download_command_source (num
, addr
, *cmd
->body_list
);
10028 QUIT
; /* Allow user to bail out with ^C. */
10029 strcpy (rs
->buf
, "QTDPsrc:");
10030 encode_source_string (num
, addr
, "cmd", "end",
10031 rs
->buf
+ strlen (rs
->buf
),
10032 rs
->buf_size
- strlen (rs
->buf
));
10034 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10035 if (strcmp (target_buf
, "OK"))
10036 warning (_("Target does not support source download."));
10042 remote_download_tracepoint (struct bp_location
*loc
)
10048 char **tdp_actions
;
10049 char **stepping_actions
;
10051 struct cleanup
*old_chain
= NULL
;
10052 struct agent_expr
*aexpr
;
10053 struct cleanup
*aexpr_chain
= NULL
;
10055 struct breakpoint
*b
= loc
->owner
;
10056 struct tracepoint
*t
= (struct tracepoint
*) b
;
10058 encode_actions (loc
->owner
, loc
, &tdp_actions
, &stepping_actions
);
10059 old_chain
= make_cleanup (free_actions_list_cleanup_wrapper
,
10061 (void) make_cleanup (free_actions_list_cleanup_wrapper
,
10064 tpaddr
= loc
->address
;
10065 sprintf_vma (addrbuf
, tpaddr
);
10066 sprintf (buf
, "QTDP:%x:%s:%c:%lx:%x", b
->number
,
10067 addrbuf
, /* address */
10068 (b
->enable_state
== bp_enabled
? 'E' : 'D'),
10069 t
->step_count
, t
->pass_count
);
10070 /* Fast tracepoints are mostly handled by the target, but we can
10071 tell the target how big of an instruction block should be moved
10073 if (b
->type
== bp_fast_tracepoint
)
10075 /* Only test for support at download time; we may not know
10076 target capabilities at definition time. */
10077 if (remote_supports_fast_tracepoints ())
10081 if (gdbarch_fast_tracepoint_valid_at (target_gdbarch
,
10082 tpaddr
, &isize
, NULL
))
10083 sprintf (buf
+ strlen (buf
), ":F%x", isize
);
10085 /* If it passed validation at definition but fails now,
10086 something is very wrong. */
10087 internal_error (__FILE__
, __LINE__
,
10088 _("Fast tracepoint not "
10089 "valid during download"));
10092 /* Fast tracepoints are functionally identical to regular
10093 tracepoints, so don't take lack of support as a reason to
10094 give up on the trace run. */
10095 warning (_("Target does not support fast tracepoints, "
10096 "downloading %d as regular tracepoint"), b
->number
);
10098 else if (b
->type
== bp_static_tracepoint
)
10100 /* Only test for support at download time; we may not know
10101 target capabilities at definition time. */
10102 if (remote_supports_static_tracepoints ())
10104 struct static_tracepoint_marker marker
;
10106 if (target_static_tracepoint_marker_at (tpaddr
, &marker
))
10107 strcat (buf
, ":S");
10109 error (_("Static tracepoint not valid during download"));
10112 /* Fast tracepoints are functionally identical to regular
10113 tracepoints, so don't take lack of support as a reason
10114 to give up on the trace run. */
10115 error (_("Target does not support static tracepoints"));
10117 /* If the tracepoint has a conditional, make it into an agent
10118 expression and append to the definition. */
10121 /* Only test support at download time, we may not know target
10122 capabilities at definition time. */
10123 if (remote_supports_cond_tracepoints ())
10125 aexpr
= gen_eval_for_expr (tpaddr
, loc
->cond
);
10126 aexpr_chain
= make_cleanup_free_agent_expr (aexpr
);
10127 sprintf (buf
+ strlen (buf
), ":X%x,", aexpr
->len
);
10128 pkt
= buf
+ strlen (buf
);
10129 for (ndx
= 0; ndx
< aexpr
->len
; ++ndx
)
10130 pkt
= pack_hex_byte (pkt
, aexpr
->buf
[ndx
]);
10132 do_cleanups (aexpr_chain
);
10135 warning (_("Target does not support conditional tracepoints, "
10136 "ignoring tp %d cond"), b
->number
);
10139 if (b
->commands
|| *default_collect
)
10142 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10143 if (strcmp (target_buf
, "OK"))
10144 error (_("Target does not support tracepoints."));
10146 /* do_single_steps (t); */
10149 for (ndx
= 0; tdp_actions
[ndx
]; ndx
++)
10151 QUIT
; /* Allow user to bail out with ^C. */
10152 sprintf (buf
, "QTDP:-%x:%s:%s%c",
10153 b
->number
, addrbuf
, /* address */
10155 ((tdp_actions
[ndx
+ 1] || stepping_actions
)
10158 remote_get_noisy_reply (&target_buf
,
10160 if (strcmp (target_buf
, "OK"))
10161 error (_("Error on target while setting tracepoints."));
10164 if (stepping_actions
)
10166 for (ndx
= 0; stepping_actions
[ndx
]; ndx
++)
10168 QUIT
; /* Allow user to bail out with ^C. */
10169 sprintf (buf
, "QTDP:-%x:%s:%s%s%s",
10170 b
->number
, addrbuf
, /* address */
10171 ((ndx
== 0) ? "S" : ""),
10172 stepping_actions
[ndx
],
10173 (stepping_actions
[ndx
+ 1] ? "-" : ""));
10175 remote_get_noisy_reply (&target_buf
,
10177 if (strcmp (target_buf
, "OK"))
10178 error (_("Error on target while setting tracepoints."));
10182 if (remote_protocol_packets
[PACKET_TracepointSource
].support
10185 if (b
->addr_string
)
10187 strcpy (buf
, "QTDPsrc:");
10188 encode_source_string (b
->number
, loc
->address
,
10189 "at", b
->addr_string
, buf
+ strlen (buf
),
10190 2048 - strlen (buf
));
10193 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10194 if (strcmp (target_buf
, "OK"))
10195 warning (_("Target does not support source download."));
10197 if (b
->cond_string
)
10199 strcpy (buf
, "QTDPsrc:");
10200 encode_source_string (b
->number
, loc
->address
,
10201 "cond", b
->cond_string
, buf
+ strlen (buf
),
10202 2048 - strlen (buf
));
10204 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10205 if (strcmp (target_buf
, "OK"))
10206 warning (_("Target does not support source download."));
10208 remote_download_command_source (b
->number
, loc
->address
,
10209 breakpoint_commands (b
));
10212 do_cleanups (old_chain
);
10216 remote_can_download_tracepoint (void)
10218 struct trace_status
*ts
= current_trace_status ();
10219 int status
= remote_get_trace_status (ts
);
10221 if (status
== -1 || !ts
->running_known
|| !ts
->running
)
10224 /* If we are in a tracing experiment, but remote stub doesn't support
10225 installing tracepoint in trace, we have to return. */
10226 if (!remote_supports_install_in_trace ())
10234 remote_download_trace_state_variable (struct trace_state_variable
*tsv
)
10236 struct remote_state
*rs
= get_remote_state ();
10239 sprintf (rs
->buf
, "QTDV:%x:%s:%x:",
10240 tsv
->number
, phex ((ULONGEST
) tsv
->initial_value
, 8), tsv
->builtin
);
10241 p
= rs
->buf
+ strlen (rs
->buf
);
10242 if ((p
- rs
->buf
) + strlen (tsv
->name
) * 2 >= get_remote_packet_size ())
10243 error (_("Trace state variable name too long for tsv definition packet"));
10244 p
+= 2 * bin2hex ((gdb_byte
*) (tsv
->name
), p
, 0);
10247 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10248 if (*target_buf
== '\0')
10249 error (_("Target does not support this command."));
10250 if (strcmp (target_buf
, "OK") != 0)
10251 error (_("Error on target while downloading trace state variable."));
10255 remote_enable_tracepoint (struct bp_location
*location
)
10257 struct remote_state
*rs
= get_remote_state ();
10260 sprintf_vma (addr_buf
, location
->address
);
10261 sprintf (rs
->buf
, "QTEnable:%x:%s", location
->owner
->number
, addr_buf
);
10263 remote_get_noisy_reply (&rs
->buf
, &rs
->buf_size
);
10264 if (*rs
->buf
== '\0')
10265 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
10266 if (strcmp (rs
->buf
, "OK") != 0)
10267 error (_("Error on target while enabling tracepoint."));
10271 remote_disable_tracepoint (struct bp_location
*location
)
10273 struct remote_state
*rs
= get_remote_state ();
10276 sprintf_vma (addr_buf
, location
->address
);
10277 sprintf (rs
->buf
, "QTDisable:%x:%s", location
->owner
->number
, addr_buf
);
10279 remote_get_noisy_reply (&rs
->buf
, &rs
->buf_size
);
10280 if (*rs
->buf
== '\0')
10281 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
10282 if (strcmp (rs
->buf
, "OK") != 0)
10283 error (_("Error on target while disabling tracepoint."));
10287 remote_trace_set_readonly_regions (void)
10290 bfd_size_type size
;
10296 return; /* No information to give. */
10298 strcpy (target_buf
, "QTro");
10299 for (s
= exec_bfd
->sections
; s
; s
= s
->next
)
10301 char tmp1
[40], tmp2
[40];
10304 if ((s
->flags
& SEC_LOAD
) == 0 ||
10305 /* (s->flags & SEC_CODE) == 0 || */
10306 (s
->flags
& SEC_READONLY
) == 0)
10310 vma
= bfd_get_section_vma (,s
);
10311 size
= bfd_get_section_size (s
);
10312 sprintf_vma (tmp1
, vma
);
10313 sprintf_vma (tmp2
, vma
+ size
);
10314 sec_length
= 1 + strlen (tmp1
) + 1 + strlen (tmp2
);
10315 if (offset
+ sec_length
+ 1 > target_buf_size
)
10317 if (remote_protocol_packets
[PACKET_qXfer_traceframe_info
].support
10320 Too many sections for read-only sections definition packet."));
10323 sprintf (target_buf
+ offset
, ":%s,%s", tmp1
, tmp2
);
10324 offset
+= sec_length
;
10328 putpkt (target_buf
);
10329 getpkt (&target_buf
, &target_buf_size
, 0);
10334 remote_trace_start (void)
10336 putpkt ("QTStart");
10337 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10338 if (*target_buf
== '\0')
10339 error (_("Target does not support this command."));
10340 if (strcmp (target_buf
, "OK") != 0)
10341 error (_("Bogus reply from target: %s"), target_buf
);
10345 remote_get_trace_status (struct trace_status
*ts
)
10347 /* Initialize it just to avoid a GCC false warning. */
10349 /* FIXME we need to get register block size some other way. */
10350 extern int trace_regblock_size
;
10351 volatile struct gdb_exception ex
;
10353 trace_regblock_size
= get_remote_arch_state ()->sizeof_g_packet
;
10355 putpkt ("qTStatus");
10357 TRY_CATCH (ex
, RETURN_MASK_ERROR
)
10359 p
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10363 exception_fprintf (gdb_stderr
, ex
, "qTStatus: ");
10367 /* If the remote target doesn't do tracing, flag it. */
10371 /* We're working with a live target. */
10374 /* Set some defaults. */
10375 ts
->running_known
= 0;
10376 ts
->stop_reason
= trace_stop_reason_unknown
;
10377 ts
->traceframe_count
= -1;
10378 ts
->buffer_free
= 0;
10381 error (_("Bogus trace status reply from target: %s"), target_buf
);
10383 parse_trace_status (p
, ts
);
10385 return ts
->running
;
10389 remote_get_tracepoint_status (struct breakpoint
*bp
,
10390 struct uploaded_tp
*utp
)
10392 struct remote_state
*rs
= get_remote_state ();
10394 struct bp_location
*loc
;
10395 struct tracepoint
*tp
= (struct tracepoint
*) bp
;
10399 tp
->base
.hit_count
= 0;
10400 tp
->traceframe_usage
= 0;
10401 for (loc
= tp
->base
.loc
; loc
; loc
= loc
->next
)
10403 /* If the tracepoint was never downloaded, don't go asking for
10405 if (tp
->number_on_target
== 0)
10407 sprintf (rs
->buf
, "qTP:%x:%s", tp
->number_on_target
,
10408 phex_nz (loc
->address
, 0));
10410 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10411 if (reply
&& *reply
)
10414 parse_tracepoint_status (reply
+ 1, bp
, utp
);
10420 utp
->hit_count
= 0;
10421 utp
->traceframe_usage
= 0;
10422 sprintf (rs
->buf
, "qTP:%x:%s", utp
->number
, phex_nz (utp
->addr
, 0));
10424 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10425 if (reply
&& *reply
)
10428 parse_tracepoint_status (reply
+ 1, bp
, utp
);
10434 remote_trace_stop (void)
10437 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10438 if (*target_buf
== '\0')
10439 error (_("Target does not support this command."));
10440 if (strcmp (target_buf
, "OK") != 0)
10441 error (_("Bogus reply from target: %s"), target_buf
);
10445 remote_trace_find (enum trace_find_type type
, int num
,
10446 ULONGEST addr1
, ULONGEST addr2
,
10449 struct remote_state
*rs
= get_remote_state ();
10451 int target_frameno
= -1, target_tracept
= -1;
10453 /* Lookups other than by absolute frame number depend on the current
10454 trace selected, so make sure it is correct on the remote end
10456 if (type
!= tfind_number
)
10457 set_remote_traceframe ();
10460 strcpy (p
, "QTFrame:");
10461 p
= strchr (p
, '\0');
10465 sprintf (p
, "%x", num
);
10468 sprintf (p
, "pc:%s", phex_nz (addr1
, 0));
10471 sprintf (p
, "tdp:%x", num
);
10474 sprintf (p
, "range:%s:%s", phex_nz (addr1
, 0), phex_nz (addr2
, 0));
10476 case tfind_outside
:
10477 sprintf (p
, "outside:%s:%s", phex_nz (addr1
, 0), phex_nz (addr2
, 0));
10480 error (_("Unknown trace find type %d"), type
);
10484 reply
= remote_get_noisy_reply (&(rs
->buf
), &sizeof_pkt
);
10485 if (*reply
== '\0')
10486 error (_("Target does not support this command."));
10488 while (reply
&& *reply
)
10493 target_frameno
= (int) strtol (p
, &reply
, 16);
10495 error (_("Unable to parse trace frame number"));
10496 /* Don't update our remote traceframe number cache on failure
10497 to select a remote traceframe. */
10498 if (target_frameno
== -1)
10503 target_tracept
= (int) strtol (p
, &reply
, 16);
10505 error (_("Unable to parse tracepoint number"));
10507 case 'O': /* "OK"? */
10508 if (reply
[1] == 'K' && reply
[2] == '\0')
10511 error (_("Bogus reply from target: %s"), reply
);
10514 error (_("Bogus reply from target: %s"), reply
);
10517 *tpp
= target_tracept
;
10519 remote_traceframe_number
= target_frameno
;
10520 return target_frameno
;
10524 remote_get_trace_state_variable_value (int tsvnum
, LONGEST
*val
)
10526 struct remote_state
*rs
= get_remote_state ();
10530 set_remote_traceframe ();
10532 sprintf (rs
->buf
, "qTV:%x", tsvnum
);
10534 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10535 if (reply
&& *reply
)
10539 unpack_varlen_hex (reply
+ 1, &uval
);
10540 *val
= (LONGEST
) uval
;
10548 remote_save_trace_data (const char *filename
)
10550 struct remote_state
*rs
= get_remote_state ();
10554 strcpy (p
, "QTSave:");
10556 if ((p
- rs
->buf
) + strlen (filename
) * 2 >= get_remote_packet_size ())
10557 error (_("Remote file name too long for trace save packet"));
10558 p
+= 2 * bin2hex ((gdb_byte
*) filename
, p
, 0);
10561 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10562 if (*reply
== '\0')
10563 error (_("Target does not support this command."));
10564 if (strcmp (reply
, "OK") != 0)
10565 error (_("Bogus reply from target: %s"), reply
);
10569 /* This is basically a memory transfer, but needs to be its own packet
10570 because we don't know how the target actually organizes its trace
10571 memory, plus we want to be able to ask for as much as possible, but
10572 not be unhappy if we don't get as much as we ask for. */
10575 remote_get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
)
10577 struct remote_state
*rs
= get_remote_state ();
10583 strcpy (p
, "qTBuffer:");
10585 p
+= hexnumstr (p
, offset
);
10587 p
+= hexnumstr (p
, len
);
10591 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10592 if (reply
&& *reply
)
10594 /* 'l' by itself means we're at the end of the buffer and
10595 there is nothing more to get. */
10599 /* Convert the reply into binary. Limit the number of bytes to
10600 convert according to our passed-in buffer size, rather than
10601 what was returned in the packet; if the target is
10602 unexpectedly generous and gives us a bigger reply than we
10603 asked for, we don't want to crash. */
10604 rslt
= hex2bin (target_buf
, buf
, len
);
10608 /* Something went wrong, flag as an error. */
10613 remote_set_disconnected_tracing (int val
)
10615 struct remote_state
*rs
= get_remote_state ();
10617 if (rs
->disconnected_tracing
)
10621 sprintf (rs
->buf
, "QTDisconnected:%x", val
);
10623 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10624 if (*reply
== '\0')
10625 error (_("Target does not support this command."));
10626 if (strcmp (reply
, "OK") != 0)
10627 error (_("Bogus reply from target: %s"), reply
);
10630 warning (_("Target does not support disconnected tracing."));
10634 remote_core_of_thread (struct target_ops
*ops
, ptid_t ptid
)
10636 struct thread_info
*info
= find_thread_ptid (ptid
);
10638 if (info
&& info
->private)
10639 return info
->private->core
;
10644 remote_set_circular_trace_buffer (int val
)
10646 struct remote_state
*rs
= get_remote_state ();
10649 sprintf (rs
->buf
, "QTBuffer:circular:%x", val
);
10651 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10652 if (*reply
== '\0')
10653 error (_("Target does not support this command."));
10654 if (strcmp (reply
, "OK") != 0)
10655 error (_("Bogus reply from target: %s"), reply
);
10658 static struct traceframe_info
*
10659 remote_traceframe_info (void)
10663 text
= target_read_stralloc (¤t_target
,
10664 TARGET_OBJECT_TRACEFRAME_INFO
, NULL
);
10667 struct traceframe_info
*info
;
10668 struct cleanup
*back_to
= make_cleanup (xfree
, text
);
10670 info
= parse_traceframe_info (text
);
10671 do_cleanups (back_to
);
10678 /* Handle the qTMinFTPILen packet. Returns the minimum length of
10679 instruction on which a fast tracepoint may be placed. Returns -1
10680 if the packet is not supported, and 0 if the minimum instruction
10681 length is unknown. */
10684 remote_get_min_fast_tracepoint_insn_len (void)
10686 struct remote_state
*rs
= get_remote_state ();
10689 /* If we're not debugging a process yet, the IPA can't be
10691 if (!target_has_execution
)
10694 /* Make sure the remote is pointing at the right process. */
10695 set_general_process ();
10697 sprintf (rs
->buf
, "qTMinFTPILen");
10699 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10700 if (*reply
== '\0')
10704 ULONGEST min_insn_len
;
10706 unpack_varlen_hex (reply
, &min_insn_len
);
10708 return (int) min_insn_len
;
10713 remote_set_trace_notes (char *user
, char *notes
, char *stop_notes
)
10715 struct remote_state
*rs
= get_remote_state ();
10717 char *buf
= rs
->buf
;
10718 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
10721 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTNotes:");
10724 buf
+= xsnprintf (buf
, endbuf
- buf
, "user:");
10725 nbytes
= bin2hex (user
, buf
, 0);
10731 buf
+= xsnprintf (buf
, endbuf
- buf
, "notes:");
10732 nbytes
= bin2hex (notes
, buf
, 0);
10738 buf
+= xsnprintf (buf
, endbuf
- buf
, "tstop:");
10739 nbytes
= bin2hex (stop_notes
, buf
, 0);
10743 /* Ensure the buffer is terminated. */
10747 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10748 if (*reply
== '\0')
10751 if (strcmp (reply
, "OK") != 0)
10752 error (_("Bogus reply from target: %s"), reply
);
10758 remote_use_agent (int use
)
10760 if (remote_protocol_packets
[PACKET_QAgent
].support
!= PACKET_DISABLE
)
10762 struct remote_state
*rs
= get_remote_state ();
10764 /* If the stub supports QAgent. */
10765 sprintf (rs
->buf
, "QAgent:%d", use
);
10767 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
10769 if (strcmp (rs
->buf
, "OK") == 0)
10780 remote_can_use_agent (void)
10782 return (remote_protocol_packets
[PACKET_QAgent
].support
!= PACKET_DISABLE
);
10786 init_remote_ops (void)
10788 remote_ops
.to_shortname
= "remote";
10789 remote_ops
.to_longname
= "Remote serial target in gdb-specific protocol";
10790 remote_ops
.to_doc
=
10791 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
10792 Specify the serial device it is connected to\n\
10793 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).";
10794 remote_ops
.to_open
= remote_open
;
10795 remote_ops
.to_close
= remote_close
;
10796 remote_ops
.to_detach
= remote_detach
;
10797 remote_ops
.to_disconnect
= remote_disconnect
;
10798 remote_ops
.to_resume
= remote_resume
;
10799 remote_ops
.to_wait
= remote_wait
;
10800 remote_ops
.to_fetch_registers
= remote_fetch_registers
;
10801 remote_ops
.to_store_registers
= remote_store_registers
;
10802 remote_ops
.to_prepare_to_store
= remote_prepare_to_store
;
10803 remote_ops
.deprecated_xfer_memory
= remote_xfer_memory
;
10804 remote_ops
.to_files_info
= remote_files_info
;
10805 remote_ops
.to_insert_breakpoint
= remote_insert_breakpoint
;
10806 remote_ops
.to_remove_breakpoint
= remote_remove_breakpoint
;
10807 remote_ops
.to_stopped_by_watchpoint
= remote_stopped_by_watchpoint
;
10808 remote_ops
.to_stopped_data_address
= remote_stopped_data_address
;
10809 remote_ops
.to_watchpoint_addr_within_range
=
10810 remote_watchpoint_addr_within_range
;
10811 remote_ops
.to_can_use_hw_breakpoint
= remote_check_watch_resources
;
10812 remote_ops
.to_insert_hw_breakpoint
= remote_insert_hw_breakpoint
;
10813 remote_ops
.to_remove_hw_breakpoint
= remote_remove_hw_breakpoint
;
10814 remote_ops
.to_region_ok_for_hw_watchpoint
10815 = remote_region_ok_for_hw_watchpoint
;
10816 remote_ops
.to_insert_watchpoint
= remote_insert_watchpoint
;
10817 remote_ops
.to_remove_watchpoint
= remote_remove_watchpoint
;
10818 remote_ops
.to_kill
= remote_kill
;
10819 remote_ops
.to_load
= generic_load
;
10820 remote_ops
.to_mourn_inferior
= remote_mourn
;
10821 remote_ops
.to_pass_signals
= remote_pass_signals
;
10822 remote_ops
.to_thread_alive
= remote_thread_alive
;
10823 remote_ops
.to_find_new_threads
= remote_threads_info
;
10824 remote_ops
.to_pid_to_str
= remote_pid_to_str
;
10825 remote_ops
.to_extra_thread_info
= remote_threads_extra_info
;
10826 remote_ops
.to_get_ada_task_ptid
= remote_get_ada_task_ptid
;
10827 remote_ops
.to_stop
= remote_stop
;
10828 remote_ops
.to_xfer_partial
= remote_xfer_partial
;
10829 remote_ops
.to_rcmd
= remote_rcmd
;
10830 remote_ops
.to_log_command
= serial_log_command
;
10831 remote_ops
.to_get_thread_local_address
= remote_get_thread_local_address
;
10832 remote_ops
.to_stratum
= process_stratum
;
10833 remote_ops
.to_has_all_memory
= default_child_has_all_memory
;
10834 remote_ops
.to_has_memory
= default_child_has_memory
;
10835 remote_ops
.to_has_stack
= default_child_has_stack
;
10836 remote_ops
.to_has_registers
= default_child_has_registers
;
10837 remote_ops
.to_has_execution
= default_child_has_execution
;
10838 remote_ops
.to_has_thread_control
= tc_schedlock
; /* can lock scheduler */
10839 remote_ops
.to_can_execute_reverse
= remote_can_execute_reverse
;
10840 remote_ops
.to_magic
= OPS_MAGIC
;
10841 remote_ops
.to_memory_map
= remote_memory_map
;
10842 remote_ops
.to_flash_erase
= remote_flash_erase
;
10843 remote_ops
.to_flash_done
= remote_flash_done
;
10844 remote_ops
.to_read_description
= remote_read_description
;
10845 remote_ops
.to_search_memory
= remote_search_memory
;
10846 remote_ops
.to_can_async_p
= remote_can_async_p
;
10847 remote_ops
.to_is_async_p
= remote_is_async_p
;
10848 remote_ops
.to_async
= remote_async
;
10849 remote_ops
.to_terminal_inferior
= remote_terminal_inferior
;
10850 remote_ops
.to_terminal_ours
= remote_terminal_ours
;
10851 remote_ops
.to_supports_non_stop
= remote_supports_non_stop
;
10852 remote_ops
.to_supports_multi_process
= remote_supports_multi_process
;
10853 remote_ops
.to_supports_disable_randomization
10854 = remote_supports_disable_randomization
;
10855 remote_ops
.to_fileio_open
= remote_hostio_open
;
10856 remote_ops
.to_fileio_pwrite
= remote_hostio_pwrite
;
10857 remote_ops
.to_fileio_pread
= remote_hostio_pread
;
10858 remote_ops
.to_fileio_close
= remote_hostio_close
;
10859 remote_ops
.to_fileio_unlink
= remote_hostio_unlink
;
10860 remote_ops
.to_fileio_readlink
= remote_hostio_readlink
;
10861 remote_ops
.to_supports_enable_disable_tracepoint
= remote_supports_enable_disable_tracepoint
;
10862 remote_ops
.to_supports_string_tracing
= remote_supports_string_tracing
;
10863 remote_ops
.to_supports_evaluation_of_breakpoint_conditions
= remote_supports_cond_breakpoints
;
10864 remote_ops
.to_trace_init
= remote_trace_init
;
10865 remote_ops
.to_download_tracepoint
= remote_download_tracepoint
;
10866 remote_ops
.to_can_download_tracepoint
= remote_can_download_tracepoint
;
10867 remote_ops
.to_download_trace_state_variable
10868 = remote_download_trace_state_variable
;
10869 remote_ops
.to_enable_tracepoint
= remote_enable_tracepoint
;
10870 remote_ops
.to_disable_tracepoint
= remote_disable_tracepoint
;
10871 remote_ops
.to_trace_set_readonly_regions
= remote_trace_set_readonly_regions
;
10872 remote_ops
.to_trace_start
= remote_trace_start
;
10873 remote_ops
.to_get_trace_status
= remote_get_trace_status
;
10874 remote_ops
.to_get_tracepoint_status
= remote_get_tracepoint_status
;
10875 remote_ops
.to_trace_stop
= remote_trace_stop
;
10876 remote_ops
.to_trace_find
= remote_trace_find
;
10877 remote_ops
.to_get_trace_state_variable_value
10878 = remote_get_trace_state_variable_value
;
10879 remote_ops
.to_save_trace_data
= remote_save_trace_data
;
10880 remote_ops
.to_upload_tracepoints
= remote_upload_tracepoints
;
10881 remote_ops
.to_upload_trace_state_variables
10882 = remote_upload_trace_state_variables
;
10883 remote_ops
.to_get_raw_trace_data
= remote_get_raw_trace_data
;
10884 remote_ops
.to_get_min_fast_tracepoint_insn_len
= remote_get_min_fast_tracepoint_insn_len
;
10885 remote_ops
.to_set_disconnected_tracing
= remote_set_disconnected_tracing
;
10886 remote_ops
.to_set_circular_trace_buffer
= remote_set_circular_trace_buffer
;
10887 remote_ops
.to_set_trace_notes
= remote_set_trace_notes
;
10888 remote_ops
.to_core_of_thread
= remote_core_of_thread
;
10889 remote_ops
.to_verify_memory
= remote_verify_memory
;
10890 remote_ops
.to_get_tib_address
= remote_get_tib_address
;
10891 remote_ops
.to_set_permissions
= remote_set_permissions
;
10892 remote_ops
.to_static_tracepoint_marker_at
10893 = remote_static_tracepoint_marker_at
;
10894 remote_ops
.to_static_tracepoint_markers_by_strid
10895 = remote_static_tracepoint_markers_by_strid
;
10896 remote_ops
.to_traceframe_info
= remote_traceframe_info
;
10897 remote_ops
.to_use_agent
= remote_use_agent
;
10898 remote_ops
.to_can_use_agent
= remote_can_use_agent
;
10901 /* Set up the extended remote vector by making a copy of the standard
10902 remote vector and adding to it. */
10905 init_extended_remote_ops (void)
10907 extended_remote_ops
= remote_ops
;
10909 extended_remote_ops
.to_shortname
= "extended-remote";
10910 extended_remote_ops
.to_longname
=
10911 "Extended remote serial target in gdb-specific protocol";
10912 extended_remote_ops
.to_doc
=
10913 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
10914 Specify the serial device it is connected to (e.g. /dev/ttya).";
10915 extended_remote_ops
.to_open
= extended_remote_open
;
10916 extended_remote_ops
.to_create_inferior
= extended_remote_create_inferior
;
10917 extended_remote_ops
.to_mourn_inferior
= extended_remote_mourn
;
10918 extended_remote_ops
.to_detach
= extended_remote_detach
;
10919 extended_remote_ops
.to_attach
= extended_remote_attach
;
10920 extended_remote_ops
.to_kill
= extended_remote_kill
;
10921 extended_remote_ops
.to_supports_disable_randomization
10922 = extended_remote_supports_disable_randomization
;
10926 remote_can_async_p (void)
10928 if (!target_async_permitted
)
10929 /* We only enable async when the user specifically asks for it. */
10932 /* We're async whenever the serial device is. */
10933 return serial_can_async_p (remote_desc
);
10937 remote_is_async_p (void)
10939 if (!target_async_permitted
)
10940 /* We only enable async when the user specifically asks for it. */
10943 /* We're async whenever the serial device is. */
10944 return serial_is_async_p (remote_desc
);
10947 /* Pass the SERIAL event on and up to the client. One day this code
10948 will be able to delay notifying the client of an event until the
10949 point where an entire packet has been received. */
10951 static void (*async_client_callback
) (enum inferior_event_type event_type
,
10953 static void *async_client_context
;
10954 static serial_event_ftype remote_async_serial_handler
;
10957 remote_async_serial_handler (struct serial
*scb
, void *context
)
10959 /* Don't propogate error information up to the client. Instead let
10960 the client find out about the error by querying the target. */
10961 async_client_callback (INF_REG_EVENT
, async_client_context
);
10965 remote_async_inferior_event_handler (gdb_client_data data
)
10967 inferior_event_handler (INF_REG_EVENT
, NULL
);
10971 remote_async_get_pending_events_handler (gdb_client_data data
)
10973 remote_get_pending_stop_replies ();
10977 remote_async (void (*callback
) (enum inferior_event_type event_type
,
10978 void *context
), void *context
)
10980 if (callback
!= NULL
)
10982 serial_async (remote_desc
, remote_async_serial_handler
, NULL
);
10983 async_client_callback
= callback
;
10984 async_client_context
= context
;
10987 serial_async (remote_desc
, NULL
, NULL
);
10991 set_remote_cmd (char *args
, int from_tty
)
10993 help_list (remote_set_cmdlist
, "set remote ", -1, gdb_stdout
);
10997 show_remote_cmd (char *args
, int from_tty
)
10999 /* We can't just use cmd_show_list here, because we want to skip
11000 the redundant "show remote Z-packet" and the legacy aliases. */
11001 struct cleanup
*showlist_chain
;
11002 struct cmd_list_element
*list
= remote_show_cmdlist
;
11003 struct ui_out
*uiout
= current_uiout
;
11005 showlist_chain
= make_cleanup_ui_out_tuple_begin_end (uiout
, "showlist");
11006 for (; list
!= NULL
; list
= list
->next
)
11007 if (strcmp (list
->name
, "Z-packet") == 0)
11009 else if (list
->type
== not_set_cmd
)
11010 /* Alias commands are exactly like the original, except they
11011 don't have the normal type. */
11015 struct cleanup
*option_chain
11016 = make_cleanup_ui_out_tuple_begin_end (uiout
, "option");
11018 ui_out_field_string (uiout
, "name", list
->name
);
11019 ui_out_text (uiout
, ": ");
11020 if (list
->type
== show_cmd
)
11021 do_setshow_command ((char *) NULL
, from_tty
, list
);
11023 cmd_func (list
, NULL
, from_tty
);
11024 /* Close the tuple. */
11025 do_cleanups (option_chain
);
11028 /* Close the tuple. */
11029 do_cleanups (showlist_chain
);
11033 /* Function to be called whenever a new objfile (shlib) is detected. */
11035 remote_new_objfile (struct objfile
*objfile
)
11037 if (remote_desc
!= 0) /* Have a remote connection. */
11038 remote_check_symbols (objfile
);
11041 /* Pull all the tracepoints defined on the target and create local
11042 data structures representing them. We don't want to create real
11043 tracepoints yet, we don't want to mess up the user's existing
11047 remote_upload_tracepoints (struct uploaded_tp
**utpp
)
11049 struct remote_state
*rs
= get_remote_state ();
11052 /* Ask for a first packet of tracepoint definition. */
11054 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11056 while (*p
&& *p
!= 'l')
11058 parse_tracepoint_definition (p
, utpp
);
11059 /* Ask for another packet of tracepoint definition. */
11061 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11068 remote_upload_trace_state_variables (struct uploaded_tsv
**utsvp
)
11070 struct remote_state
*rs
= get_remote_state ();
11073 /* Ask for a first packet of variable definition. */
11075 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11077 while (*p
&& *p
!= 'l')
11079 parse_tsv_definition (p
, utsvp
);
11080 /* Ask for another packet of variable definition. */
11082 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11089 _initialize_remote (void)
11091 struct remote_state
*rs
;
11092 struct cmd_list_element
*cmd
;
11095 /* architecture specific data */
11096 remote_gdbarch_data_handle
=
11097 gdbarch_data_register_post_init (init_remote_state
);
11098 remote_g_packet_data_handle
=
11099 gdbarch_data_register_pre_init (remote_g_packet_data_init
);
11101 /* Initialize the per-target state. At the moment there is only one
11102 of these, not one per target. Only one target is active at a
11103 time. The default buffer size is unimportant; it will be expanded
11104 whenever a larger buffer is needed. */
11105 rs
= get_remote_state_raw ();
11106 rs
->buf_size
= 400;
11107 rs
->buf
= xmalloc (rs
->buf_size
);
11109 init_remote_ops ();
11110 add_target (&remote_ops
);
11112 init_extended_remote_ops ();
11113 add_target (&extended_remote_ops
);
11115 /* Hook into new objfile notification. */
11116 observer_attach_new_objfile (remote_new_objfile
);
11118 /* Set up signal handlers. */
11119 sigint_remote_token
=
11120 create_async_signal_handler (async_remote_interrupt
, NULL
);
11121 sigint_remote_twice_token
=
11122 create_async_signal_handler (async_remote_interrupt_twice
, NULL
);
11125 init_remote_threadtests ();
11128 /* set/show remote ... */
11130 add_prefix_cmd ("remote", class_maintenance
, set_remote_cmd
, _("\
11131 Remote protocol specific variables\n\
11132 Configure various remote-protocol specific variables such as\n\
11133 the packets being used"),
11134 &remote_set_cmdlist
, "set remote ",
11135 0 /* allow-unknown */, &setlist
);
11136 add_prefix_cmd ("remote", class_maintenance
, show_remote_cmd
, _("\
11137 Remote protocol specific variables\n\
11138 Configure various remote-protocol specific variables such as\n\
11139 the packets being used"),
11140 &remote_show_cmdlist
, "show remote ",
11141 0 /* allow-unknown */, &showlist
);
11143 add_cmd ("compare-sections", class_obscure
, compare_sections_command
, _("\
11144 Compare section data on target to the exec file.\n\
11145 Argument is a single section name (default: all loaded sections)."),
11148 add_cmd ("packet", class_maintenance
, packet_command
, _("\
11149 Send an arbitrary packet to a remote target.\n\
11150 maintenance packet TEXT\n\
11151 If GDB is talking to an inferior via the GDB serial protocol, then\n\
11152 this command sends the string TEXT to the inferior, and displays the\n\
11153 response packet. GDB supplies the initial `$' character, and the\n\
11154 terminating `#' character and checksum."),
11157 add_setshow_boolean_cmd ("remotebreak", no_class
, &remote_break
, _("\
11158 Set whether to send break if interrupted."), _("\
11159 Show whether to send break if interrupted."), _("\
11160 If set, a break, instead of a cntrl-c, is sent to the remote target."),
11161 set_remotebreak
, show_remotebreak
,
11162 &setlist
, &showlist
);
11163 cmd_name
= "remotebreak";
11164 cmd
= lookup_cmd (&cmd_name
, setlist
, "", -1, 1);
11165 deprecate_cmd (cmd
, "set remote interrupt-sequence");
11166 cmd_name
= "remotebreak"; /* needed because lookup_cmd updates the pointer */
11167 cmd
= lookup_cmd (&cmd_name
, showlist
, "", -1, 1);
11168 deprecate_cmd (cmd
, "show remote interrupt-sequence");
11170 add_setshow_enum_cmd ("interrupt-sequence", class_support
,
11171 interrupt_sequence_modes
, &interrupt_sequence_mode
,
11173 Set interrupt sequence to remote target."), _("\
11174 Show interrupt sequence to remote target."), _("\
11175 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
11176 NULL
, show_interrupt_sequence
,
11177 &remote_set_cmdlist
,
11178 &remote_show_cmdlist
);
11180 add_setshow_boolean_cmd ("interrupt-on-connect", class_support
,
11181 &interrupt_on_connect
, _("\
11182 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
11183 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
11184 If set, interrupt sequence is sent to remote target."),
11186 &remote_set_cmdlist
, &remote_show_cmdlist
);
11188 /* Install commands for configuring memory read/write packets. */
11190 add_cmd ("remotewritesize", no_class
, set_memory_write_packet_size
, _("\
11191 Set the maximum number of bytes per memory write packet (deprecated)."),
11193 add_cmd ("remotewritesize", no_class
, show_memory_write_packet_size
, _("\
11194 Show the maximum number of bytes per memory write packet (deprecated)."),
11196 add_cmd ("memory-write-packet-size", no_class
,
11197 set_memory_write_packet_size
, _("\
11198 Set the maximum number of bytes per memory-write packet.\n\
11199 Specify the number of bytes in a packet or 0 (zero) for the\n\
11200 default packet size. The actual limit is further reduced\n\
11201 dependent on the target. Specify ``fixed'' to disable the\n\
11202 further restriction and ``limit'' to enable that restriction."),
11203 &remote_set_cmdlist
);
11204 add_cmd ("memory-read-packet-size", no_class
,
11205 set_memory_read_packet_size
, _("\
11206 Set the maximum number of bytes per memory-read packet.\n\
11207 Specify the number of bytes in a packet or 0 (zero) for the\n\
11208 default packet size. The actual limit is further reduced\n\
11209 dependent on the target. Specify ``fixed'' to disable the\n\
11210 further restriction and ``limit'' to enable that restriction."),
11211 &remote_set_cmdlist
);
11212 add_cmd ("memory-write-packet-size", no_class
,
11213 show_memory_write_packet_size
,
11214 _("Show the maximum number of bytes per memory-write packet."),
11215 &remote_show_cmdlist
);
11216 add_cmd ("memory-read-packet-size", no_class
,
11217 show_memory_read_packet_size
,
11218 _("Show the maximum number of bytes per memory-read packet."),
11219 &remote_show_cmdlist
);
11221 add_setshow_zinteger_cmd ("hardware-watchpoint-limit", no_class
,
11222 &remote_hw_watchpoint_limit
, _("\
11223 Set the maximum number of target hardware watchpoints."), _("\
11224 Show the maximum number of target hardware watchpoints."), _("\
11225 Specify a negative limit for unlimited."),
11226 NULL
, NULL
, /* FIXME: i18n: The maximum
11227 number of target hardware
11228 watchpoints is %s. */
11229 &remote_set_cmdlist
, &remote_show_cmdlist
);
11230 add_setshow_zinteger_cmd ("hardware-watchpoint-length-limit", no_class
,
11231 &remote_hw_watchpoint_length_limit
, _("\
11232 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
11233 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
11234 Specify a negative limit for unlimited."),
11235 NULL
, NULL
, /* FIXME: i18n: The maximum
11236 length (in bytes) of a target
11237 hardware watchpoint is %s. */
11238 &remote_set_cmdlist
, &remote_show_cmdlist
);
11239 add_setshow_zinteger_cmd ("hardware-breakpoint-limit", no_class
,
11240 &remote_hw_breakpoint_limit
, _("\
11241 Set the maximum number of target hardware breakpoints."), _("\
11242 Show the maximum number of target hardware breakpoints."), _("\
11243 Specify a negative limit for unlimited."),
11244 NULL
, NULL
, /* FIXME: i18n: The maximum
11245 number of target hardware
11246 breakpoints is %s. */
11247 &remote_set_cmdlist
, &remote_show_cmdlist
);
11249 add_setshow_integer_cmd ("remoteaddresssize", class_obscure
,
11250 &remote_address_size
, _("\
11251 Set the maximum size of the address (in bits) in a memory packet."), _("\
11252 Show the maximum size of the address (in bits) in a memory packet."), NULL
,
11254 NULL
, /* FIXME: i18n: */
11255 &setlist
, &showlist
);
11257 add_packet_config_cmd (&remote_protocol_packets
[PACKET_X
],
11258 "X", "binary-download", 1);
11260 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCont
],
11261 "vCont", "verbose-resume", 0);
11263 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QPassSignals
],
11264 "QPassSignals", "pass-signals", 0);
11266 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSymbol
],
11267 "qSymbol", "symbol-lookup", 0);
11269 add_packet_config_cmd (&remote_protocol_packets
[PACKET_P
],
11270 "P", "set-register", 1);
11272 add_packet_config_cmd (&remote_protocol_packets
[PACKET_p
],
11273 "p", "fetch-register", 1);
11275 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
],
11276 "Z0", "software-breakpoint", 0);
11278 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z1
],
11279 "Z1", "hardware-breakpoint", 0);
11281 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z2
],
11282 "Z2", "write-watchpoint", 0);
11284 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z3
],
11285 "Z3", "read-watchpoint", 0);
11287 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z4
],
11288 "Z4", "access-watchpoint", 0);
11290 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_auxv
],
11291 "qXfer:auxv:read", "read-aux-vector", 0);
11293 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_features
],
11294 "qXfer:features:read", "target-features", 0);
11296 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries
],
11297 "qXfer:libraries:read", "library-info", 0);
11299 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries_svr4
],
11300 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
11302 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_memory_map
],
11303 "qXfer:memory-map:read", "memory-map", 0);
11305 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_spu_read
],
11306 "qXfer:spu:read", "read-spu-object", 0);
11308 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_spu_write
],
11309 "qXfer:spu:write", "write-spu-object", 0);
11311 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_osdata
],
11312 "qXfer:osdata:read", "osdata", 0);
11314 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_threads
],
11315 "qXfer:threads:read", "threads", 0);
11317 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_read
],
11318 "qXfer:siginfo:read", "read-siginfo-object", 0);
11320 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_write
],
11321 "qXfer:siginfo:write", "write-siginfo-object", 0);
11323 add_packet_config_cmd
11324 (&remote_protocol_packets
[PACKET_qXfer_traceframe_info
],
11325 "qXfer:trace-frame-info:read", "traceframe-info", 0);
11327 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_uib
],
11328 "qXfer:uib:read", "unwind-info-block", 0);
11330 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTLSAddr
],
11331 "qGetTLSAddr", "get-thread-local-storage-address",
11334 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTIBAddr
],
11335 "qGetTIBAddr", "get-thread-information-block-address",
11338 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bc
],
11339 "bc", "reverse-continue", 0);
11341 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bs
],
11342 "bs", "reverse-step", 0);
11344 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSupported
],
11345 "qSupported", "supported-packets", 0);
11347 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSearch_memory
],
11348 "qSearch:memory", "search-memory", 0);
11350 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_open
],
11351 "vFile:open", "hostio-open", 0);
11353 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pread
],
11354 "vFile:pread", "hostio-pread", 0);
11356 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pwrite
],
11357 "vFile:pwrite", "hostio-pwrite", 0);
11359 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_close
],
11360 "vFile:close", "hostio-close", 0);
11362 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_unlink
],
11363 "vFile:unlink", "hostio-unlink", 0);
11365 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_readlink
],
11366 "vFile:readlink", "hostio-readlink", 0);
11368 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vAttach
],
11369 "vAttach", "attach", 0);
11371 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vRun
],
11374 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartNoAckMode
],
11375 "QStartNoAckMode", "noack", 0);
11377 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vKill
],
11378 "vKill", "kill", 0);
11380 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qAttached
],
11381 "qAttached", "query-attached", 0);
11383 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalTracepoints
],
11384 "ConditionalTracepoints",
11385 "conditional-tracepoints", 0);
11387 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalBreakpoints
],
11388 "ConditionalBreakpoints",
11389 "conditional-breakpoints", 0);
11391 add_packet_config_cmd (&remote_protocol_packets
[PACKET_FastTracepoints
],
11392 "FastTracepoints", "fast-tracepoints", 0);
11394 add_packet_config_cmd (&remote_protocol_packets
[PACKET_TracepointSource
],
11395 "TracepointSource", "TracepointSource", 0);
11397 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAllow
],
11398 "QAllow", "allow", 0);
11400 add_packet_config_cmd (&remote_protocol_packets
[PACKET_StaticTracepoints
],
11401 "StaticTracepoints", "static-tracepoints", 0);
11403 add_packet_config_cmd (&remote_protocol_packets
[PACKET_InstallInTrace
],
11404 "InstallInTrace", "install-in-trace", 0);
11406 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_statictrace_read
],
11407 "qXfer:statictrace:read", "read-sdata-object", 0);
11409 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_fdpic
],
11410 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
11412 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QDisableRandomization
],
11413 "QDisableRandomization", "disable-randomization", 0);
11415 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAgent
],
11416 "QAgent", "agent", 0);
11418 /* Keep the old ``set remote Z-packet ...'' working. Each individual
11419 Z sub-packet has its own set and show commands, but users may
11420 have sets to this variable in their .gdbinit files (or in their
11422 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure
,
11423 &remote_Z_packet_detect
, _("\
11424 Set use of remote protocol `Z' packets"), _("\
11425 Show use of remote protocol `Z' packets "), _("\
11426 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
11428 set_remote_protocol_Z_packet_cmd
,
11429 show_remote_protocol_Z_packet_cmd
,
11430 /* FIXME: i18n: Use of remote protocol
11431 `Z' packets is %s. */
11432 &remote_set_cmdlist
, &remote_show_cmdlist
);
11434 add_prefix_cmd ("remote", class_files
, remote_command
, _("\
11435 Manipulate files on the remote system\n\
11436 Transfer files to and from the remote target system."),
11437 &remote_cmdlist
, "remote ",
11438 0 /* allow-unknown */, &cmdlist
);
11440 add_cmd ("put", class_files
, remote_put_command
,
11441 _("Copy a local file to the remote system."),
11444 add_cmd ("get", class_files
, remote_get_command
,
11445 _("Copy a remote file to the local system."),
11448 add_cmd ("delete", class_files
, remote_delete_command
,
11449 _("Delete a remote file."),
11452 remote_exec_file
= xstrdup ("");
11453 add_setshow_string_noescape_cmd ("exec-file", class_files
,
11454 &remote_exec_file
, _("\
11455 Set the remote pathname for \"run\""), _("\
11456 Show the remote pathname for \"run\""), NULL
, NULL
, NULL
,
11457 &remote_set_cmdlist
, &remote_show_cmdlist
);
11459 /* Eventually initialize fileio. See fileio.c */
11460 initialize_remote_fileio (remote_set_cmdlist
, remote_show_cmdlist
);
11462 /* Take advantage of the fact that the LWP field is not used, to tag
11463 special ptids with it set to != 0. */
11464 magic_null_ptid
= ptid_build (42000, 1, -1);
11465 not_sent_ptid
= ptid_build (42000, 1, -2);
11466 any_thread_ptid
= ptid_build (42000, 1, 0);
11468 target_buf_size
= 2048;
11469 target_buf
= xmalloc (target_buf_size
);