gdb/
[platform/upstream/binutils.git] / gdb / corelow.c
1 /* Core dump and executable file functions below target vector, for GDB.
2
3    Copyright (C) 1986-2013 Free Software Foundation, Inc.
4
5    This file is part of GDB.
6
7    This program is free software; you can redistribute it and/or modify
8    it under the terms of the GNU General Public License as published by
9    the Free Software Foundation; either version 3 of the License, or
10    (at your option) any later version.
11
12    This program is distributed in the hope that it will be useful,
13    but WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15    GNU General Public License for more details.
16
17    You should have received a copy of the GNU General Public License
18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
19
20 #include "defs.h"
21 #include "arch-utils.h"
22 #include "gdb_string.h"
23 #include <errno.h>
24 #include <signal.h>
25 #include <fcntl.h>
26 #ifdef HAVE_SYS_FILE_H
27 #include <sys/file.h>           /* needed for F_OK and friends */
28 #endif
29 #include "frame.h"              /* required by inferior.h */
30 #include "inferior.h"
31 #include "symtab.h"
32 #include "command.h"
33 #include "bfd.h"
34 #include "target.h"
35 #include "gdbcore.h"
36 #include "gdbthread.h"
37 #include "regcache.h"
38 #include "regset.h"
39 #include "symfile.h"
40 #include "exec.h"
41 #include "readline/readline.h"
42 #include "gdb_assert.h"
43 #include "exceptions.h"
44 #include "solib.h"
45 #include "filenames.h"
46 #include "progspace.h"
47 #include "objfiles.h"
48 #include "gdb_bfd.h"
49 #include "completer.h"
50
51 #ifndef O_LARGEFILE
52 #define O_LARGEFILE 0
53 #endif
54
55 /* List of all available core_fns.  On gdb startup, each core file
56    register reader calls deprecated_add_core_fns() to register
57    information on each core format it is prepared to read.  */
58
59 static struct core_fns *core_file_fns = NULL;
60
61 /* The core_fns for a core file handler that is prepared to read the
62    core file currently open on core_bfd.  */
63
64 static struct core_fns *core_vec = NULL;
65
66 /* FIXME: kettenis/20031023: Eventually this variable should
67    disappear.  */
68
69 struct gdbarch *core_gdbarch = NULL;
70
71 /* Per-core data.  Currently, only the section table.  Note that these
72    target sections are *not* mapped in the current address spaces' set
73    of target sections --- those should come only from pure executable
74    or shared library bfds.  The core bfd sections are an
75    implementation detail of the core target, just like ptrace is for
76    unix child targets.  */
77 static struct target_section_table *core_data;
78
79 static void core_files_info (struct target_ops *);
80
81 static struct core_fns *sniff_core_bfd (bfd *);
82
83 static int gdb_check_format (bfd *);
84
85 static void core_open (char *, int);
86
87 static void core_detach (struct target_ops *ops, char *, int);
88
89 static void core_close (void);
90
91 static void core_close_cleanup (void *ignore);
92
93 static void add_to_thread_list (bfd *, asection *, void *);
94
95 static void init_core_ops (void);
96
97 void _initialize_corelow (void);
98
99 static struct target_ops core_ops;
100
101 /* An arbitrary identifier for the core inferior.  */
102 #define CORELOW_PID 1
103
104 /* Link a new core_fns into the global core_file_fns list.  Called on
105    gdb startup by the _initialize routine in each core file register
106    reader, to register information about each format the reader is
107    prepared to handle.  */
108
109 void
110 deprecated_add_core_fns (struct core_fns *cf)
111 {
112   cf->next = core_file_fns;
113   core_file_fns = cf;
114 }
115
116 /* The default function that core file handlers can use to examine a
117    core file BFD and decide whether or not to accept the job of
118    reading the core file.  */
119
120 int
121 default_core_sniffer (struct core_fns *our_fns, bfd *abfd)
122 {
123   int result;
124
125   result = (bfd_get_flavour (abfd) == our_fns -> core_flavour);
126   return (result);
127 }
128
129 /* Walk through the list of core functions to find a set that can
130    handle the core file open on ABFD.  Returns pointer to set that is
131    selected.  */
132
133 static struct core_fns *
134 sniff_core_bfd (bfd *abfd)
135 {
136   struct core_fns *cf;
137   struct core_fns *yummy = NULL;
138   int matches = 0;;
139
140   /* Don't sniff if we have support for register sets in
141      CORE_GDBARCH.  */
142   if (core_gdbarch && gdbarch_regset_from_core_section_p (core_gdbarch))
143     return NULL;
144
145   for (cf = core_file_fns; cf != NULL; cf = cf->next)
146     {
147       if (cf->core_sniffer (cf, abfd))
148         {
149           yummy = cf;
150           matches++;
151         }
152     }
153   if (matches > 1)
154     {
155       warning (_("\"%s\": ambiguous core format, %d handlers match"),
156                bfd_get_filename (abfd), matches);
157     }
158   else if (matches == 0)
159     error (_("\"%s\": no core file handler recognizes format"),
160            bfd_get_filename (abfd));
161
162   return (yummy);
163 }
164
165 /* The default is to reject every core file format we see.  Either
166    BFD has to recognize it, or we have to provide a function in the
167    core file handler that recognizes it.  */
168
169 int
170 default_check_format (bfd *abfd)
171 {
172   return (0);
173 }
174
175 /* Attempt to recognize core file formats that BFD rejects.  */
176
177 static int
178 gdb_check_format (bfd *abfd)
179 {
180   struct core_fns *cf;
181
182   for (cf = core_file_fns; cf != NULL; cf = cf->next)
183     {
184       if (cf->check_format (abfd))
185         {
186           return (1);
187         }
188     }
189   return (0);
190 }
191
192 /* Discard all vestiges of any previous core file and mark data and
193    stack spaces as empty.  */
194
195 static void
196 core_close (void)
197 {
198   if (core_bfd)
199     {
200       int pid = ptid_get_pid (inferior_ptid);
201       inferior_ptid = null_ptid;    /* Avoid confusion from thread
202                                        stuff.  */
203       if (pid != 0)
204         exit_inferior_silent (pid);
205
206       /* Clear out solib state while the bfd is still open.  See
207          comments in clear_solib in solib.c.  */
208       clear_solib ();
209
210       if (core_data)
211         {
212           xfree (core_data->sections);
213           xfree (core_data);
214           core_data = NULL;
215         }
216
217       gdb_bfd_unref (core_bfd);
218       core_bfd = NULL;
219     }
220   core_vec = NULL;
221   core_gdbarch = NULL;
222 }
223
224 static void
225 core_close_cleanup (void *ignore)
226 {
227   core_close ();
228 }
229
230 /* Look for sections whose names start with `.reg/' so that we can
231    extract the list of threads in a core file.  */
232
233 static void
234 add_to_thread_list (bfd *abfd, asection *asect, void *reg_sect_arg)
235 {
236   ptid_t ptid;
237   int core_tid;
238   int pid, lwpid;
239   asection *reg_sect = (asection *) reg_sect_arg;
240   int fake_pid_p = 0;
241   struct inferior *inf;
242
243   if (strncmp (bfd_section_name (abfd, asect), ".reg/", 5) != 0)
244     return;
245
246   core_tid = atoi (bfd_section_name (abfd, asect) + 5);
247
248   pid = bfd_core_file_pid (core_bfd);
249   if (pid == 0)
250     {
251       fake_pid_p = 1;
252       pid = CORELOW_PID;
253     }
254
255   lwpid = core_tid;
256
257   inf = current_inferior ();
258   if (inf->pid == 0)
259     {
260       inferior_appeared (inf, pid);
261       inf->fake_pid_p = fake_pid_p;
262     }
263
264   ptid = ptid_build (pid, lwpid, 0);
265
266   add_thread (ptid);
267
268 /* Warning, Will Robinson, looking at BFD private data! */
269
270   if (reg_sect != NULL
271       && asect->filepos == reg_sect->filepos)   /* Did we find .reg?  */
272     inferior_ptid = ptid;                       /* Yes, make it current.  */
273 }
274
275 /* This routine opens and sets up the core file bfd.  */
276
277 static void
278 core_open (char *filename, int from_tty)
279 {
280   const char *p;
281   int siggy;
282   struct cleanup *old_chain;
283   char *temp;
284   bfd *temp_bfd;
285   int scratch_chan;
286   int flags;
287   volatile struct gdb_exception except;
288
289   target_preopen (from_tty);
290   if (!filename)
291     {
292       if (core_bfd)
293         error (_("No core file specified.  (Use `detach' "
294                  "to stop debugging a core file.)"));
295       else
296         error (_("No core file specified."));
297     }
298
299   filename = tilde_expand (filename);
300   if (!IS_ABSOLUTE_PATH (filename))
301     {
302       temp = concat (current_directory, "/",
303                      filename, (char *) NULL);
304       xfree (filename);
305       filename = temp;
306     }
307
308   old_chain = make_cleanup (xfree, filename);
309
310   flags = O_BINARY | O_LARGEFILE;
311   if (write_files)
312     flags |= O_RDWR;
313   else
314     flags |= O_RDONLY;
315   scratch_chan = open (filename, flags, 0);
316   if (scratch_chan < 0)
317     perror_with_name (filename);
318
319   temp_bfd = gdb_bfd_fopen (filename, gnutarget, 
320                             write_files ? FOPEN_RUB : FOPEN_RB,
321                             scratch_chan);
322   if (temp_bfd == NULL)
323     perror_with_name (filename);
324
325   if (!bfd_check_format (temp_bfd, bfd_core)
326       && !gdb_check_format (temp_bfd))
327     {
328       /* Do it after the err msg */
329       /* FIXME: should be checking for errors from bfd_close (for one
330          thing, on error it does not free all the storage associated
331          with the bfd).  */
332       make_cleanup_bfd_unref (temp_bfd);
333       error (_("\"%s\" is not a core dump: %s"),
334              filename, bfd_errmsg (bfd_get_error ()));
335     }
336
337   /* Looks semi-reasonable.  Toss the old core file and work on the
338      new.  */
339
340   do_cleanups (old_chain);
341   unpush_target (&core_ops);
342   core_bfd = temp_bfd;
343   old_chain = make_cleanup (core_close_cleanup, 0 /*ignore*/);
344
345   core_gdbarch = gdbarch_from_bfd (core_bfd);
346
347   /* Find a suitable core file handler to munch on core_bfd */
348   core_vec = sniff_core_bfd (core_bfd);
349
350   validate_files ();
351
352   core_data = XZALLOC (struct target_section_table);
353
354   /* Find the data section */
355   if (build_section_table (core_bfd,
356                            &core_data->sections,
357                            &core_data->sections_end))
358     error (_("\"%s\": Can't find sections: %s"),
359            bfd_get_filename (core_bfd), bfd_errmsg (bfd_get_error ()));
360
361   /* If we have no exec file, try to set the architecture from the
362      core file.  We don't do this unconditionally since an exec file
363      typically contains more information that helps us determine the
364      architecture than a core file.  */
365   if (!exec_bfd)
366     set_gdbarch_from_file (core_bfd);
367
368   push_target (&core_ops);
369   discard_cleanups (old_chain);
370
371   /* Do this before acknowledging the inferior, so if
372      post_create_inferior throws (can happen easilly if you're loading
373      a core file with the wrong exec), we aren't left with threads
374      from the previous inferior.  */
375   init_thread_list ();
376
377   inferior_ptid = null_ptid;
378
379   /* Need to flush the register cache (and the frame cache) from a
380      previous debug session.  If inferior_ptid ends up the same as the
381      last debug session --- e.g., b foo; run; gcore core1; step; gcore
382      core2; core core1; core core2 --- then there's potential for
383      get_current_regcache to return the cached regcache of the
384      previous session, and the frame cache being stale.  */
385   registers_changed ();
386
387   /* Build up thread list from BFD sections, and possibly set the
388      current thread to the .reg/NN section matching the .reg
389      section.  */
390   bfd_map_over_sections (core_bfd, add_to_thread_list,
391                          bfd_get_section_by_name (core_bfd, ".reg"));
392
393   if (ptid_equal (inferior_ptid, null_ptid))
394     {
395       /* Either we found no .reg/NN section, and hence we have a
396          non-threaded core (single-threaded, from gdb's perspective),
397          or for some reason add_to_thread_list couldn't determine
398          which was the "main" thread.  The latter case shouldn't
399          usually happen, but we're dealing with input here, which can
400          always be broken in different ways.  */
401       struct thread_info *thread = first_thread_of_process (-1);
402
403       if (thread == NULL)
404         {
405           inferior_appeared (current_inferior (), CORELOW_PID);
406           inferior_ptid = pid_to_ptid (CORELOW_PID);
407           add_thread_silent (inferior_ptid);
408         }
409       else
410         switch_to_thread (thread->ptid);
411     }
412
413   post_create_inferior (&core_ops, from_tty);
414
415   /* Now go through the target stack looking for threads since there
416      may be a thread_stratum target loaded on top of target core by
417      now.  The layer above should claim threads found in the BFD
418      sections.  */
419   TRY_CATCH (except, RETURN_MASK_ERROR)
420     {
421       target_find_new_threads ();
422     }
423
424   if (except.reason < 0)
425     exception_print (gdb_stderr, except);
426
427   p = bfd_core_file_failing_command (core_bfd);
428   if (p)
429     printf_filtered (_("Core was generated by `%s'.\n"), p);
430
431   siggy = bfd_core_file_failing_signal (core_bfd);
432   if (siggy > 0)
433     {
434       /* If we don't have a CORE_GDBARCH to work with, assume a native
435          core (map gdb_signal from host signals).  If we do have
436          CORE_GDBARCH to work with, but no gdb_signal_from_target
437          implementation for that gdbarch, as a fallback measure,
438          assume the host signal mapping.  It'll be correct for native
439          cores, but most likely incorrect for cross-cores.  */
440       enum gdb_signal sig = (core_gdbarch != NULL
441                              && gdbarch_gdb_signal_from_target_p (core_gdbarch)
442                              ? gdbarch_gdb_signal_from_target (core_gdbarch,
443                                                                siggy)
444                              : gdb_signal_from_host (siggy));
445
446       printf_filtered (_("Program terminated with signal %d, %s.\n"),
447                        siggy, gdb_signal_to_string (sig));
448     }
449
450   /* Fetch all registers from core file.  */
451   target_fetch_registers (get_current_regcache (), -1);
452
453   /* Now, set up the frame cache, and print the top of stack.  */
454   reinit_frame_cache ();
455   print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC);
456 }
457
458 static void
459 core_detach (struct target_ops *ops, char *args, int from_tty)
460 {
461   if (args)
462     error (_("Too many arguments"));
463   unpush_target (ops);
464   reinit_frame_cache ();
465   if (from_tty)
466     printf_filtered (_("No core file now.\n"));
467 }
468
469 #ifdef DEPRECATED_IBM6000_TARGET
470
471 /* Resize the core memory's section table, by NUM_ADDED.  Returns a
472    pointer into the first new slot.  This will not be necessary when
473    the rs6000 target is converted to use the standard solib
474    framework.  */
475
476 struct target_section *
477 deprecated_core_resize_section_table (int num_added)
478 {
479   int old_count;
480
481   old_count = resize_section_table (core_data, num_added);
482   return core_data->sections + old_count;
483 }
484
485 #endif
486
487 /* Try to retrieve registers from a section in core_bfd, and supply
488    them to core_vec->core_read_registers, as the register set numbered
489    WHICH.
490
491    If inferior_ptid's lwp member is zero, do the single-threaded
492    thing: look for a section named NAME.  If inferior_ptid's lwp
493    member is non-zero, do the multi-threaded thing: look for a section
494    named "NAME/LWP", where LWP is the shortest ASCII decimal
495    representation of inferior_ptid's lwp member.
496
497    HUMAN_NAME is a human-readable name for the kind of registers the
498    NAME section contains, for use in error messages.
499
500    If REQUIRED is non-zero, print an error if the core file doesn't
501    have a section by the appropriate name.  Otherwise, just do
502    nothing.  */
503
504 static void
505 get_core_register_section (struct regcache *regcache,
506                            const char *name,
507                            int which,
508                            const char *human_name,
509                            int required)
510 {
511   static char *section_name = NULL;
512   struct bfd_section *section;
513   bfd_size_type size;
514   char *contents;
515
516   xfree (section_name);
517
518   if (ptid_get_lwp (inferior_ptid))
519     section_name = xstrprintf ("%s/%ld", name,
520                                ptid_get_lwp (inferior_ptid));
521   else
522     section_name = xstrdup (name);
523
524   section = bfd_get_section_by_name (core_bfd, section_name);
525   if (! section)
526     {
527       if (required)
528         warning (_("Couldn't find %s registers in core file."),
529                  human_name);
530       return;
531     }
532
533   size = bfd_section_size (core_bfd, section);
534   contents = alloca (size);
535   if (! bfd_get_section_contents (core_bfd, section, contents,
536                                   (file_ptr) 0, size))
537     {
538       warning (_("Couldn't read %s registers from `%s' section in core file."),
539                human_name, name);
540       return;
541     }
542
543   if (core_gdbarch && gdbarch_regset_from_core_section_p (core_gdbarch))
544     {
545       const struct regset *regset;
546
547       regset = gdbarch_regset_from_core_section (core_gdbarch,
548                                                  name, size);
549       if (regset == NULL)
550         {
551           if (required)
552             warning (_("Couldn't recognize %s registers in core file."),
553                      human_name);
554           return;
555         }
556
557       regset->supply_regset (regset, regcache, -1, contents, size);
558       return;
559     }
560
561   gdb_assert (core_vec);
562   core_vec->core_read_registers (regcache, contents, size, which,
563                                  ((CORE_ADDR)
564                                   bfd_section_vma (core_bfd, section)));
565 }
566
567
568 /* Get the registers out of a core file.  This is the machine-
569    independent part.  Fetch_core_registers is the machine-dependent
570    part, typically implemented in the xm-file for each
571    architecture.  */
572
573 /* We just get all the registers, so we don't use regno.  */
574
575 static void
576 get_core_registers (struct target_ops *ops,
577                     struct regcache *regcache, int regno)
578 {
579   struct core_regset_section *sect_list;
580   int i;
581
582   if (!(core_gdbarch && gdbarch_regset_from_core_section_p (core_gdbarch))
583       && (core_vec == NULL || core_vec->core_read_registers == NULL))
584     {
585       fprintf_filtered (gdb_stderr,
586                      "Can't fetch registers from this type of core file\n");
587       return;
588     }
589
590   sect_list = gdbarch_core_regset_sections (get_regcache_arch (regcache));
591   if (sect_list)
592     while (sect_list->sect_name != NULL)
593       {
594         if (strcmp (sect_list->sect_name, ".reg") == 0)
595           get_core_register_section (regcache, sect_list->sect_name,
596                                      0, sect_list->human_name, 1);
597         else if (strcmp (sect_list->sect_name, ".reg2") == 0)
598           get_core_register_section (regcache, sect_list->sect_name,
599                                      2, sect_list->human_name, 0);
600         else
601           get_core_register_section (regcache, sect_list->sect_name,
602                                      3, sect_list->human_name, 0);
603
604         sect_list++;
605       }
606
607   else
608     {
609       get_core_register_section (regcache,
610                                  ".reg", 0, "general-purpose", 1);
611       get_core_register_section (regcache,
612                                  ".reg2", 2, "floating-point", 0);
613     }
614
615   /* Mark all registers not found in the core as unavailable.  */
616   for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
617     if (regcache_register_status (regcache, i) == REG_UNKNOWN)
618       regcache_raw_supply (regcache, i, NULL);
619 }
620
621 static void
622 core_files_info (struct target_ops *t)
623 {
624   print_section_info (core_data, core_bfd);
625 }
626 \f
627 struct spuid_list
628 {
629   gdb_byte *buf;
630   ULONGEST offset;
631   LONGEST len;
632   ULONGEST pos;
633   ULONGEST written;
634 };
635
636 static void
637 add_to_spuid_list (bfd *abfd, asection *asect, void *list_p)
638 {
639   struct spuid_list *list = list_p;
640   enum bfd_endian byte_order
641     = bfd_big_endian (abfd) ? BFD_ENDIAN_BIG : BFD_ENDIAN_LITTLE;
642   int fd, pos = 0;
643
644   sscanf (bfd_section_name (abfd, asect), "SPU/%d/regs%n", &fd, &pos);
645   if (pos == 0)
646     return;
647
648   if (list->pos >= list->offset && list->pos + 4 <= list->offset + list->len)
649     {
650       store_unsigned_integer (list->buf + list->pos - list->offset,
651                               4, byte_order, fd);
652       list->written += 4;
653     }
654   list->pos += 4;
655 }
656
657 /* Read siginfo data from the core, if possible.  Returns -1 on
658    failure.  Otherwise, returns the number of bytes read.  ABFD is the
659    core file's BFD; READBUF, OFFSET, and LEN are all as specified by
660    the to_xfer_partial interface.  */
661
662 static LONGEST
663 get_core_siginfo (bfd *abfd, gdb_byte *readbuf, ULONGEST offset, LONGEST len)
664 {
665   asection *section;
666   char *section_name;
667   const char *name = ".note.linuxcore.siginfo";
668
669   if (ptid_get_lwp (inferior_ptid))
670     section_name = xstrprintf ("%s/%ld", name,
671                                ptid_get_lwp (inferior_ptid));
672   else
673     section_name = xstrdup (name);
674
675   section = bfd_get_section_by_name (abfd, section_name);
676   xfree (section_name);
677   if (section == NULL)
678     return -1;
679
680   if (!bfd_get_section_contents (abfd, section, readbuf, offset, len))
681     return -1;
682
683   return len;
684 }
685
686 static LONGEST
687 core_xfer_partial (struct target_ops *ops, enum target_object object,
688                    const char *annex, gdb_byte *readbuf,
689                    const gdb_byte *writebuf, ULONGEST offset,
690                    LONGEST len)
691 {
692   switch (object)
693     {
694     case TARGET_OBJECT_MEMORY:
695       return section_table_xfer_memory_partial (readbuf, writebuf,
696                                                 offset, len,
697                                                 core_data->sections,
698                                                 core_data->sections_end,
699                                                 NULL);
700
701     case TARGET_OBJECT_AUXV:
702       if (readbuf)
703         {
704           /* When the aux vector is stored in core file, BFD
705              represents this with a fake section called ".auxv".  */
706
707           struct bfd_section *section;
708           bfd_size_type size;
709
710           section = bfd_get_section_by_name (core_bfd, ".auxv");
711           if (section == NULL)
712             return -1;
713
714           size = bfd_section_size (core_bfd, section);
715           if (offset >= size)
716             return 0;
717           size -= offset;
718           if (size > len)
719             size = len;
720           if (size > 0
721               && !bfd_get_section_contents (core_bfd, section, readbuf,
722                                             (file_ptr) offset, size))
723             {
724               warning (_("Couldn't read NT_AUXV note in core file."));
725               return -1;
726             }
727
728           return size;
729         }
730       return -1;
731
732     case TARGET_OBJECT_WCOOKIE:
733       if (readbuf)
734         {
735           /* When the StackGhost cookie is stored in core file, BFD
736              represents this with a fake section called
737              ".wcookie".  */
738
739           struct bfd_section *section;
740           bfd_size_type size;
741
742           section = bfd_get_section_by_name (core_bfd, ".wcookie");
743           if (section == NULL)
744             return -1;
745
746           size = bfd_section_size (core_bfd, section);
747           if (offset >= size)
748             return 0;
749           size -= offset;
750           if (size > len)
751             size = len;
752           if (size > 0
753               && !bfd_get_section_contents (core_bfd, section, readbuf,
754                                             (file_ptr) offset, size))
755             {
756               warning (_("Couldn't read StackGhost cookie in core file."));
757               return -1;
758             }
759
760           return size;
761         }
762       return -1;
763
764     case TARGET_OBJECT_LIBRARIES:
765       if (core_gdbarch
766           && gdbarch_core_xfer_shared_libraries_p (core_gdbarch))
767         {
768           if (writebuf)
769             return -1;
770           return
771             gdbarch_core_xfer_shared_libraries (core_gdbarch,
772                                                 readbuf, offset, len);
773         }
774       /* FALL THROUGH */
775
776     case TARGET_OBJECT_SPU:
777       if (readbuf && annex)
778         {
779           /* When the SPU contexts are stored in a core file, BFD
780              represents this with a fake section called
781              "SPU/<annex>".  */
782
783           struct bfd_section *section;
784           bfd_size_type size;
785           char sectionstr[100];
786
787           xsnprintf (sectionstr, sizeof sectionstr, "SPU/%s", annex);
788
789           section = bfd_get_section_by_name (core_bfd, sectionstr);
790           if (section == NULL)
791             return -1;
792
793           size = bfd_section_size (core_bfd, section);
794           if (offset >= size)
795             return 0;
796           size -= offset;
797           if (size > len)
798             size = len;
799           if (size > 0
800               && !bfd_get_section_contents (core_bfd, section, readbuf,
801                                             (file_ptr) offset, size))
802             {
803               warning (_("Couldn't read SPU section in core file."));
804               return -1;
805             }
806
807           return size;
808         }
809       else if (readbuf)
810         {
811           /* NULL annex requests list of all present spuids.  */
812           struct spuid_list list;
813
814           list.buf = readbuf;
815           list.offset = offset;
816           list.len = len;
817           list.pos = 0;
818           list.written = 0;
819           bfd_map_over_sections (core_bfd, add_to_spuid_list, &list);
820           return list.written;
821         }
822       return -1;
823
824     case TARGET_OBJECT_SIGNAL_INFO:
825       if (readbuf)
826         return get_core_siginfo (core_bfd, readbuf, offset, len);
827       return -1;
828
829     default:
830       if (ops->beneath != NULL)
831         return ops->beneath->to_xfer_partial (ops->beneath, object,
832                                               annex, readbuf,
833                                               writebuf, offset, len);
834       return -1;
835     }
836 }
837
838 \f
839 /* If mourn is being called in all the right places, this could be say
840    `gdb internal error' (since generic_mourn calls
841    breakpoint_init_inferior).  */
842
843 static int
844 ignore (struct gdbarch *gdbarch, struct bp_target_info *bp_tgt)
845 {
846   return 0;
847 }
848
849
850 /* Okay, let's be honest: threads gleaned from a core file aren't
851    exactly lively, are they?  On the other hand, if we don't claim
852    that each & every one is alive, then we don't get any of them
853    to appear in an "info thread" command, which is quite a useful
854    behaviour.
855  */
856 static int
857 core_thread_alive (struct target_ops *ops, ptid_t ptid)
858 {
859   return 1;
860 }
861
862 /* Ask the current architecture what it knows about this core file.
863    That will be used, in turn, to pick a better architecture.  This
864    wrapper could be avoided if targets got a chance to specialize
865    core_ops.  */
866
867 static const struct target_desc *
868 core_read_description (struct target_ops *target)
869 {
870   if (core_gdbarch && gdbarch_core_read_description_p (core_gdbarch))
871     return gdbarch_core_read_description (core_gdbarch, 
872                                           target, core_bfd);
873
874   return NULL;
875 }
876
877 static char *
878 core_pid_to_str (struct target_ops *ops, ptid_t ptid)
879 {
880   static char buf[64];
881   struct inferior *inf;
882   int pid;
883
884   /* The preferred way is to have a gdbarch/OS specific
885      implementation.  */
886   if (core_gdbarch
887       && gdbarch_core_pid_to_str_p (core_gdbarch))
888     return gdbarch_core_pid_to_str (core_gdbarch, ptid);
889
890   /* Otherwise, if we don't have one, we'll just fallback to
891      "process", with normal_pid_to_str.  */
892
893   /* Try the LWPID field first.  */
894   pid = ptid_get_lwp (ptid);
895   if (pid != 0)
896     return normal_pid_to_str (pid_to_ptid (pid));
897
898   /* Otherwise, this isn't a "threaded" core -- use the PID field, but
899      only if it isn't a fake PID.  */
900   inf = find_inferior_pid (ptid_get_pid (ptid));
901   if (inf != NULL && !inf->fake_pid_p)
902     return normal_pid_to_str (ptid);
903
904   /* No luck.  We simply don't have a valid PID to print.  */
905   xsnprintf (buf, sizeof buf, "<main task>");
906   return buf;
907 }
908
909 static int
910 core_has_memory (struct target_ops *ops)
911 {
912   return (core_bfd != NULL);
913 }
914
915 static int
916 core_has_stack (struct target_ops *ops)
917 {
918   return (core_bfd != NULL);
919 }
920
921 static int
922 core_has_registers (struct target_ops *ops)
923 {
924   return (core_bfd != NULL);
925 }
926
927 /* Implement the to_info_proc method.  */
928
929 static void
930 core_info_proc (struct target_ops *ops, char *args, enum info_proc_what request)
931 {
932   struct gdbarch *gdbarch = get_current_arch ();
933
934   /* Since this is the core file target, call the 'core_info_proc'
935      method on gdbarch, not 'info_proc'.  */
936   if (gdbarch_core_info_proc_p (gdbarch))
937     gdbarch_core_info_proc (gdbarch, args, request);
938 }
939
940 /* Fill in core_ops with its defined operations and properties.  */
941
942 static void
943 init_core_ops (void)
944 {
945   core_ops.to_shortname = "core";
946   core_ops.to_longname = "Local core dump file";
947   core_ops.to_doc =
948     "Use a core file as a target.  Specify the filename of the core file.";
949   core_ops.to_open = core_open;
950   core_ops.to_close = core_close;
951   core_ops.to_attach = find_default_attach;
952   core_ops.to_detach = core_detach;
953   core_ops.to_fetch_registers = get_core_registers;
954   core_ops.to_xfer_partial = core_xfer_partial;
955   core_ops.to_files_info = core_files_info;
956   core_ops.to_insert_breakpoint = ignore;
957   core_ops.to_remove_breakpoint = ignore;
958   core_ops.to_create_inferior = find_default_create_inferior;
959   core_ops.to_thread_alive = core_thread_alive;
960   core_ops.to_read_description = core_read_description;
961   core_ops.to_pid_to_str = core_pid_to_str;
962   core_ops.to_stratum = process_stratum;
963   core_ops.to_has_memory = core_has_memory;
964   core_ops.to_has_stack = core_has_stack;
965   core_ops.to_has_registers = core_has_registers;
966   core_ops.to_info_proc = core_info_proc;
967   core_ops.to_magic = OPS_MAGIC;
968
969   if (core_target)
970     internal_error (__FILE__, __LINE__, 
971                     _("init_core_ops: core target already exists (\"%s\")."),
972                     core_target->to_longname);
973   core_target = &core_ops;
974 }
975
976 void
977 _initialize_corelow (void)
978 {
979   init_core_ops ();
980
981   add_target_with_completer (&core_ops, filename_completer);
982 }