Mon Jul 3 13:55:18 1995 Steve Chamberlain <sac@slash.cygnus.com>
[deliverable/binutils-gdb.git] / bfd / opncls.c
index 3acc1fd844366d3bc1b96c93aec873661189f9cb..b28d6b0b535a70a049035de8ff86a6b0d965162a 100644 (file)
@@ -1,5 +1,5 @@
 /* opncls.c -- open and close a BFD.
-   Copyright (C) 1990-1991 Free Software Foundation, Inc.
+   Copyright (C) 1990 91, 92, 93, 94 Free Software Foundation, Inc.
    Written by Cygnus Support.
 
 This file is part of BFD, the Binary File Descriptor library.
@@ -18,34 +18,48 @@ You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
 
-/* $Id$ */
-
 #include "bfd.h"
 #include "sysdep.h"
 #include "libbfd.h"
 #include "obstack.h"
-extern void bfd_cache_init();
-FILE *bfd_open_file();
+
+#ifndef S_IXUSR
+#define S_IXUSR 0100   /* Execute by owner.  */
+#endif
+#ifndef S_IXGRP
+#define S_IXGRP 0010   /* Execute by group.  */
+#endif
+#ifndef S_IXOTH
+#define S_IXOTH 0001   /* Execute by others.  */
+#endif
 
 /* fdopen is a loser -- we should use stdio exclusively.  Unfortunately
    if we do that we can't use fcntl.  */
 
 
-#define obstack_chunk_alloc bfd_xmalloc
+#define obstack_chunk_alloc malloc
 #define obstack_chunk_free free
 
 /* Return a new BFD.  All BFD's are allocated through this routine.  */
 
-bfd *new_bfd()
+bfd *
+_bfd_new_bfd ()
 {
   bfd *nbfd;
 
-  nbfd = (bfd *)zalloc (sizeof (bfd));
+  nbfd = (bfd *)bfd_zmalloc (sizeof (bfd));
   if (!nbfd)
-    return 0;
+    {
+      bfd_set_error (bfd_error_no_memory);
+      return 0;
+    }
 
   bfd_check_init();
-  obstack_begin((PTR)&nbfd->memory, 128);
+  if (!obstack_begin(&nbfd->memory, 128))
+    {
+      bfd_set_error (bfd_error_no_memory);
+      return 0;
+    }
 
   nbfd->arch_info = &bfd_default_arch_struct;
 
@@ -55,36 +69,37 @@ bfd *new_bfd()
   nbfd->sections = (asection *)NULL;
   nbfd->format = bfd_unknown;
   nbfd->my_archive = (bfd *)NULL;
-  nbfd->origin = 0;                               
+  nbfd->origin = 0;                            
   nbfd->opened_once = false;
   nbfd->output_has_begun = false;
   nbfd->section_count = 0;
   nbfd->usrdata = (PTR)NULL;
-  nbfd->sections = (asection *)NULL;
   nbfd->cacheable = false;
   nbfd->flags = NO_FLAGS;
   nbfd->mtime_set = false;
 
-  
   return nbfd;
 }
 
 /* Allocate a new BFD as a member of archive OBFD.  */
 
-bfd *new_bfd_contained_in(obfd)
-bfd *obfd;
+bfd *
+_bfd_new_bfd_contained_in (obfd)
+     bfd *obfd;
 {
-       bfd *nbfd = new_bfd();
-       nbfd->xvec = obfd->xvec;
-       nbfd->my_archive = obfd;
-       nbfd->direction = read_direction;
-       nbfd->target_defaulted = obfd->target_defaulted;
-       return nbfd;
+  bfd *nbfd;
+
+  nbfd = _bfd_new_bfd();
+  nbfd->xvec = obfd->xvec;
+  nbfd->my_archive = obfd;
+  nbfd->direction = read_direction;
+  nbfd->target_defaulted = obfd->target_defaulted;
+  return nbfd;
 }
 
 /*
 SECTION
-       Opening and Closing BFDs
+       Opening and closing BFDs
 
 */
 
