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 struct target_desc;
  25
  26 /* FIXME?: move this interface down to tgt vector) */
  27
  28 /* Read a packet from the remote machine, with error checking, and
  29    store it in *BUF.  Resize *BUF using xrealloc if necessary to hold
  30    the result, and update *SIZEOF_BUF.  If FOREVER, wait forever
  31    rather than timing out; this is used (in synchronous mode) to wait
  32    for a target that is is executing user code to stop.  */
  33
  34 extern void getpkt (char **buf, long *sizeof_buf, int forever);
  35
  36 /* Send a packet to the remote machine, with error checking.  The data
  37    of the packet is in BUF.  The string in BUF can be at most PBUFSIZ
  38    - 5 to account for the $, # and checksum, and for a possible /0 if
  39    we are debugging (remote_debug) and want to print the sent packet
  40    as a string */
  41
  42 extern int putpkt (char *buf);
  43
  44 /* Send HEX encoded string to the target console. (gdb_stdtarg) */
  45
  46 extern void remote_console_output (char *);
  47
  48
  49 /* FIXME: cagney/1999-09-20: The remote cisco stuff in remote.c needs
  50    to be broken out into a separate file (remote-cisco.[hc]?).  Before
  51    that can happen, a remote protocol stack framework needs to be
  52    implemented. */
  53
  54 extern void remote_cisco_objfile_relocate (bfd_signed_vma text_off,
  55                                            bfd_signed_vma data_off,
  56                                            bfd_signed_vma bss_off);
  57
  58 extern void async_remote_interrupt_twice (void *arg);
  59
  60 extern int remote_write_bytes (CORE_ADDR memaddr, const gdb_byte *myaddr,
  61                                int len);
  62
  63 extern int remote_read_bytes (CORE_ADDR memaddr, gdb_byte *myaddr, int len);
  64
  65 extern void (*deprecated_target_resume_hook) (void);
  66 extern void (*deprecated_target_wait_loop_hook) (void);
  67
  68 void register_remote_g_packet_guess (struct gdbarch *gdbarch, int bytes,
  69                                      const struct target_desc *tdesc);
  70
  71 #endif