aboutsummaryrefslogtreecommitdiff
path: root/gdb/remote.h
diff options
context:
space:
mode:
Diffstat (limited to 'gdb/remote.h')
-rw-r--r--gdb/remote.h35
1 files changed, 35 insertions, 0 deletions
diff --git a/gdb/remote.h b/gdb/remote.h
index 46bfa01..0178294 100644
--- a/gdb/remote.h
+++ b/gdb/remote.h
@@ -78,4 +78,39 @@ extern int remote_register_number_and_offset (struct gdbarch *gdbarch,
extern void remote_notif_get_pending_events (remote_target *remote,
struct notif_client *np);
extern bool remote_target_is_non_stop_p (remote_target *t);
+
+/* An abstract class that represents the set of callbacks that are made
+ from the send_remote_packet function (declared below). */
+
+struct send_remote_packet_callbacks
+{
+ /* The SENDING callback is called once send_remote_packet has performed
+ its error checking and setup, just before the packet is sent to the
+ remote target. BUF is the content of the packet that will be sent
+ (before any of the protocol specific prefix, suffix, or escaping is
+ applied). */
+
+ virtual void sending (gdb::array_view<const char> &buf) = 0;
+
+ /* The RECEIVED callback is called once a reply has been received from
+ the remote target. The content of the reply is in BUF which can't be
+ modified, and which is not guaranteed to remain valid after the
+ RECEIVED call has returned. If you need to preserve the contents of
+ BUF then a copy should be taken. */
+
+ virtual void received (gdb::array_view<const char> &buf) = 0;
+};
+
+/* Send BUF to the current remote target. If BUF points to an empty
+ string, either zero length, or the first character is the null
+ character, then an error is thrown. If the current target is not a
+ remote target then an error is thrown.
+
+ Calls CALLBACKS->sending() just before the packet is sent to the remote
+ target, and calls CALLBACKS->received() with the reply once this is
+ received from the remote target. */
+
+extern void send_remote_packet (gdb::array_view<const char> &buf,
+ send_remote_packet_callbacks *callbacks);
+
#endif