espressif/binutils-gdb
1
0
Fork 0
mirror of https://github.com/espressif/binutils-gdb.git synced 2025-06-25 04:49:54 +08:00
Code Issues Packages Projects Releases Wiki Activity

*** empty log message ***

Browse Source
This commit is contained in:
Steve Chamberlain
1991-12-04 18:16:41 +00:00
parent 8bcad1b5b7
commit 4e41b5aa40
2 changed files with 172 additions and 108 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
bfd/ChangeLog
View File

@ -1,3 +1,9 @@
Wed Dec 4 10:14:17 1991 Steve Chamberlain (sac at rtl.cygnus.com)
* bout.c: (b_out_callback): replace the text size, since aout
fries them.
* aoutx.h: Documentation in the new style
Wed Dec 4 02:00:30 1991 John Gilmore (gnu at cygnus.com) Wed Dec 4 02:00:30 1991 John Gilmore (gnu at cygnus.com)
* bfd.c (bfd_get_mtime): Don't cache mtime any more; only * bfd.c (bfd_get_mtime): Don't cache mtime any more; only

274
bfd/aoutx.h
View File

@ -18,72 +18,87 @@ You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
/*doc* /*
@section a.out backends SECTION
a.out backends
BFD supports a number of different flavours of a.out format, though
the major differences are only the sizes of the structures on disk,
and the shape of the relocation information.
The support is split into a basic support file @code{aoutx.h} and DESCRIPTION
other files which derive functions from the base. One derivation file
is @code{aoutf1.h} (for a.out flavour 1), and adds to the basic a.out
functions support for sun3, sun4, 386 and 29k a.out files, to create a
target jump vector for a specific target.
This information is further split out into more specific files for each BFD supports a number of different flavours of a.out format,
machine, including @code{sunos.c} for sun3 and sun4, @code{newsos3.c} for though the major differences are only the sizes of the
the Sony NEWS, and @code{demo64.c} for a demonstration of a 64 bit a.out structures on disk, and the shape of the relocation
format. information.
The base file @code{aoutx.h} defines general mechanisms for reading The support is split into a basic support file @code{aoutx.h}
and writing records to and from disk, and various other methods which and other files which derive functions from the base. One
BFD requires. It is included by @code{aout32.c} and @code{aout64.c} to derivation file is @code{aoutf1.h} (for a.out flavour 1), and
form the names aout_32_swap_exec_header_in, adds to the basic a.out functions support for sun3, sun4, 386
aout_64_swap_exec_header_in, etc. and 29k a.out files, to create a target jump vector for a
specific target.
As an example, this is what goes on to make the back end for a sun4, from aout32.c This information is further split out into more specific files
for each machine, including @code{sunos.c} for sun3 and sun4,
@code{newsos3.c} for the Sony NEWS, and @code{demo64.c} for a
demonstration of a 64 bit a.out format.
The base file @code{aoutx.h} defines general mechanisms for
reading and writing records to and from disk, and various
other methods which BFD requires. It is included by
@code{aout32.c} and @code{aout64.c} to form the names
aout_32_swap_exec_header_in, aout_64_swap_exec_header_in, etc.
As an example, this is what goes on to make the back end for a
sun4, from aout32.c
EXAMPLE
@example
#define ARCH_SIZE 32 #define ARCH_SIZE 32
#include "aoutx.h" #include "aoutx.h"
@end example
Which exports names: DESCRIPTION
@example
Which exports names:
EXAMPLE
... ...
aout_32_canonicalize_reloc aout_32_canonicalize_reloc
aout_32_find_nearest_line aout_32_find_nearest_line
aout_32_get_lineno aout_32_get_lineno
aout_32_get_reloc_upper_bound aout_32_get_reloc_upper_bound
... ...
@end example
from sunos.c DESCRIPTION
@example from sunos.c
EXAMPLE
#define ARCH 32 #define ARCH 32
#define TARGET_NAME "a.out-sunos-big" #define TARGET_NAME "a.out-sunos-big"
#define VECNAME sunos_big_vec #define VECNAME sunos_big_vec
#include "aoutf1.h" #include "aoutf1.h"
@end example DESCRIPTION
requires all the names from aout32.c, and produces the jump vector
@example requires all the names from aout32.c, and produces the jump vector
EXAMPLE
sunos_big_vec sunos_big_vec
@end example
The file host-aout.c is a special case. It is for a large set of hosts DESCRIPTION
that use ``more or less standard'' a.out files, and for which cross-debugging
is not interesting. It uses the standard 32-bit a.out support routines,
but determines the file offsets and addresses of the text, data,
and BSS sections, the machine architecture and machine type,
and the entry point address, in a host-dependent manner. Once these
values have been determined, generic code is used to handle the
object file.
When porting it to run on a new system, you must supply: The file host-aout.c is a special case. It is for a large set
of hosts that use ``more or less standard'' a.out files, and
for which cross-debugging is not interesting. It uses the
standard 32-bit a.out support routines, but determines the
file offsets and addresses of the text, data, and BSS
sections, the machine architecture and machine type, and the
entry point address, in a host-dependent manner. Once these
values have been determined, generic code is used to handle
the object file.
When porting it to run on a new system, you must supply:
EXAMPLE
HOST_PAGE_SIZE HOST_PAGE_SIZE
HOST_SEGMENT_SIZE HOST_SEGMENT_SIZE
HOST_MACHINE_ARCH (optional) HOST_MACHINE_ARCH (optional)
@ -91,18 +106,22 @@ When porting it to run on a new system, you must supply:
HOST_TEXT_START_ADDR HOST_TEXT_START_ADDR
HOST_STACK_END_ADDR HOST_STACK_END_ADDR
in the file ../include/sys/h-XXX.h (for your host). These values, plus DESCRIPTION
the structures and macros defined in <a.out.h> on your host system, will
produce a BFD target that will access ordinary a.out files on your host.
To configure a new machine to use host-aout.c, specify: in the file ../include/sys/h-XXX.h (for your host). These
values, plus the structures and macros defined in <a.out.h> on
your host system, will produce a BFD target that will access
ordinary a.out files on your host. To configure a new machine
to use host-aout.c, specify:
TDEFAULTS = -DDEFAULT_VECTOR=host_aout_big_vec EXAMPLE
TDEPFILES= host-aout.o trad-core.o TDEFAULTS = -DDEFAULT_VECTOR=host_aout_big_vec
TDEPFILES= host-aout.o trad-core.o
in the config/mt-XXX file, and modify configure.in to use the DESCIPTION
mt-XXX file (by setting "bfd_target=XXX") when your configuration is in the config/mt-XXX file, and modify configure.in to use the
selected. mt-XXX file (by setting "bfd_target=XXX") when your
configuration is selected.
*/ */
@ -122,14 +141,19 @@ struct external_exec;
void (*bfd_error_trap)(); void (*bfd_error_trap)();
/*doc* /*
@subsection relocations SUBSECTION
The file @code{aoutx.h} caters for both the @emph{standard} and relocations
@emph{extended} forms of a.out relocation records.
DESCRIPTION
The file @code{aoutx.h} caters for both the @emph{standard}
and @emph{extended} forms of a.out relocation records.
The standard records are characterised by containing only an
address, a symbol index and a type field. The extended records
(used on 29ks and sparcs) also have a full integer for an
addend.
The standard records are characterised by containing only an address,
a symbol index and a type field. The extended records (used on 29ks
and sparcs) also have a full integer for an addend.
*/ */
#define CTOR_TABLE_RELOC_IDX 2 #define CTOR_TABLE_RELOC_IDX 2
@ -180,21 +204,31 @@ HOWTO( 7, 0, 3, 64, true, 0, false, true,0,"DISP64", true, 0xfeedfac
bfd_error_vector_type bfd_error_vector; bfd_error_vector_type bfd_error_vector;
/*doc* /*
@subsection Internal Entry Points SUBSECTION
@code{aoutx.h} exports several routines for accessing the contents of Internal Entry Points
an a.out file, which are gathered and exported in turn by various
format specific files (eg sunos.c). DESCRIPTION
@code{aoutx.h} exports several routines for accessing the
contents of an a.out file, which are gathered and exported in
turn by various format specific files (eg sunos.c).
*/ */
/*doc* /*
*i aout_<size>_swap_exec_header_in FUNCTION
Swaps the information in an executable header taken from a raw byte stream memory image, aout_<size>_swap_exec_header_in
into the internal exec_header structure.
*; PROTO(void, aout_<size>_swap_exec_header_in, DESCRIPTION
(bfd *abfd, Swaps the information in an executable header taken from a raw
struct external_exec *raw_bytes, byte stream memory image, into the internal exec_header
struct internal_exec *execp)); structure.
EXAMPLE
void aout_<size>_swap_exec_header_in,
(bfd *abfd,
struct external_exec *raw_bytes,
struct internal_exec *execp);
*/ */
void void
@ -216,14 +250,19 @@ DEFUN(NAME(aout,swap_exec_header_in),(abfd, raw_bytes, execp),
execp->a_drsize = GET_WORD (abfd, bytes->e_drsize); execp->a_drsize = GET_WORD (abfd, bytes->e_drsize);
} }
/*doc* /*
*i aout_<size>_swap_exec_header_out FUNCTION
Swaps the information in an internal exec header structure into the aout_<size>_swap_exec_header_out
supplied buffer ready for writing to disk.
*; PROTO(void, aout_<size>_swap_exec_header_out, DESCRIPTION
Swaps the information in an internal exec header structure
into the supplied buffer ready for writing to disk.
EXAMPLE
void aout_<size>_swap_exec_header_out
(bfd *abfd, (bfd *abfd,
struct internal_exec *execp, struct internal_exec *execp,
struct external_exec *raw_bytes)); struct external_exec *raw_bytes);
*/ */
void void
DEFUN(NAME(aout,swap_exec_header_out),(abfd, execp, raw_bytes), DEFUN(NAME(aout,swap_exec_header_out),(abfd, execp, raw_bytes),
@ -250,17 +289,21 @@ struct container {
}; };
/*doc* /*
*i aout_<size>_some_aout_object_p FUNCTION
aout_<size>_some_aout_object_p
Some A.OUT variant thinks that the file whose format we're checking DESCRIPTION
is an a.out file. Do some more checking, and set up for access if Some A.OUT variant thinks that the file whose format we're
it really is. Call back to the calling environments "finish up" checking is an a.out file. Do some more checking, and set up
function just before returning, to handle any last-minute setup. for access if it really is. Call back to the calling
environments "finish up" function just before returning, to
handle any last-minute setup.
*; PROTO(bfd_target *, aout_<size>_some_aout_object_p, EXAMPLE
bfd_target *aout_<size>_some_aout_object_p
(bfd *abfd, (bfd *abfd,
bfd_target *(*callback_to_real_object_p)())); bfd_target *(*callback_to_real_object_p)());
*/ */
bfd_target * bfd_target *
@ -415,12 +458,15 @@ DEFUN(NAME(aout,some_aout_object_p),(abfd, execp, callback_to_real_object_p),
return result; return result;
} }
/*doc* /*
*i aout_<size>_mkobject FUNCTION
aout_<size>_mkobject
This routine initializes a BFD for use with a.out files. DESCRIPTION
This routine initializes a BFD for use with a.out files.
*; PROTO(boolean, aout_<size>_mkobject, (bfd *)); EXAMPLE
boolean aout_<size>_mkobject, (bfd *);
*/ */
boolean boolean
@ -455,17 +501,21 @@ DEFUN(NAME(aout,mkobject),(abfd),
} }
/*doc* /*
*i aout_<size>_machine_type FUNCTION
aout_<size>_machine_type
Keep track of machine architecture and machine type for a.out's. DESCRIPTION
Return the machine_type for a particular arch&machine, or M_UNKNOWN Keep track of machine architecture and machine type for
if that exact arch&machine can't be represented in a.out format. a.out's. Return the machine_type for a particular
arch&machine, or M_UNKNOWN if that exact arch&machine can't be
represented in a.out format.
If the architecture is understood, machine type 0 (default) should If the architecture is understood, machine type 0 (default)
always be understood. should always be understood.
*; PROTO(enum machine_type, aout_<size>_machine_type, EXAMPLE
enum machine_type aout_<size>_machine_type
(enum bfd_architecture arch, (enum bfd_architecture arch,
unsigned long machine)); unsigned long machine));
*/ */
@ -510,14 +560,17 @@ DEFUN(NAME(aout,machine_type),(arch, machine),
} }
/*doc* /*
*i aout_<size>_set_arch_mach FUNCTION
aout_<size>_set_arch_mach
Sets the architecture and the machine of the BFD to those values DESCRIPTION
supplied. Verifies that the format can support the architecture Sets the architecture and the machine of the BFD to those
required. values supplied. Verifies that the format can support the
architecture required.
*; PROTO(boolean, aout_<size>_set_arch_mach, EXAMPLE
boolean aout_<size>_set_arch_mach,
(bfd *, (bfd *,
enum bfd_architecture, enum bfd_architecture,
unsigned long machine)); unsigned long machine));
@ -536,11 +589,16 @@ DEFUN(NAME(aout,set_arch_mach),(abfd, arch, machine),
return true; /* We're easy ... */ return true; /* We're easy ... */
} }
/*doc* /*
*i aout_<size>new_section_hook FUNCTION
aout_<size>new_section_hook
Called by the BFD in response to a @code{bfd_make_section} request. DESCRIPTION
*; PROTO(boolean, aout_<size>_new_section_hook, Called by the BFD in response to a @code{bfd_make_section}
request.
EXAMPLE
boolean aout_<size>_new_section_hook,
(bfd *abfd, (bfd *abfd,
asection *newsect)); asection *newsect));
*/ */
@ -701,9 +759,9 @@ boolean
static void static void
DEFUN(translate_from_native_sym_flags,(sym_pointer, cache_ptr, abfd), DEFUN(translate_from_native_sym_flags,(sym_pointer, cache_ptr, abfd),
struct external_nlist *sym_pointer AND struct external_nlist *sym_pointer AND
aout_symbol_type *cache_ptr AND aout_symbol_type *cache_ptr AND
bfd *abfd) bfd *abfd)
{ {
switch (cache_ptr->type & N_TYPE) { switch (cache_ptr->type & N_TYPE) {
case N_SETA: case N_SETA: