1 /* ELF support for BFD.
2 Copyright (C) 1991 Free Software Foundation, Inc.
4 Written by Fred Fish @ Cygnus Support, from information published
5 in "UNIX System V Release 4, Programmers Guide: ANSI C and
6 Programming Support Tools".
8 This file is part of BFD, the Binary File Descriptor library.
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 2 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program; if not, write to the Free Software
22 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
25 /****************************************
29 This is only a partial ELF implementation,
30 incorporating only those parts that are
31 required to get gdb up and running. It is
32 expected that it will be expanded to a full
33 ELF implementation at some future date.
35 Unimplemented stubs call abort() to ensure
36 that they get proper attention if they are
37 ever called. The stubs are here since
38 this version was hacked from the COFF
39 version, and thus they will probably
40 go away or get expanded appropriately in a
45 *****************************************/
48 /* Problems and other issues to resolve.
50 (1) BFD expects there to be some fixed number of "sections" in
51 the object file. I.E. there is a "section_count" variable in the
52 bfd structure which contains the number of sections. However, ELF
53 supports multiple "views" of a file. In particular, with current
54 implementations, executable files typically have two tables, a
55 program header table and a section header table, both of which
56 partition the executable.
58 In ELF-speak, the "linking view" of the file uses the section header
59 table to access "sections" within the file, and the "execution view"
60 uses the program header table to access "segments" within the file.
61 "Segments" typically may contain all the data from one or more
64 Note that the section header table is optional in ELF executables,
65 but it is this information that is most useful to gdb. If the
66 section header table is missing, then gdb should probably try
67 to make do with the program header table. (FIXME)
75 #include "elf/common.h"
76 #include "elf/internal.h"
77 #include "elf/external.h"
79 #ifdef HAVE_PROCFS /* Some core file support requires host /proc files */
80 #include <sys/procfs.h>
82 #define bfd_prstatus(abfd, descdata, descsz, filepos) /* Define away */
83 #define bfd_fpregset(abfd, descdata, descsz, filepos) /* Define away */
84 #define bfd_prpsinfo(abfd, descdata, descsz, filepos) /* Define away */
87 /* Forward data declarations */
89 extern bfd_target elf_little_vec, elf_big_vec;
91 /* Currently the elf_symbol_type struct just contains the generic bfd
99 /* Some private data is stashed away for future use using the tdata pointer
100 in the bfd structure. This information is different for ELF core files
101 and other ELF files. */
103 typedef struct elf_core_tdata_struct
105 void *prstatus; /* The raw /proc prstatus structure */
106 void *prpsinfo; /* The raw /proc prpsinfo structure */
109 #define core_prpsinfo(bfd) (((bfd)->tdata.elf_core_data))->prpsinfo)
110 #define core_prpstatus(bfd) (((bfd)->tdata.elf_core_data))->prpstatus)
113 typedef struct elf_obj_tdata_struct
115 file_ptr symtab_filepos; /* Offset to start of ELF symtab section */
116 long symtab_filesz; /* Size of ELF symtab section */
117 file_ptr strtab_filepos; /* Offset to start of ELF string tbl section */
118 long strtab_filesz; /* Size of ELF string tbl section */
121 #define elf_tdata(bfd) ((bfd) -> tdata.elf_obj_data)
122 #define elf_symtab_filepos(bfd) (elf_tdata(bfd) -> symtab_filepos)
123 #define elf_symtab_filesz(bfd) (elf_tdata(bfd) -> symtab_filesz)
124 #define elf_strtab_filepos(bfd) (elf_tdata(bfd) -> strtab_filepos)
125 #define elf_strtab_filesz(bfd) (elf_tdata(bfd) -> strtab_filesz)
127 /* Translate an ELF symbol in external format into an ELF symbol in internal
131 DEFUN(elf_swap_symbol_in,(abfd, src, dst),
133 Elf_External_Sym *src AND
134 Elf_Internal_Sym *dst)
136 dst -> st_name = bfd_h_get_32 (abfd, (bfd_byte *) src -> st_name);
137 dst -> st_value = bfd_h_get_32 (abfd, (bfd_byte *) src -> st_value);
138 dst -> st_size = bfd_h_get_32 (abfd, (bfd_byte *) src -> st_size);
139 dst -> st_info = bfd_h_get_8 (abfd, (bfd_byte *) src -> st_info);
140 dst -> st_other = bfd_h_get_8 (abfd, (bfd_byte *) src -> st_other);
141 dst -> st_shndx = bfd_h_get_16 (abfd, (bfd_byte *) src -> st_shndx);
145 /* Translate an ELF file header in external format into an ELF file header in
149 DEFUN(elf_swap_ehdr_in,(abfd, src, dst),
151 Elf_External_Ehdr *src AND
152 Elf_Internal_Ehdr *dst)
154 memcpy (dst -> e_ident, src -> e_ident, EI_NIDENT);
155 dst -> e_type = bfd_h_get_16 (abfd, (bfd_byte *) src -> e_type);
156 dst -> e_machine = bfd_h_get_16 (abfd, (bfd_byte *) src -> e_machine);
157 dst -> e_version = bfd_h_get_32 (abfd, (bfd_byte *) src -> e_version);
158 dst -> e_entry = bfd_h_get_32 (abfd, (bfd_byte *) src -> e_entry);
159 dst -> e_phoff = bfd_h_get_32 (abfd, (bfd_byte *) src -> e_phoff);
160 dst -> e_shoff = bfd_h_get_32 (abfd, (bfd_byte *) src -> e_shoff);
161 dst -> e_flags = bfd_h_get_32 (abfd, (bfd_byte *) src -> e_flags);
162 dst -> e_ehsize = bfd_h_get_16 (abfd, (bfd_byte *) src -> e_ehsize);
163 dst -> e_phentsize = bfd_h_get_16 (abfd, (bfd_byte *) src -> e_phentsize);
164 dst -> e_phnum = bfd_h_get_16 (abfd, (bfd_byte *) src -> e_phnum);
165 dst -> e_shentsize = bfd_h_get_16 (abfd, (bfd_byte *) src -> e_shentsize);
166 dst -> e_shnum = bfd_h_get_16 (abfd, (bfd_byte *) src -> e_shnum);
167 dst -> e_shstrndx = bfd_h_get_16 (abfd, (bfd_byte *) src -> e_shstrndx);
171 /* Translate an ELF section header table entry in external format into an
172 ELF section header table entry in internal format. */
175 DEFUN(elf_swap_shdr_in,(abfd, src, dst),
177 Elf_External_Shdr *src AND
178 Elf_Internal_Shdr *dst)
180 dst -> sh_name = bfd_h_get_32 (abfd, (bfd_byte *) src -> sh_name);
181 dst -> sh_type = bfd_h_get_32 (abfd, (bfd_byte *) src -> sh_type);
182 dst -> sh_flags = bfd_h_get_32 (abfd, (bfd_byte *) src -> sh_flags);
183 dst -> sh_addr = bfd_h_get_32 (abfd, (bfd_byte *) src -> sh_addr);
184 dst -> sh_offset = bfd_h_get_32 (abfd, (bfd_byte *) src -> sh_offset);
185 dst -> sh_size = bfd_h_get_32 (abfd, (bfd_byte *) src -> sh_size);
186 dst -> sh_link = bfd_h_get_32 (abfd, (bfd_byte *) src -> sh_link);
187 dst -> sh_info = bfd_h_get_32 (abfd, (bfd_byte *) src -> sh_info);
188 dst -> sh_addralign = bfd_h_get_32 (abfd, (bfd_byte *) src -> sh_addralign);
189 dst -> sh_entsize = bfd_h_get_32 (abfd, (bfd_byte *) src -> sh_entsize);
193 /* Translate an ELF program header table entry in external format into an
194 ELF program header table entry in internal format. */
197 DEFUN(elf_swap_phdr_in,(abfd, src, dst),
199 Elf_External_Phdr *src AND
200 Elf_Internal_Phdr *dst)
202 dst -> p_type = bfd_h_get_32 (abfd, (bfd_byte *) src -> p_type);
203 dst -> p_offset = bfd_h_get_32 (abfd, (bfd_byte *) src -> p_offset);
204 dst -> p_vaddr = bfd_h_get_32 (abfd, (bfd_byte *) src -> p_vaddr);
205 dst -> p_paddr = bfd_h_get_32 (abfd, (bfd_byte *) src -> p_paddr);
206 dst -> p_filesz = bfd_h_get_32 (abfd, (bfd_byte *) src -> p_filesz);
207 dst -> p_memsz = bfd_h_get_32 (abfd, (bfd_byte *) src -> p_memsz);
208 dst -> p_flags = bfd_h_get_32 (abfd, (bfd_byte *) src -> p_flags);
209 dst -> p_align = bfd_h_get_32 (abfd, (bfd_byte *) src -> p_align);
213 /* Create a new bfd section from an ELF section header. */
216 DEFUN(bfd_section_from_shdr, (abfd, hdr, shstrtab),
218 Elf_Internal_Shdr *hdr AND
224 name = hdr -> sh_name ? shstrtab + hdr -> sh_name : "unnamed";
225 newsect = bfd_make_section (abfd, name);
226 newsect -> vma = hdr -> sh_addr;
227 newsect -> _raw_size = hdr -> sh_size;
228 if (!(hdr -> sh_type == SHT_NOBITS))
230 newsect -> filepos = hdr -> sh_offset;
231 newsect -> flags |= SEC_HAS_CONTENTS;
233 if (hdr -> sh_flags & SHF_ALLOC)
235 newsect -> flags |= SEC_ALLOC;
236 if (hdr -> sh_type != SHT_NOBITS)
238 newsect -> flags |= SEC_LOAD;
241 if (!(hdr -> sh_flags & SHF_WRITE))
243 newsect -> flags |= SEC_READONLY;
245 if (hdr -> sh_flags & SHF_EXECINSTR)
247 newsect -> flags |= SEC_CODE; /* FIXME: may only contain SOME code */
251 newsect -> flags |= SEC_DATA;
253 if (hdr -> sh_type == SHT_SYMTAB)
255 abfd -> flags |= HAS_SYMS;
261 /* Create a new bfd section from an ELF program header.
263 Since program segments have no names, we generate a synthetic name
264 of the form segment<NUM>, where NUM is generally the index in the
265 program header table. For segments that are split (see below) we
266 generate the names segment<NUM>a and segment<NUM>b.
268 Note that some program segments may have a file size that is different than
269 (less than) the memory size. All this means is that at execution the
270 system must allocate the amount of memory specified by the memory size,
271 but only initialize it with the first "file size" bytes read from the
272 file. This would occur for example, with program segments consisting
273 of combined data+bss.
275 To handle the above situation, this routine generates TWO bfd sections
276 for the single program segment. The first has the length specified by
277 the file size of the segment, and the second has the length specified
278 by the difference between the two sizes. In effect, the segment is split
279 into it's initialized and uninitialized parts.
284 DEFUN(bfd_section_from_phdr, (abfd, hdr, index),
286 Elf_Internal_Phdr *hdr AND
294 split = ((hdr -> p_memsz > 0) &&
295 (hdr -> p_filesz > 0) &&
296 (hdr -> p_memsz > hdr -> p_filesz));
297 sprintf (namebuf, split ? "segment%da" : "segment%d", index);
298 name = bfd_alloc (abfd, strlen (namebuf) + 1);
299 (void) strcpy (name, namebuf);
300 newsect = bfd_make_section (abfd, name);
301 newsect -> vma = hdr -> p_vaddr;
302 newsect -> _raw_size = hdr -> p_filesz;
303 newsect -> filepos = hdr -> p_offset;
304 newsect -> flags |= SEC_HAS_CONTENTS;
305 if (hdr -> p_type == PT_LOAD)
307 newsect -> flags |= SEC_ALLOC;
308 newsect -> flags |= SEC_LOAD;
309 if (hdr -> p_flags & PF_X)
311 /* FIXME: all we known is that it has execute PERMISSION,
313 newsect -> flags |= SEC_CODE;
316 if (!(hdr -> p_flags & PF_W))
318 newsect -> flags |= SEC_READONLY;
323 sprintf (namebuf, "segment%db", index);
324 name = bfd_alloc (abfd, strlen (namebuf) + 1);
325 (void) strcpy (name, namebuf);
326 newsect = bfd_make_section (abfd, name);
327 newsect -> vma = hdr -> p_vaddr + hdr -> p_filesz;
328 newsect -> _raw_size = hdr -> p_memsz - hdr -> p_filesz;
329 if (hdr -> p_type == PT_LOAD)
331 newsect -> flags |= SEC_ALLOC;
332 if (hdr -> p_flags & PF_X)
334 newsect -> flags |= SEC_CODE;
337 if (!(hdr -> p_flags & PF_W))
339 newsect -> flags |= SEC_READONLY;
349 DEFUN(bfd_prstatus,(abfd, descdata, descsz, filepos),
357 if (descsz == sizeof (prstatus_t))
359 newsect = bfd_make_section (abfd, ".reg");
360 newsect -> size = sizeof (gregset_t);
361 newsect -> filepos = filepos + (long) (((prstatus_t *)0) -> pr_reg);
362 newsect -> flags = SEC_ALLOC | SEC_HAS_CONTENTS;
363 newsect -> alignment_power = 2;
364 if ((core_prstatus (abfd) = bfd_alloc (abfd, descsz)) != NULL)
366 memcpy (core_prstatus (abfd), descdata, descsz);
371 /* Stash a copy of the prpsinfo structure away for future use. */
374 DEFUN(bfd_prpsinfo,(abfd, descdata, descsz, filepos),
382 if (descsz == sizeof (prpsinfo_t))
384 if ((core_prpsinfo (abfd) = bfd_alloc (abfd, descsz)) != NULL)
386 bcopy (descdata, core_prpsinfo (abfd), descsz);
392 DEFUN(bfd_fpregset,(abfd, descdata, descsz, filepos),
400 if (descsz == sizeof (fpregset_t))
402 newsect = bfd_make_section (abfd, ".reg2");
403 newsect -> size = sizeof (fpregset_t);
404 newsect -> filepos = filepos;
405 newsect -> flags = SEC_ALLOC | SEC_HAS_CONTENTS;
406 newsect -> alignment_power = 2;
410 #endif /* HAVE_PROCFS */
412 /* Return a pointer to the args (including the command name) that were
413 seen by the program that generated the core dump. Note that for
414 some reason, a spurious space is tacked onto the end of the args
415 in some (at least one anyway) implementations, so strip it off if
419 DEFUN(elf_core_file_failing_command, (abfd),
423 if (core_prpsinfo (abfd))
425 prpsinfo_t *p = core_prpsinfo (abfd);
426 char *scan = p -> pr_psargs;
429 if ((scan > p -> pr_psargs) && (*scan == ' '))
433 return (p -> pr_psargs);
439 /* Return the number of the signal that caused the core dump. Presumably,
440 since we have a core file, we got a signal of some kind, so don't bother
441 checking the other process status fields, just return the signal number.
445 DEFUN(elf_core_file_failing_signal, (abfd),
449 if (core_prstatus (abfd))
451 return (((prstatus_t *)(core_prstatus (abfd))) -> pr_cursig);
457 /* Check to see if the core file could reasonably be expected to have
458 come for the current executable file. Note that by default we return
459 true unless we find something that indicates that there might be a
464 DEFUN(elf_core_file_matches_executable_p, (core_bfd, exec_bfd),
473 /* First, xvecs must match since both are ELF files for the same target. */
475 if (core_bfd->xvec != exec_bfd->xvec)
477 bfd_error = system_call_error;
483 /* If no prpsinfo, just return true. Otherwise, grab the last component
484 of the exec'd pathname from the prpsinfo. */
486 if (core_prpsinfo (core_bfd))
488 corename = (((struct prpsinfo *) core_prpsinfo (core_bfd)) -> pr_fname);
495 /* Find the last component of the executable pathname. */
497 if ((execname = strrchr (exec_bfd -> filename, '/')) != NULL)
503 execname = (char *) exec_bfd -> filename;
506 /* See if they match */
508 return (strcmp (execname, corename) ? false : true);
514 #endif /* HAVE_PROCFS */
517 /* ELF core files contain a segment of type PT_NOTE, that holds much of
518 the information that would normally be available from the /proc interface
519 for the process, at the time the process dumped core. Currently this
520 includes copies of the prstatus, prpsinfo, and fpregset structures.
522 Since these structures are potentially machine dependent in size and
523 ordering, bfd provides two levels of support for them. The first level,
524 available on all machines since it does not require that the host
525 have /proc support or the relevant include files, is to create a bfd
526 section for each of the prstatus, prpsinfo, and fpregset structures,
527 without any interpretation of their contents. With just this support,
528 the bfd client will have to interpret the structures itself. Even with
529 /proc support, it might want these full structures for it's own reasons.
531 In the second level of support, where HAVE_PROCFS is defined, bfd will
532 pick apart the structures to gather some additional information that
533 clients may want, such as the general register set, the name of the
534 exec'ed file and its arguments, the signal (if any) that caused the
540 DEFUN(elf_corefile_note, (abfd, hdr),
542 Elf_Internal_Phdr *hdr)
544 Elf_External_Note *x_note_p; /* Elf note, external form */
545 Elf_Internal_Note i_note; /* Elf note, internal form */
546 char *buf = NULL; /* Entire note segment contents */
547 char *namedata; /* Name portion of the note */
548 char *descdata; /* Descriptor portion of the note */
549 char *sectname; /* Name to use for new section */
550 long filepos; /* File offset to descriptor data */
553 if (hdr -> p_filesz > 0
554 && (buf = (char *)malloc(hdr -> p_filesz)) != NULL
555 && bfd_seek (abfd, hdr -> p_offset, SEEK_SET) != -1L
556 && bfd_read ((PTR) buf, hdr -> p_filesz, 1, abfd) == hdr -> p_filesz)
558 x_note_p = (Elf_External_Note *) buf;
559 while ((char *) x_note_p < (buf + hdr -> p_filesz))
561 i_note.namesz = bfd_h_get_32 (abfd, (bfd_byte *) x_note_p -> namesz);
562 i_note.descsz = bfd_h_get_32 (abfd, (bfd_byte *) x_note_p -> descsz);
563 i_note.type = bfd_h_get_32 (abfd, (bfd_byte *) x_note_p -> type);
564 namedata = x_note_p -> name;
565 descdata = namedata + BFD_ALIGN (i_note.namesz, 4);
566 filepos = hdr -> p_offset + (descdata - buf);
567 switch (i_note.type) {
569 /* process descdata as prstatus info */
570 bfd_prstatus (abfd, descdata, i_note.descsz, filepos);
571 sectname = ".prstatus";
574 /* process descdata as fpregset info */
575 bfd_fpregset (abfd, descdata, i_note.descsz, filepos);
576 sectname = ".fpregset";
579 /* process descdata as prpsinfo */
580 bfd_prpsinfo (abfd, descdata, i_note.descsz, filepos);
581 sectname = ".prpsinfo";
584 /* Unknown descriptor, just ignore it. */
588 if (sectname != NULL)
590 newsect = bfd_make_section (abfd, sectname);
591 newsect -> _raw_size = i_note.descsz;
592 newsect -> filepos = filepos;
593 newsect -> flags = SEC_ALLOC | SEC_HAS_CONTENTS;
594 newsect -> alignment_power = 2;
596 x_note_p = (Elf_External_Note *)
597 (descdata + BFD_ALIGN (i_note.descsz, 4));
609 /* Read a specified number of bytes at a specified offset in an ELF
610 file, into a newly allocated buffer, and return a pointer to the
614 DEFUN(elf_read, (abfd, offset, size),
621 if ((buf = bfd_alloc (abfd, size)) == NULL)
623 bfd_error = no_memory;
626 if (bfd_seek (abfd, offset, SEEK_SET) == -1)
628 bfd_error = system_call_error;
631 if (bfd_read ((PTR) buf, size, 1, abfd) != size)
633 bfd_error = system_call_error;
639 /* Begin processing a given object.
641 First we validate the file by reading in the ELF header and checking
647 DEFUN (elf_object_p, (abfd), bfd *abfd)
649 Elf_External_Ehdr x_ehdr; /* Elf file header, external form */
650 Elf_Internal_Ehdr i_ehdr; /* Elf file header, internal form */
651 Elf_External_Shdr *x_shdr; /* Section header table, external form */
652 Elf_Internal_Shdr *i_shdr; /* Section header table, internal form */
654 char *shstrtab; /* Internal copy of section header stringtab */
655 int shstrtabsize; /* Size of section header string table */
656 Elf_Off offset; /* Temp place to stash file offsets */
658 /* Read in the ELF header in external format. */
660 if (bfd_read ((PTR) &x_ehdr, sizeof (x_ehdr), 1, abfd) != sizeof (x_ehdr))
662 bfd_error = system_call_error;
666 /* Now check to see if we have a valid ELF file, and one that BFD can
667 make use of. The magic number must match, the address size ('class')
668 and byte-swapping must match our XVEC entry, and it must have a
669 section header table (FIXME: See comments re sections at top of this
672 if (x_ehdr.e_ident[EI_MAG0] != ELFMAG0 ||
673 x_ehdr.e_ident[EI_MAG1] != ELFMAG1 ||
674 x_ehdr.e_ident[EI_MAG2] != ELFMAG2 ||
675 x_ehdr.e_ident[EI_MAG3] != ELFMAG3)
678 bfd_error = wrong_format;
682 /* FIXME, Check EI_VERSION here ! */
684 switch (x_ehdr.e_ident[EI_CLASS]) {
685 case ELFCLASSNONE: /* address size not specified */
686 goto wrong; /* No support if can't tell address size */
687 case ELFCLASS32: /* 32-bit addresses */
689 case ELFCLASS64: /* 64-bit addresses */
690 goto wrong; /* FIXME: 64 bits not yet supported */
692 goto wrong; /* No support if unknown address class */
695 /* Switch xvec to match the specified byte order. */
696 switch (x_ehdr.e_ident[EI_DATA]) {
697 case ELFDATA2MSB: /* Big-endian */
698 abfd->xvec = &elf_big_vec;
700 case ELFDATA2LSB: /* Little-endian */
701 abfd->xvec = &elf_little_vec;
703 case ELFDATANONE: /* No data encoding specified */
704 default: /* Unknown data encoding specified */
708 /* Allocate an instance of the elf_obj_tdata structure and hook it up to
709 the tdata pointer in the bfd. */
711 if ((abfd -> tdata.elf_obj_data =
712 (elf_obj_tdata*) bfd_zalloc (abfd, sizeof (elf_obj_tdata)))
715 bfd_error = no_memory;
719 /* Now that we know the byte order, swap in the rest of the header */
720 elf_swap_ehdr_in (abfd, &x_ehdr, &i_ehdr);
722 /* If there is no section header table, we're hosed. */
723 if (i_ehdr.e_shoff == 0)
726 if (i_ehdr.e_type == ET_EXEC || i_ehdr.e_type == ET_DYN)
728 abfd -> flags |= EXEC_P;
731 /* Allocate space for copies of the section header table in external
732 and internal form, seek to the section header table in the file,
733 read it in, and convert it to internal form. As a simple sanity
734 check, verify that the what BFD thinks is the size of each section
735 header table entry actually matches the size recorded in the file. */
737 if (i_ehdr.e_shentsize != sizeof (*x_shdr))
739 if ((x_shdr = (Elf_External_Shdr *)
740 bfd_alloc (abfd, sizeof (*x_shdr) * i_ehdr.e_shnum)) == NULL)
742 bfd_error = no_memory;
745 if ((i_shdr = (Elf_Internal_Shdr *)
746 bfd_alloc (abfd, sizeof (*i_shdr) * i_ehdr.e_shnum)) == NULL)
748 bfd_error = no_memory;
751 if (bfd_seek (abfd, i_ehdr.e_shoff, SEEK_SET) == -1)
753 bfd_error = system_call_error;
756 for (shindex = 0; shindex < i_ehdr.e_shnum; shindex++)
758 if (bfd_read ((PTR) (x_shdr + shindex), sizeof (*x_shdr), 1, abfd)
761 bfd_error = system_call_error;
764 elf_swap_shdr_in (abfd, x_shdr + shindex, i_shdr + shindex);
767 /* Read in the string table containing the names of the sections. We
768 will need the base pointer to this table later. */
770 shstrtabsize = i_shdr[i_ehdr.e_shstrndx].sh_size;
771 offset = i_shdr[i_ehdr.e_shstrndx].sh_offset;
772 if ((shstrtab = elf_read (abfd, offset, shstrtabsize)) == NULL)
777 /* Once all of the section headers have been read and converted, we
778 can start processing them. Note that the first section header is
779 a dummy placeholder entry, so we ignore it.
781 We also watch for the symbol table section and remember the file
782 offset and section size for both the symbol table section and the
783 associated string table section. */
785 for (shindex = 1; shindex < i_ehdr.e_shnum; shindex++)
787 Elf_Internal_Shdr *hdr = i_shdr + shindex;
788 bfd_section_from_shdr (abfd, hdr, shstrtab);
789 if (hdr -> sh_type == SHT_SYMTAB)
791 elf_symtab_filepos(abfd) = hdr -> sh_offset;
792 elf_symtab_filesz(abfd) = hdr -> sh_size;
793 elf_strtab_filepos(abfd) = (i_shdr + hdr -> sh_link) -> sh_offset;
794 elf_strtab_filesz(abfd) = (i_shdr + hdr -> sh_link) -> sh_size;
798 /* Remember the entry point specified in the ELF file header. */
800 bfd_get_start_address (abfd) = i_ehdr.e_entry;
805 /* Core files are simply standard ELF formatted files that partition
806 the file using the execution view of the file (program header table)
807 rather than the linking view. In fact, there is no section header
808 table in a core file.
810 The process status information (including the contents of the general
811 register set) and the floating point register set are stored in a
812 segment of type PT_NOTE. We handcraft a couple of extra bfd sections
813 that allow standard bfd access to the general registers (.reg) and the
814 floating point registers (.reg2).
819 DEFUN (elf_core_file_p, (abfd), bfd *abfd)
821 Elf_External_Ehdr x_ehdr; /* Elf file header, external form */
822 Elf_Internal_Ehdr i_ehdr; /* Elf file header, internal form */
823 Elf_External_Phdr *x_phdr; /* Program header table, external form */
824 Elf_Internal_Phdr *i_phdr; /* Program header table, internal form */
827 /* Read in the ELF header in external format. */
829 if (bfd_read ((PTR) &x_ehdr, sizeof (x_ehdr), 1, abfd) != sizeof (x_ehdr))
831 bfd_error = system_call_error;
835 /* Now check to see if we have a valid ELF file, and one that BFD can
836 make use of. The magic number must match, the address size ('class')
837 and byte-swapping must match our XVEC entry, and it must have a
838 program header table (FIXME: See comments re segments at top of this
841 if (x_ehdr.e_ident[EI_MAG0] != ELFMAG0 ||
842 x_ehdr.e_ident[EI_MAG1] != ELFMAG1 ||
843 x_ehdr.e_ident[EI_MAG2] != ELFMAG2 ||
844 x_ehdr.e_ident[EI_MAG3] != ELFMAG3)
847 bfd_error = wrong_format;
851 /* FIXME, Check EI_VERSION here ! */
853 switch (x_ehdr.e_ident[EI_CLASS]) {
854 case ELFCLASSNONE: /* address size not specified */
855 goto wrong; /* No support if can't tell address size */
856 case ELFCLASS32: /* 32-bit addresses */
858 case ELFCLASS64: /* 64-bit addresses */
859 goto wrong; /* FIXME: 64 bits not yet supported */
861 goto wrong; /* No support if unknown address class */
864 /* Switch xvec to match the specified byte order. */
865 switch (x_ehdr.e_ident[EI_DATA]) {
866 case ELFDATA2MSB: /* Big-endian */
867 abfd->xvec = &elf_big_vec;
869 case ELFDATA2LSB: /* Little-endian */
870 abfd->xvec = &elf_little_vec;
872 case ELFDATANONE: /* No data encoding specified */
873 default: /* Unknown data encoding specified */
877 /* Now that we know the byte order, swap in the rest of the header */
878 elf_swap_ehdr_in (abfd, &x_ehdr, &i_ehdr);
880 /* If there is no program header, or the type is not a core file, then
882 if (i_ehdr.e_phoff == 0 || i_ehdr.e_type != ET_CORE)
885 /* Allocate an instance of the elf_core_tdata structure and hook it up to
886 the tdata pointer in the bfd. */
888 if ((abfd -> tdata.elf_core_data =
889 (elf_core_tdata *) bfd_zalloc (abfd, sizeof (elf_core_tdata)))
892 bfd_error = no_memory;
896 /* Allocate space for copies of the program header table in external
897 and internal form, seek to the program header table in the file,
898 read it in, and convert it to internal form. As a simple sanity
899 check, verify that the what BFD thinks is the size of each program
900 header table entry actually matches the size recorded in the file. */
902 if (i_ehdr.e_phentsize != sizeof (*x_phdr))
904 if ((x_phdr = (Elf_External_Phdr *)
905 bfd_alloc (abfd, sizeof (*x_phdr) * i_ehdr.e_phnum)) == NULL)
907 bfd_error = no_memory;
910 if ((i_phdr = (Elf_Internal_Phdr *)
911 bfd_alloc (abfd, sizeof (*i_phdr) * i_ehdr.e_phnum)) == NULL)
913 bfd_error = no_memory;
916 if (bfd_seek (abfd, i_ehdr.e_phoff, SEEK_SET) == -1)
918 bfd_error = system_call_error;
921 for (phindex = 0; phindex < i_ehdr.e_phnum; phindex++)
923 if (bfd_read ((PTR) (x_phdr + phindex), sizeof (*x_phdr), 1, abfd)
926 bfd_error = system_call_error;
929 elf_swap_phdr_in (abfd, x_phdr + phindex, i_phdr + phindex);
932 /* Once all of the program headers have been read and converted, we
933 can start processing them. */
935 for (phindex = 0; phindex < i_ehdr.e_phnum; phindex++)
937 bfd_section_from_phdr (abfd, i_phdr + phindex, phindex);
938 if ((i_phdr + phindex) -> p_type == PT_NOTE)
940 elf_corefile_note (abfd, i_phdr + phindex);
944 /* Remember the entry point specified in the ELF file header. */
946 bfd_get_start_address (abfd) = i_ehdr.e_entry;
952 DEFUN (elf_mkobject, (abfd), bfd *abfd)
954 fprintf (stderr, "elf_mkobject unimplemented\n");
961 DEFUN (elf_write_object_contents, (abfd), bfd *abfd)
963 fprintf (stderr, "elf_write_object_contents unimplemented\n");
969 /* Given an index of a section, retrieve a pointer to it. Note
970 that for our purposes, sections are indexed by {1, 2, ...} with
971 0 being an illegal index. */
974 DEFUN (section_from_bfd_index, (abfd, index),
980 struct sec *answer = abfd -> sections;
983 answer = answer -> next;
991 DEFUN (elf_slurp_symbol_table, (abfd), bfd *abfd)
993 int symcount; /* Number of external ELF symbols */
994 char *strtab; /* Buffer for raw ELF string table section */
995 asymbol *sym; /* Pointer to current bfd symbol */
996 asymbol *symbase; /* Buffer for generated bfd symbols */
997 asymbol **vec; /* Pointer to current bfd symbol pointer */
998 Elf_Internal_Sym i_sym;
999 Elf_External_Sym x_sym;
1001 if (bfd_get_outsymbols (abfd) != NULL)
1006 /* Slurp in the string table. We will keep it around permanently, as
1007 long as the bfd is in use, since we will end up setting up pointers
1008 into it for the names of all the symbols. */
1010 strtab = elf_read (abfd, elf_strtab_filepos(abfd), elf_strtab_filesz(abfd));
1016 /* Read each raw ELF symbol, converting from external ELF form to
1017 internal ELF form, and then using the information to create a
1018 canonical bfd symbol table entry.
1020 Note that be allocate the initial bfd canonical symbol buffer
1021 based on a one-to-one mapping of the ELF symbols to canonical
1022 symbols. However, it is likely that not all the ELF symbols will
1023 be used, so there will be some space leftover at the end. Once
1024 we know how many symbols we actual generate, we realloc the buffer
1025 to the correct size and then build the pointer vector. */
1027 if (bfd_seek (abfd, elf_symtab_filepos (abfd), SEEK_SET) == -1)
1029 bfd_error = system_call_error;
1033 symcount = elf_symtab_filesz(abfd) / sizeof (Elf_External_Sym);
1034 sym = symbase = (asymbol *) bfd_zalloc (abfd, symcount * sizeof (asymbol));
1036 while (symcount-- > 0)
1038 if (bfd_read ((PTR) &x_sym, sizeof (x_sym), 1, abfd) != sizeof (x_sym))
1040 bfd_error = system_call_error;
1043 elf_swap_symbol_in (abfd, &x_sym, &i_sym);
1044 if (i_sym.st_name > 0)
1046 sym -> the_bfd = abfd;
1047 sym -> name = strtab + i_sym.st_name;
1048 sym -> value = i_sym.st_value;
1049 if (i_sym.st_shndx > 0 && i_sym.st_shndx < SHN_LORESERV)
1051 /* Note: This code depends upon there being an ordered
1052 one-for-one mapping of ELF sections to bfd sections. */
1053 sym -> section = section_from_bfd_index (abfd, i_sym.st_shndx);
1055 else if (i_sym.st_shndx == SHN_ABS)
1057 /* sym -> flags |= BSF_ABSOLUTE; OBSOLETE */
1059 else if (i_sym.st_shndx == SHN_COMMON)
1061 sym -> section = &bfd_com_section;
1063 switch (ELF_ST_BIND (i_sym.st_info))
1066 sym -> flags |= BSF_LOCAL;
1069 sym -> flags |= (BSF_GLOBAL | BSF_EXPORT);
1072 sym -> flags |= BSF_WEAK;
1079 bfd_get_symcount(abfd) = symcount = sym - symbase;
1080 sym = symbase = (asymbol *)
1081 bfd_realloc (abfd, symbase, symcount * sizeof (asymbol));
1082 bfd_get_outsymbols(abfd) = vec = (asymbol **)
1083 bfd_alloc (abfd, symcount * sizeof (asymbol *));
1085 while (symcount-- > 0)
1093 /* Return the number of bytes required to hold the symtab vector.
1095 Note that we base it on the count plus 1, since we will null terminate
1096 the vector allocated based on this size. */
1099 DEFUN (elf_get_symtab_upper_bound, (abfd), bfd *abfd)
1101 unsigned int symtab_size = 0;
1103 if (elf_slurp_symbol_table (abfd))
1105 symtab_size = (bfd_get_symcount (abfd) + 1) * (sizeof (asymbol));
1107 return (symtab_size);
1111 elf_get_reloc_upper_bound (abfd, asect)
1115 fprintf (stderr, "elf_get_reloc_upper_bound unimplemented\n");
1122 elf_canonicalize_reloc (abfd, section, relptr, symbols)
1128 fprintf (stderr, "elf_canonicalize_reloc unimplemented\n");
1135 DEFUN (elf_get_symtab, (abfd, alocation),
1137 asymbol **alocation)
1139 unsigned int symcount;
1142 if (!elf_slurp_symbol_table (abfd))
1148 symcount = bfd_get_symcount (abfd);
1149 vec = bfd_get_outsymbols (abfd);
1150 while (symcount-- > 0)
1152 *alocation++ = *vec++;
1154 *alocation++ = NULL;
1155 return (bfd_get_symcount (abfd));
1160 elf_make_empty_symbol(abfd)
1163 fprintf (stderr, "elf_make_empty_symbol unimplemented\n");
1170 DEFUN (elf_print_symbol,(ignore_abfd, filep, symbol, how),
1171 bfd *ignore_abfd AND
1174 bfd_print_symbol_type how)
1176 fprintf (stderr, "elf_print_symbol unimplemented\n");
1182 DEFUN (elf_get_lineno,(ignore_abfd, symbol),
1183 bfd *ignore_abfd AND
1186 fprintf (stderr, "elf_get_lineno unimplemented\n");
1193 DEFUN (elf_set_arch_mach,(abfd, arch, machine),
1195 enum bfd_architecture arch AND
1196 unsigned long machine)
1198 fprintf (stderr, "elf_set_arch_mach unimplemented\n");
1200 /* Allow any architecture to be supported by the elf backend */
1201 return bfd_default_set_arch_mach(abfd, arch, machine);
1205 DEFUN (elf_find_nearest_line,(abfd,
1213 asection *section AND
1214 asymbol **symbols AND
1216 CONST char **filename_ptr AND
1217 CONST char **functionname_ptr AND
1218 unsigned int *line_ptr)
1220 fprintf (stderr, "elf_find_nearest_line unimplemented\n");
1227 DEFUN (elf_sizeof_headers, (abfd, reloc),
1231 fprintf (stderr, "elf_sizeof_headers unimplemented\n");
1237 /* This structure contains everything that BFD knows about a target.
1238 It includes things like its byte order, name, what routines to call
1239 to do various operations, etc. Every BFD points to a target structure
1240 with its "xvec" member.
1242 There are two such structures here: one for big-endian machines and
1243 one for little-endian machines. */
1245 /* Archives are generic or unimplemented. */
1246 #define elf_slurp_armap bfd_false
1247 #define elf_slurp_extended_name_table _bfd_slurp_extended_name_table
1248 #define elf_truncate_arname bfd_dont_truncate_arname
1249 #define elf_openr_next_archived_file bfd_generic_openr_next_archived_file
1250 #define elf_generic_stat_arch_elt bfd_generic_stat_arch_elt
1251 #define elf_write_armap (PROTO (boolean, (*), \
1252 (bfd *arch, unsigned int elength, struct orl *map, unsigned int orl_count, \
1253 int stridx))) bfd_false
1255 /* Ordinary section reading and writing */
1256 #define elf_new_section_hook _bfd_dummy_new_section_hook
1257 #define elf_get_section_contents bfd_generic_get_section_contents
1258 #define elf_set_section_contents bfd_generic_set_section_contents
1259 #define elf_close_and_cleanup bfd_generic_close_and_cleanup
1261 #define elf_bfd_debug_info_start bfd_void
1262 #define elf_bfd_debug_info_end bfd_void
1263 #define elf_bfd_debug_info_accumulate (PROTO(void,(*),(bfd*, struct sec *))) bfd_void
1264 #define elf_bfd_get_relocated_section_contents \
1265 bfd_generic_get_relocated_section_contents
1267 bfd_target elf_big_vec =
1269 /* name: identify kind of target */
1272 /* flavour: general indication about file */
1273 bfd_target_elf_flavour,
1275 /* byteorder_big_p: data is big endian */
1278 /* header_byteorder_big_p: header is also big endian */
1281 /* object_flags: mask of all file flags */
1282 (HAS_RELOC | EXEC_P | HAS_LINENO | HAS_DEBUG | HAS_SYMS | HAS_LOCALS |
1285 /* section_flags: mask of all section flags */
1286 (SEC_HAS_CONTENTS | SEC_ALLOC | SEC_LOAD | SEC_RELOC | SEC_READONLY |
1289 /* ar_pad_char: pad character for filenames within an archive header
1290 FIXME: this really has nothing to do with ELF, this is a characteristic
1291 of the archiver and/or os and should be independently tunable */
1294 /* ar_max_namelen: maximum number of characters in an archive header
1295 FIXME: this really has nothing to do with ELF, this is a characteristic
1296 of the archiver and should be independently tunable. This value is
1297 a WAG (wild a** guess) */
1300 /* align_power_min: minimum alignment restriction for any section
1301 FIXME: this value may be target machine dependent */
1304 /* Routines to byte-swap various sized integers from the data sections */
1305 _do_getb64, _do_putb64, _do_getb32, _do_putb32, _do_getb16, _do_putb16,
1307 /* Routines to byte-swap various sized integers from the file headers */
1308 _do_getb64, _do_putb64, _do_getb32, _do_putb32, _do_getb16, _do_putb16,
1310 /* bfd_check_format: check the format of a file being read */
1311 { _bfd_dummy_target, /* unknown format */
1312 elf_object_p, /* assembler/linker output (object file) */
1313 bfd_generic_archive_p, /* an archive */
1314 elf_core_file_p /* a core file */
1317 /* bfd_set_format: set the format of a file being written */
1320 _bfd_generic_mkarchive,
1324 /* bfd_write_contents: write cached information into a file being written */
1326 elf_write_object_contents,
1327 _bfd_write_archive_contents,
1331 /* Initialize a jump table with the standard macro. All names start
1339 bfd_target elf_little_vec =
1341 /* name: identify kind of target */
1344 /* flavour: general indication about file */
1345 bfd_target_elf_flavour,
1347 /* byteorder_big_p: data is big endian */
1348 false, /* Nope -- this one's little endian */
1350 /* header_byteorder_big_p: header is also big endian */
1351 false, /* Nope -- this one's little endian */
1353 /* object_flags: mask of all file flags */
1354 (HAS_RELOC | EXEC_P | HAS_LINENO | HAS_DEBUG | HAS_SYMS | HAS_LOCALS |
1357 /* section_flags: mask of all section flags */
1358 (SEC_HAS_CONTENTS | SEC_ALLOC | SEC_LOAD | SEC_RELOC | SEC_READONLY |
1361 /* ar_pad_char: pad character for filenames within an archive header
1362 FIXME: this really has nothing to do with ELF, this is a characteristic
1363 of the archiver and/or os and should be independently tunable */
1366 /* ar_max_namelen: maximum number of characters in an archive header
1367 FIXME: this really has nothing to do with ELF, this is a characteristic
1368 of the archiver and should be independently tunable. This value is
1369 a WAG (wild a** guess) */
1372 /* align_power_min: minimum alignment restriction for any section
1373 FIXME: this value may be target machine dependent */
1376 /* Routines to byte-swap various sized integers from the data sections */
1377 _do_getl64, _do_putl64, _do_getl32, _do_putl32, _do_getl16, _do_putl16,
1379 /* Routines to byte-swap various sized integers from the file headers */
1380 _do_getl64, _do_putl64, _do_getl32, _do_putl32, _do_getl16, _do_putl16,
1382 /* bfd_check_format: check the format of a file being read */
1383 { _bfd_dummy_target, /* unknown format */
1384 elf_object_p, /* assembler/linker output (object file) */
1385 bfd_generic_archive_p, /* an archive */
1386 elf_core_file_p /* a core file */
1389 /* bfd_set_format: set the format of a file being written */
1392 _bfd_generic_mkarchive,
1396 /* bfd_write_contents: write cached information into a file being written */
1398 elf_write_object_contents,
1399 _bfd_write_archive_contents,
1403 /* Initialize a jump table with the standard macro. All names start