/* Definitions for BFD wrappers used by GDB.
- Copyright (C) 2011-2014 Free Software Foundation, Inc.
+ Copyright (C) 2011-2015 Free Software Foundation, Inc.
This file is part of GDB.
DECLARE_REGISTRY (bfd);
+/* If supplied a path starting with this sequence, gdb_bfd_open will
+ open BFDs using target fileio operations. */
+
+#define TARGET_SYSROOT_PREFIX "target:"
+
+/* Returns nonzero if NAME starts with TARGET_SYSROOT_PREFIX, zero
+ otherwise. */
+
+int is_target_filename (const char *name);
+
+/* Returns nonzero if the filename associated with ABFD starts with
+ TARGET_SYSROOT_PREFIX, zero otherwise. */
+
+int gdb_bfd_has_target_filename (struct bfd *abfd);
+
/* Open a read-only (FOPEN_RB) BFD given arguments like bfd_fopen.
- Returns NULL on error. On success, returns a new reference to the
- BFD, which must be freed with gdb_bfd_unref. BFDs returned by this
- call are shared among all callers opening the same file. If FD is
- not -1, then after this call it is owned by BFD. */
+ If NAME starts with TARGET_SYSROOT_PREFIX then the BFD will be
+ opened using target fileio operations if necessary. Returns NULL
+ on error. On success, returns a new reference to the BFD, which
+ must be freed with gdb_bfd_unref. BFDs returned by this call are
+ shared among all callers opening the same file. If FD is not -1,
+ then after this call it is owned by BFD. If the BFD was not
+ accessed using target fileio operations then the filename
+ associated with the BFD and accessible with bfd_get_filename will
+ not be exactly NAME but rather NAME with TARGET_SYSROOT_PREFIX
+ stripped. */
struct bfd *gdb_bfd_open (const char *name, const char *target, int fd);
void gdb_bfd_mark_parent (bfd *child, bfd *parent);
+/* Mark INCLUDEE as being included by INCLUDER.
+ This is used to associate the life time of INCLUDEE with INCLUDER.
+ For example, with Fission, one file can refer to debug info in another
+ file, and internal tables we build for the main file (INCLUDER) may refer
+ to data contained in INCLUDEE. Therefore we want to keep INCLUDEE around
+ at least as long as INCLUDER exists.
+
+ Note that this is different than gdb_bfd_mark_parent because in our case
+ lifetime tracking is based on the "parent" whereas in gdb_bfd_mark_parent
+ lifetime tracking is based on the "child". Plus in our case INCLUDEE could
+ have multiple different "parents". */
+
+void gdb_bfd_record_inclusion (bfd *includer, bfd *includee);
+
/* Try to read or map the contents of the section SECT. If
successful, the section data is returned and *SIZE is set to the
size of the section data; this may not be the same as the size