* Makefile.in (MAKEOVERRIDES): Define to be empty.
[deliverable/binutils-gdb.git] / bfd / opncls.c
index 63e9c51daed6ea0a1c64708631f140007d175cc6..3acc1fd844366d3bc1b96c93aec873661189f9cb 100644 (file)
@@ -1,61 +1,53 @@
-/* Copyright (C) 1990, 1991 Free Software Foundation, Inc.
+/* opncls.c -- open and close a BFD.
+   Copyright (C) 1990-1991 Free Software Foundation, Inc.
+   Written by Cygnus Support.
 
-This file is part of BFD, the Binary File Diddler.
+This file is part of BFD, the Binary File Descriptor library.
 
-BFD is free software; you can redistribute it and/or modify
+This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 1, or (at your option)
-any later version.
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
 
-BFD is distributed in the hope that it will be useful,
+This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
-along with BFD; see the file COPYING.  If not, write to
-the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */
+along with this program; if not, write to the Free Software
+Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
 
 /* $Id$ */
 
-/*** opncls.c -- open and close a bfd. */
-
-#include "sysdep.h"
 #include "bfd.h"
+#include "sysdep.h"
 #include "libbfd.h"
-
-
+#include "obstack.h"
 extern void bfd_cache_init();
 FILE *bfd_open_file();
 
 /* fdopen is a loser -- we should use stdio exclusively.  Unfortunately
    if we do that we can't use fcntl.  */
