3.5 Generic functions
The `BFD_JUMP_TABLE_GENERIC' macro is used for some catch all
functions which don't easily fit into other categories.
- `_close_and_cleanup'
- Free any target specific information associated with the BFD. This is
called when any BFD is closed (the `bfd_write_contents' function
mentioned earlier is only called for a BFD opened for writing). Most
targets use `bfd_alloc' to allocate all target specific
information, and therefore don't have to do anything in this function.
This function pointer is typically set to
`_bfd_generic_close_and_cleanup', which simply returns true.
- `_bfd_free_cached_info'
- Free any cached information associated with the BFD which can be
recreated later if necessary. This is used to reduce the memory
consumption required by programs using BFD. This is normally called via
the `bfd_free_cached_info' macro. It is used by the default
archive routines when computing the archive map. Most targets do not
do anything special for this entry point, and just set it to
`_bfd_generic_free_cached_info', which simply returns true.
- `_new_section_hook'
- This is called from `bfd_make_section_anyway' whenever a new
section is created. Most targets use it to initialize section specific
information. This function is called whether or not the section
corresponds to an actual section in an actual BFD.
- `_get_section_contents'
- Get the contents of a section. This is called from
`bfd_get_section_contents'. Most targets set this to
`_bfd_generic_get_section_contents', which does a `bfd_seek'
based on the section's `filepos' field and a `bfd_bread'. The
corresponding field in the target vector is named
`_bfd_get_section_contents'.
- `_get_section_contents_in_window'
- Set a `bfd_window' to hold the contents of a section. This is
called from `bfd_get_section_contents_in_window'. The
`bfd_window' idea never really caught on, and I don't think this is
ever called. Pretty much all targets implement this as
`bfd_generic_get_section_contents_in_window', which uses
`bfd_get_section_contents' to do the right thing. The
corresponding field in the target vector is named
`_bfd_get_section_contents_in_window'.
This document was generated
by system on December, 2 2004
using texi2html