1 /* IBM RS/6000 "XCOFF" back-end for BFD.
2 Copyright (C) 1990-2023 Free Software Foundation, Inc.
3 Written by Metin G. Ozisik, Mimi Phuong-Thao Vo, and John Gilmore.
4 Archive support from Damon A. Permezel.
5 Contributed by IBM Corporation and Cygnus Support.
7 This file is part of BFD, the Binary File Descriptor library.
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.
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.
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,
22 MA 02110-1301, USA. */
25 /* This port currently only handles reading object files, except when
26 compiled on an RS/6000 host. -- no archive support, no core files.
27 In all cases, it does not support writing.
29 This is in a separate file from coff-rs6000.c, because it includes
30 system include files that conflict with coff/rs6000.h. */
32 /* Internalcoff.h and coffcode.h modify themselves based on this flag. */
33 #define RS6000COFF_C 1
35 /* The AIX 4.1 kernel is obviously compiled with -D_LONG_LONG, so
36 we have to define _LONG_LONG for older versions of gcc to get the
37 proper alignments in the user structure. */
38 #if defined(_AIX41) && !defined(_LONG_LONG)
48 /* AOUTHDR is defined by the above. We need another defn of it, from the
49 system include files. Punt the old one and get us a new name for the
50 typedef in the system include files. */
54 #define AOUTHDR second_AOUTHDR
58 /* Support for core file stuff. */
61 #define __LDINFO_PTRACE32__ /* for __ld_info32 */
62 #define __LDINFO_PTRACE64__ /* for __ld_info64 */
65 #include <sys/systemcfg.h>
67 /* Borrowed from <sys/inttypes.h> on recent AIX versions. */
68 typedef unsigned long ptr_to_uint
;
70 #define core_hdr(bfd) ((CoreHdr *) bfd->tdata.any)
72 /* AIX 4.1 changed the names and locations of a few items in the core file.
73 AIX 4.3 defined an entirely new structure, core_dumpx, but kept support for
74 the previous 4.1 structure, core_dump.
76 AIX_CORE_DUMPX_CORE is defined (by configure) on AIX 4.3+, and
77 CORE_VERSION_1 is defined (by AIX core.h) as 2 on AIX 4.3+ and as 1 on AIX
78 4.1 and 4.2. AIX pre-4.1 (aka 3.x) either doesn't define CORE_VERSION_1
79 or else defines it as 0. */
81 #if defined(CORE_VERSION_1) && !CORE_VERSION_1
82 # undef CORE_VERSION_1
85 /* The following union and macros allow this module to compile on all AIX
86 versions and to handle both core_dumpx and core_dump on 4.3+. CNEW_*()
87 and COLD_*() macros respectively retrieve core_dumpx and core_dump
90 /* Union of 32-bit and 64-bit versions of ld_info. */
94 #if defined (__ld_info32) || defined (__ld_info64)
95 struct __ld_info32 l32
;
96 struct __ld_info64 l64
;
103 /* Union of old and new core dump structures. */
107 #ifdef AIX_CORE_DUMPX_CORE
108 struct core_dumpx new_dump
; /* New AIX 4.3+ core dump. */
110 struct core_dump new_dump
; /* For simpler coding. */
112 #ifndef BFD64 /* Use old only if gdb is 32-bit. */
113 struct core_dump old
; /* Old AIX 4.2- core dump, still used on
114 4.3+ with appropriate SMIT config. */
118 /* Union of old and new vm_info structures. */
120 #ifdef CORE_VERSION_1
123 #ifdef AIX_CORE_DUMPX_CORE
124 struct vm_infox new_dump
;
126 struct vm_info new_dump
;
134 /* Return whether CoreHdr C is in new or old format. */
136 #ifdef AIX_CORE_DUMPX_CORE
138 # define CORE_NEW(c) (!(c).old.c_entries)
140 # define CORE_NEW(c) 1
143 # define CORE_NEW(c) 0
146 /* Return whether CoreHdr C usese core_dumpxx structure.
148 FIXME: the core file format version number used here definitely indicates
149 that struct core_dumpxx should be used to represent the core file header,
150 but that may not be the only such format version number. */
153 # define CORE_DUMPXX_VERSION 267312562
154 # define CNEW_IS_CORE_DUMPXX(c) ((c).new_dump.c_version == CORE_DUMPXX_VERSION)
156 # define CNEW_IS_CORE_DUMPXX(c) 0
159 /* Return the c_stackorg field from struct core_dumpx C. */
161 #ifdef AIX_CORE_DUMPX_CORE
162 # define CNEW_STACKORG(c) (c).c_stackorg
164 # define CNEW_STACKORG(c) 0
167 /* Return the offset to the loader region from struct core_dump C. */
169 #ifdef AIX_CORE_DUMPX_CORE
170 # define CNEW_LOADER(c) (c).c_loader
172 # define CNEW_LOADER(c) 0
175 /* Return the offset to the loader region from struct core_dump C. */
177 #define COLD_LOADER(c) (c).c_tab
179 /* Return the c_lsize field from struct core_dumpx C. */
181 #ifdef AIX_CORE_DUMPX_CORE
182 # define CNEW_LSIZE(c) (c).c_lsize
184 # define CNEW_LSIZE(c) 0
187 /* Return the c_dataorg field from struct core_dumpx C. */
189 #ifdef AIX_CORE_DUMPX_CORE
190 # define CNEW_DATAORG(c) (c).c_dataorg
192 # define CNEW_DATAORG(c) 0
195 /* Return the c_datasize field from struct core_dumpx C. */
197 #ifdef AIX_CORE_DUMPX_CORE
198 # define CNEW_DATASIZE(c) (c).c_datasize
200 # define CNEW_DATASIZE(c) 0
203 /* Return the c_impl field from struct core_dumpx C. */
205 #if defined (HAVE_ST_C_IMPL) || defined (AIX_5_CORE)
206 # define CNEW_IMPL(c) (c).c_impl
208 # define CNEW_IMPL(c) 0
211 /* Return the command string from struct core_dumpx C. */
213 #ifdef AIX_CORE_DUMPX_CORE
214 # define CNEW_COMM(c) (c).c_u.U_proc.pi_comm
216 # define CNEW_COMM(c) 0
219 /* Return the command string from struct core_dump C. */
221 #ifdef CORE_VERSION_1
222 # define COLD_COMM(c) (c).c_u.U_comm
224 # define COLD_COMM(c) (c).c_u.u_comm
227 /* Return the struct __context64 pointer from struct core_dumpx C. */
229 #ifdef AIX_CORE_DUMPX_CORE
230 # define CNEW_CONTEXT64(c) (c).c_flt.hctx.r64
232 # define CNEW_CONTEXT64(c) c
235 /* Return the struct mstsave pointer from struct core_dumpx C. */
237 #ifdef AIX_CORE_DUMPX_CORE
238 # define CNEW_MSTSAVE(c) (c).c_flt.hctx.r32
240 # define CNEW_MSTSAVE(c) c
243 /* Return the struct mstsave pointer from struct core_dump C. */
245 #ifdef CORE_VERSION_1
246 # define COLD_MSTSAVE(c) (c).c_mst
248 # define COLD_MSTSAVE(c) (c).c_u.u_save
251 /* Return whether struct core_dumpx is from a 64-bit process. */
253 #ifdef AIX_CORE_DUMPX_CORE
254 # define CNEW_PROC64(c) IS_PROC64(&(c).c_u.U_proc)
256 # define CNEW_PROC64(c) 0
259 /* Magic end-of-stack addresses for old core dumps. This is _very_ fragile,
260 but I don't see any easy way to get that info right now. */
262 #ifdef CORE_VERSION_1
263 # define COLD_STACKEND 0x2ff23000
265 # define COLD_STACKEND 0x2ff80000
268 /* Size of the leading portion that old and new core dump structures have in
270 #ifdef AIX_CORE_DUMPX_CORE
271 #define CORE_COMMONSZ ((long) &((struct core_dumpx *) 0)->c_entries \
272 + sizeof (((struct core_dumpx *) 0)->c_entries))
274 #define CORE_COMMONSZ ((int) &((struct core_dump *) 0)->c_entries \
275 + sizeof (((struct core_dump *) 0)->c_entries))
277 /* Define prototypes for certain functions, to avoid a compiler warning
278 saying that they are missing. */
280 bfd_cleanup
rs6000coff_core_p (bfd
*abfd
);
281 bool rs6000coff_core_file_matches_executable_p (bfd
*core_bfd
, bfd
*exec_bfd
);
282 char * rs6000coff_core_file_failing_command (bfd
*abfd
);
283 int rs6000coff_core_file_failing_signal (bfd
*abfd
);
285 /* Try to read into CORE the header from the core file associated with ABFD.
289 read_hdr (bfd
*abfd
, CoreHdr
*core
)
293 if (bfd_seek (abfd
, (file_ptr
) 0, SEEK_SET
) != 0)
296 /* Read the leading portion that old and new core dump structures have in
298 size
= CORE_COMMONSZ
;
299 if (bfd_bread (core
, size
, abfd
) != size
)
302 /* Read the trailing portion of the structure. */
303 if (CORE_NEW (*core
))
304 size
= sizeof (core
->new_dump
);
307 size
= sizeof (core
->old
);
309 size
-= CORE_COMMONSZ
;
310 return bfd_bread ((char *) core
+ CORE_COMMONSZ
, size
, abfd
) == size
;
314 make_bfd_asection (bfd
*abfd
, const char *name
, flagword flags
,
315 bfd_size_type size
, bfd_vma vma
, file_ptr filepos
)
319 asect
= bfd_make_section_anyway_with_flags (abfd
, name
, flags
);
325 asect
->filepos
= filepos
;
326 asect
->alignment_power
= 8;
331 /* Decide if a given bfd represents a `core' file or not. There really is no
332 magic number or anything like, in rs6000coff. */
335 rs6000coff_core_p (bfd
*abfd
)
342 /* Values from new and old core structures. */
344 file_ptr c_stack
, c_regoff
, c_loader
;
345 bfd_size_type c_size
, c_regsize
, c_lsize
;
350 if (!read_hdr (abfd
, &core
))
352 if (bfd_get_error () != bfd_error_system_call
)
353 bfd_set_error (bfd_error_wrong_format
);
357 /* This isn't the right handler for 64-bit core files on AIX 5.x. */
358 if (CORE_NEW (core
) && CNEW_IS_CORE_DUMPXX (core
))
360 bfd_set_error (bfd_error_wrong_format
);
364 /* Copy fields from new or old core structure. */
367 c_flag
= core
.new_dump
.c_flag
;
368 c_stack
= (file_ptr
) core
.new_dump
.c_stack
;
369 c_size
= core
.new_dump
.c_size
;
370 c_stackend
= CNEW_STACKORG (core
.new_dump
) + c_size
;
371 c_lsize
= CNEW_LSIZE (core
.new_dump
);
372 c_loader
= CNEW_LOADER (core
.new_dump
);
374 proc64
= CNEW_PROC64 (core
.new_dump
);
378 c_flag
= core
.old
.c_flag
;
379 c_stack
= (file_ptr
) (ptr_to_uint
) core
.old
.c_stack
;
380 c_size
= core
.old
.c_size
;
381 c_stackend
= COLD_STACKEND
;
383 c_loader
= (file_ptr
) (ptr_to_uint
) COLD_LOADER (core
.old
);
390 c_regsize
= sizeof (CNEW_CONTEXT64 (core
.new_dump
));
391 c_regptr
= &CNEW_CONTEXT64 (core
.new_dump
);
393 else if (CORE_NEW (core
))
395 c_regsize
= sizeof (CNEW_MSTSAVE (core
.new_dump
));
396 c_regptr
= &CNEW_MSTSAVE (core
.new_dump
);
401 c_regsize
= sizeof (COLD_MSTSAVE (core
.old
));
402 c_regptr
= &COLD_MSTSAVE (core
.old
);
405 c_regoff
= (char *) c_regptr
- (char *) &core
;
407 if (bfd_stat (abfd
, &statbuf
) < 0)
409 bfd_set_error (bfd_error_system_call
);
413 /* If the core file ulimit is too small, the system will first
414 omit the data segment, then omit the stack, then decline to
415 dump core altogether (as far as I know UBLOCK_VALID and LE_VALID
416 are always set) (this is based on experimentation on AIX 3.2).
417 Now, the thing is that GDB users will be surprised
418 if segments just silently don't appear (well, maybe they would
419 think to check "info files", I don't know).
421 For the data segment, we have no choice but to keep going if it's
422 not there, since the default behavior is not to dump it (regardless
423 of the ulimit, it's based on SA_FULLDUMP). But for the stack segment,
424 if it's not there, we refuse to have anything to do with this core
425 file. The usefulness of a core dump without a stack segment is pretty
428 if (!(c_flag
& UBLOCK_VALID
)
429 || !(c_flag
& LE_VALID
))
431 bfd_set_error (bfd_error_wrong_format
);
435 if (!(c_flag
& USTACK_VALID
))
437 bfd_set_error (bfd_error_file_truncated
);
441 /* Don't check the core file size for a full core, AIX 4.1 includes
442 additional shared library sections in a full core. */
443 if (!(c_flag
& (FULL_CORE
| CORE_TRUNC
)))
445 /* If the size is wrong, it means we're misinterpreting something. */
446 if (c_stack
+ (file_ptr
) c_size
!= statbuf
.st_size
)
448 bfd_set_error (bfd_error_wrong_format
);
453 /* Sanity check on the c_tab field. */
457 c_loader
< (file_ptr
) sizeof core
.old
459 c_loader
< (file_ptr
) sizeof core
.new_dump
461 || c_loader
>= statbuf
.st_size
462 || c_loader
>= c_stack
))
464 bfd_set_error (bfd_error_wrong_format
);
468 /* Issue warning if the core file was truncated during writing. */
469 if (c_flag
& CORE_TRUNC
)
470 _bfd_error_handler (_("%pB: warning core file truncated"), abfd
);
472 /* Allocate core file header. */
474 size
= CORE_NEW (core
) ? sizeof (core
.new_dump
) : sizeof (core
.old
);
476 size
= sizeof (core
.new_dump
);
478 tmpptr
= (char *) bfd_zalloc (abfd
, (bfd_size_type
) size
);
482 /* Copy core file header. */
483 memcpy (tmpptr
, &core
, size
);
484 set_tdata (abfd
, tmpptr
);
486 /* Set architecture. */
489 enum bfd_architecture arch
;
492 switch (CNEW_IMPL (core
.new_dump
))
497 arch
= bfd_arch_rs6000
;
498 mach
= bfd_mach_rs6k
;
501 arch
= bfd_arch_powerpc
;
505 bfd_default_set_arch_mach (abfd
, arch
, mach
);
508 /* .stack section. */
509 if (!make_bfd_asection (abfd
, ".stack",
510 SEC_ALLOC
| SEC_LOAD
| SEC_HAS_CONTENTS
,
511 c_size
, c_stackend
- c_size
, c_stack
))
514 /* .reg section for all registers. */
515 if (!make_bfd_asection (abfd
, ".reg",
517 c_regsize
, (bfd_vma
) 0, c_regoff
))
521 To actually find out how long this section is in this particular
522 core dump would require going down the whole list of struct ld_info's.
523 See if we can just fake it. */
524 if (!make_bfd_asection (abfd
, ".ldinfo",
526 c_lsize
, (bfd_vma
) 0, c_loader
))
529 #ifndef CORE_VERSION_1
530 /* .data section if present.
531 AIX 3 dumps the complete data section and sets FULL_CORE if the
532 ulimit is large enough, otherwise the data section is omitted.
533 AIX 4 sets FULL_CORE even if the core file is truncated, we have
534 to examine core.c_datasize below to find out the actual size of
535 the .data section. */
536 if (c_flag
& FULL_CORE
)
538 if (!make_bfd_asection (abfd
, ".data",
539 SEC_ALLOC
| SEC_LOAD
| SEC_HAS_CONTENTS
,
540 (bfd_size_type
) core
.old
.c_u
.u_dsize
,
542 CDATA_ADDR (core
.old
.c_u
.u_dsize
),
548 #ifdef CORE_VERSION_1
549 /* AIX 4 adds data sections from loaded objects to the core file,
550 which can be found by examining ldinfo, and anonymously mmapped
554 bfd_size_type ldi_datasize
;
558 bfd_vma core_dataorg
;
560 /* Fields from new and old core structures. */
561 bfd_size_type c_datasize
, c_vmregions
;
562 file_ptr c_data
, c_vmm
;
566 c_datasize
= CNEW_DATASIZE (core
.new_dump
);
567 c_data
= (file_ptr
) core
.new_dump
.c_data
;
568 c_vmregions
= core
.new_dump
.c_vmregions
;
569 c_vmm
= (file_ptr
) core
.new_dump
.c_vmm
;
574 c_datasize
= core
.old
.c_datasize
;
575 c_data
= (file_ptr
) (ptr_to_uint
) core
.old
.c_data
;
576 c_vmregions
= core
.old
.c_vmregions
;
577 c_vmm
= (file_ptr
) (ptr_to_uint
) core
.old
.c_vmm
;
581 /* .data section from executable. */
584 /* If Large Memory Model is used, then the .data segment should start from
585 BDATAORG which has been defined in the system header files. */
587 if (c_flag
& CORE_BIGDATA
)
588 core_dataorg
= BDATAORG
;
590 core_dataorg
= CDATA_ADDR (c_datasize
);
592 if (!make_bfd_asection (abfd
, ".data",
593 SEC_ALLOC
| SEC_LOAD
| SEC_HAS_CONTENTS
,
595 (bfd_vma
) core_dataorg
,
600 /* .data sections from loaded objects. */
602 size
= (unsigned long) ((LdInfo
*) 0)->l64
.ldinfo_filename
;
604 size
= (unsigned long) ((LdInfo
*) 0)->l32
.ldinfo_filename
;
608 if (bfd_seek (abfd
, c_loader
, SEEK_SET
) != 0)
610 if (bfd_bread (&ldinfo
, size
, abfd
) != size
)
615 ldi_core
= ldinfo
.l64
.ldinfo_core
;
616 ldi_datasize
= ldinfo
.l64
.ldinfo_datasize
;
617 ldi_dataorg
= (bfd_vma
) ldinfo
.l64
.ldinfo_dataorg
;
618 ldi_next
= ldinfo
.l64
.ldinfo_next
;
622 ldi_core
= ldinfo
.l32
.ldinfo_core
;
623 ldi_datasize
= ldinfo
.l32
.ldinfo_datasize
;
624 ldi_dataorg
= (bfd_vma
) (ptr_to_uint
) ldinfo
.l32
.ldinfo_dataorg
;
625 ldi_next
= ldinfo
.l32
.ldinfo_next
;
629 if (!make_bfd_asection (abfd
, ".data",
630 SEC_ALLOC
| SEC_LOAD
| SEC_HAS_CONTENTS
,
631 ldi_datasize
, ldi_dataorg
, ldi_core
))
636 c_loader
+= ldi_next
;
639 /* .vmdata sections from anonymously mmapped regions. */
644 if (bfd_seek (abfd
, c_vmm
, SEEK_SET
) != 0)
647 for (i
= 0; i
< c_vmregions
; i
++)
650 bfd_size_type vminfo_size
;
651 file_ptr vminfo_offset
;
655 size
= CORE_NEW (core
) ? sizeof (vminfo
.new_dump
) : sizeof (vminfo
.old
);
657 size
= sizeof (vminfo
.new_dump
);
659 if (bfd_bread (&vminfo
, size
, abfd
) != size
)
664 vminfo_addr
= (bfd_vma
) vminfo
.new_dump
.vminfo_addr
;
665 vminfo_size
= vminfo
.new_dump
.vminfo_size
;
666 vminfo_offset
= vminfo
.new_dump
.vminfo_offset
;
671 vminfo_addr
= (bfd_vma
) (ptr_to_uint
) vminfo
.old
.vminfo_addr
;
672 vminfo_size
= vminfo
.old
.vminfo_size
;
673 vminfo_offset
= vminfo
.old
.vminfo_offset
;
678 if (!make_bfd_asection (abfd
, ".vmdata",
679 SEC_ALLOC
| SEC_LOAD
| SEC_HAS_CONTENTS
,
680 vminfo_size
, vminfo_addr
,
688 return _bfd_no_cleanup
;
691 bfd_release (abfd
, abfd
->tdata
.any
);
692 abfd
->tdata
.any
= NULL
;
693 bfd_section_list_clear (abfd
);
697 /* Return `TRUE' if given core is from the given executable. */
700 rs6000coff_core_file_matches_executable_p (bfd
*core_bfd
, bfd
*exec_bfd
)
706 const char *str1
, *str2
;
710 if (!read_hdr (core_bfd
, &core
))
714 c_loader
= CNEW_LOADER (core
.new_dump
);
717 c_loader
= (file_ptr
) (ptr_to_uint
) COLD_LOADER (core
.old
);
720 if (CORE_NEW (core
) && CNEW_PROC64 (core
.new_dump
))
721 size
= (int) ((LdInfo
*) 0)->l64
.ldinfo_filename
;
723 size
= (int) ((LdInfo
*) 0)->l32
.ldinfo_filename
;
725 if (bfd_seek (core_bfd
, c_loader
+ size
, SEEK_SET
) != 0)
729 path
= bfd_malloc ((bfd_size_type
) alloc
);
736 if (bfd_bread (s
, (bfd_size_type
) 1, core_bfd
) != 1)
744 if (s
== path
+ alloc
)
749 n
= bfd_realloc (path
, (bfd_size_type
) alloc
);
760 str1
= strrchr (path
, '/');
761 str2
= strrchr (bfd_get_filename (exec_bfd
), '/');
763 /* step over character '/' */
764 str1
= str1
!= NULL
? str1
+ 1 : path
;
765 str2
= str2
!= NULL
? str2
+ 1 : bfd_get_filename (exec_bfd
);
767 if (strcmp (str1
, str2
) == 0)
778 rs6000coff_core_file_failing_command (bfd
*abfd
)
780 CoreHdr
*core
= core_hdr (abfd
);
782 char *com
= CORE_NEW (*core
) ?
783 CNEW_COMM (core
->new_dump
) : COLD_COMM (core
->old
);
785 char *com
= CNEW_COMM (core
->new_dump
);
795 rs6000coff_core_file_failing_signal (bfd
*abfd
)
797 CoreHdr
*core
= core_hdr (abfd
);
799 return CORE_NEW (*core
) ? core
->new_dump
.c_signo
: core
->old
.c_signo
;
801 return core
->new_dump
.c_signo
;
805 #endif /* AIX_CORE */