-\f
-/** Locking 
-
-   Locking is loosely controlled by the preprocessor variable
-   BFD_LOCKS.  I say loosely because Unix barely understands locking
-   -- at least in BSD it doesn't affect programs which don't
-   explicitly use it!  That is to say it's practically useless, though
-   if everyone uses this library you'll be OK.
-
-   From among the many and varied lock facilities available, (none of
-   which, of course, knows about any other) we use the fcntl locks,
-   because they're Posix.
-
-   The reason that bfd_openr and bfd_fdopenr exist, yet only bfd_openw
-   exists is because of locking.  When we do output, we lock the
-   filename file for output, then open a temporary file which does not
-   actually get its correct filename until closing time.  This is
-   safest, but requires the asymmetry in read and write entry points.
-
-   Perhaps, since unix has so many different kinds of locking anyway,
-   we should use the emacs lock scheme?... */
-\f
+
+
+#define obstack_chunk_alloc bfd_xmalloc
+#define obstack_chunk_free free
+
+/* Return a new BFD.  All BFD's are allocated through this routine.  */
 
 bfd *new_bfd()
 {
-  bfd *nbfd = (bfd *)zalloc(sizeof(bfd));
+  bfd *nbfd;
+
+  nbfd = (bfd *)zalloc (sizeof (bfd));
+  if (!nbfd)
+    return 0;
+
+  bfd_check_init();
+  obstack_begin((PTR)&nbfd->memory, 128);
+
+  nbfd->arch_info = &bfd_default_arch_struct;
 
   nbfd->direction = no_direction;
   nbfd->iostream = NULL;
@@ -67,53 +59,76 @@ bfd *new_bfd()
   nbfd->opened_once = false;
   nbfd->output_has_begun = false;
   nbfd->section_count = 0;
-  nbfd->usrdata = (void *)NULL;
+  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 *nbfd = new_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_openr, bfd_fdopenr -- open for reading.
-  Returns a pointer to a freshly-allocated bfd on success, or NULL. */
+/*
+SECTION
+       Opening and Closing BFDs
+
+*/
+
+/*
+FUNCTION
+       bfd_openr
+
+SYNOPSIS
+        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.
+
+       If NULL is returned then an error has occured. Possible errors
+       are <<no_memory>>, <<invalid_target>> or <<system_call>> error.
+*/
 
 bfd *
-bfd_openr (filename, target)
-     char *filename;
-     char *target;
+DEFUN(bfd_openr, (filename, target),
+      CONST char *filename AND
+      CONST char *target)
 {
   bfd *nbfd;
   bfd_target *target_vec;
 
-  target_vec = bfd_find_target (target);
-  if (target_vec == NULL) {
-    bfd_error = invalid_target;
-    return NULL;
-  }
-
-  bfd_error = system_call_error;
   nbfd = new_bfd();
   if (nbfd == NULL) {
     bfd_error = no_memory;
     return NULL;
   }
 
+  target_vec = bfd_find_target (target, nbfd);
+  if (target_vec == NULL) {
+    bfd_error = invalid_target;
+    return NULL;
+  }
+
   nbfd->filename = filename;
-  nbfd->xvec = target_vec;
   nbfd->direction = read_direction; 
 
   if (bfd_open_file (nbfd) == NULL) {
     bfd_error = system_call_error;     /* File didn't exist, or some such */
-    free (nbfd);
+    bfd_release(nbfd,0);
     return NULL;
   }
   return nbfd;
@@ -128,35 +143,40 @@ bfd_openr (filename, target)
        close it if anything goes wrong.  Closing the stream means closing
        the file descriptor too, even though we didn't open it.
  */
+/*
+FUNCTION
+         bfd_fdopenr
+
+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.
+        It opens a BFD on a file already described by the @var{fd}
+        supplied. 
+
+         Possible errors are no_memory, invalid_target and system_call
+        error.
+*/
 
 bfd *
-bfd_fdopenr (filename, target, fd)
-     char *filename;
-     char *target;
-     int fd;
+DEFUN(bfd_fdopenr,(filename, target, fd),
+      CONST char *filename AND
+      CONST char *target AND
+      int fd)
 {
   bfd *nbfd;
   bfd_target *target_vec;
   int fdflags;
-#ifdef BFD_LOCKS
-  struct flock lock, *lockp = &lock;
-#endif
-
-  target_vec = bfd_find_target (target);
-  if (target_vec == NULL) {
-    bfd_error = invalid_target;
-    return NULL;
-  }
 
   bfd_error = system_call_error;
   
-  fdflags = fcntl (fd, F_GETFL);
-  if (fdflags == -1) return NULL;
-
-#ifdef BFD_LOCKS
-  lockp->l_type = F_RDLCK;
-  if (fcntl (fd, F_SETLKW, lockp) == -1) return NULL;
+#ifdef NO_FCNTL
+  fdflags = O_RDWR;                    /* Assume full access */
+#else
+  fdflags = fcntl (fd, F_GETFL, NULL);
 #endif
+  if (fdflags == -1) return NULL;
 
   nbfd = new_bfd();
 
@@ -164,56 +184,72 @@ bfd_fdopenr (filename, target, fd)
     bfd_error = no_memory;
     return NULL;
   }
-#ifdef BFD_LOCKS
-  nbfd->lock = (struct flock *) (nbfd + 1);
-#endif
+
+  target_vec = bfd_find_target (target, nbfd);
+  if (target_vec == NULL) {
+    bfd_error = invalid_target;
+    return NULL;
+  }
+
+#ifdef FASCIST_FDOPEN
+  nbfd->iostream = (char *) fdopen (fd, FOPEN_RB); 
+#else
   /* if the fd were open for read only, this still would not hurt: */
-  nbfd->iostream = (char *) fdopen (fd, "r+"); 
+  nbfd->iostream = (char *) fdopen (fd, FOPEN_RUB); 
+#endif
   if (nbfd->iostream == NULL) {
-    free (nbfd);
+    (void) obstack_free (&nbfd->memory, (PTR)0);
     return NULL;
   }
   
   /* OK, put everything where it belongs */
 
   nbfd->filename = filename;
-  nbfd->xvec = target_vec;
 
   /* As a special case we allow a FD open for read/write to
      be written through, although doing so requires that we end
      the previous clause with a preposition.  */
-  switch (fdflags & O_ACCMODE) {
+  /* (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_RDWR: nbfd->direction = both_direction; break;
   default: abort ();
   }
                                   
-#ifdef BFD_LOCKS
-  memcpy (nbfd->lock, lockp, sizeof (struct flock))
-#endif
-
-    bfd_cache_init (nbfd);
+  bfd_cache_init (nbfd);
 
   return nbfd;
 }
 \f
 /** bfd_openw -- open for writing.
-  Returns a pointer to a freshly-allocated bfd on success, or NULL.
+  Returns a pointer to a freshly-allocated BFD on success, or NULL.
 
   See comment by bfd_fdopenr before you try to modify this function. */
 
+/*
+FUNCTION
+       bfd_openw
+
+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.
+
+       Possible errors are system_call_error, no_memory,
+       invalid_target. 
+*/
+
 bfd *
-bfd_openw (filename, target)
-     char *filename;
-     char *target;
+DEFUN(bfd_openw,(filename, target),
+      CONST char *filename AND
+      CONST char *target)
 {
   bfd *nbfd;
   bfd_target *target_vec;
   
-  target_vec = bfd_find_target (target);
-  if (target_vec == NULL) return NULL;
-
   bfd_error = system_call_error;
 
   /* nbfd has to point to head of malloc'ed block so that bfd_close may
@@ -225,46 +261,177 @@ bfd_openw (filename, target)
     return NULL;
   }
 
+  target_vec = bfd_find_target (target, nbfd);
+  if (target_vec == NULL) return NULL;
+
   nbfd->filename = filename;
-  nbfd->xvec = target_vec;
   nbfd->direction = write_direction;
 
   if (bfd_open_file (nbfd) == NULL) {
     bfd_error = system_call_error;     /* File not writeable, etc */
-    free (nbfd);
+    (void) obstack_free (&nbfd->memory, (PTR)0);
     return NULL;
   }
   return nbfd;
 }
 
+/*
+
+FUNCTION
+       bfd_close
+
+SYNOPSIS
+       boolean bfd_close(bfd *);
+
+DESCRIPTION
+
+       This function closes 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. 
+
+RETURNS
+       <<true>> is returned if all is ok, otherwise <<false>>.
+*/
+
 
-\f
-/** Close up shop, get your deposit back. */
 boolean
-bfd_close (abfd)
-     bfd *abfd;
+DEFUN(bfd_close,(abfd),
+      bfd *abfd)
 {
+  if (!bfd_read_p(abfd))
+    if (BFD_SEND_FMT (abfd, _bfd_write_contents, (abfd)) != true)
+      return false;
+
   if (BFD_SEND (abfd, _close_and_cleanup, (abfd)) != true) return false;
 
   bfd_cache_close(abfd);
-/* If the file was open for writing and is now executable
-  make it so */
+
+  /* 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);
-    chmod(abfd->filename,buf.st_mode | S_IXUSR | S_IXGRP | S_IXOTH);
+#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, 0777  & (buf.st_mode | S_IXUSR | S_IXGRP | S_IXOTH));
   }
-  free (abfd);
+  (void) obstack_free (&abfd->memory, (PTR)0);
+  (void) free(abfd);
   return true;
 }
-/* 
- called to create a bfd with no ascociated file or target 
- */
+
+/*
+FUNCTION
+       bfd_close_all_done
+
+SYNOPSIS
+       boolean bfd_close_all_done(bfd *);
+
+DESCRIPTION
+       This function closes a BFD. It 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.
+
+       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. 
+
+RETURNS
+       <<true>> is returned if all is ok, otherwise <<false>>.
+
+*/
+
+boolean
+DEFUN(bfd_close_all_done,(abfd),
+      bfd *abfd)
+{
+  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));
+  }
+  (void) obstack_free (&abfd->memory, (PTR)0);
+  (void) free(abfd);
+  return true;
+}
+
+
+/*
+FUNCTION       
+       bfd_alloc_size
+
+SYNOPSIS
+       bfd_size_type bfd_alloc_size(bfd *abfd);
+
+DESCRIPTION
+        Return the number of bytes in the obstacks connected to the
+       supplied BFD.
+
+*/
+
+bfd_size_type
+DEFUN(bfd_alloc_size,(abfd),
+      bfd *abfd)
+{
+  struct _obstack_chunk *chunk = abfd->memory.chunk;
+  size_t size = 0;
+  while (chunk) {
+    size += chunk->limit - &(chunk->contents[0]);
+    chunk = chunk->prev;
+  }
+  return size;
+}
+
+
+
+/*
+FUNCTION
+       bfd_create
+
+SYNOPSIS
+       bfd *bfd_create(CONST char *filename, bfd *template);
+
+DESCRIPTION
+       This routine creates 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>>. 
+
+*/
+
 bfd *
