1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2014 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. */
29 #include "exceptions.h"
31 /*#include "terminal.h" */
34 #include "gdb-stabs.h"
35 #include "gdbthread.h"
37 #include "remote-notif.h"
40 #include "gdb_assert.h"
43 #include "cli/cli-decode.h"
44 #include "cli/cli-setshow.h"
45 #include "target-descriptions.h"
47 #include "filestuff.h"
52 #include "event-loop.h"
53 #include "event-top.h"
59 #include "gdbcore.h" /* for exec_bfd */
61 #include "remote-fileio.h"
62 #include "gdb/fileio.h"
64 #include "xml-support.h"
66 #include "memory-map.h"
68 #include "tracepoint.h"
74 /* Temp hacks for tracepoint encoding migration. */
75 static char *target_buf
;
76 static long target_buf_size
;
78 /* The size to align memory write packets, when practical. The protocol
79 does not guarantee any alignment, and gdb will generate short
80 writes and unaligned writes, but even as a best-effort attempt this
81 can improve bulk transfers. For instance, if a write is misaligned
82 relative to the target's data bus, the stub may need to make an extra
83 round trip fetching data from the target. This doesn't make a
84 huge difference, but it's easy to do, so we try to be helpful.
86 The alignment chosen is arbitrary; usually data bus width is
87 important here, not the possibly larger cache line size. */
88 enum { REMOTE_ALIGN_WRITES
= 16 };
90 /* Prototypes for local functions. */
91 static void async_cleanup_sigint_signal_handler (void *dummy
);
92 static int getpkt_sane (char **buf
, long *sizeof_buf
, int forever
);
93 static int getpkt_or_notif_sane (char **buf
, long *sizeof_buf
,
94 int forever
, int *is_notif
);
96 static void async_handle_remote_sigint (int);
97 static void async_handle_remote_sigint_twice (int);
99 static void remote_files_info (struct target_ops
*ignore
);
101 static void remote_prepare_to_store (struct target_ops
*self
,
102 struct regcache
*regcache
);
104 static void remote_open (char *name
, int from_tty
);
106 static void extended_remote_open (char *name
, int from_tty
);
108 static void remote_open_1 (char *, int, struct target_ops
*, int extended_p
);
110 static void remote_close (struct target_ops
*self
);
112 static void remote_mourn (struct target_ops
*ops
);
114 static void extended_remote_restart (void);
116 static void extended_remote_mourn (struct target_ops
*);
118 static void remote_mourn_1 (struct target_ops
*);
120 static void remote_send (char **buf
, long *sizeof_buf_p
);
122 static int readchar (int timeout
);
124 static void remote_serial_write (const char *str
, int len
);
126 static void remote_kill (struct target_ops
*ops
);
128 static int remote_can_async_p (struct target_ops
*);
130 static int remote_is_async_p (struct target_ops
*);
132 static void remote_async (struct target_ops
*ops
,
133 void (*callback
) (enum inferior_event_type event_type
,
137 static void sync_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 (struct target_ops
*self
, ptid_t
);
158 static int stubhex (int ch
);
160 static int hexnumstr (char *, ULONGEST
);
162 static int hexnumnstr (char *, ULONGEST
, int);
164 static CORE_ADDR
remote_address_masked (CORE_ADDR
);
166 static void print_packet (char *);
168 static void compare_sections_command (char *, int);
170 static void packet_command (char *, int);
172 static int stub_unpack_int (char *buff
, int fieldlength
);
174 static ptid_t
remote_current_thread (ptid_t oldptid
);
176 static void remote_find_new_threads (void);
178 static int putpkt_binary (char *buf
, int cnt
);
180 static void check_binary_download (CORE_ADDR addr
);
182 struct packet_config
;
184 static void show_packet_config_cmd (struct packet_config
*config
);
186 static void update_packet_config (struct packet_config
*config
);
188 static void set_remote_protocol_packet_cmd (char *args
, int from_tty
,
189 struct cmd_list_element
*c
);
191 static void show_remote_protocol_packet_cmd (struct ui_file
*file
,
193 struct cmd_list_element
*c
,
196 static char *write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
);
197 static ptid_t
read_ptid (char *buf
, char **obuf
);
199 static void remote_set_permissions (struct target_ops
*self
);
202 static int remote_get_trace_status (struct target_ops
*self
,
203 struct trace_status
*ts
);
205 static int remote_upload_tracepoints (struct target_ops
*self
,
206 struct uploaded_tp
**utpp
);
208 static int remote_upload_trace_state_variables (struct target_ops
*self
,
209 struct uploaded_tsv
**utsvp
);
211 static void remote_query_supported (void);
213 static void remote_check_symbols (void);
215 void _initialize_remote (void);
218 static void stop_reply_xfree (struct stop_reply
*);
219 static void remote_parse_stop_reply (char *, struct stop_reply
*);
220 static void push_stop_reply (struct stop_reply
*);
221 static void discard_pending_stop_replies_in_queue (struct remote_state
*);
222 static int peek_stop_reply (ptid_t ptid
);
224 static void remote_async_inferior_event_handler (gdb_client_data
);
226 static void remote_terminal_ours (struct target_ops
*self
);
228 static int remote_read_description_p (struct target_ops
*target
);
230 static void remote_console_output (char *msg
);
232 static int remote_supports_cond_breakpoints (struct target_ops
*self
);
234 static int remote_can_run_breakpoint_commands (struct target_ops
*self
);
238 static struct cmd_list_element
*remote_cmdlist
;
240 /* For "set remote" and "show remote". */
242 static struct cmd_list_element
*remote_set_cmdlist
;
243 static struct cmd_list_element
*remote_show_cmdlist
;
245 /* Stub vCont actions support.
247 Each field is a boolean flag indicating whether the stub reports
248 support for the corresponding action. */
250 struct vCont_action_support
259 /* Controls whether GDB is willing to use range stepping. */
261 static int use_range_stepping
= 1;
263 #define OPAQUETHREADBYTES 8
265 /* a 64 bit opaque identifier */
266 typedef unsigned char threadref
[OPAQUETHREADBYTES
];
268 /* About this many threadisds fit in a packet. */
270 #define MAXTHREADLISTRESULTS 32
272 /* Description of the remote protocol state for the currently
273 connected target. This is per-target state, and independent of the
274 selected architecture. */
278 /* A buffer to use for incoming packets, and its current size. The
279 buffer is grown dynamically for larger incoming packets.
280 Outgoing packets may also be constructed in this buffer.
281 BUF_SIZE is always at least REMOTE_PACKET_SIZE;
282 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
287 /* True if we're going through initial connection setup (finding out
288 about the remote side's threads, relocating symbols, etc.). */
291 /* If we negotiated packet size explicitly (and thus can bypass
292 heuristics for the largest packet size that will not overflow
293 a buffer in the stub), this will be set to that packet size.
294 Otherwise zero, meaning to use the guessed size. */
295 long explicit_packet_size
;
297 /* remote_wait is normally called when the target is running and
298 waits for a stop reply packet. But sometimes we need to call it
299 when the target is already stopped. We can send a "?" packet
300 and have remote_wait read the response. Or, if we already have
301 the response, we can stash it in BUF and tell remote_wait to
302 skip calling getpkt. This flag is set when BUF contains a
303 stop reply packet and the target is not waiting. */
304 int cached_wait_status
;
306 /* True, if in no ack mode. That is, neither GDB nor the stub will
307 expect acks from each other. The connection is assumed to be
311 /* True if we're connected in extended remote mode. */
314 /* True if the stub reported support for multi-process
316 int multi_process_aware
;
318 /* True if we resumed the target and we're waiting for the target to
319 stop. In the mean time, we can't start another command/query.
320 The remote server wouldn't be ready to process it, so we'd
321 timeout waiting for a reply that would never come and eventually
322 we'd close the connection. This can happen in asynchronous mode
323 because we allow GDB commands while the target is running. */
324 int waiting_for_stop_reply
;
326 /* True if the stub reports support for non-stop mode. */
329 /* The status of the stub support for the various vCont actions. */
330 struct vCont_action_support supports_vCont
;
332 /* True if the stub reports support for conditional tracepoints. */
333 int cond_tracepoints
;
335 /* True if the stub reports support for target-side breakpoint
337 int cond_breakpoints
;
339 /* True if the stub reports support for target-side breakpoint
341 int breakpoint_commands
;
343 /* True if the stub reports support for fast tracepoints. */
344 int fast_tracepoints
;
346 /* True if the stub reports support for static tracepoints. */
347 int static_tracepoints
;
349 /* True if the stub reports support for installing tracepoint while
351 int install_in_trace
;
353 /* True if the stub can continue running a trace while GDB is
355 int disconnected_tracing
;
357 /* True if the stub reports support for enabling and disabling
358 tracepoints while a trace experiment is running. */
359 int enable_disable_tracepoints
;
361 /* True if the stub can collect strings using tracenz bytecode. */
364 /* True if the stub supports qXfer:libraries-svr4:read with a
366 int augmented_libraries_svr4_read
;
368 /* Nonzero if the user has pressed Ctrl-C, but the target hasn't
369 responded to that. */
372 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
373 remote_open knows that we don't have a file open when the program
375 struct serial
*remote_desc
;
377 /* These are the threads which we last sent to the remote system. The
378 TID member will be -1 for all or -2 for not sent yet. */
379 ptid_t general_thread
;
380 ptid_t continue_thread
;
382 /* This is the traceframe which we last selected on the remote system.
383 It will be -1 if no traceframe is selected. */
384 int remote_traceframe_number
;
386 char *last_pass_packet
;
388 /* The last QProgramSignals packet sent to the target. We bypass
389 sending a new program signals list down to the target if the new
390 packet is exactly the same as the last we sent. IOW, we only let
391 the target know about program signals list changes. */
392 char *last_program_signals_packet
;
394 enum gdb_signal last_sent_signal
;
398 char *finished_object
;
399 char *finished_annex
;
400 ULONGEST finished_offset
;
402 /* Should we try the 'ThreadInfo' query packet?
404 This variable (NOT available to the user: auto-detect only!)
405 determines whether GDB will use the new, simpler "ThreadInfo"
406 query or the older, more complex syntax for thread queries.
407 This is an auto-detect variable (set to true at each connect,
408 and set to false when the target fails to recognize it). */
409 int use_threadinfo_query
;
410 int use_threadextra_query
;
412 void (*async_client_callback
) (enum inferior_event_type event_type
,
414 void *async_client_context
;
416 /* This is set to the data address of the access causing the target
417 to stop for a watchpoint. */
418 CORE_ADDR remote_watch_data_address
;
420 /* This is non-zero if target stopped for a watchpoint. */
421 int remote_stopped_by_watchpoint_p
;
423 threadref echo_nextthread
;
424 threadref nextthread
;
425 threadref resultthreadlist
[MAXTHREADLISTRESULTS
];
427 /* The state of remote notification. */
428 struct remote_notif_state
*notif_state
;
431 /* Private data that we'll store in (struct thread_info)->private. */
432 struct private_thread_info
439 free_private_thread_info (struct private_thread_info
*info
)
445 /* Returns true if the multi-process extensions are in effect. */
447 remote_multi_process_p (struct remote_state
*rs
)
449 return rs
->multi_process_aware
;
452 /* This data could be associated with a target, but we do not always
453 have access to the current target when we need it, so for now it is
454 static. This will be fine for as long as only one target is in use
456 static struct remote_state
*remote_state
;
458 static struct remote_state
*
459 get_remote_state_raw (void)
464 /* Allocate a new struct remote_state with xmalloc, initialize it, and
467 static struct remote_state
*
468 new_remote_state (void)
470 struct remote_state
*result
= XCNEW (struct remote_state
);
472 /* The default buffer size is unimportant; it will be expanded
473 whenever a larger buffer is needed. */
474 result
->buf_size
= 400;
475 result
->buf
= xmalloc (result
->buf_size
);
476 result
->remote_traceframe_number
= -1;
477 result
->last_sent_signal
= GDB_SIGNAL_0
;
482 /* Description of the remote protocol for a given architecture. */
486 long offset
; /* Offset into G packet. */
487 long regnum
; /* GDB's internal register number. */
488 LONGEST pnum
; /* Remote protocol register number. */
489 int in_g_packet
; /* Always part of G packet. */
490 /* long size in bytes; == register_size (target_gdbarch (), regnum);
492 /* char *name; == gdbarch_register_name (target_gdbarch (), regnum);
496 struct remote_arch_state
498 /* Description of the remote protocol registers. */
499 long sizeof_g_packet
;
501 /* Description of the remote protocol registers indexed by REGNUM
502 (making an array gdbarch_num_regs in size). */
503 struct packet_reg
*regs
;
505 /* This is the size (in chars) of the first response to the ``g''
506 packet. It is used as a heuristic when determining the maximum
507 size of memory-read and memory-write packets. A target will
508 typically only reserve a buffer large enough to hold the ``g''
509 packet. The size does not include packet overhead (headers and
511 long actual_register_packet_size
;
513 /* This is the maximum size (in chars) of a non read/write packet.
514 It is also used as a cap on the size of read/write packets. */
515 long remote_packet_size
;
518 /* Utility: generate error from an incoming stub packet. */
520 trace_error (char *buf
)
523 return; /* not an error msg */
526 case '1': /* malformed packet error */
527 if (*++buf
== '0') /* general case: */
528 error (_("remote.c: error in outgoing packet."));
530 error (_("remote.c: error in outgoing packet at field #%ld."),
531 strtol (buf
, NULL
, 16));
533 error (_("Target returns error code '%s'."), buf
);
537 /* Utility: wait for reply from stub, while accepting "O" packets. */
539 remote_get_noisy_reply (char **buf_p
,
542 do /* Loop on reply from remote stub. */
546 QUIT
; /* Allow user to bail out with ^C. */
547 getpkt (buf_p
, sizeof_buf
, 0);
551 else if (strncmp (buf
, "qRelocInsn:", strlen ("qRelocInsn:")) == 0)
554 CORE_ADDR from
, to
, org_to
;
556 int adjusted_size
= 0;
557 volatile struct gdb_exception ex
;
559 p
= buf
+ strlen ("qRelocInsn:");
560 pp
= unpack_varlen_hex (p
, &ul
);
562 error (_("invalid qRelocInsn packet: %s"), buf
);
566 unpack_varlen_hex (p
, &ul
);
571 TRY_CATCH (ex
, RETURN_MASK_ALL
)
573 gdbarch_relocate_instruction (target_gdbarch (), &to
, from
);
577 adjusted_size
= to
- org_to
;
579 xsnprintf (buf
, *sizeof_buf
, "qRelocInsn:%x", adjusted_size
);
582 else if (ex
.reason
< 0 && ex
.error
== MEMORY_ERROR
)
584 /* Propagate memory errors silently back to the target.
585 The stub may have limited the range of addresses we
586 can write to, for example. */
591 /* Something unexpectedly bad happened. Be verbose so
592 we can tell what, and propagate the error back to the
593 stub, so it doesn't get stuck waiting for a
595 exception_fprintf (gdb_stderr
, ex
,
596 _("warning: relocating instruction: "));
600 else if (buf
[0] == 'O' && buf
[1] != 'K')
601 remote_console_output (buf
+ 1); /* 'O' message from stub */
603 return buf
; /* Here's the actual reply. */
608 /* Handle for retreving the remote protocol data from gdbarch. */
609 static struct gdbarch_data
*remote_gdbarch_data_handle
;
611 static struct remote_arch_state
*
612 get_remote_arch_state (void)
614 return gdbarch_data (target_gdbarch (), remote_gdbarch_data_handle
);
617 /* Fetch the global remote target state. */
619 static struct remote_state
*
620 get_remote_state (void)
622 /* Make sure that the remote architecture state has been
623 initialized, because doing so might reallocate rs->buf. Any
624 function which calls getpkt also needs to be mindful of changes
625 to rs->buf, but this call limits the number of places which run
627 get_remote_arch_state ();
629 return get_remote_state_raw ();
633 compare_pnums (const void *lhs_
, const void *rhs_
)
635 const struct packet_reg
* const *lhs
= lhs_
;
636 const struct packet_reg
* const *rhs
= rhs_
;
638 if ((*lhs
)->pnum
< (*rhs
)->pnum
)
640 else if ((*lhs
)->pnum
== (*rhs
)->pnum
)
647 map_regcache_remote_table (struct gdbarch
*gdbarch
, struct packet_reg
*regs
)
649 int regnum
, num_remote_regs
, offset
;
650 struct packet_reg
**remote_regs
;
652 for (regnum
= 0; regnum
< gdbarch_num_regs (gdbarch
); regnum
++)
654 struct packet_reg
*r
= ®s
[regnum
];
656 if (register_size (gdbarch
, regnum
) == 0)
657 /* Do not try to fetch zero-sized (placeholder) registers. */
660 r
->pnum
= gdbarch_remote_register_number (gdbarch
, regnum
);
665 /* Define the g/G packet format as the contents of each register
666 with a remote protocol number, in order of ascending protocol
669 remote_regs
= alloca (gdbarch_num_regs (gdbarch
)
670 * sizeof (struct packet_reg
*));
671 for (num_remote_regs
= 0, regnum
= 0;
672 regnum
< gdbarch_num_regs (gdbarch
);
674 if (regs
[regnum
].pnum
!= -1)
675 remote_regs
[num_remote_regs
++] = ®s
[regnum
];
677 qsort (remote_regs
, num_remote_regs
, sizeof (struct packet_reg
*),
680 for (regnum
= 0, offset
= 0; regnum
< num_remote_regs
; regnum
++)
682 remote_regs
[regnum
]->in_g_packet
= 1;
683 remote_regs
[regnum
]->offset
= offset
;
684 offset
+= register_size (gdbarch
, remote_regs
[regnum
]->regnum
);
690 /* Given the architecture described by GDBARCH, return the remote
691 protocol register's number and the register's offset in the g/G
692 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
693 If the target does not have a mapping for REGNUM, return false,
694 otherwise, return true. */
697 remote_register_number_and_offset (struct gdbarch
*gdbarch
, int regnum
,
698 int *pnum
, int *poffset
)
701 struct packet_reg
*regs
;
702 struct cleanup
*old_chain
;
704 gdb_assert (regnum
< gdbarch_num_regs (gdbarch
));
706 regs
= xcalloc (gdbarch_num_regs (gdbarch
), sizeof (struct packet_reg
));
707 old_chain
= make_cleanup (xfree
, regs
);
709 sizeof_g_packet
= map_regcache_remote_table (gdbarch
, regs
);
711 *pnum
= regs
[regnum
].pnum
;
712 *poffset
= regs
[regnum
].offset
;
714 do_cleanups (old_chain
);
720 init_remote_state (struct gdbarch
*gdbarch
)
722 struct remote_state
*rs
= get_remote_state_raw ();
723 struct remote_arch_state
*rsa
;
725 rsa
= GDBARCH_OBSTACK_ZALLOC (gdbarch
, struct remote_arch_state
);
727 /* Use the architecture to build a regnum<->pnum table, which will be
728 1:1 unless a feature set specifies otherwise. */
729 rsa
->regs
= GDBARCH_OBSTACK_CALLOC (gdbarch
,
730 gdbarch_num_regs (gdbarch
),
733 /* Record the maximum possible size of the g packet - it may turn out
735 rsa
->sizeof_g_packet
= map_regcache_remote_table (gdbarch
, rsa
->regs
);
737 /* Default maximum number of characters in a packet body. Many
738 remote stubs have a hardwired buffer size of 400 bytes
739 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
740 as the maximum packet-size to ensure that the packet and an extra
741 NUL character can always fit in the buffer. This stops GDB
742 trashing stubs that try to squeeze an extra NUL into what is
743 already a full buffer (As of 1999-12-04 that was most stubs). */
744 rsa
->remote_packet_size
= 400 - 1;
746 /* This one is filled in when a ``g'' packet is received. */
747 rsa
->actual_register_packet_size
= 0;
749 /* Should rsa->sizeof_g_packet needs more space than the
750 default, adjust the size accordingly. Remember that each byte is
751 encoded as two characters. 32 is the overhead for the packet
752 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
753 (``$NN:G...#NN'') is a better guess, the below has been padded a
755 if (rsa
->sizeof_g_packet
> ((rsa
->remote_packet_size
- 32) / 2))
756 rsa
->remote_packet_size
= (rsa
->sizeof_g_packet
* 2 + 32);
758 /* Make sure that the packet buffer is plenty big enough for
759 this architecture. */
760 if (rs
->buf_size
< rsa
->remote_packet_size
)
762 rs
->buf_size
= 2 * rsa
->remote_packet_size
;
763 rs
->buf
= xrealloc (rs
->buf
, rs
->buf_size
);
769 /* Return the current allowed size of a remote packet. This is
770 inferred from the current architecture, and should be used to
771 limit the length of outgoing packets. */
773 get_remote_packet_size (void)
775 struct remote_state
*rs
= get_remote_state ();
776 struct remote_arch_state
*rsa
= get_remote_arch_state ();
778 if (rs
->explicit_packet_size
)
779 return rs
->explicit_packet_size
;
781 return rsa
->remote_packet_size
;
784 static struct packet_reg
*
785 packet_reg_from_regnum (struct remote_arch_state
*rsa
, long regnum
)
787 if (regnum
< 0 && regnum
>= gdbarch_num_regs (target_gdbarch ()))
791 struct packet_reg
*r
= &rsa
->regs
[regnum
];
793 gdb_assert (r
->regnum
== regnum
);
798 static struct packet_reg
*
799 packet_reg_from_pnum (struct remote_arch_state
*rsa
, LONGEST pnum
)
803 for (i
= 0; i
< gdbarch_num_regs (target_gdbarch ()); i
++)
805 struct packet_reg
*r
= &rsa
->regs
[i
];
813 static struct target_ops remote_ops
;
815 static struct target_ops extended_remote_ops
;
817 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
818 ``forever'' still use the normal timeout mechanism. This is
819 currently used by the ASYNC code to guarentee that target reads
820 during the initial connect always time-out. Once getpkt has been
821 modified to return a timeout indication and, in turn
822 remote_wait()/wait_for_inferior() have gained a timeout parameter
824 static int wait_forever_enabled_p
= 1;
826 /* Allow the user to specify what sequence to send to the remote
827 when he requests a program interruption: Although ^C is usually
828 what remote systems expect (this is the default, here), it is
829 sometimes preferable to send a break. On other systems such
830 as the Linux kernel, a break followed by g, which is Magic SysRq g
831 is required in order to interrupt the execution. */
832 const char interrupt_sequence_control_c
[] = "Ctrl-C";
833 const char interrupt_sequence_break
[] = "BREAK";
834 const char interrupt_sequence_break_g
[] = "BREAK-g";
835 static const char *const interrupt_sequence_modes
[] =
837 interrupt_sequence_control_c
,
838 interrupt_sequence_break
,
839 interrupt_sequence_break_g
,
842 static const char *interrupt_sequence_mode
= interrupt_sequence_control_c
;
845 show_interrupt_sequence (struct ui_file
*file
, int from_tty
,
846 struct cmd_list_element
*c
,
849 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
850 fprintf_filtered (file
,
851 _("Send the ASCII ETX character (Ctrl-c) "
852 "to the remote target to interrupt the "
853 "execution of the program.\n"));
854 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
855 fprintf_filtered (file
,
856 _("send a break signal to the remote target "
857 "to interrupt the execution of the program.\n"));
858 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
859 fprintf_filtered (file
,
860 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
861 "the remote target to interrupt the execution "
862 "of Linux kernel.\n"));
864 internal_error (__FILE__
, __LINE__
,
865 _("Invalid value for interrupt_sequence_mode: %s."),
866 interrupt_sequence_mode
);
869 /* This boolean variable specifies whether interrupt_sequence is sent
870 to the remote target when gdb connects to it.
871 This is mostly needed when you debug the Linux kernel: The Linux kernel
872 expects BREAK g which is Magic SysRq g for connecting gdb. */
873 static int interrupt_on_connect
= 0;
875 /* This variable is used to implement the "set/show remotebreak" commands.
876 Since these commands are now deprecated in favor of "set/show remote
877 interrupt-sequence", it no longer has any effect on the code. */
878 static int remote_break
;
881 set_remotebreak (char *args
, int from_tty
, struct cmd_list_element
*c
)
884 interrupt_sequence_mode
= interrupt_sequence_break
;
886 interrupt_sequence_mode
= interrupt_sequence_control_c
;
890 show_remotebreak (struct ui_file
*file
, int from_tty
,
891 struct cmd_list_element
*c
,
896 /* This variable sets the number of bits in an address that are to be
897 sent in a memory ("M" or "m") packet. Normally, after stripping
898 leading zeros, the entire address would be sent. This variable
899 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
900 initial implementation of remote.c restricted the address sent in
901 memory packets to ``host::sizeof long'' bytes - (typically 32
902 bits). Consequently, for 64 bit targets, the upper 32 bits of an
903 address was never sent. Since fixing this bug may cause a break in
904 some remote targets this variable is principly provided to
905 facilitate backward compatibility. */
907 static unsigned int remote_address_size
;
909 /* Temporary to track who currently owns the terminal. See
910 remote_terminal_* for more details. */
912 static int remote_async_terminal_ours_p
;
914 /* The executable file to use for "run" on the remote side. */
916 static char *remote_exec_file
= "";
919 /* User configurable variables for the number of characters in a
920 memory read/write packet. MIN (rsa->remote_packet_size,
921 rsa->sizeof_g_packet) is the default. Some targets need smaller
922 values (fifo overruns, et.al.) and some users need larger values
923 (speed up transfers). The variables ``preferred_*'' (the user
924 request), ``current_*'' (what was actually set) and ``forced_*''
925 (Positive - a soft limit, negative - a hard limit). */
927 struct memory_packet_config
934 /* Compute the current size of a read/write packet. Since this makes
935 use of ``actual_register_packet_size'' the computation is dynamic. */
938 get_memory_packet_size (struct memory_packet_config
*config
)
940 struct remote_state
*rs
= get_remote_state ();
941 struct remote_arch_state
*rsa
= get_remote_arch_state ();
943 /* NOTE: The somewhat arbitrary 16k comes from the knowledge (folk
944 law?) that some hosts don't cope very well with large alloca()
945 calls. Eventually the alloca() code will be replaced by calls to
946 xmalloc() and make_cleanups() allowing this restriction to either
947 be lifted or removed. */
948 #ifndef MAX_REMOTE_PACKET_SIZE
949 #define MAX_REMOTE_PACKET_SIZE 16384
951 /* NOTE: 20 ensures we can write at least one byte. */
952 #ifndef MIN_REMOTE_PACKET_SIZE
953 #define MIN_REMOTE_PACKET_SIZE 20
958 if (config
->size
<= 0)
959 what_they_get
= MAX_REMOTE_PACKET_SIZE
;
961 what_they_get
= config
->size
;
965 what_they_get
= get_remote_packet_size ();
966 /* Limit the packet to the size specified by the user. */
968 && what_they_get
> config
->size
)
969 what_they_get
= config
->size
;
971 /* Limit it to the size of the targets ``g'' response unless we have
972 permission from the stub to use a larger packet size. */
973 if (rs
->explicit_packet_size
== 0
974 && rsa
->actual_register_packet_size
> 0
975 && what_they_get
> rsa
->actual_register_packet_size
)
976 what_they_get
= rsa
->actual_register_packet_size
;
978 if (what_they_get
> MAX_REMOTE_PACKET_SIZE
)
979 what_they_get
= MAX_REMOTE_PACKET_SIZE
;
980 if (what_they_get
< MIN_REMOTE_PACKET_SIZE
)
981 what_they_get
= MIN_REMOTE_PACKET_SIZE
;
983 /* Make sure there is room in the global buffer for this packet
984 (including its trailing NUL byte). */
985 if (rs
->buf_size
< what_they_get
+ 1)
987 rs
->buf_size
= 2 * what_they_get
;
988 rs
->buf
= xrealloc (rs
->buf
, 2 * what_they_get
);
991 return what_they_get
;
994 /* Update the size of a read/write packet. If they user wants
995 something really big then do a sanity check. */
998 set_memory_packet_size (char *args
, struct memory_packet_config
*config
)
1000 int fixed_p
= config
->fixed_p
;
1001 long size
= config
->size
;
1004 error (_("Argument required (integer, `fixed' or `limited')."));
1005 else if (strcmp (args
, "hard") == 0
1006 || strcmp (args
, "fixed") == 0)
1008 else if (strcmp (args
, "soft") == 0
1009 || strcmp (args
, "limit") == 0)
1015 size
= strtoul (args
, &end
, 0);
1017 error (_("Invalid %s (bad syntax)."), config
->name
);
1019 /* Instead of explicitly capping the size of a packet to
1020 MAX_REMOTE_PACKET_SIZE or dissallowing it, the user is
1021 instead allowed to set the size to something arbitrarily
1023 if (size
> MAX_REMOTE_PACKET_SIZE
)
1024 error (_("Invalid %s (too large)."), config
->name
);
1028 if (fixed_p
&& !config
->fixed_p
)
1030 if (! query (_("The target may not be able to correctly handle a %s\n"
1031 "of %ld bytes. Change the packet size? "),
1032 config
->name
, size
))
1033 error (_("Packet size not changed."));
1035 /* Update the config. */
1036 config
->fixed_p
= fixed_p
;
1037 config
->size
= size
;
1041 show_memory_packet_size (struct memory_packet_config
*config
)
1043 printf_filtered (_("The %s is %ld. "), config
->name
, config
->size
);
1044 if (config
->fixed_p
)
1045 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
1046 get_memory_packet_size (config
));
1048 printf_filtered (_("Packets are limited to %ld bytes.\n"),
1049 get_memory_packet_size (config
));
1052 static struct memory_packet_config memory_write_packet_config
=
1054 "memory-write-packet-size",
1058 set_memory_write_packet_size (char *args
, int from_tty
)
1060 set_memory_packet_size (args
, &memory_write_packet_config
);
1064 show_memory_write_packet_size (char *args
, int from_tty
)
1066 show_memory_packet_size (&memory_write_packet_config
);
1070 get_memory_write_packet_size (void)
1072 return get_memory_packet_size (&memory_write_packet_config
);
1075 static struct memory_packet_config memory_read_packet_config
=
1077 "memory-read-packet-size",
1081 set_memory_read_packet_size (char *args
, int from_tty
)
1083 set_memory_packet_size (args
, &memory_read_packet_config
);
1087 show_memory_read_packet_size (char *args
, int from_tty
)
1089 show_memory_packet_size (&memory_read_packet_config
);
1093 get_memory_read_packet_size (void)
1095 long size
= get_memory_packet_size (&memory_read_packet_config
);
1097 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1098 extra buffer size argument before the memory read size can be
1099 increased beyond this. */
1100 if (size
> get_remote_packet_size ())
1101 size
= get_remote_packet_size ();
1106 /* Generic configuration support for packets the stub optionally
1107 supports. Allows the user to specify the use of the packet as well
1108 as allowing GDB to auto-detect support in the remote stub. */
1112 PACKET_SUPPORT_UNKNOWN
= 0,
1117 struct packet_config
1121 enum auto_boolean detect
;
1122 enum packet_support support
;
1125 /* Analyze a packet's return value and update the packet config
1136 update_packet_config (struct packet_config
*config
)
1138 switch (config
->detect
)
1140 case AUTO_BOOLEAN_TRUE
:
1141 config
->support
= PACKET_ENABLE
;
1143 case AUTO_BOOLEAN_FALSE
:
1144 config
->support
= PACKET_DISABLE
;
1146 case AUTO_BOOLEAN_AUTO
:
1147 config
->support
= PACKET_SUPPORT_UNKNOWN
;
1153 show_packet_config_cmd (struct packet_config
*config
)
1155 char *support
= "internal-error";
1157 switch (config
->support
)
1160 support
= "enabled";
1162 case PACKET_DISABLE
:
1163 support
= "disabled";
1165 case PACKET_SUPPORT_UNKNOWN
:
1166 support
= "unknown";
1169 switch (config
->detect
)
1171 case AUTO_BOOLEAN_AUTO
:
1172 printf_filtered (_("Support for the `%s' packet "
1173 "is auto-detected, currently %s.\n"),
1174 config
->name
, support
);
1176 case AUTO_BOOLEAN_TRUE
:
1177 case AUTO_BOOLEAN_FALSE
:
1178 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1179 config
->name
, support
);
1185 add_packet_config_cmd (struct packet_config
*config
, const char *name
,
1186 const char *title
, int legacy
)
1192 config
->name
= name
;
1193 config
->title
= title
;
1194 config
->detect
= AUTO_BOOLEAN_AUTO
;
1195 config
->support
= PACKET_SUPPORT_UNKNOWN
;
1196 set_doc
= xstrprintf ("Set use of remote protocol `%s' (%s) packet",
1198 show_doc
= xstrprintf ("Show current use of remote "
1199 "protocol `%s' (%s) packet",
1201 /* set/show TITLE-packet {auto,on,off} */
1202 cmd_name
= xstrprintf ("%s-packet", title
);
1203 add_setshow_auto_boolean_cmd (cmd_name
, class_obscure
,
1204 &config
->detect
, set_doc
,
1205 show_doc
, NULL
, /* help_doc */
1206 set_remote_protocol_packet_cmd
,
1207 show_remote_protocol_packet_cmd
,
1208 &remote_set_cmdlist
, &remote_show_cmdlist
);
1209 /* The command code copies the documentation strings. */
1212 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1217 legacy_name
= xstrprintf ("%s-packet", name
);
1218 add_alias_cmd (legacy_name
, cmd_name
, class_obscure
, 0,
1219 &remote_set_cmdlist
);
1220 add_alias_cmd (legacy_name
, cmd_name
, class_obscure
, 0,
1221 &remote_show_cmdlist
);
1225 static enum packet_result
1226 packet_check_result (const char *buf
)
1230 /* The stub recognized the packet request. Check that the
1231 operation succeeded. */
1233 && isxdigit (buf
[1]) && isxdigit (buf
[2])
1235 /* "Enn" - definitly an error. */
1236 return PACKET_ERROR
;
1238 /* Always treat "E." as an error. This will be used for
1239 more verbose error messages, such as E.memtypes. */
1240 if (buf
[0] == 'E' && buf
[1] == '.')
1241 return PACKET_ERROR
;
1243 /* The packet may or may not be OK. Just assume it is. */
1247 /* The stub does not support the packet. */
1248 return PACKET_UNKNOWN
;
1251 static enum packet_result
1252 packet_ok (const char *buf
, struct packet_config
*config
)
1254 enum packet_result result
;
1256 result
= packet_check_result (buf
);
1261 /* The stub recognized the packet request. */
1262 switch (config
->support
)
1264 case PACKET_SUPPORT_UNKNOWN
:
1266 fprintf_unfiltered (gdb_stdlog
,
1267 "Packet %s (%s) is supported\n",
1268 config
->name
, config
->title
);
1269 config
->support
= PACKET_ENABLE
;
1271 case PACKET_DISABLE
:
1272 internal_error (__FILE__
, __LINE__
,
1273 _("packet_ok: attempt to use a disabled packet"));
1279 case PACKET_UNKNOWN
:
1280 /* The stub does not support the packet. */
1281 switch (config
->support
)
1284 if (config
->detect
== AUTO_BOOLEAN_AUTO
)
1285 /* If the stub previously indicated that the packet was
1286 supported then there is a protocol error.. */
1287 error (_("Protocol error: %s (%s) conflicting enabled responses."),
1288 config
->name
, config
->title
);
1290 /* The user set it wrong. */
1291 error (_("Enabled packet %s (%s) not recognized by stub"),
1292 config
->name
, config
->title
);
1294 case PACKET_SUPPORT_UNKNOWN
:
1296 fprintf_unfiltered (gdb_stdlog
,
1297 "Packet %s (%s) is NOT supported\n",
1298 config
->name
, config
->title
);
1299 config
->support
= PACKET_DISABLE
;
1301 case PACKET_DISABLE
:
1323 PACKET_vFile_pwrite
,
1325 PACKET_vFile_unlink
,
1326 PACKET_vFile_readlink
,
1328 PACKET_qXfer_features
,
1329 PACKET_qXfer_libraries
,
1330 PACKET_qXfer_libraries_svr4
,
1331 PACKET_qXfer_memory_map
,
1332 PACKET_qXfer_spu_read
,
1333 PACKET_qXfer_spu_write
,
1334 PACKET_qXfer_osdata
,
1335 PACKET_qXfer_threads
,
1336 PACKET_qXfer_statictrace_read
,
1337 PACKET_qXfer_traceframe_info
,
1343 PACKET_QPassSignals
,
1344 PACKET_QProgramSignals
,
1345 PACKET_qSearch_memory
,
1348 PACKET_QStartNoAckMode
,
1350 PACKET_qXfer_siginfo_read
,
1351 PACKET_qXfer_siginfo_write
,
1353 PACKET_ConditionalTracepoints
,
1354 PACKET_ConditionalBreakpoints
,
1355 PACKET_BreakpointCommands
,
1356 PACKET_FastTracepoints
,
1357 PACKET_StaticTracepoints
,
1358 PACKET_InstallInTrace
,
1361 PACKET_TracepointSource
,
1364 PACKET_QDisableRandomization
,
1366 PACKET_QTBuffer_size
,
1369 PACKET_qXfer_btrace
,
1373 static struct packet_config remote_protocol_packets
[PACKET_MAX
];
1376 set_remote_protocol_packet_cmd (char *args
, int from_tty
,
1377 struct cmd_list_element
*c
)
1379 struct packet_config
*packet
;
1381 for (packet
= remote_protocol_packets
;
1382 packet
< &remote_protocol_packets
[PACKET_MAX
];
1385 if (&packet
->detect
== c
->var
)
1387 update_packet_config (packet
);
1391 internal_error (__FILE__
, __LINE__
, _("Could not find config for %s"),
1396 show_remote_protocol_packet_cmd (struct ui_file
*file
, int from_tty
,
1397 struct cmd_list_element
*c
,
1400 struct packet_config
*packet
;
1402 for (packet
= remote_protocol_packets
;
1403 packet
< &remote_protocol_packets
[PACKET_MAX
];
1406 if (&packet
->detect
== c
->var
)
1408 show_packet_config_cmd (packet
);
1412 internal_error (__FILE__
, __LINE__
, _("Could not find config for %s"),
1416 /* Should we try one of the 'Z' requests? */
1420 Z_PACKET_SOFTWARE_BP
,
1421 Z_PACKET_HARDWARE_BP
,
1428 /* For compatibility with older distributions. Provide a ``set remote
1429 Z-packet ...'' command that updates all the Z packet types. */
1431 static enum auto_boolean remote_Z_packet_detect
;
1434 set_remote_protocol_Z_packet_cmd (char *args
, int from_tty
,
1435 struct cmd_list_element
*c
)
1439 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
1441 remote_protocol_packets
[PACKET_Z0
+ i
].detect
= remote_Z_packet_detect
;
1442 update_packet_config (&remote_protocol_packets
[PACKET_Z0
+ i
]);
1447 show_remote_protocol_Z_packet_cmd (struct ui_file
*file
, int from_tty
,
1448 struct cmd_list_element
*c
,
1453 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
1455 show_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
+ i
]);
1459 /* Tokens for use by the asynchronous signal handlers for SIGINT. */
1460 static struct async_signal_handler
*async_sigint_remote_twice_token
;
1461 static struct async_signal_handler
*async_sigint_remote_token
;
1464 /* Asynchronous signal handle registered as event loop source for
1465 when we have pending events ready to be passed to the core. */
1467 static struct async_event_handler
*remote_async_inferior_event_token
;
1471 static ptid_t magic_null_ptid
;
1472 static ptid_t not_sent_ptid
;
1473 static ptid_t any_thread_ptid
;
1475 /* Find out if the stub attached to PID (and hence GDB should offer to
1476 detach instead of killing it when bailing out). */
1479 remote_query_attached (int pid
)
1481 struct remote_state
*rs
= get_remote_state ();
1482 size_t size
= get_remote_packet_size ();
1484 if (remote_protocol_packets
[PACKET_qAttached
].support
== PACKET_DISABLE
)
1487 if (remote_multi_process_p (rs
))
1488 xsnprintf (rs
->buf
, size
, "qAttached:%x", pid
);
1490 xsnprintf (rs
->buf
, size
, "qAttached");
1493 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1495 switch (packet_ok (rs
->buf
,
1496 &remote_protocol_packets
[PACKET_qAttached
]))
1499 if (strcmp (rs
->buf
, "1") == 0)
1503 warning (_("Remote failure reply: %s"), rs
->buf
);
1505 case PACKET_UNKNOWN
:
1512 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
1513 has been invented by GDB, instead of reported by the target. Since
1514 we can be connected to a remote system before before knowing about
1515 any inferior, mark the target with execution when we find the first
1516 inferior. If ATTACHED is 1, then we had just attached to this
1517 inferior. If it is 0, then we just created this inferior. If it
1518 is -1, then try querying the remote stub to find out if it had
1519 attached to the inferior or not. */
1521 static struct inferior
*
1522 remote_add_inferior (int fake_pid_p
, int pid
, int attached
)
1524 struct inferior
*inf
;
1526 /* Check whether this process we're learning about is to be
1527 considered attached, or if is to be considered to have been
1528 spawned by the stub. */
1530 attached
= remote_query_attached (pid
);
1532 if (gdbarch_has_global_solist (target_gdbarch ()))
1534 /* If the target shares code across all inferiors, then every
1535 attach adds a new inferior. */
1536 inf
= add_inferior (pid
);
1538 /* ... and every inferior is bound to the same program space.
1539 However, each inferior may still have its own address
1541 inf
->aspace
= maybe_new_address_space ();
1542 inf
->pspace
= current_program_space
;
1546 /* In the traditional debugging scenario, there's a 1-1 match
1547 between program/address spaces. We simply bind the inferior
1548 to the program space's address space. */
1549 inf
= current_inferior ();
1550 inferior_appeared (inf
, pid
);
1553 inf
->attach_flag
= attached
;
1554 inf
->fake_pid_p
= fake_pid_p
;
1559 /* Add thread PTID to GDB's thread list. Tag it as executing/running
1560 according to RUNNING. */
1563 remote_add_thread (ptid_t ptid
, int running
)
1565 struct remote_state
*rs
= get_remote_state ();
1567 /* GDB historically didn't pull threads in the initial connection
1568 setup. If the remote target doesn't even have a concept of
1569 threads (e.g., a bare-metal target), even if internally we
1570 consider that a single-threaded target, mentioning a new thread
1571 might be confusing to the user. Be silent then, preserving the
1572 age old behavior. */
1573 if (rs
->starting_up
)
1574 add_thread_silent (ptid
);
1578 set_executing (ptid
, running
);
1579 set_running (ptid
, running
);
1582 /* Come here when we learn about a thread id from the remote target.
1583 It may be the first time we hear about such thread, so take the
1584 opportunity to add it to GDB's thread list. In case this is the
1585 first time we're noticing its corresponding inferior, add it to
1586 GDB's inferior list as well. */
1589 remote_notice_new_inferior (ptid_t currthread
, int running
)
1591 /* If this is a new thread, add it to GDB's thread list.
1592 If we leave it up to WFI to do this, bad things will happen. */
1594 if (in_thread_list (currthread
) && is_exited (currthread
))
1596 /* We're seeing an event on a thread id we knew had exited.
1597 This has to be a new thread reusing the old id. Add it. */
1598 remote_add_thread (currthread
, running
);
1602 if (!in_thread_list (currthread
))
1604 struct inferior
*inf
= NULL
;
1605 int pid
= ptid_get_pid (currthread
);
1607 if (ptid_is_pid (inferior_ptid
)
1608 && pid
== ptid_get_pid (inferior_ptid
))
1610 /* inferior_ptid has no thread member yet. This can happen
1611 with the vAttach -> remote_wait,"TAAthread:" path if the
1612 stub doesn't support qC. This is the first stop reported
1613 after an attach, so this is the main thread. Update the
1614 ptid in the thread list. */
1615 if (in_thread_list (pid_to_ptid (pid
)))
1616 thread_change_ptid (inferior_ptid
, currthread
);
1619 remote_add_thread (currthread
, running
);
1620 inferior_ptid
= currthread
;
1625 if (ptid_equal (magic_null_ptid
, inferior_ptid
))
1627 /* inferior_ptid is not set yet. This can happen with the
1628 vRun -> remote_wait,"TAAthread:" path if the stub
1629 doesn't support qC. This is the first stop reported
1630 after an attach, so this is the main thread. Update the
1631 ptid in the thread list. */
1632 thread_change_ptid (inferior_ptid
, currthread
);
1636 /* When connecting to a target remote, or to a target
1637 extended-remote which already was debugging an inferior, we
1638 may not know about it yet. Add it before adding its child
1639 thread, so notifications are emitted in a sensible order. */
1640 if (!in_inferior_list (ptid_get_pid (currthread
)))
1642 struct remote_state
*rs
= get_remote_state ();
1643 int fake_pid_p
= !remote_multi_process_p (rs
);
1645 inf
= remote_add_inferior (fake_pid_p
,
1646 ptid_get_pid (currthread
), -1);
1649 /* This is really a new thread. Add it. */
1650 remote_add_thread (currthread
, running
);
1652 /* If we found a new inferior, let the common code do whatever
1653 it needs to with it (e.g., read shared libraries, insert
1654 breakpoints), unless we're just setting up an all-stop
1658 struct remote_state
*rs
= get_remote_state ();
1660 if (non_stop
|| !rs
->starting_up
)
1661 notice_new_inferior (currthread
, running
, 0);
1666 /* Return the private thread data, creating it if necessary. */
1668 static struct private_thread_info
*
1669 demand_private_info (ptid_t ptid
)
1671 struct thread_info
*info
= find_thread_ptid (ptid
);
1677 info
->private = xmalloc (sizeof (*(info
->private)));
1678 info
->private_dtor
= free_private_thread_info
;
1679 info
->private->core
= -1;
1680 info
->private->extra
= 0;
1683 return info
->private;
1686 /* Call this function as a result of
1687 1) A halt indication (T packet) containing a thread id
1688 2) A direct query of currthread
1689 3) Successful execution of set thread */
1692 record_currthread (struct remote_state
*rs
, ptid_t currthread
)
1694 rs
->general_thread
= currthread
;
1697 /* If 'QPassSignals' is supported, tell the remote stub what signals
1698 it can simply pass through to the inferior without reporting. */
1701 remote_pass_signals (struct target_ops
*self
,
1702 int numsigs
, unsigned char *pass_signals
)
1704 if (remote_protocol_packets
[PACKET_QPassSignals
].support
!= PACKET_DISABLE
)
1706 char *pass_packet
, *p
;
1708 struct remote_state
*rs
= get_remote_state ();
1710 gdb_assert (numsigs
< 256);
1711 for (i
= 0; i
< numsigs
; i
++)
1713 if (pass_signals
[i
])
1716 pass_packet
= xmalloc (count
* 3 + strlen ("QPassSignals:") + 1);
1717 strcpy (pass_packet
, "QPassSignals:");
1718 p
= pass_packet
+ strlen (pass_packet
);
1719 for (i
= 0; i
< numsigs
; i
++)
1721 if (pass_signals
[i
])
1724 *p
++ = tohex (i
>> 4);
1725 *p
++ = tohex (i
& 15);
1734 if (!rs
->last_pass_packet
|| strcmp (rs
->last_pass_packet
, pass_packet
))
1736 putpkt (pass_packet
);
1737 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1738 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QPassSignals
]);
1739 if (rs
->last_pass_packet
)
1740 xfree (rs
->last_pass_packet
);
1741 rs
->last_pass_packet
= pass_packet
;
1744 xfree (pass_packet
);
1748 /* If 'QProgramSignals' is supported, tell the remote stub what
1749 signals it should pass through to the inferior when detaching. */
1752 remote_program_signals (struct target_ops
*self
,
1753 int numsigs
, unsigned char *signals
)
1755 if (remote_protocol_packets
[PACKET_QProgramSignals
].support
!= PACKET_DISABLE
)
1759 struct remote_state
*rs
= get_remote_state ();
1761 gdb_assert (numsigs
< 256);
1762 for (i
= 0; i
< numsigs
; i
++)
1767 packet
= xmalloc (count
* 3 + strlen ("QProgramSignals:") + 1);
1768 strcpy (packet
, "QProgramSignals:");
1769 p
= packet
+ strlen (packet
);
1770 for (i
= 0; i
< numsigs
; i
++)
1772 if (signal_pass_state (i
))
1775 *p
++ = tohex (i
>> 4);
1776 *p
++ = tohex (i
& 15);
1785 if (!rs
->last_program_signals_packet
1786 || strcmp (rs
->last_program_signals_packet
, packet
) != 0)
1789 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1790 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QProgramSignals
]);
1791 xfree (rs
->last_program_signals_packet
);
1792 rs
->last_program_signals_packet
= packet
;
1799 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
1800 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
1801 thread. If GEN is set, set the general thread, if not, then set
1802 the step/continue thread. */
1804 set_thread (struct ptid ptid
, int gen
)
1806 struct remote_state
*rs
= get_remote_state ();
1807 ptid_t state
= gen
? rs
->general_thread
: rs
->continue_thread
;
1808 char *buf
= rs
->buf
;
1809 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
1811 if (ptid_equal (state
, ptid
))
1815 *buf
++ = gen
? 'g' : 'c';
1816 if (ptid_equal (ptid
, magic_null_ptid
))
1817 xsnprintf (buf
, endbuf
- buf
, "0");
1818 else if (ptid_equal (ptid
, any_thread_ptid
))
1819 xsnprintf (buf
, endbuf
- buf
, "0");
1820 else if (ptid_equal (ptid
, minus_one_ptid
))
1821 xsnprintf (buf
, endbuf
- buf
, "-1");
1823 write_ptid (buf
, endbuf
, ptid
);
1825 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1827 rs
->general_thread
= ptid
;
1829 rs
->continue_thread
= ptid
;
1833 set_general_thread (struct ptid ptid
)
1835 set_thread (ptid
, 1);
1839 set_continue_thread (struct ptid ptid
)
1841 set_thread (ptid
, 0);
1844 /* Change the remote current process. Which thread within the process
1845 ends up selected isn't important, as long as it is the same process
1846 as what INFERIOR_PTID points to.
1848 This comes from that fact that there is no explicit notion of
1849 "selected process" in the protocol. The selected process for
1850 general operations is the process the selected general thread
1854 set_general_process (void)
1856 struct remote_state
*rs
= get_remote_state ();
1858 /* If the remote can't handle multiple processes, don't bother. */
1859 if (!rs
->extended
|| !remote_multi_process_p (rs
))
1862 /* We only need to change the remote current thread if it's pointing
1863 at some other process. */
1864 if (ptid_get_pid (rs
->general_thread
) != ptid_get_pid (inferior_ptid
))
1865 set_general_thread (inferior_ptid
);
1869 /* Return nonzero if the thread PTID is still alive on the remote
1873 remote_thread_alive (struct target_ops
*ops
, ptid_t ptid
)
1875 struct remote_state
*rs
= get_remote_state ();
1878 if (ptid_equal (ptid
, magic_null_ptid
))
1879 /* The main thread is always alive. */
1882 if (ptid_get_pid (ptid
) != 0 && ptid_get_lwp (ptid
) == 0)
1883 /* The main thread is always alive. This can happen after a
1884 vAttach, if the remote side doesn't support
1889 endp
= rs
->buf
+ get_remote_packet_size ();
1892 write_ptid (p
, endp
, ptid
);
1895 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
1896 return (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K');
1899 /* About these extended threadlist and threadinfo packets. They are
1900 variable length packets but, the fields within them are often fixed
1901 length. They are redundent enough to send over UDP as is the
1902 remote protocol in general. There is a matching unit test module
1905 /* WARNING: This threadref data structure comes from the remote O.S.,
1906 libstub protocol encoding, and remote.c. It is not particularly
1909 /* Right now, the internal structure is int. We want it to be bigger.
1910 Plan to fix this. */
1912 typedef int gdb_threadref
; /* Internal GDB thread reference. */
1914 /* gdb_ext_thread_info is an internal GDB data structure which is
1915 equivalent to the reply of the remote threadinfo packet. */
1917 struct gdb_ext_thread_info
1919 threadref threadid
; /* External form of thread reference. */
1920 int active
; /* Has state interesting to GDB?
1922 char display
[256]; /* Brief state display, name,
1923 blocked/suspended. */
1924 char shortname
[32]; /* To be used to name threads. */
1925 char more_display
[256]; /* Long info, statistics, queue depth,
1929 /* The volume of remote transfers can be limited by submitting
1930 a mask containing bits specifying the desired information.
1931 Use a union of these values as the 'selection' parameter to
1932 get_thread_info. FIXME: Make these TAG names more thread specific. */
1934 #define TAG_THREADID 1
1935 #define TAG_EXISTS 2
1936 #define TAG_DISPLAY 4
1937 #define TAG_THREADNAME 8
1938 #define TAG_MOREDISPLAY 16
1940 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
1942 static char *unpack_nibble (char *buf
, int *val
);
1944 static char *unpack_byte (char *buf
, int *value
);
1946 static char *pack_int (char *buf
, int value
);
1948 static char *unpack_int (char *buf
, int *value
);
1950 static char *unpack_string (char *src
, char *dest
, int length
);
1952 static char *pack_threadid (char *pkt
, threadref
*id
);
1954 static char *unpack_threadid (char *inbuf
, threadref
*id
);
1956 void int_to_threadref (threadref
*id
, int value
);
1958 static int threadref_to_int (threadref
*ref
);
1960 static void copy_threadref (threadref
*dest
, threadref
*src
);
1962 static int threadmatch (threadref
*dest
, threadref
*src
);
1964 static char *pack_threadinfo_request (char *pkt
, int mode
,
1967 static int remote_unpack_thread_info_response (char *pkt
,
1968 threadref
*expectedref
,
1969 struct gdb_ext_thread_info
1973 static int remote_get_threadinfo (threadref
*threadid
,
1974 int fieldset
, /*TAG mask */
1975 struct gdb_ext_thread_info
*info
);
1977 static char *pack_threadlist_request (char *pkt
, int startflag
,
1979 threadref
*nextthread
);
1981 static int parse_threadlist_response (char *pkt
,
1983 threadref
*original_echo
,
1984 threadref
*resultlist
,
1987 static int remote_get_threadlist (int startflag
,
1988 threadref
*nextthread
,
1992 threadref
*threadlist
);
1994 typedef int (*rmt_thread_action
) (threadref
*ref
, void *context
);
1996 static int remote_threadlist_iterator (rmt_thread_action stepfunction
,
1997 void *context
, int looplimit
);
1999 static int remote_newthread_step (threadref
*ref
, void *context
);
2002 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
2003 buffer we're allowed to write to. Returns
2004 BUF+CHARACTERS_WRITTEN. */
2007 write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
)
2010 struct remote_state
*rs
= get_remote_state ();
2012 if (remote_multi_process_p (rs
))
2014 pid
= ptid_get_pid (ptid
);
2016 buf
+= xsnprintf (buf
, endbuf
- buf
, "p-%x.", -pid
);
2018 buf
+= xsnprintf (buf
, endbuf
- buf
, "p%x.", pid
);
2020 tid
= ptid_get_lwp (ptid
);
2022 buf
+= xsnprintf (buf
, endbuf
- buf
, "-%x", -tid
);
2024 buf
+= xsnprintf (buf
, endbuf
- buf
, "%x", tid
);
2029 /* Extract a PTID from BUF. If non-null, OBUF is set to the to one
2030 passed the last parsed char. Returns null_ptid on error. */
2033 read_ptid (char *buf
, char **obuf
)
2037 ULONGEST pid
= 0, tid
= 0;
2041 /* Multi-process ptid. */
2042 pp
= unpack_varlen_hex (p
+ 1, &pid
);
2044 error (_("invalid remote ptid: %s"), p
);
2047 pp
= unpack_varlen_hex (p
+ 1, &tid
);
2050 return ptid_build (pid
, tid
, 0);
2053 /* No multi-process. Just a tid. */
2054 pp
= unpack_varlen_hex (p
, &tid
);
2056 /* Since the stub is not sending a process id, then default to
2057 what's in inferior_ptid, unless it's null at this point. If so,
2058 then since there's no way to know the pid of the reported
2059 threads, use the magic number. */
2060 if (ptid_equal (inferior_ptid
, null_ptid
))
2061 pid
= ptid_get_pid (magic_null_ptid
);
2063 pid
= ptid_get_pid (inferior_ptid
);
2067 return ptid_build (pid
, tid
, 0);
2073 if (ch
>= 'a' && ch
<= 'f')
2074 return ch
- 'a' + 10;
2075 if (ch
>= '0' && ch
<= '9')
2077 if (ch
>= 'A' && ch
<= 'F')
2078 return ch
- 'A' + 10;
2083 stub_unpack_int (char *buff
, int fieldlength
)
2090 nibble
= stubhex (*buff
++);
2094 retval
= retval
<< 4;
2100 unpack_nibble (char *buf
, int *val
)
2102 *val
= fromhex (*buf
++);
2107 unpack_byte (char *buf
, int *value
)
2109 *value
= stub_unpack_int (buf
, 2);
2114 pack_int (char *buf
, int value
)
2116 buf
= pack_hex_byte (buf
, (value
>> 24) & 0xff);
2117 buf
= pack_hex_byte (buf
, (value
>> 16) & 0xff);
2118 buf
= pack_hex_byte (buf
, (value
>> 8) & 0x0ff);
2119 buf
= pack_hex_byte (buf
, (value
& 0xff));
2124 unpack_int (char *buf
, int *value
)
2126 *value
= stub_unpack_int (buf
, 8);
2130 #if 0 /* Currently unused, uncomment when needed. */
2131 static char *pack_string (char *pkt
, char *string
);
2134 pack_string (char *pkt
, char *string
)
2139 len
= strlen (string
);
2141 len
= 200; /* Bigger than most GDB packets, junk??? */
2142 pkt
= pack_hex_byte (pkt
, len
);
2146 if ((ch
== '\0') || (ch
== '#'))
2147 ch
= '*'; /* Protect encapsulation. */
2152 #endif /* 0 (unused) */
2155 unpack_string (char *src
, char *dest
, int length
)
2164 pack_threadid (char *pkt
, threadref
*id
)
2167 unsigned char *altid
;
2169 altid
= (unsigned char *) id
;
2170 limit
= pkt
+ BUF_THREAD_ID_SIZE
;
2172 pkt
= pack_hex_byte (pkt
, *altid
++);
2178 unpack_threadid (char *inbuf
, threadref
*id
)
2181 char *limit
= inbuf
+ BUF_THREAD_ID_SIZE
;
2184 altref
= (char *) id
;
2186 while (inbuf
< limit
)
2188 x
= stubhex (*inbuf
++);
2189 y
= stubhex (*inbuf
++);
2190 *altref
++ = (x
<< 4) | y
;
2195 /* Externally, threadrefs are 64 bits but internally, they are still
2196 ints. This is due to a mismatch of specifications. We would like
2197 to use 64bit thread references internally. This is an adapter
2201 int_to_threadref (threadref
*id
, int value
)
2203 unsigned char *scan
;
2205 scan
= (unsigned char *) id
;
2211 *scan
++ = (value
>> 24) & 0xff;
2212 *scan
++ = (value
>> 16) & 0xff;
2213 *scan
++ = (value
>> 8) & 0xff;
2214 *scan
++ = (value
& 0xff);
2218 threadref_to_int (threadref
*ref
)
2221 unsigned char *scan
;
2227 value
= (value
<< 8) | ((*scan
++) & 0xff);
2232 copy_threadref (threadref
*dest
, threadref
*src
)
2235 unsigned char *csrc
, *cdest
;
2237 csrc
= (unsigned char *) src
;
2238 cdest
= (unsigned char *) dest
;
2245 threadmatch (threadref
*dest
, threadref
*src
)
2247 /* Things are broken right now, so just assume we got a match. */
2249 unsigned char *srcp
, *destp
;
2251 srcp
= (char *) src
;
2252 destp
= (char *) dest
;
2256 result
&= (*srcp
++ == *destp
++) ? 1 : 0;
2263 threadid:1, # always request threadid
2270 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
2273 pack_threadinfo_request (char *pkt
, int mode
, threadref
*id
)
2275 *pkt
++ = 'q'; /* Info Query */
2276 *pkt
++ = 'P'; /* process or thread info */
2277 pkt
= pack_int (pkt
, mode
); /* mode */
2278 pkt
= pack_threadid (pkt
, id
); /* threadid */
2279 *pkt
= '\0'; /* terminate */
2283 /* These values tag the fields in a thread info response packet. */
2284 /* Tagging the fields allows us to request specific fields and to
2285 add more fields as time goes by. */
2287 #define TAG_THREADID 1 /* Echo the thread identifier. */
2288 #define TAG_EXISTS 2 /* Is this process defined enough to
2289 fetch registers and its stack? */
2290 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
2291 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
2292 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
2296 remote_unpack_thread_info_response (char *pkt
, threadref
*expectedref
,
2297 struct gdb_ext_thread_info
*info
)
2299 struct remote_state
*rs
= get_remote_state ();
2303 char *limit
= pkt
+ rs
->buf_size
; /* Plausible parsing limit. */
2306 /* info->threadid = 0; FIXME: implement zero_threadref. */
2308 info
->display
[0] = '\0';
2309 info
->shortname
[0] = '\0';
2310 info
->more_display
[0] = '\0';
2312 /* Assume the characters indicating the packet type have been
2314 pkt
= unpack_int (pkt
, &mask
); /* arg mask */
2315 pkt
= unpack_threadid (pkt
, &ref
);
2318 warning (_("Incomplete response to threadinfo request."));
2319 if (!threadmatch (&ref
, expectedref
))
2320 { /* This is an answer to a different request. */
2321 warning (_("ERROR RMT Thread info mismatch."));
2324 copy_threadref (&info
->threadid
, &ref
);
2326 /* Loop on tagged fields , try to bail if somthing goes wrong. */
2328 /* Packets are terminated with nulls. */
2329 while ((pkt
< limit
) && mask
&& *pkt
)
2331 pkt
= unpack_int (pkt
, &tag
); /* tag */
2332 pkt
= unpack_byte (pkt
, &length
); /* length */
2333 if (!(tag
& mask
)) /* Tags out of synch with mask. */
2335 warning (_("ERROR RMT: threadinfo tag mismatch."));
2339 if (tag
== TAG_THREADID
)
2343 warning (_("ERROR RMT: length of threadid is not 16."));
2347 pkt
= unpack_threadid (pkt
, &ref
);
2348 mask
= mask
& ~TAG_THREADID
;
2351 if (tag
== TAG_EXISTS
)
2353 info
->active
= stub_unpack_int (pkt
, length
);
2355 mask
= mask
& ~(TAG_EXISTS
);
2358 warning (_("ERROR RMT: 'exists' length too long."));
2364 if (tag
== TAG_THREADNAME
)
2366 pkt
= unpack_string (pkt
, &info
->shortname
[0], length
);
2367 mask
= mask
& ~TAG_THREADNAME
;
2370 if (tag
== TAG_DISPLAY
)
2372 pkt
= unpack_string (pkt
, &info
->display
[0], length
);
2373 mask
= mask
& ~TAG_DISPLAY
;
2376 if (tag
== TAG_MOREDISPLAY
)
2378 pkt
= unpack_string (pkt
, &info
->more_display
[0], length
);
2379 mask
= mask
& ~TAG_MOREDISPLAY
;
2382 warning (_("ERROR RMT: unknown thread info tag."));
2383 break; /* Not a tag we know about. */
2389 remote_get_threadinfo (threadref
*threadid
, int fieldset
, /* TAG mask */
2390 struct gdb_ext_thread_info
*info
)
2392 struct remote_state
*rs
= get_remote_state ();
2395 pack_threadinfo_request (rs
->buf
, fieldset
, threadid
);
2397 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2399 if (rs
->buf
[0] == '\0')
2402 result
= remote_unpack_thread_info_response (rs
->buf
+ 2,
2407 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
2410 pack_threadlist_request (char *pkt
, int startflag
, int threadcount
,
2411 threadref
*nextthread
)
2413 *pkt
++ = 'q'; /* info query packet */
2414 *pkt
++ = 'L'; /* Process LIST or threadLIST request */
2415 pkt
= pack_nibble (pkt
, startflag
); /* initflag 1 bytes */
2416 pkt
= pack_hex_byte (pkt
, threadcount
); /* threadcount 2 bytes */
2417 pkt
= pack_threadid (pkt
, nextthread
); /* 64 bit thread identifier */
2422 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
2425 parse_threadlist_response (char *pkt
, int result_limit
,
2426 threadref
*original_echo
, threadref
*resultlist
,
2429 struct remote_state
*rs
= get_remote_state ();
2431 int count
, resultcount
, done
;
2434 /* Assume the 'q' and 'M chars have been stripped. */
2435 limit
= pkt
+ (rs
->buf_size
- BUF_THREAD_ID_SIZE
);
2436 /* done parse past here */
2437 pkt
= unpack_byte (pkt
, &count
); /* count field */
2438 pkt
= unpack_nibble (pkt
, &done
);
2439 /* The first threadid is the argument threadid. */
2440 pkt
= unpack_threadid (pkt
, original_echo
); /* should match query packet */
2441 while ((count
-- > 0) && (pkt
< limit
))
2443 pkt
= unpack_threadid (pkt
, resultlist
++);
2444 if (resultcount
++ >= result_limit
)
2453 remote_get_threadlist (int startflag
, threadref
*nextthread
, int result_limit
,
2454 int *done
, int *result_count
, threadref
*threadlist
)
2456 struct remote_state
*rs
= get_remote_state ();
2459 /* Trancate result limit to be smaller than the packet size. */
2460 if ((((result_limit
+ 1) * BUF_THREAD_ID_SIZE
) + 10)
2461 >= get_remote_packet_size ())
2462 result_limit
= (get_remote_packet_size () / BUF_THREAD_ID_SIZE
) - 2;
2464 pack_threadlist_request (rs
->buf
, startflag
, result_limit
, nextthread
);
2466 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2468 if (*rs
->buf
== '\0')
2472 parse_threadlist_response (rs
->buf
+ 2, result_limit
,
2473 &rs
->echo_nextthread
, threadlist
, done
);
2475 if (!threadmatch (&rs
->echo_nextthread
, nextthread
))
2477 /* FIXME: This is a good reason to drop the packet. */
2478 /* Possably, there is a duplicate response. */
2480 retransmit immediatly - race conditions
2481 retransmit after timeout - yes
2483 wait for packet, then exit
2485 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
2486 return 0; /* I choose simply exiting. */
2488 if (*result_count
<= 0)
2492 warning (_("RMT ERROR : failed to get remote thread list."));
2495 return result
; /* break; */
2497 if (*result_count
> result_limit
)
2500 warning (_("RMT ERROR: threadlist response longer than requested."));
2506 /* This is the interface between remote and threads, remotes upper
2509 /* remote_find_new_threads retrieves the thread list and for each
2510 thread in the list, looks up the thread in GDB's internal list,
2511 adding the thread if it does not already exist. This involves
2512 getting partial thread lists from the remote target so, polling the
2513 quit_flag is required. */
2517 remote_threadlist_iterator (rmt_thread_action stepfunction
, void *context
,
2520 struct remote_state
*rs
= get_remote_state ();
2521 int done
, i
, result_count
;
2529 if (loopcount
++ > looplimit
)
2532 warning (_("Remote fetch threadlist -infinite loop-."));
2535 if (!remote_get_threadlist (startflag
, &rs
->nextthread
,
2536 MAXTHREADLISTRESULTS
,
2537 &done
, &result_count
, rs
->resultthreadlist
))
2542 /* Clear for later iterations. */
2544 /* Setup to resume next batch of thread references, set nextthread. */
2545 if (result_count
>= 1)
2546 copy_threadref (&rs
->nextthread
,
2547 &rs
->resultthreadlist
[result_count
- 1]);
2549 while (result_count
--)
2550 if (!(result
= (*stepfunction
) (&rs
->resultthreadlist
[i
++], context
)))
2557 remote_newthread_step (threadref
*ref
, void *context
)
2559 int pid
= ptid_get_pid (inferior_ptid
);
2560 ptid_t ptid
= ptid_build (pid
, threadref_to_int (ref
), 0);
2562 if (!in_thread_list (ptid
))
2564 return 1; /* continue iterator */
2567 #define CRAZY_MAX_THREADS 1000
2570 remote_current_thread (ptid_t oldpid
)
2572 struct remote_state
*rs
= get_remote_state ();
2575 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2576 if (rs
->buf
[0] == 'Q' && rs
->buf
[1] == 'C')
2577 return read_ptid (&rs
->buf
[2], NULL
);
2582 /* Find new threads for info threads command.
2583 * Original version, using John Metzler's thread protocol.
2587 remote_find_new_threads (void)
2589 remote_threadlist_iterator (remote_newthread_step
, 0,
2593 #if defined(HAVE_LIBEXPAT)
2595 typedef struct thread_item
2601 DEF_VEC_O(thread_item_t
);
2603 struct threads_parsing_context
2605 VEC (thread_item_t
) *items
;
2609 start_thread (struct gdb_xml_parser
*parser
,
2610 const struct gdb_xml_element
*element
,
2611 void *user_data
, VEC(gdb_xml_value_s
) *attributes
)
2613 struct threads_parsing_context
*data
= user_data
;
2615 struct thread_item item
;
2617 struct gdb_xml_value
*attr
;
2619 id
= xml_find_attribute (attributes
, "id")->value
;
2620 item
.ptid
= read_ptid (id
, NULL
);
2622 attr
= xml_find_attribute (attributes
, "core");
2624 item
.core
= *(ULONGEST
*) attr
->value
;
2630 VEC_safe_push (thread_item_t
, data
->items
, &item
);
2634 end_thread (struct gdb_xml_parser
*parser
,
2635 const struct gdb_xml_element
*element
,
2636 void *user_data
, const char *body_text
)
2638 struct threads_parsing_context
*data
= user_data
;
2640 if (body_text
&& *body_text
)
2641 VEC_last (thread_item_t
, data
->items
)->extra
= xstrdup (body_text
);
2644 const struct gdb_xml_attribute thread_attributes
[] = {
2645 { "id", GDB_XML_AF_NONE
, NULL
, NULL
},
2646 { "core", GDB_XML_AF_OPTIONAL
, gdb_xml_parse_attr_ulongest
, NULL
},
2647 { NULL
, GDB_XML_AF_NONE
, NULL
, NULL
}
2650 const struct gdb_xml_element thread_children
[] = {
2651 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
2654 const struct gdb_xml_element threads_children
[] = {
2655 { "thread", thread_attributes
, thread_children
,
2656 GDB_XML_EF_REPEATABLE
| GDB_XML_EF_OPTIONAL
,
2657 start_thread
, end_thread
},
2658 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
2661 const struct gdb_xml_element threads_elements
[] = {
2662 { "threads", NULL
, threads_children
,
2663 GDB_XML_EF_NONE
, NULL
, NULL
},
2664 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
2667 /* Discard the contents of the constructed thread info context. */
2670 clear_threads_parsing_context (void *p
)
2672 struct threads_parsing_context
*context
= p
;
2674 struct thread_item
*item
;
2676 for (i
= 0; VEC_iterate (thread_item_t
, context
->items
, i
, item
); ++i
)
2677 xfree (item
->extra
);
2679 VEC_free (thread_item_t
, context
->items
);
2685 * Find all threads for info threads command.
2686 * Uses new thread protocol contributed by Cisco.
2687 * Falls back and attempts to use the older method (above)
2688 * if the target doesn't respond to the new method.
2692 remote_threads_info (struct target_ops
*ops
)
2694 struct remote_state
*rs
= get_remote_state ();
2698 if (rs
->remote_desc
== 0) /* paranoia */
2699 error (_("Command can only be used when connected to the remote target."));
2701 #if defined(HAVE_LIBEXPAT)
2702 if (remote_protocol_packets
[PACKET_qXfer_threads
].support
== PACKET_ENABLE
)
2704 char *xml
= target_read_stralloc (¤t_target
,
2705 TARGET_OBJECT_THREADS
, NULL
);
2707 struct cleanup
*back_to
= make_cleanup (xfree
, xml
);
2711 struct threads_parsing_context context
;
2713 context
.items
= NULL
;
2714 make_cleanup (clear_threads_parsing_context
, &context
);
2716 if (gdb_xml_parse_quick (_("threads"), "threads.dtd",
2717 threads_elements
, xml
, &context
) == 0)
2720 struct thread_item
*item
;
2723 VEC_iterate (thread_item_t
, context
.items
, i
, item
);
2726 if (!ptid_equal (item
->ptid
, null_ptid
))
2728 struct private_thread_info
*info
;
2729 /* In non-stop mode, we assume new found threads
2730 are running until proven otherwise with a
2731 stop reply. In all-stop, we can only get
2732 here if all threads are stopped. */
2733 int running
= non_stop
? 1 : 0;
2735 remote_notice_new_inferior (item
->ptid
, running
);
2737 info
= demand_private_info (item
->ptid
);
2738 info
->core
= item
->core
;
2739 info
->extra
= item
->extra
;
2746 do_cleanups (back_to
);
2751 if (rs
->use_threadinfo_query
)
2753 putpkt ("qfThreadInfo");
2754 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2756 if (bufp
[0] != '\0') /* q packet recognized */
2758 struct cleanup
*old_chain
;
2761 /* remote_notice_new_inferior (in the loop below) may make
2762 new RSP calls, which clobber rs->buf. Work with a
2764 bufp
= saved_reply
= xstrdup (rs
->buf
);
2765 old_chain
= make_cleanup (free_current_contents
, &saved_reply
);
2767 while (*bufp
++ == 'm') /* reply contains one or more TID */
2771 new_thread
= read_ptid (bufp
, &bufp
);
2772 if (!ptid_equal (new_thread
, null_ptid
))
2774 /* In non-stop mode, we assume new found threads
2775 are running until proven otherwise with a
2776 stop reply. In all-stop, we can only get
2777 here if all threads are stopped. */
2778 int running
= non_stop
? 1 : 0;
2780 remote_notice_new_inferior (new_thread
, running
);
2783 while (*bufp
++ == ','); /* comma-separated list */
2784 free_current_contents (&saved_reply
);
2785 putpkt ("qsThreadInfo");
2786 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2787 bufp
= saved_reply
= xstrdup (rs
->buf
);
2789 do_cleanups (old_chain
);
2794 /* Only qfThreadInfo is supported in non-stop mode. */
2798 /* Else fall back to old method based on jmetzler protocol. */
2799 rs
->use_threadinfo_query
= 0;
2800 remote_find_new_threads ();
2805 * Collect a descriptive string about the given thread.
2806 * The target may say anything it wants to about the thread
2807 * (typically info about its blocked / runnable state, name, etc.).
2808 * This string will appear in the info threads display.
2810 * Optional: targets are not required to implement this function.
2814 remote_threads_extra_info (struct target_ops
*self
, struct thread_info
*tp
)
2816 struct remote_state
*rs
= get_remote_state ();
2820 struct gdb_ext_thread_info threadinfo
;
2821 static char display_buf
[100]; /* arbitrary... */
2822 int n
= 0; /* position in display_buf */
2824 if (rs
->remote_desc
== 0) /* paranoia */
2825 internal_error (__FILE__
, __LINE__
,
2826 _("remote_threads_extra_info"));
2828 if (ptid_equal (tp
->ptid
, magic_null_ptid
)
2829 || (ptid_get_pid (tp
->ptid
) != 0 && ptid_get_lwp (tp
->ptid
) == 0))
2830 /* This is the main thread which was added by GDB. The remote
2831 server doesn't know about it. */
2834 if (remote_protocol_packets
[PACKET_qXfer_threads
].support
== PACKET_ENABLE
)
2836 struct thread_info
*info
= find_thread_ptid (tp
->ptid
);
2838 if (info
&& info
->private)
2839 return info
->private->extra
;
2844 if (rs
->use_threadextra_query
)
2847 char *endb
= rs
->buf
+ get_remote_packet_size ();
2849 xsnprintf (b
, endb
- b
, "qThreadExtraInfo,");
2851 write_ptid (b
, endb
, tp
->ptid
);
2854 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2855 if (rs
->buf
[0] != 0)
2857 n
= min (strlen (rs
->buf
) / 2, sizeof (display_buf
));
2858 result
= hex2bin (rs
->buf
, (gdb_byte
*) display_buf
, n
);
2859 display_buf
[result
] = '\0';
2864 /* If the above query fails, fall back to the old method. */
2865 rs
->use_threadextra_query
= 0;
2866 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
2867 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
2868 int_to_threadref (&id
, ptid_get_lwp (tp
->ptid
));
2869 if (remote_get_threadinfo (&id
, set
, &threadinfo
))
2870 if (threadinfo
.active
)
2872 if (*threadinfo
.shortname
)
2873 n
+= xsnprintf (&display_buf
[0], sizeof (display_buf
) - n
,
2874 " Name: %s,", threadinfo
.shortname
);
2875 if (*threadinfo
.display
)
2876 n
+= xsnprintf (&display_buf
[n
], sizeof (display_buf
) - n
,
2877 " State: %s,", threadinfo
.display
);
2878 if (*threadinfo
.more_display
)
2879 n
+= xsnprintf (&display_buf
[n
], sizeof (display_buf
) - n
,
2880 " Priority: %s", threadinfo
.more_display
);
2884 /* For purely cosmetic reasons, clear up trailing commas. */
2885 if (',' == display_buf
[n
-1])
2886 display_buf
[n
-1] = ' ';
2895 remote_static_tracepoint_marker_at (struct target_ops
*self
, CORE_ADDR addr
,
2896 struct static_tracepoint_marker
*marker
)
2898 struct remote_state
*rs
= get_remote_state ();
2901 xsnprintf (p
, get_remote_packet_size (), "qTSTMat:");
2903 p
+= hexnumstr (p
, addr
);
2905 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2909 error (_("Remote failure reply: %s"), p
);
2913 parse_static_tracepoint_marker_definition (p
, &p
, marker
);
2920 static VEC(static_tracepoint_marker_p
) *
2921 remote_static_tracepoint_markers_by_strid (struct target_ops
*self
,
2924 struct remote_state
*rs
= get_remote_state ();
2925 VEC(static_tracepoint_marker_p
) *markers
= NULL
;
2926 struct static_tracepoint_marker
*marker
= NULL
;
2927 struct cleanup
*old_chain
;
2930 /* Ask for a first packet of static tracepoint marker
2933 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2936 error (_("Remote failure reply: %s"), p
);
2938 old_chain
= make_cleanup (free_current_marker
, &marker
);
2943 marker
= XCNEW (struct static_tracepoint_marker
);
2947 parse_static_tracepoint_marker_definition (p
, &p
, marker
);
2949 if (strid
== NULL
|| strcmp (strid
, marker
->str_id
) == 0)
2951 VEC_safe_push (static_tracepoint_marker_p
,
2957 release_static_tracepoint_marker (marker
);
2958 memset (marker
, 0, sizeof (*marker
));
2961 while (*p
++ == ','); /* comma-separated list */
2962 /* Ask for another packet of static tracepoint definition. */
2964 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
2968 do_cleanups (old_chain
);
2973 /* Implement the to_get_ada_task_ptid function for the remote targets. */
2976 remote_get_ada_task_ptid (struct target_ops
*self
, long lwp
, long thread
)
2978 return ptid_build (ptid_get_pid (inferior_ptid
), lwp
, 0);
2982 /* Restart the remote side; this is an extended protocol operation. */
2985 extended_remote_restart (void)
2987 struct remote_state
*rs
= get_remote_state ();
2989 /* Send the restart command; for reasons I don't understand the
2990 remote side really expects a number after the "R". */
2991 xsnprintf (rs
->buf
, get_remote_packet_size (), "R%x", 0);
2994 remote_fileio_reset ();
2997 /* Clean up connection to a remote debugger. */
3000 remote_close (struct target_ops
*self
)
3002 struct remote_state
*rs
= get_remote_state ();
3004 if (rs
->remote_desc
== NULL
)
3005 return; /* already closed */
3007 /* Make sure we leave stdin registered in the event loop, and we
3008 don't leave the async SIGINT signal handler installed. */
3009 remote_terminal_ours (self
);
3011 serial_close (rs
->remote_desc
);
3012 rs
->remote_desc
= NULL
;
3014 /* We don't have a connection to the remote stub anymore. Get rid
3015 of all the inferiors and their threads we were controlling.
3016 Reset inferior_ptid to null_ptid first, as otherwise has_stack_frame
3017 will be unable to find the thread corresponding to (pid, 0, 0). */
3018 inferior_ptid
= null_ptid
;
3019 discard_all_inferiors ();
3021 /* We are closing the remote target, so we should discard
3022 everything of this target. */
3023 discard_pending_stop_replies_in_queue (rs
);
3025 if (remote_async_inferior_event_token
)
3026 delete_async_event_handler (&remote_async_inferior_event_token
);
3028 remote_notif_state_xfree (rs
->notif_state
);
3030 trace_reset_local_state ();
3033 /* Query the remote side for the text, data and bss offsets. */
3038 struct remote_state
*rs
= get_remote_state ();
3041 int lose
, num_segments
= 0, do_sections
, do_segments
;
3042 CORE_ADDR text_addr
, data_addr
, bss_addr
, segments
[2];
3043 struct section_offsets
*offs
;
3044 struct symfile_segment_data
*data
;
3046 if (symfile_objfile
== NULL
)
3049 putpkt ("qOffsets");
3050 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3053 if (buf
[0] == '\000')
3054 return; /* Return silently. Stub doesn't support
3058 warning (_("Remote failure reply: %s"), buf
);
3062 /* Pick up each field in turn. This used to be done with scanf, but
3063 scanf will make trouble if CORE_ADDR size doesn't match
3064 conversion directives correctly. The following code will work
3065 with any size of CORE_ADDR. */
3066 text_addr
= data_addr
= bss_addr
= 0;
3070 if (strncmp (ptr
, "Text=", 5) == 0)
3073 /* Don't use strtol, could lose on big values. */
3074 while (*ptr
&& *ptr
!= ';')
3075 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
3077 if (strncmp (ptr
, ";Data=", 6) == 0)
3080 while (*ptr
&& *ptr
!= ';')
3081 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
3086 if (!lose
&& strncmp (ptr
, ";Bss=", 5) == 0)
3089 while (*ptr
&& *ptr
!= ';')
3090 bss_addr
= (bss_addr
<< 4) + fromhex (*ptr
++);
3092 if (bss_addr
!= data_addr
)
3093 warning (_("Target reported unsupported offsets: %s"), buf
);
3098 else if (strncmp (ptr
, "TextSeg=", 8) == 0)
3101 /* Don't use strtol, could lose on big values. */
3102 while (*ptr
&& *ptr
!= ';')
3103 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
3106 if (strncmp (ptr
, ";DataSeg=", 9) == 0)
3109 while (*ptr
&& *ptr
!= ';')
3110 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
3118 error (_("Malformed response to offset query, %s"), buf
);
3119 else if (*ptr
!= '\0')
3120 warning (_("Target reported unsupported offsets: %s"), buf
);
3122 offs
= ((struct section_offsets
*)
3123 alloca (SIZEOF_N_SECTION_OFFSETS (symfile_objfile
->num_sections
)));
3124 memcpy (offs
, symfile_objfile
->section_offsets
,
3125 SIZEOF_N_SECTION_OFFSETS (symfile_objfile
->num_sections
));
3127 data
= get_symfile_segment_data (symfile_objfile
->obfd
);
3128 do_segments
= (data
!= NULL
);
3129 do_sections
= num_segments
== 0;
3131 if (num_segments
> 0)
3133 segments
[0] = text_addr
;
3134 segments
[1] = data_addr
;
3136 /* If we have two segments, we can still try to relocate everything
3137 by assuming that the .text and .data offsets apply to the whole
3138 text and data segments. Convert the offsets given in the packet
3139 to base addresses for symfile_map_offsets_to_segments. */
3140 else if (data
&& data
->num_segments
== 2)
3142 segments
[0] = data
->segment_bases
[0] + text_addr
;
3143 segments
[1] = data
->segment_bases
[1] + data_addr
;
3146 /* If the object file has only one segment, assume that it is text
3147 rather than data; main programs with no writable data are rare,
3148 but programs with no code are useless. Of course the code might
3149 have ended up in the data segment... to detect that we would need
3150 the permissions here. */
3151 else if (data
&& data
->num_segments
== 1)
3153 segments
[0] = data
->segment_bases
[0] + text_addr
;
3156 /* There's no way to relocate by segment. */
3162 int ret
= symfile_map_offsets_to_segments (symfile_objfile
->obfd
, data
,
3163 offs
, num_segments
, segments
);
3165 if (ret
== 0 && !do_sections
)
3166 error (_("Can not handle qOffsets TextSeg "
3167 "response with this symbol file"));
3174 free_symfile_segment_data (data
);
3178 offs
->offsets
[SECT_OFF_TEXT (symfile_objfile
)] = text_addr
;
3180 /* This is a temporary kludge to force data and bss to use the
3181 same offsets because that's what nlmconv does now. The real
3182 solution requires changes to the stub and remote.c that I
3183 don't have time to do right now. */
3185 offs
->offsets
[SECT_OFF_DATA (symfile_objfile
)] = data_addr
;
3186 offs
->offsets
[SECT_OFF_BSS (symfile_objfile
)] = data_addr
;
3189 objfile_relocate (symfile_objfile
, offs
);
3192 /* Callback for iterate_over_threads. Set the STOP_REQUESTED flags in
3193 threads we know are stopped already. This is used during the
3194 initial remote connection in non-stop mode --- threads that are
3195 reported as already being stopped are left stopped. */
3198 set_stop_requested_callback (struct thread_info
*thread
, void *data
)
3200 /* If we have a stop reply for this thread, it must be stopped. */
3201 if (peek_stop_reply (thread
->ptid
))
3202 set_stop_requested (thread
->ptid
, 1);
3207 /* Send interrupt_sequence to remote target. */
3209 send_interrupt_sequence (void)
3211 struct remote_state
*rs
= get_remote_state ();
3213 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
3214 remote_serial_write ("\x03", 1);
3215 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
3216 serial_send_break (rs
->remote_desc
);
3217 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
3219 serial_send_break (rs
->remote_desc
);
3220 remote_serial_write ("g", 1);
3223 internal_error (__FILE__
, __LINE__
,
3224 _("Invalid value for interrupt_sequence_mode: %s."),
3225 interrupt_sequence_mode
);
3229 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
3230 and extract the PTID. Returns NULL_PTID if not found. */
3233 stop_reply_extract_thread (char *stop_reply
)
3235 if (stop_reply
[0] == 'T' && strlen (stop_reply
) > 3)
3239 /* Txx r:val ; r:val (...) */
3242 /* Look for "register" named "thread". */
3247 p1
= strchr (p
, ':');
3251 if (strncmp (p
, "thread", p1
- p
) == 0)
3252 return read_ptid (++p1
, &p
);
3254 p1
= strchr (p
, ';');
3266 /* Determine the remote side's current thread. If we have a stop
3267 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
3268 "thread" register we can extract the current thread from. If not,
3269 ask the remote which is the current thread with qC. The former
3270 method avoids a roundtrip. */
3273 get_current_thread (char *wait_status
)
3277 /* Note we don't use remote_parse_stop_reply as that makes use of
3278 the target architecture, which we haven't yet fully determined at
3280 if (wait_status
!= NULL
)
3281 ptid
= stop_reply_extract_thread (wait_status
);
3282 if (ptid_equal (ptid
, null_ptid
))
3283 ptid
= remote_current_thread (inferior_ptid
);
3288 /* Query the remote target for which is the current thread/process,
3289 add it to our tables, and update INFERIOR_PTID. The caller is
3290 responsible for setting the state such that the remote end is ready
3291 to return the current thread.
3293 This function is called after handling the '?' or 'vRun' packets,
3294 whose response is a stop reply from which we can also try
3295 extracting the thread. If the target doesn't support the explicit
3296 qC query, we infer the current thread from that stop reply, passed
3297 in in WAIT_STATUS, which may be NULL. */
3300 add_current_inferior_and_thread (char *wait_status
)
3302 struct remote_state
*rs
= get_remote_state ();
3304 ptid_t ptid
= null_ptid
;
3306 inferior_ptid
= null_ptid
;
3308 /* Now, if we have thread information, update inferior_ptid. */
3309 ptid
= get_current_thread (wait_status
);
3311 if (!ptid_equal (ptid
, null_ptid
))
3313 if (!remote_multi_process_p (rs
))
3316 inferior_ptid
= ptid
;
3320 /* Without this, some commands which require an active target
3321 (such as kill) won't work. This variable serves (at least)
3322 double duty as both the pid of the target process (if it has
3323 such), and as a flag indicating that a target is active. */
3324 inferior_ptid
= magic_null_ptid
;
3328 remote_add_inferior (fake_pid_p
, ptid_get_pid (inferior_ptid
), -1);
3330 /* Add the main thread. */
3331 add_thread_silent (inferior_ptid
);
3335 remote_start_remote (int from_tty
, struct target_ops
*target
, int extended_p
)
3337 struct remote_state
*rs
= get_remote_state ();
3338 struct packet_config
*noack_config
;
3339 char *wait_status
= NULL
;
3341 immediate_quit
++; /* Allow user to interrupt it. */
3344 if (interrupt_on_connect
)
3345 send_interrupt_sequence ();
3347 /* Ack any packet which the remote side has already sent. */
3348 serial_write (rs
->remote_desc
, "+", 1);
3350 /* Signal other parts that we're going through the initial setup,
3351 and so things may not be stable yet. */
3352 rs
->starting_up
= 1;
3354 /* The first packet we send to the target is the optional "supported
3355 packets" request. If the target can answer this, it will tell us
3356 which later probes to skip. */
3357 remote_query_supported ();
3359 /* If the stub wants to get a QAllow, compose one and send it. */
3360 if (remote_protocol_packets
[PACKET_QAllow
].support
!= PACKET_DISABLE
)
3361 remote_set_permissions (target
);
3363 /* Next, we possibly activate noack mode.
3365 If the QStartNoAckMode packet configuration is set to AUTO,
3366 enable noack mode if the stub reported a wish for it with
3369 If set to TRUE, then enable noack mode even if the stub didn't
3370 report it in qSupported. If the stub doesn't reply OK, the
3371 session ends with an error.
3373 If FALSE, then don't activate noack mode, regardless of what the
3374 stub claimed should be the default with qSupported. */
3376 noack_config
= &remote_protocol_packets
[PACKET_QStartNoAckMode
];
3378 if (noack_config
->detect
== AUTO_BOOLEAN_TRUE
3379 || (noack_config
->detect
== AUTO_BOOLEAN_AUTO
3380 && noack_config
->support
== PACKET_ENABLE
))
3382 putpkt ("QStartNoAckMode");
3383 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3384 if (packet_ok (rs
->buf
, noack_config
) == PACKET_OK
)
3390 /* Tell the remote that we are using the extended protocol. */
3392 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3395 /* Let the target know which signals it is allowed to pass down to
3397 update_signals_program_target ();
3399 /* Next, if the target can specify a description, read it. We do
3400 this before anything involving memory or registers. */
3401 target_find_description ();
3403 /* Next, now that we know something about the target, update the
3404 address spaces in the program spaces. */
3405 update_address_spaces ();
3407 /* On OSs where the list of libraries is global to all
3408 processes, we fetch them early. */
3409 if (gdbarch_has_global_solist (target_gdbarch ()))
3410 solib_add (NULL
, from_tty
, target
, auto_solib_add
);
3414 if (!rs
->non_stop_aware
)
3415 error (_("Non-stop mode requested, but remote "
3416 "does not support non-stop"));
3418 putpkt ("QNonStop:1");
3419 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3421 if (strcmp (rs
->buf
, "OK") != 0)
3422 error (_("Remote refused setting non-stop mode with: %s"), rs
->buf
);
3424 /* Find about threads and processes the stub is already
3425 controlling. We default to adding them in the running state.
3426 The '?' query below will then tell us about which threads are
3428 remote_threads_info (target
);
3430 else if (rs
->non_stop_aware
)
3432 /* Don't assume that the stub can operate in all-stop mode.
3433 Request it explicitly. */
3434 putpkt ("QNonStop:0");
3435 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3437 if (strcmp (rs
->buf
, "OK") != 0)
3438 error (_("Remote refused setting all-stop mode with: %s"), rs
->buf
);
3441 /* Upload TSVs regardless of whether the target is running or not. The
3442 remote stub, such as GDBserver, may have some predefined or builtin
3443 TSVs, even if the target is not running. */
3444 if (remote_get_trace_status (target
, current_trace_status ()) != -1)
3446 struct uploaded_tsv
*uploaded_tsvs
= NULL
;
3448 remote_upload_trace_state_variables (target
, &uploaded_tsvs
);
3449 merge_uploaded_trace_state_variables (&uploaded_tsvs
);
3452 /* Check whether the target is running now. */
3454 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3460 struct inferior
*inf
;
3462 if (rs
->buf
[0] == 'W' || rs
->buf
[0] == 'X')
3465 error (_("The target is not running (try extended-remote?)"));
3467 /* We're connected, but not running. Drop out before we
3468 call start_remote. */
3469 rs
->starting_up
= 0;
3474 /* Save the reply for later. */
3475 wait_status
= alloca (strlen (rs
->buf
) + 1);
3476 strcpy (wait_status
, rs
->buf
);
3479 /* Fetch thread list. */
3480 target_find_new_threads ();
3482 /* Let the stub know that we want it to return the thread. */
3483 set_continue_thread (minus_one_ptid
);
3485 if (thread_count () == 0)
3487 /* Target has no concept of threads at all. GDB treats
3488 non-threaded target as single-threaded; add a main
3490 add_current_inferior_and_thread (wait_status
);
3494 /* We have thread information; select the thread the target
3495 says should be current. If we're reconnecting to a
3496 multi-threaded program, this will ideally be the thread
3497 that last reported an event before GDB disconnected. */
3498 inferior_ptid
= get_current_thread (wait_status
);
3499 if (ptid_equal (inferior_ptid
, null_ptid
))
3501 /* Odd... The target was able to list threads, but not
3502 tell us which thread was current (no "thread"
3503 register in T stop reply?). Just pick the first
3504 thread in the thread list then. */
3505 inferior_ptid
= thread_list
->ptid
;
3509 /* init_wait_for_inferior should be called before get_offsets in order
3510 to manage `inserted' flag in bp loc in a correct state.
3511 breakpoint_init_inferior, called from init_wait_for_inferior, set
3512 `inserted' flag to 0, while before breakpoint_re_set, called from
3513 start_remote, set `inserted' flag to 1. In the initialization of
3514 inferior, breakpoint_init_inferior should be called first, and then
3515 breakpoint_re_set can be called. If this order is broken, state of
3516 `inserted' flag is wrong, and cause some problems on breakpoint
3518 init_wait_for_inferior ();
3520 get_offsets (); /* Get text, data & bss offsets. */
3522 /* If we could not find a description using qXfer, and we know
3523 how to do it some other way, try again. This is not
3524 supported for non-stop; it could be, but it is tricky if
3525 there are no stopped threads when we connect. */
3526 if (remote_read_description_p (target
)
3527 && gdbarch_target_desc (target_gdbarch ()) == NULL
)
3529 target_clear_description ();
3530 target_find_description ();
3533 /* Use the previously fetched status. */
3534 gdb_assert (wait_status
!= NULL
);
3535 strcpy (rs
->buf
, wait_status
);
3536 rs
->cached_wait_status
= 1;
3539 start_remote (from_tty
); /* Initialize gdb process mechanisms. */
3543 /* Clear WFI global state. Do this before finding about new
3544 threads and inferiors, and setting the current inferior.
3545 Otherwise we would clear the proceed status of the current
3546 inferior when we want its stop_soon state to be preserved
3547 (see notice_new_inferior). */
3548 init_wait_for_inferior ();
3550 /* In non-stop, we will either get an "OK", meaning that there
3551 are no stopped threads at this time; or, a regular stop
3552 reply. In the latter case, there may be more than one thread
3553 stopped --- we pull them all out using the vStopped
3555 if (strcmp (rs
->buf
, "OK") != 0)
3557 struct notif_client
*notif
= ¬if_client_stop
;
3559 /* remote_notif_get_pending_replies acks this one, and gets
3561 rs
->notif_state
->pending_event
[notif_client_stop
.id
]
3562 = remote_notif_parse (notif
, rs
->buf
);
3563 remote_notif_get_pending_events (notif
);
3565 /* Make sure that threads that were stopped remain
3567 iterate_over_threads (set_stop_requested_callback
, NULL
);
3570 if (target_can_async_p ())
3571 target_async (inferior_event_handler
, 0);
3573 if (thread_count () == 0)
3576 error (_("The target is not running (try extended-remote?)"));
3578 /* We're connected, but not running. Drop out before we
3579 call start_remote. */
3580 rs
->starting_up
= 0;
3584 /* Let the stub know that we want it to return the thread. */
3586 /* Force the stub to choose a thread. */
3587 set_general_thread (null_ptid
);
3590 inferior_ptid
= remote_current_thread (minus_one_ptid
);
3591 if (ptid_equal (inferior_ptid
, minus_one_ptid
))
3592 error (_("remote didn't report the current thread in non-stop mode"));
3594 get_offsets (); /* Get text, data & bss offsets. */
3596 /* In non-stop mode, any cached wait status will be stored in
3597 the stop reply queue. */
3598 gdb_assert (wait_status
== NULL
);
3600 /* Report all signals during attach/startup. */
3601 remote_pass_signals (target
, 0, NULL
);
3604 /* If we connected to a live target, do some additional setup. */
3605 if (target_has_execution
)
3607 if (symfile_objfile
) /* No use without a symbol-file. */
3608 remote_check_symbols ();
3611 /* Possibly the target has been engaged in a trace run started
3612 previously; find out where things are at. */
3613 if (remote_get_trace_status (target
, current_trace_status ()) != -1)
3615 struct uploaded_tp
*uploaded_tps
= NULL
;
3617 if (current_trace_status ()->running
)
3618 printf_filtered (_("Trace is already running on the target.\n"));
3620 remote_upload_tracepoints (target
, &uploaded_tps
);
3622 merge_uploaded_tracepoints (&uploaded_tps
);
3625 /* The thread and inferior lists are now synchronized with the
3626 target, our symbols have been relocated, and we're merged the
3627 target's tracepoints with ours. We're done with basic start
3629 rs
->starting_up
= 0;
3631 /* If breakpoints are global, insert them now. */
3632 if (gdbarch_has_global_breakpoints (target_gdbarch ())
3633 && breakpoints_always_inserted_mode ())
3634 insert_breakpoints ();
3637 /* Open a connection to a remote debugger.
3638 NAME is the filename used for communication. */
3641 remote_open (char *name
, int from_tty
)
3643 remote_open_1 (name
, from_tty
, &remote_ops
, 0);
3646 /* Open a connection to a remote debugger using the extended
3647 remote gdb protocol. NAME is the filename used for communication. */
3650 extended_remote_open (char *name
, int from_tty
)
3652 remote_open_1 (name
, from_tty
, &extended_remote_ops
, 1 /*extended_p */);
3655 /* Generic code for opening a connection to a remote target. */
3658 init_all_packet_configs (void)
3662 for (i
= 0; i
< PACKET_MAX
; i
++)
3663 update_packet_config (&remote_protocol_packets
[i
]);
3666 /* Symbol look-up. */
3669 remote_check_symbols (void)
3671 struct remote_state
*rs
= get_remote_state ();
3672 char *msg
, *reply
, *tmp
;
3673 struct bound_minimal_symbol sym
;
3676 /* The remote side has no concept of inferiors that aren't running
3677 yet, it only knows about running processes. If we're connected
3678 but our current inferior is not running, we should not invite the
3679 remote target to request symbol lookups related to its
3680 (unrelated) current process. */
3681 if (!target_has_execution
)
3684 if (remote_protocol_packets
[PACKET_qSymbol
].support
== PACKET_DISABLE
)
3687 /* Make sure the remote is pointing at the right process. Note
3688 there's no way to select "no process". */
3689 set_general_process ();
3691 /* Allocate a message buffer. We can't reuse the input buffer in RS,
3692 because we need both at the same time. */
3693 msg
= alloca (get_remote_packet_size ());
3695 /* Invite target to request symbol lookups. */
3697 putpkt ("qSymbol::");
3698 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3699 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_qSymbol
]);
3702 while (strncmp (reply
, "qSymbol:", 8) == 0)
3704 struct bound_minimal_symbol sym
;
3707 end
= hex2bin (tmp
, (gdb_byte
*) msg
, strlen (tmp
) / 2);
3709 sym
= lookup_minimal_symbol (msg
, NULL
, NULL
);
3710 if (sym
.minsym
== NULL
)
3711 xsnprintf (msg
, get_remote_packet_size (), "qSymbol::%s", &reply
[8]);
3714 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
3715 CORE_ADDR sym_addr
= BMSYMBOL_VALUE_ADDRESS (sym
);
3717 /* If this is a function address, return the start of code
3718 instead of any data function descriptor. */
3719 sym_addr
= gdbarch_convert_from_func_ptr_addr (target_gdbarch (),
3723 xsnprintf (msg
, get_remote_packet_size (), "qSymbol:%s:%s",
3724 phex_nz (sym_addr
, addr_size
), &reply
[8]);
3728 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3733 static struct serial
*
3734 remote_serial_open (char *name
)
3736 static int udp_warning
= 0;
3738 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
3739 of in ser-tcp.c, because it is the remote protocol assuming that the
3740 serial connection is reliable and not the serial connection promising
3742 if (!udp_warning
&& strncmp (name
, "udp:", 4) == 0)
3744 warning (_("The remote protocol may be unreliable over UDP.\n"
3745 "Some events may be lost, rendering further debugging "
3750 return serial_open (name
);
3753 /* Inform the target of our permission settings. The permission flags
3754 work without this, but if the target knows the settings, it can do
3755 a couple things. First, it can add its own check, to catch cases
3756 that somehow manage to get by the permissions checks in target
3757 methods. Second, if the target is wired to disallow particular
3758 settings (for instance, a system in the field that is not set up to
3759 be able to stop at a breakpoint), it can object to any unavailable
3763 remote_set_permissions (struct target_ops
*self
)
3765 struct remote_state
*rs
= get_remote_state ();
3767 xsnprintf (rs
->buf
, get_remote_packet_size (), "QAllow:"
3768 "WriteReg:%x;WriteMem:%x;"
3769 "InsertBreak:%x;InsertTrace:%x;"
3770 "InsertFastTrace:%x;Stop:%x",
3771 may_write_registers
, may_write_memory
,
3772 may_insert_breakpoints
, may_insert_tracepoints
,
3773 may_insert_fast_tracepoints
, may_stop
);
3775 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
3777 /* If the target didn't like the packet, warn the user. Do not try
3778 to undo the user's settings, that would just be maddening. */
3779 if (strcmp (rs
->buf
, "OK") != 0)
3780 warning (_("Remote refused setting permissions with: %s"), rs
->buf
);
3783 /* This type describes each known response to the qSupported
3785 struct protocol_feature
3787 /* The name of this protocol feature. */
3790 /* The default for this protocol feature. */
3791 enum packet_support default_support
;
3793 /* The function to call when this feature is reported, or after
3794 qSupported processing if the feature is not supported.
3795 The first argument points to this structure. The second
3796 argument indicates whether the packet requested support be
3797 enabled, disabled, or probed (or the default, if this function
3798 is being called at the end of processing and this feature was
3799 not reported). The third argument may be NULL; if not NULL, it
3800 is a NUL-terminated string taken from the packet following
3801 this feature's name and an equals sign. */
3802 void (*func
) (const struct protocol_feature
*, enum packet_support
,
3805 /* The corresponding packet for this feature. Only used if
3806 FUNC is remote_supported_packet. */
3811 remote_supported_packet (const struct protocol_feature
*feature
,
3812 enum packet_support support
,
3813 const char *argument
)
3817 warning (_("Remote qSupported response supplied an unexpected value for"
3818 " \"%s\"."), feature
->name
);
3822 if (remote_protocol_packets
[feature
->packet
].support
3823 == PACKET_SUPPORT_UNKNOWN
)
3824 remote_protocol_packets
[feature
->packet
].support
= support
;
3828 remote_packet_size (const struct protocol_feature
*feature
,
3829 enum packet_support support
, const char *value
)
3831 struct remote_state
*rs
= get_remote_state ();
3836 if (support
!= PACKET_ENABLE
)
3839 if (value
== NULL
|| *value
== '\0')
3841 warning (_("Remote target reported \"%s\" without a size."),
3847 packet_size
= strtol (value
, &value_end
, 16);
3848 if (errno
!= 0 || *value_end
!= '\0' || packet_size
< 0)
3850 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
3851 feature
->name
, value
);
3855 if (packet_size
> MAX_REMOTE_PACKET_SIZE
)
3857 warning (_("limiting remote suggested packet size (%d bytes) to %d"),
3858 packet_size
, MAX_REMOTE_PACKET_SIZE
);
3859 packet_size
= MAX_REMOTE_PACKET_SIZE
;
3862 /* Record the new maximum packet size. */
3863 rs
->explicit_packet_size
= packet_size
;
3867 remote_multi_process_feature (const struct protocol_feature
*feature
,
3868 enum packet_support support
, const char *value
)
3870 struct remote_state
*rs
= get_remote_state ();
3872 rs
->multi_process_aware
= (support
== PACKET_ENABLE
);
3876 remote_non_stop_feature (const struct protocol_feature
*feature
,
3877 enum packet_support support
, const char *value
)
3879 struct remote_state
*rs
= get_remote_state ();
3881 rs
->non_stop_aware
= (support
== PACKET_ENABLE
);
3885 remote_cond_tracepoint_feature (const struct protocol_feature
*feature
,
3886 enum packet_support support
,
3889 struct remote_state
*rs
= get_remote_state ();
3891 rs
->cond_tracepoints
= (support
== PACKET_ENABLE
);
3895 remote_cond_breakpoint_feature (const struct protocol_feature
*feature
,
3896 enum packet_support support
,
3899 struct remote_state
*rs
= get_remote_state ();
3901 rs
->cond_breakpoints
= (support
== PACKET_ENABLE
);
3905 remote_breakpoint_commands_feature (const struct protocol_feature
*feature
,
3906 enum packet_support support
,
3909 struct remote_state
*rs
= get_remote_state ();
3911 rs
->breakpoint_commands
= (support
== PACKET_ENABLE
);
3915 remote_fast_tracepoint_feature (const struct protocol_feature
*feature
,
3916 enum packet_support support
,
3919 struct remote_state
*rs
= get_remote_state ();
3921 rs
->fast_tracepoints
= (support
== PACKET_ENABLE
);
3925 remote_static_tracepoint_feature (const struct protocol_feature
*feature
,
3926 enum packet_support support
,
3929 struct remote_state
*rs
= get_remote_state ();
3931 rs
->static_tracepoints
= (support
== PACKET_ENABLE
);
3935 remote_install_in_trace_feature (const struct protocol_feature
*feature
,
3936 enum packet_support support
,
3939 struct remote_state
*rs
= get_remote_state ();
3941 rs
->install_in_trace
= (support
== PACKET_ENABLE
);
3945 remote_disconnected_tracing_feature (const struct protocol_feature
*feature
,
3946 enum packet_support support
,
3949 struct remote_state
*rs
= get_remote_state ();
3951 rs
->disconnected_tracing
= (support
== PACKET_ENABLE
);
3955 remote_enable_disable_tracepoint_feature (const struct protocol_feature
*feature
,
3956 enum packet_support support
,
3959 struct remote_state
*rs
= get_remote_state ();
3961 rs
->enable_disable_tracepoints
= (support
== PACKET_ENABLE
);
3965 remote_string_tracing_feature (const struct protocol_feature
*feature
,
3966 enum packet_support support
,
3969 struct remote_state
*rs
= get_remote_state ();
3971 rs
->string_tracing
= (support
== PACKET_ENABLE
);
3975 remote_augmented_libraries_svr4_read_feature
3976 (const struct protocol_feature
*feature
,
3977 enum packet_support support
, const char *value
)
3979 struct remote_state
*rs
= get_remote_state ();
3981 rs
->augmented_libraries_svr4_read
= (support
== PACKET_ENABLE
);
3984 static const struct protocol_feature remote_protocol_features
[] = {
3985 { "PacketSize", PACKET_DISABLE
, remote_packet_size
, -1 },
3986 { "qXfer:auxv:read", PACKET_DISABLE
, remote_supported_packet
,
3987 PACKET_qXfer_auxv
},
3988 { "qXfer:features:read", PACKET_DISABLE
, remote_supported_packet
,
3989 PACKET_qXfer_features
},
3990 { "qXfer:libraries:read", PACKET_DISABLE
, remote_supported_packet
,
3991 PACKET_qXfer_libraries
},
3992 { "qXfer:libraries-svr4:read", PACKET_DISABLE
, remote_supported_packet
,
3993 PACKET_qXfer_libraries_svr4
},
3994 { "augmented-libraries-svr4-read", PACKET_DISABLE
,
3995 remote_augmented_libraries_svr4_read_feature
, -1 },
3996 { "qXfer:memory-map:read", PACKET_DISABLE
, remote_supported_packet
,
3997 PACKET_qXfer_memory_map
},
3998 { "qXfer:spu:read", PACKET_DISABLE
, remote_supported_packet
,
3999 PACKET_qXfer_spu_read
},
4000 { "qXfer:spu:write", PACKET_DISABLE
, remote_supported_packet
,
4001 PACKET_qXfer_spu_write
},
4002 { "qXfer:osdata:read", PACKET_DISABLE
, remote_supported_packet
,
4003 PACKET_qXfer_osdata
},
4004 { "qXfer:threads:read", PACKET_DISABLE
, remote_supported_packet
,
4005 PACKET_qXfer_threads
},
4006 { "qXfer:traceframe-info:read", PACKET_DISABLE
, remote_supported_packet
,
4007 PACKET_qXfer_traceframe_info
},
4008 { "QPassSignals", PACKET_DISABLE
, remote_supported_packet
,
4009 PACKET_QPassSignals
},
4010 { "QProgramSignals", PACKET_DISABLE
, remote_supported_packet
,
4011 PACKET_QProgramSignals
},
4012 { "QStartNoAckMode", PACKET_DISABLE
, remote_supported_packet
,
4013 PACKET_QStartNoAckMode
},
4014 { "multiprocess", PACKET_DISABLE
, remote_multi_process_feature
, -1 },
4015 { "QNonStop", PACKET_DISABLE
, remote_non_stop_feature
, -1 },
4016 { "qXfer:siginfo:read", PACKET_DISABLE
, remote_supported_packet
,
4017 PACKET_qXfer_siginfo_read
},
4018 { "qXfer:siginfo:write", PACKET_DISABLE
, remote_supported_packet
,
4019 PACKET_qXfer_siginfo_write
},
4020 { "ConditionalTracepoints", PACKET_DISABLE
, remote_cond_tracepoint_feature
,
4021 PACKET_ConditionalTracepoints
},
4022 { "ConditionalBreakpoints", PACKET_DISABLE
, remote_cond_breakpoint_feature
,
4023 PACKET_ConditionalBreakpoints
},
4024 { "BreakpointCommands", PACKET_DISABLE
, remote_breakpoint_commands_feature
,
4025 PACKET_BreakpointCommands
},
4026 { "FastTracepoints", PACKET_DISABLE
, remote_fast_tracepoint_feature
,
4027 PACKET_FastTracepoints
},
4028 { "StaticTracepoints", PACKET_DISABLE
, remote_static_tracepoint_feature
,
4029 PACKET_StaticTracepoints
},
4030 {"InstallInTrace", PACKET_DISABLE
, remote_install_in_trace_feature
,
4031 PACKET_InstallInTrace
},
4032 { "DisconnectedTracing", PACKET_DISABLE
, remote_disconnected_tracing_feature
,
4034 { "ReverseContinue", PACKET_DISABLE
, remote_supported_packet
,
4036 { "ReverseStep", PACKET_DISABLE
, remote_supported_packet
,
4038 { "TracepointSource", PACKET_DISABLE
, remote_supported_packet
,
4039 PACKET_TracepointSource
},
4040 { "QAllow", PACKET_DISABLE
, remote_supported_packet
,
4042 { "EnableDisableTracepoints", PACKET_DISABLE
,
4043 remote_enable_disable_tracepoint_feature
, -1 },
4044 { "qXfer:fdpic:read", PACKET_DISABLE
, remote_supported_packet
,
4045 PACKET_qXfer_fdpic
},
4046 { "qXfer:uib:read", PACKET_DISABLE
, remote_supported_packet
,
4048 { "QDisableRandomization", PACKET_DISABLE
, remote_supported_packet
,
4049 PACKET_QDisableRandomization
},
4050 { "QAgent", PACKET_DISABLE
, remote_supported_packet
, PACKET_QAgent
},
4051 { "QTBuffer:size", PACKET_DISABLE
,
4052 remote_supported_packet
, PACKET_QTBuffer_size
},
4053 { "tracenz", PACKET_DISABLE
,
4054 remote_string_tracing_feature
, -1 },
4055 { "Qbtrace:off", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_off
},
4056 { "Qbtrace:bts", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_bts
},
4057 { "qXfer:btrace:read", PACKET_DISABLE
, remote_supported_packet
,
4058 PACKET_qXfer_btrace
}
4061 static char *remote_support_xml
;
4063 /* Register string appended to "xmlRegisters=" in qSupported query. */
4066 register_remote_support_xml (const char *xml
)
4068 #if defined(HAVE_LIBEXPAT)
4069 if (remote_support_xml
== NULL
)
4070 remote_support_xml
= concat ("xmlRegisters=", xml
, (char *) NULL
);
4073 char *copy
= xstrdup (remote_support_xml
+ 13);
4074 char *p
= strtok (copy
, ",");
4078 if (strcmp (p
, xml
) == 0)
4085 while ((p
= strtok (NULL
, ",")) != NULL
);
4088 remote_support_xml
= reconcat (remote_support_xml
,
4089 remote_support_xml
, ",", xml
,
4096 remote_query_supported_append (char *msg
, const char *append
)
4099 return reconcat (msg
, msg
, ";", append
, (char *) NULL
);
4101 return xstrdup (append
);
4105 remote_query_supported (void)
4107 struct remote_state
*rs
= get_remote_state ();
4110 unsigned char seen
[ARRAY_SIZE (remote_protocol_features
)];
4112 /* The packet support flags are handled differently for this packet
4113 than for most others. We treat an error, a disabled packet, and
4114 an empty response identically: any features which must be reported
4115 to be used will be automatically disabled. An empty buffer
4116 accomplishes this, since that is also the representation for a list
4117 containing no features. */
4120 if (remote_protocol_packets
[PACKET_qSupported
].support
!= PACKET_DISABLE
)
4123 struct cleanup
*old_chain
= make_cleanup (free_current_contents
, &q
);
4125 q
= remote_query_supported_append (q
, "multiprocess+");
4127 if (remote_support_xml
)
4128 q
= remote_query_supported_append (q
, remote_support_xml
);
4130 q
= remote_query_supported_append (q
, "qRelocInsn+");
4132 q
= reconcat (q
, "qSupported:", q
, (char *) NULL
);
4135 do_cleanups (old_chain
);
4137 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4139 /* If an error occured, warn, but do not return - just reset the
4140 buffer to empty and go on to disable features. */
4141 if (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_qSupported
])
4144 warning (_("Remote failure reply: %s"), rs
->buf
);
4149 memset (seen
, 0, sizeof (seen
));
4154 enum packet_support is_supported
;
4155 char *p
, *end
, *name_end
, *value
;
4157 /* First separate out this item from the rest of the packet. If
4158 there's another item after this, we overwrite the separator
4159 (terminated strings are much easier to work with). */
4161 end
= strchr (p
, ';');
4164 end
= p
+ strlen (p
);
4174 warning (_("empty item in \"qSupported\" response"));
4179 name_end
= strchr (p
, '=');
4182 /* This is a name=value entry. */
4183 is_supported
= PACKET_ENABLE
;
4184 value
= name_end
+ 1;
4193 is_supported
= PACKET_ENABLE
;
4197 is_supported
= PACKET_DISABLE
;
4201 is_supported
= PACKET_SUPPORT_UNKNOWN
;
4205 warning (_("unrecognized item \"%s\" "
4206 "in \"qSupported\" response"), p
);
4212 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
4213 if (strcmp (remote_protocol_features
[i
].name
, p
) == 0)
4215 const struct protocol_feature
*feature
;
4218 feature
= &remote_protocol_features
[i
];
4219 feature
->func (feature
, is_supported
, value
);
4224 /* If we increased the packet size, make sure to increase the global
4225 buffer size also. We delay this until after parsing the entire
4226 qSupported packet, because this is the same buffer we were
4228 if (rs
->buf_size
< rs
->explicit_packet_size
)
4230 rs
->buf_size
= rs
->explicit_packet_size
;
4231 rs
->buf
= xrealloc (rs
->buf
, rs
->buf_size
);
4234 /* Handle the defaults for unmentioned features. */
4235 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
4238 const struct protocol_feature
*feature
;
4240 feature
= &remote_protocol_features
[i
];
4241 feature
->func (feature
, feature
->default_support
, NULL
);
4245 /* Remove any of the remote.c targets from target stack. Upper targets depend
4246 on it so remove them first. */
4249 remote_unpush_target (void)
4251 pop_all_targets_above (process_stratum
- 1);
4255 remote_open_1 (char *name
, int from_tty
,
4256 struct target_ops
*target
, int extended_p
)
4258 struct remote_state
*rs
= get_remote_state ();
4261 error (_("To open a remote debug connection, you need to specify what\n"
4262 "serial device is attached to the remote system\n"
4263 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
4265 /* See FIXME above. */
4266 if (!target_async_permitted
)
4267 wait_forever_enabled_p
= 1;
4269 /* If we're connected to a running target, target_preopen will kill it.
4270 Ask this question first, before target_preopen has a chance to kill
4272 if (rs
->remote_desc
!= NULL
&& !have_inferiors ())
4275 && !query (_("Already connected to a remote target. Disconnect? ")))
4276 error (_("Still connected."));
4279 /* Here the possibly existing remote target gets unpushed. */
4280 target_preopen (from_tty
);
4282 /* Make sure we send the passed signals list the next time we resume. */
4283 xfree (rs
->last_pass_packet
);
4284 rs
->last_pass_packet
= NULL
;
4286 /* Make sure we send the program signals list the next time we
4288 xfree (rs
->last_program_signals_packet
);
4289 rs
->last_program_signals_packet
= NULL
;
4291 remote_fileio_reset ();
4292 reopen_exec_file ();
4295 rs
->remote_desc
= remote_serial_open (name
);
4296 if (!rs
->remote_desc
)
4297 perror_with_name (name
);
4299 if (baud_rate
!= -1)
4301 if (serial_setbaudrate (rs
->remote_desc
, baud_rate
))
4303 /* The requested speed could not be set. Error out to
4304 top level after closing remote_desc. Take care to
4305 set remote_desc to NULL to avoid closing remote_desc
4307 serial_close (rs
->remote_desc
);
4308 rs
->remote_desc
= NULL
;
4309 perror_with_name (name
);
4313 serial_raw (rs
->remote_desc
);
4315 /* If there is something sitting in the buffer we might take it as a
4316 response to a command, which would be bad. */
4317 serial_flush_input (rs
->remote_desc
);
4321 puts_filtered ("Remote debugging using ");
4322 puts_filtered (name
);
4323 puts_filtered ("\n");
4325 push_target (target
); /* Switch to using remote target now. */
4327 /* Register extra event sources in the event loop. */
4328 remote_async_inferior_event_token
4329 = create_async_event_handler (remote_async_inferior_event_handler
,
4331 rs
->notif_state
= remote_notif_state_allocate ();
4333 /* Reset the target state; these things will be queried either by
4334 remote_query_supported or as they are needed. */
4335 init_all_packet_configs ();
4336 rs
->cached_wait_status
= 0;
4337 rs
->explicit_packet_size
= 0;
4339 rs
->multi_process_aware
= 0;
4340 rs
->extended
= extended_p
;
4341 rs
->non_stop_aware
= 0;
4342 rs
->waiting_for_stop_reply
= 0;
4343 rs
->ctrlc_pending_p
= 0;
4345 rs
->general_thread
= not_sent_ptid
;
4346 rs
->continue_thread
= not_sent_ptid
;
4347 rs
->remote_traceframe_number
= -1;
4349 /* Probe for ability to use "ThreadInfo" query, as required. */
4350 rs
->use_threadinfo_query
= 1;
4351 rs
->use_threadextra_query
= 1;
4353 if (target_async_permitted
)
4355 /* With this target we start out by owning the terminal. */
4356 remote_async_terminal_ours_p
= 1;
4358 /* FIXME: cagney/1999-09-23: During the initial connection it is
4359 assumed that the target is already ready and able to respond to
4360 requests. Unfortunately remote_start_remote() eventually calls
4361 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
4362 around this. Eventually a mechanism that allows
4363 wait_for_inferior() to expect/get timeouts will be
4365 wait_forever_enabled_p
= 0;
4368 /* First delete any symbols previously loaded from shared libraries. */
4369 no_shared_libraries (NULL
, 0);
4372 init_thread_list ();
4374 /* Start the remote connection. If error() or QUIT, discard this
4375 target (we'd otherwise be in an inconsistent state) and then
4376 propogate the error on up the exception chain. This ensures that
4377 the caller doesn't stumble along blindly assuming that the
4378 function succeeded. The CLI doesn't have this problem but other
4379 UI's, such as MI do.
4381 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
4382 this function should return an error indication letting the
4383 caller restore the previous state. Unfortunately the command
4384 ``target remote'' is directly wired to this function making that
4385 impossible. On a positive note, the CLI side of this problem has
4386 been fixed - the function set_cmd_context() makes it possible for
4387 all the ``target ....'' commands to share a common callback
4388 function. See cli-dump.c. */
4390 volatile struct gdb_exception ex
;
4392 TRY_CATCH (ex
, RETURN_MASK_ALL
)
4394 remote_start_remote (from_tty
, target
, extended_p
);
4398 /* Pop the partially set up target - unless something else did
4399 already before throwing the exception. */
4400 if (rs
->remote_desc
!= NULL
)
4401 remote_unpush_target ();
4402 if (target_async_permitted
)
4403 wait_forever_enabled_p
= 1;
4404 throw_exception (ex
);
4408 if (target_async_permitted
)
4409 wait_forever_enabled_p
= 1;
4412 /* This takes a program previously attached to and detaches it. After
4413 this is done, GDB can be used to debug some other program. We
4414 better not have left any breakpoints in the target program or it'll
4415 die when it hits one. */
4418 remote_detach_1 (const char *args
, int from_tty
, int extended
)
4420 int pid
= ptid_get_pid (inferior_ptid
);
4421 struct remote_state
*rs
= get_remote_state ();
4424 error (_("Argument given to \"detach\" when remotely debugging."));
4426 if (!target_has_execution
)
4427 error (_("No process to detach from."));
4431 char *exec_file
= get_exec_file (0);
4432 if (exec_file
== NULL
)
4434 printf_unfiltered (_("Detaching from program: %s, %s\n"), exec_file
,
4435 target_pid_to_str (pid_to_ptid (pid
)));
4436 gdb_flush (gdb_stdout
);
4439 /* Tell the remote target to detach. */
4440 if (remote_multi_process_p (rs
))
4441 xsnprintf (rs
->buf
, get_remote_packet_size (), "D;%x", pid
);
4443 strcpy (rs
->buf
, "D");
4446 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4448 if (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K')
4450 else if (rs
->buf
[0] == '\0')
4451 error (_("Remote doesn't know how to detach"));
4453 error (_("Can't detach process."));
4455 if (from_tty
&& !extended
)
4456 puts_filtered (_("Ending remote debugging.\n"));
4458 target_mourn_inferior ();
4462 remote_detach (struct target_ops
*ops
, const char *args
, int from_tty
)
4464 remote_detach_1 (args
, from_tty
, 0);
4468 extended_remote_detach (struct target_ops
*ops
, const char *args
, int from_tty
)
4470 remote_detach_1 (args
, from_tty
, 1);
4473 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
4476 remote_disconnect (struct target_ops
*target
, char *args
, int from_tty
)
4479 error (_("Argument given to \"disconnect\" when remotely debugging."));
4481 /* Make sure we unpush even the extended remote targets; mourn
4482 won't do it. So call remote_mourn_1 directly instead of
4483 target_mourn_inferior. */
4484 remote_mourn_1 (target
);
4487 puts_filtered ("Ending remote debugging.\n");
4490 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
4491 be chatty about it. */
4494 extended_remote_attach_1 (struct target_ops
*target
, char *args
, int from_tty
)
4496 struct remote_state
*rs
= get_remote_state ();
4498 char *wait_status
= NULL
;
4500 pid
= parse_pid_to_attach (args
);
4502 /* Remote PID can be freely equal to getpid, do not check it here the same
4503 way as in other targets. */
4505 if (remote_protocol_packets
[PACKET_vAttach
].support
== PACKET_DISABLE
)
4506 error (_("This target does not support attaching to a process"));
4510 char *exec_file
= get_exec_file (0);
4513 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file
,
4514 target_pid_to_str (pid_to_ptid (pid
)));
4516 printf_unfiltered (_("Attaching to %s\n"),
4517 target_pid_to_str (pid_to_ptid (pid
)));
4519 gdb_flush (gdb_stdout
);
4522 xsnprintf (rs
->buf
, get_remote_packet_size (), "vAttach;%x", pid
);
4524 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4526 if (packet_ok (rs
->buf
,
4527 &remote_protocol_packets
[PACKET_vAttach
]) == PACKET_OK
)
4531 /* Save the reply for later. */
4532 wait_status
= alloca (strlen (rs
->buf
) + 1);
4533 strcpy (wait_status
, rs
->buf
);
4535 else if (strcmp (rs
->buf
, "OK") != 0)
4536 error (_("Attaching to %s failed with: %s"),
4537 target_pid_to_str (pid_to_ptid (pid
)),
4540 else if (remote_protocol_packets
[PACKET_vAttach
].support
== PACKET_DISABLE
)
4541 error (_("This target does not support attaching to a process"));
4543 error (_("Attaching to %s failed"),
4544 target_pid_to_str (pid_to_ptid (pid
)));
4546 set_current_inferior (remote_add_inferior (0, pid
, 1));
4548 inferior_ptid
= pid_to_ptid (pid
);
4552 struct thread_info
*thread
;
4554 /* Get list of threads. */
4555 remote_threads_info (target
);
4557 thread
= first_thread_of_process (pid
);
4559 inferior_ptid
= thread
->ptid
;
4561 inferior_ptid
= pid_to_ptid (pid
);
4563 /* Invalidate our notion of the remote current thread. */
4564 record_currthread (rs
, minus_one_ptid
);
4568 /* Now, if we have thread information, update inferior_ptid. */
4569 inferior_ptid
= remote_current_thread (inferior_ptid
);
4571 /* Add the main thread to the thread list. */
4572 add_thread_silent (inferior_ptid
);
4575 /* Next, if the target can specify a description, read it. We do
4576 this before anything involving memory or registers. */
4577 target_find_description ();
4581 /* Use the previously fetched status. */
4582 gdb_assert (wait_status
!= NULL
);
4584 if (target_can_async_p ())
4586 struct notif_event
*reply
4587 = remote_notif_parse (¬if_client_stop
, wait_status
);
4589 push_stop_reply ((struct stop_reply
*) reply
);
4591 target_async (inferior_event_handler
, 0);
4595 gdb_assert (wait_status
!= NULL
);
4596 strcpy (rs
->buf
, wait_status
);
4597 rs
->cached_wait_status
= 1;
4601 gdb_assert (wait_status
== NULL
);
4605 extended_remote_attach (struct target_ops
*ops
, char *args
, int from_tty
)
4607 extended_remote_attach_1 (ops
, args
, from_tty
);
4611 /* Check for the availability of vCont. This function should also check
4615 remote_vcont_probe (struct remote_state
*rs
)
4619 strcpy (rs
->buf
, "vCont?");
4621 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4624 /* Make sure that the features we assume are supported. */
4625 if (strncmp (buf
, "vCont", 5) == 0)
4628 int support_s
, support_S
, support_c
, support_C
;
4634 rs
->supports_vCont
.t
= 0;
4635 rs
->supports_vCont
.r
= 0;
4636 while (p
&& *p
== ';')
4639 if (*p
== 's' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4641 else if (*p
== 'S' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4643 else if (*p
== 'c' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4645 else if (*p
== 'C' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4647 else if (*p
== 't' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4648 rs
->supports_vCont
.t
= 1;
4649 else if (*p
== 'r' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
4650 rs
->supports_vCont
.r
= 1;
4652 p
= strchr (p
, ';');
4655 /* If s, S, c, and C are not all supported, we can't use vCont. Clearing
4656 BUF will make packet_ok disable the packet. */
4657 if (!support_s
|| !support_S
|| !support_c
|| !support_C
)
4661 packet_ok (buf
, &remote_protocol_packets
[PACKET_vCont
]);
4664 /* Helper function for building "vCont" resumptions. Write a
4665 resumption to P. ENDP points to one-passed-the-end of the buffer
4666 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
4667 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
4668 resumed thread should be single-stepped and/or signalled. If PTID
4669 equals minus_one_ptid, then all threads are resumed; if PTID
4670 represents a process, then all threads of the process are resumed;
4671 the thread to be stepped and/or signalled is given in the global
4675 append_resumption (char *p
, char *endp
,
4676 ptid_t ptid
, int step
, enum gdb_signal siggnal
)
4678 struct remote_state
*rs
= get_remote_state ();
4680 if (step
&& siggnal
!= GDB_SIGNAL_0
)
4681 p
+= xsnprintf (p
, endp
- p
, ";S%02x", siggnal
);
4683 /* GDB is willing to range step. */
4684 && use_range_stepping
4685 /* Target supports range stepping. */
4686 && rs
->supports_vCont
.r
4687 /* We don't currently support range stepping multiple
4688 threads with a wildcard (though the protocol allows it,
4689 so stubs shouldn't make an active effort to forbid
4691 && !(remote_multi_process_p (rs
) && ptid_is_pid (ptid
)))
4693 struct thread_info
*tp
;
4695 if (ptid_equal (ptid
, minus_one_ptid
))
4697 /* If we don't know about the target thread's tid, then
4698 we're resuming magic_null_ptid (see caller). */
4699 tp
= find_thread_ptid (magic_null_ptid
);
4702 tp
= find_thread_ptid (ptid
);
4703 gdb_assert (tp
!= NULL
);
4705 if (tp
->control
.may_range_step
)
4707 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
4709 p
+= xsnprintf (p
, endp
- p
, ";r%s,%s",
4710 phex_nz (tp
->control
.step_range_start
,
4712 phex_nz (tp
->control
.step_range_end
,
4716 p
+= xsnprintf (p
, endp
- p
, ";s");
4719 p
+= xsnprintf (p
, endp
- p
, ";s");
4720 else if (siggnal
!= GDB_SIGNAL_0
)
4721 p
+= xsnprintf (p
, endp
- p
, ";C%02x", siggnal
);
4723 p
+= xsnprintf (p
, endp
- p
, ";c");
4725 if (remote_multi_process_p (rs
) && ptid_is_pid (ptid
))
4729 /* All (-1) threads of process. */
4730 nptid
= ptid_build (ptid_get_pid (ptid
), -1, 0);
4732 p
+= xsnprintf (p
, endp
- p
, ":");
4733 p
= write_ptid (p
, endp
, nptid
);
4735 else if (!ptid_equal (ptid
, minus_one_ptid
))
4737 p
+= xsnprintf (p
, endp
- p
, ":");
4738 p
= write_ptid (p
, endp
, ptid
);
4744 /* Append a vCont continue-with-signal action for threads that have a
4745 non-zero stop signal. */
4748 append_pending_thread_resumptions (char *p
, char *endp
, ptid_t ptid
)
4750 struct thread_info
*thread
;
4752 ALL_THREADS (thread
)
4753 if (ptid_match (thread
->ptid
, ptid
)
4754 && !ptid_equal (inferior_ptid
, thread
->ptid
)
4755 && thread
->suspend
.stop_signal
!= GDB_SIGNAL_0
4756 && signal_pass_state (thread
->suspend
.stop_signal
))
4758 p
= append_resumption (p
, endp
, thread
->ptid
,
4759 0, thread
->suspend
.stop_signal
);
4760 thread
->suspend
.stop_signal
= GDB_SIGNAL_0
;
4766 /* Resume the remote inferior by using a "vCont" packet. The thread
4767 to be resumed is PTID; STEP and SIGGNAL indicate whether the
4768 resumed thread should be single-stepped and/or signalled. If PTID
4769 equals minus_one_ptid, then all threads are resumed; the thread to
4770 be stepped and/or signalled is given in the global INFERIOR_PTID.
4771 This function returns non-zero iff it resumes the inferior.
4773 This function issues a strict subset of all possible vCont commands at the
4777 remote_vcont_resume (ptid_t ptid
, int step
, enum gdb_signal siggnal
)
4779 struct remote_state
*rs
= get_remote_state ();
4783 if (remote_protocol_packets
[PACKET_vCont
].support
== PACKET_SUPPORT_UNKNOWN
)
4784 remote_vcont_probe (rs
);
4786 if (remote_protocol_packets
[PACKET_vCont
].support
== PACKET_DISABLE
)
4790 endp
= rs
->buf
+ get_remote_packet_size ();
4792 /* If we could generate a wider range of packets, we'd have to worry
4793 about overflowing BUF. Should there be a generic
4794 "multi-part-packet" packet? */
4796 p
+= xsnprintf (p
, endp
- p
, "vCont");
4798 if (ptid_equal (ptid
, magic_null_ptid
))
4800 /* MAGIC_NULL_PTID means that we don't have any active threads,
4801 so we don't have any TID numbers the inferior will
4802 understand. Make sure to only send forms that do not specify
4804 append_resumption (p
, endp
, minus_one_ptid
, step
, siggnal
);
4806 else if (ptid_equal (ptid
, minus_one_ptid
) || ptid_is_pid (ptid
))
4808 /* Resume all threads (of all processes, or of a single
4809 process), with preference for INFERIOR_PTID. This assumes
4810 inferior_ptid belongs to the set of all threads we are about
4812 if (step
|| siggnal
!= GDB_SIGNAL_0
)
4814 /* Step inferior_ptid, with or without signal. */
4815 p
= append_resumption (p
, endp
, inferior_ptid
, step
, siggnal
);
4818 /* Also pass down any pending signaled resumption for other
4819 threads not the current. */
4820 p
= append_pending_thread_resumptions (p
, endp
, ptid
);
4822 /* And continue others without a signal. */
4823 append_resumption (p
, endp
, ptid
, /*step=*/ 0, GDB_SIGNAL_0
);
4827 /* Scheduler locking; resume only PTID. */
4828 append_resumption (p
, endp
, ptid
, step
, siggnal
);
4831 gdb_assert (strlen (rs
->buf
) < get_remote_packet_size ());
4836 /* In non-stop, the stub replies to vCont with "OK". The stop
4837 reply will be reported asynchronously by means of a `%Stop'
4839 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
4840 if (strcmp (rs
->buf
, "OK") != 0)
4841 error (_("Unexpected vCont reply in non-stop mode: %s"), rs
->buf
);
4847 /* Tell the remote machine to resume. */
4850 remote_resume (struct target_ops
*ops
,
4851 ptid_t ptid
, int step
, enum gdb_signal siggnal
)
4853 struct remote_state
*rs
= get_remote_state ();
4856 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
4857 (explained in remote-notif.c:handle_notification) so
4858 remote_notif_process is not called. We need find a place where
4859 it is safe to start a 'vNotif' sequence. It is good to do it
4860 before resuming inferior, because inferior was stopped and no RSP
4861 traffic at that moment. */
4863 remote_notif_process (rs
->notif_state
, ¬if_client_stop
);
4865 rs
->last_sent_signal
= siggnal
;
4866 rs
->last_sent_step
= step
;
4868 /* The vCont packet doesn't need to specify threads via Hc. */
4869 /* No reverse support (yet) for vCont. */
4870 if (execution_direction
!= EXEC_REVERSE
)
4871 if (remote_vcont_resume (ptid
, step
, siggnal
))
4874 /* All other supported resume packets do use Hc, so set the continue
4876 if (ptid_equal (ptid
, minus_one_ptid
))
4877 set_continue_thread (any_thread_ptid
);
4879 set_continue_thread (ptid
);
4882 if (execution_direction
== EXEC_REVERSE
)
4884 /* We don't pass signals to the target in reverse exec mode. */
4885 if (info_verbose
&& siggnal
!= GDB_SIGNAL_0
)
4886 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
4890 && remote_protocol_packets
[PACKET_bs
].support
== PACKET_DISABLE
)
4891 error (_("Remote reverse-step not supported."));
4893 && remote_protocol_packets
[PACKET_bc
].support
== PACKET_DISABLE
)
4894 error (_("Remote reverse-continue not supported."));
4896 strcpy (buf
, step
? "bs" : "bc");
4898 else if (siggnal
!= GDB_SIGNAL_0
)
4900 buf
[0] = step
? 'S' : 'C';
4901 buf
[1] = tohex (((int) siggnal
>> 4) & 0xf);
4902 buf
[2] = tohex (((int) siggnal
) & 0xf);
4906 strcpy (buf
, step
? "s" : "c");
4911 /* We are about to start executing the inferior, let's register it
4912 with the event loop. NOTE: this is the one place where all the
4913 execution commands end up. We could alternatively do this in each
4914 of the execution commands in infcmd.c. */
4915 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
4916 into infcmd.c in order to allow inferior function calls to work
4917 NOT asynchronously. */
4918 if (target_can_async_p ())
4919 target_async (inferior_event_handler
, 0);
4921 /* We've just told the target to resume. The remote server will
4922 wait for the inferior to stop, and then send a stop reply. In
4923 the mean time, we can't start another command/query ourselves
4924 because the stub wouldn't be ready to process it. This applies
4925 only to the base all-stop protocol, however. In non-stop (which
4926 only supports vCont), the stub replies with an "OK", and is
4927 immediate able to process further serial input. */
4929 rs
->waiting_for_stop_reply
= 1;
4933 /* Set up the signal handler for SIGINT, while the target is
4934 executing, ovewriting the 'regular' SIGINT signal handler. */
4936 async_initialize_sigint_signal_handler (void)
4938 signal (SIGINT
, async_handle_remote_sigint
);
4941 /* Signal handler for SIGINT, while the target is executing. */
4943 async_handle_remote_sigint (int sig
)
4945 signal (sig
, async_handle_remote_sigint_twice
);
4946 mark_async_signal_handler (async_sigint_remote_token
);
4949 /* Signal handler for SIGINT, installed after SIGINT has already been
4950 sent once. It will take effect the second time that the user sends
4953 async_handle_remote_sigint_twice (int sig
)
4955 signal (sig
, async_handle_remote_sigint
);
4956 mark_async_signal_handler (async_sigint_remote_twice_token
);
4959 /* Perform the real interruption of the target execution, in response
4962 async_remote_interrupt (gdb_client_data arg
)
4965 fprintf_unfiltered (gdb_stdlog
, "async_remote_interrupt called\n");
4967 target_stop (inferior_ptid
);
4970 /* Perform interrupt, if the first attempt did not succeed. Just give
4971 up on the target alltogether. */
4973 async_remote_interrupt_twice (gdb_client_data arg
)
4976 fprintf_unfiltered (gdb_stdlog
, "async_remote_interrupt_twice called\n");
4981 /* Reinstall the usual SIGINT handlers, after the target has
4984 async_cleanup_sigint_signal_handler (void *dummy
)
4986 signal (SIGINT
, handle_sigint
);
4989 /* Send ^C to target to halt it. Target will respond, and send us a
4991 static void (*ofunc
) (int);
4993 /* The command line interface's stop routine. This function is installed
4994 as a signal handler for SIGINT. The first time a user requests a
4995 stop, we call remote_stop to send a break or ^C. If there is no
4996 response from the target (it didn't stop when the user requested it),
4997 we ask the user if he'd like to detach from the target. */
4999 sync_remote_interrupt (int signo
)
5001 /* If this doesn't work, try more severe steps. */
5002 signal (signo
, sync_remote_interrupt_twice
);
5004 gdb_call_async_signal_handler (async_sigint_remote_token
, 1);
5007 /* The user typed ^C twice. */
5010 sync_remote_interrupt_twice (int signo
)
5012 signal (signo
, ofunc
);
5013 gdb_call_async_signal_handler (async_sigint_remote_twice_token
, 1);
5014 signal (signo
, sync_remote_interrupt
);
5017 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
5018 thread, all threads of a remote process, or all threads of all
5022 remote_stop_ns (ptid_t ptid
)
5024 struct remote_state
*rs
= get_remote_state ();
5026 char *endp
= rs
->buf
+ get_remote_packet_size ();
5028 if (remote_protocol_packets
[PACKET_vCont
].support
== PACKET_SUPPORT_UNKNOWN
)
5029 remote_vcont_probe (rs
);
5031 if (!rs
->supports_vCont
.t
)
5032 error (_("Remote server does not support stopping threads"));
5034 if (ptid_equal (ptid
, minus_one_ptid
)
5035 || (!remote_multi_process_p (rs
) && ptid_is_pid (ptid
)))
5036 p
+= xsnprintf (p
, endp
- p
, "vCont;t");
5041 p
+= xsnprintf (p
, endp
- p
, "vCont;t:");
5043 if (ptid_is_pid (ptid
))
5044 /* All (-1) threads of process. */
5045 nptid
= ptid_build (ptid_get_pid (ptid
), -1, 0);
5048 /* Small optimization: if we already have a stop reply for
5049 this thread, no use in telling the stub we want this
5051 if (peek_stop_reply (ptid
))
5057 write_ptid (p
, endp
, nptid
);
5060 /* In non-stop, we get an immediate OK reply. The stop reply will
5061 come in asynchronously by notification. */
5063 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
5064 if (strcmp (rs
->buf
, "OK") != 0)
5065 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid
), rs
->buf
);
5068 /* All-stop version of target_stop. Sends a break or a ^C to stop the
5069 remote target. It is undefined which thread of which process
5070 reports the stop. */
5073 remote_stop_as (ptid_t ptid
)
5075 struct remote_state
*rs
= get_remote_state ();
5077 rs
->ctrlc_pending_p
= 1;
5079 /* If the inferior is stopped already, but the core didn't know
5080 about it yet, just ignore the request. The cached wait status
5081 will be collected in remote_wait. */
5082 if (rs
->cached_wait_status
)
5085 /* Send interrupt_sequence to remote target. */
5086 send_interrupt_sequence ();
5089 /* This is the generic stop called via the target vector. When a target
5090 interrupt is requested, either by the command line or the GUI, we
5091 will eventually end up here. */
5094 remote_stop (struct target_ops
*self
, ptid_t ptid
)
5097 fprintf_unfiltered (gdb_stdlog
, "remote_stop called\n");
5100 remote_stop_ns (ptid
);
5102 remote_stop_as (ptid
);
5105 /* Ask the user what to do when an interrupt is received. */
5108 interrupt_query (void)
5110 target_terminal_ours ();
5112 if (target_can_async_p ())
5114 signal (SIGINT
, handle_sigint
);
5119 if (query (_("Interrupted while waiting for the program.\n\
5120 Give up (and stop debugging it)? ")))
5122 remote_unpush_target ();
5127 target_terminal_inferior ();
5130 /* Enable/disable target terminal ownership. Most targets can use
5131 terminal groups to control terminal ownership. Remote targets are
5132 different in that explicit transfer of ownership to/from GDB/target
5136 remote_terminal_inferior (struct target_ops
*self
)
5138 if (!target_async_permitted
)
5139 /* Nothing to do. */
5142 /* FIXME: cagney/1999-09-27: Make calls to target_terminal_*()
5143 idempotent. The event-loop GDB talking to an asynchronous target
5144 with a synchronous command calls this function from both
5145 event-top.c and infrun.c/infcmd.c. Once GDB stops trying to
5146 transfer the terminal to the target when it shouldn't this guard
5148 if (!remote_async_terminal_ours_p
)
5150 delete_file_handler (input_fd
);
5151 remote_async_terminal_ours_p
= 0;
5152 async_initialize_sigint_signal_handler ();
5153 /* NOTE: At this point we could also register our selves as the
5154 recipient of all input. Any characters typed could then be
5155 passed on down to the target. */
5159 remote_terminal_ours (struct target_ops
*self
)
5161 if (!target_async_permitted
)
5162 /* Nothing to do. */
5165 /* See FIXME in remote_terminal_inferior. */
5166 if (remote_async_terminal_ours_p
)
5168 async_cleanup_sigint_signal_handler (NULL
);
5169 add_file_handler (input_fd
, stdin_event_handler
, 0);
5170 remote_async_terminal_ours_p
= 1;
5174 remote_console_output (char *msg
)
5178 for (p
= msg
; p
[0] && p
[1]; p
+= 2)
5181 char c
= fromhex (p
[0]) * 16 + fromhex (p
[1]);
5185 fputs_unfiltered (tb
, gdb_stdtarg
);
5187 gdb_flush (gdb_stdtarg
);
5190 typedef struct cached_reg
5193 gdb_byte data
[MAX_REGISTER_SIZE
];
5196 DEF_VEC_O(cached_reg_t
);
5198 typedef struct stop_reply
5200 struct notif_event base
;
5202 /* The identifier of the thread about this event */
5205 /* The remote state this event is associated with. When the remote
5206 connection, represented by a remote_state object, is closed,
5207 all the associated stop_reply events should be released. */
5208 struct remote_state
*rs
;
5210 struct target_waitstatus ws
;
5212 /* Expedited registers. This makes remote debugging a bit more
5213 efficient for those targets that provide critical registers as
5214 part of their normal status mechanism (as another roundtrip to
5215 fetch them is avoided). */
5216 VEC(cached_reg_t
) *regcache
;
5218 int stopped_by_watchpoint_p
;
5219 CORE_ADDR watch_data_address
;
5224 DECLARE_QUEUE_P (stop_reply_p
);
5225 DEFINE_QUEUE_P (stop_reply_p
);
5226 /* The list of already fetched and acknowledged stop events. This
5227 queue is used for notification Stop, and other notifications
5228 don't need queue for their events, because the notification events
5229 of Stop can't be consumed immediately, so that events should be
5230 queued first, and be consumed by remote_wait_{ns,as} one per
5231 time. Other notifications can consume their events immediately,
5232 so queue is not needed for them. */
5233 static QUEUE (stop_reply_p
) *stop_reply_queue
;
5236 stop_reply_xfree (struct stop_reply
*r
)
5238 notif_event_xfree ((struct notif_event
*) r
);
5242 remote_notif_stop_parse (struct notif_client
*self
, char *buf
,
5243 struct notif_event
*event
)
5245 remote_parse_stop_reply (buf
, (struct stop_reply
*) event
);
5249 remote_notif_stop_ack (struct notif_client
*self
, char *buf
,
5250 struct notif_event
*event
)
5252 struct stop_reply
*stop_reply
= (struct stop_reply
*) event
;
5255 putpkt ((char *) self
->ack_command
);
5257 if (stop_reply
->ws
.kind
== TARGET_WAITKIND_IGNORE
)
5258 /* We got an unknown stop reply. */
5259 error (_("Unknown stop reply"));
5261 push_stop_reply (stop_reply
);
5265 remote_notif_stop_can_get_pending_events (struct notif_client
*self
)
5267 /* We can't get pending events in remote_notif_process for
5268 notification stop, and we have to do this in remote_wait_ns
5269 instead. If we fetch all queued events from stub, remote stub
5270 may exit and we have no chance to process them back in
5272 mark_async_event_handler (remote_async_inferior_event_token
);
5277 stop_reply_dtr (struct notif_event
*event
)
5279 struct stop_reply
*r
= (struct stop_reply
*) event
;
5281 VEC_free (cached_reg_t
, r
->regcache
);
5284 static struct notif_event
*
5285 remote_notif_stop_alloc_reply (void)
5287 struct notif_event
*r
5288 = (struct notif_event
*) XNEW (struct stop_reply
);
5290 r
->dtr
= stop_reply_dtr
;
5295 /* A client of notification Stop. */
5297 struct notif_client notif_client_stop
=
5301 remote_notif_stop_parse
,
5302 remote_notif_stop_ack
,
5303 remote_notif_stop_can_get_pending_events
,
5304 remote_notif_stop_alloc_reply
,
5308 /* A parameter to pass data in and out. */
5310 struct queue_iter_param
5313 struct stop_reply
*output
;
5316 /* Remove stop replies in the queue if its pid is equal to the given
5320 remove_stop_reply_for_inferior (QUEUE (stop_reply_p
) *q
,
5321 QUEUE_ITER (stop_reply_p
) *iter
,
5325 struct queue_iter_param
*param
= data
;
5326 struct inferior
*inf
= param
->input
;
5328 if (ptid_get_pid (event
->ptid
) == inf
->pid
)
5330 stop_reply_xfree (event
);
5331 QUEUE_remove_elem (stop_reply_p
, q
, iter
);
5337 /* Discard all pending stop replies of inferior INF. */
5340 discard_pending_stop_replies (struct inferior
*inf
)
5343 struct queue_iter_param param
;
5344 struct stop_reply
*reply
;
5345 struct remote_state
*rs
= get_remote_state ();
5346 struct remote_notif_state
*rns
= rs
->notif_state
;
5348 /* This function can be notified when an inferior exists. When the
5349 target is not remote, the notification state is NULL. */
5350 if (rs
->remote_desc
== NULL
)
5353 reply
= (struct stop_reply
*) rns
->pending_event
[notif_client_stop
.id
];
5355 /* Discard the in-flight notification. */
5356 if (reply
!= NULL
&& ptid_get_pid (reply
->ptid
) == inf
->pid
)
5358 stop_reply_xfree (reply
);
5359 rns
->pending_event
[notif_client_stop
.id
] = NULL
;
5363 param
.output
= NULL
;
5364 /* Discard the stop replies we have already pulled with
5366 QUEUE_iterate (stop_reply_p
, stop_reply_queue
,
5367 remove_stop_reply_for_inferior
, ¶m
);
5370 /* If its remote state is equal to the given remote state,
5371 remove EVENT from the stop reply queue. */
5374 remove_stop_reply_of_remote_state (QUEUE (stop_reply_p
) *q
,
5375 QUEUE_ITER (stop_reply_p
) *iter
,
5379 struct queue_iter_param
*param
= data
;
5380 struct remote_state
*rs
= param
->input
;
5382 if (event
->rs
== rs
)
5384 stop_reply_xfree (event
);
5385 QUEUE_remove_elem (stop_reply_p
, q
, iter
);
5391 /* Discard the stop replies for RS in stop_reply_queue. */
5394 discard_pending_stop_replies_in_queue (struct remote_state
*rs
)
5396 struct queue_iter_param param
;
5399 param
.output
= NULL
;
5400 /* Discard the stop replies we have already pulled with
5402 QUEUE_iterate (stop_reply_p
, stop_reply_queue
,
5403 remove_stop_reply_of_remote_state
, ¶m
);
5406 /* A parameter to pass data in and out. */
5409 remote_notif_remove_once_on_match (QUEUE (stop_reply_p
) *q
,
5410 QUEUE_ITER (stop_reply_p
) *iter
,
5414 struct queue_iter_param
*param
= data
;
5415 ptid_t
*ptid
= param
->input
;
5417 if (ptid_match (event
->ptid
, *ptid
))
5419 param
->output
= event
;
5420 QUEUE_remove_elem (stop_reply_p
, q
, iter
);
5427 /* Remove the first reply in 'stop_reply_queue' which matches
5430 static struct stop_reply
*
5431 remote_notif_remove_queued_reply (ptid_t ptid
)
5433 struct queue_iter_param param
;
5435 param
.input
= &ptid
;
5436 param
.output
= NULL
;
5438 QUEUE_iterate (stop_reply_p
, stop_reply_queue
,
5439 remote_notif_remove_once_on_match
, ¶m
);
5441 fprintf_unfiltered (gdb_stdlog
,
5442 "notif: discard queued event: 'Stop' in %s\n",
5443 target_pid_to_str (ptid
));
5445 return param
.output
;
5448 /* Look for a queued stop reply belonging to PTID. If one is found,
5449 remove it from the queue, and return it. Returns NULL if none is
5450 found. If there are still queued events left to process, tell the
5451 event loop to get back to target_wait soon. */
5453 static struct stop_reply
*
5454 queued_stop_reply (ptid_t ptid
)
5456 struct stop_reply
*r
= remote_notif_remove_queued_reply (ptid
);
5458 if (!QUEUE_is_empty (stop_reply_p
, stop_reply_queue
))
5459 /* There's still at least an event left. */
5460 mark_async_event_handler (remote_async_inferior_event_token
);
5465 /* Push a fully parsed stop reply in the stop reply queue. Since we
5466 know that we now have at least one queued event left to pass to the
5467 core side, tell the event loop to get back to target_wait soon. */
5470 push_stop_reply (struct stop_reply
*new_event
)
5472 QUEUE_enque (stop_reply_p
, stop_reply_queue
, new_event
);
5475 fprintf_unfiltered (gdb_stdlog
,
5476 "notif: push 'Stop' %s to queue %d\n",
5477 target_pid_to_str (new_event
->ptid
),
5478 QUEUE_length (stop_reply_p
,
5481 mark_async_event_handler (remote_async_inferior_event_token
);
5485 stop_reply_match_ptid_and_ws (QUEUE (stop_reply_p
) *q
,
5486 QUEUE_ITER (stop_reply_p
) *iter
,
5487 struct stop_reply
*event
,
5490 ptid_t
*ptid
= data
;
5492 return !(ptid_equal (*ptid
, event
->ptid
)
5493 && event
->ws
.kind
== TARGET_WAITKIND_STOPPED
);
5496 /* Returns true if we have a stop reply for PTID. */
5499 peek_stop_reply (ptid_t ptid
)
5501 return !QUEUE_iterate (stop_reply_p
, stop_reply_queue
,
5502 stop_reply_match_ptid_and_ws
, &ptid
);
5505 /* Parse the stop reply in BUF. Either the function succeeds, and the
5506 result is stored in EVENT, or throws an error. */
5509 remote_parse_stop_reply (char *buf
, struct stop_reply
*event
)
5511 struct remote_arch_state
*rsa
= get_remote_arch_state ();
5515 event
->ptid
= null_ptid
;
5516 event
->rs
= get_remote_state ();
5517 event
->ws
.kind
= TARGET_WAITKIND_IGNORE
;
5518 event
->ws
.value
.integer
= 0;
5519 event
->stopped_by_watchpoint_p
= 0;
5520 event
->regcache
= NULL
;
5525 case 'T': /* Status with PC, SP, FP, ... */
5526 /* Expedited reply, containing Signal, {regno, reg} repeat. */
5527 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
5529 n... = register number
5530 r... = register contents
5533 p
= &buf
[3]; /* after Txx */
5541 /* If the packet contains a register number, save it in
5542 pnum and set p1 to point to the character following it.
5543 Otherwise p1 points to p. */
5545 /* If this packet is an awatch packet, don't parse the 'a'
5546 as a register number. */
5548 if (strncmp (p
, "awatch", strlen("awatch")) != 0
5549 && strncmp (p
, "core", strlen ("core") != 0))
5551 /* Read the ``P'' register number. */
5552 pnum
= strtol (p
, &p_temp
, 16);
5558 if (p1
== p
) /* No register number present here. */
5560 p1
= strchr (p
, ':');
5562 error (_("Malformed packet(a) (missing colon): %s\n\
5565 if (strncmp (p
, "thread", p1
- p
) == 0)
5566 event
->ptid
= read_ptid (++p1
, &p
);
5567 else if ((strncmp (p
, "watch", p1
- p
) == 0)
5568 || (strncmp (p
, "rwatch", p1
- p
) == 0)
5569 || (strncmp (p
, "awatch", p1
- p
) == 0))
5571 event
->stopped_by_watchpoint_p
= 1;
5572 p
= unpack_varlen_hex (++p1
, &addr
);
5573 event
->watch_data_address
= (CORE_ADDR
) addr
;
5575 else if (strncmp (p
, "library", p1
- p
) == 0)
5579 while (*p_temp
&& *p_temp
!= ';')
5582 event
->ws
.kind
= TARGET_WAITKIND_LOADED
;
5585 else if (strncmp (p
, "replaylog", p1
- p
) == 0)
5587 event
->ws
.kind
= TARGET_WAITKIND_NO_HISTORY
;
5588 /* p1 will indicate "begin" or "end", but it makes
5589 no difference for now, so ignore it. */
5590 p_temp
= strchr (p1
+ 1, ';');
5594 else if (strncmp (p
, "core", p1
- p
) == 0)
5598 p
= unpack_varlen_hex (++p1
, &c
);
5603 /* Silently skip unknown optional info. */
5604 p_temp
= strchr (p1
+ 1, ';');
5611 struct packet_reg
*reg
= packet_reg_from_pnum (rsa
, pnum
);
5612 cached_reg_t cached_reg
;
5617 error (_("Malformed packet(b) (missing colon): %s\n\
5623 error (_("Remote sent bad register number %s: %s\n\
5625 hex_string (pnum
), p
, buf
);
5627 cached_reg
.num
= reg
->regnum
;
5629 fieldsize
= hex2bin (p
, cached_reg
.data
,
5630 register_size (target_gdbarch (),
5633 if (fieldsize
< register_size (target_gdbarch (),
5635 warning (_("Remote reply is too short: %s"), buf
);
5637 VEC_safe_push (cached_reg_t
, event
->regcache
, &cached_reg
);
5641 error (_("Remote register badly formatted: %s\nhere: %s"),
5646 if (event
->ws
.kind
!= TARGET_WAITKIND_IGNORE
)
5650 case 'S': /* Old style status, just signal only. */
5654 event
->ws
.kind
= TARGET_WAITKIND_STOPPED
;
5655 sig
= (fromhex (buf
[1]) << 4) + fromhex (buf
[2]);
5656 if (GDB_SIGNAL_FIRST
<= sig
&& sig
< GDB_SIGNAL_LAST
)
5657 event
->ws
.value
.sig
= (enum gdb_signal
) sig
;
5659 event
->ws
.value
.sig
= GDB_SIGNAL_UNKNOWN
;
5662 case 'W': /* Target exited. */
5669 /* GDB used to accept only 2 hex chars here. Stubs should
5670 only send more if they detect GDB supports multi-process
5672 p
= unpack_varlen_hex (&buf
[1], &value
);
5676 /* The remote process exited. */
5677 event
->ws
.kind
= TARGET_WAITKIND_EXITED
;
5678 event
->ws
.value
.integer
= value
;
5682 /* The remote process exited with a signal. */
5683 event
->ws
.kind
= TARGET_WAITKIND_SIGNALLED
;
5684 if (GDB_SIGNAL_FIRST
<= value
&& value
< GDB_SIGNAL_LAST
)
5685 event
->ws
.value
.sig
= (enum gdb_signal
) value
;
5687 event
->ws
.value
.sig
= GDB_SIGNAL_UNKNOWN
;
5690 /* If no process is specified, assume inferior_ptid. */
5691 pid
= ptid_get_pid (inferior_ptid
);
5700 else if (strncmp (p
,
5701 "process:", sizeof ("process:") - 1) == 0)
5705 p
+= sizeof ("process:") - 1;
5706 unpack_varlen_hex (p
, &upid
);
5710 error (_("unknown stop reply packet: %s"), buf
);
5713 error (_("unknown stop reply packet: %s"), buf
);
5714 event
->ptid
= pid_to_ptid (pid
);
5719 if (non_stop
&& ptid_equal (event
->ptid
, null_ptid
))
5720 error (_("No process or thread specified in stop reply: %s"), buf
);
5723 /* When the stub wants to tell GDB about a new notification reply, it
5724 sends a notification (%Stop, for example). Those can come it at
5725 any time, hence, we have to make sure that any pending
5726 putpkt/getpkt sequence we're making is finished, before querying
5727 the stub for more events with the corresponding ack command
5728 (vStopped, for example). E.g., if we started a vStopped sequence
5729 immediately upon receiving the notification, something like this
5737 1.6) <-- (registers reply to step #1.3)
5739 Obviously, the reply in step #1.6 would be unexpected to a vStopped
5742 To solve this, whenever we parse a %Stop notification successfully,
5743 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
5744 doing whatever we were doing:
5750 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
5751 2.5) <-- (registers reply to step #2.3)
5753 Eventualy after step #2.5, we return to the event loop, which
5754 notices there's an event on the
5755 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
5756 associated callback --- the function below. At this point, we're
5757 always safe to start a vStopped sequence. :
5760 2.7) <-- T05 thread:2
5766 remote_notif_get_pending_events (struct notif_client
*nc
)
5768 struct remote_state
*rs
= get_remote_state ();
5770 if (rs
->notif_state
->pending_event
[nc
->id
] != NULL
)
5773 fprintf_unfiltered (gdb_stdlog
,
5774 "notif: process: '%s' ack pending event\n",
5778 nc
->ack (nc
, rs
->buf
, rs
->notif_state
->pending_event
[nc
->id
]);
5779 rs
->notif_state
->pending_event
[nc
->id
] = NULL
;
5783 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
5784 if (strcmp (rs
->buf
, "OK") == 0)
5787 remote_notif_ack (nc
, rs
->buf
);
5793 fprintf_unfiltered (gdb_stdlog
,
5794 "notif: process: '%s' no pending reply\n",
5799 /* Called when it is decided that STOP_REPLY holds the info of the
5800 event that is to be returned to the core. This function always
5801 destroys STOP_REPLY. */
5804 process_stop_reply (struct stop_reply
*stop_reply
,
5805 struct target_waitstatus
*status
)
5809 *status
= stop_reply
->ws
;
5810 ptid
= stop_reply
->ptid
;
5812 /* If no thread/process was reported by the stub, assume the current
5814 if (ptid_equal (ptid
, null_ptid
))
5815 ptid
= inferior_ptid
;
5817 if (status
->kind
!= TARGET_WAITKIND_EXITED
5818 && status
->kind
!= TARGET_WAITKIND_SIGNALLED
)
5820 struct remote_state
*rs
= get_remote_state ();
5822 /* Expedited registers. */
5823 if (stop_reply
->regcache
)
5825 struct regcache
*regcache
5826 = get_thread_arch_regcache (ptid
, target_gdbarch ());
5831 VEC_iterate(cached_reg_t
, stop_reply
->regcache
, ix
, reg
);
5833 regcache_raw_supply (regcache
, reg
->num
, reg
->data
);
5834 VEC_free (cached_reg_t
, stop_reply
->regcache
);
5837 rs
->remote_stopped_by_watchpoint_p
= stop_reply
->stopped_by_watchpoint_p
;
5838 rs
->remote_watch_data_address
= stop_reply
->watch_data_address
;
5840 remote_notice_new_inferior (ptid
, 0);
5841 demand_private_info (ptid
)->core
= stop_reply
->core
;
5844 stop_reply_xfree (stop_reply
);
5848 /* The non-stop mode version of target_wait. */
5851 remote_wait_ns (ptid_t ptid
, struct target_waitstatus
*status
, int options
)
5853 struct remote_state
*rs
= get_remote_state ();
5854 struct stop_reply
*stop_reply
;
5858 /* If in non-stop mode, get out of getpkt even if a
5859 notification is received. */
5861 ret
= getpkt_or_notif_sane (&rs
->buf
, &rs
->buf_size
,
5862 0 /* forever */, &is_notif
);
5865 if (ret
!= -1 && !is_notif
)
5868 case 'E': /* Error of some sort. */
5869 /* We're out of sync with the target now. Did it continue
5870 or not? We can't tell which thread it was in non-stop,
5871 so just ignore this. */
5872 warning (_("Remote failure reply: %s"), rs
->buf
);
5874 case 'O': /* Console output. */
5875 remote_console_output (rs
->buf
+ 1);
5878 warning (_("Invalid remote reply: %s"), rs
->buf
);
5882 /* Acknowledge a pending stop reply that may have arrived in the
5884 if (rs
->notif_state
->pending_event
[notif_client_stop
.id
] != NULL
)
5885 remote_notif_get_pending_events (¬if_client_stop
);
5887 /* If indeed we noticed a stop reply, we're done. */
5888 stop_reply
= queued_stop_reply (ptid
);
5889 if (stop_reply
!= NULL
)
5890 return process_stop_reply (stop_reply
, status
);
5892 /* Still no event. If we're just polling for an event, then
5893 return to the event loop. */
5894 if (options
& TARGET_WNOHANG
)
5896 status
->kind
= TARGET_WAITKIND_IGNORE
;
5897 return minus_one_ptid
;
5900 /* Otherwise do a blocking wait. */
5901 ret
= getpkt_or_notif_sane (&rs
->buf
, &rs
->buf_size
,
5902 1 /* forever */, &is_notif
);
5906 /* Wait until the remote machine stops, then return, storing status in
5907 STATUS just as `wait' would. */
5910 remote_wait_as (ptid_t ptid
, struct target_waitstatus
*status
, int options
)
5912 struct remote_state
*rs
= get_remote_state ();
5913 ptid_t event_ptid
= null_ptid
;
5915 struct stop_reply
*stop_reply
;
5919 status
->kind
= TARGET_WAITKIND_IGNORE
;
5920 status
->value
.integer
= 0;
5922 stop_reply
= queued_stop_reply (ptid
);
5923 if (stop_reply
!= NULL
)
5924 return process_stop_reply (stop_reply
, status
);
5926 if (rs
->cached_wait_status
)
5927 /* Use the cached wait status, but only once. */
5928 rs
->cached_wait_status
= 0;
5934 if (!target_is_async_p ())
5936 ofunc
= signal (SIGINT
, sync_remote_interrupt
);
5937 /* If the user hit C-c before this packet, or between packets,
5938 pretend that it was hit right here. */
5939 if (check_quit_flag ())
5942 sync_remote_interrupt (SIGINT
);
5946 /* FIXME: cagney/1999-09-27: If we're in async mode we should
5947 _never_ wait for ever -> test on target_is_async_p().
5948 However, before we do that we need to ensure that the caller
5949 knows how to take the target into/out of async mode. */
5950 ret
= getpkt_or_notif_sane (&rs
->buf
, &rs
->buf_size
,
5951 wait_forever_enabled_p
, &is_notif
);
5953 if (!target_is_async_p ())
5954 signal (SIGINT
, ofunc
);
5956 /* GDB gets a notification. Return to core as this event is
5958 if (ret
!= -1 && is_notif
)
5959 return minus_one_ptid
;
5964 rs
->remote_stopped_by_watchpoint_p
= 0;
5966 /* We got something. */
5967 rs
->waiting_for_stop_reply
= 0;
5969 /* Assume that the target has acknowledged Ctrl-C unless we receive
5970 an 'F' or 'O' packet. */
5971 if (buf
[0] != 'F' && buf
[0] != 'O')
5972 rs
->ctrlc_pending_p
= 0;
5976 case 'E': /* Error of some sort. */
5977 /* We're out of sync with the target now. Did it continue or
5978 not? Not is more likely, so report a stop. */
5979 warning (_("Remote failure reply: %s"), buf
);
5980 status
->kind
= TARGET_WAITKIND_STOPPED
;
5981 status
->value
.sig
= GDB_SIGNAL_0
;
5983 case 'F': /* File-I/O request. */
5984 remote_fileio_request (buf
, rs
->ctrlc_pending_p
);
5985 rs
->ctrlc_pending_p
= 0;
5987 case 'T': case 'S': case 'X': case 'W':
5989 struct stop_reply
*stop_reply
5990 = (struct stop_reply
*) remote_notif_parse (¬if_client_stop
,
5993 event_ptid
= process_stop_reply (stop_reply
, status
);
5996 case 'O': /* Console output. */
5997 remote_console_output (buf
+ 1);
5999 /* The target didn't really stop; keep waiting. */
6000 rs
->waiting_for_stop_reply
= 1;
6004 if (rs
->last_sent_signal
!= GDB_SIGNAL_0
)
6006 /* Zero length reply means that we tried 'S' or 'C' and the
6007 remote system doesn't support it. */
6008 target_terminal_ours_for_output ();
6010 ("Can't send signals to this remote system. %s not sent.\n",
6011 gdb_signal_to_name (rs
->last_sent_signal
));
6012 rs
->last_sent_signal
= GDB_SIGNAL_0
;
6013 target_terminal_inferior ();
6015 strcpy ((char *) buf
, rs
->last_sent_step
? "s" : "c");
6016 putpkt ((char *) buf
);
6018 /* We just told the target to resume, so a stop reply is in
6020 rs
->waiting_for_stop_reply
= 1;
6023 /* else fallthrough */
6025 warning (_("Invalid remote reply: %s"), buf
);
6027 rs
->waiting_for_stop_reply
= 1;
6031 if (status
->kind
== TARGET_WAITKIND_IGNORE
)
6033 /* Nothing interesting happened. If we're doing a non-blocking
6034 poll, we're done. Otherwise, go back to waiting. */
6035 if (options
& TARGET_WNOHANG
)
6036 return minus_one_ptid
;
6040 else if (status
->kind
!= TARGET_WAITKIND_EXITED
6041 && status
->kind
!= TARGET_WAITKIND_SIGNALLED
)
6043 if (!ptid_equal (event_ptid
, null_ptid
))
6044 record_currthread (rs
, event_ptid
);
6046 event_ptid
= inferior_ptid
;
6049 /* A process exit. Invalidate our notion of current thread. */
6050 record_currthread (rs
, minus_one_ptid
);
6055 /* Wait until the remote machine stops, then return, storing status in
6056 STATUS just as `wait' would. */
6059 remote_wait (struct target_ops
*ops
,
6060 ptid_t ptid
, struct target_waitstatus
*status
, int options
)
6065 event_ptid
= remote_wait_ns (ptid
, status
, options
);
6067 event_ptid
= remote_wait_as (ptid
, status
, options
);
6069 if (target_can_async_p ())
6071 /* If there are are events left in the queue tell the event loop
6073 if (!QUEUE_is_empty (stop_reply_p
, stop_reply_queue
))
6074 mark_async_event_handler (remote_async_inferior_event_token
);
6080 /* Fetch a single register using a 'p' packet. */
6083 fetch_register_using_p (struct regcache
*regcache
, struct packet_reg
*reg
)
6085 struct remote_state
*rs
= get_remote_state ();
6087 char regp
[MAX_REGISTER_SIZE
];
6090 if (remote_protocol_packets
[PACKET_p
].support
== PACKET_DISABLE
)
6093 if (reg
->pnum
== -1)
6098 p
+= hexnumstr (p
, reg
->pnum
);
6101 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6105 switch (packet_ok (buf
, &remote_protocol_packets
[PACKET_p
]))
6109 case PACKET_UNKNOWN
:
6112 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
6113 gdbarch_register_name (get_regcache_arch (regcache
),
6118 /* If this register is unfetchable, tell the regcache. */
6121 regcache_raw_supply (regcache
, reg
->regnum
, NULL
);
6125 /* Otherwise, parse and supply the value. */
6131 error (_("fetch_register_using_p: early buf termination"));
6133 regp
[i
++] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
6136 regcache_raw_supply (regcache
, reg
->regnum
, regp
);
6140 /* Fetch the registers included in the target's 'g' packet. */
6143 send_g_packet (void)
6145 struct remote_state
*rs
= get_remote_state ();
6148 xsnprintf (rs
->buf
, get_remote_packet_size (), "g");
6149 remote_send (&rs
->buf
, &rs
->buf_size
);
6151 /* We can get out of synch in various cases. If the first character
6152 in the buffer is not a hex character, assume that has happened
6153 and try to fetch another packet to read. */
6154 while ((rs
->buf
[0] < '0' || rs
->buf
[0] > '9')
6155 && (rs
->buf
[0] < 'A' || rs
->buf
[0] > 'F')
6156 && (rs
->buf
[0] < 'a' || rs
->buf
[0] > 'f')
6157 && rs
->buf
[0] != 'x') /* New: unavailable register value. */
6160 fprintf_unfiltered (gdb_stdlog
,
6161 "Bad register packet; fetching a new packet\n");
6162 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6165 buf_len
= strlen (rs
->buf
);
6167 /* Sanity check the received packet. */
6168 if (buf_len
% 2 != 0)
6169 error (_("Remote 'g' packet reply is of odd length: %s"), rs
->buf
);
6175 process_g_packet (struct regcache
*regcache
)
6177 struct gdbarch
*gdbarch
= get_regcache_arch (regcache
);
6178 struct remote_state
*rs
= get_remote_state ();
6179 struct remote_arch_state
*rsa
= get_remote_arch_state ();
6184 buf_len
= strlen (rs
->buf
);
6186 /* Further sanity checks, with knowledge of the architecture. */
6187 if (buf_len
> 2 * rsa
->sizeof_g_packet
)
6188 error (_("Remote 'g' packet reply is too long: %s"), rs
->buf
);
6190 /* Save the size of the packet sent to us by the target. It is used
6191 as a heuristic when determining the max size of packets that the
6192 target can safely receive. */
6193 if (rsa
->actual_register_packet_size
== 0)
6194 rsa
->actual_register_packet_size
= buf_len
;
6196 /* If this is smaller than we guessed the 'g' packet would be,
6197 update our records. A 'g' reply that doesn't include a register's
6198 value implies either that the register is not available, or that
6199 the 'p' packet must be used. */
6200 if (buf_len
< 2 * rsa
->sizeof_g_packet
)
6202 rsa
->sizeof_g_packet
= buf_len
/ 2;
6204 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
6206 if (rsa
->regs
[i
].pnum
== -1)
6209 if (rsa
->regs
[i
].offset
>= rsa
->sizeof_g_packet
)
6210 rsa
->regs
[i
].in_g_packet
= 0;
6212 rsa
->regs
[i
].in_g_packet
= 1;
6216 regs
= alloca (rsa
->sizeof_g_packet
);
6218 /* Unimplemented registers read as all bits zero. */
6219 memset (regs
, 0, rsa
->sizeof_g_packet
);
6221 /* Reply describes registers byte by byte, each byte encoded as two
6222 hex characters. Suck them all up, then supply them to the
6223 register cacheing/storage mechanism. */
6226 for (i
= 0; i
< rsa
->sizeof_g_packet
; i
++)
6228 if (p
[0] == 0 || p
[1] == 0)
6229 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
6230 internal_error (__FILE__
, __LINE__
,
6231 _("unexpected end of 'g' packet reply"));
6233 if (p
[0] == 'x' && p
[1] == 'x')
6234 regs
[i
] = 0; /* 'x' */
6236 regs
[i
] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
6240 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
6242 struct packet_reg
*r
= &rsa
->regs
[i
];
6246 if (r
->offset
* 2 >= strlen (rs
->buf
))
6247 /* This shouldn't happen - we adjusted in_g_packet above. */
6248 internal_error (__FILE__
, __LINE__
,
6249 _("unexpected end of 'g' packet reply"));
6250 else if (rs
->buf
[r
->offset
* 2] == 'x')
6252 gdb_assert (r
->offset
* 2 < strlen (rs
->buf
));
6253 /* The register isn't available, mark it as such (at
6254 the same time setting the value to zero). */
6255 regcache_raw_supply (regcache
, r
->regnum
, NULL
);
6258 regcache_raw_supply (regcache
, r
->regnum
,
6265 fetch_registers_using_g (struct regcache
*regcache
)
6268 process_g_packet (regcache
);
6271 /* Make the remote selected traceframe match GDB's selected
6275 set_remote_traceframe (void)
6278 struct remote_state
*rs
= get_remote_state ();
6280 if (rs
->remote_traceframe_number
== get_traceframe_number ())
6283 /* Avoid recursion, remote_trace_find calls us again. */
6284 rs
->remote_traceframe_number
= get_traceframe_number ();
6286 newnum
= target_trace_find (tfind_number
,
6287 get_traceframe_number (), 0, 0, NULL
);
6289 /* Should not happen. If it does, all bets are off. */
6290 if (newnum
!= get_traceframe_number ())
6291 warning (_("could not set remote traceframe"));
6295 remote_fetch_registers (struct target_ops
*ops
,
6296 struct regcache
*regcache
, int regnum
)
6298 struct remote_arch_state
*rsa
= get_remote_arch_state ();
6301 set_remote_traceframe ();
6302 set_general_thread (inferior_ptid
);
6306 struct packet_reg
*reg
= packet_reg_from_regnum (rsa
, regnum
);
6308 gdb_assert (reg
!= NULL
);
6310 /* If this register might be in the 'g' packet, try that first -
6311 we are likely to read more than one register. If this is the
6312 first 'g' packet, we might be overly optimistic about its
6313 contents, so fall back to 'p'. */
6314 if (reg
->in_g_packet
)
6316 fetch_registers_using_g (regcache
);
6317 if (reg
->in_g_packet
)
6321 if (fetch_register_using_p (regcache
, reg
))
6324 /* This register is not available. */
6325 regcache_raw_supply (regcache
, reg
->regnum
, NULL
);
6330 fetch_registers_using_g (regcache
);
6332 for (i
= 0; i
< gdbarch_num_regs (get_regcache_arch (regcache
)); i
++)
6333 if (!rsa
->regs
[i
].in_g_packet
)
6334 if (!fetch_register_using_p (regcache
, &rsa
->regs
[i
]))
6336 /* This register is not available. */
6337 regcache_raw_supply (regcache
, i
, NULL
);
6341 /* Prepare to store registers. Since we may send them all (using a
6342 'G' request), we have to read out the ones we don't want to change
6346 remote_prepare_to_store (struct target_ops
*self
, struct regcache
*regcache
)
6348 struct remote_arch_state
*rsa
= get_remote_arch_state ();
6350 gdb_byte buf
[MAX_REGISTER_SIZE
];
6352 /* Make sure the entire registers array is valid. */
6353 switch (remote_protocol_packets
[PACKET_P
].support
)
6355 case PACKET_DISABLE
:
6356 case PACKET_SUPPORT_UNKNOWN
:
6357 /* Make sure all the necessary registers are cached. */
6358 for (i
= 0; i
< gdbarch_num_regs (get_regcache_arch (regcache
)); i
++)
6359 if (rsa
->regs
[i
].in_g_packet
)
6360 regcache_raw_read (regcache
, rsa
->regs
[i
].regnum
, buf
);
6367 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
6368 packet was not recognized. */
6371 store_register_using_P (const struct regcache
*regcache
,
6372 struct packet_reg
*reg
)
6374 struct gdbarch
*gdbarch
= get_regcache_arch (regcache
);
6375 struct remote_state
*rs
= get_remote_state ();
6376 /* Try storing a single register. */
6377 char *buf
= rs
->buf
;
6378 gdb_byte regp
[MAX_REGISTER_SIZE
];
6381 if (remote_protocol_packets
[PACKET_P
].support
== PACKET_DISABLE
)
6384 if (reg
->pnum
== -1)
6387 xsnprintf (buf
, get_remote_packet_size (), "P%s=", phex_nz (reg
->pnum
, 0));
6388 p
= buf
+ strlen (buf
);
6389 regcache_raw_collect (regcache
, reg
->regnum
, regp
);
6390 bin2hex (regp
, p
, register_size (gdbarch
, reg
->regnum
));
6392 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6394 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_P
]))
6399 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
6400 gdbarch_register_name (gdbarch
, reg
->regnum
), rs
->buf
);
6401 case PACKET_UNKNOWN
:
6404 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
6408 /* Store register REGNUM, or all registers if REGNUM == -1, from the
6409 contents of the register cache buffer. FIXME: ignores errors. */
6412 store_registers_using_G (const struct regcache
*regcache
)
6414 struct remote_state
*rs
= get_remote_state ();
6415 struct remote_arch_state
*rsa
= get_remote_arch_state ();
6419 /* Extract all the registers in the regcache copying them into a
6424 regs
= alloca (rsa
->sizeof_g_packet
);
6425 memset (regs
, 0, rsa
->sizeof_g_packet
);
6426 for (i
= 0; i
< gdbarch_num_regs (get_regcache_arch (regcache
)); i
++)
6428 struct packet_reg
*r
= &rsa
->regs
[i
];
6431 regcache_raw_collect (regcache
, r
->regnum
, regs
+ r
->offset
);
6435 /* Command describes registers byte by byte,
6436 each byte encoded as two hex characters. */
6439 /* remote_prepare_to_store insures that rsa->sizeof_g_packet gets
6441 bin2hex (regs
, p
, rsa
->sizeof_g_packet
);
6443 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6444 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
6445 error (_("Could not write registers; remote failure reply '%s'"),
6449 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
6450 of the register cache buffer. FIXME: ignores errors. */
6453 remote_store_registers (struct target_ops
*ops
,
6454 struct regcache
*regcache
, int regnum
)
6456 struct remote_arch_state
*rsa
= get_remote_arch_state ();
6459 set_remote_traceframe ();
6460 set_general_thread (inferior_ptid
);
6464 struct packet_reg
*reg
= packet_reg_from_regnum (rsa
, regnum
);
6466 gdb_assert (reg
!= NULL
);
6468 /* Always prefer to store registers using the 'P' packet if
6469 possible; we often change only a small number of registers.
6470 Sometimes we change a larger number; we'd need help from a
6471 higher layer to know to use 'G'. */
6472 if (store_register_using_P (regcache
, reg
))
6475 /* For now, don't complain if we have no way to write the
6476 register. GDB loses track of unavailable registers too
6477 easily. Some day, this may be an error. We don't have
6478 any way to read the register, either... */
6479 if (!reg
->in_g_packet
)
6482 store_registers_using_G (regcache
);
6486 store_registers_using_G (regcache
);
6488 for (i
= 0; i
< gdbarch_num_regs (get_regcache_arch (regcache
)); i
++)
6489 if (!rsa
->regs
[i
].in_g_packet
)
6490 if (!store_register_using_P (regcache
, &rsa
->regs
[i
]))
6491 /* See above for why we do not issue an error here. */
6496 /* Return the number of hex digits in num. */
6499 hexnumlen (ULONGEST num
)
6503 for (i
= 0; num
!= 0; i
++)
6509 /* Set BUF to the minimum number of hex digits representing NUM. */
6512 hexnumstr (char *buf
, ULONGEST num
)
6514 int len
= hexnumlen (num
);
6516 return hexnumnstr (buf
, num
, len
);
6520 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
6523 hexnumnstr (char *buf
, ULONGEST num
, int width
)
6529 for (i
= width
- 1; i
>= 0; i
--)
6531 buf
[i
] = "0123456789abcdef"[(num
& 0xf)];
6538 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
6541 remote_address_masked (CORE_ADDR addr
)
6543 unsigned int address_size
= remote_address_size
;
6545 /* If "remoteaddresssize" was not set, default to target address size. */
6547 address_size
= gdbarch_addr_bit (target_gdbarch ());
6549 if (address_size
> 0
6550 && address_size
< (sizeof (ULONGEST
) * 8))
6552 /* Only create a mask when that mask can safely be constructed
6553 in a ULONGEST variable. */
6556 mask
= (mask
<< address_size
) - 1;
6562 /* Determine whether the remote target supports binary downloading.
6563 This is accomplished by sending a no-op memory write of zero length
6564 to the target at the specified address. It does not suffice to send
6565 the whole packet, since many stubs strip the eighth bit and
6566 subsequently compute a wrong checksum, which causes real havoc with
6569 NOTE: This can still lose if the serial line is not eight-bit
6570 clean. In cases like this, the user should clear "remote
6574 check_binary_download (CORE_ADDR addr
)
6576 struct remote_state
*rs
= get_remote_state ();
6578 switch (remote_protocol_packets
[PACKET_X
].support
)
6580 case PACKET_DISABLE
:
6584 case PACKET_SUPPORT_UNKNOWN
:
6590 p
+= hexnumstr (p
, (ULONGEST
) addr
);
6592 p
+= hexnumstr (p
, (ULONGEST
) 0);
6596 putpkt_binary (rs
->buf
, (int) (p
- rs
->buf
));
6597 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6599 if (rs
->buf
[0] == '\0')
6602 fprintf_unfiltered (gdb_stdlog
,
6603 "binary downloading NOT "
6604 "supported by target\n");
6605 remote_protocol_packets
[PACKET_X
].support
= PACKET_DISABLE
;
6610 fprintf_unfiltered (gdb_stdlog
,
6611 "binary downloading supported by target\n");
6612 remote_protocol_packets
[PACKET_X
].support
= PACKET_ENABLE
;
6619 /* Write memory data directly to the remote machine.
6620 This does not inform the data cache; the data cache uses this.
6621 HEADER is the starting part of the packet.
6622 MEMADDR is the address in the remote memory space.
6623 MYADDR is the address of the buffer in our space.
6624 LEN is the number of bytes.
6625 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
6626 should send data as binary ('X'), or hex-encoded ('M').
6628 The function creates packet of the form
6629 <HEADER><ADDRESS>,<LENGTH>:<DATA>
6631 where encoding of <DATA> is termined by PACKET_FORMAT.
6633 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
6636 Return the transferred status, error or OK (an
6637 'enum target_xfer_status' value). Save the number of bytes
6638 transferred in *XFERED_LEN. Only transfer a single packet. */
6640 static enum target_xfer_status
6641 remote_write_bytes_aux (const char *header
, CORE_ADDR memaddr
,
6642 const gdb_byte
*myaddr
, ULONGEST len
,
6643 ULONGEST
*xfered_len
, char packet_format
,
6646 struct remote_state
*rs
= get_remote_state ();
6656 if (packet_format
!= 'X' && packet_format
!= 'M')
6657 internal_error (__FILE__
, __LINE__
,
6658 _("remote_write_bytes_aux: bad packet format"));
6661 return TARGET_XFER_EOF
;
6663 payload_size
= get_memory_write_packet_size ();
6665 /* The packet buffer will be large enough for the payload;
6666 get_memory_packet_size ensures this. */
6669 /* Compute the size of the actual payload by subtracting out the
6670 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
6672 payload_size
-= strlen ("$,:#NN");
6674 /* The comma won't be used. */
6676 header_length
= strlen (header
);
6677 payload_size
-= header_length
;
6678 payload_size
-= hexnumlen (memaddr
);
6680 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
6682 strcat (rs
->buf
, header
);
6683 p
= rs
->buf
+ strlen (header
);
6685 /* Compute a best guess of the number of bytes actually transfered. */
6686 if (packet_format
== 'X')
6688 /* Best guess at number of bytes that will fit. */
6689 todo
= min (len
, payload_size
);
6691 payload_size
-= hexnumlen (todo
);
6692 todo
= min (todo
, payload_size
);
6696 /* Num bytes that will fit. */
6697 todo
= min (len
, payload_size
/ 2);
6699 payload_size
-= hexnumlen (todo
);
6700 todo
= min (todo
, payload_size
/ 2);
6704 internal_error (__FILE__
, __LINE__
,
6705 _("minimum packet size too small to write data"));
6707 /* If we already need another packet, then try to align the end
6708 of this packet to a useful boundary. */
6709 if (todo
> 2 * REMOTE_ALIGN_WRITES
&& todo
< len
)
6710 todo
= ((memaddr
+ todo
) & ~(REMOTE_ALIGN_WRITES
- 1)) - memaddr
;
6712 /* Append "<memaddr>". */
6713 memaddr
= remote_address_masked (memaddr
);
6714 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
6721 /* Append <len>. Retain the location/size of <len>. It may need to
6722 be adjusted once the packet body has been created. */
6724 plenlen
= hexnumstr (p
, (ULONGEST
) todo
);
6732 /* Append the packet body. */
6733 if (packet_format
== 'X')
6735 /* Binary mode. Send target system values byte by byte, in
6736 increasing byte addresses. Only escape certain critical
6738 payload_length
= remote_escape_output (myaddr
, todo
, (gdb_byte
*) p
,
6739 &nr_bytes
, payload_size
);
6741 /* If not all TODO bytes fit, then we'll need another packet. Make
6742 a second try to keep the end of the packet aligned. Don't do
6743 this if the packet is tiny. */
6744 if (nr_bytes
< todo
&& nr_bytes
> 2 * REMOTE_ALIGN_WRITES
)
6748 new_nr_bytes
= (((memaddr
+ nr_bytes
) & ~(REMOTE_ALIGN_WRITES
- 1))
6750 if (new_nr_bytes
!= nr_bytes
)
6751 payload_length
= remote_escape_output (myaddr
, new_nr_bytes
,
6752 (gdb_byte
*) p
, &nr_bytes
,
6756 p
+= payload_length
;
6757 if (use_length
&& nr_bytes
< todo
)
6759 /* Escape chars have filled up the buffer prematurely,
6760 and we have actually sent fewer bytes than planned.
6761 Fix-up the length field of the packet. Use the same
6762 number of characters as before. */
6763 plen
+= hexnumnstr (plen
, (ULONGEST
) nr_bytes
, plenlen
);
6764 *plen
= ':'; /* overwrite \0 from hexnumnstr() */
6769 /* Normal mode: Send target system values byte by byte, in
6770 increasing byte addresses. Each byte is encoded as a two hex
6772 nr_bytes
= bin2hex (myaddr
, p
, todo
);
6776 putpkt_binary (rs
->buf
, (int) (p
- rs
->buf
));
6777 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6779 if (rs
->buf
[0] == 'E')
6780 return TARGET_XFER_E_IO
;
6782 /* Return NR_BYTES, not TODO, in case escape chars caused us to send
6783 fewer bytes than we'd planned. */
6784 *xfered_len
= (ULONGEST
) nr_bytes
;
6785 return TARGET_XFER_OK
;
6788 /* Write memory data directly to the remote machine.
6789 This does not inform the data cache; the data cache uses this.
6790 MEMADDR is the address in the remote memory space.
6791 MYADDR is the address of the buffer in our space.
6792 LEN is the number of bytes.
6794 Return the transferred status, error or OK (an
6795 'enum target_xfer_status' value). Save the number of bytes
6796 transferred in *XFERED_LEN. Only transfer a single packet. */
6798 static enum target_xfer_status
6799 remote_write_bytes (CORE_ADDR memaddr
, const gdb_byte
*myaddr
, ULONGEST len
,
6800 ULONGEST
*xfered_len
)
6802 char *packet_format
= 0;
6804 /* Check whether the target supports binary download. */
6805 check_binary_download (memaddr
);
6807 switch (remote_protocol_packets
[PACKET_X
].support
)
6810 packet_format
= "X";
6812 case PACKET_DISABLE
:
6813 packet_format
= "M";
6815 case PACKET_SUPPORT_UNKNOWN
:
6816 internal_error (__FILE__
, __LINE__
,
6817 _("remote_write_bytes: bad internal state"));
6819 internal_error (__FILE__
, __LINE__
, _("bad switch"));
6822 return remote_write_bytes_aux (packet_format
,
6823 memaddr
, myaddr
, len
, xfered_len
,
6824 packet_format
[0], 1);
6827 /* Read memory data directly from the remote machine.
6828 This does not use the data cache; the data cache uses this.
6829 MEMADDR is the address in the remote memory space.
6830 MYADDR is the address of the buffer in our space.
6831 LEN is the number of bytes.
6833 Return the transferred status, error or OK (an
6834 'enum target_xfer_status' value). Save the number of bytes
6835 transferred in *XFERED_LEN. */
6837 static enum target_xfer_status
6838 remote_read_bytes (CORE_ADDR memaddr
, gdb_byte
*myaddr
, ULONGEST len
,
6839 ULONGEST
*xfered_len
)
6841 struct remote_state
*rs
= get_remote_state ();
6842 int max_buf_size
; /* Max size of packet output buffer. */
6850 max_buf_size
= get_memory_read_packet_size ();
6851 /* The packet buffer will be large enough for the payload;
6852 get_memory_packet_size ensures this. */
6854 /* Number if bytes that will fit. */
6855 todo
= min (len
, max_buf_size
/ 2);
6857 /* Construct "m"<memaddr>","<len>". */
6858 memaddr
= remote_address_masked (memaddr
);
6861 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
6863 p
+= hexnumstr (p
, (ULONGEST
) todo
);
6866 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6867 if (rs
->buf
[0] == 'E'
6868 && isxdigit (rs
->buf
[1]) && isxdigit (rs
->buf
[2])
6869 && rs
->buf
[3] == '\0')
6870 return TARGET_XFER_E_IO
;
6871 /* Reply describes memory byte by byte, each byte encoded as two hex
6874 i
= hex2bin (p
, myaddr
, todo
);
6875 /* Return what we have. Let higher layers handle partial reads. */
6876 *xfered_len
= (ULONGEST
) i
;
6877 return TARGET_XFER_OK
;
6882 /* Sends a packet with content determined by the printf format string
6883 FORMAT and the remaining arguments, then gets the reply. Returns
6884 whether the packet was a success, a failure, or unknown. */
6886 static enum packet_result
6887 remote_send_printf (const char *format
, ...)
6889 struct remote_state
*rs
= get_remote_state ();
6890 int max_size
= get_remote_packet_size ();
6893 va_start (ap
, format
);
6896 if (vsnprintf (rs
->buf
, max_size
, format
, ap
) >= max_size
)
6897 internal_error (__FILE__
, __LINE__
, _("Too long remote packet."));
6899 if (putpkt (rs
->buf
) < 0)
6900 error (_("Communication problem with target."));
6903 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
6905 return packet_check_result (rs
->buf
);
6909 restore_remote_timeout (void *p
)
6911 int value
= *(int *)p
;
6913 remote_timeout
= value
;
6916 /* Flash writing can take quite some time. We'll set
6917 effectively infinite timeout for flash operations.
6918 In future, we'll need to decide on a better approach. */
6919 static const int remote_flash_timeout
= 1000;
6922 remote_flash_erase (struct target_ops
*ops
,
6923 ULONGEST address
, LONGEST length
)
6925 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
6926 int saved_remote_timeout
= remote_timeout
;
6927 enum packet_result ret
;
6928 struct cleanup
*back_to
= make_cleanup (restore_remote_timeout
,
6929 &saved_remote_timeout
);
6931 remote_timeout
= remote_flash_timeout
;
6933 ret
= remote_send_printf ("vFlashErase:%s,%s",
6934 phex (address
, addr_size
),
6938 case PACKET_UNKNOWN
:
6939 error (_("Remote target does not support flash erase"));
6941 error (_("Error erasing flash with vFlashErase packet"));
6946 do_cleanups (back_to
);
6949 static enum target_xfer_status
6950 remote_flash_write (struct target_ops
*ops
, ULONGEST address
,
6951 ULONGEST length
, ULONGEST
*xfered_len
,
6952 const gdb_byte
*data
)
6954 int saved_remote_timeout
= remote_timeout
;
6955 enum target_xfer_status ret
;
6956 struct cleanup
*back_to
= make_cleanup (restore_remote_timeout
,
6957 &saved_remote_timeout
);
6959 remote_timeout
= remote_flash_timeout
;
6960 ret
= remote_write_bytes_aux ("vFlashWrite:", address
, data
, length
,
6962 do_cleanups (back_to
);
6968 remote_flash_done (struct target_ops
*ops
)
6970 int saved_remote_timeout
= remote_timeout
;
6972 struct cleanup
*back_to
= make_cleanup (restore_remote_timeout
,
6973 &saved_remote_timeout
);
6975 remote_timeout
= remote_flash_timeout
;
6976 ret
= remote_send_printf ("vFlashDone");
6977 do_cleanups (back_to
);
6981 case PACKET_UNKNOWN
:
6982 error (_("Remote target does not support vFlashDone"));
6984 error (_("Error finishing flash operation"));
6991 remote_files_info (struct target_ops
*ignore
)
6993 puts_filtered ("Debugging a target over a serial line.\n");
6996 /* Stuff for dealing with the packets which are part of this protocol.
6997 See comment at top of file for details. */
6999 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
7000 error to higher layers. Called when a serial error is detected.
7001 The exception message is STRING, followed by a colon and a blank,
7002 the system error message for errno at function entry and final dot
7003 for output compatibility with throw_perror_with_name. */
7006 unpush_and_perror (const char *string
)
7008 int saved_errno
= errno
;
7010 remote_unpush_target ();
7011 throw_error (TARGET_CLOSE_ERROR
, "%s: %s.", string
,
7012 safe_strerror (saved_errno
));
7015 /* Read a single character from the remote end. */
7018 readchar (int timeout
)
7021 struct remote_state
*rs
= get_remote_state ();
7023 ch
= serial_readchar (rs
->remote_desc
, timeout
);
7028 switch ((enum serial_rc
) ch
)
7031 remote_unpush_target ();
7032 throw_error (TARGET_CLOSE_ERROR
, _("Remote connection closed"));
7035 unpush_and_perror (_("Remote communication error. "
7036 "Target disconnected."));
7038 case SERIAL_TIMEOUT
:
7044 /* Wrapper for serial_write that closes the target and throws if
7048 remote_serial_write (const char *str
, int len
)
7050 struct remote_state
*rs
= get_remote_state ();
7052 if (serial_write (rs
->remote_desc
, str
, len
))
7054 unpush_and_perror (_("Remote communication error. "
7055 "Target disconnected."));
7059 /* Send the command in *BUF to the remote machine, and read the reply
7060 into *BUF. Report an error if we get an error reply. Resize
7061 *BUF using xrealloc if necessary to hold the result, and update
7065 remote_send (char **buf
,
7069 getpkt (buf
, sizeof_buf
, 0);
7071 if ((*buf
)[0] == 'E')
7072 error (_("Remote failure reply: %s"), *buf
);
7075 /* Return a pointer to an xmalloc'ed string representing an escaped
7076 version of BUF, of len N. E.g. \n is converted to \\n, \t to \\t,
7077 etc. The caller is responsible for releasing the returned
7081 escape_buffer (const char *buf
, int n
)
7083 struct cleanup
*old_chain
;
7084 struct ui_file
*stb
;
7087 stb
= mem_fileopen ();
7088 old_chain
= make_cleanup_ui_file_delete (stb
);
7090 fputstrn_unfiltered (buf
, n
, 0, stb
);
7091 str
= ui_file_xstrdup (stb
, NULL
);
7092 do_cleanups (old_chain
);
7096 /* Display a null-terminated packet on stdout, for debugging, using C
7100 print_packet (char *buf
)
7102 puts_filtered ("\"");
7103 fputstr_filtered (buf
, '"', gdb_stdout
);
7104 puts_filtered ("\"");
7110 return putpkt_binary (buf
, strlen (buf
));
7113 /* Send a packet to the remote machine, with error checking. The data
7114 of the packet is in BUF. The string in BUF can be at most
7115 get_remote_packet_size () - 5 to account for the $, # and checksum,
7116 and for a possible /0 if we are debugging (remote_debug) and want
7117 to print the sent packet as a string. */
7120 putpkt_binary (char *buf
, int cnt
)
7122 struct remote_state
*rs
= get_remote_state ();
7124 unsigned char csum
= 0;
7125 char *buf2
= alloca (cnt
+ 6);
7132 /* Catch cases like trying to read memory or listing threads while
7133 we're waiting for a stop reply. The remote server wouldn't be
7134 ready to handle this request, so we'd hang and timeout. We don't
7135 have to worry about this in synchronous mode, because in that
7136 case it's not possible to issue a command while the target is
7137 running. This is not a problem in non-stop mode, because in that
7138 case, the stub is always ready to process serial input. */
7139 if (!non_stop
&& target_can_async_p () && rs
->waiting_for_stop_reply
)
7140 error (_("Cannot execute this command while the target is running."));
7142 /* We're sending out a new packet. Make sure we don't look at a
7143 stale cached response. */
7144 rs
->cached_wait_status
= 0;
7146 /* Copy the packet into buffer BUF2, encapsulating it
7147 and giving it a checksum. */
7152 for (i
= 0; i
< cnt
; i
++)
7158 *p
++ = tohex ((csum
>> 4) & 0xf);
7159 *p
++ = tohex (csum
& 0xf);
7161 /* Send it over and over until we get a positive ack. */
7165 int started_error_output
= 0;
7169 struct cleanup
*old_chain
;
7173 str
= escape_buffer (buf2
, p
- buf2
);
7174 old_chain
= make_cleanup (xfree
, str
);
7175 fprintf_unfiltered (gdb_stdlog
, "Sending packet: %s...", str
);
7176 gdb_flush (gdb_stdlog
);
7177 do_cleanups (old_chain
);
7179 remote_serial_write (buf2
, p
- buf2
);
7181 /* If this is a no acks version of the remote protocol, send the
7182 packet and move on. */
7186 /* Read until either a timeout occurs (-2) or '+' is read.
7187 Handle any notification that arrives in the mean time. */
7190 ch
= readchar (remote_timeout
);
7198 case SERIAL_TIMEOUT
:
7201 if (started_error_output
)
7203 putchar_unfiltered ('\n');
7204 started_error_output
= 0;
7213 fprintf_unfiltered (gdb_stdlog
, "Ack\n");
7217 fprintf_unfiltered (gdb_stdlog
, "Nak\n");
7219 case SERIAL_TIMEOUT
:
7223 break; /* Retransmit buffer. */
7227 fprintf_unfiltered (gdb_stdlog
,
7228 "Packet instead of Ack, ignoring it\n");
7229 /* It's probably an old response sent because an ACK
7230 was lost. Gobble up the packet and ack it so it
7231 doesn't get retransmitted when we resend this
7234 remote_serial_write ("+", 1);
7235 continue; /* Now, go look for +. */
7242 /* If we got a notification, handle it, and go back to looking
7244 /* We've found the start of a notification. Now
7245 collect the data. */
7246 val
= read_frame (&rs
->buf
, &rs
->buf_size
);
7251 struct cleanup
*old_chain
;
7254 str
= escape_buffer (rs
->buf
, val
);
7255 old_chain
= make_cleanup (xfree
, str
);
7256 fprintf_unfiltered (gdb_stdlog
,
7257 " Notification received: %s\n",
7259 do_cleanups (old_chain
);
7261 handle_notification (rs
->notif_state
, rs
->buf
);
7262 /* We're in sync now, rewait for the ack. */
7269 if (!started_error_output
)
7271 started_error_output
= 1;
7272 fprintf_unfiltered (gdb_stdlog
, "putpkt: Junk: ");
7274 fputc_unfiltered (ch
& 0177, gdb_stdlog
);
7275 fprintf_unfiltered (gdb_stdlog
, "%s", rs
->buf
);
7284 if (!started_error_output
)
7286 started_error_output
= 1;
7287 fprintf_unfiltered (gdb_stdlog
, "putpkt: Junk: ");
7289 fputc_unfiltered (ch
& 0177, gdb_stdlog
);
7293 break; /* Here to retransmit. */
7297 /* This is wrong. If doing a long backtrace, the user should be
7298 able to get out next time we call QUIT, without anything as
7299 violent as interrupt_query. If we want to provide a way out of
7300 here without getting to the next QUIT, it should be based on
7301 hitting ^C twice as in remote_wait. */
7312 /* Come here after finding the start of a frame when we expected an
7313 ack. Do our best to discard the rest of this packet. */
7322 c
= readchar (remote_timeout
);
7325 case SERIAL_TIMEOUT
:
7326 /* Nothing we can do. */
7329 /* Discard the two bytes of checksum and stop. */
7330 c
= readchar (remote_timeout
);
7332 c
= readchar (remote_timeout
);
7335 case '*': /* Run length encoding. */
7336 /* Discard the repeat count. */
7337 c
= readchar (remote_timeout
);
7342 /* A regular character. */
7348 /* Come here after finding the start of the frame. Collect the rest
7349 into *BUF, verifying the checksum, length, and handling run-length
7350 compression. NUL terminate the buffer. If there is not enough room,
7351 expand *BUF using xrealloc.
7353 Returns -1 on error, number of characters in buffer (ignoring the
7354 trailing NULL) on success. (could be extended to return one of the
7355 SERIAL status indications). */
7358 read_frame (char **buf_p
,
7365 struct remote_state
*rs
= get_remote_state ();
7372 c
= readchar (remote_timeout
);
7375 case SERIAL_TIMEOUT
:
7377 fputs_filtered ("Timeout in mid-packet, retrying\n", gdb_stdlog
);
7381 fputs_filtered ("Saw new packet start in middle of old one\n",
7383 return -1; /* Start a new packet, count retries. */
7386 unsigned char pktcsum
;
7392 check_0
= readchar (remote_timeout
);
7394 check_1
= readchar (remote_timeout
);
7396 if (check_0
== SERIAL_TIMEOUT
|| check_1
== SERIAL_TIMEOUT
)
7399 fputs_filtered ("Timeout in checksum, retrying\n",
7403 else if (check_0
< 0 || check_1
< 0)
7406 fputs_filtered ("Communication error in checksum\n",
7411 /* Don't recompute the checksum; with no ack packets we
7412 don't have any way to indicate a packet retransmission
7417 pktcsum
= (fromhex (check_0
) << 4) | fromhex (check_1
);
7418 if (csum
== pktcsum
)
7423 struct cleanup
*old_chain
;
7426 str
= escape_buffer (buf
, bc
);
7427 old_chain
= make_cleanup (xfree
, str
);
7428 fprintf_unfiltered (gdb_stdlog
,
7429 "Bad checksum, sentsum=0x%x, "
7430 "csum=0x%x, buf=%s\n",
7431 pktcsum
, csum
, str
);
7432 do_cleanups (old_chain
);
7434 /* Number of characters in buffer ignoring trailing
7438 case '*': /* Run length encoding. */
7443 c
= readchar (remote_timeout
);
7445 repeat
= c
- ' ' + 3; /* Compute repeat count. */
7447 /* The character before ``*'' is repeated. */
7449 if (repeat
> 0 && repeat
<= 255 && bc
> 0)
7451 if (bc
+ repeat
- 1 >= *sizeof_buf
- 1)
7453 /* Make some more room in the buffer. */
7454 *sizeof_buf
+= repeat
;
7455 *buf_p
= xrealloc (*buf_p
, *sizeof_buf
);
7459 memset (&buf
[bc
], buf
[bc
- 1], repeat
);
7465 printf_filtered (_("Invalid run length encoding: %s\n"), buf
);
7469 if (bc
>= *sizeof_buf
- 1)
7471 /* Make some more room in the buffer. */
7473 *buf_p
= xrealloc (*buf_p
, *sizeof_buf
);
7484 /* Read a packet from the remote machine, with error checking, and
7485 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
7486 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
7487 rather than timing out; this is used (in synchronous mode) to wait
7488 for a target that is is executing user code to stop. */
7489 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
7490 don't have to change all the calls to getpkt to deal with the
7491 return value, because at the moment I don't know what the right
7492 thing to do it for those. */
7500 timed_out
= getpkt_sane (buf
, sizeof_buf
, forever
);
7504 /* Read a packet from the remote machine, with error checking, and
7505 store it in *BUF. Resize *BUF using xrealloc if necessary to hold
7506 the result, and update *SIZEOF_BUF. If FOREVER, wait forever
7507 rather than timing out; this is used (in synchronous mode) to wait
7508 for a target that is is executing user code to stop. If FOREVER ==
7509 0, this function is allowed to time out gracefully and return an
7510 indication of this to the caller. Otherwise return the number of
7511 bytes read. If EXPECTING_NOTIF, consider receiving a notification
7512 enough reason to return to the caller. *IS_NOTIF is an output
7513 boolean that indicates whether *BUF holds a notification or not
7514 (a regular packet). */
7517 getpkt_or_notif_sane_1 (char **buf
, long *sizeof_buf
, int forever
,
7518 int expecting_notif
, int *is_notif
)
7520 struct remote_state
*rs
= get_remote_state ();
7526 /* We're reading a new response. Make sure we don't look at a
7527 previously cached response. */
7528 rs
->cached_wait_status
= 0;
7530 strcpy (*buf
, "timeout");
7533 timeout
= watchdog
> 0 ? watchdog
: -1;
7534 else if (expecting_notif
)
7535 timeout
= 0; /* There should already be a char in the buffer. If
7538 timeout
= remote_timeout
;
7542 /* Process any number of notifications, and then return when
7546 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
7548 for (tries
= 1; tries
<= MAX_TRIES
; tries
++)
7550 /* This can loop forever if the remote side sends us
7551 characters continuously, but if it pauses, we'll get
7552 SERIAL_TIMEOUT from readchar because of timeout. Then
7553 we'll count that as a retry.
7555 Note that even when forever is set, we will only wait
7556 forever prior to the start of a packet. After that, we
7557 expect characters to arrive at a brisk pace. They should
7558 show up within remote_timeout intervals. */
7560 c
= readchar (timeout
);
7561 while (c
!= SERIAL_TIMEOUT
&& c
!= '$' && c
!= '%');
7563 if (c
== SERIAL_TIMEOUT
)
7565 if (expecting_notif
)
7566 return -1; /* Don't complain, it's normal to not get
7567 anything in this case. */
7569 if (forever
) /* Watchdog went off? Kill the target. */
7572 remote_unpush_target ();
7573 throw_error (TARGET_CLOSE_ERROR
,
7574 _("Watchdog timeout has expired. "
7575 "Target detached."));
7578 fputs_filtered ("Timed out.\n", gdb_stdlog
);
7582 /* We've found the start of a packet or notification.
7583 Now collect the data. */
7584 val
= read_frame (buf
, sizeof_buf
);
7589 remote_serial_write ("-", 1);
7592 if (tries
> MAX_TRIES
)
7594 /* We have tried hard enough, and just can't receive the
7595 packet/notification. Give up. */
7596 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
7598 /* Skip the ack char if we're in no-ack mode. */
7599 if (!rs
->noack_mode
)
7600 remote_serial_write ("+", 1);
7604 /* If we got an ordinary packet, return that to our caller. */
7609 struct cleanup
*old_chain
;
7612 str
= escape_buffer (*buf
, val
);
7613 old_chain
= make_cleanup (xfree
, str
);
7614 fprintf_unfiltered (gdb_stdlog
, "Packet received: %s\n", str
);
7615 do_cleanups (old_chain
);
7618 /* Skip the ack char if we're in no-ack mode. */
7619 if (!rs
->noack_mode
)
7620 remote_serial_write ("+", 1);
7621 if (is_notif
!= NULL
)
7626 /* If we got a notification, handle it, and go back to looking
7630 gdb_assert (c
== '%');
7634 struct cleanup
*old_chain
;
7637 str
= escape_buffer (*buf
, val
);
7638 old_chain
= make_cleanup (xfree
, str
);
7639 fprintf_unfiltered (gdb_stdlog
,
7640 " Notification received: %s\n",
7642 do_cleanups (old_chain
);
7644 if (is_notif
!= NULL
)
7647 handle_notification (rs
->notif_state
, *buf
);
7649 /* Notifications require no acknowledgement. */
7651 if (expecting_notif
)
7658 getpkt_sane (char **buf
, long *sizeof_buf
, int forever
)
7660 return getpkt_or_notif_sane_1 (buf
, sizeof_buf
, forever
, 0, NULL
);
7664 getpkt_or_notif_sane (char **buf
, long *sizeof_buf
, int forever
,
7667 return getpkt_or_notif_sane_1 (buf
, sizeof_buf
, forever
, 1,
7673 remote_kill (struct target_ops
*ops
)
7675 volatile struct gdb_exception ex
;
7677 /* Catch errors so the user can quit from gdb even when we
7678 aren't on speaking terms with the remote system. */
7679 TRY_CATCH (ex
, RETURN_MASK_ERROR
)
7685 if (ex
.error
== TARGET_CLOSE_ERROR
)
7687 /* If we got an (EOF) error that caused the target
7688 to go away, then we're done, that's what we wanted.
7689 "k" is susceptible to cause a premature EOF, given
7690 that the remote server isn't actually required to
7691 reply to "k", and it can happen that it doesn't
7692 even get to reply ACK to the "k". */
7696 /* Otherwise, something went wrong. We didn't actually kill
7697 the target. Just propagate the exception, and let the
7698 user or higher layers decide what to do. */
7699 throw_exception (ex
);
7702 /* We've killed the remote end, we get to mourn it. Since this is
7703 target remote, single-process, mourning the inferior also
7704 unpushes remote_ops. */
7705 target_mourn_inferior ();
7709 remote_vkill (int pid
, struct remote_state
*rs
)
7711 if (remote_protocol_packets
[PACKET_vKill
].support
== PACKET_DISABLE
)
7714 /* Tell the remote target to detach. */
7715 xsnprintf (rs
->buf
, get_remote_packet_size (), "vKill;%x", pid
);
7717 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7719 if (packet_ok (rs
->buf
,
7720 &remote_protocol_packets
[PACKET_vKill
]) == PACKET_OK
)
7722 else if (remote_protocol_packets
[PACKET_vKill
].support
== PACKET_DISABLE
)
7729 extended_remote_kill (struct target_ops
*ops
)
7732 int pid
= ptid_get_pid (inferior_ptid
);
7733 struct remote_state
*rs
= get_remote_state ();
7735 res
= remote_vkill (pid
, rs
);
7736 if (res
== -1 && !(rs
->extended
&& remote_multi_process_p (rs
)))
7738 /* Don't try 'k' on a multi-process aware stub -- it has no way
7739 to specify the pid. */
7743 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7744 if (rs
->buf
[0] != 'O' || rs
->buf
[0] != 'K')
7747 /* Don't wait for it to die. I'm not really sure it matters whether
7748 we do or not. For the existing stubs, kill is a noop. */
7754 error (_("Can't kill process"));
7756 target_mourn_inferior ();
7760 remote_mourn (struct target_ops
*ops
)
7762 remote_mourn_1 (ops
);
7765 /* Worker function for remote_mourn. */
7767 remote_mourn_1 (struct target_ops
*target
)
7769 unpush_target (target
);
7771 /* remote_close takes care of doing most of the clean up. */
7772 generic_mourn_inferior ();
7776 extended_remote_mourn_1 (struct target_ops
*target
)
7778 struct remote_state
*rs
= get_remote_state ();
7780 /* In case we got here due to an error, but we're going to stay
7782 rs
->waiting_for_stop_reply
= 0;
7784 /* If the current general thread belonged to the process we just
7785 detached from or has exited, the remote side current general
7786 thread becomes undefined. Considering a case like this:
7788 - We just got here due to a detach.
7789 - The process that we're detaching from happens to immediately
7790 report a global breakpoint being hit in non-stop mode, in the
7791 same thread we had selected before.
7792 - GDB attaches to this process again.
7793 - This event happens to be the next event we handle.
7795 GDB would consider that the current general thread didn't need to
7796 be set on the stub side (with Hg), since for all it knew,
7797 GENERAL_THREAD hadn't changed.
7799 Notice that although in all-stop mode, the remote server always
7800 sets the current thread to the thread reporting the stop event,
7801 that doesn't happen in non-stop mode; in non-stop, the stub *must
7802 not* change the current thread when reporting a breakpoint hit,
7803 due to the decoupling of event reporting and event handling.
7805 To keep things simple, we always invalidate our notion of the
7807 record_currthread (rs
, minus_one_ptid
);
7809 /* Unlike "target remote", we do not want to unpush the target; then
7810 the next time the user says "run", we won't be connected. */
7812 /* Call common code to mark the inferior as not running. */
7813 generic_mourn_inferior ();
7815 if (!have_inferiors ())
7817 if (!remote_multi_process_p (rs
))
7819 /* Check whether the target is running now - some remote stubs
7820 automatically restart after kill. */
7822 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7824 if (rs
->buf
[0] == 'S' || rs
->buf
[0] == 'T')
7826 /* Assume that the target has been restarted. Set
7827 inferior_ptid so that bits of core GDB realizes
7828 there's something here, e.g., so that the user can
7829 say "kill" again. */
7830 inferior_ptid
= magic_null_ptid
;
7837 extended_remote_mourn (struct target_ops
*ops
)
7839 extended_remote_mourn_1 (ops
);
7843 extended_remote_supports_disable_randomization (struct target_ops
*self
)
7845 return (remote_protocol_packets
[PACKET_QDisableRandomization
].support
7850 extended_remote_disable_randomization (int val
)
7852 struct remote_state
*rs
= get_remote_state ();
7855 xsnprintf (rs
->buf
, get_remote_packet_size (), "QDisableRandomization:%x",
7858 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
7860 error (_("Target does not support QDisableRandomization."));
7861 if (strcmp (reply
, "OK") != 0)
7862 error (_("Bogus QDisableRandomization reply from target: %s"), reply
);
7866 extended_remote_run (char *args
)
7868 struct remote_state
*rs
= get_remote_state ();
7871 /* If the user has disabled vRun support, or we have detected that
7872 support is not available, do not try it. */
7873 if (remote_protocol_packets
[PACKET_vRun
].support
== PACKET_DISABLE
)
7876 strcpy (rs
->buf
, "vRun;");
7877 len
= strlen (rs
->buf
);
7879 if (strlen (remote_exec_file
) * 2 + len
>= get_remote_packet_size ())
7880 error (_("Remote file name too long for run packet"));
7881 len
+= 2 * bin2hex ((gdb_byte
*) remote_exec_file
, rs
->buf
+ len
,
7882 strlen (remote_exec_file
));
7884 gdb_assert (args
!= NULL
);
7887 struct cleanup
*back_to
;
7891 argv
= gdb_buildargv (args
);
7892 back_to
= make_cleanup ((void (*) (void *)) freeargv
, argv
);
7893 for (i
= 0; argv
[i
] != NULL
; i
++)
7895 if (strlen (argv
[i
]) * 2 + 1 + len
>= get_remote_packet_size ())
7896 error (_("Argument list too long for run packet"));
7897 rs
->buf
[len
++] = ';';
7898 len
+= 2 * bin2hex ((gdb_byte
*) argv
[i
], rs
->buf
+ len
,
7901 do_cleanups (back_to
);
7904 rs
->buf
[len
++] = '\0';
7907 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
7909 if (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vRun
]) == PACKET_OK
)
7911 /* We have a wait response. All is well. */
7914 else if (remote_protocol_packets
[PACKET_vRun
].support
== PACKET_DISABLE
)
7915 /* It wasn't disabled before, but it is now. */
7919 if (remote_exec_file
[0] == '\0')
7920 error (_("Running the default executable on the remote target failed; "
7921 "try \"set remote exec-file\"?"));
7923 error (_("Running \"%s\" on the remote target failed"),
7928 /* In the extended protocol we want to be able to do things like
7929 "run" and have them basically work as expected. So we need
7930 a special create_inferior function. We support changing the
7931 executable file and the command line arguments, but not the
7935 extended_remote_create_inferior (struct target_ops
*ops
,
7936 char *exec_file
, char *args
,
7937 char **env
, int from_tty
)
7941 struct remote_state
*rs
= get_remote_state ();
7943 /* If running asynchronously, register the target file descriptor
7944 with the event loop. */
7945 if (target_can_async_p ())
7946 target_async (inferior_event_handler
, 0);
7948 /* Disable address space randomization if requested (and supported). */
7949 if (extended_remote_supports_disable_randomization (ops
))
7950 extended_remote_disable_randomization (disable_randomization
);
7952 /* Now restart the remote server. */
7953 run_worked
= extended_remote_run (args
) != -1;
7956 /* vRun was not supported. Fail if we need it to do what the
7958 if (remote_exec_file
[0])
7959 error (_("Remote target does not support \"set remote exec-file\""));
7961 error (_("Remote target does not support \"set args\" or run <ARGS>"));
7963 /* Fall back to "R". */
7964 extended_remote_restart ();
7967 if (!have_inferiors ())
7969 /* Clean up from the last time we ran, before we mark the target
7970 running again. This will mark breakpoints uninserted, and
7971 get_offsets may insert breakpoints. */
7972 init_thread_list ();
7973 init_wait_for_inferior ();
7976 /* vRun's success return is a stop reply. */
7977 stop_reply
= run_worked
? rs
->buf
: NULL
;
7978 add_current_inferior_and_thread (stop_reply
);
7980 /* Get updated offsets, if the stub uses qOffsets. */
7985 /* Given a location's target info BP_TGT and the packet buffer BUF, output
7986 the list of conditions (in agent expression bytecode format), if any, the
7987 target needs to evaluate. The output is placed into the packet buffer
7988 started from BUF and ended at BUF_END. */
7991 remote_add_target_side_condition (struct gdbarch
*gdbarch
,
7992 struct bp_target_info
*bp_tgt
, char *buf
,
7995 struct agent_expr
*aexpr
= NULL
;
7998 char *buf_start
= buf
;
8000 if (VEC_empty (agent_expr_p
, bp_tgt
->conditions
))
8003 buf
+= strlen (buf
);
8004 xsnprintf (buf
, buf_end
- buf
, "%s", ";");
8007 /* Send conditions to the target and free the vector. */
8009 VEC_iterate (agent_expr_p
, bp_tgt
->conditions
, ix
, aexpr
);
8012 xsnprintf (buf
, buf_end
- buf
, "X%x,", aexpr
->len
);
8013 buf
+= strlen (buf
);
8014 for (i
= 0; i
< aexpr
->len
; ++i
)
8015 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
8022 remote_add_target_side_commands (struct gdbarch
*gdbarch
,
8023 struct bp_target_info
*bp_tgt
, char *buf
)
8025 struct agent_expr
*aexpr
= NULL
;
8028 if (VEC_empty (agent_expr_p
, bp_tgt
->tcommands
))
8031 buf
+= strlen (buf
);
8033 sprintf (buf
, ";cmds:%x,", bp_tgt
->persist
);
8034 buf
+= strlen (buf
);
8036 /* Concatenate all the agent expressions that are commands into the
8039 VEC_iterate (agent_expr_p
, bp_tgt
->tcommands
, ix
, aexpr
);
8042 sprintf (buf
, "X%x,", aexpr
->len
);
8043 buf
+= strlen (buf
);
8044 for (i
= 0; i
< aexpr
->len
; ++i
)
8045 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
8050 /* Insert a breakpoint. On targets that have software breakpoint
8051 support, we ask the remote target to do the work; on targets
8052 which don't, we insert a traditional memory breakpoint. */
8055 remote_insert_breakpoint (struct target_ops
*ops
,
8056 struct gdbarch
*gdbarch
,
8057 struct bp_target_info
*bp_tgt
)
8059 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
8060 If it succeeds, then set the support to PACKET_ENABLE. If it
8061 fails, and the user has explicitly requested the Z support then
8062 report an error, otherwise, mark it disabled and go on. */
8064 if (remote_protocol_packets
[PACKET_Z0
].support
!= PACKET_DISABLE
)
8066 CORE_ADDR addr
= bp_tgt
->placed_address
;
8067 struct remote_state
*rs
;
8070 struct condition_list
*cond
= NULL
;
8072 /* Make sure the remote is pointing at the right process, if
8074 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8075 set_general_process ();
8077 gdbarch_remote_breakpoint_from_pc (gdbarch
, &addr
, &bpsize
);
8079 rs
= get_remote_state ();
8081 endbuf
= rs
->buf
+ get_remote_packet_size ();
8086 addr
= (ULONGEST
) remote_address_masked (addr
);
8087 p
+= hexnumstr (p
, addr
);
8088 xsnprintf (p
, endbuf
- p
, ",%d", bpsize
);
8090 if (remote_supports_cond_breakpoints (ops
))
8091 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
8093 if (remote_can_run_breakpoint_commands (ops
))
8094 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
8097 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8099 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
]))
8104 bp_tgt
->placed_address
= addr
;
8105 bp_tgt
->placed_size
= bpsize
;
8107 case PACKET_UNKNOWN
:
8112 /* If this breakpoint has target-side commands but this stub doesn't
8113 support Z0 packets, throw error. */
8114 if (!VEC_empty (agent_expr_p
, bp_tgt
->tcommands
))
8115 throw_error (NOT_SUPPORTED_ERROR
, _("\
8116 Target doesn't support breakpoints that have target side commands."));
8118 return memory_insert_breakpoint (ops
, gdbarch
, bp_tgt
);
8122 remote_remove_breakpoint (struct target_ops
*ops
,
8123 struct gdbarch
*gdbarch
,
8124 struct bp_target_info
*bp_tgt
)
8126 CORE_ADDR addr
= bp_tgt
->placed_address
;
8127 struct remote_state
*rs
= get_remote_state ();
8129 if (remote_protocol_packets
[PACKET_Z0
].support
!= PACKET_DISABLE
)
8132 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
8134 /* Make sure the remote is pointing at the right process, if
8136 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8137 set_general_process ();
8143 addr
= (ULONGEST
) remote_address_masked (bp_tgt
->placed_address
);
8144 p
+= hexnumstr (p
, addr
);
8145 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->placed_size
);
8148 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8150 return (rs
->buf
[0] == 'E');
8153 return memory_remove_breakpoint (ops
, gdbarch
, bp_tgt
);
8157 watchpoint_to_Z_packet (int type
)
8162 return Z_PACKET_WRITE_WP
;
8165 return Z_PACKET_READ_WP
;
8168 return Z_PACKET_ACCESS_WP
;
8171 internal_error (__FILE__
, __LINE__
,
8172 _("hw_bp_to_z: bad watchpoint type %d"), type
);
8177 remote_insert_watchpoint (struct target_ops
*self
,
8178 CORE_ADDR addr
, int len
, int type
,
8179 struct expression
*cond
)
8181 struct remote_state
*rs
= get_remote_state ();
8182 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
8184 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
8186 if (remote_protocol_packets
[PACKET_Z0
+ packet
].support
== PACKET_DISABLE
)
8189 /* Make sure the remote is pointing at the right process, if
8191 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8192 set_general_process ();
8194 xsnprintf (rs
->buf
, endbuf
- rs
->buf
, "Z%x,", packet
);
8195 p
= strchr (rs
->buf
, '\0');
8196 addr
= remote_address_masked (addr
);
8197 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8198 xsnprintf (p
, endbuf
- p
, ",%x", len
);
8201 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8203 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
8207 case PACKET_UNKNOWN
:
8212 internal_error (__FILE__
, __LINE__
,
8213 _("remote_insert_watchpoint: reached end of function"));
8217 remote_watchpoint_addr_within_range (struct target_ops
*target
, CORE_ADDR addr
,
8218 CORE_ADDR start
, int length
)
8220 CORE_ADDR diff
= remote_address_masked (addr
- start
);
8222 return diff
< length
;
8227 remote_remove_watchpoint (struct target_ops
*self
,
8228 CORE_ADDR addr
, int len
, int type
,
8229 struct expression
*cond
)
8231 struct remote_state
*rs
= get_remote_state ();
8232 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
8234 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
8236 if (remote_protocol_packets
[PACKET_Z0
+ packet
].support
== PACKET_DISABLE
)
8239 /* Make sure the remote is pointing at the right process, if
8241 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8242 set_general_process ();
8244 xsnprintf (rs
->buf
, endbuf
- rs
->buf
, "z%x,", packet
);
8245 p
= strchr (rs
->buf
, '\0');
8246 addr
= remote_address_masked (addr
);
8247 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8248 xsnprintf (p
, endbuf
- p
, ",%x", len
);
8250 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8252 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
8255 case PACKET_UNKNOWN
:
8260 internal_error (__FILE__
, __LINE__
,
8261 _("remote_remove_watchpoint: reached end of function"));
8265 int remote_hw_watchpoint_limit
= -1;
8266 int remote_hw_watchpoint_length_limit
= -1;
8267 int remote_hw_breakpoint_limit
= -1;
8270 remote_region_ok_for_hw_watchpoint (struct target_ops
*self
,
8271 CORE_ADDR addr
, int len
)
8273 if (remote_hw_watchpoint_length_limit
== 0)
8275 else if (remote_hw_watchpoint_length_limit
< 0)
8277 else if (len
<= remote_hw_watchpoint_length_limit
)
8284 remote_check_watch_resources (struct target_ops
*self
,
8285 int type
, int cnt
, int ot
)
8287 if (type
== bp_hardware_breakpoint
)
8289 if (remote_hw_breakpoint_limit
== 0)
8291 else if (remote_hw_breakpoint_limit
< 0)
8293 else if (cnt
<= remote_hw_breakpoint_limit
)
8298 if (remote_hw_watchpoint_limit
== 0)
8300 else if (remote_hw_watchpoint_limit
< 0)
8304 else if (cnt
<= remote_hw_watchpoint_limit
)
8311 remote_stopped_by_watchpoint (struct target_ops
*ops
)
8313 struct remote_state
*rs
= get_remote_state ();
8315 return rs
->remote_stopped_by_watchpoint_p
;
8319 remote_stopped_data_address (struct target_ops
*target
, CORE_ADDR
*addr_p
)
8321 struct remote_state
*rs
= get_remote_state ();
8324 if (remote_stopped_by_watchpoint (target
))
8326 *addr_p
= rs
->remote_watch_data_address
;
8335 remote_insert_hw_breakpoint (struct target_ops
*self
, struct gdbarch
*gdbarch
,
8336 struct bp_target_info
*bp_tgt
)
8339 struct remote_state
*rs
;
8343 /* The length field should be set to the size of a breakpoint
8344 instruction, even though we aren't inserting one ourselves. */
8346 gdbarch_remote_breakpoint_from_pc
8347 (gdbarch
, &bp_tgt
->placed_address
, &bp_tgt
->placed_size
);
8349 if (remote_protocol_packets
[PACKET_Z1
].support
== PACKET_DISABLE
)
8352 /* Make sure the remote is pointing at the right process, if
8354 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8355 set_general_process ();
8357 rs
= get_remote_state ();
8359 endbuf
= rs
->buf
+ get_remote_packet_size ();
8365 addr
= remote_address_masked (bp_tgt
->placed_address
);
8366 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8367 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->placed_size
);
8369 if (remote_supports_cond_breakpoints (self
))
8370 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
8372 if (remote_can_run_breakpoint_commands (self
))
8373 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
8376 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8378 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
8381 if (rs
->buf
[1] == '.')
8383 message
= strchr (rs
->buf
+ 2, '.');
8385 error (_("Remote failure reply: %s"), message
+ 1);
8388 case PACKET_UNKNOWN
:
8393 internal_error (__FILE__
, __LINE__
,
8394 _("remote_insert_hw_breakpoint: reached end of function"));
8399 remote_remove_hw_breakpoint (struct target_ops
*self
, struct gdbarch
*gdbarch
,
8400 struct bp_target_info
*bp_tgt
)
8403 struct remote_state
*rs
= get_remote_state ();
8405 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
8407 if (remote_protocol_packets
[PACKET_Z1
].support
== PACKET_DISABLE
)
8410 /* Make sure the remote is pointing at the right process, if
8412 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
8413 set_general_process ();
8419 addr
= remote_address_masked (bp_tgt
->placed_address
);
8420 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8421 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->placed_size
);
8424 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8426 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
8429 case PACKET_UNKNOWN
:
8434 internal_error (__FILE__
, __LINE__
,
8435 _("remote_remove_hw_breakpoint: reached end of function"));
8438 /* Verify memory using the "qCRC:" request. */
8441 remote_verify_memory (struct target_ops
*ops
,
8442 const gdb_byte
*data
, CORE_ADDR lma
, ULONGEST size
)
8444 struct remote_state
*rs
= get_remote_state ();
8445 unsigned long host_crc
, target_crc
;
8448 /* Make sure the remote is pointing at the right process. */
8449 set_general_process ();
8451 /* FIXME: assumes lma can fit into long. */
8452 xsnprintf (rs
->buf
, get_remote_packet_size (), "qCRC:%lx,%lx",
8453 (long) lma
, (long) size
);
8456 /* Be clever; compute the host_crc before waiting for target
8458 host_crc
= xcrc32 (data
, size
, 0xffffffff);
8460 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8461 if (rs
->buf
[0] == 'E')
8464 if (rs
->buf
[0] != 'C')
8465 error (_("remote target does not support this operation"));
8467 for (target_crc
= 0, tmp
= &rs
->buf
[1]; *tmp
; tmp
++)
8468 target_crc
= target_crc
* 16 + fromhex (*tmp
);
8470 return (host_crc
== target_crc
);
8473 /* compare-sections command
8475 With no arguments, compares each loadable section in the exec bfd
8476 with the same memory range on the target, and reports mismatches.
8477 Useful for verifying the image on the target against the exec file. */
8480 compare_sections_command (char *args
, int from_tty
)
8483 struct cleanup
*old_chain
;
8485 const char *sectname
;
8493 error (_("command cannot be used without an exec file"));
8495 /* Make sure the remote is pointing at the right process. */
8496 set_general_process ();
8498 for (s
= exec_bfd
->sections
; s
; s
= s
->next
)
8500 if (!(s
->flags
& SEC_LOAD
))
8501 continue; /* Skip non-loadable section. */
8503 size
= bfd_get_section_size (s
);
8505 continue; /* Skip zero-length section. */
8507 sectname
= bfd_get_section_name (exec_bfd
, s
);
8508 if (args
&& strcmp (args
, sectname
) != 0)
8509 continue; /* Not the section selected by user. */
8511 matched
= 1; /* Do this section. */
8514 sectdata
= xmalloc (size
);
8515 old_chain
= make_cleanup (xfree
, sectdata
);
8516 bfd_get_section_contents (exec_bfd
, s
, sectdata
, 0, size
);
8518 res
= target_verify_memory (sectdata
, lma
, size
);
8521 error (_("target memory fault, section %s, range %s -- %s"), sectname
,
8522 paddress (target_gdbarch (), lma
),
8523 paddress (target_gdbarch (), lma
+ size
));
8525 printf_filtered ("Section %s, range %s -- %s: ", sectname
,
8526 paddress (target_gdbarch (), lma
),
8527 paddress (target_gdbarch (), lma
+ size
));
8529 printf_filtered ("matched.\n");
8532 printf_filtered ("MIS-MATCHED!\n");
8536 do_cleanups (old_chain
);
8539 warning (_("One or more sections of the remote executable does not match\n\
8540 the loaded file\n"));
8541 if (args
&& !matched
)
8542 printf_filtered (_("No loaded section named '%s'.\n"), args
);
8545 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
8546 into remote target. The number of bytes written to the remote
8547 target is returned, or -1 for error. */
8549 static enum target_xfer_status
8550 remote_write_qxfer (struct target_ops
*ops
, const char *object_name
,
8551 const char *annex
, const gdb_byte
*writebuf
,
8552 ULONGEST offset
, LONGEST len
, ULONGEST
*xfered_len
,
8553 struct packet_config
*packet
)
8557 struct remote_state
*rs
= get_remote_state ();
8558 int max_size
= get_memory_write_packet_size ();
8560 if (packet
->support
== PACKET_DISABLE
)
8561 return TARGET_XFER_E_IO
;
8563 /* Insert header. */
8564 i
= snprintf (rs
->buf
, max_size
,
8565 "qXfer:%s:write:%s:%s:",
8566 object_name
, annex
? annex
: "",
8567 phex_nz (offset
, sizeof offset
));
8568 max_size
-= (i
+ 1);
8570 /* Escape as much data as fits into rs->buf. */
8571 buf_len
= remote_escape_output
8572 (writebuf
, len
, (gdb_byte
*) rs
->buf
+ i
, &max_size
, max_size
);
8574 if (putpkt_binary (rs
->buf
, i
+ buf_len
) < 0
8575 || getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0) < 0
8576 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
8577 return TARGET_XFER_E_IO
;
8579 unpack_varlen_hex (rs
->buf
, &n
);
8582 return TARGET_XFER_OK
;
8585 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
8586 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
8587 number of bytes read is returned, or 0 for EOF, or -1 for error.
8588 The number of bytes read may be less than LEN without indicating an
8589 EOF. PACKET is checked and updated to indicate whether the remote
8590 target supports this object. */
8592 static enum target_xfer_status
8593 remote_read_qxfer (struct target_ops
*ops
, const char *object_name
,
8595 gdb_byte
*readbuf
, ULONGEST offset
, LONGEST len
,
8596 ULONGEST
*xfered_len
,
8597 struct packet_config
*packet
)
8599 struct remote_state
*rs
= get_remote_state ();
8600 LONGEST i
, n
, packet_len
;
8602 if (packet
->support
== PACKET_DISABLE
)
8603 return TARGET_XFER_E_IO
;
8605 /* Check whether we've cached an end-of-object packet that matches
8607 if (rs
->finished_object
)
8609 if (strcmp (object_name
, rs
->finished_object
) == 0
8610 && strcmp (annex
? annex
: "", rs
->finished_annex
) == 0
8611 && offset
== rs
->finished_offset
)
8612 return TARGET_XFER_EOF
;
8615 /* Otherwise, we're now reading something different. Discard
8617 xfree (rs
->finished_object
);
8618 xfree (rs
->finished_annex
);
8619 rs
->finished_object
= NULL
;
8620 rs
->finished_annex
= NULL
;
8623 /* Request only enough to fit in a single packet. The actual data
8624 may not, since we don't know how much of it will need to be escaped;
8625 the target is free to respond with slightly less data. We subtract
8626 five to account for the response type and the protocol frame. */
8627 n
= min (get_remote_packet_size () - 5, len
);
8628 snprintf (rs
->buf
, get_remote_packet_size () - 4, "qXfer:%s:read:%s:%s,%s",
8629 object_name
, annex
? annex
: "",
8630 phex_nz (offset
, sizeof offset
),
8631 phex_nz (n
, sizeof n
));
8632 i
= putpkt (rs
->buf
);
8634 return TARGET_XFER_E_IO
;
8637 packet_len
= getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0);
8638 if (packet_len
< 0 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
8639 return TARGET_XFER_E_IO
;
8641 if (rs
->buf
[0] != 'l' && rs
->buf
[0] != 'm')
8642 error (_("Unknown remote qXfer reply: %s"), rs
->buf
);
8644 /* 'm' means there is (or at least might be) more data after this
8645 batch. That does not make sense unless there's at least one byte
8646 of data in this reply. */
8647 if (rs
->buf
[0] == 'm' && packet_len
== 1)
8648 error (_("Remote qXfer reply contained no data."));
8650 /* Got some data. */
8651 i
= remote_unescape_input ((gdb_byte
*) rs
->buf
+ 1,
8652 packet_len
- 1, readbuf
, n
);
8654 /* 'l' is an EOF marker, possibly including a final block of data,
8655 or possibly empty. If we have the final block of a non-empty
8656 object, record this fact to bypass a subsequent partial read. */
8657 if (rs
->buf
[0] == 'l' && offset
+ i
> 0)
8659 rs
->finished_object
= xstrdup (object_name
);
8660 rs
->finished_annex
= xstrdup (annex
? annex
: "");
8661 rs
->finished_offset
= offset
+ i
;
8665 return TARGET_XFER_EOF
;
8669 return TARGET_XFER_OK
;
8673 static enum target_xfer_status
8674 remote_xfer_partial (struct target_ops
*ops
, enum target_object object
,
8675 const char *annex
, gdb_byte
*readbuf
,
8676 const gdb_byte
*writebuf
, ULONGEST offset
, ULONGEST len
,
8677 ULONGEST
*xfered_len
)
8679 struct remote_state
*rs
;
8684 set_remote_traceframe ();
8685 set_general_thread (inferior_ptid
);
8687 rs
= get_remote_state ();
8689 /* Handle memory using the standard memory routines. */
8690 if (object
== TARGET_OBJECT_MEMORY
)
8692 /* If the remote target is connected but not running, we should
8693 pass this request down to a lower stratum (e.g. the executable
8695 if (!target_has_execution
)
8696 return TARGET_XFER_EOF
;
8698 if (writebuf
!= NULL
)
8699 return remote_write_bytes (offset
, writebuf
, len
, xfered_len
);
8701 return remote_read_bytes (offset
, readbuf
, len
, xfered_len
);
8704 /* Handle SPU memory using qxfer packets. */
8705 if (object
== TARGET_OBJECT_SPU
)
8708 return remote_read_qxfer (ops
, "spu", annex
, readbuf
, offset
, len
,
8709 xfered_len
, &remote_protocol_packets
8710 [PACKET_qXfer_spu_read
]);
8712 return remote_write_qxfer (ops
, "spu", annex
, writebuf
, offset
, len
,
8713 xfered_len
, &remote_protocol_packets
8714 [PACKET_qXfer_spu_write
]);
8717 /* Handle extra signal info using qxfer packets. */
8718 if (object
== TARGET_OBJECT_SIGNAL_INFO
)
8721 return remote_read_qxfer (ops
, "siginfo", annex
, readbuf
, offset
, len
,
8722 xfered_len
, &remote_protocol_packets
8723 [PACKET_qXfer_siginfo_read
]);
8725 return remote_write_qxfer (ops
, "siginfo", annex
,
8726 writebuf
, offset
, len
, xfered_len
,
8727 &remote_protocol_packets
8728 [PACKET_qXfer_siginfo_write
]);
8731 if (object
== TARGET_OBJECT_STATIC_TRACE_DATA
)
8734 return remote_read_qxfer (ops
, "statictrace", annex
,
8735 readbuf
, offset
, len
, xfered_len
,
8736 &remote_protocol_packets
8737 [PACKET_qXfer_statictrace_read
]);
8739 return TARGET_XFER_E_IO
;
8742 /* Only handle flash writes. */
8743 if (writebuf
!= NULL
)
8749 case TARGET_OBJECT_FLASH
:
8750 return remote_flash_write (ops
, offset
, len
, xfered_len
,
8754 return TARGET_XFER_E_IO
;
8758 /* Map pre-existing objects onto letters. DO NOT do this for new
8759 objects!!! Instead specify new query packets. */
8762 case TARGET_OBJECT_AVR
:
8766 case TARGET_OBJECT_AUXV
:
8767 gdb_assert (annex
== NULL
);
8768 return remote_read_qxfer (ops
, "auxv", annex
, readbuf
, offset
, len
,
8770 &remote_protocol_packets
[PACKET_qXfer_auxv
]);
8772 case TARGET_OBJECT_AVAILABLE_FEATURES
:
8773 return remote_read_qxfer
8774 (ops
, "features", annex
, readbuf
, offset
, len
, xfered_len
,
8775 &remote_protocol_packets
[PACKET_qXfer_features
]);
8777 case TARGET_OBJECT_LIBRARIES
:
8778 return remote_read_qxfer
8779 (ops
, "libraries", annex
, readbuf
, offset
, len
, xfered_len
,
8780 &remote_protocol_packets
[PACKET_qXfer_libraries
]);
8782 case TARGET_OBJECT_LIBRARIES_SVR4
:
8783 return remote_read_qxfer
8784 (ops
, "libraries-svr4", annex
, readbuf
, offset
, len
, xfered_len
,
8785 &remote_protocol_packets
[PACKET_qXfer_libraries_svr4
]);
8787 case TARGET_OBJECT_MEMORY_MAP
:
8788 gdb_assert (annex
== NULL
);
8789 return remote_read_qxfer (ops
, "memory-map", annex
, readbuf
, offset
, len
,
8791 &remote_protocol_packets
[PACKET_qXfer_memory_map
]);
8793 case TARGET_OBJECT_OSDATA
:
8794 /* Should only get here if we're connected. */
8795 gdb_assert (rs
->remote_desc
);
8796 return remote_read_qxfer
8797 (ops
, "osdata", annex
, readbuf
, offset
, len
, xfered_len
,
8798 &remote_protocol_packets
[PACKET_qXfer_osdata
]);
8800 case TARGET_OBJECT_THREADS
:
8801 gdb_assert (annex
== NULL
);
8802 return remote_read_qxfer (ops
, "threads", annex
, readbuf
, offset
, len
,
8804 &remote_protocol_packets
[PACKET_qXfer_threads
]);
8806 case TARGET_OBJECT_TRACEFRAME_INFO
:
8807 gdb_assert (annex
== NULL
);
8808 return remote_read_qxfer
8809 (ops
, "traceframe-info", annex
, readbuf
, offset
, len
, xfered_len
,
8810 &remote_protocol_packets
[PACKET_qXfer_traceframe_info
]);
8812 case TARGET_OBJECT_FDPIC
:
8813 return remote_read_qxfer (ops
, "fdpic", annex
, readbuf
, offset
, len
,
8815 &remote_protocol_packets
[PACKET_qXfer_fdpic
]);
8817 case TARGET_OBJECT_OPENVMS_UIB
:
8818 return remote_read_qxfer (ops
, "uib", annex
, readbuf
, offset
, len
,
8820 &remote_protocol_packets
[PACKET_qXfer_uib
]);
8822 case TARGET_OBJECT_BTRACE
:
8823 return remote_read_qxfer (ops
, "btrace", annex
, readbuf
, offset
, len
,
8825 &remote_protocol_packets
[PACKET_qXfer_btrace
]);
8828 return TARGET_XFER_E_IO
;
8831 /* Note: a zero OFFSET and LEN can be used to query the minimum
8833 if (offset
== 0 && len
== 0)
8834 return (get_remote_packet_size ());
8835 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
8836 large enough let the caller deal with it. */
8837 if (len
< get_remote_packet_size ())
8838 return TARGET_XFER_E_IO
;
8839 len
= get_remote_packet_size ();
8841 /* Except for querying the minimum buffer size, target must be open. */
8842 if (!rs
->remote_desc
)
8843 error (_("remote query is only available after target open"));
8845 gdb_assert (annex
!= NULL
);
8846 gdb_assert (readbuf
!= NULL
);
8852 /* We used one buffer char for the remote protocol q command and
8853 another for the query type. As the remote protocol encapsulation
8854 uses 4 chars plus one extra in case we are debugging
8855 (remote_debug), we have PBUFZIZ - 7 left to pack the query
8858 while (annex
[i
] && (i
< (get_remote_packet_size () - 8)))
8860 /* Bad caller may have sent forbidden characters. */
8861 gdb_assert (isprint (annex
[i
]) && annex
[i
] != '$' && annex
[i
] != '#');
8866 gdb_assert (annex
[i
] == '\0');
8868 i
= putpkt (rs
->buf
);
8870 return TARGET_XFER_E_IO
;
8872 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
8873 strcpy ((char *) readbuf
, rs
->buf
);
8875 *xfered_len
= strlen ((char *) readbuf
);
8876 return TARGET_XFER_OK
;
8880 remote_search_memory (struct target_ops
* ops
,
8881 CORE_ADDR start_addr
, ULONGEST search_space_len
,
8882 const gdb_byte
*pattern
, ULONGEST pattern_len
,
8883 CORE_ADDR
*found_addrp
)
8885 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
8886 struct remote_state
*rs
= get_remote_state ();
8887 int max_size
= get_memory_write_packet_size ();
8888 struct packet_config
*packet
=
8889 &remote_protocol_packets
[PACKET_qSearch_memory
];
8890 /* Number of packet bytes used to encode the pattern;
8891 this could be more than PATTERN_LEN due to escape characters. */
8892 int escaped_pattern_len
;
8893 /* Amount of pattern that was encodable in the packet. */
8894 int used_pattern_len
;
8897 ULONGEST found_addr
;
8899 /* Don't go to the target if we don't have to.
8900 This is done before checking packet->support to avoid the possibility that
8901 a success for this edge case means the facility works in general. */
8902 if (pattern_len
> search_space_len
)
8904 if (pattern_len
== 0)
8906 *found_addrp
= start_addr
;
8910 /* If we already know the packet isn't supported, fall back to the simple
8911 way of searching memory. */
8913 if (packet
->support
== PACKET_DISABLE
)
8915 /* Target doesn't provided special support, fall back and use the
8916 standard support (copy memory and do the search here). */
8917 return simple_search_memory (ops
, start_addr
, search_space_len
,
8918 pattern
, pattern_len
, found_addrp
);
8921 /* Make sure the remote is pointing at the right process. */
8922 set_general_process ();
8924 /* Insert header. */
8925 i
= snprintf (rs
->buf
, max_size
,
8926 "qSearch:memory:%s;%s;",
8927 phex_nz (start_addr
, addr_size
),
8928 phex_nz (search_space_len
, sizeof (search_space_len
)));
8929 max_size
-= (i
+ 1);
8931 /* Escape as much data as fits into rs->buf. */
8932 escaped_pattern_len
=
8933 remote_escape_output (pattern
, pattern_len
, (gdb_byte
*) rs
->buf
+ i
,
8934 &used_pattern_len
, max_size
);
8936 /* Bail if the pattern is too large. */
8937 if (used_pattern_len
!= pattern_len
)
8938 error (_("Pattern is too large to transmit to remote target."));
8940 if (putpkt_binary (rs
->buf
, i
+ escaped_pattern_len
) < 0
8941 || getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0) < 0
8942 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
8944 /* The request may not have worked because the command is not
8945 supported. If so, fall back to the simple way. */
8946 if (packet
->support
== PACKET_DISABLE
)
8948 return simple_search_memory (ops
, start_addr
, search_space_len
,
8949 pattern
, pattern_len
, found_addrp
);
8954 if (rs
->buf
[0] == '0')
8956 else if (rs
->buf
[0] == '1')
8959 if (rs
->buf
[1] != ',')
8960 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
);
8961 unpack_varlen_hex (rs
->buf
+ 2, &found_addr
);
8962 *found_addrp
= found_addr
;
8965 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
);
8971 remote_rcmd (struct target_ops
*self
, char *command
,
8972 struct ui_file
*outbuf
)
8974 struct remote_state
*rs
= get_remote_state ();
8977 if (!rs
->remote_desc
)
8978 error (_("remote rcmd is only available after target open"));
8980 /* Send a NULL command across as an empty command. */
8981 if (command
== NULL
)
8984 /* The query prefix. */
8985 strcpy (rs
->buf
, "qRcmd,");
8986 p
= strchr (rs
->buf
, '\0');
8988 if ((strlen (rs
->buf
) + strlen (command
) * 2 + 8/*misc*/)
8989 > get_remote_packet_size ())
8990 error (_("\"monitor\" command ``%s'' is too long."), command
);
8992 /* Encode the actual command. */
8993 bin2hex ((gdb_byte
*) command
, p
, strlen (command
));
8995 if (putpkt (rs
->buf
) < 0)
8996 error (_("Communication problem with target."));
8998 /* get/display the response */
9003 /* XXX - see also remote_get_noisy_reply(). */
9004 QUIT
; /* Allow user to bail out with ^C. */
9006 if (getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0) == -1)
9008 /* Timeout. Continue to (try to) read responses.
9009 This is better than stopping with an error, assuming the stub
9010 is still executing the (long) monitor command.
9011 If needed, the user can interrupt gdb using C-c, obtaining
9012 an effect similar to stop on timeout. */
9017 error (_("Target does not support this command."));
9018 if (buf
[0] == 'O' && buf
[1] != 'K')
9020 remote_console_output (buf
+ 1); /* 'O' message from stub. */
9023 if (strcmp (buf
, "OK") == 0)
9025 if (strlen (buf
) == 3 && buf
[0] == 'E'
9026 && isdigit (buf
[1]) && isdigit (buf
[2]))
9028 error (_("Protocol error with Rcmd"));
9030 for (p
= buf
; p
[0] != '\0' && p
[1] != '\0'; p
+= 2)
9032 char c
= (fromhex (p
[0]) << 4) + fromhex (p
[1]);
9034 fputc_unfiltered (c
, outbuf
);
9040 static VEC(mem_region_s
) *
9041 remote_memory_map (struct target_ops
*ops
)
9043 VEC(mem_region_s
) *result
= NULL
;
9044 char *text
= target_read_stralloc (¤t_target
,
9045 TARGET_OBJECT_MEMORY_MAP
, NULL
);
9049 struct cleanup
*back_to
= make_cleanup (xfree
, text
);
9051 result
= parse_memory_map (text
);
9052 do_cleanups (back_to
);
9059 packet_command (char *args
, int from_tty
)
9061 struct remote_state
*rs
= get_remote_state ();
9063 if (!rs
->remote_desc
)
9064 error (_("command can only be used with remote target"));
9067 error (_("remote-packet command requires packet text as argument"));
9069 puts_filtered ("sending: ");
9070 print_packet (args
);
9071 puts_filtered ("\n");
9074 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
9075 puts_filtered ("received: ");
9076 print_packet (rs
->buf
);
9077 puts_filtered ("\n");
9081 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
9083 static void display_thread_info (struct gdb_ext_thread_info
*info
);
9085 static void threadset_test_cmd (char *cmd
, int tty
);
9087 static void threadalive_test (char *cmd
, int tty
);
9089 static void threadlist_test_cmd (char *cmd
, int tty
);
9091 int get_and_display_threadinfo (threadref
*ref
);
9093 static void threadinfo_test_cmd (char *cmd
, int tty
);
9095 static int thread_display_step (threadref
*ref
, void *context
);
9097 static void threadlist_update_test_cmd (char *cmd
, int tty
);
9099 static void init_remote_threadtests (void);
9101 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
9104 threadset_test_cmd (char *cmd
, int tty
)
9106 int sample_thread
= SAMPLE_THREAD
;
9108 printf_filtered (_("Remote threadset test\n"));
9109 set_general_thread (sample_thread
);
9114 threadalive_test (char *cmd
, int tty
)
9116 int sample_thread
= SAMPLE_THREAD
;
9117 int pid
= ptid_get_pid (inferior_ptid
);
9118 ptid_t ptid
= ptid_build (pid
, sample_thread
, 0);
9120 if (remote_thread_alive (ptid
))
9121 printf_filtered ("PASS: Thread alive test\n");
9123 printf_filtered ("FAIL: Thread alive test\n");
9126 void output_threadid (char *title
, threadref
*ref
);
9129 output_threadid (char *title
, threadref
*ref
)
9133 pack_threadid (&hexid
[0], ref
); /* Convert threead id into hex. */
9135 printf_filtered ("%s %s\n", title
, (&hexid
[0]));
9139 threadlist_test_cmd (char *cmd
, int tty
)
9142 threadref nextthread
;
9143 int done
, result_count
;
9144 threadref threadlist
[3];
9146 printf_filtered ("Remote Threadlist test\n");
9147 if (!remote_get_threadlist (startflag
, &nextthread
, 3, &done
,
9148 &result_count
, &threadlist
[0]))
9149 printf_filtered ("FAIL: threadlist test\n");
9152 threadref
*scan
= threadlist
;
9153 threadref
*limit
= scan
+ result_count
;
9155 while (scan
< limit
)
9156 output_threadid (" thread ", scan
++);
9161 display_thread_info (struct gdb_ext_thread_info
*info
)
9163 output_threadid ("Threadid: ", &info
->threadid
);
9164 printf_filtered ("Name: %s\n ", info
->shortname
);
9165 printf_filtered ("State: %s\n", info
->display
);
9166 printf_filtered ("other: %s\n\n", info
->more_display
);
9170 get_and_display_threadinfo (threadref
*ref
)
9174 struct gdb_ext_thread_info threadinfo
;
9176 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
9177 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
9178 if (0 != (result
= remote_get_threadinfo (ref
, set
, &threadinfo
)))
9179 display_thread_info (&threadinfo
);
9184 threadinfo_test_cmd (char *cmd
, int tty
)
9186 int athread
= SAMPLE_THREAD
;
9190 int_to_threadref (&thread
, athread
);
9191 printf_filtered ("Remote Threadinfo test\n");
9192 if (!get_and_display_threadinfo (&thread
))
9193 printf_filtered ("FAIL cannot get thread info\n");
9197 thread_display_step (threadref
*ref
, void *context
)
9199 /* output_threadid(" threadstep ",ref); *//* simple test */
9200 return get_and_display_threadinfo (ref
);
9204 threadlist_update_test_cmd (char *cmd
, int tty
)
9206 printf_filtered ("Remote Threadlist update test\n");
9207 remote_threadlist_iterator (thread_display_step
, 0, CRAZY_MAX_THREADS
);
9211 init_remote_threadtests (void)
9213 add_com ("tlist", class_obscure
, threadlist_test_cmd
,
9214 _("Fetch and print the remote list of "
9215 "thread identifiers, one pkt only"));
9216 add_com ("tinfo", class_obscure
, threadinfo_test_cmd
,
9217 _("Fetch and display info about one thread"));
9218 add_com ("tset", class_obscure
, threadset_test_cmd
,
9219 _("Test setting to a different thread"));
9220 add_com ("tupd", class_obscure
, threadlist_update_test_cmd
,
9221 _("Iterate through updating all remote thread info"));
9222 add_com ("talive", class_obscure
, threadalive_test
,
9223 _(" Remote thread alive test "));
9228 /* Convert a thread ID to a string. Returns the string in a static
9232 remote_pid_to_str (struct target_ops
*ops
, ptid_t ptid
)
9234 static char buf
[64];
9235 struct remote_state
*rs
= get_remote_state ();
9237 if (ptid_equal (ptid
, null_ptid
))
9238 return normal_pid_to_str (ptid
);
9239 else if (ptid_is_pid (ptid
))
9241 /* Printing an inferior target id. */
9243 /* When multi-process extensions are off, there's no way in the
9244 remote protocol to know the remote process id, if there's any
9245 at all. There's one exception --- when we're connected with
9246 target extended-remote, and we manually attached to a process
9247 with "attach PID". We don't record anywhere a flag that
9248 allows us to distinguish that case from the case of
9249 connecting with extended-remote and the stub already being
9250 attached to a process, and reporting yes to qAttached, hence
9251 no smart special casing here. */
9252 if (!remote_multi_process_p (rs
))
9254 xsnprintf (buf
, sizeof buf
, "Remote target");
9258 return normal_pid_to_str (ptid
);
9262 if (ptid_equal (magic_null_ptid
, ptid
))
9263 xsnprintf (buf
, sizeof buf
, "Thread <main>");
9264 else if (rs
->extended
&& remote_multi_process_p (rs
))
9265 xsnprintf (buf
, sizeof buf
, "Thread %d.%ld",
9266 ptid_get_pid (ptid
), ptid_get_lwp (ptid
));
9268 xsnprintf (buf
, sizeof buf
, "Thread %ld",
9269 ptid_get_lwp (ptid
));
9274 /* Get the address of the thread local variable in OBJFILE which is
9275 stored at OFFSET within the thread local storage for thread PTID. */
9278 remote_get_thread_local_address (struct target_ops
*ops
,
9279 ptid_t ptid
, CORE_ADDR lm
, CORE_ADDR offset
)
9281 if (remote_protocol_packets
[PACKET_qGetTLSAddr
].support
!= PACKET_DISABLE
)
9283 struct remote_state
*rs
= get_remote_state ();
9285 char *endp
= rs
->buf
+ get_remote_packet_size ();
9286 enum packet_result result
;
9288 strcpy (p
, "qGetTLSAddr:");
9290 p
= write_ptid (p
, endp
, ptid
);
9292 p
+= hexnumstr (p
, offset
);
9294 p
+= hexnumstr (p
, lm
);
9298 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
9299 result
= packet_ok (rs
->buf
,
9300 &remote_protocol_packets
[PACKET_qGetTLSAddr
]);
9301 if (result
== PACKET_OK
)
9305 unpack_varlen_hex (rs
->buf
, &result
);
9308 else if (result
== PACKET_UNKNOWN
)
9309 throw_error (TLS_GENERIC_ERROR
,
9310 _("Remote target doesn't support qGetTLSAddr packet"));
9312 throw_error (TLS_GENERIC_ERROR
,
9313 _("Remote target failed to process qGetTLSAddr request"));
9316 throw_error (TLS_GENERIC_ERROR
,
9317 _("TLS not supported or disabled on this target"));
9322 /* Provide thread local base, i.e. Thread Information Block address.
9323 Returns 1 if ptid is found and thread_local_base is non zero. */
9326 remote_get_tib_address (struct target_ops
*self
, ptid_t ptid
, CORE_ADDR
*addr
)
9328 if (remote_protocol_packets
[PACKET_qGetTIBAddr
].support
!= PACKET_DISABLE
)
9330 struct remote_state
*rs
= get_remote_state ();
9332 char *endp
= rs
->buf
+ get_remote_packet_size ();
9333 enum packet_result result
;
9335 strcpy (p
, "qGetTIBAddr:");
9337 p
= write_ptid (p
, endp
, ptid
);
9341 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
9342 result
= packet_ok (rs
->buf
,
9343 &remote_protocol_packets
[PACKET_qGetTIBAddr
]);
9344 if (result
== PACKET_OK
)
9348 unpack_varlen_hex (rs
->buf
, &result
);
9350 *addr
= (CORE_ADDR
) result
;
9353 else if (result
== PACKET_UNKNOWN
)
9354 error (_("Remote target doesn't support qGetTIBAddr packet"));
9356 error (_("Remote target failed to process qGetTIBAddr request"));
9359 error (_("qGetTIBAddr not supported or disabled on this target"));
9364 /* Support for inferring a target description based on the current
9365 architecture and the size of a 'g' packet. While the 'g' packet
9366 can have any size (since optional registers can be left off the
9367 end), some sizes are easily recognizable given knowledge of the
9368 approximate architecture. */
9370 struct remote_g_packet_guess
9373 const struct target_desc
*tdesc
;
9375 typedef struct remote_g_packet_guess remote_g_packet_guess_s
;
9376 DEF_VEC_O(remote_g_packet_guess_s
);
9378 struct remote_g_packet_data
9380 VEC(remote_g_packet_guess_s
) *guesses
;
9383 static struct gdbarch_data
*remote_g_packet_data_handle
;
9386 remote_g_packet_data_init (struct obstack
*obstack
)
9388 return OBSTACK_ZALLOC (obstack
, struct remote_g_packet_data
);
9392 register_remote_g_packet_guess (struct gdbarch
*gdbarch
, int bytes
,
9393 const struct target_desc
*tdesc
)
9395 struct remote_g_packet_data
*data
9396 = gdbarch_data (gdbarch
, remote_g_packet_data_handle
);
9397 struct remote_g_packet_guess new_guess
, *guess
;
9400 gdb_assert (tdesc
!= NULL
);
9403 VEC_iterate (remote_g_packet_guess_s
, data
->guesses
, ix
, guess
);
9405 if (guess
->bytes
== bytes
)
9406 internal_error (__FILE__
, __LINE__
,
9407 _("Duplicate g packet description added for size %d"),
9410 new_guess
.bytes
= bytes
;
9411 new_guess
.tdesc
= tdesc
;
9412 VEC_safe_push (remote_g_packet_guess_s
, data
->guesses
, &new_guess
);
9415 /* Return 1 if remote_read_description would do anything on this target
9416 and architecture, 0 otherwise. */
9419 remote_read_description_p (struct target_ops
*target
)
9421 struct remote_g_packet_data
*data
9422 = gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
);
9424 if (!VEC_empty (remote_g_packet_guess_s
, data
->guesses
))
9430 static const struct target_desc
*
9431 remote_read_description (struct target_ops
*target
)
9433 struct remote_g_packet_data
*data
9434 = gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
);
9436 /* Do not try this during initial connection, when we do not know
9437 whether there is a running but stopped thread. */
9438 if (!target_has_execution
|| ptid_equal (inferior_ptid
, null_ptid
))
9439 return target
->beneath
->to_read_description (target
->beneath
);
9441 if (!VEC_empty (remote_g_packet_guess_s
, data
->guesses
))
9443 struct remote_g_packet_guess
*guess
;
9445 int bytes
= send_g_packet ();
9448 VEC_iterate (remote_g_packet_guess_s
, data
->guesses
, ix
, guess
);
9450 if (guess
->bytes
== bytes
)
9451 return guess
->tdesc
;
9453 /* We discard the g packet. A minor optimization would be to
9454 hold on to it, and fill the register cache once we have selected
9455 an architecture, but it's too tricky to do safely. */
9458 return target
->beneath
->to_read_description (target
->beneath
);
9461 /* Remote file transfer support. This is host-initiated I/O, not
9462 target-initiated; for target-initiated, see remote-fileio.c. */
9464 /* If *LEFT is at least the length of STRING, copy STRING to
9465 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9466 decrease *LEFT. Otherwise raise an error. */
9469 remote_buffer_add_string (char **buffer
, int *left
, char *string
)
9471 int len
= strlen (string
);
9474 error (_("Packet too long for target."));
9476 memcpy (*buffer
, string
, len
);
9480 /* NUL-terminate the buffer as a convenience, if there is
9486 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
9487 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9488 decrease *LEFT. Otherwise raise an error. */
9491 remote_buffer_add_bytes (char **buffer
, int *left
, const gdb_byte
*bytes
,
9494 if (2 * len
> *left
)
9495 error (_("Packet too long for target."));
9497 bin2hex (bytes
, *buffer
, len
);
9501 /* NUL-terminate the buffer as a convenience, if there is
9507 /* If *LEFT is large enough, convert VALUE to hex and add it to
9508 *BUFFER, update *BUFFER to point to the new end of the buffer, and
9509 decrease *LEFT. Otherwise raise an error. */
9512 remote_buffer_add_int (char **buffer
, int *left
, ULONGEST value
)
9514 int len
= hexnumlen (value
);
9517 error (_("Packet too long for target."));
9519 hexnumstr (*buffer
, value
);
9523 /* NUL-terminate the buffer as a convenience, if there is
9529 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
9530 value, *REMOTE_ERRNO to the remote error number or zero if none
9531 was included, and *ATTACHMENT to point to the start of the annex
9532 if any. The length of the packet isn't needed here; there may
9533 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
9535 Return 0 if the packet could be parsed, -1 if it could not. If
9536 -1 is returned, the other variables may not be initialized. */
9539 remote_hostio_parse_result (char *buffer
, int *retcode
,
9540 int *remote_errno
, char **attachment
)
9547 if (buffer
[0] != 'F')
9551 *retcode
= strtol (&buffer
[1], &p
, 16);
9552 if (errno
!= 0 || p
== &buffer
[1])
9555 /* Check for ",errno". */
9559 *remote_errno
= strtol (p
+ 1, &p2
, 16);
9560 if (errno
!= 0 || p
+ 1 == p2
)
9565 /* Check for ";attachment". If there is no attachment, the
9566 packet should end here. */
9569 *attachment
= p
+ 1;
9572 else if (*p
== '\0')
9578 /* Send a prepared I/O packet to the target and read its response.
9579 The prepared packet is in the global RS->BUF before this function
9580 is called, and the answer is there when we return.
9582 COMMAND_BYTES is the length of the request to send, which may include
9583 binary data. WHICH_PACKET is the packet configuration to check
9584 before attempting a packet. If an error occurs, *REMOTE_ERRNO
9585 is set to the error number and -1 is returned. Otherwise the value
9586 returned by the function is returned.
9588 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
9589 attachment is expected; an error will be reported if there's a
9590 mismatch. If one is found, *ATTACHMENT will be set to point into
9591 the packet buffer and *ATTACHMENT_LEN will be set to the
9592 attachment's length. */
9595 remote_hostio_send_command (int command_bytes
, int which_packet
,
9596 int *remote_errno
, char **attachment
,
9597 int *attachment_len
)
9599 struct remote_state
*rs
= get_remote_state ();
9600 int ret
, bytes_read
;
9601 char *attachment_tmp
;
9603 if (!rs
->remote_desc
9604 || remote_protocol_packets
[which_packet
].support
== PACKET_DISABLE
)
9606 *remote_errno
= FILEIO_ENOSYS
;
9610 putpkt_binary (rs
->buf
, command_bytes
);
9611 bytes_read
= getpkt_sane (&rs
->buf
, &rs
->buf_size
, 0);
9613 /* If it timed out, something is wrong. Don't try to parse the
9617 *remote_errno
= FILEIO_EINVAL
;
9621 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[which_packet
]))
9624 *remote_errno
= FILEIO_EINVAL
;
9626 case PACKET_UNKNOWN
:
9627 *remote_errno
= FILEIO_ENOSYS
;
9633 if (remote_hostio_parse_result (rs
->buf
, &ret
, remote_errno
,
9636 *remote_errno
= FILEIO_EINVAL
;
9640 /* Make sure we saw an attachment if and only if we expected one. */
9641 if ((attachment_tmp
== NULL
&& attachment
!= NULL
)
9642 || (attachment_tmp
!= NULL
&& attachment
== NULL
))
9644 *remote_errno
= FILEIO_EINVAL
;
9648 /* If an attachment was found, it must point into the packet buffer;
9649 work out how many bytes there were. */
9650 if (attachment_tmp
!= NULL
)
9652 *attachment
= attachment_tmp
;
9653 *attachment_len
= bytes_read
- (*attachment
- rs
->buf
);
9659 /* Open FILENAME on the remote target, using FLAGS and MODE. Return a
9660 remote file descriptor, or -1 if an error occurs (and set
9664 remote_hostio_open (struct target_ops
*self
,
9665 const char *filename
, int flags
, int mode
,
9668 struct remote_state
*rs
= get_remote_state ();
9670 int left
= get_remote_packet_size () - 1;
9672 remote_buffer_add_string (&p
, &left
, "vFile:open:");
9674 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
9676 remote_buffer_add_string (&p
, &left
, ",");
9678 remote_buffer_add_int (&p
, &left
, flags
);
9679 remote_buffer_add_string (&p
, &left
, ",");
9681 remote_buffer_add_int (&p
, &left
, mode
);
9683 return remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_open
,
9684 remote_errno
, NULL
, NULL
);
9687 /* Write up to LEN bytes from WRITE_BUF to FD on the remote target.
9688 Return the number of bytes written, or -1 if an error occurs (and
9689 set *REMOTE_ERRNO). */
9692 remote_hostio_pwrite (struct target_ops
*self
,
9693 int fd
, const gdb_byte
*write_buf
, int len
,
9694 ULONGEST offset
, int *remote_errno
)
9696 struct remote_state
*rs
= get_remote_state ();
9698 int left
= get_remote_packet_size ();
9701 remote_buffer_add_string (&p
, &left
, "vFile:pwrite:");
9703 remote_buffer_add_int (&p
, &left
, fd
);
9704 remote_buffer_add_string (&p
, &left
, ",");
9706 remote_buffer_add_int (&p
, &left
, offset
);
9707 remote_buffer_add_string (&p
, &left
, ",");
9709 p
+= remote_escape_output (write_buf
, len
, (gdb_byte
*) p
, &out_len
,
9710 get_remote_packet_size () - (p
- rs
->buf
));
9712 return remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_pwrite
,
9713 remote_errno
, NULL
, NULL
);
9716 /* Read up to LEN bytes FD on the remote target into READ_BUF
9717 Return the number of bytes read, or -1 if an error occurs (and
9718 set *REMOTE_ERRNO). */
9721 remote_hostio_pread (struct target_ops
*self
,
9722 int fd
, gdb_byte
*read_buf
, int len
,
9723 ULONGEST offset
, int *remote_errno
)
9725 struct remote_state
*rs
= get_remote_state ();
9728 int left
= get_remote_packet_size ();
9729 int ret
, attachment_len
;
9732 remote_buffer_add_string (&p
, &left
, "vFile:pread:");
9734 remote_buffer_add_int (&p
, &left
, fd
);
9735 remote_buffer_add_string (&p
, &left
, ",");
9737 remote_buffer_add_int (&p
, &left
, len
);
9738 remote_buffer_add_string (&p
, &left
, ",");
9740 remote_buffer_add_int (&p
, &left
, offset
);
9742 ret
= remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_pread
,
9743 remote_errno
, &attachment
,
9749 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
9751 if (read_len
!= ret
)
9752 error (_("Read returned %d, but %d bytes."), ret
, (int) read_len
);
9757 /* Close FD on the remote target. Return 0, or -1 if an error occurs
9758 (and set *REMOTE_ERRNO). */
9761 remote_hostio_close (struct target_ops
*self
, int fd
, int *remote_errno
)
9763 struct remote_state
*rs
= get_remote_state ();
9765 int left
= get_remote_packet_size () - 1;
9767 remote_buffer_add_string (&p
, &left
, "vFile:close:");
9769 remote_buffer_add_int (&p
, &left
, fd
);
9771 return remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_close
,
9772 remote_errno
, NULL
, NULL
);
9775 /* Unlink FILENAME on the remote target. Return 0, or -1 if an error
9776 occurs (and set *REMOTE_ERRNO). */
9779 remote_hostio_unlink (struct target_ops
*self
,
9780 const char *filename
, int *remote_errno
)
9782 struct remote_state
*rs
= get_remote_state ();
9784 int left
= get_remote_packet_size () - 1;
9786 remote_buffer_add_string (&p
, &left
, "vFile:unlink:");
9788 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
9791 return remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_unlink
,
9792 remote_errno
, NULL
, NULL
);
9795 /* Read value of symbolic link FILENAME on the remote target. Return
9796 a null-terminated string allocated via xmalloc, or NULL if an error
9797 occurs (and set *REMOTE_ERRNO). */
9800 remote_hostio_readlink (struct target_ops
*self
,
9801 const char *filename
, int *remote_errno
)
9803 struct remote_state
*rs
= get_remote_state ();
9806 int left
= get_remote_packet_size ();
9807 int len
, attachment_len
;
9811 remote_buffer_add_string (&p
, &left
, "vFile:readlink:");
9813 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
9816 len
= remote_hostio_send_command (p
- rs
->buf
, PACKET_vFile_readlink
,
9817 remote_errno
, &attachment
,
9823 ret
= xmalloc (len
+ 1);
9825 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
9826 (gdb_byte
*) ret
, len
);
9827 if (read_len
!= len
)
9828 error (_("Readlink returned %d, but %d bytes."), len
, read_len
);
9835 remote_fileio_errno_to_host (int errnum
)
9859 case FILEIO_ENOTDIR
:
9879 case FILEIO_ENAMETOOLONG
:
9880 return ENAMETOOLONG
;
9886 remote_hostio_error (int errnum
)
9888 int host_error
= remote_fileio_errno_to_host (errnum
);
9890 if (host_error
== -1)
9891 error (_("Unknown remote I/O error %d"), errnum
);
9893 error (_("Remote I/O error: %s"), safe_strerror (host_error
));
9897 remote_hostio_close_cleanup (void *opaque
)
9899 int fd
= *(int *) opaque
;
9902 remote_hostio_close (find_target_at (process_stratum
), fd
, &remote_errno
);
9907 remote_bfd_iovec_open (struct bfd
*abfd
, void *open_closure
)
9909 const char *filename
= bfd_get_filename (abfd
);
9910 int fd
, remote_errno
;
9913 gdb_assert (remote_filename_p (filename
));
9915 fd
= remote_hostio_open (find_target_at (process_stratum
),
9916 filename
+ 7, FILEIO_O_RDONLY
, 0, &remote_errno
);
9919 errno
= remote_fileio_errno_to_host (remote_errno
);
9920 bfd_set_error (bfd_error_system_call
);
9924 stream
= xmalloc (sizeof (int));
9930 remote_bfd_iovec_close (struct bfd
*abfd
, void *stream
)
9932 int fd
= *(int *)stream
;
9937 /* Ignore errors on close; these may happen if the remote
9938 connection was already torn down. */
9939 remote_hostio_close (find_target_at (process_stratum
), fd
, &remote_errno
);
9941 /* Zero means success. */
9946 remote_bfd_iovec_pread (struct bfd
*abfd
, void *stream
, void *buf
,
9947 file_ptr nbytes
, file_ptr offset
)
9949 int fd
= *(int *)stream
;
9951 file_ptr pos
, bytes
;
9954 while (nbytes
> pos
)
9956 bytes
= remote_hostio_pread (find_target_at (process_stratum
),
9957 fd
, (gdb_byte
*) buf
+ pos
, nbytes
- pos
,
9958 offset
+ pos
, &remote_errno
);
9960 /* Success, but no bytes, means end-of-file. */
9964 errno
= remote_fileio_errno_to_host (remote_errno
);
9965 bfd_set_error (bfd_error_system_call
);
9976 remote_bfd_iovec_stat (struct bfd
*abfd
, void *stream
, struct stat
*sb
)
9978 /* FIXME: We should probably implement remote_hostio_stat. */
9979 sb
->st_size
= INT_MAX
;
9984 remote_filename_p (const char *filename
)
9986 return strncmp (filename
,
9987 REMOTE_SYSROOT_PREFIX
,
9988 sizeof (REMOTE_SYSROOT_PREFIX
) - 1) == 0;
9992 remote_bfd_open (const char *remote_file
, const char *target
)
9994 bfd
*abfd
= gdb_bfd_openr_iovec (remote_file
, target
,
9995 remote_bfd_iovec_open
, NULL
,
9996 remote_bfd_iovec_pread
,
9997 remote_bfd_iovec_close
,
9998 remote_bfd_iovec_stat
);
10004 remote_file_put (const char *local_file
, const char *remote_file
, int from_tty
)
10006 struct cleanup
*back_to
, *close_cleanup
;
10007 int retcode
, fd
, remote_errno
, bytes
, io_size
;
10010 int bytes_in_buffer
;
10013 struct remote_state
*rs
= get_remote_state ();
10015 if (!rs
->remote_desc
)
10016 error (_("command can only be used with remote target"));
10018 file
= gdb_fopen_cloexec (local_file
, "rb");
10020 perror_with_name (local_file
);
10021 back_to
= make_cleanup_fclose (file
);
10023 fd
= remote_hostio_open (find_target_at (process_stratum
),
10024 remote_file
, (FILEIO_O_WRONLY
| FILEIO_O_CREAT
10026 0700, &remote_errno
);
10028 remote_hostio_error (remote_errno
);
10030 /* Send up to this many bytes at once. They won't all fit in the
10031 remote packet limit, so we'll transfer slightly fewer. */
10032 io_size
= get_remote_packet_size ();
10033 buffer
= xmalloc (io_size
);
10034 make_cleanup (xfree
, buffer
);
10036 close_cleanup
= make_cleanup (remote_hostio_close_cleanup
, &fd
);
10038 bytes_in_buffer
= 0;
10041 while (bytes_in_buffer
|| !saw_eof
)
10045 bytes
= fread (buffer
+ bytes_in_buffer
, 1,
10046 io_size
- bytes_in_buffer
,
10051 error (_("Error reading %s."), local_file
);
10054 /* EOF. Unless there is something still in the
10055 buffer from the last iteration, we are done. */
10057 if (bytes_in_buffer
== 0)
10065 bytes
+= bytes_in_buffer
;
10066 bytes_in_buffer
= 0;
10068 retcode
= remote_hostio_pwrite (find_target_at (process_stratum
),
10070 offset
, &remote_errno
);
10073 remote_hostio_error (remote_errno
);
10074 else if (retcode
== 0)
10075 error (_("Remote write of %d bytes returned 0!"), bytes
);
10076 else if (retcode
< bytes
)
10078 /* Short write. Save the rest of the read data for the next
10080 bytes_in_buffer
= bytes
- retcode
;
10081 memmove (buffer
, buffer
+ retcode
, bytes_in_buffer
);
10087 discard_cleanups (close_cleanup
);
10088 if (remote_hostio_close (find_target_at (process_stratum
), fd
, &remote_errno
))
10089 remote_hostio_error (remote_errno
);
10092 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file
);
10093 do_cleanups (back_to
);
10097 remote_file_get (const char *remote_file
, const char *local_file
, int from_tty
)
10099 struct cleanup
*back_to
, *close_cleanup
;
10100 int fd
, remote_errno
, bytes
, io_size
;
10104 struct remote_state
*rs
= get_remote_state ();
10106 if (!rs
->remote_desc
)
10107 error (_("command can only be used with remote target"));
10109 fd
= remote_hostio_open (find_target_at (process_stratum
),
10110 remote_file
, FILEIO_O_RDONLY
, 0, &remote_errno
);
10112 remote_hostio_error (remote_errno
);
10114 file
= gdb_fopen_cloexec (local_file
, "wb");
10116 perror_with_name (local_file
);
10117 back_to
= make_cleanup_fclose (file
);
10119 /* Send up to this many bytes at once. They won't all fit in the
10120 remote packet limit, so we'll transfer slightly fewer. */
10121 io_size
= get_remote_packet_size ();
10122 buffer
= xmalloc (io_size
);
10123 make_cleanup (xfree
, buffer
);
10125 close_cleanup
= make_cleanup (remote_hostio_close_cleanup
, &fd
);
10130 bytes
= remote_hostio_pread (find_target_at (process_stratum
),
10131 fd
, buffer
, io_size
, offset
, &remote_errno
);
10133 /* Success, but no bytes, means end-of-file. */
10136 remote_hostio_error (remote_errno
);
10140 bytes
= fwrite (buffer
, 1, bytes
, file
);
10142 perror_with_name (local_file
);
10145 discard_cleanups (close_cleanup
);
10146 if (remote_hostio_close (find_target_at (process_stratum
), fd
, &remote_errno
))
10147 remote_hostio_error (remote_errno
);
10150 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file
);
10151 do_cleanups (back_to
);
10155 remote_file_delete (const char *remote_file
, int from_tty
)
10157 int retcode
, remote_errno
;
10158 struct remote_state
*rs
= get_remote_state ();
10160 if (!rs
->remote_desc
)
10161 error (_("command can only be used with remote target"));
10163 retcode
= remote_hostio_unlink (find_target_at (process_stratum
),
10164 remote_file
, &remote_errno
);
10166 remote_hostio_error (remote_errno
);
10169 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file
);
10173 remote_put_command (char *args
, int from_tty
)
10175 struct cleanup
*back_to
;
10179 error_no_arg (_("file to put"));
10181 argv
= gdb_buildargv (args
);
10182 back_to
= make_cleanup_freeargv (argv
);
10183 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
10184 error (_("Invalid parameters to remote put"));
10186 remote_file_put (argv
[0], argv
[1], from_tty
);
10188 do_cleanups (back_to
);
10192 remote_get_command (char *args
, int from_tty
)
10194 struct cleanup
*back_to
;
10198 error_no_arg (_("file to get"));
10200 argv
= gdb_buildargv (args
);
10201 back_to
= make_cleanup_freeargv (argv
);
10202 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
10203 error (_("Invalid parameters to remote get"));
10205 remote_file_get (argv
[0], argv
[1], from_tty
);
10207 do_cleanups (back_to
);
10211 remote_delete_command (char *args
, int from_tty
)
10213 struct cleanup
*back_to
;
10217 error_no_arg (_("file to delete"));
10219 argv
= gdb_buildargv (args
);
10220 back_to
= make_cleanup_freeargv (argv
);
10221 if (argv
[0] == NULL
|| argv
[1] != NULL
)
10222 error (_("Invalid parameters to remote delete"));
10224 remote_file_delete (argv
[0], from_tty
);
10226 do_cleanups (back_to
);
10230 remote_command (char *args
, int from_tty
)
10232 help_list (remote_cmdlist
, "remote ", -1, gdb_stdout
);
10236 remote_can_execute_reverse (struct target_ops
*self
)
10238 if (remote_protocol_packets
[PACKET_bs
].support
== PACKET_ENABLE
10239 || remote_protocol_packets
[PACKET_bc
].support
== PACKET_ENABLE
)
10246 remote_supports_non_stop (struct target_ops
*self
)
10252 remote_supports_disable_randomization (struct target_ops
*self
)
10254 /* Only supported in extended mode. */
10259 remote_supports_multi_process (struct target_ops
*self
)
10261 struct remote_state
*rs
= get_remote_state ();
10263 /* Only extended-remote handles being attached to multiple
10264 processes, even though plain remote can use the multi-process
10265 thread id extensions, so that GDB knows the target process's
10267 return rs
->extended
&& remote_multi_process_p (rs
);
10271 remote_supports_cond_tracepoints (void)
10273 struct remote_state
*rs
= get_remote_state ();
10275 return rs
->cond_tracepoints
;
10279 remote_supports_cond_breakpoints (struct target_ops
*self
)
10281 struct remote_state
*rs
= get_remote_state ();
10283 return rs
->cond_breakpoints
;
10287 remote_supports_fast_tracepoints (void)
10289 struct remote_state
*rs
= get_remote_state ();
10291 return rs
->fast_tracepoints
;
10295 remote_supports_static_tracepoints (void)
10297 struct remote_state
*rs
= get_remote_state ();
10299 return rs
->static_tracepoints
;
10303 remote_supports_install_in_trace (void)
10305 struct remote_state
*rs
= get_remote_state ();
10307 return rs
->install_in_trace
;
10311 remote_supports_enable_disable_tracepoint (struct target_ops
*self
)
10313 struct remote_state
*rs
= get_remote_state ();
10315 return rs
->enable_disable_tracepoints
;
10319 remote_supports_string_tracing (struct target_ops
*self
)
10321 struct remote_state
*rs
= get_remote_state ();
10323 return rs
->string_tracing
;
10327 remote_can_run_breakpoint_commands (struct target_ops
*self
)
10329 struct remote_state
*rs
= get_remote_state ();
10331 return rs
->breakpoint_commands
;
10335 remote_trace_init (struct target_ops
*self
)
10338 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10339 if (strcmp (target_buf
, "OK") != 0)
10340 error (_("Target does not support this command."));
10343 static void free_actions_list (char **actions_list
);
10344 static void free_actions_list_cleanup_wrapper (void *);
10346 free_actions_list_cleanup_wrapper (void *al
)
10348 free_actions_list (al
);
10352 free_actions_list (char **actions_list
)
10356 if (actions_list
== 0)
10359 for (ndx
= 0; actions_list
[ndx
]; ndx
++)
10360 xfree (actions_list
[ndx
]);
10362 xfree (actions_list
);
10365 /* Recursive routine to walk through command list including loops, and
10366 download packets for each command. */
10369 remote_download_command_source (int num
, ULONGEST addr
,
10370 struct command_line
*cmds
)
10372 struct remote_state
*rs
= get_remote_state ();
10373 struct command_line
*cmd
;
10375 for (cmd
= cmds
; cmd
; cmd
= cmd
->next
)
10377 QUIT
; /* Allow user to bail out with ^C. */
10378 strcpy (rs
->buf
, "QTDPsrc:");
10379 encode_source_string (num
, addr
, "cmd", cmd
->line
,
10380 rs
->buf
+ strlen (rs
->buf
),
10381 rs
->buf_size
- strlen (rs
->buf
));
10383 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10384 if (strcmp (target_buf
, "OK"))
10385 warning (_("Target does not support source download."));
10387 if (cmd
->control_type
== while_control
10388 || cmd
->control_type
== while_stepping_control
)
10390 remote_download_command_source (num
, addr
, *cmd
->body_list
);
10392 QUIT
; /* Allow user to bail out with ^C. */
10393 strcpy (rs
->buf
, "QTDPsrc:");
10394 encode_source_string (num
, addr
, "cmd", "end",
10395 rs
->buf
+ strlen (rs
->buf
),
10396 rs
->buf_size
- strlen (rs
->buf
));
10398 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10399 if (strcmp (target_buf
, "OK"))
10400 warning (_("Target does not support source download."));
10406 remote_download_tracepoint (struct target_ops
*self
, struct bp_location
*loc
)
10408 #define BUF_SIZE 2048
10412 char buf
[BUF_SIZE
];
10413 char **tdp_actions
;
10414 char **stepping_actions
;
10416 struct cleanup
*old_chain
= NULL
;
10417 struct agent_expr
*aexpr
;
10418 struct cleanup
*aexpr_chain
= NULL
;
10420 struct breakpoint
*b
= loc
->owner
;
10421 struct tracepoint
*t
= (struct tracepoint
*) b
;
10423 encode_actions_rsp (loc
, &tdp_actions
, &stepping_actions
);
10424 old_chain
= make_cleanup (free_actions_list_cleanup_wrapper
,
10426 (void) make_cleanup (free_actions_list_cleanup_wrapper
,
10429 tpaddr
= loc
->address
;
10430 sprintf_vma (addrbuf
, tpaddr
);
10431 xsnprintf (buf
, BUF_SIZE
, "QTDP:%x:%s:%c:%lx:%x", b
->number
,
10432 addrbuf
, /* address */
10433 (b
->enable_state
== bp_enabled
? 'E' : 'D'),
10434 t
->step_count
, t
->pass_count
);
10435 /* Fast tracepoints are mostly handled by the target, but we can
10436 tell the target how big of an instruction block should be moved
10438 if (b
->type
== bp_fast_tracepoint
)
10440 /* Only test for support at download time; we may not know
10441 target capabilities at definition time. */
10442 if (remote_supports_fast_tracepoints ())
10446 if (gdbarch_fast_tracepoint_valid_at (target_gdbarch (),
10447 tpaddr
, &isize
, NULL
))
10448 xsnprintf (buf
+ strlen (buf
), BUF_SIZE
- strlen (buf
), ":F%x",
10451 /* If it passed validation at definition but fails now,
10452 something is very wrong. */
10453 internal_error (__FILE__
, __LINE__
,
10454 _("Fast tracepoint not "
10455 "valid during download"));
10458 /* Fast tracepoints are functionally identical to regular
10459 tracepoints, so don't take lack of support as a reason to
10460 give up on the trace run. */
10461 warning (_("Target does not support fast tracepoints, "
10462 "downloading %d as regular tracepoint"), b
->number
);
10464 else if (b
->type
== bp_static_tracepoint
)
10466 /* Only test for support at download time; we may not know
10467 target capabilities at definition time. */
10468 if (remote_supports_static_tracepoints ())
10470 struct static_tracepoint_marker marker
;
10472 if (target_static_tracepoint_marker_at (tpaddr
, &marker
))
10473 strcat (buf
, ":S");
10475 error (_("Static tracepoint not valid during download"));
10478 /* Fast tracepoints are functionally identical to regular
10479 tracepoints, so don't take lack of support as a reason
10480 to give up on the trace run. */
10481 error (_("Target does not support static tracepoints"));
10483 /* If the tracepoint has a conditional, make it into an agent
10484 expression and append to the definition. */
10487 /* Only test support at download time, we may not know target
10488 capabilities at definition time. */
10489 if (remote_supports_cond_tracepoints ())
10491 aexpr
= gen_eval_for_expr (tpaddr
, loc
->cond
);
10492 aexpr_chain
= make_cleanup_free_agent_expr (aexpr
);
10493 xsnprintf (buf
+ strlen (buf
), BUF_SIZE
- strlen (buf
), ":X%x,",
10495 pkt
= buf
+ strlen (buf
);
10496 for (ndx
= 0; ndx
< aexpr
->len
; ++ndx
)
10497 pkt
= pack_hex_byte (pkt
, aexpr
->buf
[ndx
]);
10499 do_cleanups (aexpr_chain
);
10502 warning (_("Target does not support conditional tracepoints, "
10503 "ignoring tp %d cond"), b
->number
);
10506 if (b
->commands
|| *default_collect
)
10509 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10510 if (strcmp (target_buf
, "OK"))
10511 error (_("Target does not support tracepoints."));
10513 /* do_single_steps (t); */
10516 for (ndx
= 0; tdp_actions
[ndx
]; ndx
++)
10518 QUIT
; /* Allow user to bail out with ^C. */
10519 xsnprintf (buf
, BUF_SIZE
, "QTDP:-%x:%s:%s%c",
10520 b
->number
, addrbuf
, /* address */
10522 ((tdp_actions
[ndx
+ 1] || stepping_actions
)
10525 remote_get_noisy_reply (&target_buf
,
10527 if (strcmp (target_buf
, "OK"))
10528 error (_("Error on target while setting tracepoints."));
10531 if (stepping_actions
)
10533 for (ndx
= 0; stepping_actions
[ndx
]; ndx
++)
10535 QUIT
; /* Allow user to bail out with ^C. */
10536 xsnprintf (buf
, BUF_SIZE
, "QTDP:-%x:%s:%s%s%s",
10537 b
->number
, addrbuf
, /* address */
10538 ((ndx
== 0) ? "S" : ""),
10539 stepping_actions
[ndx
],
10540 (stepping_actions
[ndx
+ 1] ? "-" : ""));
10542 remote_get_noisy_reply (&target_buf
,
10544 if (strcmp (target_buf
, "OK"))
10545 error (_("Error on target while setting tracepoints."));
10549 if (remote_protocol_packets
[PACKET_TracepointSource
].support
10552 if (b
->addr_string
)
10554 strcpy (buf
, "QTDPsrc:");
10555 encode_source_string (b
->number
, loc
->address
,
10556 "at", b
->addr_string
, buf
+ strlen (buf
),
10557 2048 - strlen (buf
));
10560 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10561 if (strcmp (target_buf
, "OK"))
10562 warning (_("Target does not support source download."));
10564 if (b
->cond_string
)
10566 strcpy (buf
, "QTDPsrc:");
10567 encode_source_string (b
->number
, loc
->address
,
10568 "cond", b
->cond_string
, buf
+ strlen (buf
),
10569 2048 - strlen (buf
));
10571 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10572 if (strcmp (target_buf
, "OK"))
10573 warning (_("Target does not support source download."));
10575 remote_download_command_source (b
->number
, loc
->address
,
10576 breakpoint_commands (b
));
10579 do_cleanups (old_chain
);
10583 remote_can_download_tracepoint (struct target_ops
*self
)
10585 struct remote_state
*rs
= get_remote_state ();
10586 struct trace_status
*ts
;
10589 /* Don't try to install tracepoints until we've relocated our
10590 symbols, and fetched and merged the target's tracepoint list with
10592 if (rs
->starting_up
)
10595 ts
= current_trace_status ();
10596 status
= remote_get_trace_status (self
, ts
);
10598 if (status
== -1 || !ts
->running_known
|| !ts
->running
)
10601 /* If we are in a tracing experiment, but remote stub doesn't support
10602 installing tracepoint in trace, we have to return. */
10603 if (!remote_supports_install_in_trace ())
10611 remote_download_trace_state_variable (struct target_ops
*self
,
10612 struct trace_state_variable
*tsv
)
10614 struct remote_state
*rs
= get_remote_state ();
10617 xsnprintf (rs
->buf
, get_remote_packet_size (), "QTDV:%x:%s:%x:",
10618 tsv
->number
, phex ((ULONGEST
) tsv
->initial_value
, 8),
10620 p
= rs
->buf
+ strlen (rs
->buf
);
10621 if ((p
- rs
->buf
) + strlen (tsv
->name
) * 2 >= get_remote_packet_size ())
10622 error (_("Trace state variable name too long for tsv definition packet"));
10623 p
+= 2 * bin2hex ((gdb_byte
*) (tsv
->name
), p
, strlen (tsv
->name
));
10626 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10627 if (*target_buf
== '\0')
10628 error (_("Target does not support this command."));
10629 if (strcmp (target_buf
, "OK") != 0)
10630 error (_("Error on target while downloading trace state variable."));
10634 remote_enable_tracepoint (struct target_ops
*self
,
10635 struct bp_location
*location
)
10637 struct remote_state
*rs
= get_remote_state ();
10640 sprintf_vma (addr_buf
, location
->address
);
10641 xsnprintf (rs
->buf
, get_remote_packet_size (), "QTEnable:%x:%s",
10642 location
->owner
->number
, addr_buf
);
10644 remote_get_noisy_reply (&rs
->buf
, &rs
->buf_size
);
10645 if (*rs
->buf
== '\0')
10646 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
10647 if (strcmp (rs
->buf
, "OK") != 0)
10648 error (_("Error on target while enabling tracepoint."));
10652 remote_disable_tracepoint (struct target_ops
*self
,
10653 struct bp_location
*location
)
10655 struct remote_state
*rs
= get_remote_state ();
10658 sprintf_vma (addr_buf
, location
->address
);
10659 xsnprintf (rs
->buf
, get_remote_packet_size (), "QTDisable:%x:%s",
10660 location
->owner
->number
, addr_buf
);
10662 remote_get_noisy_reply (&rs
->buf
, &rs
->buf_size
);
10663 if (*rs
->buf
== '\0')
10664 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
10665 if (strcmp (rs
->buf
, "OK") != 0)
10666 error (_("Error on target while disabling tracepoint."));
10670 remote_trace_set_readonly_regions (struct target_ops
*self
)
10674 bfd_size_type size
;
10680 return; /* No information to give. */
10682 strcpy (target_buf
, "QTro");
10683 offset
= strlen (target_buf
);
10684 for (s
= exec_bfd
->sections
; s
; s
= s
->next
)
10686 char tmp1
[40], tmp2
[40];
10689 if ((s
->flags
& SEC_LOAD
) == 0 ||
10690 /* (s->flags & SEC_CODE) == 0 || */
10691 (s
->flags
& SEC_READONLY
) == 0)
10695 vma
= bfd_get_section_vma (abfd
, s
);
10696 size
= bfd_get_section_size (s
);
10697 sprintf_vma (tmp1
, vma
);
10698 sprintf_vma (tmp2
, vma
+ size
);
10699 sec_length
= 1 + strlen (tmp1
) + 1 + strlen (tmp2
);
10700 if (offset
+ sec_length
+ 1 > target_buf_size
)
10702 if (remote_protocol_packets
[PACKET_qXfer_traceframe_info
].support
10705 Too many sections for read-only sections definition packet."));
10708 xsnprintf (target_buf
+ offset
, target_buf_size
- offset
, ":%s,%s",
10710 offset
+= sec_length
;
10714 putpkt (target_buf
);
10715 getpkt (&target_buf
, &target_buf_size
, 0);
10720 remote_trace_start (struct target_ops
*self
)
10722 putpkt ("QTStart");
10723 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10724 if (*target_buf
== '\0')
10725 error (_("Target does not support this command."));
10726 if (strcmp (target_buf
, "OK") != 0)
10727 error (_("Bogus reply from target: %s"), target_buf
);
10731 remote_get_trace_status (struct target_ops
*self
, struct trace_status
*ts
)
10733 /* Initialize it just to avoid a GCC false warning. */
10735 /* FIXME we need to get register block size some other way. */
10736 extern int trace_regblock_size
;
10737 volatile struct gdb_exception ex
;
10738 enum packet_result result
;
10740 if (remote_protocol_packets
[PACKET_qTStatus
].support
== PACKET_DISABLE
)
10743 trace_regblock_size
= get_remote_arch_state ()->sizeof_g_packet
;
10745 putpkt ("qTStatus");
10747 TRY_CATCH (ex
, RETURN_MASK_ERROR
)
10749 p
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10753 if (ex
.error
!= TARGET_CLOSE_ERROR
)
10755 exception_fprintf (gdb_stderr
, ex
, "qTStatus: ");
10758 throw_exception (ex
);
10761 result
= packet_ok (p
, &remote_protocol_packets
[PACKET_qTStatus
]);
10763 /* If the remote target doesn't do tracing, flag it. */
10764 if (result
== PACKET_UNKNOWN
)
10767 /* We're working with a live target. */
10768 ts
->filename
= NULL
;
10771 error (_("Bogus trace status reply from target: %s"), target_buf
);
10773 /* Function 'parse_trace_status' sets default value of each field of
10774 'ts' at first, so we don't have to do it here. */
10775 parse_trace_status (p
, ts
);
10777 return ts
->running
;
10781 remote_get_tracepoint_status (struct target_ops
*self
, struct breakpoint
*bp
,
10782 struct uploaded_tp
*utp
)
10784 struct remote_state
*rs
= get_remote_state ();
10786 struct bp_location
*loc
;
10787 struct tracepoint
*tp
= (struct tracepoint
*) bp
;
10788 size_t size
= get_remote_packet_size ();
10792 tp
->base
.hit_count
= 0;
10793 tp
->traceframe_usage
= 0;
10794 for (loc
= tp
->base
.loc
; loc
; loc
= loc
->next
)
10796 /* If the tracepoint was never downloaded, don't go asking for
10798 if (tp
->number_on_target
== 0)
10800 xsnprintf (rs
->buf
, size
, "qTP:%x:%s", tp
->number_on_target
,
10801 phex_nz (loc
->address
, 0));
10803 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10804 if (reply
&& *reply
)
10807 parse_tracepoint_status (reply
+ 1, bp
, utp
);
10813 utp
->hit_count
= 0;
10814 utp
->traceframe_usage
= 0;
10815 xsnprintf (rs
->buf
, size
, "qTP:%x:%s", utp
->number
,
10816 phex_nz (utp
->addr
, 0));
10818 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10819 if (reply
&& *reply
)
10822 parse_tracepoint_status (reply
+ 1, bp
, utp
);
10828 remote_trace_stop (struct target_ops
*self
)
10831 remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10832 if (*target_buf
== '\0')
10833 error (_("Target does not support this command."));
10834 if (strcmp (target_buf
, "OK") != 0)
10835 error (_("Bogus reply from target: %s"), target_buf
);
10839 remote_trace_find (struct target_ops
*self
,
10840 enum trace_find_type type
, int num
,
10841 CORE_ADDR addr1
, CORE_ADDR addr2
,
10844 struct remote_state
*rs
= get_remote_state ();
10845 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
10847 int target_frameno
= -1, target_tracept
= -1;
10849 /* Lookups other than by absolute frame number depend on the current
10850 trace selected, so make sure it is correct on the remote end
10852 if (type
!= tfind_number
)
10853 set_remote_traceframe ();
10856 strcpy (p
, "QTFrame:");
10857 p
= strchr (p
, '\0');
10861 xsnprintf (p
, endbuf
- p
, "%x", num
);
10864 xsnprintf (p
, endbuf
- p
, "pc:%s", phex_nz (addr1
, 0));
10867 xsnprintf (p
, endbuf
- p
, "tdp:%x", num
);
10870 xsnprintf (p
, endbuf
- p
, "range:%s:%s", phex_nz (addr1
, 0),
10871 phex_nz (addr2
, 0));
10873 case tfind_outside
:
10874 xsnprintf (p
, endbuf
- p
, "outside:%s:%s", phex_nz (addr1
, 0),
10875 phex_nz (addr2
, 0));
10878 error (_("Unknown trace find type %d"), type
);
10882 reply
= remote_get_noisy_reply (&(rs
->buf
), &rs
->buf_size
);
10883 if (*reply
== '\0')
10884 error (_("Target does not support this command."));
10886 while (reply
&& *reply
)
10891 target_frameno
= (int) strtol (p
, &reply
, 16);
10893 error (_("Unable to parse trace frame number"));
10894 /* Don't update our remote traceframe number cache on failure
10895 to select a remote traceframe. */
10896 if (target_frameno
== -1)
10901 target_tracept
= (int) strtol (p
, &reply
, 16);
10903 error (_("Unable to parse tracepoint number"));
10905 case 'O': /* "OK"? */
10906 if (reply
[1] == 'K' && reply
[2] == '\0')
10909 error (_("Bogus reply from target: %s"), reply
);
10912 error (_("Bogus reply from target: %s"), reply
);
10915 *tpp
= target_tracept
;
10917 rs
->remote_traceframe_number
= target_frameno
;
10918 return target_frameno
;
10922 remote_get_trace_state_variable_value (struct target_ops
*self
,
10923 int tsvnum
, LONGEST
*val
)
10925 struct remote_state
*rs
= get_remote_state ();
10929 set_remote_traceframe ();
10931 xsnprintf (rs
->buf
, get_remote_packet_size (), "qTV:%x", tsvnum
);
10933 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10934 if (reply
&& *reply
)
10938 unpack_varlen_hex (reply
+ 1, &uval
);
10939 *val
= (LONGEST
) uval
;
10947 remote_save_trace_data (struct target_ops
*self
, const char *filename
)
10949 struct remote_state
*rs
= get_remote_state ();
10953 strcpy (p
, "QTSave:");
10955 if ((p
- rs
->buf
) + strlen (filename
) * 2 >= get_remote_packet_size ())
10956 error (_("Remote file name too long for trace save packet"));
10957 p
+= 2 * bin2hex ((gdb_byte
*) filename
, p
, strlen (filename
));
10960 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10961 if (*reply
== '\0')
10962 error (_("Target does not support this command."));
10963 if (strcmp (reply
, "OK") != 0)
10964 error (_("Bogus reply from target: %s"), reply
);
10968 /* This is basically a memory transfer, but needs to be its own packet
10969 because we don't know how the target actually organizes its trace
10970 memory, plus we want to be able to ask for as much as possible, but
10971 not be unhappy if we don't get as much as we ask for. */
10974 remote_get_raw_trace_data (struct target_ops
*self
,
10975 gdb_byte
*buf
, ULONGEST offset
, LONGEST len
)
10977 struct remote_state
*rs
= get_remote_state ();
10983 strcpy (p
, "qTBuffer:");
10985 p
+= hexnumstr (p
, offset
);
10987 p
+= hexnumstr (p
, len
);
10991 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
10992 if (reply
&& *reply
)
10994 /* 'l' by itself means we're at the end of the buffer and
10995 there is nothing more to get. */
10999 /* Convert the reply into binary. Limit the number of bytes to
11000 convert according to our passed-in buffer size, rather than
11001 what was returned in the packet; if the target is
11002 unexpectedly generous and gives us a bigger reply than we
11003 asked for, we don't want to crash. */
11004 rslt
= hex2bin (target_buf
, buf
, len
);
11008 /* Something went wrong, flag as an error. */
11013 remote_set_disconnected_tracing (struct target_ops
*self
, int val
)
11015 struct remote_state
*rs
= get_remote_state ();
11017 if (rs
->disconnected_tracing
)
11021 xsnprintf (rs
->buf
, get_remote_packet_size (), "QTDisconnected:%x", val
);
11023 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
11024 if (*reply
== '\0')
11025 error (_("Target does not support this command."));
11026 if (strcmp (reply
, "OK") != 0)
11027 error (_("Bogus reply from target: %s"), reply
);
11030 warning (_("Target does not support disconnected tracing."));
11034 remote_core_of_thread (struct target_ops
*ops
, ptid_t ptid
)
11036 struct thread_info
*info
= find_thread_ptid (ptid
);
11038 if (info
&& info
->private)
11039 return info
->private->core
;
11044 remote_set_circular_trace_buffer (struct target_ops
*self
, int val
)
11046 struct remote_state
*rs
= get_remote_state ();
11049 xsnprintf (rs
->buf
, get_remote_packet_size (), "QTBuffer:circular:%x", val
);
11051 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
11052 if (*reply
== '\0')
11053 error (_("Target does not support this command."));
11054 if (strcmp (reply
, "OK") != 0)
11055 error (_("Bogus reply from target: %s"), reply
);
11058 static struct traceframe_info
*
11059 remote_traceframe_info (struct target_ops
*self
)
11063 text
= target_read_stralloc (¤t_target
,
11064 TARGET_OBJECT_TRACEFRAME_INFO
, NULL
);
11067 struct traceframe_info
*info
;
11068 struct cleanup
*back_to
= make_cleanup (xfree
, text
);
11070 info
= parse_traceframe_info (text
);
11071 do_cleanups (back_to
);
11078 /* Handle the qTMinFTPILen packet. Returns the minimum length of
11079 instruction on which a fast tracepoint may be placed. Returns -1
11080 if the packet is not supported, and 0 if the minimum instruction
11081 length is unknown. */
11084 remote_get_min_fast_tracepoint_insn_len (struct target_ops
*self
)
11086 struct remote_state
*rs
= get_remote_state ();
11089 /* If we're not debugging a process yet, the IPA can't be
11091 if (!target_has_execution
)
11094 /* Make sure the remote is pointing at the right process. */
11095 set_general_process ();
11097 xsnprintf (rs
->buf
, get_remote_packet_size (), "qTMinFTPILen");
11099 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
11100 if (*reply
== '\0')
11104 ULONGEST min_insn_len
;
11106 unpack_varlen_hex (reply
, &min_insn_len
);
11108 return (int) min_insn_len
;
11113 remote_set_trace_buffer_size (struct target_ops
*self
, LONGEST val
)
11115 if (remote_protocol_packets
[PACKET_QTBuffer_size
].support
11118 struct remote_state
*rs
= get_remote_state ();
11119 char *buf
= rs
->buf
;
11120 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
11121 enum packet_result result
;
11123 gdb_assert (val
>= 0 || val
== -1);
11124 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTBuffer:size:");
11125 /* Send -1 as literal "-1" to avoid host size dependency. */
11129 buf
+= hexnumstr (buf
, (ULONGEST
) -val
);
11132 buf
+= hexnumstr (buf
, (ULONGEST
) val
);
11135 remote_get_noisy_reply (&rs
->buf
, &rs
->buf_size
);
11136 result
= packet_ok (rs
->buf
,
11137 &remote_protocol_packets
[PACKET_QTBuffer_size
]);
11139 if (result
!= PACKET_OK
)
11140 warning (_("Bogus reply from target: %s"), rs
->buf
);
11145 remote_set_trace_notes (struct target_ops
*self
,
11146 const char *user
, const char *notes
,
11147 const char *stop_notes
)
11149 struct remote_state
*rs
= get_remote_state ();
11151 char *buf
= rs
->buf
;
11152 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
11155 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTNotes:");
11158 buf
+= xsnprintf (buf
, endbuf
- buf
, "user:");
11159 nbytes
= bin2hex ((gdb_byte
*) user
, buf
, strlen (user
));
11165 buf
+= xsnprintf (buf
, endbuf
- buf
, "notes:");
11166 nbytes
= bin2hex ((gdb_byte
*) notes
, buf
, strlen (notes
));
11172 buf
+= xsnprintf (buf
, endbuf
- buf
, "tstop:");
11173 nbytes
= bin2hex ((gdb_byte
*) stop_notes
, buf
, strlen (stop_notes
));
11177 /* Ensure the buffer is terminated. */
11181 reply
= remote_get_noisy_reply (&target_buf
, &target_buf_size
);
11182 if (*reply
== '\0')
11185 if (strcmp (reply
, "OK") != 0)
11186 error (_("Bogus reply from target: %s"), reply
);
11192 remote_use_agent (struct target_ops
*self
, int use
)
11194 if (remote_protocol_packets
[PACKET_QAgent
].support
!= PACKET_DISABLE
)
11196 struct remote_state
*rs
= get_remote_state ();
11198 /* If the stub supports QAgent. */
11199 xsnprintf (rs
->buf
, get_remote_packet_size (), "QAgent:%d", use
);
11201 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11203 if (strcmp (rs
->buf
, "OK") == 0)
11214 remote_can_use_agent (struct target_ops
*self
)
11216 return (remote_protocol_packets
[PACKET_QAgent
].support
!= PACKET_DISABLE
);
11219 struct btrace_target_info
11221 /* The ptid of the traced thread. */
11225 /* Check whether the target supports branch tracing. */
11228 remote_supports_btrace (struct target_ops
*self
)
11230 if (remote_protocol_packets
[PACKET_Qbtrace_off
].support
!= PACKET_ENABLE
)
11232 if (remote_protocol_packets
[PACKET_Qbtrace_bts
].support
!= PACKET_ENABLE
)
11234 if (remote_protocol_packets
[PACKET_qXfer_btrace
].support
!= PACKET_ENABLE
)
11240 /* Enable branch tracing. */
11242 static struct btrace_target_info
*
11243 remote_enable_btrace (struct target_ops
*self
, ptid_t ptid
)
11245 struct btrace_target_info
*tinfo
= NULL
;
11246 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_Qbtrace_bts
];
11247 struct remote_state
*rs
= get_remote_state ();
11248 char *buf
= rs
->buf
;
11249 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
11251 if (packet
->support
!= PACKET_ENABLE
)
11252 error (_("Target does not support branch tracing."));
11254 set_general_thread (ptid
);
11256 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
11258 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11260 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
11262 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
11263 error (_("Could not enable branch tracing for %s: %s"),
11264 target_pid_to_str (ptid
), rs
->buf
+ 2);
11266 error (_("Could not enable branch tracing for %s."),
11267 target_pid_to_str (ptid
));
11270 tinfo
= xzalloc (sizeof (*tinfo
));
11271 tinfo
->ptid
= ptid
;
11276 /* Disable branch tracing. */
11279 remote_disable_btrace (struct target_ops
*self
,
11280 struct btrace_target_info
*tinfo
)
11282 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_Qbtrace_off
];
11283 struct remote_state
*rs
= get_remote_state ();
11284 char *buf
= rs
->buf
;
11285 char *endbuf
= rs
->buf
+ get_remote_packet_size ();
11287 if (packet
->support
!= PACKET_ENABLE
)
11288 error (_("Target does not support branch tracing."));
11290 set_general_thread (tinfo
->ptid
);
11292 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
11294 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11296 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
11298 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
11299 error (_("Could not disable branch tracing for %s: %s"),
11300 target_pid_to_str (tinfo
->ptid
), rs
->buf
+ 2);
11302 error (_("Could not disable branch tracing for %s."),
11303 target_pid_to_str (tinfo
->ptid
));
11309 /* Teardown branch tracing. */
11312 remote_teardown_btrace (struct target_ops
*self
,
11313 struct btrace_target_info
*tinfo
)
11315 /* We must not talk to the target during teardown. */
11319 /* Read the branch trace. */
11321 static enum btrace_error
11322 remote_read_btrace (struct target_ops
*self
,
11323 VEC (btrace_block_s
) **btrace
,
11324 struct btrace_target_info
*tinfo
,
11325 enum btrace_read_type type
)
11327 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_qXfer_btrace
];
11328 struct remote_state
*rs
= get_remote_state ();
11329 struct cleanup
*cleanup
;
11333 if (packet
->support
!= PACKET_ENABLE
)
11334 error (_("Target does not support branch tracing."));
11336 #if !defined(HAVE_LIBEXPAT)
11337 error (_("Cannot process branch tracing result. XML parsing not supported."));
11342 case BTRACE_READ_ALL
:
11345 case BTRACE_READ_NEW
:
11348 case BTRACE_READ_DELTA
:
11352 internal_error (__FILE__
, __LINE__
,
11353 _("Bad branch tracing read type: %u."),
11354 (unsigned int) type
);
11357 xml
= target_read_stralloc (¤t_target
,
11358 TARGET_OBJECT_BTRACE
, annex
);
11360 return BTRACE_ERR_UNKNOWN
;
11362 cleanup
= make_cleanup (xfree
, xml
);
11363 *btrace
= parse_xml_btrace (xml
);
11364 do_cleanups (cleanup
);
11366 return BTRACE_ERR_NONE
;
11370 remote_augmented_libraries_svr4_read (struct target_ops
*self
)
11372 struct remote_state
*rs
= get_remote_state ();
11374 return rs
->augmented_libraries_svr4_read
;
11377 /* Implementation of to_load. */
11380 remote_load (struct target_ops
*self
, char *name
, int from_tty
)
11382 generic_load (name
, from_tty
);
11386 init_remote_ops (void)
11388 remote_ops
.to_shortname
= "remote";
11389 remote_ops
.to_longname
= "Remote serial target in gdb-specific protocol";
11390 remote_ops
.to_doc
=
11391 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
11392 Specify the serial device it is connected to\n\
11393 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).";
11394 remote_ops
.to_open
= remote_open
;
11395 remote_ops
.to_close
= remote_close
;
11396 remote_ops
.to_detach
= remote_detach
;
11397 remote_ops
.to_disconnect
= remote_disconnect
;
11398 remote_ops
.to_resume
= remote_resume
;
11399 remote_ops
.to_wait
= remote_wait
;
11400 remote_ops
.to_fetch_registers
= remote_fetch_registers
;
11401 remote_ops
.to_store_registers
= remote_store_registers
;
11402 remote_ops
.to_prepare_to_store
= remote_prepare_to_store
;
11403 remote_ops
.to_files_info
= remote_files_info
;
11404 remote_ops
.to_insert_breakpoint
= remote_insert_breakpoint
;
11405 remote_ops
.to_remove_breakpoint
= remote_remove_breakpoint
;
11406 remote_ops
.to_stopped_by_watchpoint
= remote_stopped_by_watchpoint
;
11407 remote_ops
.to_stopped_data_address
= remote_stopped_data_address
;
11408 remote_ops
.to_watchpoint_addr_within_range
=
11409 remote_watchpoint_addr_within_range
;
11410 remote_ops
.to_can_use_hw_breakpoint
= remote_check_watch_resources
;
11411 remote_ops
.to_insert_hw_breakpoint
= remote_insert_hw_breakpoint
;
11412 remote_ops
.to_remove_hw_breakpoint
= remote_remove_hw_breakpoint
;
11413 remote_ops
.to_region_ok_for_hw_watchpoint
11414 = remote_region_ok_for_hw_watchpoint
;
11415 remote_ops
.to_insert_watchpoint
= remote_insert_watchpoint
;
11416 remote_ops
.to_remove_watchpoint
= remote_remove_watchpoint
;
11417 remote_ops
.to_kill
= remote_kill
;
11418 remote_ops
.to_load
= remote_load
;
11419 remote_ops
.to_mourn_inferior
= remote_mourn
;
11420 remote_ops
.to_pass_signals
= remote_pass_signals
;
11421 remote_ops
.to_program_signals
= remote_program_signals
;
11422 remote_ops
.to_thread_alive
= remote_thread_alive
;
11423 remote_ops
.to_find_new_threads
= remote_threads_info
;
11424 remote_ops
.to_pid_to_str
= remote_pid_to_str
;
11425 remote_ops
.to_extra_thread_info
= remote_threads_extra_info
;
11426 remote_ops
.to_get_ada_task_ptid
= remote_get_ada_task_ptid
;
11427 remote_ops
.to_stop
= remote_stop
;
11428 remote_ops
.to_xfer_partial
= remote_xfer_partial
;
11429 remote_ops
.to_rcmd
= remote_rcmd
;
11430 remote_ops
.to_log_command
= serial_log_command
;
11431 remote_ops
.to_get_thread_local_address
= remote_get_thread_local_address
;
11432 remote_ops
.to_stratum
= process_stratum
;
11433 remote_ops
.to_has_all_memory
= default_child_has_all_memory
;
11434 remote_ops
.to_has_memory
= default_child_has_memory
;
11435 remote_ops
.to_has_stack
= default_child_has_stack
;
11436 remote_ops
.to_has_registers
= default_child_has_registers
;
11437 remote_ops
.to_has_execution
= default_child_has_execution
;
11438 remote_ops
.to_has_thread_control
= tc_schedlock
; /* can lock scheduler */
11439 remote_ops
.to_can_execute_reverse
= remote_can_execute_reverse
;
11440 remote_ops
.to_magic
= OPS_MAGIC
;
11441 remote_ops
.to_memory_map
= remote_memory_map
;
11442 remote_ops
.to_flash_erase
= remote_flash_erase
;
11443 remote_ops
.to_flash_done
= remote_flash_done
;
11444 remote_ops
.to_read_description
= remote_read_description
;
11445 remote_ops
.to_search_memory
= remote_search_memory
;
11446 remote_ops
.to_can_async_p
= remote_can_async_p
;
11447 remote_ops
.to_is_async_p
= remote_is_async_p
;
11448 remote_ops
.to_async
= remote_async
;
11449 remote_ops
.to_terminal_inferior
= remote_terminal_inferior
;
11450 remote_ops
.to_terminal_ours
= remote_terminal_ours
;
11451 remote_ops
.to_supports_non_stop
= remote_supports_non_stop
;
11452 remote_ops
.to_supports_multi_process
= remote_supports_multi_process
;
11453 remote_ops
.to_supports_disable_randomization
11454 = remote_supports_disable_randomization
;
11455 remote_ops
.to_fileio_open
= remote_hostio_open
;
11456 remote_ops
.to_fileio_pwrite
= remote_hostio_pwrite
;
11457 remote_ops
.to_fileio_pread
= remote_hostio_pread
;
11458 remote_ops
.to_fileio_close
= remote_hostio_close
;
11459 remote_ops
.to_fileio_unlink
= remote_hostio_unlink
;
11460 remote_ops
.to_fileio_readlink
= remote_hostio_readlink
;
11461 remote_ops
.to_supports_enable_disable_tracepoint
= remote_supports_enable_disable_tracepoint
;
11462 remote_ops
.to_supports_string_tracing
= remote_supports_string_tracing
;
11463 remote_ops
.to_supports_evaluation_of_breakpoint_conditions
= remote_supports_cond_breakpoints
;
11464 remote_ops
.to_can_run_breakpoint_commands
= remote_can_run_breakpoint_commands
;
11465 remote_ops
.to_trace_init
= remote_trace_init
;
11466 remote_ops
.to_download_tracepoint
= remote_download_tracepoint
;
11467 remote_ops
.to_can_download_tracepoint
= remote_can_download_tracepoint
;
11468 remote_ops
.to_download_trace_state_variable
11469 = remote_download_trace_state_variable
;
11470 remote_ops
.to_enable_tracepoint
= remote_enable_tracepoint
;
11471 remote_ops
.to_disable_tracepoint
= remote_disable_tracepoint
;
11472 remote_ops
.to_trace_set_readonly_regions
= remote_trace_set_readonly_regions
;
11473 remote_ops
.to_trace_start
= remote_trace_start
;
11474 remote_ops
.to_get_trace_status
= remote_get_trace_status
;
11475 remote_ops
.to_get_tracepoint_status
= remote_get_tracepoint_status
;
11476 remote_ops
.to_trace_stop
= remote_trace_stop
;
11477 remote_ops
.to_trace_find
= remote_trace_find
;
11478 remote_ops
.to_get_trace_state_variable_value
11479 = remote_get_trace_state_variable_value
;
11480 remote_ops
.to_save_trace_data
= remote_save_trace_data
;
11481 remote_ops
.to_upload_tracepoints
= remote_upload_tracepoints
;
11482 remote_ops
.to_upload_trace_state_variables
11483 = remote_upload_trace_state_variables
;
11484 remote_ops
.to_get_raw_trace_data
= remote_get_raw_trace_data
;
11485 remote_ops
.to_get_min_fast_tracepoint_insn_len
= remote_get_min_fast_tracepoint_insn_len
;
11486 remote_ops
.to_set_disconnected_tracing
= remote_set_disconnected_tracing
;
11487 remote_ops
.to_set_circular_trace_buffer
= remote_set_circular_trace_buffer
;
11488 remote_ops
.to_set_trace_buffer_size
= remote_set_trace_buffer_size
;
11489 remote_ops
.to_set_trace_notes
= remote_set_trace_notes
;
11490 remote_ops
.to_core_of_thread
= remote_core_of_thread
;
11491 remote_ops
.to_verify_memory
= remote_verify_memory
;
11492 remote_ops
.to_get_tib_address
= remote_get_tib_address
;
11493 remote_ops
.to_set_permissions
= remote_set_permissions
;
11494 remote_ops
.to_static_tracepoint_marker_at
11495 = remote_static_tracepoint_marker_at
;
11496 remote_ops
.to_static_tracepoint_markers_by_strid
11497 = remote_static_tracepoint_markers_by_strid
;
11498 remote_ops
.to_traceframe_info
= remote_traceframe_info
;
11499 remote_ops
.to_use_agent
= remote_use_agent
;
11500 remote_ops
.to_can_use_agent
= remote_can_use_agent
;
11501 remote_ops
.to_supports_btrace
= remote_supports_btrace
;
11502 remote_ops
.to_enable_btrace
= remote_enable_btrace
;
11503 remote_ops
.to_disable_btrace
= remote_disable_btrace
;
11504 remote_ops
.to_teardown_btrace
= remote_teardown_btrace
;
11505 remote_ops
.to_read_btrace
= remote_read_btrace
;
11506 remote_ops
.to_augmented_libraries_svr4_read
=
11507 remote_augmented_libraries_svr4_read
;
11510 /* Set up the extended remote vector by making a copy of the standard
11511 remote vector and adding to it. */
11514 init_extended_remote_ops (void)
11516 extended_remote_ops
= remote_ops
;
11518 extended_remote_ops
.to_shortname
= "extended-remote";
11519 extended_remote_ops
.to_longname
=
11520 "Extended remote serial target in gdb-specific protocol";
11521 extended_remote_ops
.to_doc
=
11522 "Use a remote computer via a serial line, using a gdb-specific protocol.\n\
11523 Specify the serial device it is connected to (e.g. /dev/ttya).";
11524 extended_remote_ops
.to_open
= extended_remote_open
;
11525 extended_remote_ops
.to_create_inferior
= extended_remote_create_inferior
;
11526 extended_remote_ops
.to_mourn_inferior
= extended_remote_mourn
;
11527 extended_remote_ops
.to_detach
= extended_remote_detach
;
11528 extended_remote_ops
.to_attach
= extended_remote_attach
;
11529 extended_remote_ops
.to_kill
= extended_remote_kill
;
11530 extended_remote_ops
.to_supports_disable_randomization
11531 = extended_remote_supports_disable_randomization
;
11535 remote_can_async_p (struct target_ops
*ops
)
11537 struct remote_state
*rs
= get_remote_state ();
11539 if (!target_async_permitted
)
11540 /* We only enable async when the user specifically asks for it. */
11543 /* We're async whenever the serial device is. */
11544 return serial_can_async_p (rs
->remote_desc
);
11548 remote_is_async_p (struct target_ops
*ops
)
11550 struct remote_state
*rs
= get_remote_state ();
11552 if (!target_async_permitted
)
11553 /* We only enable async when the user specifically asks for it. */
11556 /* We're async whenever the serial device is. */
11557 return serial_is_async_p (rs
->remote_desc
);
11560 /* Pass the SERIAL event on and up to the client. One day this code
11561 will be able to delay notifying the client of an event until the
11562 point where an entire packet has been received. */
11564 static serial_event_ftype remote_async_serial_handler
;
11567 remote_async_serial_handler (struct serial
*scb
, void *context
)
11569 struct remote_state
*rs
= context
;
11571 /* Don't propogate error information up to the client. Instead let
11572 the client find out about the error by querying the target. */
11573 rs
->async_client_callback (INF_REG_EVENT
, rs
->async_client_context
);
11577 remote_async_inferior_event_handler (gdb_client_data data
)
11579 inferior_event_handler (INF_REG_EVENT
, NULL
);
11583 remote_async (struct target_ops
*ops
,
11584 void (*callback
) (enum inferior_event_type event_type
,
11588 struct remote_state
*rs
= get_remote_state ();
11590 if (callback
!= NULL
)
11592 serial_async (rs
->remote_desc
, remote_async_serial_handler
, rs
);
11593 rs
->async_client_callback
= callback
;
11594 rs
->async_client_context
= context
;
11597 serial_async (rs
->remote_desc
, NULL
, NULL
);
11601 set_remote_cmd (char *args
, int from_tty
)
11603 help_list (remote_set_cmdlist
, "set remote ", -1, gdb_stdout
);
11607 show_remote_cmd (char *args
, int from_tty
)
11609 /* We can't just use cmd_show_list here, because we want to skip
11610 the redundant "show remote Z-packet" and the legacy aliases. */
11611 struct cleanup
*showlist_chain
;
11612 struct cmd_list_element
*list
= remote_show_cmdlist
;
11613 struct ui_out
*uiout
= current_uiout
;
11615 showlist_chain
= make_cleanup_ui_out_tuple_begin_end (uiout
, "showlist");
11616 for (; list
!= NULL
; list
= list
->next
)
11617 if (strcmp (list
->name
, "Z-packet") == 0)
11619 else if (list
->type
== not_set_cmd
)
11620 /* Alias commands are exactly like the original, except they
11621 don't have the normal type. */
11625 struct cleanup
*option_chain
11626 = make_cleanup_ui_out_tuple_begin_end (uiout
, "option");
11628 ui_out_field_string (uiout
, "name", list
->name
);
11629 ui_out_text (uiout
, ": ");
11630 if (list
->type
== show_cmd
)
11631 do_show_command ((char *) NULL
, from_tty
, list
);
11633 cmd_func (list
, NULL
, from_tty
);
11634 /* Close the tuple. */
11635 do_cleanups (option_chain
);
11638 /* Close the tuple. */
11639 do_cleanups (showlist_chain
);
11643 /* Function to be called whenever a new objfile (shlib) is detected. */
11645 remote_new_objfile (struct objfile
*objfile
)
11647 struct remote_state
*rs
= get_remote_state ();
11649 if (rs
->remote_desc
!= 0) /* Have a remote connection. */
11650 remote_check_symbols ();
11653 /* Pull all the tracepoints defined on the target and create local
11654 data structures representing them. We don't want to create real
11655 tracepoints yet, we don't want to mess up the user's existing
11659 remote_upload_tracepoints (struct target_ops
*self
, struct uploaded_tp
**utpp
)
11661 struct remote_state
*rs
= get_remote_state ();
11664 /* Ask for a first packet of tracepoint definition. */
11666 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11668 while (*p
&& *p
!= 'l')
11670 parse_tracepoint_definition (p
, utpp
);
11671 /* Ask for another packet of tracepoint definition. */
11673 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11680 remote_upload_trace_state_variables (struct target_ops
*self
,
11681 struct uploaded_tsv
**utsvp
)
11683 struct remote_state
*rs
= get_remote_state ();
11686 /* Ask for a first packet of variable definition. */
11688 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11690 while (*p
&& *p
!= 'l')
11692 parse_tsv_definition (p
, utsvp
);
11693 /* Ask for another packet of variable definition. */
11695 getpkt (&rs
->buf
, &rs
->buf_size
, 0);
11701 /* The "set/show range-stepping" show hook. */
11704 show_range_stepping (struct ui_file
*file
, int from_tty
,
11705 struct cmd_list_element
*c
,
11708 fprintf_filtered (file
,
11709 _("Debugger's willingness to use range stepping "
11710 "is %s.\n"), value
);
11713 /* The "set/show range-stepping" set hook. */
11716 set_range_stepping (char *ignore_args
, int from_tty
,
11717 struct cmd_list_element
*c
)
11719 struct remote_state
*rs
= get_remote_state ();
11721 /* Whene enabling, check whether range stepping is actually
11722 supported by the target, and warn if not. */
11723 if (use_range_stepping
)
11725 if (rs
->remote_desc
!= NULL
)
11727 if (remote_protocol_packets
[PACKET_vCont
].support
== PACKET_SUPPORT_UNKNOWN
)
11728 remote_vcont_probe (rs
);
11730 if (remote_protocol_packets
[PACKET_vCont
].support
== PACKET_ENABLE
11731 && rs
->supports_vCont
.r
)
11735 warning (_("Range stepping is not supported by the current target"));
11740 _initialize_remote (void)
11742 struct remote_state
*rs
;
11743 struct cmd_list_element
*cmd
;
11744 const char *cmd_name
;
11746 /* architecture specific data */
11747 remote_gdbarch_data_handle
=
11748 gdbarch_data_register_post_init (init_remote_state
);
11749 remote_g_packet_data_handle
=
11750 gdbarch_data_register_pre_init (remote_g_packet_data_init
);
11752 /* Initialize the per-target state. At the moment there is only one
11753 of these, not one per target. Only one target is active at a
11755 remote_state
= new_remote_state ();
11757 init_remote_ops ();
11758 add_target (&remote_ops
);
11760 init_extended_remote_ops ();
11761 add_target (&extended_remote_ops
);
11763 /* Hook into new objfile notification. */
11764 observer_attach_new_objfile (remote_new_objfile
);
11765 /* We're no longer interested in notification events of an inferior
11767 observer_attach_inferior_exit (discard_pending_stop_replies
);
11769 /* Set up signal handlers. */
11770 async_sigint_remote_token
=
11771 create_async_signal_handler (async_remote_interrupt
, NULL
);
11772 async_sigint_remote_twice_token
=
11773 create_async_signal_handler (async_remote_interrupt_twice
, NULL
);
11776 init_remote_threadtests ();
11779 stop_reply_queue
= QUEUE_alloc (stop_reply_p
, stop_reply_xfree
);
11780 /* set/show remote ... */
11782 add_prefix_cmd ("remote", class_maintenance
, set_remote_cmd
, _("\
11783 Remote protocol specific variables\n\
11784 Configure various remote-protocol specific variables such as\n\
11785 the packets being used"),
11786 &remote_set_cmdlist
, "set remote ",
11787 0 /* allow-unknown */, &setlist
);
11788 add_prefix_cmd ("remote", class_maintenance
, show_remote_cmd
, _("\
11789 Remote protocol specific variables\n\
11790 Configure various remote-protocol specific variables such as\n\
11791 the packets being used"),
11792 &remote_show_cmdlist
, "show remote ",
11793 0 /* allow-unknown */, &showlist
);
11795 add_cmd ("compare-sections", class_obscure
, compare_sections_command
, _("\
11796 Compare section data on target to the exec file.\n\
11797 Argument is a single section name (default: all loaded sections)."),
11800 add_cmd ("packet", class_maintenance
, packet_command
, _("\
11801 Send an arbitrary packet to a remote target.\n\
11802 maintenance packet TEXT\n\
11803 If GDB is talking to an inferior via the GDB serial protocol, then\n\
11804 this command sends the string TEXT to the inferior, and displays the\n\
11805 response packet. GDB supplies the initial `$' character, and the\n\
11806 terminating `#' character and checksum."),
11809 add_setshow_boolean_cmd ("remotebreak", no_class
, &remote_break
, _("\
11810 Set whether to send break if interrupted."), _("\
11811 Show whether to send break if interrupted."), _("\
11812 If set, a break, instead of a cntrl-c, is sent to the remote target."),
11813 set_remotebreak
, show_remotebreak
,
11814 &setlist
, &showlist
);
11815 cmd_name
= "remotebreak";
11816 cmd
= lookup_cmd (&cmd_name
, setlist
, "", -1, 1);
11817 deprecate_cmd (cmd
, "set remote interrupt-sequence");
11818 cmd_name
= "remotebreak"; /* needed because lookup_cmd updates the pointer */
11819 cmd
= lookup_cmd (&cmd_name
, showlist
, "", -1, 1);
11820 deprecate_cmd (cmd
, "show remote interrupt-sequence");
11822 add_setshow_enum_cmd ("interrupt-sequence", class_support
,
11823 interrupt_sequence_modes
, &interrupt_sequence_mode
,
11825 Set interrupt sequence to remote target."), _("\
11826 Show interrupt sequence to remote target."), _("\
11827 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
11828 NULL
, show_interrupt_sequence
,
11829 &remote_set_cmdlist
,
11830 &remote_show_cmdlist
);
11832 add_setshow_boolean_cmd ("interrupt-on-connect", class_support
,
11833 &interrupt_on_connect
, _("\
11834 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
11835 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _(" \
11836 If set, interrupt sequence is sent to remote target."),
11838 &remote_set_cmdlist
, &remote_show_cmdlist
);
11840 /* Install commands for configuring memory read/write packets. */
11842 add_cmd ("remotewritesize", no_class
, set_memory_write_packet_size
, _("\
11843 Set the maximum number of bytes per memory write packet (deprecated)."),
11845 add_cmd ("remotewritesize", no_class
, show_memory_write_packet_size
, _("\
11846 Show the maximum number of bytes per memory write packet (deprecated)."),
11848 add_cmd ("memory-write-packet-size", no_class
,
11849 set_memory_write_packet_size
, _("\
11850 Set the maximum number of bytes per memory-write packet.\n\
11851 Specify the number of bytes in a packet or 0 (zero) for the\n\
11852 default packet size. The actual limit is further reduced\n\
11853 dependent on the target. Specify ``fixed'' to disable the\n\
11854 further restriction and ``limit'' to enable that restriction."),
11855 &remote_set_cmdlist
);
11856 add_cmd ("memory-read-packet-size", no_class
,
11857 set_memory_read_packet_size
, _("\
11858 Set the maximum number of bytes per memory-read packet.\n\
11859 Specify the number of bytes in a packet or 0 (zero) for the\n\
11860 default packet size. The actual limit is further reduced\n\
11861 dependent on the target. Specify ``fixed'' to disable the\n\
11862 further restriction and ``limit'' to enable that restriction."),
11863 &remote_set_cmdlist
);
11864 add_cmd ("memory-write-packet-size", no_class
,
11865 show_memory_write_packet_size
,
11866 _("Show the maximum number of bytes per memory-write packet."),
11867 &remote_show_cmdlist
);
11868 add_cmd ("memory-read-packet-size", no_class
,
11869 show_memory_read_packet_size
,
11870 _("Show the maximum number of bytes per memory-read packet."),
11871 &remote_show_cmdlist
);
11873 add_setshow_zinteger_cmd ("hardware-watchpoint-limit", no_class
,
11874 &remote_hw_watchpoint_limit
, _("\
11875 Set the maximum number of target hardware watchpoints."), _("\
11876 Show the maximum number of target hardware watchpoints."), _("\
11877 Specify a negative limit for unlimited."),
11878 NULL
, NULL
, /* FIXME: i18n: The maximum
11879 number of target hardware
11880 watchpoints is %s. */
11881 &remote_set_cmdlist
, &remote_show_cmdlist
);
11882 add_setshow_zinteger_cmd ("hardware-watchpoint-length-limit", no_class
,
11883 &remote_hw_watchpoint_length_limit
, _("\
11884 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
11885 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
11886 Specify a negative limit for unlimited."),
11887 NULL
, NULL
, /* FIXME: i18n: The maximum
11888 length (in bytes) of a target
11889 hardware watchpoint is %s. */
11890 &remote_set_cmdlist
, &remote_show_cmdlist
);
11891 add_setshow_zinteger_cmd ("hardware-breakpoint-limit", no_class
,
11892 &remote_hw_breakpoint_limit
, _("\
11893 Set the maximum number of target hardware breakpoints."), _("\
11894 Show the maximum number of target hardware breakpoints."), _("\
11895 Specify a negative limit for unlimited."),
11896 NULL
, NULL
, /* FIXME: i18n: The maximum
11897 number of target hardware
11898 breakpoints is %s. */
11899 &remote_set_cmdlist
, &remote_show_cmdlist
);
11901 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure
,
11902 &remote_address_size
, _("\
11903 Set the maximum size of the address (in bits) in a memory packet."), _("\
11904 Show the maximum size of the address (in bits) in a memory packet."), NULL
,
11906 NULL
, /* FIXME: i18n: */
11907 &setlist
, &showlist
);
11909 add_packet_config_cmd (&remote_protocol_packets
[PACKET_X
],
11910 "X", "binary-download", 1);
11912 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCont
],
11913 "vCont", "verbose-resume", 0);
11915 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QPassSignals
],
11916 "QPassSignals", "pass-signals", 0);
11918 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QProgramSignals
],
11919 "QProgramSignals", "program-signals", 0);
11921 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSymbol
],
11922 "qSymbol", "symbol-lookup", 0);
11924 add_packet_config_cmd (&remote_protocol_packets
[PACKET_P
],
11925 "P", "set-register", 1);
11927 add_packet_config_cmd (&remote_protocol_packets
[PACKET_p
],
11928 "p", "fetch-register", 1);
11930 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
],
11931 "Z0", "software-breakpoint", 0);
11933 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z1
],
11934 "Z1", "hardware-breakpoint", 0);
11936 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z2
],
11937 "Z2", "write-watchpoint", 0);
11939 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z3
],
11940 "Z3", "read-watchpoint", 0);
11942 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z4
],
11943 "Z4", "access-watchpoint", 0);
11945 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_auxv
],
11946 "qXfer:auxv:read", "read-aux-vector", 0);
11948 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_features
],
11949 "qXfer:features:read", "target-features", 0);
11951 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries
],
11952 "qXfer:libraries:read", "library-info", 0);
11954 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries_svr4
],
11955 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
11957 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_memory_map
],
11958 "qXfer:memory-map:read", "memory-map", 0);
11960 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_spu_read
],
11961 "qXfer:spu:read", "read-spu-object", 0);
11963 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_spu_write
],
11964 "qXfer:spu:write", "write-spu-object", 0);
11966 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_osdata
],
11967 "qXfer:osdata:read", "osdata", 0);
11969 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_threads
],
11970 "qXfer:threads:read", "threads", 0);
11972 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_read
],
11973 "qXfer:siginfo:read", "read-siginfo-object", 0);
11975 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_write
],
11976 "qXfer:siginfo:write", "write-siginfo-object", 0);
11978 add_packet_config_cmd
11979 (&remote_protocol_packets
[PACKET_qXfer_traceframe_info
],
11980 "qXfer:traceframe-info:read", "traceframe-info", 0);
11982 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_uib
],
11983 "qXfer:uib:read", "unwind-info-block", 0);
11985 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTLSAddr
],
11986 "qGetTLSAddr", "get-thread-local-storage-address",
11989 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTIBAddr
],
11990 "qGetTIBAddr", "get-thread-information-block-address",
11993 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bc
],
11994 "bc", "reverse-continue", 0);
11996 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bs
],
11997 "bs", "reverse-step", 0);
11999 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSupported
],
12000 "qSupported", "supported-packets", 0);
12002 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSearch_memory
],
12003 "qSearch:memory", "search-memory", 0);
12005 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qTStatus
],
12006 "qTStatus", "trace-status", 0);
12008 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_open
],
12009 "vFile:open", "hostio-open", 0);
12011 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pread
],
12012 "vFile:pread", "hostio-pread", 0);
12014 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pwrite
],
12015 "vFile:pwrite", "hostio-pwrite", 0);
12017 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_close
],
12018 "vFile:close", "hostio-close", 0);
12020 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_unlink
],
12021 "vFile:unlink", "hostio-unlink", 0);
12023 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_readlink
],
12024 "vFile:readlink", "hostio-readlink", 0);
12026 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vAttach
],
12027 "vAttach", "attach", 0);
12029 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vRun
],
12032 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartNoAckMode
],
12033 "QStartNoAckMode", "noack", 0);
12035 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vKill
],
12036 "vKill", "kill", 0);
12038 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qAttached
],
12039 "qAttached", "query-attached", 0);
12041 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalTracepoints
],
12042 "ConditionalTracepoints",
12043 "conditional-tracepoints", 0);
12045 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalBreakpoints
],
12046 "ConditionalBreakpoints",
12047 "conditional-breakpoints", 0);
12049 add_packet_config_cmd (&remote_protocol_packets
[PACKET_BreakpointCommands
],
12050 "BreakpointCommands",
12051 "breakpoint-commands", 0);
12053 add_packet_config_cmd (&remote_protocol_packets
[PACKET_FastTracepoints
],
12054 "FastTracepoints", "fast-tracepoints", 0);
12056 add_packet_config_cmd (&remote_protocol_packets
[PACKET_TracepointSource
],
12057 "TracepointSource", "TracepointSource", 0);
12059 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAllow
],
12060 "QAllow", "allow", 0);
12062 add_packet_config_cmd (&remote_protocol_packets
[PACKET_StaticTracepoints
],
12063 "StaticTracepoints", "static-tracepoints", 0);
12065 add_packet_config_cmd (&remote_protocol_packets
[PACKET_InstallInTrace
],
12066 "InstallInTrace", "install-in-trace", 0);
12068 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_statictrace_read
],
12069 "qXfer:statictrace:read", "read-sdata-object", 0);
12071 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_fdpic
],
12072 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
12074 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QDisableRandomization
],
12075 "QDisableRandomization", "disable-randomization", 0);
12077 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAgent
],
12078 "QAgent", "agent", 0);
12080 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QTBuffer_size
],
12081 "QTBuffer:size", "trace-buffer-size", 0);
12083 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_off
],
12084 "Qbtrace:off", "disable-btrace", 0);
12086 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_bts
],
12087 "Qbtrace:bts", "enable-btrace", 0);
12089 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace
],
12090 "qXfer:btrace", "read-btrace", 0);
12092 /* Keep the old ``set remote Z-packet ...'' working. Each individual
12093 Z sub-packet has its own set and show commands, but users may
12094 have sets to this variable in their .gdbinit files (or in their
12096 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure
,
12097 &remote_Z_packet_detect
, _("\
12098 Set use of remote protocol `Z' packets"), _("\
12099 Show use of remote protocol `Z' packets "), _("\
12100 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
12102 set_remote_protocol_Z_packet_cmd
,
12103 show_remote_protocol_Z_packet_cmd
,
12104 /* FIXME: i18n: Use of remote protocol
12105 `Z' packets is %s. */
12106 &remote_set_cmdlist
, &remote_show_cmdlist
);
12108 add_prefix_cmd ("remote", class_files
, remote_command
, _("\
12109 Manipulate files on the remote system\n\
12110 Transfer files to and from the remote target system."),
12111 &remote_cmdlist
, "remote ",
12112 0 /* allow-unknown */, &cmdlist
);
12114 add_cmd ("put", class_files
, remote_put_command
,
12115 _("Copy a local file to the remote system."),
12118 add_cmd ("get", class_files
, remote_get_command
,
12119 _("Copy a remote file to the local system."),
12122 add_cmd ("delete", class_files
, remote_delete_command
,
12123 _("Delete a remote file."),
12126 remote_exec_file
= xstrdup ("");
12127 add_setshow_string_noescape_cmd ("exec-file", class_files
,
12128 &remote_exec_file
, _("\
12129 Set the remote pathname for \"run\""), _("\
12130 Show the remote pathname for \"run\""), NULL
, NULL
, NULL
,
12131 &remote_set_cmdlist
, &remote_show_cmdlist
);
12133 add_setshow_boolean_cmd ("range-stepping", class_run
,
12134 &use_range_stepping
, _("\
12135 Enable or disable range stepping."), _("\
12136 Show whether target-assisted range stepping is enabled."), _("\
12137 If on, and the target supports it, when stepping a source line, GDB\n\
12138 tells the target to step the corresponding range of addresses itself instead\n\
12139 of issuing multiple single-steps. This speeds up source level\n\
12140 stepping. If off, GDB always issues single-steps, even if range\n\
12141 stepping is supported by the target. The default is on."),
12142 set_range_stepping
,
12143 show_range_stepping
,
12147 /* Eventually initialize fileio. See fileio.c */
12148 initialize_remote_fileio (remote_set_cmdlist
, remote_show_cmdlist
);
12150 /* Take advantage of the fact that the TID field is not used, to tag
12151 special ptids with it set to != 0. */
12152 magic_null_ptid
= ptid_build (42000, -1, 1);
12153 not_sent_ptid
= ptid_build (42000, -2, 1);
12154 any_thread_ptid
= ptid_build (42000, 0, 1);
12156 target_buf_size
= 2048;
12157 target_buf
= xmalloc (target_buf_size
);