gdb/exec.h

   1 /* Work with executable files, for GDB, the GNU debugger.
   2
   3    Copyright (C) 2003-2021 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 #include "progspace.h"
  25 #include "memrange.h"
  26 #include "symfile-add-flags.h"
  27
  28 struct target_section;
  29 struct target_ops;
  30 struct bfd;
  31 struct objfile;
  32
  33 /* Builds a section table, given args BFD.  */
  34
  35 extern target_section_table build_section_table (struct bfd *);
  36
  37 /* The current inferior is a child vforked and its program space is
  38    shared with its parent.  This pushes the exec target on the
  39    current/child inferior's target stack if there are sections in the
  40    program space's section table.  */
  41
  42 extern void exec_on_vfork ();
  43
  44 /* Read from mappable read-only sections of BFD executable files.
  45    Return TARGET_XFER_OK, if read is successful.  Return
  46    TARGET_XFER_EOF if read is done.  Return TARGET_XFER_E_IO
  47    otherwise.  */
  48
  49 extern enum target_xfer_status
  50   exec_read_partial_read_only (gdb_byte *readbuf, ULONGEST offset,
  51                                ULONGEST len, ULONGEST *xfered_len);
  52
  53 /* Read or write from mappable sections of BFD executable files.
  54
  55    Request to transfer up to LEN 8-bit bytes of the target sections
  56    defined by SECTIONS and SECTIONS_END.  The OFFSET specifies the
  57    starting address.
  58
  59    The MATCH_CB predicate is optional; when provided it will be called
  60    for each section under consideration.  When MATCH_CB evaluates as
  61    true, the section remains under consideration; a false result
  62    removes it from consideration for performing the memory transfers
  63    noted above.  See memory_xfer_partial_1() in target.c for an
  64    example.
  65
  66    Return the number of bytes actually transfered, or zero when no
  67    data is available for the requested range.
  68
  69    This function is intended to be used from target_xfer_partial
  70    implementations.  See target_read and target_write for more
  71    information.
  72
  73    One, and only one, of readbuf or writebuf must be non-NULL.  */
  74
  75 extern enum target_xfer_status
  76   section_table_xfer_memory_partial (gdb_byte *,
  77                                      const gdb_byte *,
  78                                      ULONGEST, ULONGEST, ULONGEST *,
  79                                      const target_section_table &,
  80                                      gdb::function_view<bool
  81                                        (const struct target_section *)> match_cb
  82                                          = nullptr);
  83
  84 /* Read from mappable read-only sections of BFD executable files.
  85    Similar to exec_read_partial_read_only, but return
  86    TARGET_XFER_UNAVAILABLE if data is unavailable.  */
  87
  88 extern enum target_xfer_status
  89   section_table_read_available_memory (gdb_byte *readbuf, ULONGEST offset,
  90                                        ULONGEST len, ULONGEST *xfered_len);
  91
  92 /* Set the loaded address of a section.  */
  93 extern void exec_set_section_address (const char *, int, CORE_ADDR);
  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 (const target_section_table *table,
 100                                 bfd *abfd);
 101
 102 /* Helper function that attempts to open the symbol file at EXEC_FILE_HOST.
 103    If successful, it proceeds to add the symbol file as the main symbol file.
 104
 105    ADD_FLAGS is passed on to the function adding the symbol file.  */
 106 extern void try_open_exec_file (const char *exec_file_host,
 107                                 struct inferior *inf,
 108                                 symfile_add_flags add_flags);
 109 #endif