Merge GDB 7.5.1

bfd/doc/opncls.texi

 
 @example
 /* Set to N to open the next N BFDs using an alternate id space.  */
 extern unsigned int bfd_use_reserved_id;
 @end example
 @section Opening and closing BFDs
 
 
 @subsection Functions for opening and closing
 
@@ skipping 14 matching lines @@
 
 Calls @code{bfd_find_target}, so @var{target} is interpreted as by
 that function.
 
 The new BFD is marked as cacheable iff @var{fd} is -1.
 
 If @code{NULL} is returned then an error has occured.   Possible errors
 are @code{bfd_error_no_memory}, @code{bfd_error_invalid_target} or
 @code{system_call} error.
 
+On error, @var{fd} is always closed.
+
 @findex bfd_openr
 @subsubsection @code{bfd_openr}
 @strong{Synopsis}
 @example
 bfd *bfd_openr (const char *filename, const char *target);
 @end example
 @strong{Description}@*
 Open the file @var{filename} (using @code{fopen}) with the target
 @var{target}.  Return a pointer to the created BFD.
 
@@ skipping 21 matching lines @@
 descriptors for other opens), with the supplied @var{fd} used as
 an initial file descriptor (but subject to closure at any time),
 call bfd_set_cacheable(bfd, 1) on the returned BFD.  The default
 is to assume no caching; the file descriptor will remain open
 until @code{bfd_close}, and will not be affected by BFD operations
 on other files.
 
 Possible errors are @code{bfd_error_no_memory},
 @code{bfd_error_invalid_target} and @code{bfd_error_system_call}.
 
+On error, @var{fd} is closed.
+
 @findex bfd_openstreamr
 @subsubsection @code{bfd_openstreamr}
 @strong{Synopsis}
 @example
 bfd *bfd_openstreamr (const char *, const char *, void *);
 @end example
 @strong{Description}@*
 Open a BFD for read access on an existing stdio stream.  When
 the BFD is passed to @code{bfd_close}, the stream will be closed.
 
@@ skipping 282 matching lines @@
 @strong{Description}@*
 Takes a @var{BFD} and containing a .gnu_debuglink section @var{SECT}
 and fills in the contents of the section to contain a link to the
 specified @var{filename}.  The filename should be relative to the
 current directory.
 
 @strong{Returns}@*
 @code{TRUE} is returned if all is ok.  Otherwise @code{FALSE} is returned
 and bfd_error is set.