[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

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'.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

This document was generated by system on December, 2 2004 using texi2html