Multi-target support

[deliverable/binutils-gdb.git] / gdb / exec.h

diff --git a/gdb/exec.h b/gdb/exec.h
index 89fd1565f7c65224f128de8471250e8411b06d3a..54e6ff4d9bab6c2c6f730b1faaf5a4062e20ce65 100644 (file)
--- a/gdb/exec.h
+++ b/gdb/exec.h
@@ -1,7 +1,6 @@
 /* Work with executable files, for GDB, the GNU debugger.
 
-   Copyright (C) 2003, 2007, 2008, 2009, 2010, 2011
-   Free Software Foundation, Inc.
+   Copyright (C) 2003-2020 Free Software Foundation, Inc.
 
    This file is part of GDB.
 
@@ -24,15 +23,16 @@
 #include "target.h"
 #include "progspace.h"
 #include "memrange.h"
+#include "symfile-add-flags.h"
 
 struct target_section;
 struct target_ops;
 struct bfd;
-
-extern struct target_ops exec_ops;
+struct objfile;
 
 #define exec_bfd current_program_space->ebfd
 #define exec_bfd_mtime current_program_space->ebfd_mtime
+#define exec_filename current_program_space->pspace_exec_filename
 
 /* Builds a section table, given args BFD, SECTABLE_PTR, SECEND_PTR.
    Returns 0 if OK, 1 on error.  */
@@ -40,21 +40,25 @@ extern struct target_ops exec_ops;
 extern int build_section_table (struct bfd *, struct target_section **,
                                struct target_section **);
 
-/* Resize the section table held by TABLE, by NUM_ADDED.  Returns the
-   old size.  */
+/* Remove all entries from TABLE.  */
+
+extern void clear_section_table (struct target_section_table *table);
 
-extern int resize_section_table (struct target_section_table *, int);
+/* The current inferior is a child vforked and its program space is
+   shared with its parent.  This pushes the exec target on the
+   current/child inferior's target stack if there are sections in the
+   program space's section table.  */
 
-/* Appends all read-only memory ranges found in the target section
-   table defined by SECTIONS and SECTIONS_END, starting at (and
-   intersected with) MEMADDR for LEN bytes.  Returns the augmented
-   VEC.  */
+extern void exec_on_vfork ();
 
-extern VEC(mem_range_s) *
-  section_table_available_memory (VEC(mem_range_s) *ranges,
-                                 CORE_ADDR memaddr, ULONGEST len,
-                                 struct target_section *sections,
-                                 struct target_section *sections_end);
+/* Read from mappable read-only sections of BFD executable files.
+   Return TARGET_XFER_OK, if read is successful.  Return
+   TARGET_XFER_EOF if read is done.  Return TARGET_XFER_E_IO
+   otherwise.  */
+
+extern enum target_xfer_status
+  exec_read_partial_read_only (gdb_byte *readbuf, ULONGEST offset,
+                              ULONGEST len, ULONGEST *xfered_len);
 
 /* Read or write from mappable sections of BFD executable files.
 
@@ -73,25 +77,41 @@ extern VEC(mem_range_s) *
 
    One, and only one, of readbuf or writebuf must be non-NULL.  */
 
-extern int section_table_xfer_memory_partial (gdb_byte *, const gdb_byte *,
-                                             ULONGEST, LONGEST,
-                                             struct target_section *,
-                                             struct target_section *,
-                                             const char *);
+extern enum target_xfer_status
+  section_table_xfer_memory_partial (gdb_byte *,
+                                    const gdb_byte *,
+                                    ULONGEST, ULONGEST, ULONGEST *,
+                                    struct target_section *,
+                                    struct target_section *,
+                                    const char *);
+
+/* Read from mappable read-only sections of BFD executable files.
+   Similar to exec_read_partial_read_only, but return
+   TARGET_XFER_UNAVAILABLE if data is unavailable.  */
+
+extern enum target_xfer_status
+  section_table_read_available_memory (gdb_byte *readbuf, ULONGEST offset,
+                                      ULONGEST len, ULONGEST *xfered_len);
 
 /* Set the loaded address of a section.  */
 extern void exec_set_section_address (const char *, int, CORE_ADDR);
 
-/* Remove all target sections taken from ABFD.  */
+/* Remove all target sections owned by OWNER.  */
 
-extern void remove_target_sections (bfd *abfd);
+extern void remove_target_sections (void *owner);
 
 /* Add the sections array defined by [SECTIONS..SECTIONS_END[ to the
    current set of target sections.  */
 
-extern void add_target_sections (struct target_section *sections,
+extern void add_target_sections (void *owner,
+                                struct target_section *sections,
                                 struct target_section *sections_end);
 
+/* Add the sections of OBJFILE to the current set of target sections.
+ * OBJFILE owns the new target sections.  */
+
+extern void add_target_sections_of_objfile (struct objfile *objfile);
+
 /* Prints info about all sections defined in the TABLE.  ABFD is
    special cased --- it's filename is omitted; if it is the executable
    file, its entry point is printed.  */
@@ -101,4 +121,11 @@ extern void print_section_info (struct target_section_table *table,
 
 extern void exec_close (void);
 
+/* Helper function that attempts to open the symbol file at EXEC_FILE_HOST.
+   If successful, it proceeds to add the symbol file as the main symbol file.
+
+   ADD_FLAGS is passed on to the function adding the symbol file.  */
+extern void try_open_exec_file (const char *exec_file_host,
+                               struct inferior *inf,
+                               symfile_add_flags add_flags);
 #endif