-bfd_create(filename, template)
-char *filename;
-bfd *template;
+DEFUN(bfd_create,(filename, template),
+      CONST char *filename AND
+      bfd *template)
 {
   bfd *nbfd = new_bfd();
   if (nbfd == (bfd *)NULL) {
@@ -272,10 +439,81 @@ bfd *template;
     return (bfd *)NULL;
   }
   nbfd->filename = filename;
-  nbfd->xvec = template->xvec;
+  if(template) {
+    nbfd->xvec = template->xvec;
+  }
   nbfd->direction = no_direction;
+  bfd_set_format(nbfd, bfd_object);
   return nbfd;
+}
 
+/* 
+INTERNAL_FUNCTION
+       bfd_alloc_by_size_t
 
+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.
+*/
+
+
+PTR 
+DEFUN(bfd_alloc_by_size_t,(abfd, size),
+      bfd *abfd AND
+      size_t size)
+{
+  PTR res = obstack_alloc(&(abfd->memory), size);
+  return res;
 }
+
+DEFUN(void bfd_alloc_grow,(abfd, ptr, size),
+      bfd *abfd AND
+      PTR ptr AND
+      bfd_size_type size)
+{
+  (void)   obstack_grow(&(abfd->memory), ptr, size);
+}
+DEFUN(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)
+{
+  return bfd_alloc_by_size_t(abfd, (size_t)size);
+}
+
+DEFUN(PTR bfd_zalloc,(abfd, size),
+      bfd *abfd AND
+      bfd_size_type size)
+{
+  PTR res = bfd_alloc(abfd, size);
+  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.035279 seconds and 4 git commands to generate.