bfd: Core Files

 
 2.11 Core files
 ===============
 
 2.11.1 Core file functions
 --------------------------
 
 *Description*
 These are functions pertaining to core files.
 
 2.11.1.1 'bfd_core_file_failing_command'
 ........................................
 
 *Synopsis*
      const char *bfd_core_file_failing_command (bfd *abfd);
    *Description*
 Return a read-only string explaining which program was running when it
 failed and produced the core file ABFD.
 
 2.11.1.2 'bfd_core_file_failing_signal'
 .......................................
 
 *Synopsis*
      int bfd_core_file_failing_signal (bfd *abfd);
    *Description*
 Returns the signal number which caused the core dump which generated the
 file the BFD ABFD is attached to.
 
 2.11.1.3 'bfd_core_file_pid'
 ............................
 
 *Synopsis*
      int bfd_core_file_pid (bfd *abfd);
    *Description*
 Returns the PID of the process the core dump the BFD ABFD is attached to
 was generated from.
 
 2.11.1.4 'core_file_matches_executable_p'
 .........................................
 
 *Synopsis*
      bfd_boolean core_file_matches_executable_p
         (bfd *core_bfd, bfd *exec_bfd);
    *Description*
 Return 'TRUE' if the core file attached to CORE_BFD was generated by a
 run of the executable file attached to EXEC_BFD, 'FALSE' otherwise.
 
 2.11.1.5 'generic_core_file_matches_executable_p'
 .................................................
 
 *Synopsis*
      bfd_boolean generic_core_file_matches_executable_p
         (bfd *core_bfd, bfd *exec_bfd);
    *Description*
 Return TRUE if the core file attached to CORE_BFD was generated by a run
 of the executable file attached to EXEC_BFD.  The match is based on
 executable basenames only.
 
    Note: When not able to determine the core file failing command or the
 executable name, we still return TRUE even though we're not sure that
 core file and executable match.  This is to avoid generating a false
 warning in situations where we really don't know whether they match or
 not.