gdb/remote.h

   1 /* Remote target communications for serial-line targets in custom GDB protocol
   2    Copyright (C) 1999, 2003, 2004, 2005, 2006 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 2 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, write to the Free Software
  18    Foundation, Inc., 51 Franklin Street, Fifth Floor,
  19    Boston, MA 02110-1301, USA.  */
  20
  21 #ifndef REMOTE_H
  22 #define REMOTE_H
  23
  24 /* FIXME?: move this interface down to tgt vector) */
  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 /* Send HEX encoded string to the target console. (gdb_stdtarg) */
  43
  44 extern void remote_console_output (char *);
  45
  46
  47 /* FIXME: cagney/1999-09-20: The remote cisco stuff in remote.c needs
  48    to be broken out into a separate file (remote-cisco.[hc]?).  Before
  49    that can happen, a remote protocol stack framework needs to be
  50    implemented. */
  51
  52 extern void remote_cisco_objfile_relocate (bfd_signed_vma text_off,
  53                                            bfd_signed_vma data_off,
  54                                            bfd_signed_vma bss_off);
  55
  56 extern void async_remote_interrupt_twice (void *arg);
  57
  58 extern int remote_write_bytes (CORE_ADDR memaddr, const gdb_byte *myaddr,
  59                                int len);
  60
  61 extern int remote_read_bytes (CORE_ADDR memaddr, gdb_byte *myaddr, int len);
  62
  63 extern void (*deprecated_target_resume_hook) (void);
  64 extern void (*deprecated_target_wait_loop_hook) (void);
  65
  66 #endif