contrib/gdb-7/gdb/exec.h

   1 /* Work with executable files, for GDB, the GNU debugger.
   2
   3    Copyright (C) 2003, 2007, 2008, 2009, 2010, 2011
   4    Free Software Foundation, Inc.
   5
   6    This file is part of GDB.
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 3 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  20
  21 #ifndef EXEC_H
  22 #define EXEC_H
  23
  24 #include "target.h"
  25 #include "progspace.h"
  26 #include "memrange.h"
  27
  28 struct target_section;
  29 struct target_ops;
  30 struct bfd;
  31
  32 extern struct target_ops exec_ops;
  33
  34 #define exec_bfd current_program_space->ebfd
  35 #define exec_bfd_mtime current_program_space->ebfd_mtime
  36
  37 /* Builds a section table, given args BFD, SECTABLE_PTR, SECEND_PTR.
  38    Returns 0 if OK, 1 on error.  */
  39
  40 extern int build_section_table (struct bfd *, struct target_section **,
  41                                 struct target_section **);
  42
  43 /* Resize the section table held by TABLE, by NUM_ADDED.  Returns the
  44    old size.  */
  45
  46 extern int resize_section_table (struct target_section_table *, int);
  47
  48 /* Appends all read-only memory ranges found in the target section
  49    table defined by SECTIONS and SECTIONS_END, starting at (and
  50    intersected with) MEMADDR for LEN bytes.  Returns the augmented
  51    VEC.  */
  52
  53 extern VEC(mem_range_s) *
  54   section_table_available_memory (VEC(mem_range_s) *ranges,
  55                                   CORE_ADDR memaddr, ULONGEST len,
  56                                   struct target_section *sections,
  57                                   struct target_section *sections_end);
  58
  59 /* Read or write from mappable sections of BFD executable files.
  60
  61    Request to transfer up to LEN 8-bit bytes of the target sections
  62    defined by SECTIONS and SECTIONS_END.  The OFFSET specifies the
  63    starting address.
  64    If SECTION_NAME is not NULL, only access sections with that same
  65    name.
  66
  67    Return the number of bytes actually transfered, or zero when no
  68    data is available for the requested range.
  69
  70    This function is intended to be used from target_xfer_partial
  71    implementations.  See target_read and target_write for more
  72    information.
  73
  74    One, and only one, of readbuf or writebuf must be non-NULL.  */
  75
  76 extern int section_table_xfer_memory_partial (gdb_byte *, const gdb_byte *,
  77                                               ULONGEST, LONGEST,
  78                                               struct target_section *,
  79                                               struct target_section *,
  80                                               const char *);
  81
  82 /* Set the loaded address of a section.  */
  83 extern void exec_set_section_address (const char *, int, CORE_ADDR);
  84
  85 /* Remove all target sections taken from ABFD.  */
  86
  87 extern void remove_target_sections (bfd *abfd);
  88
  89 /* Add the sections array defined by [SECTIONS..SECTIONS_END[ to the
  90    current set of target sections.  */
  91
  92 extern void add_target_sections (struct target_section *sections,
  93                                  struct target_section *sections_end);
  94
  95 /* Prints info about all sections defined in the TABLE.  ABFD is
  96    special cased --- it's filename is omitted; if it is the executable
  97    file, its entry point is printed.  */
  98
  99 extern void print_section_info (struct target_section_table *table,
 100                                 bfd *abfd);
 101
 102 extern void exec_close (void);
 103
 104 #endif