2004-04-30 H.J. Lu <hongjiu.lu@intel.com>
[deliverable/binutils-gdb.git] / bfd / section.c
index 44edb073caa5deda4fe15fd314b655824b51e7b6..0236f08756c27bc0815eaaaa4b6e594942d35e7f 100644 (file)
@@ -1,6 +1,6 @@
 /* Object file "section" support for the BFD library.
    Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
-   2000, 2001, 2002, 2003
+   2000, 2001, 2002, 2003, 2004
    Free Software Foundation, Inc.
    Written by Cygnus Support.
 
@@ -166,7 +166,7 @@ CODE_FRAGMENT
 .  long symbol;
 .};
 .
-.typedef struct sec
+.typedef struct bfd_section
 .{
 .  {* The name of the section; the name isn't a copy, the pointer is
 .     the same as that passed to bfd_make_section.  *}
@@ -179,7 +179,7 @@ CODE_FRAGMENT
 .  int index;
 .
 .  {* The next section in the list belonging to the BFD, or NULL.  *}
-.  struct sec *next;
+.  struct bfd_section *next;
 .
 .  {* The field flags contains attributes of the section. Some
 .     flags are read in from the object file, and some are
@@ -402,7 +402,7 @@ CODE_FRAGMENT
 .  {* Nonzero if this section has a gp reloc.  *}
 .  unsigned int has_gp_reloc:1;
 .
-.  {* Usused bits.  *}
+.  {* Unused bits.  *}
 .  unsigned int flag13:1;
 .  unsigned int flag14:1;
 .  unsigned int flag15:1;
@@ -445,7 +445,7 @@ CODE_FRAGMENT
 .  bfd_vma output_offset;
 .
 .  {* The output section through which to map on output.  *}
-.  struct sec *output_section;
+.  struct bfd_section *output_section;
 .
 .  {* The alignment requirement of the section, as an exponent of 2 -
 .     e.g., 3 aligns to 2^3 (or 8).  *}
@@ -475,7 +475,7 @@ CODE_FRAGMENT
 .  file_ptr line_filepos;
 .
 .  {* Pointer to data for applications.  *}
-.  PTR userdata;
+.  void *userdata;
 .
 .  {* If the SEC_IN_MEMORY flag is set, this points to the actual
 .     contents.  *}
@@ -495,7 +495,7 @@ CODE_FRAGMENT
 .
 .  {* Points to the kept section if this section is a link-once section,
 .     and is discarded.  *}
-.  struct sec *kept_section;
+.  struct bfd_section *kept_section;
 .
 .  {* When a section is being output, this value changes as more
 .     linenumbers are written out.  *}
@@ -504,7 +504,7 @@ CODE_FRAGMENT
 .  {* What the section number is in the target world.  *}
 .  int target_index;
 .
-.  PTR used_by_bfd;
+.  void *used_by_bfd;
 .
 .  {* If this is a constructor section then here is a list of the
 .     relocations created to relocate items within it.  *}
@@ -514,8 +514,8 @@ CODE_FRAGMENT
 .  bfd *owner;
 .
 .  {* A symbol which points at this section only.  *}
-.  struct symbol_cache_entry *symbol;
-.  struct symbol_cache_entry **symbol_ptr_ptr;
+.  struct bfd_symbol *symbol;
+.  struct bfd_symbol **symbol_ptr_ptr;
 .
 .  struct bfd_link_order *link_order_head;
 .  struct bfd_link_order *link_order_tail;
@@ -532,18 +532,18 @@ CODE_FRAGMENT
 .#define BFD_IND_SECTION_NAME "*IND*"
 .
 .{* The absolute section.  *}
-.extern const asection bfd_abs_section;
+.extern asection bfd_abs_section;
 .#define bfd_abs_section_ptr ((asection *) &bfd_abs_section)
 .#define bfd_is_abs_section(sec) ((sec) == bfd_abs_section_ptr)
 .{* Pointer to the undefined section.  *}
-.extern const asection bfd_und_section;
+.extern asection bfd_und_section;
 .#define bfd_und_section_ptr ((asection *) &bfd_und_section)
 .#define bfd_is_und_section(sec) ((sec) == bfd_und_section_ptr)
 .{* Pointer to the common section.  *}
-.extern const asection bfd_com_section;
+.extern asection bfd_com_section;
 .#define bfd_com_section_ptr ((asection *) &bfd_com_section)
 .{* Pointer to the indirect section.  *}
-.extern const asection bfd_ind_section;
+.extern asection bfd_ind_section;
 .#define bfd_ind_section_ptr ((asection *) &bfd_ind_section)
 .#define bfd_is_ind_section(sec) ((sec) == bfd_ind_section_ptr)
 .
@@ -553,13 +553,12 @@ CODE_FRAGMENT
 .  || ((SEC) == bfd_com_section_ptr)           \
 .  || ((SEC) == bfd_ind_section_ptr))
 .
-.extern const struct symbol_cache_entry * const bfd_abs_symbol;
-.extern const struct symbol_cache_entry * const bfd_com_symbol;
-.extern const struct symbol_cache_entry * const bfd_und_symbol;
-.extern const struct symbol_cache_entry * const bfd_ind_symbol;
+.extern const struct bfd_symbol * const bfd_abs_symbol;
+.extern const struct bfd_symbol * const bfd_com_symbol;
+.extern const struct bfd_symbol * const bfd_und_symbol;
+.extern const struct bfd_symbol * const bfd_ind_symbol;
 .#define bfd_get_section_size_before_reloc(section) \
-.     ((section)->reloc_done ? (abort (), (bfd_size_type) 1) \
-.                            : (section)->_raw_size)
+.     ((section)->_raw_size)
 .#define bfd_get_section_size_after_reloc(section) \
 .     ((section)->reloc_done ? (section)->_cooked_size \
 .                            : (abort (), (bfd_size_type) 1))
@@ -616,7 +615,7 @@ static const asymbol global_syms[] =
 
 #define STD_SECTION(SEC, FLAGS, SYM, NAME, IDX)                                \
   const asymbol * const SYM = (asymbol *) &global_syms[IDX];           \
-  const asection SEC =                                                         \
+  asection SEC =                                                       \
     /* name, id,  index, next, flags, user_set_vma, reloc_done,      */        \
     { NAME,  IDX, 0,     NULL, FLAGS, 0,            0,                 \
                                                                        \
@@ -636,7 +635,7 @@ static const asymbol global_syms[] =
        0,   0,   0,            0,                                      \
                                                                        \
     /* output_offset, output_section,      alignment_power,          */        \
-       0,             (struct sec *) &SEC, 0,                          \
+       0,             (struct bfd_section *) &SEC, 0,                  \
                                                                        \
     /* relocation, orelocation, reloc_count, filepos, rel_filepos,   */        \
        NULL,       NULL,        0,           0,       0,               \
@@ -651,10 +650,10 @@ static const asymbol global_syms[] =
        0,            NULL,        NULL,              NULL,             \
                                                                        \
     /* symbol,                                                       */        \
-       (struct symbol_cache_entry *) &global_syms[IDX],                        \
+       (struct bfd_symbol *) &global_syms[IDX],                                \
                                                                        \
     /* symbol_ptr_ptr,                                               */        \
-       (struct symbol_cache_entry **) &SYM,                            \
+       (struct bfd_symbol **) &SYM,                                    \
                                                                        \
     /* link_order_head, link_order_tail                              */        \
        NULL,            NULL                                           \
@@ -676,10 +675,9 @@ struct section_hash_entry
 /* Initialize an entry in the section hash table.  */
 
 struct bfd_hash_entry *
-bfd_section_hash_newfunc (entry, table, string)
-     struct bfd_hash_entry *entry;
-     struct bfd_hash_table *table;
-     const char *string;
+bfd_section_hash_newfunc (struct bfd_hash_entry *entry,
+                         struct bfd_hash_table *table,
+                         const char *string)
 {
   /* Allocate the structure if it has not already been allocated by a
      subclass.  */
@@ -694,10 +692,8 @@ bfd_section_hash_newfunc (entry, table, string)
   /* Call the allocation method of the superclass.  */
   entry = bfd_hash_newfunc (entry, table, string);
   if (entry != NULL)
-    {
-      memset ((PTR) &((struct section_hash_entry *) entry)->section,
-             0, sizeof (asection));
-    }
+    memset (&((struct section_hash_entry *) entry)->section, 0,
+           sizeof (asection));
 
   return entry;
 }
@@ -708,12 +704,8 @@ bfd_section_hash_newfunc (entry, table, string)
 
 /* Initializes a new section.  NEWSECT->NAME is already set.  */
 
-static asection *bfd_section_init PARAMS ((bfd *, asection *));
-
 static asection *
-bfd_section_init (abfd, newsect)
-     bfd *abfd;
-     asection *newsect;
+bfd_section_init (bfd *abfd, asection *newsect)
 {
   static int section_id = 0x10;  /* id 0 to 3 used by STD_SECTION.  */
 
@@ -768,13 +760,12 @@ DESCRIPTION
 */
 
 void
-bfd_section_list_clear (abfd)
-     bfd *abfd;
+bfd_section_list_clear (bfd *abfd)
 {
   abfd->sections = NULL;
   abfd->section_tail = &abfd->sections;
   abfd->section_count = 0;
-  memset ((PTR) abfd->section_htab.table, 0,
+  memset (abfd->section_htab.table, 0,
          abfd->section_htab.size * sizeof (struct bfd_hash_entry *));
 }
 
@@ -783,7 +774,7 @@ FUNCTION
        bfd_get_section_by_name
 
 SYNOPSIS
-       asection *bfd_get_section_by_name(bfd *abfd, const char *name);
+       asection *bfd_get_section_by_name (bfd *abfd, const char *name);
 
 DESCRIPTION
        Run through @var{abfd} and return the one of the
@@ -797,9 +788,7 @@ DESCRIPTION
 */
 
 asection *
-bfd_get_section_by_name (abfd, name)
-     bfd *abfd;
-     const char *name;
+bfd_get_section_by_name (bfd *abfd, const char *name)
 {
   struct section_hash_entry *sh;
 
@@ -815,9 +804,8 @@ FUNCTION
        bfd_get_unique_section_name
 
 SYNOPSIS
-       char *bfd_get_unique_section_name(bfd *abfd,
-                                         const char *templat,
-                                         int *count);
+       char *bfd_get_unique_section_name
+         (bfd *abfd, const char *templat, int *count);
 
 DESCRIPTION
        Invent a section name that is unique in @var{abfd} by tacking
@@ -828,17 +816,14 @@ DESCRIPTION
 */
 
 char *
-bfd_get_unique_section_name (abfd, templat, count)
-     bfd *abfd;
-     const char *templat;
-     int *count;
+bfd_get_unique_section_name (bfd *abfd, const char *templat, int *count)
 {
   int num;
   unsigned int len;
   char *sname;
 
   len = strlen (templat);
-  sname = bfd_malloc ((bfd_size_type) len + 8);
+  sname = bfd_malloc (len + 8);
   if (sname == NULL)
     return NULL;
   memcpy (sname, templat, len);
@@ -865,7 +850,7 @@ FUNCTION
        bfd_make_section_old_way
 
 SYNOPSIS
-       asection *bfd_make_section_old_way(bfd *abfd, const char *name);
+       asection *bfd_make_section_old_way (bfd *abfd, const char *name);
 
 DESCRIPTION
        Create a new empty section called @var{name}
@@ -886,9 +871,7 @@ DESCRIPTION
 */
 
 asection *
-bfd_make_section_old_way (abfd, name)
-     bfd *abfd;
-     const char *name;
+bfd_make_section_old_way (bfd *abfd, const char *name)
 {
   struct section_hash_entry *sh;
   asection *newsect;
@@ -931,7 +914,7 @@ FUNCTION
        bfd_make_section_anyway
 
 SYNOPSIS
-       asection *bfd_make_section_anyway(bfd *abfd, const char *name);
+       asection *bfd_make_section_anyway (bfd *abfd, const char *name);
 
 DESCRIPTION
    Create a new empty section called @var{name} and attach it to the end of
@@ -944,9 +927,7 @@ DESCRIPTION
 */
 
 sec_ptr
-bfd_make_section_anyway (abfd, name)
-     bfd *abfd;
-     const char *name;
+bfd_make_section_anyway (bfd *abfd, const char *name)
 {
   struct section_hash_entry *sh;
   asection *newsect;
@@ -964,13 +945,19 @@ bfd_make_section_anyway (abfd, name)
   newsect = &sh->section;
   if (newsect->name != NULL)
     {
-      /* We are making a section of the same name.  It can't go in
-        section_htab without generating a unique section name and
-        that would be pointless;  We don't need to traverse the
-        hash table.  */
-      newsect = (asection *) bfd_zalloc (abfd, sizeof (asection));
-      if (newsect == NULL)
+      /* We are making a section of the same name.  Put it in the
+        section hash table.  Even though we can't find it directly by a
+        hash lookup, we'll be able to find the section by traversing
+        sh->root.next quicker than looking at all the bfd sections.  */
+      struct section_hash_entry *new_sh;
+      new_sh = (struct section_hash_entry *)
+       bfd_section_hash_newfunc (NULL, &abfd->section_htab, name);
+      if (new_sh == NULL)
        return NULL;
+
+      new_sh->root.next = sh->root.next;
+      sh->root.next = &new_sh->root;
+      newsect = &new_sh->section;
     }
 
   newsect->name = name;
@@ -982,7 +969,7 @@ FUNCTION
        bfd_make_section
 
 SYNOPSIS
-       asection *bfd_make_section(bfd *, const char *name);
+       asection *bfd_make_section (bfd *, const char *name);
 
 DESCRIPTION
    Like <<bfd_make_section_anyway>>, but return <<NULL>> (without calling
@@ -992,9 +979,7 @@ DESCRIPTION
 */
 
 asection *
-bfd_make_section (abfd, name)
-     bfd *abfd;
-     const char *name;
+bfd_make_section (bfd *abfd, const char *name)
 {
   struct section_hash_entry *sh;
   asection *newsect;
@@ -1019,7 +1004,7 @@ bfd_make_section (abfd, name)
   if (newsect->name != NULL)
     {
       /* Section already exists.  */
-      return newsect;
+      return NULL;
     }
 
   newsect->name = name;
@@ -1031,7 +1016,8 @@ FUNCTION
        bfd_set_section_flags
 
 SYNOPSIS
-       bfd_boolean bfd_set_section_flags (bfd *abfd, asection *sec, flagword flags);
+       bfd_boolean bfd_set_section_flags
+         (bfd *abfd, asection *sec, flagword flags);
 
 DESCRIPTION
        Set the attributes of the section @var{sec} in the BFD
@@ -1045,12 +1031,10 @@ DESCRIPTION
 
 */
 
-/*ARGSUSED*/
 bfd_boolean
-bfd_set_section_flags (abfd, section, flags)
-     bfd *abfd ATTRIBUTE_UNUSED;
-     sec_ptr section;
-     flagword flags;
+bfd_set_section_flags (bfd *abfd ATTRIBUTE_UNUSED,
+                      sec_ptr section,
+                      flagword flags)
 {
 #if 0
   /* If you try to copy a text section from an input file (where it
@@ -1074,34 +1058,31 @@ FUNCTION
        bfd_map_over_sections
 
 SYNOPSIS
-       void bfd_map_over_sections(bfd *abfd,
-                                  void (*func) (bfd *abfd,
-                                               asection *sect,
-                                               PTR obj),
-                                  PTR obj);
+       void bfd_map_over_sections
+         (bfd *abfd,
+          void (*func) (bfd *abfd, asection *sect, void *obj),
+          void *obj);
 
 DESCRIPTION
        Call the provided function @var{func} for each section
        attached to the BFD @var{abfd}, passing @var{obj} as an
        argument. The function will be called as if by
 
-|      func(abfd, the_section, obj);
+|      func (abfd, the_section, obj);
 
-       This is the prefered method for iterating over sections; an
+       This is the preferred method for iterating over sections; an
        alternative would be to use a loop:
 
 |         section *p;
 |         for (p = abfd->sections; p != NULL; p = p->next)
-|            func(abfd, p, ...)
+|            func (abfd, p, ...)
 
 */
 
-/*VARARGS2*/
 void
-bfd_map_over_sections (abfd, operation, user_storage)
-     bfd *abfd;
-     void (*operation) PARAMS ((bfd * abfd, asection * sect, PTR obj));
-     PTR user_storage;
+bfd_map_over_sections (bfd *abfd,
+                      void (*operation) (bfd *, asection *, void *),
+                      void *user_storage)
 {
   asection *sect;
   unsigned int i = 0;
@@ -1113,12 +1094,48 @@ bfd_map_over_sections (abfd, operation, user_storage)
     abort ();
 }
 
+/*
+FUNCTION
+       bfd_sections_find_if
+
+SYNOPSIS
+       asection *bfd_sections_find_if
+         (bfd *abfd,
+          bfd_boolean (*func) (bfd *abfd, asection *sect, void *obj),
+          void *obj);
+
+DESCRIPTION
+       Call the provided function @var{func} for each section
+       attached to the BFD @var{abfd}, passing @var{obj} as an
+       argument. The function will be called as if by
+
+|      func (abfd, the_section, obj);
+
+       It returns the first section for which @var{func} returns true.
+
+*/
+
+asection *
+bfd_sections_find_if (bfd *abfd,
+                     bfd_boolean (*operation) (bfd *, asection *, void *),
+                     void *user_storage)
+{
+  asection *sect;
+
+  for (sect = abfd->sections; sect != NULL; sect = sect->next)
+    if ((*operation) (abfd, sect, user_storage))
+      break;
+
+  return sect;
+}
+
 /*
 FUNCTION
        bfd_set_section_size
 
 SYNOPSIS
-       bfd_boolean bfd_set_section_size (bfd *abfd, asection *sec, bfd_size_type val);
+       bfd_boolean bfd_set_section_size
+         (bfd *abfd, asection *sec, bfd_size_type val);
 
 DESCRIPTION
        Set @var{sec} to the size @var{val}. If the operation is
@@ -1131,10 +1148,7 @@ DESCRIPTION
 */
 
 bfd_boolean
-bfd_set_section_size (abfd, ptr, val)
-     bfd *abfd;
-     sec_ptr ptr;
-     bfd_size_type val;
+bfd_set_section_size (bfd *abfd, sec_ptr ptr, bfd_size_type val)
 {
   /* Once you've started writing to any section you cannot create or change
      the size of any others.  */
@@ -1156,9 +1170,9 @@ FUNCTION
        bfd_set_section_contents
 
 SYNOPSIS
-       bfd_boolean bfd_set_section_contents (bfd *abfd, asection *section,
-                                             PTR data, file_ptr offset,
-                                             bfd_size_type count);
+       bfd_boolean bfd_set_section_contents
+         (bfd *abfd, asection *section, const void *data,
+          file_ptr offset, bfd_size_type count);
 
 DESCRIPTION
        Sets the contents of the section @var{section} in BFD
@@ -1178,18 +1192,17 @@ DESCRIPTION
 
 */
 
-#define bfd_get_section_size_now(abfd,sec) \
-(sec->reloc_done \
- ? bfd_get_section_size_after_reloc (sec) \
- : bfd_get_section_size_before_reloc (sec))
+#define bfd_get_section_size_now(abfd, sec) \
+  (sec->reloc_done \
  ? bfd_get_section_size_after_reloc (sec) \
  : bfd_get_section_size_before_reloc (sec))
 
 bfd_boolean
-bfd_set_section_contents (abfd, section, location, offset, count)
-     bfd *abfd;
-     sec_ptr section;
-     PTR location;
-     file_ptr offset;
-     bfd_size_type count;
+bfd_set_section_contents (bfd *abfd,
+                         sec_ptr section,
+                         const void *location,
+                         file_ptr offset,
+                         bfd_size_type count)
 {
   bfd_size_type sz;
 
@@ -1229,7 +1242,7 @@ bfd_set_section_contents (abfd, section, location, offset, count)
 
   /* Record a copy of the data in memory if desired.  */
   if (section->contents
-      && location != (PTR) (section->contents + offset))
+      && location != section->contents + offset)
     memcpy (section->contents + offset, location, (size_t) count);
 
   if (BFD_SEND (abfd, _bfd_set_section_contents,
@@ -1247,9 +1260,9 @@ FUNCTION
        bfd_get_section_contents
 
 SYNOPSIS
-       bfd_boolean bfd_get_section_contents (bfd *abfd, asection *section,
-                                             PTR location, file_ptr offset,
-                                             bfd_size_type count);
+       bfd_boolean bfd_get_section_contents
+         (bfd *abfd, asection *section, void *location, file_ptr offset,
+          bfd_size_type count);
 
 DESCRIPTION
        Read data from @var{section} in BFD @var{abfd}
@@ -1265,12 +1278,11 @@ DESCRIPTION
 
 */
 bfd_boolean
-bfd_get_section_contents (abfd, section, location, offset, count)
-     bfd *abfd;
-     sec_ptr section;
-     PTR location;
-     file_ptr offset;
-     bfd_size_type count;
+bfd_get_section_contents (bfd *abfd,
+                         sec_ptr section,
+                         void *location,
+                         file_ptr offset,
+                         bfd_size_type count)
 {
   bfd_size_type sz;
 
@@ -1317,8 +1329,8 @@ FUNCTION
        bfd_copy_private_section_data
 
 SYNOPSIS
-       bfd_boolean bfd_copy_private_section_data (bfd *ibfd, asection *isec,
-                                                  bfd *obfd, asection *osec);
+       bfd_boolean bfd_copy_private_section_data
+         (bfd *ibfd, asection *isec, bfd *obfd, asection *osec);
 
 DESCRIPTION
        Copy private section information from @var{isec} in the BFD
@@ -1340,7 +1352,7 @@ FUNCTION
 
 SYNOPSIS
        void _bfd_strip_section_from_output
-       (struct bfd_link_info *info, asection *section);
+         (struct bfd_link_info *info, asection *section);
 
 DESCRIPTION
        Remove @var{section} from the output.  If the output section
@@ -1351,9 +1363,7 @@ DESCRIPTION
        to remove sections.
 */
 void
-_bfd_strip_section_from_output (info, s)
-     struct bfd_link_info *info;
-     asection *s;
+_bfd_strip_section_from_output (struct bfd_link_info *info, asection *s)
 {
   asection *os;
   asection *is;
@@ -1380,6 +1390,24 @@ _bfd_strip_section_from_output (info, s)
   os->flags |= SEC_EXCLUDE;
 }
 
+/*
+FUNCTION
+       bfd_generic_is_group_section
+
+SYNOPSIS
+       bfd_boolean bfd_generic_is_group_section (bfd *, const asection *sec);
+
+DESCRIPTION
+       Returns TRUE if @var{sec} is a member of a group.
+*/
+
+bfd_boolean
+bfd_generic_is_group_section (bfd *abfd ATTRIBUTE_UNUSED,
+                             const asection *sec ATTRIBUTE_UNUSED)
+{
+  return FALSE;
+}
+
 /*
 FUNCTION
        bfd_generic_discard_group
@@ -1392,9 +1420,8 @@ DESCRIPTION
 */
 
 bfd_boolean
-bfd_generic_discard_group (abfd, group)
-     bfd *abfd ATTRIBUTE_UNUSED;
-     asection *group ATTRIBUTE_UNUSED;
+bfd_generic_discard_group (bfd *abfd ATTRIBUTE_UNUSED,
+                          asection *group ATTRIBUTE_UNUSED)
 {
   return TRUE;
 }
This page took 0.044736 seconds and 4 git commands to generate.