1@section Core files
2
3
4@subsection Core file functions
5
6
7These 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); 
12Return a read-only string explaining which program was running
13when 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); 
19Returns the signal number which caused the core dump which
20generated 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); 
26Returns 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); 
33Return @code{TRUE} if the core file attached to @var{core_bfd}
34was 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); 
41Return TRUE if the core file attached to @var{core_bfd}
42was generated by a run of the executable file attached
43to @var{exec_bfd}.  The match is based on executable
44basenames only.
45
46Note: When not able to determine the core file failing
47command or the executable name, we still return TRUE even
48though we're not sure that core file and executable match.
49This is to avoid generating a false warning in situations
50where we really don't know whether they match or not.
51
52@end deftypefn
53