Home | History | Annotate | Line # | Download | only in doc 
      1 @section Core files
      2 
      3 
      4 @subsection Core file functions
      5 
      6 
      7 These are functions pertaining to core files.
      8 
      9 @findex bfd_core_file_failing_command
     10 @subsubsection @code{bfd_core_file_failing_command}
     11 @deftypefn {Function} const char *bfd_core_file_failing_command (bfd *abfd); 
     12 Return a read-only string explaining which program was running
     13 when it failed and produced the core file @var{abfd}.
     14 
     15 @end deftypefn
     16 @findex bfd_core_file_failing_signal
     17 @subsubsection @code{bfd_core_file_failing_signal}
     18 @deftypefn {Function} int bfd_core_file_failing_signal (bfd *abfd); 
     19 Returns the signal number which caused the core dump which
     20 generated the file the BFD @var{abfd} is attached to.
     21 
     22 @end deftypefn
     23 @findex bfd_core_file_pid
     24 @subsubsection @code{bfd_core_file_pid}
     25 @deftypefn {Function} int bfd_core_file_pid (bfd *abfd); 
     26 Returns the PID of the process the core dump the BFD
     27 @var{abfd} is attached to was generated from.
     28 
     29 @end deftypefn
     30 @findex core_file_matches_executable_p
     31 @subsubsection @code{core_file_matches_executable_p}
     32 @deftypefn {Function} bool core_file_matches_executable_p (bfd *core_bfd, bfd *exec_bfd); 
     33 Return @code{TRUE} if the core file attached to @var{core_bfd}
     34 was generated by a run of the executable file attached to
     35 @var{exec_bfd}, @code{FALSE} otherwise.
     36 
     37 @end deftypefn
     38 @findex generic_core_file_matches_executable_p
     39 @subsubsection @code{generic_core_file_matches_executable_p}
     40 @deftypefn {Function} bool generic_core_file_matches_executable_p (bfd *core_bfd, bfd *exec_bfd); 
     41 Return TRUE if the core file attached to @var{core_bfd}
     42 was generated by a run of the executable file attached
     43 to @var{exec_bfd}.  The match is based on executable
     44 basenames only.
     45 
     46 Note: When not able to determine the core file failing
     47 command or the executable name, we still return TRUE even
     48 though we're not sure that core file and executable match.
     49 This is to avoid generating a false warning in situations
     50 where we really don't know whether they match or not.
     51 
     52 @end deftypefn
     53