daily update
[binutils.git] / bfd / corefile.c
blob24142254eed0d8b143220358b5cf501df9ecee97
1 /* Core file generic interface routines for BFD.
2 Copyright 1990, 1991, 1992, 1993, 1994, 2000, 2001, 2002
3 Free Software Foundation, Inc.
4 Written by Cygnus Support.
6 This file is part of BFD, the Binary File Descriptor library.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
23 SECTION
24 Core files
26 DESCRIPTION
27 These are functions pertaining to core files.
30 #include "bfd.h"
31 #include "sysdep.h"
32 #include "libbfd.h"
35 FUNCTION
36 bfd_core_file_failing_command
38 SYNOPSIS
39 const char *bfd_core_file_failing_command(bfd *abfd);
41 DESCRIPTION
42 Return a read-only string explaining which program was running
43 when it failed and produced the core file @var{abfd}.
47 const char *
48 bfd_core_file_failing_command (abfd)
49 bfd *abfd;
51 if (abfd->format != bfd_core) {
52 bfd_set_error (bfd_error_invalid_operation);
53 return NULL;
55 return BFD_SEND (abfd, _core_file_failing_command, (abfd));
59 FUNCTION
60 bfd_core_file_failing_signal
62 SYNOPSIS
63 int bfd_core_file_failing_signal(bfd *abfd);
65 DESCRIPTION
66 Returns the signal number which caused the core dump which
67 generated the file the BFD @var{abfd} is attached to.
70 int
71 bfd_core_file_failing_signal (abfd)
72 bfd *abfd;
74 if (abfd->format != bfd_core) {
75 bfd_set_error (bfd_error_invalid_operation);
76 return 0;
78 return BFD_SEND (abfd, _core_file_failing_signal, (abfd));
82 FUNCTION
83 core_file_matches_executable_p
85 SYNOPSIS
86 boolean core_file_matches_executable_p
87 (bfd *core_bfd, bfd *exec_bfd);
89 DESCRIPTION
90 Return <<true>> if the core file attached to @var{core_bfd}
91 was generated by a run of the executable file attached to
92 @var{exec_bfd}, <<false>> otherwise.
94 boolean
95 core_file_matches_executable_p (core_bfd, exec_bfd)
96 bfd *core_bfd, *exec_bfd;
98 if ((core_bfd->format != bfd_core) || (exec_bfd->format != bfd_object)) {
99 bfd_set_error (bfd_error_wrong_format);
100 return false;
103 return BFD_SEND (core_bfd, _core_file_matches_executable_p,
104 (core_bfd, exec_bfd));