@@ -93,41 +108,44 @@ FUNCTION
        bfd_openr
 
 SYNOPSIS
-        bfd *bfd_openr(CONST char *filename, CONST char*target);
+        bfd *bfd_openr(CONST char *filename, CONST char *target);
 
 DESCRIPTION
-       This function opens the file supplied (using <<fopen>>) with the target
-       supplied, it returns a pointer to the created BFD.
+       Open the file @var{filename} (using <<fopen>>) with the target
+       @var{target}.  Return a pointer to the created BFD.
+
+       Calls <<bfd_find_target>>, so @var{target} is interpreted as by
+       that function.
 
-       If NULL is returned then an error has occured. Possible errors
-       are <<no_memory>>, <<invalid_target>> or <<system_call>> error.
+       If <<NULL>> is returned then an error has occured.   Possible errors
+       are <<bfd_error_no_memory>>, <<bfd_error_invalid_target>> or <<system_call>> error.
 */
 
 bfd *
-DEFUN(bfd_openr, (filename, target),
-      CONST char *filename AND
-      CONST char *target)
+bfd_openr (filename, target)
+     CONST char *filename;
+     CONST char *target;
 {
   bfd *nbfd;
-  bfd_target *target_vec;
+  const bfd_target *target_vec;
 
-  nbfd = new_bfd();
+  nbfd = _bfd_new_bfd();
   if (nbfd == NULL) {
-    bfd_error = no_memory;
+    bfd_set_error (bfd_error_no_memory);
     return NULL;
   }
 
   target_vec = bfd_find_target (target, nbfd);
   if (target_vec == NULL) {
-    bfd_error = invalid_target;
+    bfd_set_error (bfd_error_invalid_target);
     return NULL;
   }
 
   nbfd->filename = filename;
-  nbfd->direction = read_direction; 
+  nbfd->direction = read_direction;
 
   if (bfd_open_file (nbfd) == NULL) {
-    bfd_error = system_call_error;     /* File didn't exist, or some such */
+    bfd_set_error (bfd_error_system_call);     /* File didn't exist, or some such */
     bfd_release(nbfd,0);
     return NULL;
   }
@@ -151,26 +169,36 @@ SYNOPSIS
          bfd *bfd_fdopenr(CONST char *filename, CONST char *target, int fd);
 
 DESCRIPTION
-         bfd_fdopenr is to bfd_fopenr much like  fdopen is to fopen.
+         <<bfd_fdopenr>> is to <<bfd_fopenr>> much like <<fdopen>> is to <<fopen>>.
         It opens a BFD on a file already described by the @var{fd}
-        supplied. 
+        supplied.
 
-         Possible errors are no_memory, invalid_target and system_call
-        error.
+        When the file is later <<bfd_close>>d, the file descriptor will be closed.
+
+        If the caller desires that this file descriptor be cached by BFD
+        (opened as needed, closed as needed to free 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 cacheing; the file descriptor will remain open until
+        <<bfd_close>>, and will not be affected by BFD operations on other
+        files.
+
+         Possible errors are <<bfd_error_no_memory>>, <<bfd_error_invalid_target>> and <<bfd_error_system_call>>.
 */
 
 bfd *
-DEFUN(bfd_fdopenr,(filename, target, fd),
-      CONST char *filename AND
-      CONST char *target AND
-      int fd)
+bfd_fdopenr (filename, target, fd)
+     CONST char *filename;
+     CONST char *target;
+     int fd;
 {
   bfd *nbfd;
-  bfd_target *target_vec;
+  const bfd_target *target_vec;
   int fdflags;
 
-  bfd_error = system_call_error;
-  
+  bfd_set_error (bfd_error_system_call);
+
 #ifdef NO_FCNTL
   fdflags = O_RDWR;                    /* Assume full access */
 #else
@@ -178,30 +206,34 @@ DEFUN(bfd_fdopenr,(filename, target, fd),
 #endif
   if (fdflags == -1) return NULL;
 
-  nbfd = new_bfd();
+  nbfd = _bfd_new_bfd();
 
   if (nbfd == NULL) {
-    bfd_error = no_memory;
+    bfd_set_error (bfd_error_no_memory);
     return NULL;
   }
 
   target_vec = bfd_find_target (target, nbfd);
   if (target_vec == NULL) {
-    bfd_error = invalid_target;
+    bfd_set_error (bfd_error_invalid_target);
     return NULL;
   }
-
-#ifdef FASCIST_FDOPEN
-  nbfd->iostream = (char *) fdopen (fd, FOPEN_RB); 
+#if defined(VMS) || defined(__GO32__) || defined (WIN32)
+  nbfd->iostream = (char *)fopen(filename, FOPEN_RB);
 #else
-  /* if the fd were open for read only, this still would not hurt: */
-  nbfd->iostream = (char *) fdopen (fd, FOPEN_RUB); 
+  /* (O_ACCMODE) parens are to avoid Ultrix header file bug */
+  switch (fdflags & (O_ACCMODE)) {
+  case O_RDONLY: nbfd->iostream = (char *) fdopen (fd, FOPEN_RB);   break;
+  case O_WRONLY: nbfd->iostream = (char *) fdopen (fd, FOPEN_RUB);  break;
+  case O_RDWR:   nbfd->iostream = (char *) fdopen (fd, FOPEN_RUB);  break;
+  default: abort ();
+  }
 #endif
   if (nbfd->iostream == NULL) {
     (void) obstack_free (&nbfd->memory, (PTR)0);
     return NULL;
   }
-  
+
   /* OK, put everything where it belongs */
 
   nbfd->filename = filename;
@@ -212,12 +244,59 @@ DEFUN(bfd_fdopenr,(filename, target, fd),
   /* (O_ACCMODE) parens are to avoid Ultrix header file bug */
   switch (fdflags & (O_ACCMODE)) {
   case O_RDONLY: nbfd->direction = read_direction; break;
-  case O_WRONLY: nbfd->direction = write_direction; break;  
+  case O_WRONLY: nbfd->direction = write_direction; break;
   case O_RDWR: nbfd->direction = both_direction; break;
   default: abort ();
   }
-                                  
-  bfd_cache_init (nbfd);
+                               
+  if (! bfd_cache_init (nbfd))
+    return NULL;
+
+  return nbfd;
+}
+
+/*
+FUNCTION
+       bfd_openstreamr
+
+SYNOPSIS
+       bfd *bfd_openstreamr();
+
+DESCRIPTION
+
+       Open a BFD for read access on an existing stdio stream.  When
+       the BFD is passed to <<bfd_close>>, the stream will be closed.
+*/
+
+bfd *
+bfd_openstreamr (filename, target, stream)
+     const char *filename;
+     const char *target;
+     FILE *stream;
+{
+  bfd *nbfd;
+  const bfd_target *target_vec;
+
+  nbfd = _bfd_new_bfd ();
+  if (nbfd == NULL)
+    {
+      bfd_set_error (bfd_error_no_memory);
+      return NULL;
+    }
+
+  target_vec = bfd_find_target (target, nbfd);
+  if (target_vec == NULL)
+    {
+      bfd_set_error (bfd_error_invalid_target);
+      return NULL;
+    }
+
+  nbfd->iostream = (char *) stream;
+  nbfd->filename = filename;
+  nbfd->direction = read_direction;
+                               
+  if (! bfd_cache_init (nbfd))
+    return NULL;
 
   return nbfd;
 }
@@ -235,29 +314,29 @@ SYNOPSIS
        bfd *bfd_openw(CONST char *filename, CONST char *target);
 
 DESCRIPTION
-       Creates a BFD, associated with file @var{filename}, using the
-       file format @var{target}, and returns a pointer to it.
+       Create a BFD, associated with file @var{filename}, using the
+       file format @var{target}, and return a pointer to it.
 
-       Possible errors are system_call_error, no_memory,
-       invalid_target. 
+       Possible errors are <<bfd_error_system_call>>, <<bfd_error_no_memory>>,
+       <<bfd_error_invalid_target>>.
 */
 
 bfd *
-DEFUN(bfd_openw,(filename, target),
-      CONST char *filename AND
-      CONST char *target)
+bfd_openw (filename, target)
+     CONST char *filename;
+     CONST char *target;
 {
   bfd *nbfd;
-  bfd_target *target_vec;
-  
-  bfd_error = system_call_error;
+  const bfd_target *target_vec;
+
+  bfd_set_error (bfd_error_system_call);
 
   /* nbfd has to point to head of malloc'ed block so that bfd_close may
      reclaim it correctly. */
 
-  nbfd = new_bfd();
+  nbfd = _bfd_new_bfd();
   if (nbfd == NULL) {
-    bfd_error = no_memory;
+    bfd_set_error (bfd_error_no_memory);
     return NULL;
   }
 
@@ -268,7 +347,7 @@ DEFUN(bfd_openw,(filename, target),
   nbfd->direction = write_direction;
 
   if (bfd_open_file (nbfd) == NULL) {
-    bfd_error = system_call_error;     /* File not writeable, etc */
+    bfd_set_error (bfd_error_system_call);     /* File not writeable, etc */
     (void) obstack_free (&nbfd->memory, (PTR)0);
     return NULL;
   }
@@ -281,16 +360,19 @@ FUNCTION
        bfd_close
 
 SYNOPSIS
-       boolean bfd_close(bfd *);
+       boolean bfd_close(bfd *abfd);
 
 DESCRIPTION
 
-       This function closes a BFD. If the BFD was open for writing,
+       Close a BFD. If the BFD was open for writing,
        then pending operations are completed and the file written out
        and closed. If the created file is executable, then
        <<chmod>> is called to mark it as such.
 
-       All memory attached to the BFD's obstacks is released. 
+       All memory attached to the BFD's obstacks is released.
+
+       The file descriptor associated with the BFD is closed (even
+       if it was passed in to BFD by <<bfd_fdopenr>>).
 
 RETURNS
        <<true>> is returned if all is ok, otherwise <<false>>.
@@ -298,38 +380,44 @@ RETURNS
 
 
 boolean
-DEFUN(bfd_close,(abfd),
-      bfd *abfd)
+bfd_close (abfd)
+     bfd *abfd;
 {
-  if (!bfd_read_p(abfd))
-    if (BFD_SEND_FMT (abfd, _bfd_write_contents, (abfd)) != true)
-      return false;
+  boolean ret;
+
+  if (!bfd_read_p (abfd))
+    {
+      if (! BFD_SEND_FMT (abfd, _bfd_write_contents, (abfd)))
+       return false;
+    }
 
-  if (BFD_SEND (abfd, _close_and_cleanup, (abfd)) != true) return false;
+  if (! BFD_SEND (abfd, _close_and_cleanup, (abfd)))
+    return false;
 
-  bfd_cache_close(abfd);
+  ret = bfd_cache_close (abfd);
 
   /* If the file was open for writing and is now executable,
      make it so */
-  if (abfd->direction == write_direction 
-      && abfd->flags & EXEC_P) {
-    struct stat buf;
-    stat(abfd->filename, &buf);
-#ifndef S_IXUSR
-#define S_IXUSR 0100   /* Execute by owner.  */
-#endif
-#ifndef S_IXGRP
-#define S_IXGRP 0010   /* Execute by group.  */
-#endif
-#ifndef S_IXOTH
-#define S_IXOTH 0001   /* Execute by others.  */
-#endif
+  if (ret
+      && abfd->direction == write_direction
+      && abfd->flags & EXEC_P)
+    {
+      struct stat buf;
+
+      if (stat (abfd->filename, &buf) == 0)
+       {
+         int mask = umask (0);
+         umask (mask);
+         chmod (abfd->filename,
+                (0777
+                 & (buf.st_mode | ((S_IXUSR | S_IXGRP | S_IXOTH) &~ mask))));
+       }
+    }
 
-    chmod(abfd->filename, 0777  & (buf.st_mode | S_IXUSR | S_IXGRP | S_IXOTH));
-  }
   (void) obstack_free (&abfd->memory, (PTR)0);
-  (void) free(abfd);
-  return true;
+  (void) free (abfd);
+
+  return ret;
 }
 
 /*
@@ -340,7 +428,7 @@ SYNOPSIS
        boolean bfd_close_all_done(bfd *);
 
 DESCRIPTION
-       This function closes a BFD. It differs from <<bfd_close>>
+       Close a BFD.  Differs from <<bfd_close>>
        since it does not complete any pending operations.  This
        routine would be used if the application had just used BFD for
        swapping and didn't want to use any of the writing code.
@@ -348,7 +436,7 @@ DESCRIPTION
        If the created file is executable, then <<chmod>> is called
        to mark it as such.
 
-       All memory attached to the BFD's obstacks is released. 
+       All memory attached to the BFD's obstacks is released.
 
 RETURNS
        <<true>> is returned if all is ok, otherwise <<false>>.
@@ -356,32 +444,33 @@ RETURNS
 */
 
 boolean
-DEFUN(bfd_close_all_done,(abfd),
-      bfd *abfd)
+bfd_close_all_done (abfd)
+     bfd *abfd;
 {
-  bfd_cache_close(abfd);
+  boolean ret;
+
+  ret = bfd_cache_close (abfd);
 
   /* If the file was open for writing and is now executable,
      make it so */
-  if (abfd->direction == write_direction 
-      && abfd->flags & EXEC_P) {
-    struct stat buf;
-    stat(abfd->filename, &buf);
-#ifndef S_IXUSR
-#define S_IXUSR 0100   /* Execute by owner.  */
-#endif
-#ifndef S_IXGRP
-#define S_IXGRP 0010   /* Execute by group.  */
-#endif
-#ifndef S_IXOTH
-#define S_IXOTH 0001   /* Execute by others.  */
-#endif
-
-    chmod(abfd->filename, 0x777 &(buf.st_mode | S_IXUSR | S_IXGRP | S_IXOTH));
-  }
+  if (ret
+      && abfd->direction == write_direction
+      && abfd->flags & EXEC_P)
+    {
+      struct stat buf;
+
+      if (stat (abfd->filename, &buf) == 0)
+       {
+         int mask = umask (0);
+         umask (mask);
+         chmod (abfd->filename,
+                (0x777
+                 & (buf.st_mode | ((S_IXUSR | S_IXGRP | S_IXOTH) &~ mask))));
+       }
+    }
   (void) obstack_free (&abfd->memory, (PTR)0);
   (void) free(abfd);
-  return true;
+  return ret;
 }
 
 
@@ -393,14 +482,13 @@ SYNOPSIS
        bfd_size_type bfd_alloc_size(bfd *abfd);
 
 DESCRIPTION
-        Return the number of bytes in the obstacks connected to the
-       supplied BFD.
+        Return the number of bytes in the obstacks connected to @var{abfd}.
 
 */
 
 bfd_size_type
-DEFUN(bfd_alloc_size,(abfd),
-      bfd *abfd)
+bfd_alloc_size (abfd)
+     bfd *abfd;
 {
   struct _obstack_chunk *chunk = abfd->memory.chunk;
   size_t size = 0;
@@ -418,36 +506,36 @@ FUNCTION
        bfd_create
 
 SYNOPSIS
-       bfd *bfd_create(CONST char *filename, bfd *template);
+       bfd *bfd_create(CONST char *filename, bfd *templ);
 
 DESCRIPTION
-       This routine creates a new BFD in the manner of
+       Create a new BFD in the manner of
        <<bfd_openw>>, but without opening a file. The new BFD
        takes the target from the target used by @var{template}. The
-       format is always set to <<bfd_object>>. 
+       format is always set to <<bfd_object>>.
 
 */
 
 bfd *
-DEFUN(bfd_create,(filename, template),
-      CONST char *filename AND
-      bfd *template)
+bfd_create (filename, templ)
+     CONST char *filename;
+     bfd *templ;
 {
-  bfd *nbfd = new_bfd();
+  bfd *nbfd = _bfd_new_bfd();
   if (nbfd == (bfd *)NULL) {
-    bfd_error = no_memory;
+    bfd_set_error (bfd_error_no_memory);
     return (bfd *)NULL;
   }
   nbfd->filename = filename;
-  if(template) {
-    nbfd->xvec = template->xvec;
+  if(templ) {
+    nbfd->xvec = templ->xvec;
   }
   nbfd->direction = no_direction;
   bfd_set_format(nbfd, bfd_object);
   return nbfd;
 }
 
-/* 
+/*
 INTERNAL_FUNCTION
        bfd_alloc_by_size_t
 
@@ -455,65 +543,51 @@ SYNOPSIS
        PTR bfd_alloc_by_size_t(bfd *abfd, size_t wanted);
 
 DESCRIPTION
-       This function allocates a block of memory in the obstack
-       attatched to <<abfd>> and returns a pointer to it.
+       Allocate a block of @var{wanted} bytes of memory in the obstack
+       attatched to <<abfd>> and return a pointer to it.
 */
 
 
-PTR 
-DEFUN(bfd_alloc_by_size_t,(abfd, size),
-      bfd *abfd AND
-      size_t size)
+PTR
+bfd_alloc_by_size_t (abfd, size)
+     bfd *abfd;
+     size_t size;
 {
-  PTR res = obstack_alloc(&(abfd->memory), size);
-  return res;
+  return obstack_alloc(&(abfd->memory), size);
 }
 
-DEFUN(void bfd_alloc_grow,(abfd, ptr, size),
-      bfd *abfd AND
-      PTR ptr AND
-      bfd_size_type size)
+void
+bfd_alloc_grow (abfd, ptr, size)
+     bfd *abfd;
+     PTR ptr;
+     size_t size;
 {
-  (void)   obstack_grow(&(abfd->memory), ptr, size);
+  (void) obstack_grow(&(abfd->memory), ptr, size);
 }
-DEFUN(PTR bfd_alloc_finish,(abfd),
-      bfd *abfd)
+
+PTR
+bfd_alloc_finish (abfd)
+     bfd *abfd;
 {
   return obstack_finish(&(abfd->memory));
 }
 
-DEFUN(PTR bfd_alloc, (abfd, size),
-      bfd *abfd AND
-      bfd_size_type size)
+PTR
+bfd_alloc (abfd, size)
+     bfd *abfd;
+     size_t size;
 {
   return bfd_alloc_by_size_t(abfd, (size_t)size);
 }
 
-DEFUN(PTR bfd_zalloc,(abfd, size),
-      bfd *abfd AND
-      bfd_size_type size)
+PTR
+bfd_zalloc (abfd, size)
+     bfd *abfd;
+     size_t size;
 {
-  PTR res = bfd_alloc(abfd, size);
-  memset(res, 0, (size_t)size);
+  PTR res;
+  res = bfd_alloc(abfd, size);
+  if (res)
+    memset(res, 0, (size_t)size);
   return res;
 }
-
-DEFUN(PTR bfd_realloc,(abfd, old, size),
-      bfd *abfd AND
-      PTR old AND
-      bfd_size_type size)
-{
-  PTR res = bfd_alloc(abfd, size);
-  memcpy(res, old, (size_t)size);
-  return res;
-}
-
-
-
-
-
-
-
-
-
-
This page took 0.03051 seconds and 4 git commands to generate.