gdb/remote.h

   1 /* Remote target communications for serial-line targets in custom GDB protocol
   2    Copyright (C) 1999, 2003, 2004, 2005, 2006, 2007, 2008, 2009
   3    Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   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.
  11
  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.
  16
  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/>.  */
  19
  20 #ifndef REMOTE_H
  21 #define REMOTE_H
  22
  23 struct target_desc;
  24
  25 /* FIXME?: move this interface down to tgt vector) */
  26
  27 /* Read a packet from the remote machine, with error checking, and
  28    store it in *BUF.  Resize *BUF using xrealloc if necessary to hold
  29    the result, and update *SIZEOF_BUF.  If FOREVER, wait forever
  30    rather than timing out; this is used (in synchronous mode) to wait
  31    for a target that is is executing user code to stop.  */
  32
  33 extern void getpkt (char **buf, long *sizeof_buf, int forever);
  34
  35 /* Send a packet to the remote machine, with error checking.  The data
  36    of the packet is in BUF.  The string in BUF can be at most PBUFSIZ
  37    - 5 to account for the $, # and checksum, and for a possible /0 if
  38    we are debugging (remote_debug) and want to print the sent packet
  39    as a string */
  40
  41 extern int putpkt (char *buf);
  42
  43 /* Send HEX encoded string to the target console. (gdb_stdtarg) */
  44
  45 extern void remote_console_output (char *);
  46
  47
  48 /* FIXME: cagney/1999-09-20: The remote cisco stuff in remote.c needs
  49    to be broken out into a separate file (remote-cisco.[hc]?).  Before
  50    that can happen, a remote protocol stack framework needs to be
  51    implemented. */
  52
  53 extern void remote_cisco_objfile_relocate (bfd_signed_vma text_off,
  54                                            bfd_signed_vma data_off,
  55                                            bfd_signed_vma bss_off);
  56
  57 extern void async_remote_interrupt_twice (void *arg);
  58
  59 extern int remote_write_bytes (CORE_ADDR memaddr, const gdb_byte *myaddr,
  60                                int len);
  61
  62 extern int remote_read_bytes (CORE_ADDR memaddr, gdb_byte *myaddr, int len);
  63
  64 extern void (*deprecated_target_resume_hook) (void);
  65 extern void (*deprecated_target_wait_loop_hook) (void);
  66
  67 void register_remote_g_packet_guess (struct gdbarch *gdbarch, int bytes,
  68                                      const struct target_desc *tdesc);
  69
  70 void remote_file_put (const char *local_file, const char *remote_file,
  71                       int from_tty);
  72 void remote_file_get (const char *remote_file, const char *local_file,
  73                       int from_tty);
  74 void remote_file_delete (const char *remote_file, int from_tty);
  75
  76 bfd *remote_bfd_open (const char *remote_file, const char *target);
  77
  78 int remote_filename_p (const char *filename);
  79
  80 #endif