xref: /dragonfly/contrib/gdb-7/gdb/remote.h (revision 0db87cb7)
1 /* Remote target communications for serial-line targets in custom GDB protocol
2    Copyright (C) 1999-2013 Free Software Foundation, Inc.
3 
4    This file is part of GDB.
5 
6    This program is free software; you can redistribute it and/or modify
7    it under the terms of the GNU General Public License as published by
8    the Free Software Foundation; either version 3 of the License, or
9    (at your option) any later version.
10 
11    This program is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14    GNU General Public License for more details.
15 
16    You should have received a copy of the GNU General Public License
17    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
18 
19 #ifndef REMOTE_H
20 #define REMOTE_H
21 
22 #include "remote-notif.h"
23 
24 struct target_desc;
25 
26 /* Read a packet from the remote machine, with error checking, and
27    store it in *BUF.  Resize *BUF using xrealloc if necessary to hold
28    the result, and update *SIZEOF_BUF.  If FOREVER, wait forever
29    rather than timing out; this is used (in synchronous mode) to wait
30    for a target that is is executing user code to stop.  */
31 
32 extern void getpkt (char **buf, long *sizeof_buf, int forever);
33 
34 /* Send a packet to the remote machine, with error checking.  The data
35    of the packet is in BUF.  The string in BUF can be at most PBUFSIZ
36    - 5 to account for the $, # and checksum, and for a possible /0 if
37    we are debugging (remote_debug) and want to print the sent packet
38    as a string.  */
39 
40 extern int putpkt (char *buf);
41 
42 extern int hex2bin (const char *hex, gdb_byte *bin, int count);
43 
44 extern int bin2hex (const gdb_byte *bin, char *hex, int count);
45 
46 extern char *unpack_varlen_hex (char *buff, ULONGEST *result);
47 
48 extern void async_remote_interrupt_twice (void *arg);
49 
50 void register_remote_g_packet_guess (struct gdbarch *gdbarch, int bytes,
51 				     const struct target_desc *tdesc);
52 void register_remote_support_xml (const char *);
53 
54 void remote_file_put (const char *local_file, const char *remote_file,
55 		      int from_tty);
56 void remote_file_get (const char *remote_file, const char *local_file,
57 		      int from_tty);
58 void remote_file_delete (const char *remote_file, int from_tty);
59 
60 bfd *remote_bfd_open (const char *remote_file, const char *target);
61 
62 int remote_filename_p (const char *filename);
63 
64 extern int remote_register_number_and_offset (struct gdbarch *gdbarch,
65 					      int regnum, int *pnum,
66 					      int *poffset);
67 
68 extern void remote_notif_get_pending_events (struct notif_client *np);
69 #endif
70