/* external.h -- External COFF structures Copyright (C) 2001-2026 Free Software Foundation, Inc. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA. */ #ifndef COFF_EXTERNAL_H #define COFF_EXTERNAL_H #ifndef DO_NOT_DEFINE_FILHDR #define FILHDR struct external_filehdr #define FILHSZ 20 struct external_filehdr { char f_magic[2]; /* magic number */ char f_nscns[2]; /* number of sections */ char f_timdat[4]; /* time & date stamp */ char f_symptr[4]; /* file pointer to symtab */ char f_nsyms[4]; /* number of symtab entries */ char f_opthdr[2]; /* sizeof(optional hdr) */ char f_flags[2]; /* flags */ }; #endif #ifndef DO_NOT_DEFINE_AOUTHDR #define AOUTHDRSZ 28 #define AOUTSZ 28 typedef struct external_aouthdr { char magic[2]; /* type of file */ char vstamp[2]; /* version stamp */ char tsize[4]; /* text size in bytes, padded to FW bdry*/ char dsize[4]; /* initialized data " " */ char bsize[4]; /* uninitialized data " " */ char entry[4]; /* entry pt. */ char text_start[4]; /* base of text used for this file */ char data_start[4]; /* base of data used for this file */ } ATTRIBUTE_PACKED AOUTHDR; #define AOUTHDRSZ64 24 typedef struct external_aouthdr64 { char magic[2]; /* Type of file. */ char vstamp[2]; /* Version stamp. */ char tsize[4]; /* Text size in bytes, padded to FW bdry*/ char dsize[4]; /* Initialized data " ". */ char bsize[4]; /* Uninitialized data " ". */ char entry[4]; /* Entry pt. */ char text_start[4]; /* Base of text used for this file. */ } AOUTHDR64; #endif /* not DO_NOT_DEFINE_AOUTHDR */ #ifndef DO_NOT_DEFINE_SCNHDR #define SCNHDR struct external_scnhdr #define SCNHSZ 40 struct external_scnhdr { char s_name[8]; /* section name */ char s_paddr[4]; /* physical address, aliased s_nlib */ char s_vaddr[4]; /* virtual address */ char s_size[4]; /* section size */ char s_scnptr[4]; /* file ptr to raw data for section */ char s_relptr[4]; /* file ptr to relocation */ char s_lnnoptr[4]; /* file ptr to line numbers */ char s_nreloc[2]; /* number of relocation entries */ char s_nlnno[2]; /* number of line number entries */ char s_flags[4]; /* flags */ }; /* Names of "special" sections. */ #define _TEXT ".text" #define _DATA ".data" #define _BSS ".bss" #define _COMMENT ".comment" #define _LIB ".lib" #endif /* not DO_NOT_DEFINE_SCNHDR */ #ifndef DO_NOT_DEFINE_LINENO #ifndef L_LNNO_SIZE #error L_LNNO_SIZE needs to be defined #endif #define LINENO struct external_lineno #define LINESZ (4 + L_LNNO_SIZE) /* 1 line number entry for every "breakpointable" source line in a section. Line numbers are grouped on a per function basis; first entry in a function grouping will have l_lnno = 0 and in place of physical address will be the symbol table index of the function name. */ struct external_lineno { union { char l_symndx[4]; /* function name symbol index, iff l_lnno == 0*/ char l_paddr[4]; /* (physical) address of line number */ } l_addr; char l_lnno[L_LNNO_SIZE]; /* line number */ }; #if L_LNNO_SIZE == 4 #define GET_LINENO_LNNO(abfd, ext) H_GET_32 (abfd, (ext->l_lnno)) #define PUT_LINENO_LNNO(abfd, val, ext) H_PUT_32 (abfd, val, (ext->l_lnno)) #endif #if L_LNNO_SIZE == 2 #define GET_LINENO_LNNO(abfd, ext) H_GET_16 (abfd, (ext->l_lnno)) #define PUT_LINENO_LNNO(abfd, val, ext) H_PUT_16 (abfd, val, (ext->l_lnno)) #endif #endif /* not DO_NOT_DEFINE_LINENO */ #ifndef DO_NOT_DEFINE_SYMENT #define E_SYMNMLEN 8 /* # characters in a symbol name */ #define SYMESZ 18 typedef struct external_syment { union { char e_name[E_SYMNMLEN]; struct { char e_zeroes[4]; char e_offset[4]; } e; } e; char e_value[4]; char e_scnum[2]; char e_type[2]; char e_sclass[1]; char e_numaux[1]; } ATTRIBUTE_PACKED SYMENT; #ifndef N_BTMASK #define N_BTMASK 0xf #endif #ifndef N_TMASK #define N_TMASK 0x30 #endif #ifndef N_BTSHFT #define N_BTSHFT 4 #endif #ifndef N_TSHIFT #define N_TSHIFT 2 #endif #endif /* not DO_NOT_DEFINE_SYMENT */ #ifndef DO_NOT_DEFINE_AUXENT #define E_FILNMLEN 14 /* # characters in a file name */ #define E_DIMNUM 4 /* # array dimensions in auxiliary entry */ #define AUXESZ 18 typedef union external_auxent { struct { char x_tagndx[4]; /* str, un, or enum tag indx */ union { struct { char x_lnno[2]; /* declaration line number */ char x_size[2]; /* str/union/array size */ } x_lnsz; char x_fsize[4]; /* size of function */ } x_misc; union { struct /* if ISFCN, tag, or .bb */ { char x_lnnoptr[4]; /* ptr to fcn line # */ char x_endndx[4]; /* entry ndx past block end */ } x_fcn; struct /* if ISARY, up to 4 dimen. */ { char x_dimen[E_DIMNUM][2]; } x_ary; } x_fcnary; char x_tvndx[2]; /* tv index */ } x_sym; union { /* Make x_fname the full auxent size, so that if coff/pe.h redefines E_FILNMLEN from 14 to 18 we don't trigger sanitisers accessing x_fname. Beware use of sizeof (x_file.x_fname). */ char x_fname[AUXESZ]; struct { char x_zeroes[4]; char x_offset[4]; } x_n; } x_file; struct { char x_scnlen[4]; /* section length */ char x_nreloc[2]; /* # relocation entries */ char x_nlinno[2]; /* # line numbers */ #ifdef INCLUDE_COMDAT_FIELDS_IN_AUXENT char x_checksum[4]; /* section COMDAT checksum */ char x_associated[2]; /* COMDAT associated section index */ char x_comdat[1]; /* COMDAT selection number */ #endif } x_scn; /* info about .tv section (in auxent of symbol .tv). */ struct { char x_tvfill[4]; /* tv fill value */ char x_tvlen[2]; /* length of .tv */ char x_tvran[2][2]; /* tv range */ } x_tv; } ATTRIBUTE_PACKED AUXENT; #endif /* not DO_NOT_DEFINE_AUXENT */ #endif /* COFF_EXTERNAL_H */