build_section_table cannot fail

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

diff --git a/gdb/exec.h b/gdb/exec.h
index e50a3a0f49a9ac7fdc8c67c9dc4dc7cd3c8516e0..75177dda96a6942d766c4e0ade152ca1dc7f9817 100644 (file)
--- a/gdb/exec.h
+++ b/gdb/exec.h
@@ -34,16 +34,21 @@ struct objfile;
 #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.  */
+/* Builds a section table, given args BFD.  */
 
-extern int build_section_table (struct bfd *, struct target_section **,
-                               struct target_section **);
+extern target_section_table build_section_table (struct bfd *);
 
 /* Remove all entries from TABLE.  */
 
 extern void clear_section_table (struct target_section_table *table);
 
+/* 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.  */
+
+extern void exec_on_vfork ();
+
 /* 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
@@ -58,8 +63,13 @@ extern enum target_xfer_status
    Request to transfer up to LEN 8-bit bytes of the target sections
    defined by SECTIONS and SECTIONS_END.  The OFFSET specifies the
    starting address.
-   If SECTION_NAME is not NULL, only access sections with that same
-   name.
+
+   The MATCH_CB predicate is optional; when provided it will be called
+   for each section under consideration.  When MATCH_CB evaluates as
+   true, the section remains under consideration; a false result
+   removes it from consideration for performing the memory transfers
+   noted above.  See memory_xfer_partial_1() in target.c for an
+   example.
 
    Return the number of bytes actually transfered, or zero when no
    data is available for the requested range.
@@ -74,9 +84,10 @@ 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 *);
+                                    const target_section_table &,
+                                    gdb::function_view<bool
+                                      (const struct target_section *)> match_cb
+                                        = nullptr);
 
 /* Read from mappable read-only sections of BFD executable files.
    Similar to exec_read_partial_read_only, but return
@@ -97,8 +108,7 @@ extern void remove_target_sections (void *owner);
    current set of target sections.  */
 
 extern void add_target_sections (void *owner,
-                                struct target_section *sections,
-                                struct target_section *sections_end);
+                                const target_section_table &sections);
 
 /* Add the sections of OBJFILE to the current set of target sections.
  * OBJFILE owns the new target sections.  */