1 /* BFD back-end for CISCO crash dumps.
2 Copyright 1994, 1997, 1999, 2000, 2001, 2002, 2004, 2005, 2006, 2007,
4 Free Software Foundation, Inc.
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 3 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., 51 Franklin Street - Fifth Floor, Boston,
21 MA 02110-1301, USA. */
26 /* core_file_failing_signal returns a host signal (this probably should
41 int crash_info_locs
[] =
43 0x0250, /* mips, ppc, x86, i960 */
44 0x0400, /* m68k, mips, x86, i960 */
45 0x0FFC, /* m68k, mips, ppc, x86, i960 */
51 #define CRASH_MAGIC 0xdead1234
52 #define MASK_ADDR(x) ((x) & 0x0fffffff) /* Mask crash info address */
56 CRASH_REASON_NOTCRASHED
= 0,
57 CRASH_REASON_EXCEPTION
= 1,
58 CRASH_REASON_CORRUPT
= 2,
63 char magic
[4]; /* Magic number */
64 char version
[4]; /* Version number */
65 char reason
[4]; /* Crash reason */
66 char cpu_vector
[4]; /* CPU vector for exceptions */
67 char registers
[4]; /* Pointer to saved registers */
68 char rambase
[4]; /* Base of RAM (not in V1 crash info) */
69 char textbase
[4]; /* Base of .text section (not in V3 crash info) */
70 char database
[4]; /* Base of .data section (not in V3 crash info) */
71 char bssbase
[4]; /* Base of .bss section (not in V3 crash info) */
74 struct cisco_core_struct
79 #define cisco_core_file_matches_executable_p generic_core_file_matches_executable_p
80 #define cisco_core_file_pid _bfd_nocore_core_file_pid
82 /* Examine the file for a crash info struct at the offset given by
85 static const bfd_target
*
86 cisco_core_file_validate (bfd
*abfd
, int crash_info_loc
)
89 unsigned int crashinfo_offset
;
90 crashinfo_external crashinfo
;
100 if (bfd_seek (abfd
, (file_ptr
) crash_info_loc
, SEEK_SET
) != 0)
103 nread
= bfd_bread (buf
, (bfd_size_type
) 4, abfd
);
106 if (bfd_get_error () != bfd_error_system_call
)
107 bfd_set_error (bfd_error_wrong_format
);
110 crashinfo_offset
= MASK_ADDR (bfd_get_32 (abfd
, buf
));
112 if (bfd_seek (abfd
, (file_ptr
) crashinfo_offset
, SEEK_SET
) != 0)
114 /* Most likely we failed because of a bogus (huge) offset */
115 bfd_set_error (bfd_error_wrong_format
);
119 nread
= bfd_bread (&crashinfo
, (bfd_size_type
) sizeof (crashinfo
), abfd
);
120 if (nread
!= sizeof (crashinfo
))
122 if (bfd_get_error () != bfd_error_system_call
)
123 bfd_set_error (bfd_error_wrong_format
);
127 if (bfd_stat (abfd
, &statbuf
) < 0)
129 bfd_set_error (bfd_error_system_call
);
133 magic
= bfd_get_32 (abfd
, crashinfo
.magic
);
134 if (magic
!= CRASH_MAGIC
)
136 bfd_set_error (bfd_error_wrong_format
);
140 version
= bfd_get_32 (abfd
, crashinfo
.version
);
143 bfd_set_error (bfd_error_wrong_format
);
146 else if (version
== 1)
148 /* V1 core dumps don't specify the dump base, assume 0 */
153 rambase
= bfd_get_32 (abfd
, crashinfo
.rambase
);
156 /* OK, we believe you. You're a core file. */
158 amt
= sizeof (struct cisco_core_struct
);
159 abfd
->tdata
.cisco_core_data
= (struct cisco_core_struct
*) bfd_zmalloc (amt
);
160 if (abfd
->tdata
.cisco_core_data
== NULL
)
163 switch ((crashreason
) bfd_get_32 (abfd
, crashinfo
.reason
))
165 case CRASH_REASON_NOTCRASHED
:
166 /* Crash file probably came from write core. */
167 abfd
->tdata
.cisco_core_data
->sig
= 0;
169 case CRASH_REASON_CORRUPT
:
170 /* The crash context area was corrupt -- proceed with caution.
171 We have no way of passing this information back to the caller. */
172 abfd
->tdata
.cisco_core_data
->sig
= 0;
174 case CRASH_REASON_EXCEPTION
:
175 /* Crash occured due to CPU exception. */
177 /* This is 68k-specific; for MIPS we'll need to interpret
178 cpu_vector differently based on the target configuration
179 (since CISCO core files don't seem to have the processor
182 switch (bfd_get_32 (abfd
, crashinfo
.cpu_vector
))
185 case 2 : abfd
->tdata
.cisco_core_data
->sig
= SIGBUS
; break;
187 case 3 : abfd
->tdata
.cisco_core_data
->sig
= SIGBUS
; break;
188 /* illegal instruction */
189 case 4 : abfd
->tdata
.cisco_core_data
->sig
= SIGILL
; break;
191 case 5 : abfd
->tdata
.cisco_core_data
->sig
= SIGFPE
; break;
192 /* chk instruction */
193 case 6 : abfd
->tdata
.cisco_core_data
->sig
= SIGFPE
; break;
194 /* trapv instruction */
195 case 7 : abfd
->tdata
.cisco_core_data
->sig
= SIGFPE
; break;
196 /* privilege violation */
197 case 8 : abfd
->tdata
.cisco_core_data
->sig
= SIGSEGV
; break;
199 case 9 : abfd
->tdata
.cisco_core_data
->sig
= SIGTRAP
; break;
200 /* line 1010 emulator */
201 case 10: abfd
->tdata
.cisco_core_data
->sig
= SIGILL
; break;
202 /* line 1111 emulator */
203 case 11: abfd
->tdata
.cisco_core_data
->sig
= SIGILL
; break;
205 /* Coprocessor protocol violation. Using a standard MMU or FPU
206 this cannot be triggered by software. Call it a SIGBUS. */
207 case 13: abfd
->tdata
.cisco_core_data
->sig
= SIGBUS
; break;
210 case 31: abfd
->tdata
.cisco_core_data
->sig
= SIGINT
; break;
212 case 33: abfd
->tdata
.cisco_core_data
->sig
= SIGTRAP
; break;
214 /* floating point err */
215 case 48: abfd
->tdata
.cisco_core_data
->sig
= SIGFPE
; break;
216 /* floating point err */
217 case 49: abfd
->tdata
.cisco_core_data
->sig
= SIGFPE
; break;
219 case 50: abfd
->tdata
.cisco_core_data
->sig
= SIGFPE
; break;
221 case 51: abfd
->tdata
.cisco_core_data
->sig
= SIGFPE
; break;
223 case 52: abfd
->tdata
.cisco_core_data
->sig
= SIGFPE
; break;
225 case 53: abfd
->tdata
.cisco_core_data
->sig
= SIGFPE
; break;
227 case 54: abfd
->tdata
.cisco_core_data
->sig
= SIGFPE
; break;
230 #define SIGEMT SIGTRAP
232 /* "software generated"*/
233 abfd
->tdata
.cisco_core_data
->sig
= SIGEMT
;
237 /* Unknown crash reason. */
238 abfd
->tdata
.cisco_core_data
->sig
= 0;
242 /* Create a ".data" section that maps the entire file, which is
243 essentially a dump of the target system's RAM. */
245 flags
= SEC_ALLOC
| SEC_LOAD
| SEC_HAS_CONTENTS
;
246 asect
= bfd_make_section_anyway_with_flags (abfd
, ".data", flags
);
249 /* The size of memory is the size of the core file itself. */
250 asect
->size
= statbuf
.st_size
;
251 asect
->vma
= rambase
;
254 /* Create a ".crash" section to allow access to the saved
255 crash information. */
257 flags
= SEC_HAS_CONTENTS
;
258 asect
= bfd_make_section_anyway_with_flags (abfd
, ".crash", flags
);
262 asect
->filepos
= crashinfo_offset
;
263 asect
->size
= sizeof (crashinfo
);
265 /* Create a ".reg" section to allow access to the saved
268 asect
= bfd_make_section_anyway_with_flags (abfd
, ".reg", flags
);
272 asect
->filepos
= bfd_get_32 (abfd
, crashinfo
.registers
) - rambase
;
273 /* Since we don't know the exact size of the saved register info,
274 choose a register section size that is either the remaining part
275 of the file, or 1024, whichever is smaller. */
276 nread
= statbuf
.st_size
- asect
->filepos
;
277 asect
->size
= (nread
< 1024) ? nread
: 1024;
281 /* Get here if we have already started filling out the BFD
282 and there is an error of some kind. */
285 bfd_release (abfd
, abfd
->tdata
.any
);
286 abfd
->tdata
.any
= NULL
;
287 bfd_section_list_clear (abfd
);
291 static const bfd_target
*
292 cisco_core_file_p (bfd
*abfd
)
294 int *crash_info_locp
;
295 const bfd_target
*target
= NULL
;
297 for (crash_info_locp
= crash_info_locs
;
298 *crash_info_locp
!= -1 && target
== NULL
;
301 target
= cisco_core_file_validate (abfd
, *crash_info_locp
);
307 cisco_core_file_failing_command (bfd
*abfd ATTRIBUTE_UNUSED
)
313 cisco_core_file_failing_signal (bfd
*abfd ATTRIBUTE_UNUSED
)
315 return abfd
->tdata
.cisco_core_data
->sig
;
318 extern const bfd_target cisco_core_little_vec
;
320 const bfd_target cisco_core_big_vec
=
322 "cisco-ios-core-big",
323 bfd_target_unknown_flavour
,
324 BFD_ENDIAN_BIG
, /* target byte order */
325 BFD_ENDIAN_BIG
, /* target headers byte order */
326 (HAS_RELOC
| EXEC_P
| /* object flags */
327 HAS_LINENO
| HAS_DEBUG
|
328 HAS_SYMS
| HAS_LOCALS
| WP_TEXT
| D_PAGED
),
329 (SEC_HAS_CONTENTS
| SEC_ALLOC
| SEC_LOAD
| SEC_RELOC
), /* section flags */
330 0, /* symbol prefix */
331 ' ', /* ar_pad_char */
332 16, /* ar_max_namelen */
333 0, /* match priority. */
334 bfd_getb64
, bfd_getb_signed_64
, bfd_putb64
,
335 bfd_getb32
, bfd_getb_signed_32
, bfd_putb32
,
336 bfd_getb16
, bfd_getb_signed_16
, bfd_putb16
, /* data */
337 bfd_getb64
, bfd_getb_signed_64
, bfd_putb64
,
338 bfd_getb32
, bfd_getb_signed_32
, bfd_putb32
,
339 bfd_getb16
, bfd_getb_signed_16
, bfd_putb16
, /* hdrs */
341 { /* bfd_check_format */
342 _bfd_dummy_target
, /* unknown format */
343 _bfd_dummy_target
, /* object file */
344 _bfd_dummy_target
, /* archive */
345 cisco_core_file_p
/* a core file */
347 { /* bfd_set_format */
348 bfd_false
, bfd_false
,
351 { /* bfd_write_contents */
352 bfd_false
, bfd_false
,
356 BFD_JUMP_TABLE_GENERIC (_bfd_generic
),
357 BFD_JUMP_TABLE_COPY (_bfd_generic
),
358 BFD_JUMP_TABLE_CORE (cisco
),
359 BFD_JUMP_TABLE_ARCHIVE (_bfd_noarchive
),
360 BFD_JUMP_TABLE_SYMBOLS (_bfd_nosymbols
),
361 BFD_JUMP_TABLE_RELOCS (_bfd_norelocs
),
362 BFD_JUMP_TABLE_WRITE (_bfd_generic
),
363 BFD_JUMP_TABLE_LINK (_bfd_nolink
),
364 BFD_JUMP_TABLE_DYNAMIC (_bfd_nodynamic
),
366 & cisco_core_little_vec
,
368 NULL
/* backend_data */
371 const bfd_target cisco_core_little_vec
=
373 "cisco-ios-core-little",
374 bfd_target_unknown_flavour
,
375 BFD_ENDIAN_LITTLE
, /* target byte order */
376 BFD_ENDIAN_LITTLE
, /* target headers byte order */
377 (HAS_RELOC
| EXEC_P
| /* object flags */
378 HAS_LINENO
| HAS_DEBUG
|
379 HAS_SYMS
| HAS_LOCALS
| WP_TEXT
| D_PAGED
),
380 (SEC_HAS_CONTENTS
| SEC_ALLOC
| SEC_LOAD
| SEC_RELOC
), /* section flags */
381 0, /* symbol prefix */
382 ' ', /* ar_pad_char */
383 16, /* ar_max_namelen */
384 0, /* match_priority */
385 bfd_getl64
, bfd_getl_signed_64
, bfd_putl64
,
386 bfd_getl32
, bfd_getl_signed_32
, bfd_putl32
,
387 bfd_getl16
, bfd_getl_signed_16
, bfd_putl16
, /* data */
388 bfd_getl64
, bfd_getl_signed_64
, bfd_putl64
,
389 bfd_getl32
, bfd_getl_signed_32
, bfd_putl32
,
390 bfd_getl16
, bfd_getl_signed_16
, bfd_putl16
, /* hdrs */
392 { /* bfd_check_format */
393 _bfd_dummy_target
, /* unknown format */
394 _bfd_dummy_target
, /* object file */
395 _bfd_dummy_target
, /* archive */
396 cisco_core_file_p
/* a core file */
398 { /* bfd_set_format */
399 bfd_false
, bfd_false
,
402 { /* bfd_write_contents */
403 bfd_false
, bfd_false
,
407 BFD_JUMP_TABLE_GENERIC (_bfd_generic
),
408 BFD_JUMP_TABLE_COPY (_bfd_generic
),
409 BFD_JUMP_TABLE_CORE (cisco
),
410 BFD_JUMP_TABLE_ARCHIVE (_bfd_noarchive
),
411 BFD_JUMP_TABLE_SYMBOLS (_bfd_nosymbols
),
412 BFD_JUMP_TABLE_RELOCS (_bfd_norelocs
),
413 BFD_JUMP_TABLE_WRITE (_bfd_generic
),
414 BFD_JUMP_TABLE_LINK (_bfd_nolink
),
415 BFD_JUMP_TABLE_DYNAMIC (_bfd_nodynamic
),
419 NULL
/* backend_data */