gdb/exec.h

   1 /* Work with executable files, for GDB, the GNU debugger.
   2
   3    Copyright (C) 2003, 2007, 2008, 2009 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 EXEC_H
  21 #define EXEC_H
  22
  23 #include "target.h"
  24
  25 struct target_section;
  26 struct target_ops;
  27 struct bfd;
  28
  29 extern struct target_ops exec_ops;
  30
  31 /* Builds a section table, given args BFD, SECTABLE_PTR, SECEND_PTR.
  32    Returns 0 if OK, 1 on error.  */
  33
  34 extern int build_section_table (struct bfd *, struct target_section **,
  35                                 struct target_section **);
  36
  37 /* Resize the section table held by TABLE, by NUM_ADDED.  Returns the
  38    old size.  */
  39
  40 extern int resize_section_table (struct target_section_table *, int);
  41
  42 /* Request to transfer up to LEN 8-bit bytes of the target sections
  43    defined by SECTIONS and SECTIONS_END.  The OFFSET specifies the
  44    starting address.
  45
  46    Return the number of bytes actually transfered, or non-positive
  47    when no data is available for the requested range.
  48
  49    This function is intended to be used from target_xfer_partial
  50    implementations.  See target_read and target_write for more
  51    information.
  52
  53    One, and only one, of readbuf or writebuf must be non-NULL.  */
  54
  55 extern int section_table_xfer_memory_partial (gdb_byte *, const gdb_byte *,
  56                                               ULONGEST, LONGEST,
  57                                               struct target_section *,
  58                                               struct target_section *,
  59                                               const char *);
  60
  61 /* Set the loaded address of a section.  */
  62 extern void exec_set_section_address (const char *, int, CORE_ADDR);
  63
  64 /* Remove all target sections taken from ABFD.  */
  65
  66 extern void remove_target_sections (bfd *abfd);
  67
  68 /* Add the sections array defined by [SECTIONS..SECTIONS_END[ to the
  69    current set of target sections.  */
  70
  71 extern void add_target_sections (struct target_section *sections,
  72                                  struct target_section *sections_end);
  73
  74 /* Prints info about all sections defined in the TABLE.  ABFD is
  75    special cased --- it's filename is omitted; if it is the executable
  76    file, its entry point is printed.  */
  77
  78 extern void print_section_info (struct target_section_table *table,
  79                                 bfd *abfd);
  80
  81
  82 #endif