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 24#ifndef _ELFCOMM_H 25#define _ELFCOMM_H 26 27#include "aout/ar.h" 28 29extern void error (const char *, ...) ATTRIBUTE_PRINTF_1; 30extern void warn (const char *, ...) ATTRIBUTE_PRINTF_1; 31 32typedef unsigned HOST_WIDEST_INT elf_vma; 33 34extern void (*byte_put) (unsigned char *, elf_vma, unsigned int); 35extern void byte_put_little_endian (unsigned char *, elf_vma, unsigned int); 36extern void byte_put_big_endian (unsigned char *, elf_vma, unsigned int); 37 38extern elf_vma (*byte_get) (const unsigned char *, unsigned int); 39extern elf_vma byte_get_signed (const unsigned char *, unsigned int); 40extern elf_vma byte_get_little_endian (const unsigned char *, unsigned int); 41extern 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 52struct 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. */ 70extern char *adjust_relative_path (const char *, const char *, unsigned long); 71 72/* Read the symbol table and long-name table from an archive. */ 73extern 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. */ 77extern int setup_nested_archive (struct archive_info *, const char *); 78 79/* Release the memory used for the archive information. */ 80extern void release_archive (struct archive_info *); 81 82/* Get the name of an archive member from the current archive header. */ 83 84extern 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 90extern 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 97extern char *make_qualified_name (struct archive_info *, 98 struct archive_info *, 99 const char *); 100 101#endif /* _ELFCOMM_H */ 102