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