Check in with stuff from core.c (after PROTOS update in bfd Makefile)
This commit is contained in:
Roland Pesch
parent
a92b9db33c
commit
2f60a8804d
1 changed files with 98 additions and 67 deletions
165
include/bfd.h
165
include/bfd.h
|
|
@ -314,8 +314,8 @@ extern CONST short _bfd_host_big_endian;
|
|||
/* ------------------------------START FROM opncls.c
|
||||
|
||||
*i bfd_openr
|
||||
Opens the file supplied (using fopen) with the target supplied, it
|
||||
returns a pointer to the created bfd.
|
||||
Opens the file supplied (using @code{fopen}) with the target supplied, it
|
||||
returns a pointer to the created BFD.
|
||||
|
||||
If NULL is returned then an error has occured.
|
||||
Possible errors are no_memory, invalid_target or system_call error.
|
||||
|
|
@ -325,7 +325,7 @@ Possible errors are no_memory, invalid_target or system_call error.
|
|||
/*
|
||||
|
||||
*i bfd_fdopenr
|
||||
bfd_fdopenr is to bfd_fopenr much like fdopen is to fopen. It opens a bfd on
|
||||
bfd_fdopenr is to bfd_fopenr much like fdopen is to fopen. It opens a BFD on
|
||||
a file already described by the @var{fd} supplied.
|
||||
|
||||
Possible errors are no_memory, invalid_target and system_call error.
|
||||
|
|
@ -336,7 +336,7 @@ Possible errors are no_memory, invalid_target and system_call error.
|
|||
/*
|
||||
|
||||
bfd_openw
|
||||
Creates a bfd, associated with file @var{filename}, using the file
|
||||
Creates a BFD, associated with file @var{filename}, using the file
|
||||
format @var{target}, and returns a pointer to it.
|
||||
|
||||
Possible errors are system_call_error, no_memory, invalid_target.
|
||||
|
|
@ -346,12 +346,12 @@ Possible errors are system_call_error, no_memory, invalid_target.
|
|||
/*
|
||||
|
||||
bfd_close
|
||||
This function closes a bfd. If the bfd was open for writing, then
|
||||
This function closes a BFD. If the BFD was open for writing, then
|
||||
pending operations are completed and the file written out and closed.
|
||||
If the created file is executable, then @code{chmod} is called to mark
|
||||
it as such.
|
||||
|
||||
All memory attatched to the bfd's obstacks is released.
|
||||
All memory attached to the BFD's obstacks is released.
|
||||
|
||||
@code{true} is returned if all is ok, otherwise @code{false}.
|
||||
*/
|
||||
|
|
@ -360,8 +360,8 @@ All memory attatched to the bfd's obstacks is released.
|
|||
/*
|
||||
|
||||
bfd_create
|
||||
This routine creates a new bfd in the manner of bfd_openw, but without
|
||||
opening a file. The new bfd takes the target from the target used by
|
||||
This routine creates a new BFD in the manner of @code{bfd_openw}, but without
|
||||
opening a file. The new BFD takes the target from the target used by
|
||||
@var{template}. The format is always set to @code{bfd_object}.
|
||||
*/
|
||||
|
||||
|
|
@ -371,7 +371,7 @@ opening a file. The new bfd takes the target from the target used by
|
|||
|
||||
bfd_alloc_size
|
||||
Return the number of bytes in the obstacks connected to the supplied
|
||||
bfd.
|
||||
BFD.
|
||||
*/
|
||||
PROTO(bfd_size_type,bfd_alloc_size,(bfd *abfd));
|
||||
|
||||
|
|
@ -436,7 +436,7 @@ stuff
|
|||
bfd_prinable_arch_mach
|
||||
Return a printable string representing the architecture and machine
|
||||
type. The result is only good until the next call to
|
||||
bfd_printable_arch_mach.
|
||||
@code{bfd_printable_arch_mach}.
|
||||
*/
|
||||
PROTO(CONST char *,bfd_printable_arch_mach,
|
||||
(enum bfd_architecture arch, unsigned long machine));
|
||||
|
|
@ -454,10 +454,10 @@ Scan a string and attempt to turn it into an archive and machine type combinatio
|
|||
*i bfd_arch_compatible
|
||||
This routine is used to determine whether two BFDs' architectures and machine types are
|
||||
compatible. It calculates the lowest common denominator between the
|
||||
two architectures and machine types implied by the bfds and sets the
|
||||
two architectures and machine types implied by the BFDs and sets the
|
||||
objects pointed at by @var{archp} and @var{machine} if non NULL.
|
||||
|
||||
This routine returns @code{true} if the bfds are of compatible type,
|
||||
This routine returns @code{true} if the BFDs are of compatible type,
|
||||
otherwise @code{false}.
|
||||
*/
|
||||
PROTO(boolean, bfd_arch_compatible,
|
||||
|
|
@ -487,7 +487,7 @@ Set atch mach
|
|||
*i bfd_get_size
|
||||
These macros as used for reading and writing raw data in sections;
|
||||
each access (except for bytes) is vectored through the target format
|
||||
of the bfd and mangled accordingly. The mangling performs any
|
||||
of the BFD and mangled accordingly. The mangling performs any
|
||||
necessary endian translations and removes alignment restrictions.
|
||||
*/
|
||||
#define bfd_put_8(abfd, val, ptr) \
|
||||
|
|
@ -548,7 +548,7 @@ the same as that passed to bfd_make_section.
|
|||
CONST char *name;
|
||||
|
||||
/*
|
||||
The next section in the list belonging to the bfd, or NULL.
|
||||
The next section in the list belonging to the BFD, or NULL.
|
||||
*/
|
||||
|
||||
struct sec *next;
|
||||
|
|
@ -622,7 +622,7 @@ The section contains constructor information. This section type is
|
|||
used by the linker to create lists of constructors and destructors
|
||||
used by @code{g++}. When a back end sees a symbol which should be used
|
||||
in a constructor list, it creates a new section for the type of name
|
||||
(eg @code{__CTOR_LIST__}), attatches the symbol to it and builds a
|
||||
(eg @code{__CTOR_LIST__}), attaches the symbol to it and builds a
|
||||
relocation. To build the lists of constructors, all the linker has to
|
||||
to is catenate all the sections called @code{__CTOR_LIST__} and
|
||||
relocte the data contained within - exactly the operations it would
|
||||
|
|
@ -787,7 +787,7 @@ relocations created to relocate items within it.
|
|||
struct relent_chain *constructor_chain;
|
||||
|
||||
/*
|
||||
The bfd which owns the section.
|
||||
The BFD which owns the section.
|
||||
*/
|
||||
|
||||
bfd *owner;
|
||||
|
|
@ -809,15 +809,15 @@ who's name matches that provided, otherwise NULL. @xref{Sections}, for more info
|
|||
/*
|
||||
|
||||
bfd_make_section
|
||||
This function creates a new empty section called @var{name} and attatches it
|
||||
to the end of the chain of sections for @var{bfd}. An attempt to
|
||||
This function creates a new empty section called @var{name} and attaches it
|
||||
to the end of the chain of sections for the BFD supplied. An attempt to
|
||||
create a section with a name which is already in use, returns the old
|
||||
section by that name instead.
|
||||
|
||||
Possible errors are:
|
||||
@table @code
|
||||
@item invalid_operation
|
||||
If output has already started for this bfd.
|
||||
If output has already started for this BFD.
|
||||
@item no_memory
|
||||
If obstack alloc fails.
|
||||
@end table
|
||||
|
|
@ -828,7 +828,7 @@ If obstack alloc fails.
|
|||
/*
|
||||
|
||||
bfd_set_section_flags
|
||||
Attempts to set the attributes of the section named in the bfd
|
||||
Attempts to set the attributes of the section named in the BFD
|
||||
supplied to the value. Returns true on success, false on error.
|
||||
Possible error returns are:
|
||||
@table @code
|
||||
|
|
@ -845,8 +845,8 @@ example, a .bss section in @code{a.out} may not have the
|
|||
/*
|
||||
|
||||
bfd_map_over_sections
|
||||
Calls the provided function @var{func} for each section attatched to
|
||||
the bfd @var{abfd}, passing @var{obj} as an argument. The function
|
||||
Calls the provided function @var{func} for each section attached to
|
||||
the BFD @var{abfd}, passing @var{obj} as an argument. The function
|
||||
will be called as if by
|
||||
|
||||
@example
|
||||
|
|
@ -875,7 +875,7 @@ Sets @var{section} to the size @var{val}. If the operation is ok, then
|
|||
Possible error returns:
|
||||
@table @code
|
||||
@item invalid_operation
|
||||
Writing has started to the bfd, so setting the size is invalid
|
||||
Writing has started to the BFD, so setting the size is invalid
|
||||
@end table
|
||||
*/
|
||||
|
||||
|
|
@ -885,7 +885,7 @@ Writing has started to the bfd, so setting the size is invalid
|
|||
/*
|
||||
|
||||
bfd_set_section_contents
|
||||
Sets the contents of the section @var{section} in bfd @var{abfd} to
|
||||
Sets the contents of the section @var{section} in BFD @var{abfd} to
|
||||
the data starting in memory at @var{data}. The data is written to the
|
||||
output section starting at offset @var{offset} for @var{count} bytes.
|
||||
|
||||
|
|
@ -910,7 +910,7 @@ This routine is front end to the back end function @code{_bfd_set_section_conten
|
|||
/*
|
||||
|
||||
bfd_get_section_contents
|
||||
This function reads data from @var{section} in bfd @var{abfd} into
|
||||
This function reads data from @var{section} in BFD @var{abfd} into
|
||||
memory starting at @var{location}. The data is read at an offset of
|
||||
@var{offset} from the start of the input section, and is read for
|
||||
@var{count} bytes.
|
||||
|
|
@ -943,7 +943,7 @@ An @code{asymbol} has the form:
|
|||
|
||||
typedef struct symbol_cache_entry
|
||||
{
|
||||
/* A pointer to the bfd which owns the symbol. This information is
|
||||
/* A pointer to the BFD which owns the symbol. This information is
|
||||
necessary so that a back end can work out what additional (invisible to
|
||||
the application writer) information is carried with the symbol.
|
||||
*/
|
||||
|
|
@ -1056,7 +1056,7 @@ The default value for common data.
|
|||
In some files the type of a symbol sometimes alters its location
|
||||
in an output file - ie in coff a @code{ISFCN} symbol which is also @code{C_EXT}
|
||||
symbol appears where it was declared and not at the end of a section.
|
||||
This bit is set by the target bfd part to convey this information.
|
||||
This bit is set by the target BFD part to convey this information.
|
||||
*/
|
||||
|
||||
#define BSF_NOT_AT_END 0x40000
|
||||
|
|
@ -1108,8 +1108,8 @@ this a union.
|
|||
|
||||
get_symtab_upper_bound
|
||||
Returns the number of bytes required in a vector of pointers to
|
||||
@code{asymbols} for all the symbols in the supplied bfd, including a
|
||||
terminal NULL pointer. If there are no symbols in the bfd, then 0 is
|
||||
@code{asymbols} for all the symbols in the supplied BFD, including a
|
||||
terminal NULL pointer. If there are no symbols in the BFD, then 0 is
|
||||
returned.
|
||||
*/
|
||||
#define get_symtab_upper_bound(abfd) \
|
||||
|
|
@ -1118,8 +1118,8 @@ returned.
|
|||
/*
|
||||
|
||||
bfd_canonicalize_symtab
|
||||
Supplied a bfd and a pointer to an uninitialized vector of pointers.
|
||||
This reads in the symbols from the bfd, and fills in the table with
|
||||
Supplied a BFD and a pointer to an uninitialized vector of pointers.
|
||||
This reads in the symbols from the BFD, and fills in the table with
|
||||
pointers to the symbols, and a trailing NULL. The routine returns the
|
||||
actual number of symbol pointers not including the NULL.
|
||||
*/
|
||||
|
|
@ -1131,7 +1131,7 @@ actual number of symbol pointers not including the NULL.
|
|||
/*
|
||||
bfd_set_symtab
|
||||
Provided a table of pointers to to symbols and a count, writes to the
|
||||
output bfd the symbols when closed.
|
||||
output BFD the symbols when closed.
|
||||
*/
|
||||
|
||||
PROTO(boolean, bfd_set_symtab, (bfd *, asymbol **, unsigned int ));
|
||||
|
|
@ -1147,7 +1147,7 @@ Prints the value and flags of the symbol supplied to the stream file.
|
|||
/*
|
||||
|
||||
bfd_make_empty_symbol
|
||||
This function creates a new @code{asymbol} structure for the bfd, and
|
||||
This function creates a new @code{asymbol} structure for the BFD, and
|
||||
returns a pointer to it.
|
||||
|
||||
This routine is necessary, since each back end has private information
|
||||
|
|
@ -1167,16 +1167,16 @@ problems later on.
|
|||
@section typedef bfd
|
||||
|
||||
Pointers to bfd structs are the cornerstone of any application using
|
||||
libbfd. References though the bfd and to data in the bfd give the
|
||||
entire bfd functionality.
|
||||
@code{libbfd}. References though the BFD and to data in the BFD give the
|
||||
entire BFD functionality.
|
||||
|
||||
Finally! The BFD struct itself. This contains the major data about
|
||||
Here is the BFD struct itself. This contains the major data about
|
||||
the file, and contains pointers to the rest of the data.
|
||||
*/
|
||||
|
||||
struct _bfd
|
||||
{
|
||||
/* The filename the application opened the bfd with.
|
||||
/* The filename the application opened the BFD with.
|
||||
*/
|
||||
|
||||
CONST char *filename;
|
||||
|
|
@ -1190,7 +1190,7 @@ A pointer to the target jump table.
|
|||
/*
|
||||
|
||||
To avoid dragging too many header files into every file that
|
||||
includes bfd.h, IOSTREAM has been declared as a "char *", and MTIME
|
||||
includes @file{bfd.h}, IOSTREAM has been declared as a "char *", and MTIME
|
||||
as a "long". Their correct types, to which they are cast when used,
|
||||
are "FILE *" and "time_t".
|
||||
|
||||
|
|
@ -1206,7 +1206,7 @@ Is the file being cached @xref{File Caching}.
|
|||
boolean cacheable;
|
||||
|
||||
/*
|
||||
Marks whether there was a default target specified when the bfd was
|
||||
Marks whether there was a default target specified when the BFD was
|
||||
opened. This is used to select what matching algorithm to use to chose
|
||||
the back end.
|
||||
*/
|
||||
|
|
@ -1214,14 +1214,15 @@ the back end.
|
|||
boolean target_defaulted;
|
||||
|
||||
/*
|
||||
The caching routines use these to maintain an LRU list of bfds.
|
||||
The caching routines use these to maintain a least-recently-used list of
|
||||
BFDs (@pxref{File Caching}).
|
||||
*/
|
||||
|
||||
struct _bfd *lru_prev, *lru_next;
|
||||
|
||||
/*
|
||||
When a file is closed by the caching routines, it retains the state
|
||||
here:
|
||||
When a file is closed by the caching routines, BFD retains state
|
||||
information on the file here:
|
||||
*/
|
||||
|
||||
file_ptr where;
|
||||
|
|
@ -1247,13 +1248,13 @@ For output files, channel we locked (is this used?).
|
|||
int ifd;
|
||||
|
||||
/*
|
||||
The format which belongs to the bfd.
|
||||
The format which belongs to the BFD.
|
||||
*/
|
||||
|
||||
bfd_format format;
|
||||
|
||||
/*
|
||||
The direction the bfd was opened with
|
||||
The direction the BFD was opened with
|
||||
*/
|
||||
|
||||
enum bfd_direction {no_direction = 0,
|
||||
|
|
@ -1294,7 +1295,7 @@ The number of sections
|
|||
unsigned int section_count;
|
||||
|
||||
/*
|
||||
Stuff only usefull for object files:
|
||||
Stuff only useful for object files:
|
||||
The start address.
|
||||
*/
|
||||
|
||||
|
|
@ -1303,7 +1304,7 @@ The start address.
|
|||
*/
|
||||
|
||||
unsigned int symcount;
|
||||
/* Symtab for output bfd
|
||||
/* Symbol table for output BFD
|
||||
*/
|
||||
|
||||
struct symbol_cache_entry **outsymbols;
|
||||
|
|
@ -1321,7 +1322,7 @@ Particular machine within arch, e.g. 68010
|
|||
unsigned long obj_machine;
|
||||
|
||||
/*
|
||||
Stuff only usefull for archives:
|
||||
Stuff only useful for archives:
|
||||
*/
|
||||
|
||||
PTR arelt_data;
|
||||
|
|
@ -1343,7 +1344,7 @@ Used by the application to hold private data
|
|||
PTR usrdata;
|
||||
|
||||
/*
|
||||
Where all the allocated stuff under this BFD goes
|
||||
Where all the allocated stuff under this BFD goes (@pxref{Memory Usage}).
|
||||
*/
|
||||
|
||||
struct obstack memory;
|
||||
|
|
@ -1353,7 +1354,7 @@ Where all the allocated stuff under this BFD goes
|
|||
|
||||
bfd_set_start_address
|
||||
|
||||
Marks the entry point of an output bfd. Returns @code{true} on
|
||||
Marks the entry point of an output BFD. Returns @code{true} on
|
||||
success, @code{false} otherwise.
|
||||
*/
|
||||
|
||||
|
|
@ -1417,7 +1418,7 @@ What this does
|
|||
/*
|
||||
|
||||
bfd_set_archive_head
|
||||
Used whilst processing archives. Sets the head of the chain of bfds
|
||||
Used whilst processing archives. Sets the head of the chain of BFDs
|
||||
contained in an archive to @var{new_head}. (see chapter on archives)
|
||||
*/
|
||||
PROTO(boolean, bfd_set_archive_head, (bfd *output, bfd *new_head));
|
||||
|
|
@ -1432,10 +1433,10 @@ contained in an archive to @var{new_head}. (see chapter on archives)
|
|||
/*
|
||||
|
||||
bfd_openr_next_archived_file
|
||||
Initially provided a bfd containing an archive and NULL, opens a bfd
|
||||
Initially provided a BFD containing an archive and NULL, opens a BFD
|
||||
on the first contained element and returns that. Subsequent calls to
|
||||
bfd_openr_next_archived_file should pass the archive and the previous
|
||||
return value to return a created bfd to the next contained element.
|
||||
return value to return a created BFD to the next contained element.
|
||||
NULL is returned when there are no more.
|
||||
*/
|
||||
|
||||
|
|
@ -1447,6 +1448,36 @@ NULL is returned when there are no more.
|
|||
--------------------------------END FROM archive.c*/
|
||||
|
||||
/* FROM core.c*/
|
||||
/* ------------------------------START FROM core.c
|
||||
bfd_core_file_failing_command
|
||||
Returns a read-only string explaining what program was running when
|
||||
it failed and produced the core file being read
|
||||
*/
|
||||
|
||||
PROTO(CONST char *, bfd_core_file_failing_command, (bfd *));
|
||||
|
||||
/*
|
||||
|
||||
bfd_core_file_failing_signal
|
||||
Returns the signal number which caused the core dump which generated
|
||||
the file the BFD is attached to.
|
||||
*/
|
||||
|
||||
PROTO(int, bfd_core_file_failing_signal, (bfd *));
|
||||
|
||||
/*
|
||||
|
||||
core_file_matches_executable_p
|
||||
Returns @code{true} if the core file attached to @var{core_bfd} was
|
||||
generated by a run of the executable file attached to @var{exec_bfd},
|
||||
or else @code{false}.
|
||||
*/
|
||||
PROTO(boolean, core_file_matches_executable_p,
|
||||
(bfd *core_bfd, bfd *exec_bfd));
|
||||
|
||||
/*
|
||||
|
||||
--------------------------------END FROM core.c*/
|
||||
|
||||
/* FROM reloc.c*/
|
||||
/* ------------------------------START FROM reloc.c
|
||||
|
|
@ -1546,7 +1577,7 @@ Pointer to how to perform the required relocation
|
|||
|
||||
reloc_howto_type
|
||||
The @code{reloc_howto_type} is a structure which contains all the
|
||||
information that bfd needs to know to tie up a back end's data.
|
||||
information that BFD needs to know to tie up a back end's data.
|
||||
*/
|
||||
|
||||
typedef CONST struct reloc_howto_struct
|
||||
|
|
@ -1726,8 +1757,8 @@ while avoiding anguish on compilers that don't support protos.
|
|||
|
||||
/*
|
||||
These macros are used to dispatch to functions through the bfd_target
|
||||
vector. They are used in a number of macros further down in bfd.h, and
|
||||
are also used when calling various routines by hand inside the bfd
|
||||
vector. They are used in a number of macros further down in @file{bfd.h}, and
|
||||
are also used when calling various routines by hand inside the BFD
|
||||
implementation. The "arglist" argument must be parenthesized; it
|
||||
contains all the arguments to the called function.
|
||||
*/
|
||||
|
|
@ -1736,7 +1767,7 @@ contains all the arguments to the called function.
|
|||
((*((bfd)->xvec->message)) arglist)
|
||||
|
||||
/*
|
||||
For operations which index on the bfd format
|
||||
For operations which index on the BFD format
|
||||
*/
|
||||
|
||||
#define BFD_SEND_FMT(bfd, message, arglist) \
|
||||
|
|
@ -1744,7 +1775,7 @@ For operations which index on the bfd format
|
|||
|
||||
/*
|
||||
This is the struct which defines the type of BFD this is. The
|
||||
"xvec" member of the struct bfd itself points here. Each module
|
||||
"xvec" member of the struct @code{bfd} itself points here. Each module
|
||||
that implements access to a different target under BFD, defines
|
||||
one of these.
|
||||
|
||||
|
|
@ -1820,7 +1851,7 @@ The minimum alignment restriction for any section.
|
|||
|
||||
/*
|
||||
Entries for byte swapping for data. These are different to the other
|
||||
entry points, since they don't take bfd as first arg. Certain other handlers
|
||||
entry points, since they don't take BFD as first arg. Certain other handlers
|
||||
could do the same.
|
||||
*/
|
||||
|
||||
|
|
@ -1964,8 +1995,8 @@ environment variable GNUTARGET; if that is null or not defined then
|
|||
the first entry in the target list is chosen. Passing in the
|
||||
string "default" or setting the environment variable to "default"
|
||||
will cause the first entry in the target list to be returned,
|
||||
and "target_defaulted" will be set in the bfd. This causes
|
||||
bfd_check_format to loop over all the targets to find the one
|
||||
and "target_defaulted" will be set in the BFD. This causes
|
||||
@code{bfd_check_format} to loop over all the targets to find the one
|
||||
that matches the file being read.
|
||||
*/
|
||||
PROTO(bfd_target *, bfd_find_target,(CONST char *, bfd *));
|
||||
|
|
@ -1974,7 +2005,7 @@ that matches the file being read.
|
|||
|
||||
*i bfd_target_list
|
||||
This function returns a freshly malloced NULL-terminated vector of the
|
||||
names of all the valid bfd targets. Do not modify the names
|
||||
names of all the valid BFD targets. Do not modify the names
|
||||
*/
|
||||
PROTO(CONST char **,bfd_target_list,());
|
||||
|
||||
|
|
@ -1986,12 +2017,12 @@ names of all the valid bfd targets. Do not modify the names
|
|||
/* ------------------------------START FROM format.c
|
||||
|
||||
*i bfd_check_format
|
||||
This routine is supplied a bfd and a format. It attempts to verify if
|
||||
the file attatched to the bfd is indeed compatible with the format
|
||||
This routine is supplied a BFD and a format. It attempts to verify if
|
||||
the file attached to the BFD is indeed compatible with the format
|
||||
specified (ie, one of @code{bfd_object}, @code{bfd_archive} or
|
||||
@code{bfd_core}).
|
||||
|
||||
If the bfd has been set to a specific @var{target} before the call,
|
||||
If the BFD has been set to a specific @var{target} before the call,
|
||||
only the named target and format combination will be checked. If the
|
||||
target has not been set, or has been set to @code{default} then all
|
||||
the known target backends will be interrogated to determine a match.
|
||||
|
|
@ -2017,9 +2048,9 @@ more than one backend recognised the file format.
|
|||
/*
|
||||
|
||||
*i bfd_set_format
|
||||
This function sets the file format of the supplied bfd to the format
|
||||
requested. If the target set in the bfd does not support the format
|
||||
requested, the format is illegal or the bfd is not open for writing
|
||||
This function sets the file format of the supplied BFD to the format
|
||||
requested. If the target set in the BFD does not support the format
|
||||
requested, the format is illegal or the BFD is not open for writing
|
||||
than an error occurs.
|
||||
*/
|
||||
PROTO(boolean,bfd_set_format,(bfd *, bfd_format));
|
||||
|
|
|
|||
Loading…
Reference in a new issue