binutils/elfcomm.h

   1 /* elfcomm.h -- include file of common code for ELF format file.
   2    Copyright (C) 2010-2022 Free Software Foundation, Inc.
   3
   4    Originally developed by Eric Youngdale <eric@andante.jic.com>
   5    Modifications by Nick Clifton <nickc@redhat.com>
   6
   7    This file is part of GNU Binutils.
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 3 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program; if not, write to the Free Software
  21    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA
  22    02110-1301, USA.  */
  23 \f
  24 #ifndef _ELFCOMM_H
  25 #define _ELFCOMM_H
  26
  27 #include "aout/ar.h"
  28
  29 extern void error (const char *, ...) ATTRIBUTE_PRINTF_1;
  30 extern void warn (const char *, ...) ATTRIBUTE_PRINTF_1;
  31
  32 typedef unsigned HOST_WIDEST_INT elf_vma;
  33
  34 extern void (*byte_put) (unsigned char *, elf_vma, unsigned int);
  35 extern void byte_put_little_endian (unsigned char *, elf_vma, unsigned int);
  36 extern void byte_put_big_endian (unsigned char *, elf_vma, unsigned int);
  37
  38 extern elf_vma (*byte_get) (const unsigned char *, unsigned int);
  39 extern elf_vma byte_get_signed (const unsigned char *, unsigned int);
  40 extern elf_vma byte_get_little_endian (const unsigned char *, unsigned int);
  41 extern elf_vma byte_get_big_endian (const unsigned char *, unsigned int);
  42
  43 #define BYTE_PUT(field, val)    byte_put (field, val, sizeof (field))
  44 #define BYTE_GET(field)         byte_get (field, sizeof (field))
  45 #define BYTE_GET_SIGNED(field)  byte_get_signed (field, sizeof (field))
  46
  47 /* This is just a bit of syntatic sugar.  */
  48 #define streq(a,b)        (strcmp ((a), (b)) == 0)
  49
  50 /* Structure to hold information about an archive file.  */
  51
  52 struct archive_info
  53 {
  54   char * file_name;                     /* Archive file name.  */
  55   FILE * file;                          /* Open file descriptor.  */
  56   elf_vma index_num;                    /* Number of symbols in table.  */
  57   elf_vma * index_array;                /* The array of member offsets.  */
  58   char * sym_table;                     /* The symbol table.  */
  59   unsigned long sym_size;               /* Size of the symbol table.  */
  60   char * longnames;                     /* The long file names table.  */
  61   unsigned long longnames_size;         /* Size of the long file names table.  */
  62   unsigned long nested_member_origin;   /* Origin in the nested archive of the current member.  */
  63   unsigned long next_arhdr_offset;      /* Offset of the next archive header.  */
  64   int is_thin_archive;                  /* 1 if this is a thin archive.  */
  65   int uses_64bit_indices;               /* 1 if the index table uses 64bit entries.  */
  66   struct ar_hdr arhdr;                  /* Current archive header.  */
  67 };
  68
  69 /* Return the path name for a proxy entry in a thin archive.  */
  70 extern char *adjust_relative_path (const char *, const char *, unsigned long);
  71
  72 /* Read the symbol table and long-name table from an archive.  */
  73 extern int setup_archive (struct archive_info *, const char *, FILE *,
  74                           off_t, int, int);
  75
  76 /* Open and setup a nested archive, if not already open.  */
  77 extern int setup_nested_archive (struct archive_info *, const char *);
  78
  79 /* Release the memory used for the archive information.  */
  80 extern void release_archive (struct archive_info *);
  81
  82 /* Get the name of an archive member from the current archive header.  */
  83
  84 extern char *get_archive_member_name (struct archive_info *,
  85                                       struct archive_info *);
  86
  87 /* Get the name of an archive member at a given offset within an
  88    archive.  */
  89
  90 extern char *get_archive_member_name_at (struct archive_info *,
  91                                          unsigned long,
  92                                          struct archive_info *);
  93
  94 /* Construct a string showing the name of the archive member, qualified
  95    with the name of the containing archive file.  */
  96
  97 extern char *make_qualified_name (struct archive_info *,
  98                                   struct archive_info *,
  99                                   const char *);
 100
 101 #endif /* _ELFCOMM_H */